Return to ioctl.2 CVS log

Up to [Power 6/32 Unix Tahoe 4.2BSD] / cci / usr / src / man / man2

Annotation of cci/usr/src/man/man2/ioctl.2, revision 1.1.1.2

1.1       root        1: .TH IOCTL 2 "7 July 1983"
                      2: .UC 4
                      3: .SH NAME
                      4: ioctl \- control device
                      5: .SH SYNOPSIS
                      6: .nf
                      7: .ft B
                      8: #include <sys/ioctl.h>
                      9: .PP
                     10: .ft B
                     11: ioctl(d, request, argp)
                     12: int d, request;
                     13: char *argp;
                     14: .fi
                     15: .ft R
                     16: .SH DESCRIPTION
                     17: .I Ioctl
                     18: performs a variety of functions
                     19: on open descriptors.  In particular, many operating
                     20: characteristics of character special files (e.g. terminals)
                     21: may be controlled with
                     22: .I ioctl
                     23: requests.
                     24: The writeups of various devices in section 4 discuss how
                     25: .I ioctl
                     26: applies to them.
                     27: .PP
                     28: An  ioctl
                     29: .I request
                     30: has encoded in it whether the argument is an \*(lqin\*(rq parameter
                     31: or \*(lqout\*(rq parameter, and the size of the argument \fIargp\fP in bytes.
                     32: Macros and defines used in specifying an ioctl
                     33: .I request
                     34: are located in the file
                     35: .IR <sys/ioctl.h> .
                     36: .SH "RETURN VALUE
                     37: If an error has occurred, a value of \-1 is returned and
                     38: .I errno
                     39: is set to indicate the error.
                     40: .SH ERRORS
                     41: .I Ioctl
1.1.1.2 ! root       42: fails if one or more of the following are true:
1.1       root       43: .TP 15
                     44: [EBADF]
                     45: \fID\fP is not a valid descriptor.
                     46: .TP 15
                     47: [ENOTTY]
                     48: \fID\fP is not associated with a character
                     49: special device.
                     50: .TP 15
                     51: [ENOTTY]
                     52: The specified request does not apply to the kind
                     53: of object which the descriptor \fId\fP references.
                     54: .TP 15
                     55: [EINVAL]
                     56: \fIRequest\fP or \fIargp\fP is not valid.
                     57: .SH "SEE ALSO"
                     58: execve(2), fcntl(2), mt(4), tty(4), intro(4N)

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.