Print this page
10519 Convert fdio(7I) to mandoc

@@ -1,78 +1,67 @@
 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>.
+     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>.
 
 IOCTLS
-       The following ioctl() requests are available on the Solaris floppy
+     The following ioctl(2) 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.
+     FDDEFGEOCHAR  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.
 
+     FDGETCHANGE   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.
 
-       FDGETCHANGE
-                       The argument is a pointer to an int. This ioctl()
-                       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_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(2) gets the characteristics of the floppy
+                diskette from the floppy controller.
 
-       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(2) sets the characteristics of the floppy
+                diskette for the floppy controller.  Typical values in the
+                fd_char structure for a high density diskette:
 
-
-       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
+                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 */

@@ -82,27 +71,22 @@
           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(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.
 
-       FDGETDRIVECHAR
-                         The argument to this ioctl() is a pointer to an
-                         fd_drive structure (described below). This ioctl()
-                         gets the characteristics 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,
+     FDSETDRIVECHAR  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? */

@@ -119,69 +103,52 @@
               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.
 
-       FDGETSEARCH
-                      Not available.
+     FDSETSEARCH  Not available.
 
+     FDEJECT      SPARC:  This ioctl(2) requests the floppy drive to eject the
+                  diskette.
 
-       FDSETSEARCH
-                      Not available.
+     FDIOCMD      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.
 
-
-       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.
 
-
-       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(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.
 
-       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)

@@ -194,18 +161,15 @@
          #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.
+     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 {

@@ -214,12 +178,9 @@
           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)
+     ioctl(2), fd(7D), dkio(7I), hdio(7I)
 
-
-
-                                April 26, 2001                        FDIO(7I)
+illumos                        October 22, 2017                        illumos