411 REFERENCE · Wikibooks
GCC Debugging/gdb
Reference material by Wikibooks contributors. This retains its source identity and is not 411 news reporting.
Preping for the debugger
program must first be compiled for debugging:
gcc -g <filname.c> -o <output filename>
eg: gcc -g debug_me.c -o debug_me
the "-g" flag is important (To create symbol table)
Starting the debugger
start the debugger with:
gdb <program name>
eg: gdb debug_me
common commands
run, print, where, break, cond, step, next, set, ignore
run
runs the program
to pass arguments to the program on run:
run <arg1> <arg2>
eg: run 12 35
eg: run "hello world" "goodbye world"
break
sets a "breakpoint" at a certain area \ function
break <function name>
eg: break main
or
eg: b main
break <filename>:<line of code to stop in>
eg: break debug_me.c:5
b
shorthand for break
next
execute next line of code
eg: next
step
next line of code, stepping into functions
eg: step
continue
go to next breakpoint or end of program
cont
shorthand for continue
print
print out a variables \ expressions contents
print <variable name>
eg: print x
disp
prints out a variable \ expression value every step
eg: disp x
undisplay
cancel a display command
eg: undisplay 3
would stop the var at pos 3 from displaying every time
where
move within the call stack
...
up and down
up: previous step inside call stack
down: next step inside call stack
list
shows code at a certain location
list <no args>
code at current location and then at next location if typed again
eg: list
list -
shows code at previous location and then at the location before that if typed again
list <function name>
shows code in function definition
eg: list func1
cond
conditional
cond <breakpoint> <condition>
eg: cond 1 val>0
stop at breakpoint "1" when "val" becomes greater than 0
set
change a value, eg
set variable x = 12
will change x's value to 12
ignore
ignore a breakpoint for a user specified number of times.
usage: ignore <id> <count>
ignore 2 20 --> Breakpoint 2 will not be hit for 20 times.
quit
exits the gdb
q
shorthand for quit