@@ -5,11 +5,11 @@ Stackusage
5
5
| -----------| ---------|
6
6
| [ ![ Linux] ( https://github.com/d99kris/stackusage/workflows/Linux/badge.svg )] ( https://github.com/d99kris/stackusage/actions?query=workflow%3ALinux ) | [ ![ macOS] ( https://github.com/d99kris/stackusage/workflows/macOS/badge.svg )] ( https://github.com/d99kris/stackusage/actions?query=workflow%3AmacOS ) |
7
7
8
- Stackusage measures stack usage in Linux and macOS applications (main thread and
9
- native pthread child threads). The measured stack utilization data can be used to
10
- adjust the stack size allocation to provide desired margin for child threads. This
11
- is primarily useful for applications and libraries designed to work in
12
- resource-constrained environments (such as embedded systems).
8
+ Stackusage measures stack usage in Linux and macOS applications (main thread
9
+ and native pthread child threads). The measured stack utilization data can be
10
+ used to adjust the stack size allocation to provide desired margin for child
11
+ threads. This is primarily useful for applications and libraries designed to
12
+ work in resource-constrained environments (such as embedded systems).
13
13
14
14
Example Usage
15
15
=============
@@ -28,13 +28,15 @@ Example Usage
28
28
Supported Platforms
29
29
===================
30
30
Stackusage is primarily developed and tested on Linux, but basic
31
- functionality should work in macOS / OS X as well. Current version has been tested on:
32
- - OS X El Capitan 10.11
33
- - Ubuntu 16.04 LTS
31
+ functionality should work in macOS / OS X as well. Current version has been
32
+ tested on:
33
+ - macOS Big Sur 11.0
34
+ - Ubuntu 20.04 LTS
34
35
35
- Limitation: On macOS / OS X this tool relies on code injection using DYLD_INSERT_LIBRARIES,
36
- which generally does not work with third-party applications in a standard system. Using it on
37
- (your own) applications built from source should work fine though.
36
+ Limitation: On macOS / OS X this tool relies on code injection using
37
+ DYLD_INSERT_LIBRARIES, which generally does not work with third-party
38
+ applications in a standard system. Using it on (your own) applications built
39
+ from source should work fine though.
38
40
39
41
Installation
40
42
============
@@ -71,7 +73,8 @@ Options:
71
73
--help display this help and exit
72
74
--version output version information and exit
73
75
74
- Example checking stack usage of test program 'ex001' with stackusage installed on system:
76
+ Example checking stack usage of test program 'ex001' with stackusage installed
77
+ on system:
75
78
76
79
stackusage ./ex001
77
80
@@ -106,7 +109,8 @@ Description of columns:
106
109
dur thread duration in seconds
107
110
funcP (nil) for main, pointer to start_routine for child threads
108
111
109
- The function that funcP points to can be determined for example using addr2line:
112
+ The function that funcP points to can be determined for example using
113
+ addr2line:
110
114
111
115
$ addr2line -f -e ./ex001 0x4009b0
112
116
thread_start
0 commit comments