Return to cpio CVS log

Up to [MW Coherent from dump] / coherent / a / usr / man / COHERENT

Annotation of coherent/a/usr/man/COHERENT/cpio, revision 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: 

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