SINGLESTEPPER(1)

NAME
singlestepper - counter of executed instructions

SYNOPSIS
singlestepper [-i] [-o OUTPUT] [-p | command [arg ...]]

DESCRIPTION
singlestepper enables single step trace for the specified processes. Trace data is printed on program termination to the file OUTPUT, otherwise if not specified to stdout. The operations that are recorded include single step traps only.

The output report is in plain text, human readable.

The options are as follows:

-i  Inherit; pass the trace flags to all future children of the designated processes.

-o OUTPUT
    Log trace records to outfile. Without this option singlestepper will print its output to standard output.

-p PID
    Enable (disable) tracing on the indicated process id (only one -p flag is permitted).

command [args ...]
    Execute command with the specified trace flags.

The -p and command options are mutually exclusive.

IMPLEMENTATION NOTES
The tracer uses the ptrace(2) system call to perform the tracing process.

EXAMPLES
# trace the signals of process id 34
    $ singlestepper -p 34

# spawn and trace process sh(1) with all of its children and log the record to "trace.txt"
    $ singlestepper -o trace.txt -i sh

SEE ALSO
ktruss(1), ptrace(2)

HISTORY
singlestepper is a modified version of picotrace

singlestepper command was designed for NetBSD 9.

AUTHORS
Kamil Rytarowski <kamil@NetBSD.org>