DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 
Using the command line interface of debug

Debugger command summary

Invocation

   

debug [-V] [-i c|x] [-X opt] [-d defaults] [-s path] [-Yitem,dir] [[-f none|procs|all] [-r] [-l start_loc] cmd_line] debug [-V] [-i c|x] [-X opt] [-d defaults] [-s path] [-Yitem,dir] [-f none|procs|all] [-l object_file] live_object ... debug [-V] [-i c|x] [-X opt] [-d defaults] [-s path] [-Yitem,dir] -c core_file object_file

Process Control

   

cancel [-p proc_list] [signal . . . ] create [-dr] [-f all|none|procs] [-dr] [-l start_loc] [cmd_line] grab [-f all|none|procs] [-l object_file] live_object . . . grab -c core_file object_file halt [-p proc_list] input [-p proc_name|-r pseudo-tty] [-n] input_string jump [-p proc_list] location kill [-p proc_list] [signal] rename prog_name name ps [-p proc_list] release [-s] [-p proc_list] run [-p proc_list] [-bfr] [-u location] step [-p proc_list] [-bfioq] [-c count]

Events

   

change event_num [-p proc_list] [-eqvx] [-c count] [throw|catch] [stop_expr|call . . . | signal . . . |type] [commands] delete event_num . . . delete -a [-p proc_list] [event_command] disable event_num . . . disable -a [-p proc_list] [event_command] enable event_num . . . enable -a [-p proc_list] [event_command] events [-p proc_list] [event_num . . .] exception -d [-i] [throw|catch] exception [-p proc_list] [[-iq] [throw|catch] type [command]] onstop [-p proc_list] [command] signal [-p proc_list] [[-iq] signal . . . [command]] signal -d [-i] [signal . . . ] stop [-p proc_list] [[-q] [-c count] stop_expr [command]] syscall [-p proc_list] [[-eqx] [-c count] call . . . [command]]

Display

   

dis [-p proc_list] [-c instr_count] [-ns] [location] [end_location] dump [-p proc_list] [-c byte_count] [-b] expression export $username list -p[proc_list] [-c count] [thread_id@][file_name@]func_name list -p[proc_list] [-c count] [thread_id@][file_name@]line_num list -p[proc_list] [-c count] /reg_exp/ list -p[proc_list] [-c count] ?reg_exp? list -p[proc_list] [-c count] map [-p proc_list] print [-p proc_list] [-f fmt] [-v] expr [, expr] ... regs [-p proc_list] set [-p proc_list] debug_or_user_variable [=] expr [, expr] ... set [-p proc_list] [-v] language_expression stack [-p proc_list] [-c count] [-f frame] [-a address] [-s stack] symbols [-p proc_list] [-o shared_object] [-n file_name] [-dfgltuv] [pattern] whatis [-p proc_list] expr

Miscellaneous

   

! cmd_line # comment alias [name [tokens]] alias [name] alias -r name break cd [pathname] continue fc [-e ename] [-nlr] [first [last]] fc -e - [old=new] [command] help [topic] if (expr) cmd [else cmd] logon [filename] logoff pwd quit script [-q] fname while (expr) cmd

Command Syntax


block:
{ cmd_list }

cmd_list:
cmd

cmd sep cmd_list

sep:
;

new_line

cmd:
block

simple_command

simple_command:
All debugger commands

proc_name:
all

%thread

%proc

%program

process_id

ppid

program_name

$username

proc_list:
proc_name

proc_list , proc_name

stop_expr:
stop_event || stop_expr
stop_event && stop_expr

stop_event

stop_event:

location

*lvalue

( expr )

Built-in Aliases

   

b => stop exit => quit h => help history => fc -1 l => list n => next next => step -o ni => step -io p => print q => quit r => run rr => fc -e s => step si => step -i sig => signal syms => symbols sys => syscall t => stack

Format Specifiers

Character Meaning
a, A Floating point in hexadecimal with
  decimal exponent (as power of two)
b, B Unsigned binary integer
C wide character
c unsigned character
d, i signed decimal integer
e, E floating point style [-]d.ddde±dd or [-]d.dddE±dd
f floating point style [-]ddd.ddd
g, G floating point in either of the 2 styles (e,E or f,F)
o unsigned octal integer
p void *(generic pointer, hexadecimal address)
s string
S Wide character string
u unsigned decimal integer
x, X unsigned hexadecimal integer
z debugger default style for the expression
% '%'


NOTE: a, A, b, B, C and S are not available on all systems.


Next topic: Debugger variable description
Previous topic: Code in header files

© 2005 The SCO Group, Inc. All rights reserved.
SCO OpenServer Release 6.0.0 -- 02 June 2005