Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

1.1;arcf (archive_files), revision 1.1, 81/07/01
ARCF (ARCHIVE_FILE) -- Maintain an archive file.
usage:  ARCF {-D | -P | -T | -U | -X}[V] arcname [pathname...]


FORMAT

  ARCF command arcname [pathname ...]


  ARCF  collects sets of files into one large file and maintains that file as an
  archive. Files can be extracted from the archive, new ones can be  added,  old
  ones  can  be  deleted  or  replaced  by  updated versions, and data about the
  contents can be listed. Only text files can be archived.

    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

  command
  (required)         Specify the  operation  to  perform  on  the  archive  file
                     arcname.   Follow the command with V to get verbose output.
                     Possible commands are:

                     -D              Delete the named files  from  the  archive.
                                     If  the  V  option  is  used, filenames are
                                     displayed on the standard  output  as  they
                                     are deleted from the archive.

                     -P              Write  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  no  filenames  are  given,  all
                                     possible  files  in  the  archive  will  be
                                     updated with files of the same name in  the
                                     current  directory.    If  the archive file
                                     does not exist, it will be created with the
                                     name given.   If  the  V  option  is  used,
                                     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  the  V option is
                                     added, 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 will cause the archiver
                                     to  print additional information, generally
                                     filenames,  on  standard   output.      Its
                                     specific   action   for  each  command  has
                                     already been described.

  Arcname
  (required)         Specify name of archive file being created or maintained.

  pathname
  (optional)         Specify name of file  to  be  added  or  deleted  from  the
                     archive.    Multiple  names  are  permitted,  separated  by
                     blanks.  Specifying a  hyphen  as  a  filename  will  cause
                     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
                                          that names be explicitly given).


EXAMPLES

    1.  $ arcf -uv my_archive stamps        Update archive file "my_archive"
        stamps                              with a new copy of the file
        $                                   "stamps", returning verbose
                                            output.


    2.  $ arcf -tv my_archive
        stamps      330  local   02/18/83  13:53:07
        $                                   Report on the contents of the
                                            archive.

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026