upstream/opnsense-src
1
0
Fork 0
mirror of https://github.com/opnsense/src.git synced 2026-02-12 23:36:07 -05:00
Code Issues Projects Releases Packages Wiki Activity Actions
opnsense-src/usr.sbin/fdwrite/fdwrite.1

130 lines
3.6 KiB
Groff
Raw Normal View History

A small program, which can take a file of any size, format, write and verify it onto a bunch of floppies in a semi-intelligent way. Useful for things like: tar cf - . | gzip -9 | fdwrite -d /dev/rfd0.1720 -v Where it will keep asking for floppies until tar is done.
1994-09-18 03:39:19 -04:00
.\"
.\" ----------------------------------------------------------------------------
.\" "THE BEER-WARE LICENSE" (Revision 42):
Modernize my email address.
2002-03-25 09:12:49 -05:00
.\" <phk@FreeBSD.org> wrote this file. As long as you retain this notice you
A small program, which can take a file of any size, format, write and verify it onto a bunch of floppies in a semi-intelligent way. Useful for things like: tar cf - . | gzip -9 | fdwrite -d /dev/rfd0.1720 -v Where it will keep asking for floppies until tar is done.
1994-09-18 03:39:19 -04:00
.\" 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
.\" ----------------------------------------------------------------------------
.\"
$Id$ -> $FreeBSD$
1999-08-27 21:35:59 -04:00
.\" $FreeBSD$
A small program, which can take a file of any size, format, write and verify it onto a bunch of floppies in a semi-intelligent way. Useful for things like: tar cf - . | gzip -9 | fdwrite -d /dev/rfd0.1720 -v Where it will keep asking for floppies until tar is done.
1994-09-18 03:39:19 -04:00
.\"
.\"
.Dd September 16, 1993
.Dt FDWRITE 1
mdoc: order prologue macros consistently by Dd/Dt/Os Although groff_mdoc(7) gives another impression, this is the ordering most widely used and also required by mdocml/mandoc. Reviewed by: ru Approved by: philip, ed (mentors)
2010-04-14 15:08:06 -04:00
.Os
A small program, which can take a file of any size, format, write and verify it onto a bunch of floppies in a semi-intelligent way. Useful for things like: tar cf - . | gzip -9 | fdwrite -d /dev/rfd0.1720 -v Where it will keep asking for floppies until tar is done.
1994-09-18 03:39:19 -04:00
.Sh NAME
.Nm fdwrite
.Nd format and write floppy disks
.Sh SYNOPSIS
mdoc(7) police: use the new features of the Nm macro.
2000-11-20 15:10:44 -05:00
.Nm
Use err(3). Document -y flag. Remove unused -s flag from getopt string.
1997-09-18 02:35:51 -04:00
.Op Fl v
.Op Fl y
.Op Fl f Ar inputfile
.Op Fl d Ar device
A small program, which can take a file of any size, format, write and verify it onto a bunch of floppies in a semi-intelligent way. Useful for things like: tar cf - . | gzip -9 | fdwrite -d /dev/rfd0.1720 -v Where it will keep asking for floppies until tar is done.
1994-09-18 03:39:19 -04:00
.Sh DESCRIPTION
Use `The .Nm utility'
2002-04-20 08:27:18 -04:00
The
.Nm
utility formats and writes one and more floppy disks.
A small program, which can take a file of any size, format, write and verify it onto a bunch of floppies in a semi-intelligent way. Useful for things like: tar cf - . | gzip -9 | fdwrite -d /dev/rfd0.1720 -v Where it will keep asking for floppies until tar is done.
1994-09-18 03:39:19 -04:00
Any floppy disk device capable of formatting can be used.
Avoid use of direct troff requests in mdoc(7) manual pages.
2000-11-10 12:46:15 -05:00
.Pp
Use `The .Nm utility'
2002-04-20 08:27:18 -04:00
The
.Nm
utility will ask the user
mdoc(7) police: 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.
2001-08-07 11:48:51 -04:00
(on
.Pa /dev/tty )
A small program, which can take a file of any size, format, write and verify it onto a bunch of floppies in a semi-intelligent way. Useful for things like: tar cf - . | gzip -9 | fdwrite -d /dev/rfd0.1720 -v Where it will keep asking for floppies until tar is done.
1994-09-18 03:39:19 -04:00
to insert a new floppy and press return.
`it's'' -> `its'' where appropriate and typo fixes in time2posix.3. Closes PR docs/3612. Submitted by: Josh Gilliam <soil@quick.net>
1997-05-19 12:33:27 -04:00
The device will then be opened, and queried for its parameters,
A small program, which can take a file of any size, format, write and verify it onto a bunch of floppies in a semi-intelligent way. Useful for things like: tar cf - . | gzip -9 | fdwrite -d /dev/rfd0.1720 -v Where it will keep asking for floppies until tar is done.
1994-09-18 03:39:19 -04:00
then each track will be formatted, written with data from the
.Ar inputfile ,
read back and compared.
Typo. PR: 7093 Submitted by: Stefan Eggers <seggers@semyam.dinoco.de>
1998-06-27 17:29:35 -04:00
When the floppy disk is filled, the process is repeated, with the next disk.
A small program, which can take a file of any size, format, write and verify it onto a bunch of floppies in a semi-intelligent way. Useful for things like: tar cf - . | gzip -9 | fdwrite -d /dev/rfd0.1720 -v Where it will keep asking for floppies until tar is done.
1994-09-18 03:39:19 -04:00
This continues until the program is interrupted or EOF is encountered on the
.Ar inputfile .
Avoid use of direct troff requests in mdoc(7) manual pages.
2000-11-10 12:46:15 -05:00
.Pp
A small program, which can take a file of any size, format, write and verify it onto a bunch of floppies in a semi-intelligent way. Useful for things like: tar cf - . | gzip -9 | fdwrite -d /dev/rfd0.1720 -v Where it will keep asking for floppies until tar is done.
1994-09-18 03:39:19 -04:00
The options are as follows:
.Bl -tag -width 10n -offset indent
.It Fl v
Use err(3). Document -y flag. Remove unused -s flag from getopt string.
1997-09-18 02:35:51 -04:00
Toggle verbosity on stdout.
A small program, which can take a file of any size, format, write and verify it onto a bunch of floppies in a semi-intelligent way. Useful for things like: tar cf - . | gzip -9 | fdwrite -d /dev/rfd0.1720 -v Where it will keep asking for floppies until tar is done.
1994-09-18 03:39:19 -04:00
Default is ``on''.
Remove whitespace at EOL.
2001-07-15 04:06:20 -04:00
After
A small program, which can take a file of any size, format, write and verify it onto a bunch of floppies in a semi-intelligent way. Useful for things like: tar cf - . | gzip -9 | fdwrite -d /dev/rfd0.1720 -v Where it will keep asking for floppies until tar is done.
1994-09-18 03:39:19 -04:00
.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.
Use err(3). Document -y flag. Remove unused -s flag from getopt string.
1997-09-18 02:35:51 -04:00
.It Fl y
Expand *n't contractions.
2005-02-13 17:25:33 -05:00
Do not ask for presence of a floppy disk in the drive.
Remove single-space hard sentence breaks. These degrade the quality of the typeset output, tend to make diffs harder to read and provide bad examples for new-comers to mdoc.
2000-03-01 09:09:25 -05:00
This non-interactive flag
Use err(3). Document -y flag. Remove unused -s flag from getopt string.
1997-09-18 02:35:51 -04:00
is useful for shell scripts.
A small program, which can take a file of any size, format, write and verify it onto a bunch of floppies in a semi-intelligent way. Useful for things like: tar cf - . | gzip -9 | fdwrite -d /dev/rfd0.1720 -v Where it will keep asking for floppies until tar is done.
1994-09-18 03:39:19 -04:00
.It Fl f Ar inputfile
Mechanically kill hard sentence breaks.
2004-07-02 19:13:00 -04:00
Input file to read.
If none is given, stdin is assumed.
A small program, which can take a file of any size, format, write and verify it onto a bunch of floppies in a semi-intelligent way. Useful for things like: tar cf - . | gzip -9 | fdwrite -d /dev/rfd0.1720 -v Where it will keep asking for floppies until tar is done.
1994-09-18 03:39:19 -04:00
.It Fl d Ar device
Mechanically kill hard sentence breaks.
2004-07-02 19:13:00 -04:00
The name of the floppy device to write to.
Default is
/dev/r<FOO> => /dev/<FOO>
2000-04-26 07:52:44 -04:00
.Pa /dev/fd0 .
A small program, which can take a file of any size, format, write and verify it onto a bunch of floppies in a semi-intelligent way. Useful for things like: tar cf - . | gzip -9 | fdwrite -d /dev/rfd0.1720 -v Where it will keep asking for floppies until tar is done.
1994-09-18 03:39:19 -04:00
.El
Avoid use of direct troff requests in mdoc(7) manual pages.
2000-11-10 12:46:15 -05:00
.Pp
Use `The .Nm utility'
2002-04-20 08:27:18 -04:00
The
.Nm
utility actually closes the
A small program, which can take a file of any size, format, write and verify it onto a bunch of floppies in a semi-intelligent way. Useful for things like: tar cf - . | gzip -9 | fdwrite -d /dev/rfd0.1720 -v Where it will keep asking for floppies until tar is done.
1994-09-18 03:39:19 -04:00
.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.
Avoid use of direct troff requests in mdoc(7) manual pages.
2000-11-10 12:46:15 -05:00
.Pp
A small program, which can take a file of any size, format, write and verify it onto a bunch of floppies in a semi-intelligent way. Useful for things like: tar cf - . | gzip -9 | fdwrite -d /dev/rfd0.1720 -v Where it will keep asking for floppies until tar is done.
1994-09-18 03:39:19 -04:00
The parameters returned from
.Ar device
are used for formatting.
If custom formatting is needed, please use
.Xr fdformat 1
instead.
mdoc(7) police: use certified section headers wherever possible.
2000-11-17 06:44:16 -05:00
.Sh EXAMPLES
Use `The .Nm utility'
2002-04-20 08:27:18 -04:00
The
.Nm
utility
A small program, which can take a file of any size, format, write and verify it onto a bunch of floppies in a semi-intelligent way. Useful for things like: tar cf - . | gzip -9 | fdwrite -d /dev/rfd0.1720 -v Where it will keep asking for floppies until tar is done.
1994-09-18 03:39:19 -04:00
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:
Avoid use of direct troff requests in mdoc(7) manual pages.
2000-11-10 12:46:15 -05:00
.Pp
.Dl "tar cf - . | gzip -9 | fdwrite -d /dev/fd0.1720 -v
.Pp
A small program, which can take a file of any size, format, write and verify it onto a bunch of floppies in a semi-intelligent way. Useful for things like: tar cf - . | gzip -9 | fdwrite -d /dev/rfd0.1720 -v Where it will keep asking for floppies until tar is done.
1994-09-18 03:39:19 -04:00
The main difference from using
Prepare for mdoc(7)NG.
2001-01-16 04:39:23 -05:00
.Xr tar 1 Ns 's
A small program, which can take a file of any size, format, write and verify it onto a bunch of floppies in a semi-intelligent way. Useful for things like: tar cf - . | gzip -9 | fdwrite -d /dev/rfd0.1720 -v Where it will keep asking for floppies until tar is done.
1994-09-18 03:39:19 -04:00
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
.Sh AUTHOR -> .Sh AUTHORS. Use .An/.Aq.
1998-03-23 03:31:20 -05:00
.Xr fdformat 1
A small program, which can take a file of any size, format, write and verify it onto a bunch of floppies in a semi-intelligent way. Useful for things like: tar cf - . | gzip -9 | fdwrite -d /dev/rfd0.1720 -v Where it will keep asking for floppies until tar is done.
1994-09-18 03:39:19 -04:00
.Sh HISTORY
Use `The .Nm utility'
2002-04-20 08:27:18 -04:00
The
.Nm
utility was written while waiting for ``make world'' to complete.
A small program, which can take a file of any size, format, write and verify it onto a bunch of floppies in a semi-intelligent way. Useful for things like: tar cf - . | gzip -9 | fdwrite -d /dev/rfd0.1720 -v Where it will keep asking for floppies until tar is done.
1994-09-18 03:39:19 -04:00
Some of the code was taken from
.Xr fdformat 1 .
.Sh AUTHOR -> .Sh AUTHORS. Use .An/.Aq.
1998-03-23 03:31:20 -05:00
.Sh AUTHORS
A small program, which can take a file of any size, format, write and verify it onto a bunch of floppies in a semi-intelligent way. Useful for things like: tar cf - . | gzip -9 | fdwrite -d /dev/rfd0.1720 -v Where it will keep asking for floppies until tar is done.
1994-09-18 03:39:19 -04:00
The program has been contributed by
Modernize my email address.
2002-03-25 09:12:49 -05:00
.An Poul-Henning Kamp Aq phk@FreeBSD.org .
A small program, which can take a file of any size, format, write and verify it onto a bunch of floppies in a semi-intelligent way. Useful for things like: tar cf - . | gzip -9 | fdwrite -d /dev/rfd0.1720 -v Where it will keep asking for floppies until tar is done.
1994-09-18 03:39:19 -04:00
.Sh BUGS
Diagnostics are less than complete at present.
Avoid use of direct troff requests in mdoc(7) manual pages.
2000-11-10 12:46:15 -05:00
.Pp
A small program, which can take a file of any size, format, write and verify it onto a bunch of floppies in a semi-intelligent way. Useful for things like: tar cf - . | gzip -9 | fdwrite -d /dev/rfd0.1720 -v Where it will keep asking for floppies until tar is done.
1994-09-18 03:39:19 -04:00
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.
Avoid use of direct troff requests in mdoc(7) manual pages.
2000-11-10 12:46:15 -05:00
.Pp
A small program, which can take a file of any size, format, write and verify it onto a bunch of floppies in a semi-intelligent way. Useful for things like: tar cf - . | gzip -9 | fdwrite -d /dev/rfd0.1720 -v Where it will keep asking for floppies until tar is done.
1994-09-18 03:39:19 -04:00
This concept could be extended to cover non-seekable input also
Correct punctuation.
1998-06-21 00:33:36 -04:00
by employing a temporary file.
Avoid use of direct troff requests in mdoc(7) manual pages.
2000-11-10 12:46:15 -05:00
.Pp
A small program, which can take a file of any size, format, write and verify it onto a bunch of floppies in a semi-intelligent way. Useful for things like: tar cf - . | gzip -9 | fdwrite -d /dev/rfd0.1720 -v Where it will keep asking for floppies until tar is done.
1994-09-18 03:39:19 -04:00
An option (defaulting to zero) should allow the user to ask for
retries in case of failure.
Avoid use of direct troff requests in mdoc(7) manual pages.
2000-11-10 12:46:15 -05:00
.Pp
A small program, which can take a file of any size, format, write and verify it onto a bunch of floppies in a semi-intelligent way. Useful for things like: tar cf - . | gzip -9 | fdwrite -d /dev/rfd0.1720 -v Where it will keep asking for floppies until tar is done.
1994-09-18 03:39:19 -04:00
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
Correct punctuation.
1998-06-21 00:33:36 -04:00
to help out in this situation of course.
Reference in a new issue Copy permalink