![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to ustar.man CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [MW Coherent from dump] / coherent / d / usr / bin / pax / shipping|
Return to ustar.man CVS log | Up to [MW Coherent from dump] / coherent / d / usr / bin / pax / shipping |
1.1 root 1: USTAR COHERENT (USENIX Association) USTAR
2: NAME
3: ustar - process tape archives
4: SYNOPSIS
5: ustar -c[bfvw] device block filename...
6: ustar -r[bvw] device block [filename...]
7: ustar -t[fv] device
8: ustar -x[flmovw] device [filename...]
9: DESCRIPTION
10: Ustar reads and writes archive files which conform to the
11: Archive/Interchange File Format specified in IEEE Std.
12: 1003.1-1988.
13: Options
14: The following options are available:
15: -c Creates a new archive; writing begins at the
16: beginning of the archive, instead of after the
17: last file.
18: -r Writes names files to the end of the archive.
19: -t Lists the names of all of the files in the
20: archive.
21: -x Extracts named files from the archive. If a named
22: file matches a directory whose contents had been
23: written onto the archive, that directory is
24: recursively extracted. If a named file in the
25: archive does not exist on the system, the file is
26: create with the same mode as the one in the
27: archive, except that the set-user-id and get-
28: group-id modes are not set unless the user has
29: appropriate privileges.
30: If the files exist, their modes are not changed except as
31: described above. The owner, group and modification time are
32: restored if possible. If no filename argument is given, the
33: entire contents of the archive is extracted. Note that if
34: several files with the same name are in the archive, the
35: last one will overwrite all earlier ones.
36: -b Causes ustar to use the next argument on the command
37: line as the blocking factor for tape records. The
38: default is 1; the maximum is 20. This option
39: Page 1 (printed 5/24/90)
40: USTAR COHERENT (USENIX Association) USTAR
41: should only be used with raw magnetic tape
42: archives. Normally, the block size is determined
43: automatically when reading tapes.
44: -f Causes ustar to use the next argument on the command
45: line as the name of the archive instead of the
46: default, which is usually a tape drive. If - is
47: specified as a filename ustar writes to the standard
48: output or reads from the standard input, whichever
49: is appropriate for the options given. Thus, ustar
50: can be used as the head or tail of a pipeline.
51: -l Tells ustar to report if it cannot resolve all of
52: the links to the files being archived. If -l is
53: not specified, no error messages are written to
54: the standard output. This modifier is only valid
55: with the -c, -r and -u options.
56: -m Tells ustar not to restore the modification times.
57: The modification time of the file will be the time
58: of extraction. This modifier is invalid with th
59: -t option.
60: -o Causes extracted files to take on the user and
61: group identifier of the user running the program
62: rather than those on the archive. This modifier
63: is only valid with the -x option.
64: -v Causes ustar to operate verbosely. Usually, ustar
65: does its work silently, but the v modifier causes
66: it to print the name of each file it processes,
67: preceded by the option letter. With the -t
68: option, v gives more information about the archive
69: entries than just the name.
70: -w Causes ustar to print the action to be taken,
71: followed by the name of the file, and then wait
72: for the user's confirmation. If a word beginning
73: with y is given, the action is performed. Any
74: other input means "no". This modifier is invalid
75: with the -t option.
76:
77: To create archive on high density floppy, enter (disk has been
78: formated before):
79: ustar cvf /dev/fha0 files_names
80: To display a listing of the archive:
81: ustar tvf /dev/fha0
82: For extract the files from this archive you can print:
83: ustar xvf /dev/fha0
84: SEE ALSO
85: cpio, dd, find, pax
86:
87: NOTES
88: Name ustar was selected because new tar uses ustar format and
89: by distinguish between original COHERENT tar and new one.
90:
91: Because COHERENT has memory restriction ustar cannot create
92: archive on big directories tree (about 2 Mb and more).
93:
94: ustar cannot append on magnetic tape.
95:
96: ustar doesn't support option -u .
97:
98: COPYRIGHT
99: Copyright (c) 1989 Mark H. Colburn.
100: COHERENT pax/ustar/cpio are based on original code for pax
101: which is sponsored by The USENIX Association.
102:
103: Page 3 (printed 5/24/90)
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.