@cindex archives
@cindex collections of files
@smallexample
- ar [-]@var{p}@var{mod} [ @var{membername} ] @var{archive} @var{file@dots{}}
+ ar [-]@var{p}@var{mod} [ @var{membername} ] @var{archive} @var{file}@dots{}
ar -M [ <mri-script ]
@end smallexample
@section Controlling @code{ar} on the command line
@smallexample
- ar [-]@var{p}@var{mod} [ @var{membername} ] @var{archive} @var{file@dots{}}
+ ar [-]@var{p}@var{mod} [ @var{membername} ] @var{archive} @var{file}@dots{}
@end smallexample
@cindex Unix compatibility, @code{ar}
@item d
@cindex deleting from archive
@emph{Delete} modules from the archive. Specify the names of modules to
-be deleted as @var{file@dots{}}; the archive is untouched if you
+be deleted as @var{file}@dots{}; the archive is untouched if you
specify no files to delete.
If you specify the @samp{v} modifier, @code{ar} lists each module
@item q
@cindex quick append to archive
-@emph{Quick append}; add the files @var{file@dots{}} to the end of
+@emph{Quick append}; add the files @var{file}@dots{} to the end of
@var{archive}, without checking for replacement.
The modifiers @samp{a}, @samp{b}, and @samp{i} do @emph{not} affect this
@item r
@cindex replacement in archive
-Insert the files @var{file@dots{}} into @var{archive} (with
+Insert the files @var{file}@dots{} into @var{archive} (with
@emph{replacement}). This operation differs from @samp{q} in that any
previously existing members are deleted if their names match those being
added.
-If one of the files named in @var{file@dots{}} doesn't exist, @code{ar}
+If one of the files named in @var{file}@dots{} doesn't exist, @code{ar}
displays an error message, and leaves undisturbed any existing members
of the archive matching that name.
@item t
@cindex contents of archive
Display a @emph{table} listing the contents of @var{archive}, or those
-of the files listed in @var{file@dots{}} that are present in the
+of the files listed in @var{file}@dots{} that are present in the
archive. Normally only the member name is shown; if you also want to
see the modes (permissions), timestamp, owner, group, and size, you can
request that by also specifying the @samp{v} modifier.
@item u
@cindex updating an archive
-Normally, @samp{ar r@dots{}} inserts all files
+Normally, @samp{ar r}@dots{} inserts all files
listed into the archive. If you would like to insert @emph{only} those
of the files you list that are newer than existing members of the same
names, use this modifier. The @samp{u} modifier is allowed only for the
List each named @var{module} present in @var{archive}. The separate
command @code{VERBOSE} specifies the form of the output: when verbose
output is off, output is like that of @samp{ar -t @var{archive}
-@var{module@dots{}}}. When verbose output is on, the listing is like
-@samp{ar -tv @var{archive} @var{module@dots{}}}.
+@var{module}@dots{}}. When verbose output is on, the listing is like
+@samp{ar -tv @var{archive} @var{module}@dots{}}.
Output normally goes to the standard output stream; however, if you
specify @var{outputfile} as a final argument, @code{ar} directs the
@item EXTRACT @var{module}, @var{module}, @dots{} @var{module}
Extract each named @var{module} from the current archive, writing them
into the current directory as separate files. Equivalent to @samp{ar -x
-@var{archive} @var{module@dots{}}}.
+@var{archive} @var{module}@dots{}}.
Requires prior use of @code{OPEN} or @code{CREATE}.
@item VERBOSE
Toggle an internal flag governing the output from @code{DIRECTORY}.
When the flag is on, @code{DIRECTORY} output matches output from
-@samp{ar -tv @dots{}}.
+@samp{ar -tv }@dots{}.
@item SAVE
Commit your changes to the current archive, and actually save it as a
[ -n | --numeric-sort ] [ -p | --no-sort ]
[ -r | --reverse-sort ] [ -u | --undefined-only ]
[ --target=@var{bfdname} ]
- [ @var{objfile@dots{}} ]
+ [ @var{objfile}@dots{} ]
@end smallexample
-GNU @code{nm} lists the symbols from object files @var{objfile@dots{}}.
+GNU @code{nm} lists the symbols from object files @var{objfile}@dots{}.
The long and short forms of options, shown here as alternatives, are
equivalent.
@table @code
-@item @var{objfile@dots{}}
+@item @var{objfile}@dots{}
@kindex a.out
Object files whose symbols are to be listed. If no object files are
listed as arguments, @code{nm} assumes @samp{a.out}.
[ -h | --header ] [ -i ] [ -j @var{section} ] [ -l ]
[ -m @var{machine} ] [ -r | --reloc ] [ -s ]
[ --stabs ] [ -t | --syms ] [ -x ]
- @var{objfile@dots{}}
+ @var{objfile}@dots{}
@end smallexample
@code{objdump} displays information about one or more object files.
equivalent.
@table @code
-@item @var{objfile@dots{}}
+@item @var{objfile}@dots{}
The object files to be examined. When you specify archives,
@code{objdump} shows information on each of the member object files.
size [ -A | -B | --format=@var{compatibility} ]
[ --help ] [ -d | -o | -x | --radix=@var{number} ]
[ --target=@var{bfdname} ] [ -V | --version ]
- @var{objfile@dots{}}
+ @var{objfile}@dots{}
@end smallexample
The GNU @code{size} utility lists the section sizes---and the total
The command line options have the following meanings:
@table @code
-@item @var{objfile@dots{}}
+@item @var{objfile}@dots{}
The object files to be examined.
@item -A
@cindex symbols, discarding
@smallexample
-strip [-F @var{format} | --format=@var{format} ]
- [-I @var{format} | --input-format=@var{format} ]
- [-O @var{format} | --output-format=@var{format} ]
+strip [ -F @var{format} | --format=@var{format} | --target=@var{format} ]
+ [ -I @var{format} | --input-format=@var{format} ]
+ [ -O @var{format} | --output-format=@var{format} ]
+ [ -s | --strip-all ] [ -S | -g | --strip-debug ]
+ [ -x | --discard-all ] [ -X | --discard-locals ]
[ -v | --verbose ] [ -V | --version ]
- @var{objfile@dots{}}
+ @var{objfile}@dots{}
@end smallexample
GNU @code{strip} discards all symbols from object files
@item -F @var{format}
@itemx --format=@var{format}
+@itemx --target=@var{format}
Treat the original @var{objfile} as a file with the object
code format @var{format}, and rewrite it in the same format.
+@item -s
+@itemx --strip-all
+Remove all symbols.
+
@item -g
@itemx -S
@itemx --strip-debug