[unix-history] / usr / man / man8 / arff.8

.TH ARFF 8V "28 February 1983"
.UC 4
.SH NAME
arff, flcopy \- archiver and copier for floppy
.SH SYNOPSIS
.B /etc/arff
[ key ] [ name ... ]
.br
.B /etc/flcopy
[
.B \-h
] [
\fB\-t\fIn\fR
]
.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.
.TP 10
.B c
causes
.I arff
to create a new directory on the floppy, effectively deleting
all previously existing files.
.PP
.I Flcopy
copies
the console floppy disk
(opened as `/dev/floppy')
to a file created in the
current directory, named \*(lqfloppy\*(rq,
then prints the message
\*(lqChange Floppy, hit return when done\*(rq.
Then
.I flcopy
copies the local file back out to the floppy disk.
.PP
The
.B \-h
option to 
.I flcopy
causes it to
open a file named \*(lqfloppy\*(rq in the current directory
and copy it to
.I /dev/floppy;
the
.B \-t
option
causes only the first
.I n
tracks to participate in a copy.
.PP
.I Arff
may also be used with the console TU58 cassettes on the 11/730.
To do so, the 
.B m
key must be specified.   Normally, the
.B f
key is also used.
.SH FILES
/dev/floppy
.br
floppy (in current directory)
.SH AUTHORS
Keith Sklower, Richard Tuck
.SH BUGS
Floppy errors are handled ungracefully;
.I Arff
does not handle multi-segment rt11 directories.
Commit	Line	Data
0743960f C	1	.TH ARFF 8V "28 February 1983"
	2	.UC 4
	3	.SH NAME
	4	arff, flcopy \- archiver and copier for floppy
	5	.SH SYNOPSIS
	6	.B /etc/arff
	7	[ key ] [ name ... ]
	8	.br
	9	.B /etc/flcopy
	10	[
	11	.B \-h
	12	] [
	13	\fB\-t\fIn\fR
	14	]
	15	.SH DESCRIPTION
	16	.I Arff
	17	saves and restores files
	18	on the console floppy disk.
	19	Its actions are controlled by the
	20	.I key
	21	argument.
	22	The
	23	.I key
	24	is a string of characters containing
	25	at most one function letter and possibly
	26	one or more function modifiers.
	27	Other arguments to the command are file
	28	names specifying which files are to be dumped or restored.
	29	.PP
	30	Files names have restrictions, because of radix50 considerations. They
	31	must be in the form 1-6 alphanumerics followed by "." followed by
	32	0-3 alphanumerics. Case distinctions are lost. Only the trailing component
	33	of a pathname is used.
	34	.PP
	35	The function portion of
	36	the key is specified by one of the following letters:
	37	.TP 8
	38	.B r
	39	The named files
	40	are replaced where found on the floppy, or added taking up
	41	the minimal possible portion of the first empty spot on the floppy.
	42	.TP 8
	43	.B x
	44	The named files are extracted from the floppy.
	45	.TP 8
	46	.B d
	47	The named files are deleted from the floppy. Arff will combine contiguous
	48	deleted files into one empty entry in the rt-11 directory.
	49	.TP 8
	50	.B t
	51	The names of the specified files are listed each time they occur
	52	on the floppy.
	53	If no file argument is given,
	54	all of the names on the floppy are listed.
	55	.PP
	56	The following characters may be used in addition to the letter
	57	which selects the function desired.
	58	.TP 10
	59	.B v
	60	Normally
	61	.I arff
	62	does its work silently.
	63	The
	64	.B v
65	(verbose)
66	option causes it to type the name of each file it treats
67	preceded by the function letter.
68	With the
69	.B t
70	function,
71	.B v
72	gives more information about the
73	floppy entries than just the name.
74	.TP 10
75	.B f
76	causes
77	.I arff
78	to use the next argument as the name of the archive instead
79	of /dev/floppy.
80	.TP 10
81	.B m
82	causes
83	.I arff
84	not to use the mapping algorithm employed in interleaving sectors
85	around a floppy disk. In conjunction with the
86	.B f
87	option it may be
88	used for extracting files from rt11 formatted cartridge disks, for
89	example.
90	.TP 10
91	.B c
92	causes
93	.I arff
94	to create a new directory on the floppy, effectively deleting
95	all previously existing files.
96	.PP
97	.I Flcopy
98	copies
99	the console floppy disk
100	(opened as `/dev/floppy')
101	to a file created in the
102	current directory, named \(lqfloppy\(rq,
103	then prints the message
104	\(lqChange Floppy, hit return when done\(rq.
105	Then
106	.I flcopy
107	copies the local file back out to the floppy disk.
108	.PP
109	The
110	.B \-h
111	option to
112	.I flcopy
113	causes it to
114	open a file named \(lqfloppy\(rq in the current directory
115	and copy it to
116	.I /dev/floppy;
117	the
118	.B \-t
119	option
120	causes only the first
121	.I n
122	tracks to participate in a copy.
123	.PP
124	.I Arff
125	may also be used with the console TU58 cassettes on the 11/730.
126	To do so, the
127	.B m
128	key must be specified. Normally, the
129	.B f
130	key is also used.
131	.SH FILES
132	/dev/floppy
133	.br
134	floppy (in current directory)
135	.SH AUTHORS
136	Keith Sklower, Richard Tuck
137	.SH BUGS
138	Floppy errors are handled ungracefully;
139	.I Arff
140	does not handle multi-segment rt11 directories.