Return to cpio.man CVS log

Up to [MW Coherent from dump] / coherent / d / usr / bin / pax

Annotation of coherent/d/usr/bin/pax/cpio.man, revision 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: 

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