| Line 174... |
Line 174... |
@cindex collections of files
|
@cindex collections of files
|
|
|
@c man title ar create, modify, and extract from archives
|
@c man title ar create, modify, and extract from archives
|
|
|
@smallexample
|
@smallexample
|
ar [@option{--plugin} @var{name}] [-]@var{p}[@var{mod} [@var{relpos}] [@var{count}]] @var{archive} [@var{member}@dots{}]
|
ar [@option{--plugin} @var{name}] [-]@var{p}[@var{mod} [@var{relpos}] [@var{count}]] [@option{--target} @var{bfdname}] @var{archive} [@var{member}@dots{}]
|
ar -M [ <mri-script ]
|
ar -M [ <mri-script ]
|
@end smallexample
|
@end smallexample
|
|
|
@c man begin DESCRIPTION ar
|
@c man begin DESCRIPTION ar
|
|
|
| Line 249... |
Line 249... |
@node ar cmdline
|
@node ar cmdline
|
@section Controlling @command{ar} on the Command Line
|
@section Controlling @command{ar} on the Command Line
|
|
|
@smallexample
|
@smallexample
|
@c man begin SYNOPSIS ar
|
@c man begin SYNOPSIS ar
|
ar [@option{--plugin} @var{name}] [@option{-X32_64}] [@option{-}]@var{p}[@var{mod} [@var{relpos}] [@var{count}]] @var{archive} [@var{member}@dots{}]
|
ar [@option{--plugin} @var{name}] [@option{-X32_64}] [@option{-}]@var{p}[@var{mod} [@var{relpos}] [@var{count}]] [@option{--target} @var{bfdname}] @var{archive} [@var{member}@dots{}]
|
@c man end
|
@c man end
|
@end smallexample
|
@end smallexample
|
|
|
@cindex Unix compatibility, @command{ar}
|
@cindex Unix compatibility, @command{ar}
|
When you use @command{ar} in the Unix style, @command{ar} insists on at least two
|
When you use @command{ar} in the Unix style, @command{ar} insists on at least two
|
| Line 381... |
Line 381... |
If you do not specify a @var{member}, all files in the archive
|
If you do not specify a @var{member}, all files in the archive
|
are extracted.
|
are extracted.
|
|
|
Files cannot be extracted from a thin archive.
|
Files cannot be extracted from a thin archive.
|
|
|
|
@item --help
|
|
Displays the list of command line options supported by @command{ar}
|
|
and then exits.
|
|
|
|
@item --version
|
|
Displays the version information of @command{ar} and then exits.
|
|
|
@end table
|
@end table
|
|
|
A number of modifiers (@var{mod}) may immediately follow the @var{p}
|
A number of modifiers (@var{mod}) may immediately follow the @var{p}
|
keyletter, to specify variations on an operation's behavior:
|
keyletter, to specify variations on an operation's behavior:
|
|
|
| Line 504... |
Line 511... |
The optional command line switch @option{--plugin} @var{name} causes
|
The optional command line switch @option{--plugin} @var{name} causes
|
@command{ar} to load the plugin called @var{name} which adds support
|
@command{ar} to load the plugin called @var{name} which adds support
|
for more file formats. This option is only available if the toolchain
|
for more file formats. This option is only available if the toolchain
|
has been built with plugin support enabled.
|
has been built with plugin support enabled.
|
|
|
|
The optional command line switch @option{--target} @var{bfdname}
|
|
specifies that the archive members are in an object code format
|
|
different from your system's default format. See
|
|
@xref{Target Selection}, for more information.
|
|
|
@c man end
|
@c man end
|
|
|
@ignore
|
@ignore
|
@c man begin SEEALSO ar
|
@c man begin SEEALSO ar
|
nm(1), ranlib(1), and the Info entries for @file{binutils}.
|
nm(1), ranlib(1), and the Info entries for @file{binutils}.
|
| Line 4260... |
Line 4272... |
@itemx --input-mach=@var{machine}
|
@itemx --input-mach=@var{machine}
|
Set the matching input ELF machine type to @var{machine}. If
|
Set the matching input ELF machine type to @var{machine}. If
|
@option{--input-mach} isn't specified, it will match any ELF
|
@option{--input-mach} isn't specified, it will match any ELF
|
machine types.
|
machine types.
|
|
|
The supported ELF machine types are, @var{L1OM} and @var{x86-64}.
|
The supported ELF machine types are, @var{L1OM}, @var{K1OM} and
|
|
@var{x86-64}.
|
|
|
@itemx --output-mach=@var{machine}
|
@itemx --output-mach=@var{machine}
|
Change the ELF machine type in the ELF header to @var{machine}. The
|
Change the ELF machine type in the ELF header to @var{machine}. The
|
supported ELF machine types are the same as @option{--input-mach}.
|
supported ELF machine types are the same as @option{--input-mach}.
|
|
|
| Line 4281... |
Line 4294... |
@itemx --input-osabi=@var{osabi}
|
@itemx --input-osabi=@var{osabi}
|
Set the matching input ELF file OSABI to @var{osabi}. If
|
Set the matching input ELF file OSABI to @var{osabi}. If
|
@option{--input-osabi} isn't specified, it will match any ELF OSABIs.
|
@option{--input-osabi} isn't specified, it will match any ELF OSABIs.
|
|
|
The supported ELF OSABIs are, @var{none}, @var{HPUX}, @var{NetBSD},
|
The supported ELF OSABIs are, @var{none}, @var{HPUX}, @var{NetBSD},
|
@var{Linux}, @var{Hurd}, @var{Solaris}, @var{AIX}, @var{Irix},
|
@var{GNU}, @var{Linux} (alias for @var{GNU}),
|
|
@var{Solaris}, @var{AIX}, @var{Irix},
|
@var{FreeBSD}, @var{TRU64}, @var{Modesto}, @var{OpenBSD}, @var{OpenVMS},
|
@var{FreeBSD}, @var{TRU64}, @var{Modesto}, @var{OpenBSD}, @var{OpenVMS},
|
@var{NSK}, @var{AROS} and @var{FenixOS}.
|
@var{NSK}, @var{AROS} and @var{FenixOS}.
|
|
|
@itemx --output-osabi=@var{osabi}
|
@itemx --output-osabi=@var{osabi}
|
Change the ELF OSABI in the ELF header to @var{osabi}. The
|
Change the ELF OSABI in the ELF header to @var{osabi}. The
|
