Annotation of coherent/a/usr/man/COHERENT/cpio, revision 1.1.1.1

1.1       root        1: 
                      2: 
                      3: cpio                         Command                         cpio
                      4: 
                      5: 
                      6: 
                      7: 
                      8: Archiving/backup utility
                      9: 
                     10: ccppiioo -oo[BBaaccvv]
                     11: ccppiioo -ii[BBccddffmmrrttuuvv] [_p_a_t_t_e_r_n...]
                     12: ccppiioo -pp[aaddllmmrruuvv] _d_i_r_e_c_t_o_r_y
                     13: 
                     14: ccppiioo is  an archiving utility that reads and  writes files in the
                     15: format  specified  by the  ccppiioo  AArrcchhiivvee/IInntteerrcchhaannggee FFiillee  FFoorrmmaatt
                     16: specified in IEEE standard 1003.1-1988.
                     17: 
                     18: ***** Options *****
                     19: 
                     20: ccppiioo recognizes the following command-line options:
                     21: 
                     22: -aa   Reset the  access times of input files  after they have been
                     23:      copied.  When  the -ll option  is also specified,  the linked
                     24:      files do  not have  their access  times reset.  Can  be used
                     25:      only with the -oo or -ii options.
                     26: 
                     27: -BB   Change the  size of a block.  Input/output  is to be blocked
                     28:      5,120 bytes  to the  record.  This  option can be  used only
                     29:      with  the -oo  or -ii  options, for data  directed to  or from
                     30:      character-special files.
                     31: 
                     32: -cc   Write   header   information   in   ASCII   characters   for
                     33:      portability.  Can be used only with the -ii or -oo options.
                     34: 
                     35: -dd   Creates directories as needed.  Can be used only with the -ii
                     36:      or -pp options.
                     37: 
                     38: -ff   Copy all files except  those in whose names match a _p_a_t_t_e_r_n.
                     39:      Can be used only with the -ii option.
                     40: 
                     41: -ii   In.   Read the  standard input,  which it  assumes to  be an
                     42:      archive that  had been created  with the -oo  option to ccppiioo.
                     43:      Copy  all  files  within the  archive  whose  names match  a
                     44:      _p_a_t_t_e_r_n into the current directory (default, all files).
                     45: 
                     46: -ll   Whenever possible, link files rather than copying them.  Can
                     47:      be used only with the -pp option.
                     48: 
                     49: -mm   Retain   previous  modification   times.   This   option  is
                     50:      ineffective on  directories that  are being copied.   Can be
                     51:      used only with the -ii or -pp options.
                     52: 
                     53: -oo   Out.  Copy  all files whose names  match a _p_a_t_t_e_r_n (default,
                     54:      all files) into an archive written to standard output.
                     55: 
                     56: -pp   Pass mode.   This option causes ccppiioo  to read standard input
                     57:      for a  list of file names to  copy to destination _d_i_r_e_c_t_o_r_y.
                     58:      This  mode  of  operation  is  similar in  functionality  to
                     59:      command ccppddiirr, with  the added ability to specify individual
                     60:      file names via standard input.
                     61: 
                     62: 
                     63: 
                     64: COHERENT Lexicon                                           Page 1
                     65: 
                     66: 
                     67: 
                     68: 
                     69: cpio                         Command                         cpio
                     70: 
                     71: 
                     72: 
                     73: -rr   Interactively rename  files.  Before it copies  a file, ccppiioo
                     74:      asks you  to rename  the file.   If you type  just <rreettuurrnn>,
                     75:      ccppiioo skips the file.  Should be  used only with the -ii or -oo
                     76:      options.
                     77: 
                     78: -tt   Print a  table of  contents of  an existing archive;  do not
                     79:      copy files  from the archive.  Can be used  only with the -ii
                     80:      option.
                     81: 
                     82: -uu   Copy files unconditionally.   Usually an older file will not
                     83:      replace a  new file  with the same  name.  Can be  used only
                     84:      with the -ii or -pp options.
                     85: 
                     86: -vv   Verbose option: print  the names of all affected files.  Can
                     87:      be  used  only  with the  -ii  option.   Provides a  detailed
                     88:      listing when used with the -tt option.
                     89: 
                     90: ***** Operands *****
                     91: 
                     92: The following operands are available:
                     93: 
                     94: _p_a_t_t_e_r_n
                     95:      This names the files to  be manipulated by ccppiioo. This can be
                     96:      a simple regular expression.
                     97: 
                     98: _d_i_r_e_c_t_o_r_y
                     99:      The destination directory.
                    100: 
                    101: ***** Multi-Volume Operation *****
                    102: 
                    103: ccppiioo supports multi-volume backups and restoration when using the
                    104: ``raw''  (i.e.,  character-special)  floppy  device.  If  a  ccppiioo
                    105: archive exceeds the size  of one floppy diskette, ccppiioo will issue
                    106: a prompt of the form:
                    107: 
                    108: 
                    109:         Ready for volume 2
                    110:         Type "device/name" when ready to proceed ...
                    111: 
                    112: 
                    113: Remove the  first diskette and insert  the next logical diskette.
                    114: Enter  the  name  of  the  floppy  device,  e.g.   /ddeevv/rrffhhaa00  or
                    115: /ddeevv/rrffvvaa11, and press <EEnntteerr>. Please note well that multi-volume
                    116: operation  requires the  raw floppy  device and  the use  of pre-
                    117: formatted floppy diskettes.
                    118: 
                    119: ***** Examples *****
                    120: 
                    121: The following command  copies all files and directories listed by
                    122: the command ffiinndd and copies them into the archive nneewwffiillee.ccppiioo:
                    123: 
                    124: 
                    125: 
                    126: 
                    127: 
                    128: 
                    129: 
                    130: COHERENT Lexicon                                           Page 2
                    131: 
                    132: 
                    133: 
                    134: 
                    135: cpio                         Command                         cpio
                    136: 
                    137: 
                    138: 
                    139:      find . -print | cpio -oc > ../newfile.cpio
                    140: 
                    141: 
                    142: The  following command  reads the  ccppiioo archive  nneewwffiillee.ccppiioo and
                    143: extracts  all files  whose names  match  the patterns  mmeemmoo/aall or
                    144: mmeemmoo/bb*:
                    145: 
                    146: 
                    147:      cpio -icdv "memo/al" "memo/b*" <../newfile.cpio
                    148: 
                    149: 
                    150: Note that  the -dd option forces ccppiioo  to create the sub-directory
                    151: mmeemmoo and  write the  files into  it.  Otherwise, the  files would
                    152: have been  written into the current  directory.  Option -vv causes
                    153: ccppiioo  to display  each  file name  as  it is  extracted from  the
                    154: archive.
                    155: 
                    156: The following commands perform a multi-volume backup of all files
                    157: on mounted filesystem /vv to the character-special (i.e., ``raw'')
                    158: floppy device /ddeevv/rrffhhaa00:
                    159: 
                    160: 
                    161:         su root
                    162:         cd /v
                    163:         find . -print | cpio -ocv >/dev/rfha0
                    164: 
                    165: 
                    166: If the ccppiioo archive exceeds one diskette, you will be prompted to
                    167: insert another formatted diskette.
                    168: 
                    169: ***** See Also *****
                    170: 
                    171: ccoommmmaannddss, dduummpp, ppaaxx, ttaarr, uussttaarr
                    172: 
                    173: ***** Notes *****
                    174: 
                    175: ccppiioo has the following restrictions:
                    176: 
                    177: -> Path names are restricted to 256 characters.
                    178: 
                    179: -> You must have appropriate privileges to copy special files.
                    180: 
                    181: -> Blocks are reported in 512-byte quantities.
                    182: 
                    183: ccppiioo  was  developed by  Mark  H. Colburn  and  sponsored by  The
                    184: USENIX  Association.   Copyright  (c)  1989  by Mark  H.  Colburn
                    185: ([email protected]).  All  rights reserved.  See  the compressed
                    186: ttaarr  archive /uussrr/ssrrcc/aalliieenn/ppaaxx.ttaarr.ZZ  for  full descriptions  of
                    187: copyright, restrictions, and licensing terms.
                    188: 
                    189: ccppiioo is provided in binary form per the licensing terms set forth
                    190: by  the  author.  It  is  distributed as  a  service to  COHERENT
                    191: customers, as is.  It  is not supported by Mark Williams Company.
                    192: _C_a_v_e_a_t _u_t_i_l_i_t_o_r.
                    193: 
                    194: 
                    195: 
                    196: COHERENT Lexicon                                           Page 3
                    197: 
                    198: 

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.