The argument is a pointer to a dk_cinfo structure (described below). This structure tells the controller-type and attributes regarding bad-block processing done on the controller.

The argument is a pointer to a dk_allmap structure (described below). This ioctl() gets the controller's notion of the current partition table for disk drive.

The argument is a pointer to a dk_allmap structure (described below). This ioctl() sets the controller's notion of the partition table without changing the disk itself.

The argument is a pointer to a dk_geom structure (described below). This ioctl() gets the controller's notion of the current geometry of the disk drive.

The argument is a pointer to a dk_geom structure (described below). This ioctl() sets the controller's notion of the geometry without changing the disk itself.

The argument is a pointer to a vtoc structure (described below). This ioctl() returns the device's current volume table of contents (VTOC.) For disks larger than 1TB, DKIOCGEXTVTOC must be used instead.

The argument is a pointer to a vtoc structure (described below). This ioctl() changes the VTOC associated with the device. For disks larger than 1TB, DKIOCSEXTVTOC must be used instead.

The argument is a pointer to an extvtoc structure (described below). This ioctl returns the device's current volume table of contents (VTOC). VTOC is extended to support a disk up to 2TB in size. For disks larger than 1TB this ioctl must be used instead of DKIOCGVTOC.

The argument is a pointer to an extvtoc structure (described below). This ioctl changes the VTOC associated with the device. VTOC is extended to support a disk up to 2TB in size. For disks larger than 1TB this ioctl must be used instead of DKIOCSVTOC.

struct extpartition {
ushort_t p_tag; /* ID tag of partition */
ushort_t p_flag; /* permission flags */
ushort_t p_pad[2]; /* reserved */
diskaddr_t p_start; /* start sector no of partition */
diskaddr_t p_size; /* # of blocks in partition */
};


struct extvtoc {
uint64_t v_bootinfo[3]; /* info needed by mboot (unsupported) */
uint64_t v_sanity; /* to verify vtoc sanity */
uint64_t v_version; /* layout version */
char v_volume[LEN_DKL_VVOL]; /* volume name */
ushort_t v_sectorsz; /* sector size in bytes */
ushort_t v_nparts; /* number of partitions */
ushort_t pad[2];
uint64_t v_reserved[10];
struct extpartition v_part[V_NUMPAR]; /* partition headers */
uint64_t timestamp[V_NUMPAR]; /* partition timestamp (unsupported)*/
char v_asciilabel[LEN_DKL_ASCII]; /* for compatibility */
};

Partition permissions flags and identification tags
are defined the same as vtoc structure.

If the drive supports removable media, this ioctl() requests the disk drive to eject its disk.

The argument to this ioctl() is an integer. After successful completion, this ioctl() sets that integer to a non-zero value if the drive in question has removable media. If the media is not removable, the integer is set to 0.

The argument to this ioctl() is an integer. After successful completion, this ioctl() sets that integer to a non-zero value if the drive in question is hotpluggable. If the media is not hotpluggable, the integer is set to 0.

This ioctl() blocks until the state of the drive, inserted or ejected, is changed. The argument is a pointer to a dkio_state, enum, whose possible enumerations are listed below. The initial value should be either the last reported state of the drive, or DKIO_NONE. Upon return, the enum pointed to by the argument is updated with the current state of the drive.

enum dkio_state {
DKIO_NONE, /* Return disk's current state */
DKIO_EJECTED, /* Disk state is 'ejected' */
DKIO_INSERTED /* Disk state is 'inserted' */
};

For devices with removable media, this ioctl() requests the disk drive to lock the door.

For devices with removable media, this ioctl() requests the disk drive to unlock the door.

The argument to this ioctl() is a pointer to a dk_minfo structure. The structure indicates the type of media or the command set profile used by the drive to operate on the media. The dk_minfo structure also indicates the logical media block size the drive uses as the basic unit block size of operation and the raw formatted capacity of the media in number of logical blocks.

The argument to this ioctl() is a pointer to a dk_minfo_ext structure. The structure indicates the type of media or the command set profile used by the drive to operate on the media. The dk_minfo_ext structure also indicates the logical media block size the drive uses as the basic unit block size of operation, the raw formatted capacity of the media in number of logical blocks and the physical block size of the media.

The argument is a pointer to struct mboot. Copies the mboot information supplied in the argument to the absolute sector 0 of the device. Prior to copying the information, this ioctl() performs the following checks on the mboot data:

This ioctl provides information and status of available capabilities. vc_info is a bitmap and the valid flag values are:

DKV_ABR_CAP - Capable of application-based recovery
DKV_DMR_CAP - Ability to read specific copy of data when
 multiple copies exist. For example, in a two
 way mirror, this ioctl is used to read each
 side of the mirror.

DKV_ABR_CAP - This flag is set if ABR has been set on a device
 that supports ABR functionality.
DKV_DMR_CAP - Directed read has been enabled.

This ioctl sets the available capabilities for the device. If a capability flag is not set in vc_set, that capability is cleared. vc_info flags are ignored vc_set valid flags are:

DKV_ABR_CAP - Flag to set application-based recovery. A device can
 successfully support ABR only if it is capable.
DKV_DMR_CAP - Flag to set directed read.


int
ioctl(int , DKIODMR, vol_directed_rd *);

This ioctl allows highly available applications to perform round-robin reads from the underlying devices of a replicated device.

vdr_offset - offset at which the read should occur.
vdr_nbytes - number of bytes to be read
vdr_bytesread - number of bytes successfully read by the kernel.
vdr_data - pointer to a user allocated buffer to return the
 data read
vdr_side - side to be read. Initialized to DKV_SIDE_INIT
vdr_side_name - The volume name that has been read.

Valid vdr_flags are:
 DKV_DMR_NEXT_SIDE (set by user)
 DKV_DMR_DONE (return value)
 DKV_DMR_ERROR (return value)
 DKV_DMR_SUCCESS(return value)
 DKV_DMR_SHORT(return value)

vdr_flags | vdr_side | Notes
-------------|-------------------|----------------------------
DKV_DMR_ERROR| DKV_SIDE_INIT | No valid side to read
DKV_DMR_DONE | Not Init side | All valid sides read
DKV_DMR_SHORT| Any value | Bytes requested cannot
 be read. vdr_bytesread
 set to bytes actually
 read.

Typical code fragment:

enable->vc_set |= DKV_ABR_SET;
retval = ioctl(filedes, DKIOSETVOLCAP, enable);
if (retval != EINVAL || retval != ENOTSUP) {
 if (info->vc_set & DKV_DMR_SET) {
 dr->vdr_flags |= DKV_DMR_NEXT_SIDE;
 dr->vdr_side = DKV_SIDE_INIT;
 dr->vdr_nbytes = 1024;
 dr->vdr_offset = 0xff00;
 do {
 rval =ioctl(fildes, DKIODMR, dr);
 if (rval != EINVAL) {
 /* Process data */
 }
 } while (rval != EINVAL || dr->vdr_flags &
 (DKV_DMR_DONE | DKV_DMR_ERROR | DKV_DMR_SHORT)
 }
}

The argument is a pointer to a dk_geom structure (described below). This ioctl() gets the driver's notion of the physical geometry of the disk drive. It is functionally identical to the DKIOCGGEOM ioctl().

The argument is a pointer to a dk_geom structure (described below). This ioctl() gets the controller's (and hence the driver's) notion of the virtual geometry of the disk drive. Virtual geometry is a view of the disk geometry maintained by the firmware in a host bus adapter or disk controller. If the disk is larger than 8 Gbytes, this ioctl fails because a CHS-based geometry is not relevant or useful for this drive.

This ioctl() forces the driver to re-examine the alternates slice and rebuild the internal bad block map accordingly. It should be used whenever the alternates slice is changed by any method other than the addbadsec(1M) or format(1M) utilities. DKIOCADDBAD can only be used for software remapping on IDE drives; SCSI drives use hardware remapping of alternate sectors.

The argument is a pointer to a part_info structure (described below). This ioctl() gets the driver's notion of the size and extent of the partition or slice indicated by the file descriptor argument.

/*
 * Used by applications to get partition or slice information
 */
struct part_info {
daddr_t p_start;
int p_length;
 };

The argument is a pointer to an extpart_info structure (described below). This ioctl gets the driver's notion of the size and extent of the partition or slice indicated by the file descriptor argument. On disks larger than 1TB, this ioctl must be used instead of DKIOCPARTINFO.

/*
* Used by applications to get partition or slice information
*/
struct extpart_info {
diskkaddr_t p_start;
diskaddr_t p_length;
};

This ioctl is used to update the in-memory copy of the logical drive information maintained by the driver. The ioctl takes no arguments. It causes a re-read of the partition information and recreation of minor nodes if required. Prior to updating the data structures, the ioctl ensures that the partitions do not overlap. Device nodes are created only for valid partition entries. If there is any change in the partition offset, size or ID from the previous read, the partition is deemed to have been changed and hence the device nodes are recreated. Any modification to any of the logical partitions results in the recreation of all logical device nodes.