10.0;arcf (archive_files), revision 1.0, 88/01/21
arcf (archive_file) -- Maintain an archive file.
usage: arcf {-d | -p | -t | -u | -x}[v] arcname [pathname...]
DESCRIPTION
arcf collects sets of files into one large file and maintains that file
as an archive. You can extract files from the archive, add new ones,
delete or replace old ones, and list data about the contents. Only text
files can be archived.
Files to be added to an archive must exist as files with the name given.
Files that are extracted from an archive are written to files with the
name given. Files that are added to archives can, of course, be archive
files themselves. Any number of files can be nested this way. Thus, you
can use arcf to maintains tree-structured file directories.
NOTE
When you use the update and print commands, the files are updated and
printed in the order they appear in the archived file, not in the order
listed on the command line.
ARGUMENTS
arcname (required)
Specify the name of archive file being created or
maintained.
pathname (optional)
Specify the name of file to be added or deleted from the
archive. Multiple names are permitted, separated by
blanks. Specifying a hyphen as a filename causes further
names to be read from standard input, one per line.
Default if omitted:
perform action on all files in the archive
(except -d, which requires you to give
names explicitly).
COMMANDS
command (required)
Specify the operation to perform on the archive file
arcname. Follow the command with o get verbose output.
Possible commands include the following:
-d Delete the named files from the archive. If you use the v
option, filenames are displayed on the standard output as
they are deleted from the archive.
-p Write the contents of the named files on standard output.
The v option causes the filenames to precede the file.
-t Write a table of contents for the archive file. Normally,
the table contains only the filename. If the v option is
used, the table also includes the file's length, type, and
date and time of the last change.
-u Update the named archive by replacing existing files, or
adding new ones at the end. If you do not give a
filename, all possible files in the archive are updated
with files of the same name in the current directory. If
the archive file does not exist, it is created with the
name given. If you use the v option, filenames are
displayed on standard output as files are written to the
new archived file.
-x Extract the named files from archive. Write each to a
file with the same name. If the file already exists, the
new version replaces the old. If you add the v option,
filenames are displayed on standard output as files are
extracted.
v Request verbose output. This command can follow any of
the other commands (see example below), and causes the
archiver to print additional information, generally
filenames, on standard output. Its specific action for
each command has already been described.
EXAMPLES
Update archive file my_archive with a new copy of the file stamps,
returning verbose output.
$ arcf -uv my_archive stamps
stamps
$
Report on the contents of the archive.
$ arcf -tv my_archive
stamps 330 local 03/02/88 13:53:07
$