Commit | Line | Data |
---|---|---|
43550d37 JB |
1 | ustctl(1) -- a program to control the tracing of userspace applications |
2 | ======================================================================= | |
3 | ||
4 | ## SYNOPSIS | |
5 | ||
6 | `ustctl` [<command>] [<PIDs>]... | |
7 | ||
8 | ## DESCRIPTION | |
9 | ||
10 | `ustclt` is a program to control the tracing of userspace applications. It can | |
11 | list markers, start the tracing, stop the tracing, enable/disable markers, etc. | |
12 | ||
13 | ## OPTIONS | |
14 | ||
15 | These programs follow the usual GNU command line syntax, with long options | |
16 | starting with two dashes(`-'). A summary of options is included below. | |
17 | ||
18 | * `-h`, `--help`: | |
19 | Show summary of options. | |
20 | ||
21 | * `--create-trace`: | |
22 | Create trace. | |
23 | ||
24 | * `--alloc-trace`: | |
25 | Alloc trace. | |
26 | ||
27 | * `--start-trace`: | |
28 | Start tracing. | |
29 | ||
30 | * `--stop-trace`: | |
31 | Stop tracing. | |
32 | ||
33 | * `--destroy-trace`: | |
34 | Destroy the trace. | |
35 | ||
36 | * `--set-subbuf-size` <CHANNEL>/<bytes>: | |
37 | Set the size of subbuffers per channel. | |
38 | ||
39 | * `--set-subbuf-num` <CHANNEL>: | |
40 | Set the number of subbuffers per channel. | |
41 | ||
42 | * `--get-subbuf-size` <CHANNEL>: | |
43 | Get the size of subbuffers per channel. | |
44 | ||
45 | * `--get-subbuf-num` <CHANNEL>: | |
46 | Get the number of subbuffers per channel. | |
47 | ||
48 | * `--enable-marker` <CHANNEL>/<MARKER>: | |
49 | Enable a marker. | |
50 | ||
51 | * `--disable-marker` <CHANNEL>/<MARKER>: | |
52 | Disable a marker. | |
53 | ||
54 | * `--list-markers`: | |
55 | List the markers of the process, their state and format string. | |
56 | ||
57 | ## AUTHOR | |
58 | ||
59 | `ustctl` was written by Pierre-Marc Fournier. | |
60 | ||
61 | This manual page was written by Jon Bernard <jbernard@debian.org>, for | |
62 | the Debian project (and may be used by others). |