1.\" Copyright (C) 1993, 1994, 1995, 2001 by Joerg Wunsch, Dresden
2.\" All rights reserved.
3.\"
4.\" Redistribution and use in source and binary forms, with or without
5.\" modification, are permitted provided that the following conditions
6.\" are met:
7.\" 1. Redistributions of source code must retain the above copyright
8.\" notice, this list of conditions and the following disclaimer.
9.\" 2. Redistributions in binary form must reproduce the above copyright
10.\" notice, this list of conditions and the following disclaimer in the
11.\" documentation and/or other materials provided with the distribution.
12.\"
13.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR(S) ``AS IS'' AND ANY EXPRESS
14.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
15.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
16.\" DISCLAIMED. IN NO EVENT SHALL THE AUTHOR(S) BE LIABLE FOR ANY DIRECT,
17.\" INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
18.\" (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
19.\" SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
20.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
21.\" STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
22.\" IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
23.\" POSSIBILITY OF SUCH DAMAGE.
24.\"
| 1.\" Copyright (C) 1993, 1994, 1995, 2001 by Joerg Wunsch, Dresden
2.\" All rights reserved.
3.\"
4.\" Redistribution and use in source and binary forms, with or without
5.\" modification, are permitted provided that the following conditions
6.\" are met:
7.\" 1. Redistributions of source code must retain the above copyright
8.\" notice, this list of conditions and the following disclaimer.
9.\" 2. Redistributions in binary form must reproduce the above copyright
10.\" notice, this list of conditions and the following disclaimer in the
11.\" documentation and/or other materials provided with the distribution.
12.\"
13.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR(S) ``AS IS'' AND ANY EXPRESS
14.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
15.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
16.\" DISCLAIMED. IN NO EVENT SHALL THE AUTHOR(S) BE LIABLE FOR ANY DIRECT,
17.\" INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
18.\" (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
19.\" SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
20.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
21.\" STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
22.\" IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
23.\" POSSIBILITY OF SUCH DAMAGE.
24.\"
|
25.\" $FreeBSD: head/usr.sbin/fdformat/fdformat.1 81251 2001-08-07 15:48:51Z ru $
| 25.\" $FreeBSD: head/usr.sbin/fdformat/fdformat.1 81622 2001-08-14 10:01:54Z ru $
|
26.\"
27.Dd July 2, 2001
28.Os
29.Dt FDFORMAT 1
30.Sh NAME
31.Nm fdformat
32.Nd format floppy disks
33.Sh SYNOPSIS
34.Nm
35.Op Fl q
36.Op Fl y
37.Op Fl v | Fl n
38.Op Fl f Ar capacity
39.Op Fl c Ar cyls
40.Op Fl s Ar secs
41.Op Fl h Ar heads
42.Nm
43.Op Fl r Ar rate
44.Op Fl g Ar gap3len
45.Op Fl i Ar intleave
46.Op Fl S Ar secshft
47.Op Fl F Ar fillbyte
48.Op Fl t Ar steps_per_track
49.Ar device_name
50.Sh DESCRIPTION
51.Nm Fdformat
52formats a floppy disk at device
53.Ar device_name .
54.Ar Device_name
55may be given either with a full path
56name of a device node for a floppy disk drive
57(e.g.\&
58.Pa /dev/fd0 ) ,
59or a default name in an abbreviated form
60(e.g.\&
61.Em fd0 ) .
62In the latter case, the name is constructed by prepending
63.Pa /dev/
64and appending a
65.Em .capacity
66to the
67.Ar device_name .
68Note that any geometry constraints of the device node
69(minor device number)
70are meaningless, since they're overridden by
71.Nm .
72.Pp
73The options are as follows:
74.Bl -tag -width 10n -offset indent
75.It Fl q
76Suppress any normal output from the command, and don't ask the
77user for a confirmation whether to format the floppy disk at
78.Ar device_name .
79.It Fl y
80Suppress confirmation request by automagically responding "yes", but still
81report format status.
82.It Fl f Ar capacity
83The normal way to specify the desired formatting parameters.
84.Ar Capacity
85is the number of kilobytes to format.
86Valid choices are 360, 720, 800, 820,
871200, 1440, 1480 or 1720.
88.It Fl n
89Don't verify floppy after formatting.
90.It Fl v
91Don't format, verify only.
92.It Fl c Ar cyls
93Number of cylinders: 40 or 80.
94.It Fl s Ar secs
95Number of sectors per track: 9, 10, 15 or 18.
96.It Fl h Ar heads
97Number of floppy heads: 1 or 2.
98.It Fl r Ar rate
99Data rate: 250, 300 or 500 kbps.
100.It Fl g Ar gap3len
101Gap length.
102.It Fl i Ar intleave
103Interleave factor.
104.It Fl S Ar secshft
105Sector size: 0=128, 1=256, 2=512 bytes.
106.It Fl F Ar fillbyte
107Fill byte.
108.It Fl t Ar steps_per_track
109Number of steps per track.
110An alternate method to specify the geometry data to write to the floppy disk.
111.El
112.Pp
113If the
114.Fl q
115flag has not been specified, the user is asked for a confirmation
116of the intended formatting process.
117In order to continue, an answer
118of
119.Dq y
120must be given.
121.Pp
122Note that
123.Nm
124does only perform low-level formatting. In case you wish to create
125a file system on the medium, see the commands
126.Xr newfs 8
127for an
128.Em ufs
129file system, or
130.Xr newfs_msdos 8
131for an
132.Em MS-DOS (FAT)
133file system.
134.Sh DIAGNOSTICS
135Unless
136.Fl q
137has been specified, a single letter is printed to standard output
138to inform the user about the progress of work.
139First, an
140.Sq Em F
141is printed when the track(s) is being formatted, then a
142.Sq Em V
143while it's being verified, and if an error has been detected, it
144will finally change to
145.Sq Em E .
146Detailed status information (cylinder, head and sector number, and the
147exact cause of the error) will then be printed for up to 10 errors.
148.Pp
149An exit status of 0 is returned upon successful operation.
150Exit status
1511 is returned on any errors during floppy formatting, and an exit status
152of 2 reflects invalid arguments given to the program (along with an
153appropriate information written to diagnostic output).
154.Sh SEE ALSO
155.Xr fdc 4 ,
156.Xr newfs 8 ,
157.Xr newfs_msdos 8
158.Sh HISTORY
159.Nm Fdformat
| 26.\"
27.Dd July 2, 2001
28.Os
29.Dt FDFORMAT 1
30.Sh NAME
31.Nm fdformat
32.Nd format floppy disks
33.Sh SYNOPSIS
34.Nm
35.Op Fl q
36.Op Fl y
37.Op Fl v | Fl n
38.Op Fl f Ar capacity
39.Op Fl c Ar cyls
40.Op Fl s Ar secs
41.Op Fl h Ar heads
42.Nm
43.Op Fl r Ar rate
44.Op Fl g Ar gap3len
45.Op Fl i Ar intleave
46.Op Fl S Ar secshft
47.Op Fl F Ar fillbyte
48.Op Fl t Ar steps_per_track
49.Ar device_name
50.Sh DESCRIPTION
51.Nm Fdformat
52formats a floppy disk at device
53.Ar device_name .
54.Ar Device_name
55may be given either with a full path
56name of a device node for a floppy disk drive
57(e.g.\&
58.Pa /dev/fd0 ) ,
59or a default name in an abbreviated form
60(e.g.\&
61.Em fd0 ) .
62In the latter case, the name is constructed by prepending
63.Pa /dev/
64and appending a
65.Em .capacity
66to the
67.Ar device_name .
68Note that any geometry constraints of the device node
69(minor device number)
70are meaningless, since they're overridden by
71.Nm .
72.Pp
73The options are as follows:
74.Bl -tag -width 10n -offset indent
75.It Fl q
76Suppress any normal output from the command, and don't ask the
77user for a confirmation whether to format the floppy disk at
78.Ar device_name .
79.It Fl y
80Suppress confirmation request by automagically responding "yes", but still
81report format status.
82.It Fl f Ar capacity
83The normal way to specify the desired formatting parameters.
84.Ar Capacity
85is the number of kilobytes to format.
86Valid choices are 360, 720, 800, 820,
871200, 1440, 1480 or 1720.
88.It Fl n
89Don't verify floppy after formatting.
90.It Fl v
91Don't format, verify only.
92.It Fl c Ar cyls
93Number of cylinders: 40 or 80.
94.It Fl s Ar secs
95Number of sectors per track: 9, 10, 15 or 18.
96.It Fl h Ar heads
97Number of floppy heads: 1 or 2.
98.It Fl r Ar rate
99Data rate: 250, 300 or 500 kbps.
100.It Fl g Ar gap3len
101Gap length.
102.It Fl i Ar intleave
103Interleave factor.
104.It Fl S Ar secshft
105Sector size: 0=128, 1=256, 2=512 bytes.
106.It Fl F Ar fillbyte
107Fill byte.
108.It Fl t Ar steps_per_track
109Number of steps per track.
110An alternate method to specify the geometry data to write to the floppy disk.
111.El
112.Pp
113If the
114.Fl q
115flag has not been specified, the user is asked for a confirmation
116of the intended formatting process.
117In order to continue, an answer
118of
119.Dq y
120must be given.
121.Pp
122Note that
123.Nm
124does only perform low-level formatting. In case you wish to create
125a file system on the medium, see the commands
126.Xr newfs 8
127for an
128.Em ufs
129file system, or
130.Xr newfs_msdos 8
131for an
132.Em MS-DOS (FAT)
133file system.
134.Sh DIAGNOSTICS
135Unless
136.Fl q
137has been specified, a single letter is printed to standard output
138to inform the user about the progress of work.
139First, an
140.Sq Em F
141is printed when the track(s) is being formatted, then a
142.Sq Em V
143while it's being verified, and if an error has been detected, it
144will finally change to
145.Sq Em E .
146Detailed status information (cylinder, head and sector number, and the
147exact cause of the error) will then be printed for up to 10 errors.
148.Pp
149An exit status of 0 is returned upon successful operation.
150Exit status
1511 is returned on any errors during floppy formatting, and an exit status
152of 2 reflects invalid arguments given to the program (along with an
153appropriate information written to diagnostic output).
154.Sh SEE ALSO
155.Xr fdc 4 ,
156.Xr newfs 8 ,
157.Xr newfs_msdos 8
158.Sh HISTORY
159.Nm Fdformat
|
160has been developed for 386BSD 0.1
| 160has been developed for
161.Bx 386 0.1
|
161and upgraded to the new
162.Xr fdc 4
163floppy disk driver.
164It later became part of the
165.Fx 1.1
166system.
167.Sh AUTHORS
168.An -nosplit
169The program has been contributed by
170.An J\(:org Wunsch ,
171Dresden, with changes by
172.An Serge Vakulenko
173and
174.An Andrey A. Chernov ,
175Moscow.
| 162and upgraded to the new
163.Xr fdc 4
164floppy disk driver.
165It later became part of the
166.Fx 1.1
167system.
168.Sh AUTHORS
169.An -nosplit
170The program has been contributed by
171.An J\(:org Wunsch ,
172Dresden, with changes by
173.An Serge Vakulenko
174and
175.An Andrey A. Chernov ,
176Moscow.
|