scpio(1)                            CLIX                            scpio(1)



  NAME

    scpio - Performs multibuffering and asynchronous I/O cpio(1)

  SYNOPSIS

    scpio -o [acBLvV] [-C bufsize] [-z bufcount] [[-O file] [-M message]]

    scpio -i [BcdLmrtuvVfsSb6] [-C bufsize] [-z bufcount] [[-I file] [-M
    message]] [pattern ... ]

    scpio -p [adlLmuvV] directory

    scpio -x [cstvfB6] [-C bufsize] [-z bufcount] [-I file] [pattern ... ]

  FLAGS

    See cpio for a description of basic capabilities and flags.  Additional
    flags supported by scpio are as follows:

    -x            Compares the archive and the input files and reports any
                  differences.

    -z bufcount   Specifies the number of buffers to be used for
                  multibuffering.  Permissible values are from 2 to 25,
                  inclusive.  If this parameter is not specified, one buffer
                  is used and I/O is synchronous.

  DESCRIPTION

    The scpio command copies files to tape.  The command is a modified version
    of cpio with two major enhancements-asynchronous I/O and multibuffering-
    which significantly improve its performance.  In addition to the three
    standard modes of cpio (input, output, and passthrough), scpio provides a
    verify mode (-x flag).  In this mode, scpio verifies the integrity of the
    archived file by comparing it to the input file.  An error message is
    displayed if a difference is found.

    If scpio is used with the -p option and there is not enough space in the
    destination directory scpio copies what it can and terminates. No error
    message is displayed.

  EXAMPLES

    1.  The following command uses 25 buffers, each 63488 bytes in size, to
        create an archive on /dev/rmt/0m of /usr2:

        find /usr2 -print | scpio -o -C 63488 -z 25 -O /dev/rmt/0m


    2.  The following command reads an archive from /dev/rmt/0m using the same



  2/94 - Intergraph Corporation                                              1

  scpio(1)                            CLIX                            scpio(1)



        buffer count and size as the previous example:

        scpio -idm -C 63488 -z 25 -I /dev/rmt/0m


  NOTES

    When an archive is being verified (-x flag), file headers and data are
    compared.  If one of the input files is accessed between the time it was
    written and the time it is read for verification, the date in the header
    is changed.  This results in a verification error, although nothing is
    wrong with the file.

    Using the -v flag may give less than optimal speed due to time spent
    writing filenames to the screen.  The -V flag displays a dot for every
    file, verifying activity without the overhead of displaying every
    filename.

  EXIT VALUES

    The scpio command exits with a value of 0 if successful.  If unsuccessful,
    scpio exits with a nonzero value.

  RELATED INFORMATION

    Commands: cpio(1)




























  2                                              Intergraph Corporation - 2/94