mirror of
https://git.FreeBSD.org/src.git
synced 2024-12-24 11:29:10 +00:00
c4d9468ea0
Avoid using parenthesis enclosure macros (.Pq and .Po/.Pc) with plain text. Not only this slows down the mdoc(7) processing significantly, but it also has an undesired (in this case) effect of disabling hyphenation within the entire enclosed block.
122 lines
3.5 KiB
Groff
122 lines
3.5 KiB
Groff
.\"
|
|
.\" ----------------------------------------------------------------------------
|
|
.\" "THE BEER-WARE LICENSE" (Revision 42):
|
|
.\" <phk@login.dkuug.dk> wrote this file. As long as you retain this notice you
|
|
.\" can do whatever you want with this stuff. If we meet some day, and you think
|
|
.\" this stuff is worth it, you can buy me a beer in return. Poul-Henning Kamp
|
|
.\" ----------------------------------------------------------------------------
|
|
.\"
|
|
.\" $FreeBSD$
|
|
.\"
|
|
.\"
|
|
.Dd September 16, 1993
|
|
.Os
|
|
.Dt FDWRITE 1
|
|
.Sh NAME
|
|
.Nm fdwrite
|
|
.Nd format and write floppy disks
|
|
.Sh SYNOPSIS
|
|
.Nm
|
|
.Op Fl v
|
|
.Op Fl y
|
|
.Op Fl f Ar inputfile
|
|
.Op Fl d Ar device
|
|
.Sh DESCRIPTION
|
|
.Nm Fdwrite
|
|
formats and writes one and more floppy disks.
|
|
Any floppy disk device capable of formatting can be used.
|
|
.Pp
|
|
.Nm Fdwrite
|
|
will ask the user
|
|
(on
|
|
.Pa /dev/tty )
|
|
to insert a new floppy and press return.
|
|
The device will then be opened, and queried for its parameters,
|
|
then each track will be formatted, written with data from the
|
|
.Ar inputfile ,
|
|
read back and compared.
|
|
When the floppy disk is filled, the process is repeated, with the next disk.
|
|
This continues until the program is interrupted or EOF is encountered on the
|
|
.Ar inputfile .
|
|
.Pp
|
|
The options are as follows:
|
|
.Bl -tag -width 10n -offset indent
|
|
.It Fl v
|
|
Toggle verbosity on stdout.
|
|
Default is ``on''.
|
|
After
|
|
.Ar device
|
|
is opened first time the format will be printed.
|
|
During operation progress will be reported with the number of tracks
|
|
remaining on the current floppy disk, and the letters I, Z, F, W,
|
|
R and C, which indicates completion of Input, Zero-fill, Format
|
|
Write, Read and Compare of current track respectively.
|
|
.It Fl y
|
|
Don't ask for presence of a floppy disk in the drive.
|
|
This non-interactive flag
|
|
is useful for shell scripts.
|
|
.It Fl f Ar inputfile
|
|
Input file to read. If none is given, stdin is assumed.
|
|
.It Fl d Ar device
|
|
The name of the floppy device to write to. Default is
|
|
.Pa /dev/fd0 .
|
|
.El
|
|
.Pp
|
|
.Nm Fdwrite
|
|
actually closes the
|
|
.Ar device
|
|
while it waits for the user to press return,
|
|
it is thus quite possible to use the drive for other purposes at this
|
|
time and later resume writing with the next floppy.
|
|
.Pp
|
|
The parameters returned from
|
|
.Ar device
|
|
are used for formatting.
|
|
If custom formatting is needed, please use
|
|
.Xr fdformat 1
|
|
instead.
|
|
.Sh EXAMPLES
|
|
.Nm Fdwrite
|
|
was planned as a tool to make life easier when writing a set of floppies,
|
|
one such use could be to write a tar-archive:
|
|
.Pp
|
|
.Dl "tar cf - . | gzip -9 | fdwrite -d /dev/fd0.1720 -v
|
|
.Pp
|
|
The main difference from using
|
|
.Xr tar 1 Ns 's
|
|
multivolume facility is of course the formatting of the floppies, which
|
|
here is done on the fly,
|
|
thus reducing the amount of work for the floppy-jockey.
|
|
.Sh SEE ALSO
|
|
.Xr fdformat 1
|
|
.Sh HISTORY
|
|
.Nm Fdwrite
|
|
was written while waiting for ``make world'' to complete.
|
|
Some of the code was taken from
|
|
.Xr fdformat 1 .
|
|
.Sh AUTHORS
|
|
The program has been contributed by
|
|
.An Poul-Henning Kamp Aq phk@login.dknet.dk .
|
|
.Sh BUGS
|
|
Diagnostics are less than complete at present.
|
|
.Pp
|
|
If a floppy is sick, and the
|
|
.Ar inputfile
|
|
is seekable, it should ask the user to frisbee the disk, insert
|
|
another, and rewind to the right spot and continue.
|
|
.Pp
|
|
This concept could be extended to cover non-seekable input also
|
|
by employing a temporary file.
|
|
.Pp
|
|
An option (defaulting to zero) should allow the user to ask for
|
|
retries in case of failure.
|
|
.Pp
|
|
At present a suitable tool for reading back a multivolume set
|
|
of floppies is missing.
|
|
Programs like
|
|
.Xr tar 1
|
|
for instance, will do the job, if the data has not been compressed.
|
|
One can always trust
|
|
.Xr dd 1
|
|
to help out in this situation of course.
|