102 lines
3.0 KiB
Groff
102 lines
3.0 KiB
Groff
|
.\"
|
||
|
.\" Copyright (C) 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 May 22, 1994
|
||
|
.Os
|
||
|
.Dt FDCONTROL 8
|
||
|
.Sh NAME
|
||
|
.Nm fdcontrol
|
||
|
.Nd modify floppy disk parameters
|
||
|
.Sh SYNOPSIS
|
||
|
.Nm fdcontrol
|
||
|
.Op Fl d Ar 0|1
|
||
|
.Ar device
|
||
|
.Nm fdcontrol
|
||
|
.Op Fl s
|
||
|
.Ar device
|
||
|
.Sh DESCRIPTION
|
||
|
.Nm Fdcontrol
|
||
|
allows the modification of the run-time behaviour of the floppy
|
||
|
disk device specifed by
|
||
|
.Ar device .
|
||
|
.Ar Device
|
||
|
should be a character device.
|
||
|
|
||
|
.Nm Fdcontrol
|
||
|
currently supports the specification of device parameters for the
|
||
|
floppy disk drive
|
||
|
.Po
|
||
|
.Fl s ,
|
||
|
also default mode
|
||
|
.Pc ,
|
||
|
or it allows the modification of the driver debug level, in case the
|
||
|
floppy driver has been compiled into the kernel with the
|
||
|
.Em DEBUG
|
||
|
option set
|
||
|
.Pq Fl d .
|
||
|
|
||
|
Since the implications of such actions are considered harmful, the
|
||
|
underlying
|
||
|
.Xr ioctl 2
|
||
|
command is restricted to the super-user.
|
||
|
|
||
|
When requesting a new parameter specification, the command asks the
|
||
|
user for each individual tunable parameter, defaulting to the
|
||
|
currently used value.
|
||
|
|
||
|
.Sh DIAGNOSTICS
|
||
|
Error codes for the underlying
|
||
|
.Xr ioctl 2
|
||
|
commands are printed by the
|
||
|
.Xr perror 3
|
||
|
facility.
|
||
|
|
||
|
.Sh BUGS
|
||
|
The
|
||
|
.Nm
|
||
|
command is currently under development. It's user interface is rather
|
||
|
silly and likely to change in future, options should be provided to
|
||
|
allow anything being modified from the command line.
|
||
|
|
||
|
The driver does actually support only two debug levels
|
||
|
.Pq 0 and 1 ,
|
||
|
where debug level 1 will generate huge amounts of output. It is likely
|
||
|
to overflow the syslog if not used with extreme care.
|
||
|
|
||
|
.Sh SEE ALSO
|
||
|
.Xr fdc 4 ,
|
||
|
.Xr ioctl 2 ,
|
||
|
.Xr perror 3 .
|
||
|
.Sh HISTORY
|
||
|
.Nm Fdcontrol
|
||
|
is currently under development. It's user interface and overall
|
||
|
functionality are subjects to future improvements and changes.
|
||
|
.Sh AUTHOR
|
||
|
The program has been contributed by
|
||
|
.if n Joerg Wunsch,
|
||
|
.if t J\(:org Wunsch,
|
||
|
Dresden.
|