|
|
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.