


      CTCAT(1)                   (Bull-SPS9)                   CTCAT(1)



      NAME
           ctcat - read/create cartridge tape files
           ctdir - list contents of tape

      SYNTAX
           ctcat [ key ] [ files ]

      DESCRIPTION
           Ctcat saves and restores files on cartridge tape in a format
           that is readable by the operating system at slow boot time.
           This program is intended to be used in making bootable tapes
           and should not be used as a general purpose tape file
           archiver.  It is recommended that you use cpio(1) or tar(1)
           in this case.  The user is referred to ctcat(4) for a
           description of the bootable tape format.

           The key argument is a string of characters containing at
           most one function letter and possibly one or more function
           modifiers.  Other arguments to the command are files
           specifying which files (up to 64) are to be written or
           extracted.  A file name can be a path name, but only the
           final component of the path name will be used to refer to
           the file on tape.

           The function portion of key is specified by one of the
           following letters:

           -r      The named files are written to the end of the tape.
           -x      The named files are extracted from the tape into the
                   current working directory with names the same as
                   those on the tape.  Searching is stopped when the
                   next tape directory is encountered.  If no files
                   argument is given, the entire content of the tape up
                   to the next directory is extracted.  Note that if
                   several files with the same name are on the tape,
                   the last one overwrites all earlier ones.  The tape
                   must be positioned at the beginning of a directory
                   to start.
           -t      The names of the specified files are listed onto
                   stderr each time that they occur on the tape.  If no
                   files argument is given, all the names on the tape
                   are listed.  The tape must be positioned at the
                   beginning of a directory to start.
           -c      Create a new tape; writing begins at the beginning
                   of the tape, instead of after the last file.
           -p      The named files are extracted from the tape onto
                   standard out.  If no files argument is given, the
                   entire content of the tape (up to the next
                   directory) is extracted.  The tape must be
                   positioned at the beginning of a directory to start.
           -R      Rewind tape.
           -s      One directory/file group is skipped and the tape is



      Page 1                                          (73 A2 02MT REV1)






      CTCAT(1)                   (Bull-SPS9)                   CTCAT(1)



                   positioned at the beginning of the next directory on
                   the tape.  The tape must be positioned at the
                   beginning of a directory to start.

           The following characters may be used to modify the above
           functions:

           -q      This function modifier causes ctcat to exit after
                   the first occurrence of each file has been extracted
                   from the tape.  Otherwise, ctcat will read the
                   entire tape searching for all occurrences of files.
                   (This modifier is used with the -x or -p functions.)
           -v      This function modifier causes the program to type
                   the name of each file it treats onto stderr.  (This
                   modifier is used with the -c, -p, -r, and -x
                   functions.)

           After a command is complete, the tape stops 'in its tracks'.
           That is to say, it is never rewound to the beginning.  Use
           the -R function or mt rew to rewind the tape.  Please refer
           to mt(1) for more details of tape movement.  The command
           ctdir is equivalent to ctcat with the -t function.  It will
           produce a listing of the contents of the tape onto stderr.
































      Page 2                                          (73 A2 02MT REV1)






      CTCAT(1)                   (Bull-SPS9)                   CTCAT(1)



      SEE ALSO
           cpio(1), tar(1), mt(1), ctcat(4)

      FILES
           /dev/nct0

      DIAGNOSTICS
           Complains about bad key characters and tape read/write
           errors.  All diagnostics are printed on stderr.














































      Page 3                                          (73 A2 02MT REV1)



