xref: /csrg-svn/old/arff/arff.8 (revision 47469)
1*47469Scael.\" Copyright (c) 1980, 1991 Regents of the University of California.
2*47469Scael.\" All rights reserved.
318829Smckusick.\"
4*47469Scael.\" %sccs.include.redist.man%
518829Smckusick.\"
6*47469Scael.\"     @(#)arff.8	6.5 (Berkeley) 03/16/91
7*47469Scael.\"
8*47469Scael.Dd
9*47469Scael.Dt ARFF 8
10*47469Scael.Os BSD 4
11*47469Scael.Sh NAME
12*47469Scael.Nm arff
13*47469Scael.Nd floppy archiver
14*47469Scael.Sh SYNOPSIS
15*47469Scael.Nm arff
16*47469Scael.Op Ar key
17*47469Scael.Op Ar name Ar ...
18*47469Scael.Sh DESCRIPTION
19*47469Scael.Nm Arff
2018829Smckusicksaves and restores files
21*47469Scaelon
22*47469Scael.Tn VAX
23*47469Scaelconsole media (the console floppy on the
24*47469Scael.Tn VAX
25*47469Scael11/780 and 785,
2628320Skarelsthe cassette on the 11/730, and the console RL02 on the 8600/8650).
2718829SmckusickIts actions are controlled by the
28*47469Scael.Ar key
2918829Smckusickargument.
3018829SmckusickThe
31*47469Scael.Ar key
3218829Smckusickis a string of characters containing
3318829Smckusickat most one function letter and possibly
3418829Smckusickone or more function modifiers.
3518829SmckusickOther arguments to the command are file
3618829Smckusicknames specifying which files are to be dumped or restored.
3728320SkarelsThe default options are correct for the RX01 floppy on the 780;
3828320Skarelsfor other console media, the
39*47469Scael.Fl f
4028320Skarelsand
41*47469Scael.Fl m
4228320Skarelsflags are required.
43*47469Scael.Pp
4418829SmckusickFiles names have restrictions, because of radix50 considerations.  They
45*47469Scaelmust be in the form 1-6 alphanumerics followed by
46*47469Scael.Ql \&.
47*47469Scaelfollowed by
4818829Smckusick0-3 alphanumerics.  Case distinctions are lost.  Only the trailing component
4918829Smckusickof a pathname is used.
50*47469Scael.Pp
5118829SmckusickThe function portion of
5218829Smckusickthe key is specified by one of the following letters:
53*47469Scael.Bl -tag -width Ds
54*47469Scael.It Fl d
55*47469ScaelThe named files are deleted from the floppy.  Arff will combine contiguous
56*47469Scaeldeleted files into one empty entry in the rt-11 directory.
57*47469Scael.It Fl r
5818829SmckusickThe named files
5918829Smckusickare replaced where found on the floppy, or added taking up
6018829Smckusickthe minimal possible portion of the first empty spot on the floppy.
61*47469Scael.It Fl t
6218829SmckusickThe names of the specified files are listed each time they occur
6318829Smckusickon the floppy.
6418829SmckusickIf no file argument is given,
6518829Smckusickall of the names on the floppy are listed.
66*47469Scael.It Fl x
67*47469ScaelThe named files are extracted from the floppy.
68*47469Scael.El
69*47469Scael.Pp
7018829SmckusickThe following characters may be used in addition to the letter
7118829Smckusickwhich selects the function desired.
72*47469Scael.Bl -tag -width Ds
73*47469Scael.It Fl c
74*47469Scaelcauses
75*47469Scael.Nm arff
76*47469Scaelto create a new directory on the floppy, effectively deleting
77*47469Scaelall previously existing files.
78*47469Scael.It Fl f
7918829Smckusickcauses
80*47469Scael.Nm arff
8118829Smckusickto use the next argument as the name of the archive instead
82*47469Scaelof
83*47469Scael.Pa /dev/floppy .
84*47469Scael.It Fl m
8518829Smckusickcauses
86*47469Scael.Nm arff
8718829Smckusicknot to use the mapping algorithm employed in interleaving sectors
8818829Smckusickaround a floppy disk.  In conjunction with the
89*47469Scael.Fl f
9018829Smckusickoption it may be
9118829Smckusickused for extracting files from rt11 formatted cartridge disks, for
9228320Skarelsexample.
9328320SkarelsIt may also be used to speed up reading from and writing to
9418830Smckusickrx02 floppy disks, by using the `c' device instead of the `b' device.
9528320SkarelsIt must be used with TU58 or RL02 media.
96*47469Scael.It Fl v
97*47469ScaelThe
98*47469Scael.Fl v
99*47469Scael(verbose)
100*47469Scaeloption, when used with the
101*47469Scael.Fl t
102*47469Scaelfunction gives more information about the
103*47469Scaelfloppy entries than just the name.
104*47469Scael.El
105*47469Scael.Sh FILES
106*47469Scael.Bl -tag -width /dev/floppyxxx -compact
107*47469Scael.It Pa /dev/floppy
108*47469Scaeldefault floppy device
109*47469Scael.El
110*47469Scael.Sh SEE ALSO
111*47469Scael.Xr crl 4 ,
112*47469Scael.Xr fl 4 ,
113*47469Scael.Xr rx 4 ,
114*47469Scael.Xr tu 4 ,
115*47469Scael.Xr floppy 8 ,
116*47469Scael.Xr rxformat 8
117*47469Scael.Sh BUGS
11828320SkarelsDevice errors are handled ungracefully.
119*47469Scael.Sh HISTORY
120*47469ScaelThe
121*47469Scael.Nm
122*47469Scaelcommand appeared in
123*47469Scael.Bx 4.0 .
124