Event Specification Modifiers

Related Topics:

The following is a list of event specification modifiers:

-if cond Event only fires when the cond filter is true. Any expression can be used for cond as long as it evaluates to an integral type.
-in func Event only fires if it occurs in function func.
-disable Create the event in the disabled state.
-count n Count up from 0; event fires and counter is reset to 0 when n is reached.
-count infinity Count, but don't fire.
-temp A temporary event, deleted when fired.
-instr Do instruction level variation. For example, step becomes instruction level stepping, and at takes a text address for an argument instead of a line number.
-perm Make this event permanent across debug. Certain events (like breakpoints) are not appropriate to be made permanent. delete all will not delete permanent handlers, use delete hid.
-hidden Hide the event from the status command. Some import modules may choose to use this. Use status -h to see them.
-lwp lwpid Event only fires if it occurs in the given LWP.
-thread tid Event only fires if it occurs in the given thread.

For backward compatibility, the following syntactical variations of eventspec modifiers are also accepted, although they are considered anachronistic and will be eliminated in future releases.

if cond

in func

lwpid

tid

`-if` cond	Event only fires when the cond filter is true. Any expression can be used for cond as long as it evaluates to an integral type.
`-in` func	Event only fires if it occurs in function func.
`-disable`	Create the event in the disabled state.
`-count` n	Count up from 0; event fires and counter is reset to 0 when n is reached.
`-count infinity`	Count, but don't fire.
`-temp`	A temporary event, deleted when fired.
`-instr`	Do instruction level variation. For example, `step` becomes instruction level stepping, and `at` takes a text address for an argument instead of a line number.
`-perm`	Make this event permanent across `debug`. Certain events (like breakpoints) are not appropriate to be made permanent. `delete all` will not delete permanent handlers, use `delete` hid.
`-hidden`	Hide the event from the `status` command. Some import modules may choose to use this. Use `status -h` to see them.
`-lwp` lwpid	Event only fires if it occurs in the given LWP.
`-thread` tid	Event only fires if it occurs in the given thread.