[unix-history] / usr / man / man1 / arff.1m

.TH ARFF 1M
.UC
.SH NAME
arff \- archiver for floppy
.SH SYNOPSIS
.B arff
[ key ] [ name ... ]
.SH DESCRIPTION
.I Arff
saves and restores files
on the console floppy disk.
Its actions are controlled by the
.I key
argument.
The
.I key
is a string of characters containing
at most one function letter and possibly
one or more function modifiers.
Other arguments to the command are file
names specifying which files are to be dumped or restored.
.PP
Files names have restrictions, because of radix50 considerations.  They
must be in the form 1-6 alphanumerics followed by "." followed by
0-3 alphanumerics.  Case distinctions are lost.  Only the trailing component
of a pathname is used.
.PP
The function portion of
the key is specified by one of the following letters:
.TP 8
.B  r
The named files
are replaced where found on the floppy, or added taking up
the minimal possible portion of the first empty spot on the floppy.
.TP 8
.B  x
The named files are extracted from the floppy.
.TP 8
.B  d
The named files are deleted from the floppy.  Arff will combine contiguous
deleted files into one empty entry in the rt-11 directory.
.TP 8
.B  t
The names of the specified files are listed each time they occur
on the floppy.
If no file argument is given,
all of the names on the floppy are listed.
.PP
The following characters may be used in addition to the letter
which selects the function desired.
.TP 10
.B  v
Normally
.I arff
does its work silently.
The
.B v
(verbose)
option causes it to type the name of each file it treats
preceded by the function letter.
With the
.B t
function,
.B v
gives more information about the
floppy entries than just the name.
.TP 10
.B f
causes 
.I arff
to use the next argument as the name of the archive instead
of /dev/floppy. 
.TP 10
.B m
causes
.I arff
not to use the mapping algorithm employed in interleaving sectors
around a floppy disk.  In conjunction with the 
.B f
option it may be
used for extracting files from rt11 formatted cartridge disks, for
example.
.SH FILES
/dev/floppy
.SH "SEE ALSO"
``Configuring the Berkeley Virtual Memory Extensions to theUNIX System''
which describes how to set up boot files on the floppy.
.SH BUGS
Multiple segmented rt11 directories are not yet supported.
.br
Floppy errors are handled ungracefully.
.SH AUTHORS
Keith Sklower, Richard Tuck
Commit	Line	Data
6c4629f3 KS	1	.TH ARFF 1M
	2	.UC
	3	.SH NAME
	4	arff \- archiver for floppy
	5	.SH SYNOPSIS
	6	.B arff
	7	[ key ] [ name ... ]
	8	.SH DESCRIPTION
	9	.I Arff
	10	saves and restores files
	11	on the console floppy disk.
	12	Its actions are controlled by the
	13	.I key
	14	argument.
	15	The
	16	.I key
	17	is a string of characters containing
	18	at most one function letter and possibly
	19	one or more function modifiers.
	20	Other arguments to the command are file
	21	names specifying which files are to be dumped or restored.
	22	.PP
	23	Files names have restrictions, because of radix50 considerations. They
	24	must be in the form 1-6 alphanumerics followed by "." followed by
	25	0-3 alphanumerics. Case distinctions are lost. Only the trailing component
	26	of a pathname is used.
	27	.PP
	28	The function portion of
	29	the key is specified by one of the following letters:
	30	.TP 8
	31	.B r
	32	The named files
	33	are replaced where found on the floppy, or added taking up
	34	the minimal possible portion of the first empty spot on the floppy.
	35	.TP 8
	36	.B x
	37	The named files are extracted from the floppy.
	38	.TP 8
	39	.B d
	40	The named files are deleted from the floppy. Arff will combine contiguous
	41	deleted files into one empty entry in the rt-11 directory.
	42	.TP 8
	43	.B t
	44	The names of the specified files are listed each time they occur
	45	on the floppy.
	46	If no file argument is given,
	47	all of the names on the floppy are listed.
	48	.PP
	49	The following characters may be used in addition to the letter
	50	which selects the function desired.
	51	.TP 10
	52	.B v
	53	Normally
	54	.I arff
	55	does its work silently.
	56	The
	57	.B v
	58	(verbose)
	59	option causes it to type the name of each file it treats
	60	preceded by the function letter.
	61	With the
	62	.B t
	63	function,
	64	.B v
65	gives more information about the
66	floppy entries than just the name.
67	.TP 10
68	.B f
69	causes
70	.I arff
71	to use the next argument as the name of the archive instead
72	of /dev/floppy.
73	.TP 10
74	.B m
75	causes
76	.I arff
77	not to use the mapping algorithm employed in interleaving sectors
78	around a floppy disk. In conjunction with the
79	.B f
80	option it may be
81	used for extracting files from rt11 formatted cartridge disks, for
82	example.
83	.SH FILES
84	/dev/floppy
85	.SH "SEE ALSO"
86	``Configuring the Berkeley Virtual Memory Extensions to theUNIX System''
87	which describes how to set up boot files on the floppy.
88	.SH BUGS
89	Multiple segmented rt11 directories are not yet supported.
90	.br
91	Floppy errors are handled ungracefully.
92	.SH AUTHORS
93	Keith Sklower, Richard Tuck