Annotation of coherent/d/usr/bin/pax/cpio.man, revision 1.1.1.1

1.1       root        1: 
                      2: 
                      3: 
                      4:      CCCCPPPPIIIIOOOO((((1111))))                     CCCCOOOOHHHHEEEERRRREEEENNNNTTTT                      CCCCPPPPIIIIOOOO((((1111))))
                      5: 
                      6: 
                      7: 
                      8:      NNNNAAAAMMMMEEEE
                      9:           cpio - copy file archives in and out
                     10: 
                     11:      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
                     12:           ccccppppiiiioooo ----oooo[BBBBaaaaccccvvvv]
                     13:           ccccppppiiiioooo ----iiii[BBBBccccddddffffmmmmrrrrttttuuuuvvvv] [_p_a_t_t_e_r_n...]
                     14:           ccccppppiiiioooo ----pppp[aaaaddddllllmmmmrrrruuuuvvvv] _d_i_r_e_c_t_o_r_y
                     15: 
                     16:      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
                     17:           The ccccppppiiiioooo utility produces and reads files in the format
                     18:           specified by the ccccppppiiiioooo AAAArrrrcccchhhhiiiivvvveeee////IIIInnnntttteeeerrrrcccchhhhaaaannnnggggeeee FFFFiiiilllleeee FFFFoooorrrrmmmmaaaatttt
                     19:           specified in _I_E_E_E _S_t_d. _1_0_0_3._1-_1_9_8_8.
                     20: 
                     21:           The ccccppppiiiioooo ----iiii (copy in) utility extracts files from the
                     22:           standard input, which is assumed to be the product of a
                     23:           previous ccccppppiiiioooo ----oooo .... Only files with names that match _p_a_t_t_e_r_n_s
                     24:           are selected.  Multiple _p_a_t_t_e_r_n_s may be specified and if no
                     25:           _p_a_t_t_e_r_n_s are specified, the default for _p_a_t_t_e_r_n_s is
                     26:           selecting all files.  The extracted files are conditionally
                     27:           created and copied into the current directory, and possibly
                     28:           any levels below, based upon the options described below and
                     29:           the permissions of the files will be those of the previous
                     30:           ccccppppiiiioooo ----oooo .... The owner and group of the files will be that of
                     31:           the current user unless the user has appropriate privileges,
                     32:           which causes ccccppppiiiioooo to retains the owner and group of the
                     33:           files of the previous ccccppppiiiioooo ----oooo ....
                     34: 
                     35:           The ccccppppiiiioooo ----pppp (pass) utility reads the standard input to
                     36:           obtain a list of path names of files that are conditionally
                     37:           created and copied into the destination _d_i_r_e_c_t_o_r_y based upon
                     38:           the options described below.
                     39: 
                     40:           If an error is detected, the cause is reported and the ccccppppiiiioooo
                     41:           utility will continue to copy other files.  ccccppppiiiioooo will skip
                     42:           over any unrecognized files which it encounters in the
                     43:           archive.
                     44: 
                     45:           The following restrictions apply to the ccccppppiiiioooo utility:
                     46: 
                     47:           1 Pathnames are restricted to 256 characters.
                     48: 
                     49:           2 Appropriate privileges are required to copy special files.
                     50: 
                     51:           3 Blocks are reported in 512-byte quantities.
                     52: 
                     53:         OOOOppppttttiiiioooonnnnssss
                     54:           The following options are available:
                     55: 
                     56:           ----BBBB   Input/output is to be blocked 5120 bytes to the record.
                     57:                Can only be used with ccccppppiiiioooo ----oooo or ccccppppiiiioooo ----iiii for data that
                     58:                is directed to or from character special files.
                     59: 
                     60: 
                     61: 
                     62: 
                     63:      Page 1                                         (printed 10/10/90)
                     64: 
                     65: 
                     66: 
                     67: 
                     68: 
                     69: 
                     70:      CCCCPPPPIIIIOOOO((((1111))))                     CCCCOOOOHHHHEEEERRRREEEENNNNTTTT                      CCCCPPPPIIIIOOOO((((1111))))
                     71: 
                     72: 
                     73: 
                     74:           ----aaaa   Reset access times of input files after they have been
                     75:                copied.  When the ----llll option is also specified, the
                     76:                linked files do not have their access times reset.  Can
                     77:                only be used with ccccppppiiiioooo ----oooo or ccccppppiiiioooo ----iiii ....
                     78: 
                     79:           ----cccc   Write header information in ASCII character for for
                     80:                portability.  Can only be used with ccccppppiiiioooo ----iiii or ccccppppiiiioooo ----oooo
                     81:                .... Note that this option should always be used to write
                     82:                portable files.
                     83: 
                     84:           ----dddd   Creates directories as needed.  Can only be used with
                     85:                ccccppppiiiioooo ----iiii or ccccppppiiiioooo ----pppp ....
                     86: 
                     87:           ----ffff   Copy in all files except those in _p_a_t_t_e_r_n_s . Can only
                     88:                be used with ccccppppiiiioooo ----iiii ....
                     89: 
                     90:           ----llll   Whenever possible, link files rather than copying them.
                     91:                Can only be used with ccccppppiiiioooo ----pppp ....
                     92: 
                     93:           ----mmmm   Retain previous modification times.  This option is
                     94:                ineffective on directories that are being copied.  Can
                     95:                only be used with ccccppppiiiioooo ----iiii or ccccppppiiiioooo ----pppp ....
                     96: 
                     97:           ----rrrr   Interactively rename files.  The user is asked whether
                     98:                to rename _p_a_t_t_e_r_n each invocation.  Read and write
                     99:                permissions for ////ddddeeeevvvv////ttttttttyyyy are required for this option.
                    100:                If the user types a null line, the file is skipped.
                    101:                Should only be used with ccccppppiiiioooo ----iiii or ccccppppiiiioooo ----oooo ....
                    102: 
                    103:           ----tttt   Print a table of contents of the input.  No files are
                    104:                created.  Can only be used with ccccppppiiiioooo ----iiii ....
                    105: 
                    106:           ----uuuu   Copy files unconditionally; usually an older file will
                    107:                not replace a new file with the same name.  Can only be
                    108:                used with ccccppppiiiioooo ----iiii or ccccppppiiiioooo ----pppp ....
                    109: 
                    110:           ----vvvv   Verbose: cause the names of the affected files to be
                    111:                printed.  Can only be used with ccccppppiiiioooo ----iiii .... Provides a
                    112:                detailed listing when used with the ----tttt option.
                    113: 
                    114:         OOOOppppeeeerrrraaaannnnddddssss
                    115:           The following operands are available:
                    116: 
                    117:           _p_a_t_t_e_r_n_s  Simple regular expressions given in the name-
                    118:                     generating notation of the shell.
                    119: 
                    120:           _d_i_r_e_c_t_o_r_y The destination directory.
                    121: 
                    122:         EEEExxxxiiiitttt SSSSttttaaaattttuuuussss
                    123:           The ccccppppiiiioooo utility exits with one of the following values:
                    124: 
                    125:           0    All input files were copied.
                    126: 
                    127: 
                    128: 
                    129:      Page 2                                         (printed 10/10/90)
                    130: 
                    131: 
                    132: 
                    133: 
                    134: 
                    135: 
                    136:      CCCCPPPPIIIIOOOO((((1111))))                     CCCCOOOOHHHHEEEERRRREEEENNNNTTTT                      CCCCPPPPIIIIOOOO((((1111))))
                    137: 
                    138: 
                    139: 
                    140:           2    The utility encountered errors in copying or accessing
                    141:                files or directories.  An error will be reported for
                    142:                nonexistent files or directories, or permissions that
                    143:                do not allow the user to access the source or target
                    144:                files.
                    145: 
                    146: 
                    147:           It is important to use the ----ddddeeeepppptttthhhh option of the ffffiiiinnnndddd utility
                    148:           to generate pathnames for ccccppppiiiioooo .... This eliminates problems
                    149:           ccccppppiiiioooo could have trying to create files under read-only
                    150:           directories.
                    151: 
                    152:           The following command:
                    153:                ls | cpio -o > ../newfile
                    154:           copies out the files listed by the llllssss utility and redirects
                    155:           them to the file nnnneeeewwwwffffiiiilllleeee ....
                    156: 
                    157:           The following command:
                    158:                cat newfile | cpio -id "memo/al" "memo/b*"
                    159:           uses the output file nnnneeeewwwwffffiiiilllleeee from the ccccppppiiiioooo ----oooo utility, takes
                    160:           those files that match the patterns mmmmeeeemmmmoooo////aaaallll and mmmmeeeemmmmoooo////bbbb**** ,,,,
                    161:           creates the directories below the current directory, and
                    162:           places the files in the appropriate directories.
                    163: 
                    164:           The command
                    165:                find . -depth -print | cpio -pdlmv newdir
                    166:           takes the file names piped to it from the ffffiiiinnnndddd utility and
                    167:           copies or links those files to another directory named
                    168:           nnnneeeewwwwddddiiiirrrr ,,,, while retaining the modification time.
                    169: 
                    170:      FFFFIIIILLLLEEEESSSS
                    171:           /dev/tty  used to prompt the user for information when the
                    172:                     ----iiii or ----rrrr options are specified.
                    173: 
                    174:      SSSSEEEEEEEE AAAALLLLSSSSOOOO
                    175:           find(1), pax(1), tar(1), cpio(5), tar(5)
                    176: 
                    177:      CCCCOOOOPPPPYYYYRRRRIIIIGGGGHHHHTTTT
                    178:           Copyright (c) 1989 Mark H. Colburn.
                    179:           All rights reserved.
                    180: 
                    181:           Redistribution and use in source and binary forms are
                    182:           permitted provided that the above copyright notice is
                    183:           duplicated in all such forms and that any documentation,
                    184:           advertising materials, and other materials related to such
                    185:           distribution and use acknowledge that the software was
                    186:           developed by Mark H. Colburn and sponsored by The USENIX
                    187:           Association.
                    188: 
                    189:           THE SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS
                    190:           OR IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE
                    191:           IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
                    192: 
                    193: 
                    194: 
                    195:      Page 3                                         (printed 10/10/90)
                    196: 
                    197: 
                    198: 
                    199: 
                    200: 
                    201: 
                    202:      CCCCPPPPIIIIOOOO((((1111))))                     CCCCOOOOHHHHEEEERRRREEEENNNNTTTT                      CCCCPPPPIIIIOOOO((((1111))))
                    203: 
                    204: 
                    205: 
                    206:           PARTICULAR PURPOSE.
                    207: 
                    208:      AAAAUUUUTTTTHHHHOOOORRRR
                    209:           Mark H. Colburn
                    210:           NAPS International
                    211:           117 Mackubin Street, Suite 1
                    212:           St. Paul, MN 55102
                    213:           [email protected]
                    214: 
                    215: 
                    216:           Sponsored by TTTThhhheeee UUUUSSSSEEEENNNNIIIIXXXX AAAAssssssssoooocccciiiiaaaattttiiiioooonnnn for public distribution.
                    217: 
                    218: 
                    219: 
                    220: 
                    221: 
                    222: 
                    223: 
                    224: 
                    225: 
                    226: 
                    227: 
                    228: 
                    229: 
                    230: 
                    231: 
                    232: 
                    233: 
                    234: 
                    235: 
                    236: 
                    237: 
                    238: 
                    239: 
                    240: 
                    241: 
                    242: 
                    243: 
                    244: 
                    245: 
                    246: 
                    247: 
                    248: 
                    249: 
                    250: 
                    251: 
                    252: 
                    253: 
                    254: 
                    255: 
                    256: 
                    257: 
                    258: 
                    259: 
                    260: 
                    261:      Page 4                                         (printed 10/10/90)
                    262: 
                    263: 
                    264: 

unix.superglobalmegacorp.com

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