43BSDReno/contrib/ansi/ansitape.1 - annotate

Return to ansitape.1 CVS log

Up to [CSRG BSD Unix] / 43BSDReno / contrib / ansi

Annotation of 43BSDReno/contrib/ansi/ansitape.1, revision 1.1.1.1

1.1 root 1: .TH ANSITAPE LOCAL "4/10/85 UCB Local"
2: .SH NAME
3: ansitape - ANSI standard tape handler
4: .SH SYNOPSIS
5: .B ansitape
6: [key] [keyargs] [files]
7: .SH DESCRIPTION
8: .I Ansitape
9: reads and writes magnetic tapes written in
10: ANSI standard format
11: (called ``Files-11'' by DEC).
12: Tapes written by
13: .I ansitape
14: are labeled with the first 6 characters of the machine name by default.
15: Actions are controlled by the
16: .I key
17: argument.
18: The
19: .I key
20: is a string of characters containing at
21: most one function letter.
22: Other arguments to the command are
23: a tape label and file names specifying which files are
24: to be written onto or extracted from the tape.
25: .PP
26: The function portion of the key is
27: specified by one of the following letters:
28: .TP 8
29: .B r
30: The named files are written at the end of the tape.
31: The
32: .B c
33: function implies this.
34: .TP 8
35: .B x
36: The named files are extracted from the tape.
37: If no file argument is given,
38: the entire contents of the tape is extracted.
39: Note that if the tape has duplicated file names,
40: only the last file of a given name can
41: be extracted.
42: .TP 8
43: .B t
44: The names of the specified files are listed
45: each time they occur on the tape.
46: If no file argument is given,
47: all files on the tape are listed.
48: .TP 8
49: .B c
50: Create a new tape; writing begins at the
51: beginning of the tape instead of after
52: the last file.
53: This command implies
54: .B r.
55: .PP
56: The following characters may be used in
57: addition to the letter which selects
58: the function desired.
59: .TP 8
60: .B f
61: This argument allows the selection of a different tape
62: device.
63: The next word in the keyargs list is taken to be
64: the full name of a device to write the tape on.
65: The default is /dev/rmt12.
66: .TP 8
67: .B n
68: The
69: .B n
70: option allows the user to specify as the next argument in the keyargs list,
71: a control file
72: containing the names of files to put on the tape.
73: If the file name is '-', the control file will, instead, be read
74: from standard input.
75: The control file contains one line for each file
76: to be placed on the tape.
77: Each line has two names, the name of the file on
78: the local machine, and the name it is to have when
79: placed on the tape. This allows for more convenient
80: flattening of hierarchies when placing them on tape.
81: If the second name is omitted, the UNIX file name will be
82: used on the tape also.
83: This argument can only be used with the
84: .B r
85: and
86: .B c
87: functions.
88: .TP 8
89: .B l
90: The
91: .B l
92: option allows the user to specify the label to be placed on the tape.
93: The next argument in the keyargs list is taken as the tape label, which
94: will be space padded or truncated to six characters.
95: This option is meaningless unless
96: .B c
97: is also specified.
98: .TP 8
99: .B v
100: Normally
101: .I ansitape
102: works relatively silently.
103: The
104: .B v
105: (verbose) option causes it to type
106: information about each file as it processes it.
107: .TP 8
108: .B b
109: The
110: .B b
111: option allows the user to select the blocksize to be used for the
112: tape.
113: By default,
114: .I ansitape
115: uses the maximum block size permitted by the ANSI standard, 2048.
116: Some systems will permit a much larger block size, and if large
117: files are being put on the tape it may be advantageous to do so.
118: .I Ansitape
119: will take the next argument of the keyargs list as the blocksize for the tape.
120: Values below 18 or above 32k will be limited to that range.
121: The standard scale factors b=512 and k=1024 are accepted.
122: .TP 8
123: .B F
124: The
125: .B F
126: flag allows
127: .I ansitape
128: to write ansi 'D' format fixed record length tapes.
129: The next two keyargs must be the recordsize and blocksize to be used,
130: with the same scale factors and range limits as for the
131: .B b
132: option.
133: The files to be written by the
134: .B F
135: flag must be in fixed format on the unix end - all lines should be
136: .I EXACTLY
137: .B recordsize
138: bytes long plus a terminating newline (which will be discarded).
139: Note that this is exactly the same format produced by
140: .I ansitape
141: when reading an ansi 'D' format tape.
142: .PP
143: .I Ansitape
144: will not copy directories, character or block special files,
145: symbolic links, sockets, or binary executables.
146: Attempts to put these on tape will result in warnings, and they will
147: be skipped completely.
148: .SH FILES
149: /dev/rmt12
150: .br
151: .SH DIAGNOSTICS
152: A warning message will be generated when a record exceeds the maximum record
153: length and the affected file will be truncated.
154: .br
155: .SH BUGS
156: Ansitape quietly truncates names longer than 17 characters.
157: .br
158: Multivolume tapes can be read (provided no files cross the
159: volume boundary) but not written.
160: .br

unix.superglobalmegacorp.com

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