multproc subcommand for dbx: Enable or disable multiprocess debugging
Format
- multproc
- multproc [on]
- multproc [off]
- multproc [parent]
- multproc [child]
Description
The multproc subcommand alters the way dbx behaves when the process that is being debugged issues a fork() runtime call. By default, multiprocess debugging is disabled when dbx is started.If no options are specified, the multproc subcommand returns the current status of multiprocess debugging.
Options
- on
- dbx will notify the user that a fork has occurred, provide the PID of the new child process, and follow the parent process.
- off
- dbx will ignore any forks that occur.
- parent
- dbx will notify the user that a fork has occurred and follow the parent process.
- child
- dbx will notify the user that a fork has occurred and follow the child process.
Usage notes
- The multproc subcommand can be run only while the dbx debug program is running.
- The multproc subcommand is not supported in GUI (socket) mode (-p).
Examples
- To check the current status of multiprocess debugging, enter:
multproc
- To have dbx notify the user that the process being debugged
has forked, enter:
multproc on
- To have dbx ignore all forks by the process being debugged,
enter:
multproc off
Related information
The fork() function.