ioctl (DOS)

It is highly recommended to use only the DOS_* functions listed in `sys/ioctl.h'.

Syntax

#include <sys/ioctl.h> int ioctl(int fd, int cmd, ... );

Description

The following constants can be used for the cmd parameter:

DOS_GETDEVDATA

Get device information. Returns the device information word from DX. The call to ioctl should look like this:

int ret_val = ioctl (fd, DOS_GETDEVDATA);

For another way of achieving the same effect, see _get_dev_info (see section _get_dev_info).

DOS_SETDEVDATA

Set device information. Returns the new device information word form DX or -1. The call to ioctl should look like this:

int ret_val = ioctl (fd, DOS_SETDEVDATA, 0, dev_info);

DOS_RCVDATA

Read from character device control channel. After cmd must follow the number of requested bytes to read and a pointer to a buffer. Returns the number of bytes actually read or -1 on error. The call to ioctl should look like this:

unsigned char buf[bytes_to_read]; int ret_val = ioctl (fd, DOS_RCVDATA, bytes_to_read, &buf);

DOS_SNDDATA

Write to character device control channel. After cmd must follow the number of bytes to write and a pointer to a buffer holding the data. Returns the number of bytes actually written. An example of a call:

unsigned char buf[bytes_to_write]; int ret_val = ioctl (fd, DOS_SNDDATA, bytes_to_write, &buf);

DOS_RCVCTLDATA

Read from block device control channel. See DOS_RCVDATA.

DOS_SNDCTLDATA

Write to block device control channel. See DOS_SNDDATA.

DOS_CHKINSTAT

Check the input status of a file. Returns 0 if not ready of at EOF, 0xff if file is ready. Here's an example of how to call:

int ret_val = ioctl (fd, DOS_CHKINSTAT);

A more portable way of doing this is by calling select. See section select.

DOS_CHKOUTSTAT

Check the output status of a file. Returns 0 if not ready of at EOF, 0xff if file is ready. select (see section select) is another, more portable way of doing the same.

DOS_ISCHANGEABLE

Check if a block device is changeable. Returns 0 for removable or 1 for fixed. An example of a call:

int ret_val = ioctl (fd, DOS_ISCHANGEABLE);

DOS_ISREDIRBLK

Check if a block device is remote o local. The function _is_remote_drive (see section _is_remote_drive) is another way of returning the same info.

DOS_ISREDIRHND

Check if a file handle refers to a local or remote device. See _is_remote_handle (see section _is_remote_handle) for another way of doing this.

DOS_SETRETRY

Set the sharing retry count. The first extra parameter specifies the pause between retries, the second number of retries. An example:

int ret_val = ioctl (fd, DOS_SETRETRY, pause_between_retries, max_retries);

DOS_GENCHARREQ

Generic character device request. Example:

int ret_val = ioctl (fd, DOS_GENCHARREQ, category_and_function, &param_block, si_value, di_value, param_block_size);

Refer to Ralf Brown's Interrupt List for the details about each function and relevant parameter block layout.

DOS_GENBLKREQ

Generic block device request. Example of the call:

int ret_val = ioctl (drive_no, DOS_GENBLKREQ, category_and_function, &param_block, si_value, di_value, param_block_size);

Note that instead of the handle, the first argument is the disk drive number (0 = default, 1 = A:, etc.).

DOS_GLDRVMAP

Get logical drive map. A call like the following:

int ret_val = ioctl (drive_no, DOS_GLDRVMAP);

will return 0 if the block device has only one logical drive assigned, or a number in the range 1..26 which is the last drive numer used to reference that drive (1 = A:, etc.). Thus, on a machine which has a single floppy drive, calling ioctl (1, DOS_GLDRVMAP); will return 2 if the floppy was last refered to as B:. This function and the next one can be used together to prevent DOS from popping the ugly prompt saying "Insert diskette for drive B: and press any key when ready".

DOS_SLDRVMAP

Set logical drive map. For example, a call like this:

ioctl (1, DOS_SLDRVMAP);

will cause drive A: to be mapped to drive B:.

DOS_QGIOCTLCAPH

Query generic ioctl capability (handle). Test if a handle supports ioctl functions beyond those in the standard DOS 3.2 set. Call like this:

int ret_val = ioctl (fd, DOS_QGIOCTLCAPH, category_and_function);

This will return zero if the specified IOCTL function is supported, 1 if not.

DOS_QGIOCTLCAPD

Query generic ioctl capability (drive). Test if a drive supports ioctl functions beyond those in the standard DOS 3.2 set. Used same as DOS_QGIOCTLCAPH, but the first argument is a drive number (0 = default, 1 = A:, etc.), not a handle.

If your specific device driver requires different commands, they must be or'ed together with the flags listed in <sys/ioctl.h> to tell the drive about transfer buffers and what to return.

Return Value

Device information word

14 Device driver can process IOCTL request 13 output until busy supported 11 driver supports OPEN/CLOSE calls 7 set (indicates device) 6 EOF on input 5 raw (binary) mode 4 device is special (uses INT 29) 3 clock device 2 NUL device 1 standard output 0 standard input

Disk file:

15 file is remote (DOS 3.0+) 14 don't set file date/time on closing (DOS 3.0+) 11 media not removable 8 (DOS 4 only) generate INT 24 if no disk space on write or read past end of file 7 clear (indicates file) 6 file has not been written 5-0 drive number (0 = A:)

Example

#include <sys/ioctl.h> int main(int argc, char **argv) { char buf[6]; short *s; open(fd,"EMMQXXX0",O_RDONLY); mybuf[0] = '\0'; s = mybuf; ioctl(fd,DOS_SNDDATA,6, (int) &mybuf); if(*s ==0x25 )printf("EMM386 >= 4.45\n"); mybuf[0]='\x02'; ioctl(fd,DOS_SNDDATA,2,(int )&mybuf); printf("EMM Version %d.%d\n",(int )mybuf[0],(int) mybuf[1]); close(fd); }