Add Changelog ...
[jlayton/glibc.git] / sysdeps / unix / sysv / linux / hppa / bits / socket.h
1 /* System-specific socket constants and types.  Linux version.
2    Copyright (C) 1991-2012 Free Software Foundation, Inc.
3    This file is part of the GNU C Library.
4
5    The GNU C Library is free software; you can redistribute it and/or
6    modify it under the terms of the GNU Lesser General Public
7    License as published by the Free Software Foundation; either
8    version 2.1 of the License, or (at your option) any later version.
9
10    The GNU C Library is distributed in the hope that it will be useful,
11    but WITHOUT ANY WARRANTY; without even the implied warranty of
12    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
13    Lesser General Public License for more details.
14
15    You should have received a copy of the GNU Lesser General Public
16    License along with the GNU C Library; if not, see
17    <http://www.gnu.org/licenses/>.  */
18
19 #ifndef __BITS_SOCKET_H
20 #define __BITS_SOCKET_H
21
22 #ifndef _SYS_SOCKET_H
23 # error "Never include <bits/socket.h> directly; use <sys/socket.h> instead."
24 #endif
25
26 #define __need_size_t
27 #include <stddef.h>
28
29 #include <sys/types.h>
30
31 /* Type for length arguments in socket calls.  */
32 #ifndef __socklen_t_defined
33 typedef __socklen_t socklen_t;
34 # define __socklen_t_defined
35 #endif
36
37 /* Types of sockets.  */
38 enum __socket_type
39 {
40   SOCK_STREAM = 1,              /* Sequenced, reliable, connection-based
41                                    byte streams.  */
42 #define SOCK_STREAM SOCK_STREAM
43   SOCK_DGRAM = 2,               /* Connectionless, unreliable datagrams
44                                    of fixed maximum length.  */
45 #define SOCK_DGRAM SOCK_DGRAM
46   SOCK_RAW = 3,                 /* Raw protocol interface.  */
47 #define SOCK_RAW SOCK_RAW
48   SOCK_RDM = 4,                 /* Reliably-delivered messages.  */
49 #define SOCK_RDM SOCK_RDM
50   SOCK_SEQPACKET = 5,           /* Sequenced, reliable, connection-based,
51                                    datagrams of fixed maximum length.  */
52 #define SOCK_SEQPACKET SOCK_SEQPACKET
53   SOCK_DCCP = 6,                /* Datagram Congestion Control Protocol.  */
54 #define SOCK_DCCP SOCK_DCCP
55   SOCK_PACKET = 10,             /* Linux specific way of getting packets
56                                    at the dev level.  For writing rarp and
57                                    other similar things on the user level. */
58 #define SOCK_PACKET SOCK_PACKET
59
60   /* Flags to be ORed into the type parameter of socket and socketpair and
61      used for the flags parameter of paccept.  */
62
63   SOCK_CLOEXEC = 010000000,     /* Atomically set close-on-exec flag for the
64                                    new descriptor(s).  */
65 #define SOCK_CLOEXEC SOCK_CLOEXEC
66   SOCK_NONBLOCK = 0x40000000    /* Atomically mark descriptor(s) as
67                                    non-blocking.  */
68 #define SOCK_NONBLOCK SOCK_NONBLOCK
69 };
70
71 /* Protocol families.  */
72 #define PF_UNSPEC       0       /* Unspecified.  */
73 #define PF_LOCAL        1       /* Local to host (pipes and file-domain).  */
74 #define PF_UNIX         PF_LOCAL /* POSIX name for PF_LOCAL.  */
75 #define PF_FILE         PF_LOCAL /* Another non-standard name for PF_LOCAL.  */
76 #define PF_INET         2       /* IP protocol family.  */
77 #define PF_AX25         3       /* Amateur Radio AX.25.  */
78 #define PF_IPX          4       /* Novell Internet Protocol.  */
79 #define PF_APPLETALK    5       /* Appletalk DDP.  */
80 #define PF_NETROM       6       /* Amateur radio NetROM.  */
81 #define PF_BRIDGE       7       /* Multiprotocol bridge.  */
82 #define PF_ATMPVC       8       /* ATM PVCs.  */
83 #define PF_X25          9       /* Reserved for X.25 project.  */
84 #define PF_INET6        10      /* IP version 6.  */
85 #define PF_ROSE         11      /* Amateur Radio X.25 PLP.  */
86 #define PF_DECnet       12      /* Reserved for DECnet project.  */
87 #define PF_NETBEUI      13      /* Reserved for 802.2LLC project.  */
88 #define PF_SECURITY     14      /* Security callback pseudo AF.  */
89 #define PF_KEY          15      /* PF_KEY key management API.  */
90 #define PF_NETLINK      16
91 #define PF_ROUTE        PF_NETLINK /* Alias to emulate 4.4BSD.  */
92 #define PF_PACKET       17      /* Packet family.  */
93 #define PF_ASH          18      /* Ash.  */
94 #define PF_ECONET       19      /* Acorn Econet.  */
95 #define PF_ATMSVC       20      /* ATM SVCs.  */
96 #define PF_RDS          21      /* RDS sockets.  */
97 #define PF_SNA          22      /* Linux SNA Project */
98 #define PF_IRDA         23      /* IRDA sockets.  */
99 #define PF_PPPOX        24      /* PPPoX sockets.  */
100 #define PF_WANPIPE      25      /* Wanpipe API sockets.  */
101 #define PF_LLC          26      /* Linux LLC.  */
102 #define PF_CAN          29      /* Controller Area Network.  */
103 #define PF_TIPC         30      /* TIPC sockets.  */
104 #define PF_BLUETOOTH    31      /* Bluetooth sockets.  */
105 #define PF_IUCV         32      /* IUCV sockets.  */
106 #define PF_RXRPC        33      /* RxRPC sockets.  */
107 #define PF_ISDN         34      /* mISDN sockets.  */
108 #define PF_PHONET       35      /* Phonet sockets.  */
109 #define PF_IEEE802154   36      /* IEEE 802.15.4 sockets.  */
110 #define PF_CAIF         37      /* CAIF sockets.  */
111 #define PF_ALG          38      /* Algorithm sockets.  */
112 #define PF_NFC          39      /* NFC sockets.  */
113 #define PF_MAX          40      /* For now..  */
114
115 /* Address families.  */
116 #define AF_UNSPEC       PF_UNSPEC
117 #define AF_LOCAL        PF_LOCAL
118 #define AF_UNIX         PF_UNIX
119 #define AF_FILE         PF_FILE
120 #define AF_INET         PF_INET
121 #define AF_AX25         PF_AX25
122 #define AF_IPX          PF_IPX
123 #define AF_APPLETALK    PF_APPLETALK
124 #define AF_NETROM       PF_NETROM
125 #define AF_BRIDGE       PF_BRIDGE
126 #define AF_ATMPVC       PF_ATMPVC
127 #define AF_X25          PF_X25
128 #define AF_INET6        PF_INET6
129 #define AF_ROSE         PF_ROSE
130 #define AF_DECnet       PF_DECnet
131 #define AF_NETBEUI      PF_NETBEUI
132 #define AF_SECURITY     PF_SECURITY
133 #define AF_KEY          PF_KEY
134 #define AF_NETLINK      PF_NETLINK
135 #define AF_ROUTE        PF_ROUTE
136 #define AF_PACKET       PF_PACKET
137 #define AF_ASH          PF_ASH
138 #define AF_ECONET       PF_ECONET
139 #define AF_ATMSVC       PF_ATMSVC
140 #define AF_RDS          PF_RDS
141 #define AF_SNA          PF_SNA
142 #define AF_IRDA         PF_IRDA
143 #define AF_PPPOX        PF_PPPOX
144 #define AF_WANPIPE      PF_WANPIPE
145 #define AF_LLC          PF_LLC
146 #define AF_CAN          PF_CAN
147 #define AF_TIPC         PF_TIPC
148 #define AF_BLUETOOTH    PF_BLUETOOTH
149 #define AF_IUCV         PF_IUCV
150 #define AF_RXRPC        PF_RXRPC
151 #define AF_ISDN         PF_ISDN
152 #define AF_PHONET       PF_PHONET
153 #define AF_IEEE802154   PF_IEEE802154
154 #define AF_CAIF         PF_CAIF
155 #define AF_ALG          PF_ALG
156 #define AF_NFC          PF_NFC
157 #define AF_MAX          PF_MAX
158
159 /* Socket level values.  Others are defined in the appropriate headers.
160
161    XXX These definitions also should go into the appropriate headers as
162    far as they are available.  */
163 #define SOL_RAW         255
164 #define SOL_DECNET      261
165 #define SOL_X25         262
166 #define SOL_PACKET      263
167 #define SOL_ATM         264     /* ATM layer (cell level).  */
168 #define SOL_AAL         265     /* ATM Adaption Layer (packet level).  */
169 #define SOL_IRDA        266
170
171 /* Maximum queue length specifiable by listen.  */
172 #define SOMAXCONN       128
173
174 /* Get the definition of the macro to define the common sockaddr members.  */
175 #include <bits/sockaddr.h>
176
177 /* Structure describing a generic socket address.  */
178 struct sockaddr
179   {
180     __SOCKADDR_COMMON (sa_);    /* Common data: address family and length.  */
181     char sa_data[14];           /* Address data.  */
182   };
183
184
185 /* Structure large enough to hold any socket address (with the historical
186    exception of AF_UNIX).  We reserve 128 bytes.  */
187 #define __ss_aligntype  unsigned long int
188 #define _SS_SIZE        128
189 #define _SS_PADSIZE     (_SS_SIZE - (2 * sizeof (__ss_aligntype)))
190
191 struct sockaddr_storage
192   {
193     __SOCKADDR_COMMON (ss_);    /* Address family, etc.  */
194     __ss_aligntype __ss_align;  /* Force desired alignment.  */
195     char __ss_padding[_SS_PADSIZE];
196   };
197
198
199 /* Bits in the FLAGS argument to `send', `recv', et al.  */
200 enum
201   {
202     MSG_OOB             = 0x01, /* Process out-of-band data.  */
203 #define MSG_OOB         MSG_OOB
204     MSG_PEEK            = 0x02, /* Peek at incoming messages.  */
205 #define MSG_PEEK        MSG_PEEK
206     MSG_DONTROUTE       = 0x04, /* Don't use local routing.  */
207 #define MSG_DONTROUTE   MSG_DONTROUTE
208 #ifdef __USE_GNU
209     /* DECnet uses a different name.  */
210     MSG_TRYHARD         = MSG_DONTROUTE,
211 # define MSG_TRYHARD    MSG_DONTROUTE
212 #endif
213     MSG_CTRUNC          = 0x08, /* Control data lost before delivery.  */
214 #define MSG_CTRUNC      MSG_CTRUNC
215     MSG_PROXY           = 0x10, /* Supply or ask second address.  */
216 #define MSG_PROXY       MSG_PROXY
217     MSG_TRUNC           = 0x20,
218 #define MSG_TRUNC       MSG_TRUNC
219     MSG_DONTWAIT        = 0x40, /* Nonblocking IO.  */
220 #define MSG_DONTWAIT    MSG_DONTWAIT
221     MSG_EOR             = 0x80, /* End of record.  */
222 #define MSG_EOR         MSG_EOR
223     MSG_WAITALL         = 0x100, /* Wait for a full request.  */
224 #define MSG_WAITALL     MSG_WAITALL
225     MSG_FIN             = 0x200,
226 #define MSG_FIN         MSG_FIN
227     MSG_SYN             = 0x400,
228 #define MSG_SYN         MSG_SYN
229     MSG_CONFIRM         = 0x800, /* Confirm path validity.  */
230 #define MSG_CONFIRM     MSG_CONFIRM
231     MSG_RST             = 0x1000,
232 #define MSG_RST         MSG_RST
233     MSG_ERRQUEUE        = 0x2000, /* Fetch message from error queue.  */
234 #define MSG_ERRQUEUE    MSG_ERRQUEUE
235     MSG_NOSIGNAL        = 0x4000, /* Do not generate SIGPIPE.  */
236 #define MSG_NOSIGNAL    MSG_NOSIGNAL
237     MSG_MORE            = 0x8000,  /* Sender will send more.  */
238 #define MSG_MORE        MSG_MORE
239     MSG_WAITFORONE      = 0x10000, /* Wait for at least one packet to return.*/
240 #define MSG_WAITFORONE  MSG_WAITFORONE
241
242     MSG_CMSG_CLOEXEC    = 0x40000000    /* Set close_on_exit for file
243                                            descriptor received through
244                                            SCM_RIGHTS.  */
245 #define MSG_CMSG_CLOEXEC MSG_CMSG_CLOEXEC
246   };
247
248
249 /* Structure describing messages sent by
250    `sendmsg' and received by `recvmsg'.  */
251 struct msghdr
252   {
253     void *msg_name;             /* Address to send to/receive from.  */
254     socklen_t msg_namelen;      /* Length of address data.  */
255
256     struct iovec *msg_iov;      /* Vector of data to send/receive into.  */
257     size_t msg_iovlen;          /* Number of elements in the vector.  */
258
259     void *msg_control;          /* Ancillary data (eg BSD filedesc passing). */
260     size_t msg_controllen;      /* Ancillary data buffer length.
261                                    !! The type should be socklen_t but the
262                                    definition of the kernel is incompatible
263                                    with this.  */
264
265     int msg_flags;              /* Flags on received message.  */
266   };
267
268 #ifdef __USE_GNU
269 /* For `recvmmsg'.  */
270 struct mmsghdr
271   {
272     struct msghdr msg_hdr;      /* Actual message header.  */
273     unsigned int msg_len;       /* Number of received bytes for the entry.  */
274   };
275 #endif
276
277 /* Structure used for storage of ancillary data object information.  */
278 struct cmsghdr
279   {
280     size_t cmsg_len;            /* Length of data in cmsg_data plus length
281                                    of cmsghdr structure.
282                                    !! The type should be socklen_t but the
283                                    definition of the kernel is incompatible
284                                    with this.  */
285     int cmsg_level;             /* Originating protocol.  */
286     int cmsg_type;              /* Protocol specific type.  */
287 #if (!defined __STRICT_ANSI__ && __GNUC__ >= 2) || __STDC_VERSION__ >= 199901L
288     __extension__ unsigned char __cmsg_data __flexarr; /* Ancillary data.  */
289 #endif
290   };
291
292 /* Ancillary data object manipulation macros.  */
293 #if (!defined __STRICT_ANSI__ && __GNUC__ >= 2) || __STDC_VERSION__ >= 199901L
294 # define CMSG_DATA(cmsg) ((cmsg)->__cmsg_data)
295 #else
296 # define CMSG_DATA(cmsg) ((unsigned char *) ((struct cmsghdr *) (cmsg) + 1))
297 #endif
298 #define CMSG_NXTHDR(mhdr, cmsg) __cmsg_nxthdr (mhdr, cmsg)
299 #define CMSG_FIRSTHDR(mhdr) \
300   ((size_t) (mhdr)->msg_controllen >= sizeof (struct cmsghdr)                 \
301    ? (struct cmsghdr *) (mhdr)->msg_control : (struct cmsghdr *) 0)
302 #define CMSG_ALIGN(len) (((len) + sizeof (size_t) - 1) \
303                          & (size_t) ~(sizeof (size_t) - 1))
304 #define CMSG_SPACE(len) (CMSG_ALIGN (len) \
305                          + CMSG_ALIGN (sizeof (struct cmsghdr)))
306 #define CMSG_LEN(len)   (CMSG_ALIGN (sizeof (struct cmsghdr)) + (len))
307
308 extern struct cmsghdr *__cmsg_nxthdr (struct msghdr *__mhdr,
309                                       struct cmsghdr *__cmsg) __THROW;
310 #ifdef __USE_EXTERN_INLINES
311 # ifndef _EXTERN_INLINE
312 #  define _EXTERN_INLINE __extern_inline
313 # endif
314 _EXTERN_INLINE struct cmsghdr *
315 __NTH (__cmsg_nxthdr (struct msghdr *__mhdr, struct cmsghdr *__cmsg))
316 {
317   if ((size_t) __cmsg->cmsg_len < sizeof (struct cmsghdr))
318     /* The kernel header does this so there may be a reason.  */
319     return (struct cmsghdr *) 0;
320
321   __cmsg = (struct cmsghdr *) ((unsigned char *) __cmsg
322                                + CMSG_ALIGN (__cmsg->cmsg_len));
323   if ((unsigned char *) (__cmsg + 1) > ((unsigned char *) __mhdr->msg_control
324                                         + __mhdr->msg_controllen)
325       || ((unsigned char *) __cmsg + CMSG_ALIGN (__cmsg->cmsg_len)
326           > ((unsigned char *) __mhdr->msg_control + __mhdr->msg_controllen)))
327     /* No more entries.  */
328     return (struct cmsghdr *) 0;
329   return __cmsg;
330 }
331 #endif  /* Use `extern inline'.  */
332
333 /* Socket level message types.  This must match the definitions in
334    <linux/socket.h>.  */
335 enum
336   {
337     SCM_RIGHTS = 0x01           /* Transfer file descriptors.  */
338 #define SCM_RIGHTS SCM_RIGHTS
339 #ifdef __USE_GNU
340     , SCM_CREDENTIALS = 0x02    /* Credentials passing.  */
341 # define SCM_CREDENTIALS SCM_CREDENTIALS
342 #endif
343   };
344
345 #ifdef __USE_GNU
346 /* User visible structure for SCM_CREDENTIALS message */
347 struct ucred
348 {
349   pid_t pid;                    /* PID of sending process.  */
350   uid_t uid;                    /* UID of sending process.  */
351   gid_t gid;                    /* GID of sending process.  */
352 };
353 #endif
354
355 /* Ugly workaround for unclean kernel headers.  */
356 #if !defined __USE_MISC && !defined __USE_GNU
357 # ifndef FIOGETOWN
358 #  define __SYS_SOCKET_H_undef_FIOGETOWN
359 # endif
360 # ifndef FIOSETOWN
361 #  define __SYS_SOCKET_H_undef_FIOSETOWN
362 # endif
363 # ifndef SIOCATMARK
364 #  define __SYS_SOCKET_H_undef_SIOCATMARK
365 # endif
366 # ifndef SIOCGPGRP
367 #  define __SYS_SOCKET_H_undef_SIOCGPGRP
368 # endif
369 # ifndef SIOCGSTAMP
370 #  define __SYS_SOCKET_H_undef_SIOCGSTAMP
371 # endif
372 # ifndef SIOCGSTAMPNS
373 #  define __SYS_SOCKET_H_undef_SIOCGSTAMPNS
374 # endif
375 # ifndef SIOCSPGRP
376 #  define __SYS_SOCKET_H_undef_SIOCSPGRP
377 # endif
378 #endif
379
380 /* Get socket manipulation related informations from kernel headers.  */
381 #include <asm/socket.h>
382
383 #if !defined __USE_MISC && !defined __USE_GNU
384 # ifdef __SYS_SOCKET_H_undef_FIOGETOWN
385 #  undef __SYS_SOCKET_H_undef_FIOGETOWN
386 #  undef FIOGETOWN
387 # endif
388 # ifdef __SYS_SOCKET_H_undef_FIOSETOWN
389 #  undef __SYS_SOCKET_H_undef_FIOSETOWN
390 #  undef FIOSETOWN
391 # endif
392 # ifdef __SYS_SOCKET_H_undef_SIOCATMARK
393 #  undef __SYS_SOCKET_H_undef_SIOCATMARK
394 #  undef SIOCATMARK
395 # endif
396 # ifdef __SYS_SOCKET_H_undef_SIOCGPGRP
397 #  undef __SYS_SOCKET_H_undef_SIOCGPGRP
398 #  undef SIOCGPGRP
399 # endif
400 # ifdef __SYS_SOCKET_H_undef_SIOCGSTAMP
401 #  undef __SYS_SOCKET_H_undef_SIOCGSTAMP
402 #  undef SIOCGSTAMP
403 # endif
404 # ifdef __SYS_SOCKET_H_undef_SIOCGSTAMPNS
405 #  undef __SYS_SOCKET_H_undef_SIOCGSTAMPNS
406 #  undef SIOCGSTAMPNS
407 # endif
408 # ifdef __SYS_SOCKET_H_undef_SIOCSPGRP
409 #  undef __SYS_SOCKET_H_undef_SIOCSPGRP
410 #  undef SIOCSPGRP
411 # endif
412 #endif
413
414 /* Structure used to manipulate the SO_LINGER option.  */
415 struct linger
416   {
417     int l_onoff;                /* Nonzero to linger on close.  */
418     int l_linger;               /* Time to linger.  */
419   };
420
421
422 __BEGIN_DECLS
423
424 #ifdef __USE_GNU
425 /* Receive up to VLEN messages as described by VMESSAGES from socket FD.
426    Returns the number of bytes read or -1 for errors.
427
428    This function is a cancellation point and therefore not marked with
429    __THROW.  */
430 extern int recvmmsg (int __fd, struct mmsghdr *__vmessages,
431                      unsigned int __vlen, int __flags,
432                      const struct timespec *__tmo);
433
434 /* Send a VLEN messages as described by VMESSAGES to socket FD.
435    Return the number of datagrams successfully written or -1 for errors.
436 This function is a cancellation point and therefore not marked with
437    __THROW.  */
438 extern int sendmmsg (int __fd, struct mmsghdr *__vmessages,
439                      unsigned int __vlen, int __flags);
440 #endif
441
442 __END_DECLS
443
444 #endif  /* bits/socket.h */