FDIO(7I) Ioctl Requests FDIO(7I)

fdio
floppy disk control operations

#include <sys/fdio.h>

The Solaris floppy driver supports a set of ioctl(2) requests for getting and setting the floppy drive characteristics. Basic to these ioctl(2) requests are the definitions in <sys/fdio.h>.

The following ioctl(2) requests are available on the Solaris floppy driver.
x86 based systems: This ioctl(2) forces the floppy driver to restore the diskette and drive characteristics and geometry, and partition information to default values based on the device configuration.
The argument is a pointer to an int. This ioctl(2) returns the status of the diskette-changed signal from the floppy interface. The following defines are provided for cohesion.

Note: For x86 based systems, use FDGC_DETECTED (which is available only on x86 based systems) instead of FDGC_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 */
The argument is a pointer to an fd_char structure (described below). This ioctl(2) gets the characteristics of the floppy diskette from the floppy controller.
The argument is a pointer to an fd_char structure (described below). This ioctl(2) sets the characteristics of the floppy diskette for the floppy controller. Typical values in the fd_char structure for a high density diskette:
Field Value
fdc_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 */
};
The argument to this ioctl(2) is a pointer to an fd_drive structure (described below). This ioctl(2) gets the characteristics of the floppy drive from the floppy controller.
x86 based systems: The argument to this ioctl(2) is a pointer to an fd_drive structure (described below). This ioctl(2) sets the characteristics of the floppy drive for the floppy controller. Only fdd_steprate, fdd_headsettle, fdd_motoron, and fdd_motoroff are actually used by the floppy disk driver.
/*
 * Floppy Drive characteristics
 */
struct fd_drive {
    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 */
};
Not available.
Not available.
SPARC: This ioctl(2) requests the floppy drive to eject the diskette.
The argument is a pointer to an fd_cmd structure (described below). This ioctl(2) allows access to the floppy diskette using the floppy 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.

/*
 * 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
The argument is a pointer to an fd_raw structure (described below). This ioctl(2) allows direct control of the floppy drive using the floppy controller. Refer to the appropriate floppy-controller data sheet for full details on required command bytes and returned result bytes. The following commands 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 DRAW_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 */
   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 */
};

ioctl(2), fd(7D), dkio(7I), hdio(7I)
October 22, 2017 illumos