delve/Documentation/usage/dlv_trace.md

## dlv trace

Compile and begin tracing program.

### Synopsis


Trace program execution. Will set a tracepoint on every function matching the provided regular expression and output information when tracepoint is hit.

```
dlv trace [package] regexp
```

### Options

```
  -p, --pid=0: Pid to attach to.
  -s, --stack=0: Show stack trace with given depth.
```

### Options inherited from parent commands

```
      --accept-multiclient[=false]: Allows a headless server to accept multiple client connections. Note that the server API is not reentrant and clients will have to coordinate
      --build-flags="": Build flags, to be passed to the compiler.
      --headless[=false]: Run debug server only, in headless mode.
      --init="": Init file, executed by the terminal client.
  -l, --listen="localhost:0": Debugging server listen address.
      --log[=false]: Enable debugging server logging.
```

### SEE ALSO
* [dlv](dlv.md)	 - Delve is a debugger for the Go programming language.

###### Auto generated by spf13/cobra on 19-Feb-2016
docs: Move wiki docs into Documentation dir Going forward, all documentation should be placed in the Documentation directory in the root of the project. This switch allows maintainers to approve updates to documentation before they are committed, as opposed to the pre-existing wiki which anybody could modify. Currently the Documentation directory includes docs on building, usage, and minimal docs around the API. This is just the initial commit, and documentation will continue to improve over time. Some changes have been made (and will continue to be made) to `cmd/dlv` to ensure we can auto-generate documentation for all commands from the newly provided script `scripts/gen-usage-docs.go`, which can be invoked via `go run scripts/gen-usage-docs.go`. Additionally, version has been split into its own package. This was a bit of housekeeping related to the changes made the `cmd/dlv`. 2016-02-19 18:32:24 +00:00			`## dlv trace`

			`Compile and begin tracing program.`

			`### Synopsis`


			`Trace program execution. Will set a tracepoint on every function matching the provided regular expression and output information when tracepoint is hit.`

			```
			`dlv trace [package] regexp`
			```

			`### Options`

			```
			`-p, --pid=0: Pid to attach to.`
			`-s, --stack=0: Show stack trace with given depth.`
			```

			`### Options inherited from parent commands`

			```
docs: Changed word from singular to plural form to better fit context. (#491) 2016-04-08 21:12:38 +00:00			`--accept-multiclient[=false]: Allows a headless server to accept multiple client connections. Note that the server API is not reentrant and clients will have to coordinate`
docs: Move wiki docs into Documentation dir Going forward, all documentation should be placed in the Documentation directory in the root of the project. This switch allows maintainers to approve updates to documentation before they are committed, as opposed to the pre-existing wiki which anybody could modify. Currently the Documentation directory includes docs on building, usage, and minimal docs around the API. This is just the initial commit, and documentation will continue to improve over time. Some changes have been made (and will continue to be made) to `cmd/dlv` to ensure we can auto-generate documentation for all commands from the newly provided script `scripts/gen-usage-docs.go`, which can be invoked via `go run scripts/gen-usage-docs.go`. Additionally, version has been split into its own package. This was a bit of housekeeping related to the changes made the `cmd/dlv`. 2016-02-19 18:32:24 +00:00			`--build-flags="": Build flags, to be passed to the compiler.`
			`--headless[=false]: Run debug server only, in headless mode.`
			`--init="": Init file, executed by the terminal client.`
			`-l, --listen="localhost:0": Debugging server listen address.`
			`--log[=false]: Enable debugging server logging.`
			```

			`### SEE ALSO`
			`* [dlv](dlv.md) - Delve is a debugger for the Go programming language.`

			`###### Auto generated by spf13/cobra on 19-Feb-2016`