fdio(7I)							  Ioctl Requests							  fdio(7I)

NAME

       fdio - floppy disk control operations

SYNOPSIS

       #include <sys/fdio.h>

DESCRIPTION

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

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 partition information to default values based on the device configuration.

       FDGETCHANGE     The  argument is a pointer to an int. This ioctl() returns the status of the diskette-changed signal from the floppy inter-
		       face. 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 */

       FDIOGCHAR       The argument is a pointer to an fd_char structure (described below). This ioctl() gets the characteristics  of  the  floppy
		       diskette from the floppy controller.

       FDIOSCHAR       The  argument  is  a pointer to an fd_char structure (described below). This ioctl() 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 */
       };

       FDGETDRIVECHAR	       The argument to this ioctl() is a pointer to an fd_drive structure (described below). This ioctl() gets the charac-
			       teristics of the floppy drive from the floppy controller.

       FDSETDRIVECHAR	       x86  based  systems:   The  argument  to this ioctl() is a pointer to an fd_drive structure (described below). This
			       ioctl() 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 */
       };

       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 structure (described below). This ioctl() 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
       };

       FDRAW	       The  argument  is  a  pointer to an fd_raw structure (described below).	  This ioctl() 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	 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 */
	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.10							   26 April 2001							  fdio(7I)