Return to cpio.1 CVS log

Up to [Research Unix] / researchv10dc / man / adm / man1

Annotation of researchv10dc/man/adm/man1/cpio.1, revision 1.1.1.1

1.1       root        1: .TH CPIO 1
                      2: .CT 1 comm_users
                      3: .SH NAME
                      4: cpio \- copy file archives in and out
                      5: .SH SYNOPSIS
                      6: .B cpio
                      7: .BI -o
                      8: [
                      9: .I acBv
                     10: ]
                     11: .PP
                     12: .B cpio
                     13: .BI -i
                     14: [
                     15: .I BcdmrtuvfsSb6
                     16: ]
                     17: [
                     18: .I pattern ...
                     19: ]
                     20: .PP
                     21: .B cpio
                     22: .BI -p
                     23: [
                     24: .I adlmruv
                     25: ]
                     26: .I directory
                     27: .SH DESCRIPTION
                     28: .B Cpio -o
                     29: (copy out)
                     30: reads the standard input to obtain a list of path names
                     31: and copies those files onto the
                     32: standard output
                     33: together with path name and status information.
                     34: .PP
                     35: .B Cpio -i
                     36: (copy in)
                     37: extracts files from the
                     38: standard input
                     39: which is assumed to be the product of a previous
                     40: .BR "cpio -o" .
                     41: Only files with names that match the
                     42: .I patterns
                     43: are selected.
                     44: .I Patterns
                     45: are given in the name-generating notation of
                     46: .IR sh (1);
                     47: the default is
                     48: .BR * 
                     49: (all files).
                     50: The extracted files are conditionally created and copied
                     51: into the current directory tree
                     52: based upon the options described below.
                     53: File ownership is preserved if possible.
                     54: .PP
                     55: .B Cpio -p
                     56: (pass) reads from the standard input a list of path names
                     57: of files to copy
                     58: into the destination
                     59: .IR directory.
                     60: .PP
                     61: The options are:
                     62: .PP
                     63: .PD 0
                     64: .TP
                     65: .B a
                     66: Reset access times of input files after they have been copied.
                     67: .TP
                     68: .B B
                     69: Input/output is to be blocked 5,120 bytes to the record
                     70: (does not apply to the
                     71: .I pass\^
                     72: option; meaningful only with data directed to or from
                     73: .FR /dev/rmt? ).
                     74: .TP
                     75: .B d
                     76: .I Directories\^
                     77: are to be created as needed.
                     78: .TP
                     79: .B c
                     80: Write header
                     81: information in
                     82: .SM ASCII
                     83: character form for portability.
                     84: .TP
                     85: .B r
                     86: Interactively rename
                     87: files.
                     88: An empty name (newline only) causes a file to be skipped.
                     89: .TP
                     90: .B t
                     91: Print a table of contents
                     92: of the input.
                     93: No files are created.
                     94: .TP
                     95: .B u
                     96: Copy unconditionally
                     97: (normally an older file will not overwrite a newer file).
                     98: .TP
                     99: .B v
                    100: (Verbose)
                    101: List file
                    102: names;
                    103: .B -vt
                    104: looks like
                    105: .BR "ls -l" .
                    106: .TP
                    107: .B l
                    108: Whenever possible, link files rather than copying them.
                    109: Usable only with
                    110: the
                    111: .B -p
                    112: option.
                    113: .TP
                    114: .B m
                    115: Retain previous file modification time.
                    116: This option is ineffective on directories that are being copied.
                    117: .TP
                    118: .B f
                    119: Copy in all files except those in
                    120: .I patterns.\^
                    121: .TP
                    122: .B s
                    123: Swap bytes.
                    124: Use only with the
                    125: .B -i
                    126: option.
                    127: .TP
                    128: .B S
                    129: Swap halfwords.
                    130: Use only with the
                    131: .B -i
                    132: option.
                    133: .TP
                    134: .B b
                    135: Swap both bytes and halfwords.
                    136: Use only with the
                    137: .B -i
                    138: option.
                    139: .TP
                    140: .B 6
                    141: Process an old (i.e.,
                    142: .SM UNIX Sixth\^
                    143: Edition format)
                    144: file.
                    145: Only useful with
                    146: .B -i
                    147: (copy in).
                    148: .PD
                    149: .SH EXAMPLES
                    150: .TP
                    151: .L
                    152: ls | cpio -oc >/dev/mt1
                    153: Copy the contents of the current directory to a tape.
                    154: .PP
                    155: .EX
                    156: mkdir newdir
                    157: cd olddir
                    158: find . -print | cpio -pd ../newdir
                    159: .EE
                    160: .ns
                    161: .IP
                    162: Reproduce a directory hierarchy;
                    163: .B newdir
                    164: must exist.
                    165: .PD
                    166: .SH SEE ALSO
                    167: .IR ar (1), 
                    168: .IR bundle (1),
                    169: .IR tar (1),
                    170: .IR find (1), 
                    171: .IR cpio (5), 
                    172: .IR cp (1)
                    173: .SH BUGS
                    174: Path names are restricted to 128 characters.
                    175: .br
                    176: Does not know about symbolic links.
                    177: .br
                    178: If there are too many unique linked files,
                    179: linking information is lost.
                    180: .br
                    181: Only the super-user can copy special files.
                    182: .br
                    183: The archive size is reported in archaic `blocks' of 512 bytes.
                    184: .\"    @(#)cpio.1      5.2 of 5/18/82

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