OS Manuals

/usr/bin/staprun

a linux trace/probe tool

From systemtap 5.6-r1 (enterprise-packages), captured 2026-11-08 by running staprun --help (exit 1). permalink

/usr/bin/staprun: invalid option -- '-'

/usr/bin/staprun [-v] [-w] [-V] [-h] [-u] [-c cmd ] [-x pid] [-u user] [-A|-L|-d] [-C WHEN]
	[-b bufsize] [-R] [-r N:URI] [-o FILE [-D] [-S size[,N]]] MODULE [module-options]
-v              Increase verbosity.
-V              Print version number and exit.
-h              Print this help text and exit.
-w              Suppress warnings.
-u              Load uprobes.ko
-c cmd          Command 'cmd' will be run and staprun will
                exit when it does.  The '_stp_target' variable
                will contain the pid for the command.
-x pid          Sets the '_stp_target' variable to pid.
-N pid          Sets the '_stp_namespaces_pid' variable to pid.
-o FILE         Send output to FILE. This supports strftime(3)
                formats for FILE.
-b buffer size  The systemtap module specifies a buffer size.
                Setting one here will override that value.  The
                value should be an integer between 1 and 4095
                which be assumed to be the buffer size in MB.
                That value will be per-cpu in bulk mode.
-L              Load module and start probes, then detach.
-A              Attach to loaded systemtap module.
-C WHEN         Enable colored errors. WHEN must be either 'auto',
                'never', or 'always'. Set to 'auto' by default.
-M INTERVAL     Enable monitor mode.
-d              Delete a module.  Only detached or unused modules
                the user has permission to access will be deleted. Use "*"
                (quoted) to delete all unused modules.
-R              Have staprun create a new name for the module before
                inserting it. This allows the same module to be inserted
                more than once.
-r N:URI        Pass N:URI data to tapset functions remote_id()/remote_uri().
-D              Run in background. This requires '-o' option.
-S size[,N]     Switches output file to next file when the size
                of file reaches the specified size. The value
                should be an integer greater than 1 which is
                assumed to be the maximum file size in MB.
                When the number of output files reaches N, it
                switches to the first output file. You can omit
                the second argument.
-T timeout      Specifies upper limit on amount of time reader thread
                will wait for new full trace buffer. Value should be an
                integer >= 1, which is timeout value in ms. Default 200ms.
-F fd           Specifies file descriptor for module relay directory

MODULE can be either a module name or a module path.  If a
module name is used, it is searched in the following directory:
/lib/modules/6.18.60-r0-gcp-6.18/systemtap
Options (21)
OptionDescriptionSource
-vIncrease verbosity.help + man
-VPrint version number and exit.help + man
-hPrint this help text and exit.help
-wSuppress warnings from the script.help + man
-uLoad the uprobes.ko module.help + man
-c cmdCommand CMD will be run and the staprun program will exit when CMD does.help + man
-x pidThe '_stp_target' variable will be set to PID.help + man
-N pidSets the '_stp_namespaces_pid' variable to pid.help + man
-o FILESend output to FILE.help + man
-b bufferThe systemtap module will specify a buffer size.help + man
-LLoad module and start probes, then detach from the module leaving the probes running.help + man
-AAttach to loaded systemtap module.help + man
-C WHENControl coloring of error messages.help + man
-M INTERVALEnable monitor mode with INTERVAL seconds between updates.help + man
-dDelete a module.help + man
-RHave staprun create a new name for the module before inserting it.help + man
-r N:URIPass the given number and URI data to the tapset functions remote_id() and remote_uri().help + man
-DRun staprun in background as a daemon and show it's pid.help + man
-S sizeSwitches output file to next file when the size of file reaches the specified size.help
-T timeoutSpecifies upper limit on amount of time reader thread will wait for new full trace buffer.help + man
-F fdSpecifies file descriptor for module relay directoryhelp
Examples (2) from the manual page, untested

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.