Ioctl Requests fdio(7I)
NAME
fdio - floppy disk control operations
SYNOPSIS
#include
DESCRIPTION
The Solaris floppy driver supports a set of ioctl(2)requests for getting and setting the floppy drive charac-
teristics. Basic to these ioctl() requests are the defini-
tions in
IOCTLS The following ioctl() requests are available on the Solaris floppy driver. FDDEFGEOCHAR x86 based systems: This ioctl() forces the floppy driver to restore the diskette and. drive characteristics and geometry, and par-
tition information to default values based on the device configuration. FDGETCHANGE The argument is a pointer to an int. Thisioctl() returns the status of the diskette-
changed signal from the floppy interface.The following defines are provided for cohe-
sion.Note: For x86 based systems, use FDGC_DETECTED (which is
available only on x86 based systems) instead ofFDGC_HISTORY.
/* * Used by FDGETCHANGE, returned state of the sense disk change bit. */#define FDGC_HISTORY 0x01 /* disk has changed since insertion or
last FDGETCHANGE call */#define FDGC_CURRENT 0x02 /* if set, indicates drive has floppy,
> otherwise, drive is empty */#define FDGC_CURWPROT 0x10 /* current state of write protect */
#define FDGC_DETECTED 0x20 /* previous state of DISK CHANGE */
FDIOGCHAR The argument is a pointer to an fd_char struc-
ture (described below). This ioctl() gets the characteristics of the floppy diskette from the floppy controller.SunOS 5.11 Last change: 26 April 2001 1
Ioctl Requests fdio(7I)
FDIOSCHAR The argument is a pointer to an fd_char struc-
ture (described below). This ioctl() sets the characteristics of the floppy diskette for the floppy controller. Typical values in thefd_char structure for a high density diskette:
field valuefdc_medium 0
fdc_transfer_rate 500
fdc_ncyl 80
fdc_nhead 2
fdc_sec_size 512
fdc_secptrack 18
fdc_steps -1 { This field doesn't apply. }
/* * Floppy characteristics */struct fd_char {
uchar_t fdc_medium; /* equals 1 if floppy is medium density format */
int fdc_transfer_rate; /* transfer rate */
int fdc_ncyl; /* number of cylinders */
int fdc_nhead; /* number of heads */
int fdc_sec_size; /* sector size */
int fdc_secptrack; /* sectors per track */
int fdc_steps; /* no. of steps per data track */
}; FDGETDRIVECHAR The argument to this ioctl() is a pointerto an fd_drive structure (described
below). This ioctl() gets the characteris-
tics of the floppy drive from the floppy controller. FDSETDRIVECHAR x86 based systems: The argument to thisioctl() is a pointer to an fd_drive struc-
ture (described below). This ioctl() sets the characteristics of the floppy drive for the floppy controller. Onlyfdd_steprate, fdd_headsettle, fdd_motoron,
and fdd_motoroff are actually used by the
floppy disk driver. /* * Floppy Drive characteristics */struct fd_drive {
SunOS 5.11 Last change: 26 April 2001 2
Ioctl Requests fdio(7I)
int fdd_ejectable; /* does the drive support eject? */
int fdd_maxsearch; /* size of per-unit search table */
int fdd_writeprecomp; /* cyl to start write precompensation */
int fdd_writereduce; /* cyl to start recucing write current */
int fdd_stepwidth; /* width of step pulse in 1 us units */
int fdd_steprate; /* step rate in 100 us units */
int fdd_headsettle; /* delay, in 100 us units */
int fdd_headload; /* delay, in 100 us units */
int fdd_headunload; /* delay, in 100 us units */
int fdd_motoron; /* delay, in 100 ms units */
int fdd_motoroff; /* delay, in 100 ms units */
int fdd_precomplevel; /* bit shift, in nano-secs */
int fdd_pins; /* defines meaning of pin 1, 2, 4 and 34 */
int fdd_flags; /* TRUE READY, Starting Sector #, & Motor On */
}; FDGETSEARCH Not available. FDSETSEARCH Not available. FDEJECT SPARC: This ioctl() requests the floppy drive to eject the diskette.FDIOCMD The argument is a pointer to an fd_cmd struc-
ture (described below). This ioctl() allows access to the floppy diskette using thefloppy device driver. Only the FDCMD_WRITE,
FDCMD_READ, and FDCMD_FORMAT_TRACK commands
are currently available.struct fd_cmd {
ushort_t fdc_cmd; /* command to be executed */
int fdc_flags; /* execution flags (x86 only) */
daddr_t fdc_blkno; /* disk address for command */
int fdc_secnt; /* sector count for command */
caddr_t fdc_bufaddr; /* user's buffer address */
uint_t fdc_buflen; /* size of user's buffer */
};Please note that the fdc_buflen field is currently unused.
The fdc_secnt field is used to calculate the transfer size,
and the buffer is assumed to be large enough to accommodate the transfer. {SunOS 5.11 Last change: 26 April 2001 3
Ioctl Requests fdio(7I)
/* * Floppy commands */#define FDCMD_WRITE 1
#define FDCMD_READ 2
#define FDCMD_SEEK 3
#define FDCMD_REZERO 4
#define FDCMD_FORMAT_UNIT 5
#define FDCMD_FORMAT_TRACK 6
};FDRAW The argument is a pointer to an fd_raw structure
(described below). This ioctl() allows directcontrol of the floppy drive using the floppy con-
troller. Refer to the appropriate floppy-controller
data sheet for full details on required commandbytes and returned result bytes. The following com-
mands are supported. /* * Floppy raw commands */#define FDRAW_SPECIFY 0x03
#define FDRAW_READID 0x0a (x86 only)
#define FDRAW_SENSE_DRV 0x04
#define FDRAW_REZERO 0x07
#define FDRAW_SEEK 0x0f
#define FDRAW_SENSE_INT 0x08 (x86 only)
#define FDRAW_FORMAT 0x0d
#define FDRAW_READTRACK 0x02
#define FDRAW_WRCMD 0x05
#define FDRAW_RDCMD 0x06
#define FDRAW_WRITEDEL 0x09
#define FDRAW_READDEL 0x0c
Please note that when using FDRAW_SEEK or FDRAW_REZERO,
the driver automatically issues a FDRAW_SENSE_INT command
to clear the interrupt from the FDRAW_SEEK or the
FDRAW_REZERO. The result bytes returned by these commands
are the results from the FDRAW_SENSE_INT command. Please
see the floppy-controller data sheet for more details on
FDRAW_SENSE_INT.
/* * Used by FDRAW */struct fd_raw {
char fdr_cmd[10]; /* user-supplied command bytes */
SunOS 5.11 Last change: 26 April 2001 4
Ioctl Requests fdio(7I)
short fdr_cnum; /* number of command bytes */
char fdr_result[10]; /* controller-supplied result bytes */
ushort_t fdr_nbytes; /* number to transfer if read/write command */
char *fdr_addr; /* where to transfer if read/write command */
};SEE ALSO
ioctl(2), dkio(7I), fd(7D), hdio(7I)SunOS 5.11 Last change: 26 April 2001 5