version 1.6, 1999/08/27 07:14:00 |
version 1.7, 2000/03/04 21:11:59 |
|
|
Once an archive has been created, new files can be added and existing |
Once an archive has been created, new files can be added and existing |
files can be extracted, deleted, or replaced. |
files can be extracted, deleted, or replaced. |
.Pp |
.Pp |
Files are named in the archive by a single component, i.e., if a file |
Files are named in the archive by a single component; i.e., if a file |
referenced by a path containing a slash |
referenced by a path containing a slash |
.Pq Ql / |
.Pq Ql / |
is archived it will be |
is archived it will be |
|
|
the loader (see |
the loader (see |
.Xr ld 1 ) |
.Xr ld 1 ) |
although it is not restricted to this purpose. |
although it is not restricted to this purpose. |
|
.Pp |
The options are as follows: |
The options are as follows: |
.Bl -tag -width indent |
.Bl -tag -width indent |
.It Fl a |
.It Fl a |
|
|
Move the specified archive files within the archive. |
Move the specified archive files within the archive. |
If one of the options |
If one of the options |
.Fl a , |
.Fl a , |
.Fl b |
.Fl b , |
or |
or |
.Fl i |
.Fl i |
are specified, the files are moved before or after the |
are specified, the files are moved before or after the |
|
|
within the archive. |
within the archive. |
New files are appended to the archive unless one of the options |
New files are appended to the archive unless one of the options |
.Fl a , |
.Fl a , |
.Fl b |
.Fl b , |
or |
or |
.Fl i |
.Fl i |
is specified. |
is specified. |
|
|
When used with the |
When used with the |
.Fl d , |
.Fl d , |
.Fl m , |
.Fl m , |
.Fl q |
.Fl q , |
or |
or |
.Fl x |
.Fl x |
options, |
options, |
.Nm |
.Nm |
gives a file-by-file description of the archive modification. |
gives a file-by-file description of the archive modification. |
This description consists of three, white-space separated fields: the |
This description consists of three, whitespace-separated fields: the |
option letter, a dash |
option letter, a dash |
.Pq Ql - |
.Pq Ql - , |
and the file name. |
and the file name. |
When used with the |
When used with the |
.Fl r |
.Fl r |
|
|
.Dq ls -l |
.Dq ls -l |
style listing of information about the members of |
style listing of information about the members of |
the archive. |
the archive. |
This listing consists of eight, white-space separated fields: |
This listing consists of eight, whitespace-separated fields: |
the file permissions (see |
the file permissions (see |
.Xr strmode 3 ), |
.Xr strmode 3 ), |
the decimal user and group IDs, separated by a single slash |
the decimal user and group IDs, separated by a single slash |
|
|
.It Pa ar.XXXXXXXXXX |
.It Pa ar.XXXXXXXXXX |
temporary file names |
temporary file names |
.El |
.El |
|
.Sh SEE ALSO |
|
.Xr ld 1 , |
|
.Xr ranlib 1 , |
|
.Xr strmode 3 , |
|
.Xr ar 5 |
.Sh COMPATIBILITY |
.Sh COMPATIBILITY |
By default, |
By default, |
.Nm |
.Nm |
|
|
utility is expected to offer a superset of the |
utility is expected to offer a superset of the |
.St -p1003.2 |
.St -p1003.2 |
functionality. |
functionality. |
.Sh SEE ALSO |
|
.Xr ld 1 , |
|
.Xr ranlib 1 , |
|
.Xr strmode 3 , |
|
.Xr ar 5 |
|