bsd/sys/socket.h

   1 /*
   2  * Copyright (c) 2000 Apple Computer, Inc. All rights reserved.
   3  *
   4  * @APPLE_LICENSE_HEADER_START@
   5  *
   6  * The contents of this file constitute Original Code as defined in and
   7  * are subject to the Apple Public Source License Version 1.1 (the
   8  * "License").  You may not use this file except in compliance with the
   9  * License.  Please obtain a copy of the License at
  10  * http://www.apple.com/publicsource and read it before using this file.
  11  *
  12  * This Original Code and all software distributed under the License are
  13  * distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY KIND, EITHER
  14  * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
  15  * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
  16  * FITNESS FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT.  Please see the
  17  * License for the specific language governing rights and limitations
  18  * under the License.
  19  *
  20  * @APPLE_LICENSE_HEADER_END@
  21  */
  22 /* Copyright (c) 1998, 1999 Apple Computer, Inc. All Rights Reserved */
  23 /* Copyright (c) 1995 NeXT Computer, Inc. All Rights Reserved */
  24 /*
  25  * Copyright (c) 1982, 1985, 1986, 1988, 1993, 1994
  26  *      The Regents of the University of California.  All rights reserved.
  27  *
  28  * Redistribution and use in source and binary forms, with or without
  29  * modification, are permitted provided that the following conditions
  30  * are met:
  31  * 1. Redistributions of source code must retain the above copyright
  32  *    notice, this list of conditions and the following disclaimer.
  33  * 2. Redistributions in binary form must reproduce the above copyright
  34  *    notice, this list of conditions and the following disclaimer in the
  35  *    documentation and/or other materials provided with the distribution.
  36  * 3. All advertising materials mentioning features or use of this software
  37  *    must display the following acknowledgement:
  38  *      This product includes software developed by the University of
  39  *      California, Berkeley and its contributors.
  40  * 4. Neither the name of the University nor the names of its contributors
  41  *    may be used to endorse or promote products derived from this software
  42  *    without specific prior written permission.
  43  *
  44  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  45  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  46  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  47  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  48  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  49  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  50  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  51  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  52  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  53  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  54  * SUCH DAMAGE.
  55  *
  56  *      @(#)socket.h    8.4 (Berkeley) 2/21/94
  57  */
  58
  59 #ifndef _SYS_SOCKET_H_
  60 #define _SYS_SOCKET_H_
  61
  62
  63 /*
  64  * Definitions related to sockets: types, address families, options.
  65  */
  66
  67 /*
  68  * Types
  69  */
  70 #define SOCK_STREAM     1               /* stream socket */
  71 #define SOCK_DGRAM      2               /* datagram socket */
  72 #define SOCK_RAW        3               /* raw-protocol interface */
  73 #define SOCK_RDM        4               /* reliably-delivered message */
  74 #define SOCK_SEQPACKET  5               /* sequenced packet stream */
  75
  76 /*
  77  * Option flags per-socket.
  78  */
  79 #define SO_DEBUG        0x0001          /* turn on debugging info recording */
  80 #define SO_ACCEPTCONN   0x0002          /* socket has had listen() */
  81 #define SO_REUSEADDR    0x0004          /* allow local address reuse */
  82 #define SO_KEEPALIVE    0x0008          /* keep connections alive */
  83 #define SO_DONTROUTE    0x0010          /* just use interface addresses */
  84 #define SO_BROADCAST    0x0020          /* permit sending of broadcast msgs */
  85 #define SO_USELOOPBACK  0x0040          /* bypass hardware when possible */
  86 #define SO_LINGER       0x0080          /* linger on close if data present */
  87 #define SO_OOBINLINE    0x0100          /* leave received OOB data in line */
  88 #define SO_REUSEPORT    0x0200          /* allow local address & port reuse */
  89 #define SO_TIMESTAMP    0x0400          /* timestamp received dgram traffic */
  90
  91 #define SO_DONTTRUNC    0x2000          /* APPLE: Retain unread data */
  92                                         /*  (ATOMIC proto) */
  93 #define SO_WANTMORE     0x4000          /* APPLE: Give hint when more data ready */
  94 #define SO_WANTOOBFLAG  0x8000          /* APPLE: Want OOB in MSG_FLAG on receive */
  95
  96 /*
  97  * Additional options, not kept in so_options.
  98  */
  99 #define SO_SNDBUF       0x1001          /* send buffer size */
 100 #define SO_RCVBUF       0x1002          /* receive buffer size */
 101 #define SO_SNDLOWAT     0x1003          /* send low-water mark */
 102 #define SO_RCVLOWAT     0x1004          /* receive low-water mark */
 103 #define SO_SNDTIMEO     0x1005          /* send timeout */
 104 #define SO_RCVTIMEO     0x1006          /* receive timeout */
 105 #define SO_ERROR        0x1007          /* get error status and clear */
 106 #define SO_TYPE         0x1008          /* get socket type */
 107 #define SO_PRIVSTATE    0x1009          /* get/deny privileged state */
 108 #define SO_NREAD        0x1020          /* APPLE: get 1st-packet byte count */
 109 #define SO_NKE          0x1021          /* APPLE: Install socket-level NKE */
 110
 111 /*
 112  * Structure used for manipulating linger option.
 113  */
 114 struct  linger {
 115         int     l_onoff;                /* option on/off */
 116         int     l_linger;               /* linger time */
 117 };
 118
 119 /*
 120  * Level number for (get/set)sockopt() to apply to socket itself.
 121  */
 122 #define SOL_SOCKET      0xffff          /* options for socket level */
 123
 124 /*
 125  * Address families.
 126  */
 127 #define AF_UNSPEC       0               /* unspecified */
 128 #define AF_LOCAL        1               /* local to host (pipes, portals) */
 129 #define AF_UNIX         AF_LOCAL        /* backward compatibility */
 130 #define AF_INET         2               /* internetwork: UDP, TCP, etc. */
 131 #define AF_IMPLINK      3               /* arpanet imp addresses */
 132 #define AF_PUP          4               /* pup protocols: e.g. BSP */
 133 #define AF_CHAOS        5               /* mit CHAOS protocols */
 134 #define AF_NS           6               /* XEROX NS protocols */
 135 #define AF_ISO          7               /* ISO protocols */
 136 #define AF_OSI          AF_ISO
 137 #define AF_ECMA         8               /* european computer manufacturers */
 138 #define AF_DATAKIT      9               /* datakit protocols */
 139 #define AF_CCITT        10              /* CCITT protocols, X.25 etc */
 140 #define AF_SNA          11              /* IBM SNA */
 141 #define AF_DECnet       12              /* DECnet */
 142 #define AF_DLI          13              /* DEC Direct data link interface */
 143 #define AF_LAT          14              /* LAT */
 144 #define AF_HYLINK       15              /* NSC Hyperchannel */
 145 #define AF_APPLETALK    16              /* Apple Talk */
 146 #define AF_ROUTE        17              /* Internal Routing Protocol */
 147 #define AF_LINK         18              /* Link layer interface */
 148 #define pseudo_AF_XTP   19              /* eXpress Transfer Protocol (no AF) */
 149 #define AF_COIP         20              /* connection-oriented IP, aka ST II */
 150 #define AF_CNT          21              /* Computer Network Technology */
 151 #define pseudo_AF_RTIP  22              /* Help Identify RTIP packets */
 152 #define AF_IPX          23              /* Novell Internet Protocol */
 153 #define AF_SIP          24              /* Simple Internet Protocol */
 154 #define pseudo_AF_PIP   25              /* Help Identify PIP packets */
 155                                         /* Sigh - The following 2 should */
 156                                         /*  be maintained for MacOSX */
 157                                         /*  binary compatibility */
 158 #define pseudo_AF_BLUE  26              /* Identify packets for Blue Box */
 159 #define AF_NDRV         27              /* Network Driver 'raw' access */
 160 #define AF_ISDN         28              /* Integrated Services Digital Network*/
 161 #define AF_E164         AF_ISDN         /* CCITT E.164 recommendation */
 162 #define pseudo_AF_KEY   29              /* Internal key-management function */
 163 #define AF_INET6        30              /* IPv6 */
 164 #define AF_NATM         31              /* native ATM access */
 165 #define AF_SYSTEM       32              /* Kernel event messages */
 166 #define AF_NETBIOS      33              /* NetBIOS */
 167 #define AF_PPP          34              /* PPP communication protocol */
 168
 169 #define AF_MAX          35
 170
 171 /*
 172  * Structure used by kernel to store most
 173  * addresses.
 174  */
 175 struct sockaddr {
 176         u_char  sa_len;                 /* total length */
 177         u_char  sa_family;              /* address family */
 178         char    sa_data[14];            /* actually longer; address value */
 179 };
 180 #define SOCK_MAXADDRLEN 255             /* longest possible addresses */
 181
 182 /*
 183  * Structure used by kernel to pass protocol
 184  * information in raw sockets.
 185  */
 186 struct sockproto {
 187         u_short sp_family;              /* address family */
 188         u_short sp_protocol;            /* protocol */
 189 };
 190
 191 #if 1
 192 /*
 193  * bsd-api-new-02a: protocol-independent placeholder for socket addresses
 194  */
 195 #define _SS_MAXSIZE     128
 196 #define _SS_ALIGNSIZE   (sizeof(int64_t))
 197 #define _SS_PAD1SIZE    (_SS_ALIGNSIZE - sizeof(u_char) * 2)
 198 #define _SS_PAD2SIZE    (_SS_MAXSIZE - sizeof(u_char) * 2 - \
 199                                 _SS_PAD1SIZE - _SS_ALIGNSIZE)
 200
 201 struct sockaddr_storage {
 202         u_char ss_len;          /* address length */
 203         u_char ss_family;       /* address family */
 204         char _ss_pad1[_SS_PAD1SIZE];
 205         int64_t _ss_align;      /* force desired structure storage alignment */
 206         char _ss_pad2[_SS_PAD2SIZE];
 207 };
 208 #endif
 209
 210 /*
 211  * Protocol families, same as address families for now.
 212  */
 213 #define PF_UNSPEC       AF_UNSPEC
 214 #define PF_LOCAL        AF_LOCAL
 215 #define PF_UNIX         PF_LOCAL        /* backward compatibility */
 216 #define PF_INET         AF_INET
 217 #define PF_INET6        AF_INET6
 218 #define PF_IMPLINK      AF_IMPLINK
 219 #define PF_PUP          AF_PUP
 220 #define PF_CHAOS        AF_CHAOS
 221 #define PF_NS           AF_NS
 222 #define PF_ISO          AF_ISO
 223 #define PF_OSI          AF_ISO
 224 #define PF_ECMA         AF_ECMA
 225 #define PF_DATAKIT      AF_DATAKIT
 226 #define PF_CCITT        AF_CCITT
 227 #define PF_SNA          AF_SNA
 228 #define PF_DECnet       AF_DECnet
 229 #define PF_DLI          AF_DLI
 230 #define PF_LAT          AF_LAT
 231 #define PF_HYLINK       AF_HYLINK
 232 #define PF_APPLETALK    AF_APPLETALK
 233 #define PF_ROUTE        AF_ROUTE
 234 #define PF_LINK         AF_LINK
 235 #define PF_XTP          pseudo_AF_XTP   /* really just proto family, no AF */
 236 #define PF_COIP         AF_COIP
 237 #define PF_CNT          AF_CNT
 238 #define PF_SIP          AF_SIP
 239 #define PF_IPX          AF_IPX          /* same format as AF_NS */
 240 #define PF_RTIP         pseudo_AF_RTIP  /* same format as AF_INET */
 241 #define PF_PIP          pseudo_AF_PIP
 242
 243 #define PF_NDRV         AF_NDRV
 244 #define PF_ISDN         AF_ISDN
 245 #define PF_KEY          pseudo_AF_KEY
 246 #define PF_INET6        AF_INET6
 247 #define PF_NATM         AF_NATM
 248 #define PF_ATM          AF_ATM
 249 #define PF_SYSTEM       AF_SYSTEM
 250 #define PF_NETBIOS      AF_NETBIOS
 251 #define PF_PPP          AF_PPP
 252
 253 #define PF_MAX          AF_MAX
 254
 255 /*
 256  * Definitions for network related sysctl, CTL_NET.
 257  *
 258  * Second level is protocol family.
 259  * Third level is protocol number.
 260  *
 261  * Further levels are defined by the individual families below.
 262  */
 263 #define NET_MAXID       AF_MAX
 264
 265 #define CTL_NET_NAMES { \
 266         { 0, 0 }, \
 267         { "local", CTLTYPE_NODE }, \
 268         { "inet", CTLTYPE_NODE }, \
 269         { "implink", CTLTYPE_NODE }, \
 270         { "pup", CTLTYPE_NODE }, \
 271         { "chaos", CTLTYPE_NODE }, \
 272         { "xerox_ns", CTLTYPE_NODE }, \
 273         { "iso", CTLTYPE_NODE }, \
 274         { "emca", CTLTYPE_NODE }, \
 275         { "datakit", CTLTYPE_NODE }, \
 276         { "ccitt", CTLTYPE_NODE }, \
 277         { "ibm_sna", CTLTYPE_NODE }, \
 278         { "decnet", CTLTYPE_NODE }, \
 279         { "dec_dli", CTLTYPE_NODE }, \
 280         { "lat", CTLTYPE_NODE }, \
 281         { "hylink", CTLTYPE_NODE }, \
 282         { "appletalk", CTLTYPE_NODE }, \
 283         { "route", CTLTYPE_NODE }, \
 284         { "link_layer", CTLTYPE_NODE }, \
 285         { "xtp", CTLTYPE_NODE }, \
 286         { "coip", CTLTYPE_NODE }, \
 287         { "cnt", CTLTYPE_NODE }, \
 288         { "rtip", CTLTYPE_NODE }, \
 289         { "ipx", CTLTYPE_NODE }, \
 290         { "sip", CTLTYPE_NODE }, \
 291         { "pip", CTLTYPE_NODE }, \
 292         { "isdn", CTLTYPE_NODE }, \
 293         { "key", CTLTYPE_NODE }, \
 294         { "inet6", CTLTYPE_NODE }, \
 295         { "natm", CTLTYPE_NODE }, \
 296 }
 297
 298 /*
 299  * PF_ROUTE - Routing table
 300  *
 301  * Three additional levels are defined:
 302  *      Fourth: address family, 0 is wildcard
 303  *      Fifth: type of info, defined below
 304  *      Sixth: flag(s) to mask with for NET_RT_FLAGS
 305  */
 306 #define NET_RT_DUMP     1               /* dump; may limit to a.f. */
 307 #define NET_RT_FLAGS    2               /* by flags, e.g. RESOLVING */
 308 #define NET_RT_IFLIST   3               /* survey interface list */
 309 #define NET_RT_MAXID    4
 310
 311 #define CTL_NET_RT_NAMES { \
 312         { 0, 0 }, \
 313         { "dump", CTLTYPE_STRUCT }, \
 314         { "flags", CTLTYPE_STRUCT }, \
 315         { "iflist", CTLTYPE_STRUCT }, \
 316 }
 317
 318 /*
 319  * Maximum queue length specifiable by listen.
 320  */
 321 #define SOMAXCONN       128
 322
 323 /*
 324  * Message header for recvmsg and sendmsg calls.
 325  * Used value-result for recvmsg, value only for sendmsg.
 326  */
 327 struct msghdr {
 328         caddr_t msg_name;               /* optional address */
 329         u_int   msg_namelen;            /* size of address */
 330         struct  iovec *msg_iov;         /* scatter/gather array */
 331         u_int   msg_iovlen;             /* # elements in msg_iov */
 332         caddr_t msg_control;            /* ancillary data, see below */
 333         u_int   msg_controllen;         /* ancillary data buffer len */
 334         int     msg_flags;              /* flags on received message */
 335 };
 336
 337 #define MSG_OOB         0x1             /* process out-of-band data */
 338 #define MSG_PEEK        0x2             /* peek at incoming message */
 339 #define MSG_DONTROUTE   0x4             /* send without using routing tables */
 340 #define MSG_EOR         0x8             /* data completes record */
 341 #define MSG_TRUNC       0x10            /* data discarded before delivery */
 342 #define MSG_CTRUNC      0x20            /* control data lost before delivery */
 343 #define MSG_WAITALL     0x40            /* wait for full request or error */
 344 #define MSG_DONTWAIT    0x80            /* this message should be nonblocking */
 345 #define MSG_EOF         0x100           /* data completes connection */
 346 #define MSG_FLUSH       0x400           /* Start of 'hold' seq; dump so_temp */
 347 #define MSG_HOLD        0x800           /* Hold frag in so_temp */
 348 #define MSG_SEND        0x1000          /* Send the packet in so_temp */
 349 #define MSG_HAVEMORE    0x2000          /* Data ready to be read */
 350 #define MSG_RCVMORE     0x4000          /* Data remains in current pkt */
 351 #define MSG_COMPAT      0x8000          /* used in sendit() */
 352
 353 /*
 354  * Header for ancillary data objects in msg_control buffer.
 355  * Used for additional information with/about a datagram
 356  * not expressible by flags.  The format is a sequence
 357  * of message elements headed by cmsghdr structures.
 358  */
 359 struct cmsghdr {
 360         u_int   cmsg_len;               /* data byte count, including hdr */
 361         int     cmsg_level;             /* originating protocol */
 362         int     cmsg_type;              /* protocol-specific type */
 363 /* followed by  u_char  cmsg_data[]; */
 364 };
 365
 366 /* given pointer to struct cmsghdr, return pointer to data */
 367 #define CMSG_DATA(cmsg)         ((u_char *)((cmsg) + 1))
 368
 369 /* Alignment requirement for CMSG struct manipulation.
 370  * This is different from ALIGN() defined in ARCH/include/param.h.
 371  * XXX think again carefully about architecture dependencies.
 372  */
 373 #define CMSG_ALIGN(n)           (((n) + 3) & ~3)
 374
 375 /* given pointer to struct cmsghdr, return pointer to next cmsghdr */
 376 #define CMSG_NXTHDR(mhdr, cmsg) \
 377         (((caddr_t)(cmsg) + (cmsg)->cmsg_len + sizeof(struct cmsghdr) > \
 378             (mhdr)->msg_control + (mhdr)->msg_controllen) ? \
 379             (struct cmsghdr *)NULL : \
 380             (struct cmsghdr *)((caddr_t)(cmsg) + CMSG_ALIGN((cmsg)->cmsg_len)))
 381
 382 #define CMSG_FIRSTHDR(mhdr)     ((struct cmsghdr *)(mhdr)->msg_control)
 383
 384 #define CMSG_SPACE(l)   (CMSG_ALIGN(sizeof(struct cmsghdr)) + CMSG_ALIGN(l))
 385 #define CMSG_LEN(l)     (CMSG_ALIGN(sizeof(struct cmsghdr)) + (l))
 386
 387 /* "Socket"-level control message types: */
 388 #define SCM_RIGHTS      0x01            /* access rights (array of int) */
 389 #define SCM_TIMESTAMP   0x02            /* timestamp (struct timeval) */
 390 #define SCM_CREDS       0x03            /* process creds (struct cmsgcred) */
 391
 392 /*
 393  * 4.3 compat sockaddr, move to compat file later
 394  */
 395 struct osockaddr {
 396         u_short sa_family;              /* address family */
 397         char    sa_data[14];            /* up to 14 bytes of direct address */
 398 };
 399
 400 /*
 401  * 4.3-compat message header (move to compat file later).
 402  */
 403 struct omsghdr {
 404         caddr_t msg_name;               /* optional address */
 405         int     msg_namelen;            /* size of address */
 406         struct  iovec *msg_iov;         /* scatter/gather array */
 407         int     msg_iovlen;             /* # elements in msg_iov */
 408         caddr_t msg_accrights;          /* access rights sent/received */
 409         int     msg_accrightslen;
 410 };
 411
 412 /*
 413  * howto arguments for shutdown(2), specified by Posix.1g.
 414  */
 415 #define SHUT_RD         0               /* shut down the reading side */
 416 #define SHUT_WR         1               /* shut down the writing side */
 417 #define SHUT_RDWR       2               /* shut down both sides */
 418
 419 #if SENDFILE
 420 /*
 421  * sendfile(2) header/trailer struct
 422  */
 423 struct sf_hdtr {
 424         struct iovec *headers;  /* pointer to an array of header struct iovec's */
 425         int hdr_cnt;            /* number of header iovec's */
 426         struct iovec *trailers; /* pointer to an array of trailer struct iovec's */
 427         int trl_cnt;            /* number of trailer iovec's */
 428 };
 429 #endif
 430
 431 #ifndef KERNEL
 432
 433 #include <sys/cdefs.h>
 434
 435 __BEGIN_DECLS
 436 int     accept __P((int, struct sockaddr *, int *));
 437 int     bind __P((int, const struct sockaddr *, int));
 438 int     connect __P((int, const struct sockaddr *, int));
 439 int     getpeername __P((int, struct sockaddr *, int *));
 440 int     getsockname __P((int, struct sockaddr *, int *));
 441 int     getsockopt __P((int, int, int, void *, int *));
 442 int     listen __P((int, int));
 443 ssize_t recv __P((int, void *, size_t, int));
 444 ssize_t recvfrom __P((int, void *, size_t, int, struct sockaddr *, int *));
 445 ssize_t recvmsg __P((int, struct msghdr *, int));
 446 ssize_t send __P((int, const void *, size_t, int));
 447 ssize_t sendto __P((int, const void *,
 448             size_t, int, const struct sockaddr *, int));
 449 ssize_t sendmsg __P((int, const struct msghdr *, int));
 450 #if SENDFILE
 451 int     sendfile __P((int, int, off_t, size_t, struct sf_hdtr *, off_t *, int));
 452 #endif
 453 int     setsockopt __P((int, int, int, const void *, int));
 454 int     shutdown __P((int, int));
 455 int     socket __P((int, int, int));
 456 int     socketpair __P((int, int, int, int *));
 457 __END_DECLS
 458
 459 #endif /* !KERNEL */
 460 #endif /* !_SYS_SOCKET_H_ */