d/freebsd-dev
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

* Add mention of the -f, -q, -S, and -V options in the synopsis

Browse Source 
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:
Kai Wang 2010-12-26 18:10:39 +00:00
parent 78962f36d2
commit 3a870f82fc
Notes: svn2git 2020-12-20 02:59:44 +00:00 
svn path=/head/; revision=216716
1 changed files with 75 additions and 31 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

106
usr.bin/ar/ar.1
View File

@ -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