From 11c870c266cf547f05fab3b4424c831c9eeaf151 Mon Sep 17 00:00:00 2001 From: downsj Date: Thu, 20 Jun 1996 08:22:45 +0000 Subject: add fdformat for the i386: based on an old FreeBSD version, gotten from jtk's port of dosemu; some cleaning by me, but it needs more. Should probably just be rewritten... --- usr.sbin/fdformat/fdformat.1 | 128 +++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 128 insertions(+) create mode 100644 usr.sbin/fdformat/fdformat.1 (limited to 'usr.sbin/fdformat/fdformat.1') diff --git a/usr.sbin/fdformat/fdformat.1 b/usr.sbin/fdformat/fdformat.1 new file mode 100644 index 00000000000..6050cf21154 --- /dev/null +++ b/usr.sbin/fdformat/fdformat.1 @@ -0,0 +1,128 @@ +.\" $OpenBSD: fdformat.1,v 1.1 1996/06/20 08:22:46 downsj Exp $ +.\" +.\" Copyright (C) 1993, 1994 by Joerg Wunsch, Dresden +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR(S) ``AS IS'' AND ANY EXPRESS +.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED +.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE +.\" DISCLAIMED. IN NO EVENT SHALL THE AUTHOR(S) BE LIABLE FOR ANY DIRECT, +.\" INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES +.\" (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR +.\" SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, +.\" STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING +.\" IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE +.\" POSSIBILITY OF SUCH DAMAGE. +.\" +.Dd September 16, 1993 +.Os OpenBSD +.Dt FDFORMAT 1 +.Sh NAME +.Nm fdformat +.Nd format floppy disks +.Sh SYNOPSIS +.Nm fdformat +.Bq Fl q +.Bq Fl v +.Bq Fl n +.Bq Fl c Ar cyls +.Bq Fl s Ar secs +.Bq Fl h Ar heads +.br +.Bq Fl r Ar rate +.Bq Fl g Ar gap3len +.Bq Fl i Ar intleave +.Bq Fl S Ar secshft +.Bq Fl F Ar fillbyte +.Bq Fl t Ar steps_per_track +.Ar device_name +.Sh DESCRIPTION +.Nm Fdformat +formats a floppy disk at device +.Ar device_name . +.Ar Device_name +should be a character device; it may be given either with a full path +name of a raw device node for a floppy disk drive +.Pq e.\ g. Pa /dev/rfd0 , +or default name in an abbreviated form +.Pq e.\ g. Em fd0 . +In the latter case, the name is constructed by prepending +.Pa /dev/r +to the +.Ar device_name . +Note that any geometry constraints of the device node +.Pq minor device number +are meaningless, since they're overridden by +.Nm fdformat . +.Pp +The options are as follows: +.Bl -tag -width 10n -offset indent +.It Fl q +supress any normal output from the command, and don't ask the +user for a confirmation whether to format the floppy disk at +.Ar device_name . +.It Fl n +Don't verify floppy after formatting. +.It Fl v +Don't format, verify only. +.It Fl c Ar cyls +.It Fl s Ar secs +.It Fl h Ar heads +.It Fl r Ar rate +.It Fl g Ar gap3len +.It Fl i Ar intleave +.It Fl S Ar secshft +.It Fl F Ar fillbyte +.It Fl t Ar steps_per_track +An alternate method to specify the geometry data to write to the floppy disk. +.El + +If the +.Fl q +flag has not been specified, the user is asked for a confirmation +of the intended formatting process. In order to continue, an answer +of +.Dq y +must be given. +.Sh DIAGNOSTICS +Unless +.Fl q +has been specified, a single letter is printed to standard output +to inform the user about the progress of work. +First, an +.Sq Em F +is printed when the track(s) is being formatted, then a +.Sq Em V +while it's being verified, and if an error has been detected, it +will finally change to +.Sq Em E . +.Pp +An exit status of 0 is returned upon successful operation. Exit status +1 is returned on any errors during floppy formatting, and an exit status +of 2 reflects invalid arguments given to the program (along with an +appropriate information written to diagnostic output). +.Sh SEE ALSO +.Xr fdc 4 . +.Sh HISTORY +.Nm Fdformat +has been developed for 386BSD 0.1 +and upgraded to the new +.Xr fd 4 +floppy disk driver. It later became part of the +.Em FreeBSD +system, release 1.1, and was then ported to NetBSD 1.0. +.Sh AUTHOR +The program has been contributed by +.if n Joerg Wunsch, +.if t J\(:org Wunsch, +Dresden, with changes by Serge Vakulenko and Andrew A. Chernov, Moscow. -- cgit v1.2.3-59-g8ed1b