packages/net/tcpip/v2_0/doc/ioctl.html

   1 <html>
   2 <body>
   3 <pre>
   4 NAME
   5        ioctl - control device
   6
   7 SYNOPSIS
   8        #include <sys/ioctl.h>
   9
  10        int ioctl(int d, int request, ...)
  11
  12        [The  "third"  argument  is  traditionally char *argp, and
  13        will be so named for this discussion.]
  14
  15 DESCRIPTION
  16        The  ioctl  function  manipulates  the  underlying  device
  17        parameters  of special files.  In particular, many operat-
  18        ing characteristics of sockets and network devices
  19        may be controlled with ioctl requests.  The argu-
  20        ment d must be an open file descriptor.
  21
  22        An ioctl request has encoded in it whether the argument is
  23        an  in  parameter  or  out  parameter, and the size of the
  24        argument argp in bytes.  Macros and defines used in speci-
  25        fying   an   ioctl   request   are  located  in  the  file
  26        <sys/ioctl.h>.
  27
  28 RETURN VALUE
  29        On success, zero is returned.  On error, -1  is  returned,
  30        and errno is set appropriately.
  31
  32 ERRORS
  33        EBADF  d is not a valid descriptor.
  34
  35        EFAULT argp references an inaccessible memory area.
  36
  37        ENOTTY d  is  not  associated  with  a  character  special
  38               device.
  39
  40        ENOTTY The specified request does not apply to the kind of
  41               object that the descriptor d references.
  42
  43        EINVAL Request or argp is not valid.
  44 </pre>
  45 </body>
  46 </html>