* Add mention of the -f
, -q
, -S
, and -V
options in the synopsis
section. * Document the `-l`, `-M` and `-S` options. * Improve the text describing the behavior of the `-r` option. * Start a section on standard compliance. * Indicate in the synopsis that the `-S` and `-s` options are mutually exclusive. Obtained from: elftoolchain
This commit is contained in:
parent
78962f36d2
commit
3a870f82fc
Notes:
svn2git
2020-12-20 02:59:44 +00:00
svn path=/head/; revision=216716
106
usr.bin/ar/ar.1
106
usr.bin/ar/ar.1
@ -34,28 +34,42 @@
|
|||||||
.Nm
|
.Nm
|
||||||
.Fl d
|
.Fl d
|
||||||
.Op Fl T
|
.Op Fl T
|
||||||
|
.Op Fl f
|
||||||
.Op Fl j
|
.Op Fl j
|
||||||
.Op Fl v
|
.Op Fl v
|
||||||
.Op Fl z
|
.Op Fl z
|
||||||
.Ar archive
|
.Ar archive
|
||||||
.Ar files ...
|
.Ar
|
||||||
.Nm
|
.Nm
|
||||||
.Fl m
|
.Fl m
|
||||||
.Op Fl T
|
.Op Fl T
|
||||||
.Op Fl a Ar position-after
|
.Op Fl a Ar position-after
|
||||||
.Op Fl b Ar position-before
|
.Op Fl b Ar position-before
|
||||||
|
.Op Fl f
|
||||||
.Op Fl i Ar position-before
|
.Op Fl i Ar position-before
|
||||||
.Op Fl j
|
.Op Fl j
|
||||||
.Op Fl s
|
.Op Fl s | Fl S
|
||||||
.Op Fl z
|
.Op Fl z
|
||||||
.Ar archive
|
.Ar archive
|
||||||
.Ar files ...
|
.Ar
|
||||||
.Nm
|
.Nm
|
||||||
.Fl p
|
.Fl p
|
||||||
.Op Fl T
|
.Op Fl T
|
||||||
|
.Op Fl f
|
||||||
.Op Fl v
|
.Op Fl v
|
||||||
.Ar archive
|
.Ar archive
|
||||||
.Op Ar files ...
|
.Op Ar
|
||||||
|
.Nm
|
||||||
|
.Fl q
|
||||||
|
.Op Fl T
|
||||||
|
.Op Fl c
|
||||||
|
.Op Fl D
|
||||||
|
.Op Fl f
|
||||||
|
.Op Fl s | Fl S
|
||||||
|
.Op Fl v
|
||||||
|
.Op Fl z
|
||||||
|
.Ar archive
|
||||||
|
.Ar
|
||||||
.Nm
|
.Nm
|
||||||
.Fl r
|
.Fl r
|
||||||
.Op Fl T
|
.Op Fl T
|
||||||
@ -63,14 +77,15 @@
|
|||||||
.Op Fl b Ar position-before
|
.Op Fl b Ar position-before
|
||||||
.Op Fl c
|
.Op Fl c
|
||||||
.Op Fl D
|
.Op Fl D
|
||||||
|
.Op Fl f
|
||||||
.Op Fl i Ar position-before
|
.Op Fl i Ar position-before
|
||||||
.Op Fl j
|
.Op Fl j
|
||||||
.Op Fl s
|
.Op Fl s | Fl S
|
||||||
.Op Fl u
|
.Op Fl u
|
||||||
.Op Fl v
|
.Op Fl v
|
||||||
.Op Fl z
|
.Op Fl z
|
||||||
.Ar archive
|
.Ar archive
|
||||||
.Ar files ...
|
.Ar
|
||||||
.Nm
|
.Nm
|
||||||
.Fl s
|
.Fl s
|
||||||
.Op Fl j
|
.Op Fl j
|
||||||
@ -78,19 +93,23 @@
|
|||||||
.Ar archive
|
.Ar archive
|
||||||
.Nm
|
.Nm
|
||||||
.Fl t
|
.Fl t
|
||||||
|
.Op Fl f
|
||||||
.Op Fl T
|
.Op Fl T
|
||||||
.Op Fl v
|
.Op Fl v
|
||||||
.Ar archive
|
.Ar archive
|
||||||
.Op Ar files ...
|
.Op Ar
|
||||||
.Nm
|
.Nm
|
||||||
.Fl x
|
.Fl x
|
||||||
.Op Fl C
|
.Op Fl C
|
||||||
.Op Fl T
|
.Op Fl T
|
||||||
|
.Op Fl f
|
||||||
.Op Fl o
|
.Op Fl o
|
||||||
.Op Fl u
|
.Op Fl u
|
||||||
.Op Fl v
|
.Op Fl v
|
||||||
.Ar archive
|
.Ar archive
|
||||||
.Op Ar files ...
|
.Op Ar
|
||||||
|
.Nm
|
||||||
|
.Fl M
|
||||||
.Nm ranlib
|
.Nm ranlib
|
||||||
.Op Fl D
|
.Op Fl D
|
||||||
.Ar archive ...
|
.Ar archive ...
|
||||||
@ -141,13 +160,13 @@ When used with option
|
|||||||
.Fl m
|
.Fl m
|
||||||
this option specifies that the archive members specified by
|
this option specifies that the archive members specified by
|
||||||
arguments
|
arguments
|
||||||
.Ar files ...
|
.Ar
|
||||||
are moved to after the archive member named by argument
|
are moved to after the archive member named by argument
|
||||||
.Ar member-after .
|
.Ar member-after .
|
||||||
When used with option
|
When used with option
|
||||||
.Fl r
|
.Fl r
|
||||||
this option specifies that the files specified by arguments
|
this option specifies that the files specified by arguments
|
||||||
.Ar files ...
|
.Ar
|
||||||
are added after the archive member named by argument
|
are added after the archive member named by argument
|
||||||
.Ar member-after .
|
.Ar member-after .
|
||||||
.It Fl b Ar member-before
|
.It Fl b Ar member-before
|
||||||
@ -155,13 +174,13 @@ When used with option
|
|||||||
.Fl m
|
.Fl m
|
||||||
this option specifies that the archive members specified by
|
this option specifies that the archive members specified by
|
||||||
arguments
|
arguments
|
||||||
.Ar files ...
|
.Ar
|
||||||
are moved to before the archive member named by argument
|
are moved to before the archive member named by argument
|
||||||
.Ar member-before .
|
.Ar member-before .
|
||||||
When used with option
|
When used with option
|
||||||
.Fl r
|
.Fl r
|
||||||
this option specifies that the files specified by arguments
|
this option specifies that the files specified by arguments
|
||||||
.Ar files ...
|
.Ar
|
||||||
are added before the archive member named by argument
|
are added before the archive member named by argument
|
||||||
.Ar member-before .
|
.Ar member-before .
|
||||||
.It Fl c
|
.It Fl c
|
||||||
@ -176,7 +195,7 @@ Prevent extracted files from replacing like-named files
|
|||||||
in the file system.
|
in the file system.
|
||||||
.It Fl d
|
.It Fl d
|
||||||
Delete the members named by arguments
|
Delete the members named by arguments
|
||||||
.Ar files ...
|
.Ar
|
||||||
from the archive specified by argument
|
from the archive specified by argument
|
||||||
.Ar archive .
|
.Ar archive .
|
||||||
The archive's symbol table, if present, is updated to reflect
|
The archive's symbol table, if present, is updated to reflect
|
||||||
@ -188,7 +207,7 @@ or
|
|||||||
.Fl q
|
.Fl q
|
||||||
option, insert 0's instead of the real mtime, uid and gid values
|
option, insert 0's instead of the real mtime, uid and gid values
|
||||||
and 0644 instead of file mode from the members named by arguments
|
and 0644 instead of file mode from the members named by arguments
|
||||||
.Ar files ... .
|
.Ar .
|
||||||
This ensures that checksums on the resulting archives are reproducible
|
This ensures that checksums on the resulting archives are reproducible
|
||||||
when member contents are identical.
|
when member contents are identical.
|
||||||
.It Fl f
|
.It Fl f
|
||||||
@ -199,9 +218,13 @@ Synonymous with option
|
|||||||
.Fl b .
|
.Fl b .
|
||||||
.It Fl j
|
.It Fl j
|
||||||
This option is accepted but ignored.
|
This option is accepted but ignored.
|
||||||
|
.It Fl l
|
||||||
|
This option is accepted for compatibility with GNU
|
||||||
|
.Xr ar 1 ,
|
||||||
|
but is ignored.
|
||||||
.It Fl m
|
.It Fl m
|
||||||
Move archive members specified by arguments
|
Move archive members specified by arguments
|
||||||
.Ar files ...
|
.Ar
|
||||||
within the archive.
|
within the archive.
|
||||||
If a position has been specified by one of the
|
If a position has been specified by one of the
|
||||||
.Fl a ,
|
.Fl a ,
|
||||||
@ -214,19 +237,21 @@ If no position has been specified, the specified members are moved
|
|||||||
to the end of the archive.
|
to the end of the archive.
|
||||||
If the archive has a symbol table, it is updated to reflect the
|
If the archive has a symbol table, it is updated to reflect the
|
||||||
new contents of the archive.
|
new contents of the archive.
|
||||||
|
.It Fl M
|
||||||
|
Read and execute MRI librarian commands from standard input.
|
||||||
.It Fl o
|
.It Fl o
|
||||||
Preserve the original modification times of members when extracting
|
Preserve the original modification times of members when extracting
|
||||||
them.
|
them.
|
||||||
.It Fl p
|
.It Fl p
|
||||||
Write the contents of the specified archive members named by
|
Write the contents of the specified archive members named by
|
||||||
arguments
|
arguments
|
||||||
.Ar files ...
|
.Ar
|
||||||
to standard output.
|
to standard output.
|
||||||
If no members were specified, the contents of all the files in the
|
If no members were specified, the contents of all the files in the
|
||||||
archive are written in the order they appear in the archive.
|
archive are written in the order they appear in the archive.
|
||||||
.It Fl q
|
.It Fl q
|
||||||
Append the files specified by arguments
|
Append the files specified by arguments
|
||||||
.Ar files ...
|
.Ar
|
||||||
to the archive specified by argument
|
to the archive specified by argument
|
||||||
.Ar archive
|
.Ar archive
|
||||||
without checking if the files already exist in the archive and
|
without checking if the files already exist in the archive and
|
||||||
@ -241,14 +266,14 @@ option
|
|||||||
will update the archive's symbol table.
|
will update the archive's symbol table.
|
||||||
.It Fl r
|
.It Fl r
|
||||||
Replace (add) the files specified by arguments
|
Replace (add) the files specified by arguments
|
||||||
.Ar files ...
|
.Ar
|
||||||
in the archive specified by argument
|
in the archive specified by argument
|
||||||
.Ar archive ,
|
.Ar archive ,
|
||||||
creating the archive if necessary.
|
creating the archive if necessary.
|
||||||
Files that replace existing files do not change the order of files
|
Replacing existing members will not change the order of members within
|
||||||
within the archive.
|
the archive.
|
||||||
If a file named in arguments
|
If a file named in arguments
|
||||||
.Ar files ...
|
.Ar
|
||||||
does not exist, existing members in the archive that match that
|
does not exist, existing members in the archive that match that
|
||||||
name are not changed.
|
name are not changed.
|
||||||
New files are added to the end of the archive unless one of the
|
New files are added to the end of the archive unless one of the
|
||||||
@ -271,9 +296,11 @@ with the
|
|||||||
.Fl s
|
.Fl s
|
||||||
option alone is equivalent to invoking
|
option alone is equivalent to invoking
|
||||||
.Nm ranlib .
|
.Nm ranlib .
|
||||||
|
.It Fl S
|
||||||
|
Do not generate an archive symbol table.
|
||||||
.It Fl t
|
.It Fl t
|
||||||
List the files specified by arguments
|
List the files specified by arguments
|
||||||
.Ar files ...
|
.Ar
|
||||||
in the order in which they appear in the archive, one per line.
|
in the order in which they appear in the archive, one per line.
|
||||||
If no files are specified, all files in the archive are listed.
|
If no files are specified, all files in the archive are listed.
|
||||||
.It Fl T
|
.It Fl T
|
||||||
@ -284,13 +311,13 @@ Conditionally update the archive or extract members.
|
|||||||
When used with the
|
When used with the
|
||||||
.Fl r
|
.Fl r
|
||||||
option, files named by arguments
|
option, files named by arguments
|
||||||
.Ar files ...
|
.Ar
|
||||||
will be replaced in the archive if they are newer than their
|
will be replaced in the archive if they are newer than their
|
||||||
archived versions.
|
archived versions.
|
||||||
When used with the
|
When used with the
|
||||||
.Fl x
|
.Fl x
|
||||||
option, the members specified by arguments
|
option, the members specified by arguments
|
||||||
.Ar files ...
|
.Ar
|
||||||
will be extracted only if they are newer than the corresponding
|
will be extracted only if they are newer than the corresponding
|
||||||
files in the file system.
|
files in the file system.
|
||||||
.It Fl v
|
.It Fl v
|
||||||
@ -340,9 +367,11 @@ the file size in bytes, the file modification time in
|
|||||||
format
|
format
|
||||||
.Dq "%b %e %H:%M %Y" ,
|
.Dq "%b %e %H:%M %Y" ,
|
||||||
and the name of the file.
|
and the name of the file.
|
||||||
|
.It Fl V
|
||||||
|
Print a version string and exit.
|
||||||
.It Fl x
|
.It Fl x
|
||||||
Extract archive members specified by arguments
|
Extract archive members specified by arguments
|
||||||
.Ar files ...
|
.Ar
|
||||||
into the current directory.
|
into the current directory.
|
||||||
If no members have been specified, extract all members of the archive.
|
If no members have been specified, extract all members of the archive.
|
||||||
If the file corresponding to an extracted member does not exist it
|
If the file corresponding to an extracted member does not exist it
|
||||||
@ -393,12 +422,27 @@ use:
|
|||||||
.Xr strftime 3 ,
|
.Xr strftime 3 ,
|
||||||
.Xr strmode 3 ,
|
.Xr strmode 3 ,
|
||||||
.Xr ar 5
|
.Xr ar 5
|
||||||
.\" .Sh COMPATIBILITY
|
.Sh STANDARDS COMPLIANCE
|
||||||
.\" .Nm
|
The
|
||||||
.\" is expected to be compatible with GNU and SVR4
|
.Nm
|
||||||
.\" .Nm .
|
utility's support for the
|
||||||
.\" .Sh STANDARDS
|
.Fl a ,
|
||||||
.\" Do the POSIX/SuSv3 standards have anything to say about AR(1)?
|
.Fl b ,
|
||||||
|
.Fl c ,
|
||||||
|
.Fl i ,
|
||||||
|
.Fl m ,
|
||||||
|
.Fl p ,
|
||||||
|
.Fl q ,
|
||||||
|
.Fl r ,
|
||||||
|
.Fl s ,
|
||||||
|
.Fl t ,
|
||||||
|
.Fl u ,
|
||||||
|
.Fl v ,
|
||||||
|
.Fl C
|
||||||
|
and
|
||||||
|
.Fl T
|
||||||
|
options is believed to be compliant with
|
||||||
|
.St -p1003.2 .
|
||||||
.Sh HISTORY
|
.Sh HISTORY
|
||||||
An
|
An
|
||||||
.Nm
|
.Nm
|
||||||
|
Loading…
Reference in New Issue
Block a user