edb.1

.\"Text automatically generated by txt2man
.TH EDB 1 "December 2011" "" ""
.SH NAME
\fBedb \fP- graphical debugger and disassembler for executables
.SH SYNOPSIS
.nf
.fam C
 \fBedb\fP [OPTION]\.\.\. [\fITARGET\fP]
.fam T
.fi
.fam T
.fi
.SH DESCRIPTION
\fBedb\fP (Evan's Debugger) is a modular and modern disassembler and debugger for
binary ELF files based on ptrace API and the capstone disassembly library.
.TP
.B
\fB--help\fP
Show usage and exit.
.TP
.B
\fB--symbols\fP <file>
generate symbols map for file <file>
.TP
.B
\fB--attach\fP <pid>
attach the process of PID <pid> to debugger
.TP
.B
\fB--run\fP <program> [args\.\.\.]
open <program> in debugger with optional [args\.\.\.]
.TP
.B
\fB--version\fP
show version string and exit.
.TP
.B
\fB--dump-version\fP
show version and exit.
.SH EXAMPLE
\fBedb\fP \fB--symbols\fP /lib/libc.so.6 > libc.so.6.map
.PP
.nf
.fam C
     Will generate symbols for libc and save it in a text file. It's useful if you store this map files in the symbols directory configured in edb's preferences.

.fam T
.fi
for i in $(ls /lib); do \fBedb\fP \fB--symbols\fP $i > $(basename $i).map; done
.PP
.nf
.fam C
      Useful to generate maps for all libs you have in /lib.

.fam T
.fi
\fBedb\fP \fB--run\fP /bin/ls
.PP
.nf
.fam C
      Will open the ls program binary in debugger.

.fam T
.fi
\fBedb\fP \fB--attach\fP 1720
.PP
.nf
.fam C
     Attach the process of PID 1720 to debugger.
.fam T
.fi
.SH AUTHOR
Written by Evan Teran <evan.teran@gmail.com>
.SH REPORTING BUGS
Report any bugs or requests for features via BTS on https://github.com/eteran/edb-debugger/issues
.SH COPYRIGHT
Copyright © 2008 CodeF00. Licensed GPLv2: GNU GPL version 2 <http://www.gnu.org/licenses/old-licenses/gpl-2.0.txt>. This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.