mirror of
https://github.com/darlinghq/darling-gdb.git
synced 2024-11-24 20:49:43 +00:00
Document missing options. Use -- instead of + for long options.
This commit is contained in:
parent
ff580c7b96
commit
1f72cab137
@ -14,7 +14,7 @@ ar\(em\&create, modify, and extract from archives.
|
||||
.hy 0
|
||||
.na
|
||||
.BR ar " [\|" "-" "\|]"\c
|
||||
.I pmod \c
|
||||
.I {dmpqrtx}[abcilosuvV] \c
|
||||
[\|\c
|
||||
.I membername\c
|
||||
\&\|] \c
|
||||
@ -79,7 +79,7 @@ their placement in the archive.
|
||||
You may use `\|\c
|
||||
.B nm \-s\c
|
||||
\|' or `\|\c
|
||||
.B nm +print-armap\c
|
||||
.B nm \-\-print\-armap\c
|
||||
\|' to list this index
|
||||
table. If an archive lacks the table, another form of \c
|
||||
.B ar\c
|
||||
@ -435,6 +435,11 @@ when the modifier `\|\c
|
||||
.B v\c
|
||||
\|' is appended.
|
||||
|
||||
.TP
|
||||
.B V
|
||||
This modifier shows the version number of
|
||||
.BR ar .
|
||||
|
||||
.PP
|
||||
|
||||
.SH "SEE ALSO"
|
||||
|
@ -15,19 +15,19 @@ nm\(em\&list symbols from object files.
|
||||
.na
|
||||
.TP
|
||||
.B nm
|
||||
.RB "[\|" \-a | +debug-syms "\|]"
|
||||
.RB "[\|" \-g | +extern-only "\|]"
|
||||
.RB "[\|" \-s | +print-armap "\|]"
|
||||
.RB "[\|" \-o | +print-file-name "\|]"
|
||||
.RB "[\|" \-n | +numeric-sort "\|]"
|
||||
.RB "[\|" \-p | +no-sort "\|]"
|
||||
.RB "[\|" \-r | +reverse-sort "\|]"
|
||||
.RB "[\|" \-u | +undefined-only "\|]"
|
||||
.RB "[\|" "+target\ "\c
|
||||
.RB "[\|" \-a | \-\-debug\-syms "\|]"
|
||||
.RB "[\|" \-g | \-\-extern\-only "\|]"
|
||||
.RB "[\|" \-s | \-\-print\-armap "\|]"
|
||||
.RB "[\|" \-o | \-\-print\-file\-name "\|]"
|
||||
.RB "[\|" \-n | \-\-numeric\-sort "\|]"
|
||||
.RB "[\|" \-p | \-\-no\-sort "\|]"
|
||||
.RB "[\|" \-r | \-\-reverse\-sort "\|]"
|
||||
.RB "[\|" \-u | \-\-undefined\-only "\|]"
|
||||
.RB "[\|" "\-\-target="\c
|
||||
.I bfdname\c
|
||||
\&\|]
|
||||
.RB "[\|" \c
|
||||
.I objfiles\c
|
||||
.I objfile\c
|
||||
\&.\|.\|.\|]
|
||||
.ad b
|
||||
.hy 1
|
||||
@ -35,7 +35,7 @@ nm\(em\&list symbols from object files.
|
||||
GNU \c
|
||||
.B nm\c
|
||||
\& will list the symbols from object files \c
|
||||
.I objfiles\c
|
||||
.I objfile\c
|
||||
\&.
|
||||
|
||||
.SH OPTIONS
|
||||
@ -43,7 +43,7 @@ The long and short forms of options, shown here as alternatives, are
|
||||
equivalent.
|
||||
|
||||
.TP
|
||||
.IR "objfiles" .\|.\|.
|
||||
.IR "objfile" .\|.\|.
|
||||
Object files whose symbols are to be listed. If no object files are
|
||||
listed as arguments, \c
|
||||
.B nm\c
|
||||
@ -54,33 +54,33 @@ listed as arguments, \c
|
||||
.TP
|
||||
.B \-a
|
||||
.TP
|
||||
.B +debug-syms
|
||||
.B \-\-debug\-syms
|
||||
Display debugger-only symbols; normally these are not listed.
|
||||
|
||||
.TP
|
||||
.B \-g
|
||||
.TP
|
||||
.B +extern-only
|
||||
.B \-\-extern\-only
|
||||
Display only external symbols.
|
||||
|
||||
.TP
|
||||
.B \-p
|
||||
.TP
|
||||
.B +no-sort
|
||||
.B \-\-no\-sort
|
||||
Don't bother to sort the symbols in any order; just print them in the
|
||||
order encountered.
|
||||
|
||||
.TP
|
||||
.B \-n
|
||||
.TP
|
||||
.B +numeric-sort
|
||||
.B \-\-numeric\-sort
|
||||
Sort symbols numerically by their addresses, not alphabetically by their
|
||||
names.
|
||||
|
||||
.TP
|
||||
.B \-s
|
||||
.TP
|
||||
.B +print-armap
|
||||
.B \-\-print\-armap
|
||||
When listing symbols from archive members, include the index: a mapping
|
||||
(stored in the archive by \c
|
||||
.B ar\c
|
||||
@ -92,7 +92,7 @@ contain definitions for what names.
|
||||
.TP
|
||||
.B \-o
|
||||
.TP
|
||||
.B +print-file-name
|
||||
.B \-\-print\-file\-name
|
||||
Precede each symbol by the name of the input file where it was found,
|
||||
rather than identifying the input file once only before all of its
|
||||
symbols.
|
||||
@ -100,12 +100,12 @@ symbols.
|
||||
.TP
|
||||
.B \-r
|
||||
.TP
|
||||
.B +reverse-sort
|
||||
.B \-\-reverse\-sort
|
||||
Reverse the sense of the sort (whether numeric or alphabetic); let the
|
||||
last come first.
|
||||
|
||||
.TP
|
||||
.BI "+target " "bfdname"\c
|
||||
.BI "\-\-target " "bfdname"\c
|
||||
\&
|
||||
Specify an object code format other than your system's default format.
|
||||
See
|
||||
@ -115,7 +115,7 @@ for information on listing available formats.
|
||||
.TP
|
||||
.B \-u
|
||||
.TP
|
||||
.B +undefined-only
|
||||
.B \-\-undefined\-only
|
||||
Display only undefined symbols (those external to each object file).
|
||||
|
||||
.PP
|
||||
|
@ -21,7 +21,7 @@ objdump\(em\&display information from object files.
|
||||
\&\|]
|
||||
.RB "[\|" \-d "\|]"
|
||||
.RB "[\|" \-f "\|]"
|
||||
.RB "[\|" \-h | --header "\|]"
|
||||
.RB "[\|" \-h | \-\-header "\|]"
|
||||
.RB "[\|" \-i "\|]"
|
||||
.RB "[\|" "\-j\ "\c
|
||||
.I section\c
|
||||
@ -30,12 +30,12 @@ objdump\(em\&display information from object files.
|
||||
.RB "[\|" "\-m\ "\c
|
||||
.I machine\c
|
||||
\&\|]
|
||||
.RB "[\|" \-r | --reloc "\|]"
|
||||
.RB "[\|" \-r | \-\-reloc "\|]"
|
||||
.RB "[\|" \-s "\|]"
|
||||
.RB "[\|" \--stabs "\|]"
|
||||
.RB "[\|" \-t | --syms "\|]"
|
||||
.RB "[\|" \-\-stabs "\|]"
|
||||
.RB "[\|" \-t | \-\-syms "\|]"
|
||||
.RB "[\|" \-x "\|]"
|
||||
.I objfiles\c
|
||||
.I objfile\c
|
||||
\&.\|.\|.
|
||||
.ad b
|
||||
.hy 1
|
||||
@ -52,7 +52,7 @@ Where long and short forms of an option are shown together, they are
|
||||
equivalent.
|
||||
|
||||
.TP
|
||||
.IR "objfiles" .\|.\|.
|
||||
.IR "objfile" .\|.\|.
|
||||
The object files to be examined. When you specify archives,
|
||||
\c
|
||||
.B objdump\c
|
||||
@ -61,7 +61,7 @@ The object files to be examined. When you specify archives,
|
||||
.TP
|
||||
.B \-a
|
||||
If any files from \c
|
||||
.I objfiles\c
|
||||
.I objfile\c
|
||||
\& are archives, display the archive
|
||||
header information (in a format similar to `\|\c
|
||||
.B ls \-l\c
|
||||
@ -106,20 +106,20 @@ formats available with the `\|\c
|
||||
.B \-d
|
||||
Disassemble. Display the assembler mnemonics for the machine
|
||||
instructions from \c
|
||||
.I objfiles\c
|
||||
.I objfile\c
|
||||
\&.
|
||||
|
||||
.TP
|
||||
.B \-f
|
||||
File header. Display summary information from the overall header of
|
||||
each file in \c
|
||||
.I objfiles\c
|
||||
.I objfile\c
|
||||
\&.
|
||||
|
||||
.TP
|
||||
.B \-h
|
||||
.TP
|
||||
.B --header
|
||||
.B \-\-header
|
||||
Header. Display summary information from the section headers of the
|
||||
object file.
|
||||
|
||||
@ -148,7 +148,7 @@ and line numbers corresponding to the object code shown.
|
||||
.BI "-m " "machine"\c
|
||||
\&
|
||||
Specify the object files \c
|
||||
.I objfiles\c
|
||||
.I objfile\c
|
||||
\& are for architecture
|
||||
\c
|
||||
.I machine\c
|
||||
@ -160,7 +160,7 @@ option.
|
||||
.TP
|
||||
.B \-r
|
||||
.TP
|
||||
.B --reloc
|
||||
.B \-\-reloc
|
||||
Relocation. Print the relocation entries of the file.
|
||||
|
||||
.TP
|
||||
@ -168,18 +168,18 @@ Relocation. Print the relocation entries of the file.
|
||||
Display the full contents of any sections requested.
|
||||
|
||||
.TP
|
||||
.B \--stabs
|
||||
.B \-\-stabs
|
||||
Display the contents of the .stab, .stab.index, and .stab.excl
|
||||
sections from an ELF file. This is only useful on systems (such as
|
||||
Solaris 2.0) in which .stab debugging symbol-table entries are carried
|
||||
in an ELF section. In most other file formats, debugging symbol-table
|
||||
entries are interleaved with linkage symbols, and are visible in the
|
||||
--syms output.
|
||||
\-\-syms output.
|
||||
|
||||
.TP
|
||||
.B \-t
|
||||
.TP
|
||||
.B --syms
|
||||
.B \-\-syms
|
||||
Symbol Table. Print the symbol table entries of the file.
|
||||
This is similar to the information provided by the `\|\c
|
||||
.B nm\c
|
||||
|
@ -16,18 +16,18 @@ size\(em\&list section sizes and total size.
|
||||
.TP
|
||||
.B size
|
||||
.RB "[\|" \-A \||\| \-B \||\| \c
|
||||
.BI "+format\ " compatibility\c
|
||||
.BI "\-\-format=" compatibility\c
|
||||
\&\|]
|
||||
.RB "[\|" +help "\|]"
|
||||
.RB "[\|" \-\-help "\|]"
|
||||
.RB "[\|" \-d \||\| \-o \||\| \-x\c
|
||||
\||\|\c
|
||||
.BI "+radix\ " number\c
|
||||
.BI "\-\-radix=" number\c
|
||||
\&\|]
|
||||
.RB "[\|" \c
|
||||
.BI "+target\ " bfdname\c
|
||||
.BI "\-\-target=" bfdname\c
|
||||
\&\|]
|
||||
.RB "[\|" \-V \||\| +version "\|]"
|
||||
.I objfiles\c
|
||||
.RB "[\|" \-V \||\| \-\-version "\|]"
|
||||
.I objfile\c
|
||||
\&.\|.\|.
|
||||
.ad b
|
||||
.hy 1
|
||||
@ -36,14 +36,14 @@ The GNU \c
|
||||
.B size\c
|
||||
\& utility lists the section sizes\(em\&and the total
|
||||
size\(em\&for each of the object files \c
|
||||
.I objfiles\c
|
||||
.I objfile\c
|
||||
\& in its argument list.
|
||||
By default, one line of output is generated for each object file or each
|
||||
module in an archive.
|
||||
|
||||
.SH OPTIONS
|
||||
.TP
|
||||
.IR "objfiles" .\|.\|.
|
||||
.IR "objfile" .\|.\|.
|
||||
The object files to be examined.
|
||||
|
||||
.TP
|
||||
@ -51,7 +51,7 @@ The object files to be examined.
|
||||
.TP
|
||||
.B \-B
|
||||
.TP
|
||||
.BI "+format " "compatibility"\c
|
||||
.BI "\-\-format " "compatibility"\c
|
||||
\&
|
||||
Using one of these options, you can choose whether the output from GNU
|
||||
\c
|
||||
@ -62,19 +62,19 @@ Using one of these options, you can choose whether the output from GNU
|
||||
.B \-A\c
|
||||
\|',
|
||||
or `\|\c
|
||||
.B +format sysv\c
|
||||
.B \-\-format sysv\c
|
||||
\|'), or Berkeley \c
|
||||
.B size\c
|
||||
\& (using `\|\c
|
||||
.B \-B\c
|
||||
\|', or
|
||||
`\|\c
|
||||
.B +format berkeley\c
|
||||
.B \-\-format berkeley\c
|
||||
\|'). The default is the one-line format similar to
|
||||
Berkeley's.
|
||||
|
||||
.TP
|
||||
.B +help
|
||||
.B \-\-help
|
||||
Show a summary of acceptable arguments and options.
|
||||
|
||||
.TP
|
||||
@ -84,25 +84,25 @@ Show a summary of acceptable arguments and options.
|
||||
.TP
|
||||
.B \-x
|
||||
.TP
|
||||
.BI "+radix " "number"\c
|
||||
.BI "\-\-radix " "number"\c
|
||||
\&
|
||||
Using one of these options, you can control whether the size of each
|
||||
section is given in decimal (`\|\c
|
||||
.B \-d\c
|
||||
\|', or `\|\c
|
||||
.B +radix 10\c
|
||||
.B \-\-radix 10\c
|
||||
\|'); octal
|
||||
(`\|\c
|
||||
.B \-o\c
|
||||
\|', or `\|\c
|
||||
.B +radix 8\c
|
||||
.B \-\-radix 8\c
|
||||
\|'); or hexadecimal (`\|\c
|
||||
.B \-x\c
|
||||
\|', or
|
||||
`\|\c
|
||||
.B +radix 16\c
|
||||
.B \-\-radix 16\c
|
||||
\|'). In `\|\c
|
||||
.B +radix \c
|
||||
.B \-\-radix \c
|
||||
.I number\c
|
||||
\&\c
|
||||
\|', only the three
|
||||
@ -117,10 +117,10 @@ octal and hexadecimal if you're using `\|\c
|
||||
\|'.
|
||||
|
||||
.TP
|
||||
.BI "+target " "bfdname"\c
|
||||
.BI "\-\-target " "bfdname"\c
|
||||
\&
|
||||
You can specify a particular object-code format for \c
|
||||
.I objfiles\c
|
||||
.I objfile\c
|
||||
\& as
|
||||
\c
|
||||
.I bfdname\c
|
||||
@ -135,7 +135,7 @@ on listing available formats.
|
||||
.TP
|
||||
.B \-V
|
||||
.TP
|
||||
.B +version
|
||||
.B \-\-version
|
||||
Display version number information on \c
|
||||
.B size\c
|
||||
\& itself.
|
||||
|
@ -11,24 +11,31 @@
|
||||
strip\(em\&Discard symbols from object files.
|
||||
|
||||
.SH SYNOPSIS
|
||||
.B strip\c
|
||||
.RB " [\|" \-v "\|] "\c
|
||||
.I objfiles\c
|
||||
.B strip
|
||||
.RB "[\|" "\-F \fIformat\fP" | \-\-format=\fIformat\fP | \-\-target=\fIformat\fP "\|]"
|
||||
.RB "[\|" "\-I \fIformat\fP" | \-\-input\-format=\fIformat\fP "\|]"
|
||||
.RB "[\|" "\-O \fIformat\fP" | \-\-output\-format=\fIformat\fP "\|]"
|
||||
.RB "[\|" \-s | \-\-strip\-all "\|]"
|
||||
.RB "[\|" \-S | -g | \-\-strip\-debug "\|]"
|
||||
.RB "[\|" \-x | \-\-discard\-all "\|]"
|
||||
.RB "[\|" \-X | \-\-discard\-locals "\|]"
|
||||
.RB "[\|" \-v | \-\-verbose "\|]"
|
||||
.RB "[\|" \-V | \-\-version "\|]"
|
||||
.I objfile\c
|
||||
\&.\|.\|.
|
||||
|
||||
.SH DESCRIPTION
|
||||
GNU \c
|
||||
.B strip\c
|
||||
\& will discard all symbols from object files
|
||||
\& discards all symbols from the object files
|
||||
\c
|
||||
.I objfiles\c
|
||||
.I objfile\c
|
||||
\&. The list of object files may include archives.
|
||||
|
||||
\c
|
||||
.B strip\c
|
||||
\& will not execute unless at least one object file is listed.
|
||||
|
||||
.I WARNING:\c
|
||||
\& \c
|
||||
.B strip\c
|
||||
\& modifies the files named in its argument,
|
||||
@ -41,6 +48,47 @@ Verbose operation: list all object files modified. In the case of
|
||||
archives, `\|\c
|
||||
.B strip \-v\c
|
||||
\&\|' will list all members of the archive.
|
||||
|
||||
.TP
|
||||
.B "\-F \fIformat\fP \-\-format=\fIformat\fP \-\-target=\fIformat\fP"
|
||||
Treat the original \fIobjfile\fP as a file with the object
|
||||
code format \fIformat\fP, and rewrite it in the same format.
|
||||
|
||||
.TP
|
||||
.B "\-I \fIformat\fP \-\-input\-format=\fIformat\fP"
|
||||
Treat the original \fIobjfile\fP as a file with the object
|
||||
code format \fIformat\fP.
|
||||
|
||||
.TP
|
||||
.B "\-O \fIformat\fP \-\-output\-format=\fIformat\fP"
|
||||
Replace \fIobjfile\fP with a file in the output format \fIformat\fP.
|
||||
|
||||
.TP
|
||||
.B "\-s \-\-strip\-all"
|
||||
Remove all symbols.
|
||||
|
||||
.TP
|
||||
.B "\-S -g \-\-strip\-debug"
|
||||
Remove debugging symbols only.
|
||||
|
||||
.TP
|
||||
.B "\-x \-\-discard\-all"
|
||||
Remove non-global symbols.
|
||||
|
||||
.TP
|
||||
.B "\-X \-\-discard\-locals"
|
||||
Remove compiler-generated local symbols.
|
||||
(These usually start with ``L'' or ``.''.)
|
||||
|
||||
.TP
|
||||
.B "\-v \-\-verbose"
|
||||
Verbose output: list all object files modified. In the case of
|
||||
archives, ``strip -V'' lists all members of the archive.
|
||||
|
||||
.TP
|
||||
.B "\-V \-\-version
|
||||
Show the version number for \fBstrip\fP.
|
||||
|
||||
.PP
|
||||
|
||||
.SH "SEE ALSO"
|
||||
|
Loading…
Reference in New Issue
Block a user