*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->NetBSD man pages -> ioctl (2)              



NAME    [Toc]    [Back]

     ioctl - control device

LIBRARY    [Toc]    [Back]

     Standard C Library (libc, -lc)

SYNOPSIS    [Toc]    [Back]

     #include <sys/ioctl.h>

     ioctl(int d, unsigned long request, void *argp);

DESCRIPTION    [Toc]    [Back]

     The ioctl() function manipulates the underlying device parameters of special
 files.  In particular, many operating characteristics of character
     special files (e.g. terminals) may be controlled with ioctl() requests.
     The argument d must be an open file descriptor.

     An  ioctl request has encoded in it whether the argument is an ``in''
     parameter or ``out'' parameter, and the size of the argument argp in
     bytes.  Macros and defines used in specifying an ioctl request are
     located in the file <sys/ioctl.h>.

RETURN VALUES    [Toc]    [Back]

     If an error has occurred, a value of -1 is returned and errno is set to
     indicate the error.

ERRORS    [Toc]    [Back]

     ioctl() will fail if:

     [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]           request or argp is not valid.

SEE ALSO    [Toc]    [Back]

     mt(1), execve(2), fcntl(2), intro(4), tty(4)

HISTORY    [Toc]    [Back]

     An ioctl() function call appeared in Version 7 AT&T UNIX.

BSD                            December 11, 1993                           BSD
[ Back ]
 Similar pages
Name OS Title
devctl FreeBSD device event reporting and device control interface
scsictl HP-UX control a SCSI device
comcontrol FreeBSD control a special tty device
VOP_IOCTL FreeBSD device specific control
audioctl OpenBSD control audio device
atacontrol FreeBSD ATA device driver control program
ioctl HP-UX generic device control commands
uucplock FreeBSD acquire and release control of a serial device
uu_lockerr OpenBSD acquire and release control of a serial device
uu_unlock OpenBSD acquire and release control of a serial device
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service