version 1.3, 1997/08/19 07:23:13 |
version 1.4, 1998/09/23 04:32:34 |
|
|
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 (``/'') is archived it will be |
referenced by a path containing a slash (`/') is archived it will be |
named by the last component of that path. |
named by the last component of that path. |
When matching paths listed on the command line against file names stored |
When matching paths listed on the command line against file names stored |
in the archive, only the last component of the path will be compared. |
in the archive, only the last component of the path will be compared. |
|
|
that used the entire space. |
that used the entire space. |
This means that file names that are not unique in their first fifteen |
This means that file names that are not unique in their first fifteen |
characters can subsequently be confused. |
characters can subsequently be confused. |
A warning message is printed to the standard error output if any file |
A warning message is printed to the standard error if any file |
names are truncated. |
names are truncated. |
(See |
(See |
.Xr ar 5 |
.Xr ar 5 |
|
|
.Nm ar |
.Nm ar |
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, white-space separated fields: the |
option letter, a dash (``-'') and the file name. |
option letter, a dash (`-') and the file name. |
When used with the |
When used with the |
.Fl r |
.Fl r |
option, |
option, |
|
|
option, |
option, |
the name of each printed file is written to the standard output before |
the name of each printed file is written to the standard output before |
the contents of the file, preceded by a single newline character, and |
the contents of the file, preceded by a single newline character, and |
followed by two newline characters, enclosed in less-than (``<'') and |
followed by two newline characters, enclosed in less-than (`<') and |
greater-than (``>'') characters. |
greater-than (`>') characters. |
.Pp |
.Pp |
When used with the |
When used with the |
.Fl t |
.Fl t |
|
|
This listing consists of eight, white-space separated fields: |
This listing consists of eight, white-space separated fields: |
the file permissions (see |
the file permissions (see |
.Xr strmode 3 ), |
.Xr strmode 3 ), |
the decimal user and group ID's, separated by a single slash (``/''), |
the decimal user and group ID's, separated by a single slash (`/'), |
the file size (in bytes), the file modification time (in the |
the file size (in bytes), the file modification time (in the |
.Xr date 1 |
.Xr date 1 |
format ``%b %e %H:%M %Y''), and the name of the file. |
format ``%b %e %H:%M %Y''), and the name of the file. |
|
|
.Pp |
.Pp |
The |
The |
.Nm ar |
.Nm ar |
utility exits 0 on success, and >0 if an error occurs. |
utility exits 0 on success or >0 if an error occurred. |
.Sh ENVIRONMENT |
.Sh ENVIRONMENT |
.Bl -tag -width indent -compact |
.Bl -tag -width indent -compact |
.It Ev TMPDIR |
.It Ev TMPDIR |
The pathname of the directory to use when creating temporary files. |
The pathname of the directory to use when creating temporary files. |
.El |
.El |
.Sh FILES |
.Sh FILES |
.Bl -tag -width indent -compact |
.Bl -tag -width ar.XXXXXX -compact |
.It Pa /tmp |
.It Pa /tmp |
default temporary file directory |
default temporary file directory |
.It Pa ar.XXXXXX |
.It Pa ar.XXXXXX |