IOCTL(2) BSD Programmer's Manual IOCTL(2) NNAAMMEE iiooccttll - control device SSYYNNOOPPSSIISS ##iinncclluuddee <<ssyyss//iiooccttll..hh>> _i_n_t iiooccttll(_i_n_t _d, _u_n_s_i_g_n_e_d _l_o_n_g _r_e_q_u_e_s_t, _c_h_a_r _*_a_r_g_p); DDEESSCCRRIIPPTTIIOONN The iiooccttll() function manipulates the underlying device parameters of spe- cial files. In particular, many operating characteristics of character special files (e.g. terminals) may be controlled with iiooccttll() requests. The argument _d must be an open file descriptor. An ioctl _r_e_q_u_e_s_t has encoded in it whether the argument is an ``in'' pa- rameter or ``out'' parameter, and the size of the argument _a_r_g_p in bytes. Macros and defines used in specifying an ioctl _r_e_q_u_e_s_t are located in the file <_s_y_s_/_i_o_c_t_l_._h>. RREETTUURRNN VVAALLUUEESS If an error has occurred, a value of -1 is returned and _e_r_r_n_o is set to indicate the error. EERRRROORRSS IIooccttll() will fail: [EBADF] _d is not a valid descriptor. [ENOTTY] _d is not associated with a character special device. [ENOTTY] The specified request does not apply to the kind of object that the descriptor _d references. [EINVAL] _R_e_q_u_e_s_t or _a_r_g_p is not valid. SSEEEE AALLSSOO mt(1), execve(2), fcntl(2), tty(4), intro(4) HHIISSTTOORRYY An iiooccttll function call appeared in Version 7 AT&T UNIX. 4th Berkeley Distribution June 4, 1993 1