| 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). |