NAME

       dlv-trace - Compile and begin tracing program.

SYNOPSIS

       dlv trace [package] regexp [flags]

DESCRIPTION

       Trace program execution.

       The  trace  sub  command will set a tracepoint on every function matching the provided regular expression
       and output information when tracepoint is hit.  This is useful if you do not  want  to  begin  an  entire
       debug session, but merely want to know what functions your process is executing.

       The  output of the trace sub command is printed to stderr, so if you would like to only see the output of
       the trace operations you can redirect stdout.

OPTIONS

       --ebpf[=false]      Trace using eBPF (experimental).

       -e, --exec=""      Binary file to exec and trace.

       -h, --help[=false]      help for trace

       --output=""      Output path for the binary.

       -p, --pid=0      Pid to attach to.

       -s, --stack=0      Show stack trace with given depth. (Ignored with --ebpf)

       -t, --test[=false]      Trace a test binary.

       --timestamp[=false]      Show timestamp in the output

OPTIONS INHERITED FROM PARENT COMMANDS

       --accept-multiclient[=false]      Allows a headless server to  accept  multiple  client  connections  via
       JSON-RPC or DAP.

       --allow-non-terminal-interactive[=false]       Allows  interactive  sessions  of  Delve that don't have a
       terminal as stdin, stdout and stderr

       --api-version=1      Selects JSON-RPC API version when headless. New clients should use v2. Can be  reset
       via RPCServer.SetApiVersion. See Documentation/api/json-rpc/README.md.

       --backend="default"      Backend selection (see 'dlv help backend').

       --build-flags=""        Build   flags,   to   be   passed   to   the   compiler.  For  example:  --build-
       flags="-tags=integration -mod=vendor -cover -v"

       --check-go-version[=true]      Exits if the version of Go in use is not compatible (too old or  too  new)
       with the version of Delve.

       --disable-aslr[=false]      Disables address space randomization

       --headless[=false]       Run debug server only, in headless mode. Server will accept both JSON-RPC or DAP
       client connections.

       --init=""      Init file, executed by the terminal client.

       -l, --listen="127.0.0.1:0"      Debugging server listen address. Prefix with 'unix:' to use a unix domain
       socket.

       --log[=false]      Enable debugging server logging.

       --log-dest=""      Writes logs to the specified file or file descriptor (see 'dlv help log').

       --log-output=""      Comma separated list of components that should produce debug output (see  'dlv  help
       log')

       --only-same-user[=true]       Only connections from the same user that started this instance of Delve are
       allowed to connect.

       -r, --redirect=[]      Specifies redirect rules for target process (see 'dlv help redirect')

       --wd=""      Working directory for running the program.

SEE ALSO

       dlv(1)

Auto generated by spf13/cobra                       Feb 2024                                        DLV-TRACE(1)