diff options
Diffstat (limited to 'doc/srcfiles.1')
-rw-r--r-- | doc/srcfiles.1 | 33 |
1 files changed, 28 insertions, 5 deletions
diff --git a/doc/srcfiles.1 b/doc/srcfiles.1 index 6149c21b..c6338315 100644 --- a/doc/srcfiles.1 +++ b/doc/srcfiles.1 @@ -21,15 +21,18 @@ eu-srcfiles \- Lists the source files of a DWARF/ELF file. .SH "SYNOPSIS" -eu-srcfiles [\fB\-0\fR|\fB\-\-null\fR] [\fB\-c\fR|\fB\-\-cu\-only\fR] [\fB\-v\fR|\fB\-\-verbose\fR] INPUT +eu-srcfiles [\fB\-0\fR|\fB\-\-null\fR] [\fB\-c\fR|\fB\-\-cu\-only\fR] [\fB\-v\fR|\fB\-\-verbose\fR] [\fB\-z\fR|\fB\-\-zip\fR] INPUT .SH "DESCRIPTION" -\fBeu-srcfiles\fR lists the source files of a given \s-DWARF/ELF\s0 +\fBeu-srcfiles\fR lists all the source files of a given DWARF/ELF file. This list is based on a search of the DWARF debuginfo, which may be automatically fetched by debuginfod if applicable. The target file may be an executable, a coredump, a process, or even the running -kernel. The default is the file 'a.out'. The source file names are -made unique and printed to standard output. +kernel. The default input is the file 'a.out'. The source file names are +made unique by prepending the full path name and then printed to standard output. The source files can be +placed in a zip file that is sent to stdout. + +Note that all occurrences of '/./' and '/../' in the path name are canonicalized. .SH "INPUT OPTIONS" The long and short forms of options, shown here as alternatives, are @@ -81,13 +84,28 @@ Print program version. Separate items by a null instead of a newline. .TP +\fB\-b, \-\-no-backup\fR +Disables local source file search when +debuginfod fails to fetch files. This +option is only applicable when fetching and +zipping files. + +.TP \fB\-c, \-\-cu\-only\fR -Only list the CU names. +Only list the CU (compilation unit) names. .TP \fB\-v, \-\-verbose\fR Increase verbosity of logging messages. +.TP +\fB\-z, \-\-zip\fR +Zip all the source files and send to stdout. +By default, files will be automatically fetched by +debuginfod (if applicable) or locally as a +backup. Any source files that were not found +will not be archived. + .SH EXAMPLES @@ -119,6 +137,11 @@ List the source files of a kernel image. eu-srcfiles -e /boot/vmlinuz-`uname -r` .ESAMPLE +Zip all the source files for a binary. +.SAMPLE +eu-srcfiles -z -e /bin/ls > ls.zip +.ESAMPLE + .SH "AUTHOR" Written by Housam Alamour. |