Predefined Events

access mode addr-expr[ ,byte-size-expr ] The given address range has been accessed. Any expression can be used for addr-expr but it has to evaluate to an address. mode can be composed of one or all of the letters
r (read access)
w (write access)
x (access for the purpose of execution)
mode can also contain one of:
a (stop after access occurred. default)
b (stop before access occurred)
at line
at filename:line line is about to be executed. Sometimes dbx has problems setting a breakpoint at a specific line in header files (in C++ inline functions or template definitions) if debugging information has not been read for at least one instance of the function. If dbx cannot set the breakpoints, do a func name_of_function to force dbx to read the debugging information, and try to re-type the command.
attach An attach operation has just completed
change variable Value of variable has changed.
cond cond-expr Condition has changed. Any expression can be used but it must evaluate to an integral type.
detach Complements attach.
dlclose ... Similarly for dlclose.
dlopen A set of loadobjects has been loaded
dlopen [ lib-path ] The specified loadobject has been loaded. The full path name of the library has to be quoted for lib-path.
exit [ exitcode ] The process has exited with any exit value, or the specified one. exitcode has to be a decimal.
fault fault The specified fault has been intercepted (see # \Qhelp event fault')
in func Entry into func.
inclass classname Entry into any method of classname where classname is a C++ struct, union, class, or template class .
infunction func Entry into any overloaded version of func.
inmember func An alias of inmethod.
inmethod func Entry into any method named func.
inobject class_object_expression Entry into any non-static method of the class and all its baseclasses when called from the object. class_object_expression should evaluate to an C++ object.
lastrites The process is about to expire
lwp_exit Notifies of the demise of the lwp given in $lwp.
modify addr-expr[ ,byte-size-expr ] The given address range has been written to (see Event Specification Modifiers). Any expression can be used for addr-expr but it has to evaluate to an address. See Watchpoint Specification for more information.
next A next has occurred
proc_gone Fires when dbx is no longer associated with a debugged process. The event variable $reason can be: signal, exit, kill, or detach.
prog_new Fires when a new program is loaded into dbx. This occurs during the debug command or when follow-exec occurs. Since all handlers get deleted across debug, it only makes sense to create this handler with the -perm modifier
returns func The specified function has returned.
returns The current visiting function has returned.
step A single step has occurred. Specifying this event implicitly turns on stepping.
stop The process has stopped; user is about to get prompt
sync The target process has just execed and synchronized with dbx. stop sync is ineffective, although you can still use when sync.
syncrtld rtld has run and all loadobject symbols have been loaded by dbx. Same restriction regarding stop applies as with the sync event.
sysin The process has entered a system call.
sysout A system call has returned.
sysin code|name
sysout code|name Entry to or return from the system call of the given number or name. See sys/syscall.h for list of system calls.
throw A C++ exception has been thrown
throw type A C++ exception of type type has been thrown.
-unhandled or -unexpected may be used for type (see intercept Command for more information)
timer seconds The program being debugged has been running for seconds realtime seconds. seconds is a floating-point number. dbx's single interval timer is also shared by the data visualizer and the Collector commands. Using one of these features excludes the others.

For backward compatibility, the following syntactical variations of eventspecs (note that they lack the `keyword') are accepted although they are considered anachronistic and will be eliminated in future releases.

variable Value has changed. Use change variable instead.
cond-expr Condition has changed. Any expression can be used but it has to evaluate to an integral type. Use cond cond-expr instead.

`access` mode addr-expr`[ ,`byte-size-expr `]`	The given address range has been accessed. Any expression can be used for addr-expr but it has to evaluate to an address. mode can be composed of one or all of the letters
		r (read access)
		w (write access)
		x (access for the purpose of execution)
	mode can also contain one of:
		a (stop after access occurred. default)
		b (stop before access occurred)
`at` line
`at` filename`:`line	line is about to be executed. Sometimes `dbx` has problems setting a breakpoint at a specific line in header files (in C++ inline functions or template definitions) if debugging information has not been read for at least one instance of the function. If `dbx` cannot set the breakpoints, do a `func` name_of_function to force `dbx` to read the debugging information, and try to re-type the command.
`attach`	An attach operation has just completed
`change` variable	Value of variable has changed.
`cond` cond-expr	Condition has changed. Any expression can be used but it must evaluate to an integral type.
`detach`	Complements `attach.`
`dlclose ...`	Similarly for `dlclose`.
`dlopen`	A set of loadobjects has been loaded
`dlopen [` lib-path `]`	The specified loadobject has been loaded. The full path name of the library has to be quoted for lib-path.
`exit [` exitcode `]`	The process has exited with any exit value, or the specified one. exitcode has to be a decimal.
`fault` fault	The specified fault has been intercepted (see # \Qhelp event fault')
`in` func	Entry into func.
`inclass` classname	Entry into any method of classname where classname is a C++ struct, union, class, or template class .
`infunction` func	Entry into any overloaded version of func.
`inmember` func	An alias of `inmethod`.
`inmethod` func	Entry into any method named func.
`inobject` class_object_expression	Entry into any non-static method of the class and all its baseclasses when called from the object. class_object_expression should evaluate to an C++ object.
`lastrites`	The process is about to expire
`lwp_exit`	Notifies of the demise of the lwp given in `$lwp`.
`modify` addr-expr`[ ,`byte-size-expr `]`	The given address range has been written to (see Event Specification Modifiers). Any expression can be used for addr-expr but it has to evaluate to an address. See Watchpoint Specification for more information.
`next`	A next has occurred
`proc_gone`	Fires when dbx is no longer associated with a debugged process. The event variable `$reason` can be: signal, exit, kill, or detach.
`prog_new`	Fires when a new program is loaded into `dbx`. This occurs during the debug command or when follow-exec occurs. Since all handlers get deleted across debug, it only makes sense to create this handler with the `-perm` modifier
`returns` func	The specified function has returned.
`returns`	The current visiting function has returned.
`step`	A single step has occurred. Specifying this event implicitly turns on stepping.
`stop`	The process has stopped; user is about to get prompt
`sync`	The target process has just execed and synchronized with `dbx`. `stop sync` is ineffective, although you can still use `when sync`.
`syncrtld`	rtld has run and all loadobject symbols have been loaded by dbx. Same restriction regarding `stop` applies as with the `sync` event.
`sysin`	The process has entered a system call.
`sysout`	A system call has returned.
`sysin` code`\|`name
`sysout` code`\|`name	Entry to or return from the system call of the given number or name. See `sys/syscall.h` for list of system calls.
`throw`	A C++ exception has been thrown
`throw` type	A C++ exception of type type has been thrown. `-unhandled` or `-unexpected` may be used for type (see intercept Command for more information)
`timer` seconds	The program being debugged has been running for seconds realtime seconds. seconds is a floating-point number. dbx's single interval timer is also shared by the data visualizer and the Collector commands. Using one of these features excludes the others.

variable	Value has changed. Use `change` variable instead.
cond-expr	Condition has changed. Any expression can be used but it has to evaluate to an integral type. Use `cond` cond-expr instead.

Predefined Events

Related Topics: