userspace-api/ioctl/hdio.rst

5 - Edward A. Falk <efalk@google.com>
10 the HD/IDE layer.  These are by-and-large implemented (as of Linux 2.6)
22 	HDIO_GET_QDMA		get use-qdma flag
25 	HDIO_GET_KEEPSETTINGS	get keep-settings-on-reset flag
27 	HDIO_GET_NOWERR		get ignore-write-error flag
28 	HDIO_GET_DMA		get use-dma flag
31 	HDIO_GET_WCACHE		get write cache mode on|off
33 	HDIO_GET_ADDRESS	get sector addressing mode
43     ioctls that pass non-pointer values:
50 	HDIO_SET_NOWERR		change ignore-write-error flag
51 	HDIO_SET_DMA		change use-dma flag
56 	HDIO_SET_WCACHE		change write cache enable-disable
59 	HDIO_SET_QDMA		change use-qdma flag
62 	HDIO_SET_IDE_SCSI	Set scsi emulation mode on/off
70 ------------------------------------------------------------------------------
75 	and -1 with errno set to an appropriate value on error.
77 	Unless otherwise specified, all ioctl calls return -1 and set
84 ------------------------------------------------------------------------------
115 	  - EINVAL
127 		are the "bios" values -- presumably the values the drive had
174 		New value for unmask flag
184 	  - EINVAL	Called on a partition instead of the whole disk device
185 	  - EACCES	Access denied:  requires CAP_SYS_ADMIN
186 	  - EINVAL	value out of range [0 1]
187 	  - EBUSY	Controller busy
208 		The value of the current IDE block mode setting.  This
225 		New value for IDE block mode setting.  This controls how many
234 	  - EINVAL	Called on a partition instead of the whole disk device
235 	  - EACCES	Access denied:  requires CAP_SYS_ADMIN
236 	  - EINVAL	value out of range supported by disk.
237 	  - EBUSY	Controller busy or blockmode already set.
238 	  - EIO		Drive did not accept new block mode.
243 	    This is tightly woven into the driver->do_special cannot
248 	  -EBUSY
253 	get use-qdma flag
298 	  - EINVAL	Called on a partition instead of the whole disk device
299 	  - ENOMSG	IDENTIFY DEVICE information not available
304 		this ioctl does not re-probe the drive to update the
312 	get keep-settings-on-reset flag
327 		The value of the current "keep settings" flag
348 		New value for keep_settings flag
358 	  - EINVAL	Called on a partition instead of the whole disk device
359 	  - EACCES	Access denied:  requires CAP_SYS_ADMIN
360 	  - EINVAL	value out of range [0 1]
361 	  - EBUSY		Controller busy
386 		0=16-bit, 1=32-bit, 2,3 = 32bit+sync
393 	get ignore-write-error flag
408 		The value of the current ignore-write-error flag
415 	get use-dma flag
430 		The value of the current use-dma flag
457 		Per-drive flags which determine when the system will give more
487 	  - EACCES	Access denied:  requires CAP_SYS_ADMIN
488 	  - EPERM	Flags other than DSC_OVERLAP and NICE_1 set.
489 	  - EPERM	DSC_OVERLAP specified but not supported by drive
503 	get write cache mode on|off
518 		The value of the current write cache mode
565 		The value of the current addressing mode:
568 	    0  28-bit
569 	    1  48-bit
570 	    2  48-bit doing 28-bit
571 	    3  64-bit
596 	  - EACCES	Access denied:  requires CAP_SYS_ADMIN
622 	  - EACCES	Access denied:  requires CAP_SYS_RAWIO
623 	  - EOPNOTSUPP	Hardware interface does not support bus power control
658 	  - EACCES	Access denied:  requires CAP_SYS_ADMIN
659 	  - ENXIO	No such device:	phy dead or ctl_addr == 0
660 	  - EIO		I/O error:	reset timed out or hardware error
664 	  - Execute a reset on the device as soon as the current IO
667 	  - Executes an ATAPI soft reset if applicable, otherwise
680 	- Execute an ATA disk command directly by writing the "taskfile"
705 	  hob_ports[8]	high-order bytes, for extended commands.
719 	  hob_ports[]	high-order bytes, for extended commands.
727 	  - EACCES	CAP_SYS_ADMIN or CAP_SYS_RAWIO privilege not set.
728 	  - ENOMSG	Device is not a disk drive.
729 	  - ENOMEM	Unable to allocate memory for task
730 	  - EFAULT	req_cmd == TASKFILE_IN_OUT (not implemented as of 2.6.8)
731 	  - EPERM
734 			multi-count not yet set.
735 	  - EIO		Drive failed the command.
778 	    hob_ports[8]	high-order bytes, for extended commands
788 	    out_size		output (user->drive) buffer size, bytes
789 	    in_size		input (drive->user) buffer size, bytes
814 				travel on DD8-DD15 on little endian machines
815 				and on DD0-DD7 on big endian machines.
817 				travel on DD0-DD7 on little endian machines
818 				and on DD8-DD15 on big endian machines.
843 				DD8-DD15 on little endian machines and
844 				DD0-DD7 on big endian machines.
846 				DD0-DD7 on little endian machines and
847 				DD8-DD15 on big endian machines.
891 	  [6] Do not access {in|out}_flags->all except for resetting
892 	  all the bits.  Always access individual bit fields.  ->all
947 	  - EACCES	Access denied:  requires CAP_SYS_RAWIO
948 	  - ENOMEM	Unable to allocate memory for task
949 	  - EIO		Drive reports error
969 	  mode, IDE driver will try to tune the transfer mode of the
1016 	  - EACCES	Access denied:  requires CAP_SYS_RAWIO
1017 	  - ENOMEM	Unable to allocate memory for task
1018 	  - ENOMSG	Device is not a disk drive.
1019 	  - EIO		Drive failed the command.
1048 		New value for io_32bit flag
1058 	  - EINVAL	Called on a partition instead of the whole disk device
1059 	  - EACCES	Access denied:  requires CAP_SYS_ADMIN
1060 	  - EINVAL	value out of range [0 3]
1061 	  - EBUSY	Controller busy
1067 	change ignore-write-error flag
1077 		New value for ignore-write-error flag.  Used for ignoring
1088 	  - EINVAL	Called on a partition instead of the whole disk device
1089 	  - EACCES	Access denied:  requires CAP_SYS_ADMIN
1090 	  - EINVAL	value out of range [0 1]
1091 	  - EBUSY		Controller busy
1096 	change use-dma flag
1106 		New value for use-dma flag
1116 	  - EINVAL	Called on a partition instead of the whole disk device
1117 	  - EACCES	Access denied:  requires CAP_SYS_ADMIN
1118 	  - EINVAL	value out of range [0 1]
1119 	  - EBUSY	Controller busy
1144 	  - EINVAL	Called on a partition instead of the whole disk device
1145 	  - EACCES	Access denied:  requires CAP_SYS_ADMIN
1146 	  - EINVAL	value out of range [0 255]
1147 	  - EBUSY	Controller busy
1178 	  - EACCES	Access denied:  requires CAP_SYS_RAWIO
1179 	  - EIO		Probe failed.
1209 	  - EACCES	Access denied:  requires CAP_SYS_RAWIO
1220 	change write cache enable-disable
1240 	  - EINVAL	Called on a partition instead of the whole disk device
1241 	  - EACCES	Access denied:  requires CAP_SYS_ADMIN
1242 	  - EINVAL	value out of range [0 1]
1243 	  - EBUSY	Controller busy
1268 	  - EINVAL	Called on a partition instead of the whole disk device
1269 	  - EACCES	Access denied:  requires CAP_SYS_ADMIN
1270 	  - EINVAL	value out of range [0 254]
1271 	  - EBUSY	Controller busy
1276 	change use-qdma flag
1294 		New value for addressing mode
1297 	    0   28-bit
1298 	    1   48-bit
1299 	    2   48-bit doing 28-bit
1308 	  - EINVAL	Called on a partition instead of the whole disk device
1309 	  - EACCES	Access denied:  requires CAP_SYS_ADMIN
1310 	  - EINVAL	value out of range [0 2]
1311 	  - EBUSY		Controller busy
1312 	  - EIO		Drive does not support lba48 mode.
1324 		New value for scsi emulation mode (?)
1334 	  - EINVAL	Called on a partition instead of the whole disk device
1335 	  - EACCES	Access denied:  requires CAP_SYS_ADMIN
1336 	  - EINVAL	value out of range [0 1]
1337 	  - EBUSY	Controller busy