Chapter Contents

Previous

Next
Command Directory

ignore

Ignore Breakpoint or Action Requests, or Signals

ABBREVIATION
i{gnore}

FORMATS
Format 1: ignore HOOK-TYPE
Format 2: ignore signal
Format 3: ignore SIGNAL-NAME signal

DESCRIPTION
The ignore command lets you temporarily suppress action and breakpoint requests that you may want to reinstate later. It also lets you ignore signals.

Note:    It is better to drop a request than to ignore it because run-time overhead may be associated with ignored requests, but not with dropped ones.  [cautionend]

Format 1: Format 1 lets you ignore breakpoint or action requests at specified hooks. See Using Debugger Commands for details on the HOOK-TYPE argument, an argument that allows you to specify hooks.

Format 2: Format 2 causes the debugger to ignore all signals.

Format 3: Format 3 causes the specific signal named in SIGNAL-NAME to be ignored when SIGNAL-NAME is used with the signal keyword. SIGNAL-NAME is the name of a signal. Tracing of the signal is turned off. See Chapter 17, "Signal-Handling Functions," in the SAS/C Library Reference, Volume 1, for a list of signal names.

Ignoring signals: Format 2 and Format 3 allow you to ignore signals. Whenever a signal occurs, it is traced automatically, and the return from signal handling is traced also. The ignore command provides a way to turn off this trace. If you choose to ignore a signal, the debugger does not trap or trace the signal, and you cannot recover or resume execution afterward. You must remember this point when you use ignore with the signal keyword.

Dropping ignore: You can drop the ignore command (using the drop command) if you want the breakpoint requests and actions to be in effect again or if you do not want to ignore signals.

Identical requests: If an ignore request is made that is identical to an existing one, the identical request is not installed. This is true whether the request to be installed is within an on command or typed in at the command line.

If an identical request is issued and the original request is disabled, the identical request is discarded and the original request is automatically enabled without an indication.

EXAMPLES

ignore *
ignores all breakpoint and action requests at every line-hook for every source file.

ignore entry
ignores requests at all function entries.

ignore main 45
ignores any requests at line 45 in the main function.

ignore 53
ignores any requests at line 53 of the current function.

ignore (comp23) entry
ignores any requests made at entry to the comp23 compilation.

ignore func1 entry
ignores any requests made at entry to the func1 function.

ignore func 23:46
ignores any requests at lines 23 through 46 in the func function.

ignore signal
ignores all signals.

ignore SIGSEGV signal
ignores the signal named SIGSEGV.

SYSTEM DEPENDENCIES
none

COMMAND CAN BE ISSUED FROM

PROFILE yes
configuration file no
Source window prefix i

SCOPE
The ignore command uses command scope to supply default function names and section names.

RETURN CODES SET
Successful: request number from query
Unsuccessful : 0

SEE ALSO


Chapter Contents

Previous

Next

Top of Page

Copyright © 2001 by SAS Institute Inc., Cary, NC, USA. All rights reserved.