Return to ioctl.2 CVS log

Up to [Research Unix] / researchv10dc / man / man2

Annotation of researchv10dc/man/man2/ioctl.2, revision 1.1

1.1     ! root        1: .TH IOCTL 2
        !             2: .CT 2 file_io file_inq_creat
        !             3: .SH NAME
        !             4: ioctl \(mi miscellaneous control operations
        !             5: .SH SYNOPSIS
        !             6: .nf
        !             7: .B #include <sys/filio.h>
        !             8: .PP
        !             9: .B int ioctl(fildes, request, param)
        !            10: .B void *param;
        !            11: .fi
        !            12: .SH DESCRIPTION
        !            13: .I Ioctl
        !            14: performs a variety of
        !            15: .I requests
        !            16: on open files,
        !            17: most applying only to particular device files.
        !            18: The writeups of various devices
        !            19: in section 4 discuss how
        !            20: .I ioctl
        !            21: applies to them;
        !            22: see
        !            23: .IR stream (4)
        !            24: in particular
        !            25: for operations applying to
        !            26: communication devices.
        !            27: .PP
        !            28: .I Param
        !            29: points to a parameter buffer.
        !            30: Some
        !            31: .I requests
        !            32: read data from the buffer;
        !            33: others write data to the buffer;
        !            34: some do both.
        !            35: The buffer's size varies according to the request.
        !            36: A few provide meaningful data
        !            37: in the return value from
        !            38: .I ioctl
        !            39: as well;
        !            40: others return a conventional value of
        !            41: 0 for success,
        !            42: \-1 for failure.
        !            43: .PP
        !            44: Requests for different drivers
        !            45: are defined in different header files.
        !            46: Two standard calls,
        !            47: defined in
        !            48: .BR <sys/filio.h> ,
        !            49: apply to any open file:
        !            50: .IP
        !            51: .L
        !            52: ioctl(fildes, FIOCLEX, (void *)0);
        !            53: .br
        !            54: .L
        !            55: ioctl(fildes, FIONCLEX, (void *)0);
        !            56: .LP
        !            57: The first causes the file to be closed automatically upon
        !            58: a successful
        !            59: .IR exec (2);
        !            60: the second causes the file to be left open.
        !            61: .SH "SEE ALSO"
        !            62: .IR exec (2),
        !            63: .IR stream (4)
        !            64: .SH DIAGNOSTICS
        !            65: .BR EBADF ,
        !            66: .BR EFAULT ,
        !            67: .BR EIO ,
        !            68: .BR ENODEV ,
        !            69: .BR ENOTTY
        !            70: .SH BUGS
        !            71: .I Ioctl
        !            72: requests vary among UNIX systems;
        !            73: undisciplined use is likely to compromise portability.
        !            74: .br
        !            75: The size of the parameter buffer
        !            76: should be an explicit argument.

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