Home | History | Annotate | Download | only in bits
      1 /* Copyright (C) 1998, 1999, 2000, 2002 Free Software Foundation, Inc.
      2    This file is part of the GNU C Library.
      3 
      4    The GNU C Library is free software; you can redistribute it and/or
      5    modify it under the terms of the GNU Lesser General Public
      6    License as published by the Free Software Foundation; either
      7    version 2.1 of the License, or (at your option) any later version.
      8 
      9    The GNU C Library is distributed in the hope that it will be useful,
     10    but WITHOUT ANY WARRANTY; without even the implied warranty of
     11    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
     12    Lesser General Public License for more details.
     13 
     14    You should have received a copy of the GNU Lesser General Public
     15    License along with the GNU C Library; if not, write to the Free
     16    Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
     17    02111-1307 USA.  */
     18 
     19 #ifndef _STROPTS_H
     20 # error "Never include <bits/stropts.h> directly; use <stropts.h> instead."
     21 #endif
     22 
     23 #ifndef _BITS_STROPTS_H
     24 #define _BITS_STROPTS_H	1
     25 
     26 #include <bits/types.h>
     27 
     28 /* Macros used as `request' argument to `ioctl'.  */
     29 #define __SID		('S' << 8)
     30 
     31 #define I_NREAD	    (__SID | 1)	/* Counts the number of data bytes in the data
     32 				   block in the first message.  */
     33 #define I_PUSH	    (__SID | 2)	/* Push STREAMS module onto top of the current
     34 				   STREAM, just below the STREAM head.  */
     35 #define I_POP	    (__SID | 3)	/* Remove STREAMS module from just below the
     36 				   STREAM head.  */
     37 #define I_LOOK	    (__SID | 4)	/* Retrieve the name of the module just below
     38 				   the STREAM head and place it in a character
     39 				   string.  */
     40 #define I_FLUSH	    (__SID | 5)	/* Flush all input and/or output.  */
     41 #define I_SRDOPT    (__SID | 6)	/* Sets the read mode.  */
     42 #define I_GRDOPT    (__SID | 7)	/* Returns the current read mode setting.  */
     43 #define I_STR	    (__SID | 8)	/* Construct an internal STREAMS `ioctl'
     44 				   message and send that message downstream. */
     45 #define I_SETSIG    (__SID | 9)	/* Inform the STREAM head that the process
     46 				   wants the SIGPOLL signal issued.  */
     47 #define I_GETSIG    (__SID |10) /* Return the events for which the calling
     48 				   process is currently registered to be sent
     49 				   a SIGPOLL signal.  */
     50 #define I_FIND	    (__SID |11) /* Compares the names of all modules currently
     51 				   present in the STREAM to the name pointed to
     52 				   by `arg'.  */
     53 #define I_LINK	    (__SID |12) /* Connect two STREAMs.  */
     54 #define I_UNLINK    (__SID |13) /* Disconnects the two STREAMs.  */
     55 #define I_PEEK	    (__SID |15) /* Allows a process to retrieve the information
     56 				   in the first message on the STREAM head read
     57 				   queue without taking the message off the
     58 				   queue.  */
     59 #define I_FDINSERT  (__SID |16) /* Create a message from the specified
     60 				   buffer(s), adds information about another
     61 				   STREAM, and send the message downstream.  */
     62 #define I_SENDFD    (__SID |17) /* Requests the STREAM associated with `fildes'
     63 				   to send a message, containing a file
     64 				   pointer, to the STREAM head at the other end
     65 				   of a STREAMS pipe.  */
     66 #define I_RECVFD    (__SID |14) /* Non-EFT definition.  */
     67 #define I_SWROPT    (__SID |19) /* Set the write mode.  */
     68 #define I_GWROPT    (__SID |20) /* Return the current write mode setting.  */
     69 #define I_LIST	    (__SID |21) /* List all the module names on the STREAM, up
     70 				   to and including the topmost driver name. */
     71 #define I_PLINK	    (__SID |22) /* Connect two STREAMs with a persistent
     72 				   link.  */
     73 #define I_PUNLINK   (__SID |23) /* Disconnect the two STREAMs that were
     74 				   connected with a persistent link.  */
     75 #define I_FLUSHBAND (__SID |28) /* Flush only band specified.  */
     76 #define I_CKBAND    (__SID |29) /* Check if the message of a given priority
     77 				   band exists on the STREAM head read
     78 				   queue.  */
     79 #define I_GETBAND   (__SID |30) /* Return the priority band of the first
     80 				   message on the STREAM head read queue.  */
     81 #define I_ATMARK    (__SID |31) /* See if the current message on the STREAM
     82 				   head read queue is "marked" by some module
     83 				   downstream.  */
     84 #define I_SETCLTIME (__SID |32) /* Set the time the STREAM head will delay when
     85 				   a STREAM is closing and there is data on
     86 				   the write queues.  */
     87 #define I_GETCLTIME (__SID |33) /* Get current value for closing timeout.  */
     88 #define I_CANPUT    (__SID |34) /* Check if a certain band is writable.  */
     89 
     90 
     91 /* Used in `I_LOOK' request.  */
     92 #define FMNAMESZ	8	/* compatibility w/UnixWare/Solaris.  */
     93 
     94 /* Flush options.  */
     95 #define FLUSHR		0x01	/* Flush read queues.  */
     96 #define FLUSHW		0x02	/* Flush write queues.  */
     97 #define FLUSHRW		0x03	/* Flush read and write queues.  */
     98 #ifdef __USE_GNU
     99 # define FLUSHBAND	0x04	/* Flush only specified band.  */
    100 #endif
    101 
    102 /* Possible arguments for `I_SETSIG'.  */
    103 #define S_INPUT		0x0001	/* A message, other than a high-priority
    104 				   message, has arrived.  */
    105 #define S_HIPRI		0x0002	/* A high-priority message is present.  */
    106 #define S_OUTPUT	0x0004	/* The write queue for normal data is no longer
    107 				   full.  */
    108 #define S_MSG		0x0008	/* A STREAMS signal message that contains the
    109 				   SIGPOLL signal reaches the front of the
    110 				   STREAM head read queue.  */
    111 #define S_ERROR		0x0010	/* Notification of an error condition.  */
    112 #define S_HANGUP	0x0020	/* Notification of a hangup.  */
    113 #define S_RDNORM	0x0040	/* A normal message has arrived.  */
    114 #define S_WRNORM	S_OUTPUT
    115 #define S_RDBAND	0x0080	/* A message with a non-zero priority has
    116 				   arrived.  */
    117 #define S_WRBAND	0x0100	/* The write queue for a non-zero priority
    118 				   band is no longer full.  */
    119 #define S_BANDURG	0x0200	/* When used in conjunction with S_RDBAND,
    120 				   SIGURG is generated instead of SIGPOLL when
    121 				   a priority message reaches the front of the
    122 				   STREAM head read queue.  */
    123 
    124 /* Option for `I_PEEK'.  */
    125 #define RS_HIPRI	0x01	/* Only look for high-priority messages.  */
    126 
    127 /* Options for `I_SRDOPT'.  */
    128 #define RNORM		0x0000	/* Byte-STREAM mode, the default.  */
    129 #define RMSGD		0x0001	/* Message-discard mode.   */
    130 #define RMSGN		0x0002	/* Message-nondiscard mode.   */
    131 #define RPROTDAT	0x0004	/* Deliver the control part of a message as
    132 				   data.  */
    133 #define RPROTDIS	0x0008	/* Discard the control part of a message,
    134 				   delivering any data part.  */
    135 #define RPROTNORM	0x0010	/* Fail `read' with EBADMSG if a message
    136 				   containing a control part is at the front
    137 				   of the STREAM head read queue.  */
    138 #ifdef __USE_GNU
    139 # define RPROTMASK	0x001C	/* The RPROT bits */
    140 #endif
    141 
    142 /* Possible mode for `I_SWROPT'.  */
    143 #define SNDZERO		0x001	/* Send a zero-length message downstream when a
    144 				   `write' of 0 bytes occurs.  */
    145 #ifdef __USE_GNU
    146 # define SNDPIPE	0x002	/* Send SIGPIPE on write and putmsg if
    147 				   sd_werror is set.  */
    148 #endif
    149 
    150 /* Arguments for `I_ATMARK'.  */
    151 #define ANYMARK		0x01	/* Check if the message is marked.  */
    152 #define LASTMARK	0x02	/* Check if the message is the last one marked
    153 				   on the queue.  */
    154 
    155 /* Argument for `I_UNLINK'.  */
    156 #ifdef __USE_GNU
    157 # define MUXID_ALL	(-1)	/* Unlink all STREAMs linked to the STREAM
    158 				   associated with `fildes'.  */
    159 #endif
    160 
    161 
    162 /* Macros for `getmsg', `getpmsg', `putmsg' and `putpmsg'.  */
    163 #define MSG_HIPRI	0x01	/* Send/receive high priority message.  */
    164 #define MSG_ANY		0x02	/* Receive any message.  */
    165 #define MSG_BAND	0x04	/* Receive message from specified band.  */
    166 
    167 /* Values returned by getmsg and getpmsg */
    168 #define MORECTL		1	/* More control information is left in
    169 				   message.  */
    170 #define MOREDATA	2	/* More data is left in message.  */
    171 
    172 
    173 /* Structure used for the I_FLUSHBAND ioctl on streams.  */
    174 struct bandinfo
    175   {
    176     unsigned char bi_pri;
    177     int bi_flag;
    178   };
    179 
    180 struct strbuf
    181   {
    182     int maxlen;		/* Maximum buffer length.  */
    183     int len;		/* Length of data.  */
    184     char *buf;		/* Pointer to buffer.  */
    185   };
    186 
    187 struct strpeek
    188   {
    189     struct strbuf ctlbuf;
    190     struct strbuf databuf;
    191     t_uscalar_t flags;			/* UnixWare/Solaris compatibility.  */
    192   };
    193 
    194 struct strfdinsert
    195   {
    196     struct strbuf ctlbuf;
    197     struct strbuf databuf;
    198     t_uscalar_t flags;			/* UnixWare/Solaris compatibility.  */
    199     int fildes;
    200     int offset;
    201   };
    202 
    203 struct strioctl
    204   {
    205     int ic_cmd;
    206     int ic_timout;
    207     int ic_len;
    208     char *ic_dp;
    209   };
    210 
    211 struct strrecvfd
    212   {
    213     int fd;
    214     uid_t uid;
    215     gid_t gid;
    216     char __fill[8];			/* UnixWare/Solaris compatibility */
    217   };
    218 
    219 
    220 struct str_mlist
    221   {
    222     char l_name[FMNAMESZ + 1];
    223   };
    224 
    225 struct str_list
    226   {
    227     int sl_nmods;
    228     struct str_mlist *sl_modlist;
    229   };
    230 
    231 #endif /* bits/stropts.h */
    232