xref: /freebsd/usr.sbin/fdcontrol/fdcontrol.8 (revision f247324df75b7f55b48b92acb3b42a5ae2deac8a)
1.\"
2.\" Copyright (C) 1994 by Joerg Wunsch, Dresden
3.\" All rights reserved.
4.\"
5.\" Redistribution and use in source and binary forms, with or without
6.\" modification, are permitted provided that the following conditions
7.\" are met:
8.\" 1. Redistributions of source code must retain the above copyright
9.\"    notice, this list of conditions and the following disclaimer.
10.\" 2. Redistributions in binary form must reproduce the above copyright
11.\"    notice, this list of conditions and the following disclaimer in the
12.\"    documentation and/or other materials provided with the distribution.
13.\"
14.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR(S) ``AS IS'' AND ANY
15.\" EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
16.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
17.\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR(S) BE LIABLE
18.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
19.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
20.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
21.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
22.\" LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
23.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
24.\" USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
25.\" DAMAGE.
26.\"
27.\" $FreeBSD$
28.\"
29.Dd May 22, 1994
30.Os
31.Dt FDCONTROL 8
32.Sh NAME
33.Nm fdcontrol
34.Nd modify floppy disk parameters
35.Sh SYNOPSIS
36.Nm
37.Op Fl d Ar 0|1
38.Ar device
39.Nm
40.Op Fl s
41.Ar device
42.Sh DESCRIPTION
43.Nm Fdcontrol
44allows the modification of the run-time behavior of the floppy
45disk device specified by
46.Ar device .
47.Ar Device
48should be a character device.
49.Pp
50.Nm Fdcontrol
51currently supports the specification of device parameters for the
52floppy disk drive
53.Po
54.Fl s ,
55also default mode
56.Pc ,
57or it allows the modification of the driver debug level, in case the
58floppy driver has been compiled into the kernel with the
59.Em DEBUG
60option set
61.Pq Fl d .
62.Pp
63Since the implications of such actions are considered harmful, the
64underlying
65.Xr ioctl 2
66command is restricted to the super-user.
67.Pp
68When requesting a new parameter specification, the command asks the
69user for each individual tunable parameter, defaulting to the
70currently used value.
71.Sh DIAGNOSTICS
72Error codes for the underlying
73.Xr ioctl 2
74commands are printed by the
75.Xr warn 3
76facility.
77.Sh BUGS
78The
79.Nm
80command is currently under development.
81It's user interface is rather
82silly and likely to change in future, options should be provided to
83allow anything being modified from the command line.
84.Pp
85The driver does actually support only two debug levels
86.Pq 0 and 1 ,
87where debug level 1 will generate huge amounts of output.
88It is likely
89to overflow the syslog if not used with extreme care.
90.Sh SEE ALSO
91.Xr ioctl 2 ,
92.Xr warn 3 ,
93.Xr fdc 4
94.Sh HISTORY
95.Nm Fdcontrol
96is currently under development.
97It's user interface and overall
98functionality are subjects to future improvements and changes.
99.Sh AUTHORS
100The program has been contributed by
101.An J\(:org Wunsch ,
102Dresden.
103