1.\" Copyright (c) 1980, 1991 Regents of the University of California. 2.\" All rights reserved. 3.\" 4.\" %sccs.include.redist.man% 5.\" 6.\" @(#)arff.8 6.5 (Berkeley) 03/16/91 7.\" 8.Dd 9.Dt ARFF 8 10.Os BSD 4 11.Sh NAME 12.Nm arff 13.Nd floppy archiver 14.Sh SYNOPSIS 15.Nm arff 16.Op Ar key 17.Op Ar name Ar ... 18.Sh DESCRIPTION 19.Nm Arff 20saves and restores files 21on 22.Tn VAX 23console media (the console floppy on the 24.Tn VAX 2511/780 and 785, 26the cassette on the 11/730, and the console RL02 on the 8600/8650). 27Its actions are controlled by the 28.Ar key 29argument. 30The 31.Ar key 32is a string of characters containing 33at most one function letter and possibly 34one or more function modifiers. 35Other arguments to the command are file 36names specifying which files are to be dumped or restored. 37The default options are correct for the RX01 floppy on the 780; 38for other console media, the 39.Fl f 40and 41.Fl m 42flags are required. 43.Pp 44Files names have restrictions, because of radix50 considerations. They 45must be in the form 1-6 alphanumerics followed by 46.Ql \&. 47followed by 480-3 alphanumerics. Case distinctions are lost. Only the trailing component 49of a pathname is used. 50.Pp 51The function portion of 52the key is specified by one of the following letters: 53.Bl -tag -width Ds 54.It Fl d 55The named files are deleted from the floppy. Arff will combine contiguous 56deleted files into one empty entry in the rt-11 directory. 57.It Fl r 58The named files 59are replaced where found on the floppy, or added taking up 60the minimal possible portion of the first empty spot on the floppy. 61.It Fl t 62The names of the specified files are listed each time they occur 63on the floppy. 64If no file argument is given, 65all of the names on the floppy are listed. 66.It Fl x 67The named files are extracted from the floppy. 68.El 69.Pp 70The following characters may be used in addition to the letter 71which selects the function desired. 72.Bl -tag -width Ds 73.It Fl c 74causes 75.Nm arff 76to create a new directory on the floppy, effectively deleting 77all previously existing files. 78.It Fl f 79causes 80.Nm arff 81to use the next argument as the name of the archive instead 82of 83.Pa /dev/floppy . 84.It Fl m 85causes 86.Nm arff 87not to use the mapping algorithm employed in interleaving sectors 88around a floppy disk. In conjunction with the 89.Fl f 90option it may be 91used for extracting files from rt11 formatted cartridge disks, for 92example. 93It may also be used to speed up reading from and writing to 94rx02 floppy disks, by using the `c' device instead of the `b' device. 95It must be used with TU58 or RL02 media. 96.It Fl v 97The 98.Fl v 99(verbose) 100option, when used with the 101.Fl t 102function gives more information about the 103floppy entries than just the name. 104.El 105.Sh FILES 106.Bl -tag -width /dev/floppyxxx -compact 107.It Pa /dev/floppy 108default floppy device 109.El 110.Sh SEE ALSO 111.Xr crl 4 , 112.Xr fl 4 , 113.Xr rx 4 , 114.Xr tu 4 , 115.Xr floppy 8 , 116.Xr rxformat 8 117.Sh BUGS 118Device errors are handled ungracefully. 119.Sh HISTORY 120The 121.Nm 122command appeared in 123.Bx 4.0 . 124