1 /*- 2 * SPDX-License-Identifier: BSD-3-Clause 3 * 4 * Copyright (c) 1982, 1985, 1986, 1988, 1993, 1994 5 * The Regents of the University of California. All rights reserved. 6 * 7 * Redistribution and use in source and binary forms, with or without 8 * modification, are permitted provided that the following conditions 9 * are met: 10 * 1. Redistributions of source code must retain the above copyright 11 * notice, this list of conditions and the following disclaimer. 12 * 2. Redistributions in binary form must reproduce the above copyright 13 * notice, this list of conditions and the following disclaimer in the 14 * documentation and/or other materials provided with the distribution. 15 * 3. Neither the name of the University nor the names of its contributors 16 * may be used to endorse or promote products derived from this software 17 * without specific prior written permission. 18 * 19 * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND 20 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 21 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 22 * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE 23 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 24 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 25 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 26 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 27 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 28 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 29 * SUCH DAMAGE. 30 */ 31 32 #ifndef _SYS_SOCKET_H_ 33 #define _SYS_SOCKET_H_ 34 35 #include <sys/cdefs.h> 36 #include <sys/_types.h> 37 #include <sys/_iovec.h> 38 #include <sys/_timeval.h> 39 #include <sys/_align.h> 40 41 /* 42 * Definitions related to sockets: types, address families, options. 43 */ 44 45 /* 46 * Data types. 47 */ 48 #if __BSD_VISIBLE 49 #ifndef _GID_T_DECLARED 50 typedef __gid_t gid_t; 51 #define _GID_T_DECLARED 52 #endif 53 54 #ifndef _OFF_T_DECLARED 55 typedef __off_t off_t; 56 #define _OFF_T_DECLARED 57 #endif 58 59 #ifndef _PID_T_DECLARED 60 typedef __pid_t pid_t; 61 #define _PID_T_DECLARED 62 #endif 63 #endif 64 65 #ifndef _SA_FAMILY_T_DECLARED 66 typedef __sa_family_t sa_family_t; 67 #define _SA_FAMILY_T_DECLARED 68 #endif 69 70 #ifndef _SOCKLEN_T_DECLARED 71 typedef __socklen_t socklen_t; 72 #define _SOCKLEN_T_DECLARED 73 #endif 74 75 #ifndef _SSIZE_T_DECLARED 76 typedef __ssize_t ssize_t; 77 #define _SSIZE_T_DECLARED 78 #endif 79 80 #if __BSD_VISIBLE 81 #ifndef _UID_T_DECLARED 82 typedef __uid_t uid_t; 83 #define _UID_T_DECLARED 84 #endif 85 #endif 86 87 #ifndef _UINT32_T_DECLARED 88 typedef __uint32_t uint32_t; 89 #define _UINT32_T_DECLARED 90 #endif 91 92 #ifndef _UINTPTR_T_DECLARED 93 typedef __uintptr_t uintptr_t; 94 #define _UINTPTR_T_DECLARED 95 #endif 96 97 /* 98 * Types 99 */ 100 #define SOCK_STREAM 1 /* stream socket */ 101 #define SOCK_DGRAM 2 /* datagram socket */ 102 #define SOCK_RAW 3 /* raw-protocol interface */ 103 #if __BSD_VISIBLE 104 #define SOCK_RDM 4 /* reliably-delivered message */ 105 #endif 106 #define SOCK_SEQPACKET 5 /* sequenced packet stream */ 107 108 #if __BSD_VISIBLE 109 /* 110 * Creation flags, OR'ed into socket() and socketpair() type argument. 111 */ 112 #define SOCK_CLOEXEC 0x10000000 113 #define SOCK_NONBLOCK 0x20000000 114 #define SOCK_CLOFORK 0x40000000 115 #ifdef _KERNEL 116 /* 117 * Flags for accept1(), kern_accept4() and solisten_dequeue, in addition 118 * to SOCK_CLOEXEC, SOCK_CLOFORK and SOCK_NONBLOCK. 119 */ 120 #define ACCEPT4_INHERIT 0x1 121 #define ACCEPT4_COMPAT 0x2 122 #endif /* _KERNEL */ 123 #endif /* __BSD_VISIBLE */ 124 125 /* 126 * Option flags per-socket. 127 */ 128 #define SO_DEBUG 0x00000001 /* int; turn on debugging info recording */ 129 #define SO_ACCEPTCONN 0x00000002 /* int; socket has had listen() */ 130 #define SO_REUSEADDR 0x00000004 /* int; allow local address reuse */ 131 #define SO_KEEPALIVE 0x00000008 /* int; keep connections alive */ 132 #define SO_DONTROUTE 0x00000010 /* int; just use interface addresses */ 133 #define SO_BROADCAST 0x00000020 /* int; permit sending of broadcast msgs */ 134 #if __BSD_VISIBLE 135 #define SO_USELOOPBACK 0x00000040 /* int; bypass hardware when possible */ 136 #endif 137 #define SO_LINGER 0x00000080 /* struct linger; linger on close if data present */ 138 #define SO_OOBINLINE 0x00000100 /* int; leave received OOB data in line */ 139 #if __BSD_VISIBLE 140 #define SO_REUSEPORT 0x00000200 /* int; allow local address & port reuse */ 141 #define SO_TIMESTAMP 0x00000400 /* int; timestamp received dgram traffic */ 142 #define SO_NOSIGPIPE 0x00000800 /* int; no SIGPIPE from EPIPE */ 143 #define SO_ACCEPTFILTER 0x00001000 /* struct accept_filter_arg; accept filter */ 144 #define SO_BINTIME 0x00002000 /* int; timestamp received dgram traffic */ 145 #endif 146 #define SO_NO_OFFLOAD 0x00004000 /* int; socket cannot be offloaded */ 147 #define SO_NO_DDP 0x00008000 /* int; disable direct data placement */ 148 #define SO_REUSEPORT_LB 0x00010000 /* int; reuse with load balancing */ 149 #define SO_RERROR 0x00020000 /* int; keep track of receive errors */ 150 #define SO_PASSRIGHTS 0x00040000 /* int; unix(4) accepts SCM_RIGHTS */ 151 152 /* 153 * Additional options, not kept in so_options. 154 */ 155 #define SO_SNDBUF 0x1001 /* int; send buffer size */ 156 #define SO_RCVBUF 0x1002 /* int; receive buffer size */ 157 #define SO_SNDLOWAT 0x1003 /* int; send low-water mark */ 158 #define SO_RCVLOWAT 0x1004 /* int; receive low-water mark */ 159 #define SO_SNDTIMEO 0x1005 /* struct timeval; send timeout */ 160 #define SO_RCVTIMEO 0x1006 /* struct timeval; receive timeout */ 161 #define SO_ERROR 0x1007 /* int; get error status and clear */ 162 #define SO_TYPE 0x1008 /* int; get socket type */ 163 #if __BSD_VISIBLE 164 #define SO_LABEL 0x1009 /* socket's MAC label */ 165 #define SO_PEERLABEL 0x1010 /* socket's peer's MAC label */ 166 #define SO_LISTENQLIMIT 0x1011 /* int; socket's backlog limit */ 167 #define SO_LISTENQLEN 0x1012 /* int; socket's complete queue length */ 168 #define SO_LISTENINCQLEN 0x1013 /* int; socket's incomplete queue length */ 169 #define SO_FIB 0x1014 /* int; get or set socket FIB */ 170 #define SO_SETFIB SO_FIB /* backward compat alias */ 171 #define SO_USER_COOKIE 0x1015 /* uint32_t; user cookie (dummynet etc.) */ 172 #define SO_PROTOCOL 0x1016 /* int; get socket protocol (Linux name) */ 173 #define SO_PROTOTYPE SO_PROTOCOL /* alias for SO_PROTOCOL (SunOS name) */ 174 #define SO_TS_CLOCK 0x1017 /* int; clock type used for SO_TIMESTAMP */ 175 #define SO_MAX_PACING_RATE 0x1018 /* uint32_t; socket's max TX pacing rate (Linux name) */ 176 #define SO_DOMAIN 0x1019 /* int; get socket domain */ 177 #define SO_SPLICE 0x1023 /* struct splice; splice data to other socket */ 178 #endif 179 180 #if __BSD_VISIBLE 181 #define SO_TS_REALTIME_MICRO 0 /* microsecond resolution, realtime */ 182 #define SO_TS_BINTIME 1 /* sub-nanosecond resolution, realtime */ 183 #define SO_TS_REALTIME 2 /* nanosecond resolution, realtime */ 184 #define SO_TS_MONOTONIC 3 /* nanosecond resolution, monotonic */ 185 #define SO_TS_DEFAULT SO_TS_REALTIME_MICRO 186 #define SO_TS_CLOCK_MAX SO_TS_MONOTONIC 187 #endif 188 189 /* 190 * Space reserved for new socket options added by third-party vendors. 191 * This range applies to all socket option levels. New socket options 192 * in FreeBSD should always use an option value less than SO_VENDOR. 193 */ 194 #if __BSD_VISIBLE 195 #define SO_VENDOR 0x80000000 196 #endif 197 198 /* 199 * Structure used for manipulating linger option. 200 */ 201 struct linger { 202 int l_onoff; /* option on/off */ 203 int l_linger; /* linger time */ 204 }; 205 206 #if __BSD_VISIBLE 207 struct accept_filter_arg { 208 char af_name[16]; 209 char af_arg[256-16]; 210 }; 211 #endif 212 213 /* 214 * Level number for (get/set)sockopt() to apply to socket itself. 215 */ 216 #define SOL_SOCKET 0xffff /* options for socket level */ 217 218 /* 219 * Address families. 220 */ 221 #define AF_UNSPEC 0 /* unspecified */ 222 #if __BSD_VISIBLE 223 #define AF_LOCAL AF_UNIX /* local to host (pipes, portals) */ 224 #endif 225 #define AF_UNIX 1 /* standardized name for AF_LOCAL */ 226 #define AF_INET 2 /* internetwork: UDP, TCP, etc. */ 227 #if __BSD_VISIBLE 228 #define AF_IMPLINK 3 /* arpanet imp addresses */ 229 #define AF_PUP 4 /* pup protocols: e.g. BSP */ 230 #define AF_CHAOS 5 /* mit CHAOS protocols */ 231 #define AF_NETBIOS 6 /* SMB protocols */ 232 #define AF_ISO 7 /* ISO protocols */ 233 #define AF_OSI AF_ISO 234 #define AF_ECMA 8 /* European computer manufacturers */ 235 #define AF_DATAKIT 9 /* datakit protocols */ 236 #define AF_CCITT 10 /* CCITT protocols, X.25 etc */ 237 #define AF_SNA 11 /* IBM SNA */ 238 #define AF_DECnet 12 /* DECnet */ 239 #define AF_DLI 13 /* DEC Direct data link interface */ 240 #define AF_LAT 14 /* LAT */ 241 #define AF_HYLINK 15 /* NSC Hyperchannel */ 242 #define AF_APPLETALK 16 /* Apple Talk */ 243 #define AF_ROUTE 17 /* Internal Routing Protocol */ 244 #define AF_LINK 18 /* Link layer interface */ 245 #define pseudo_AF_XTP 19 /* eXpress Transfer Protocol (no AF) */ 246 #define AF_COIP 20 /* connection-oriented IP, aka ST II */ 247 #define AF_CNT 21 /* Computer Network Technology */ 248 #define pseudo_AF_RTIP 22 /* Help Identify RTIP packets */ 249 #define AF_IPX 23 /* Novell Internet Protocol */ 250 #define AF_SIP 24 /* Simple Internet Protocol */ 251 #define pseudo_AF_PIP 25 /* Help Identify PIP packets */ 252 #define AF_ISDN 26 /* Integrated Services Digital Network*/ 253 #define AF_E164 AF_ISDN /* CCITT E.164 recommendation */ 254 #define pseudo_AF_KEY 27 /* Internal key-management function */ 255 #endif 256 #define AF_INET6 28 /* IPv6 */ 257 #if __BSD_VISIBLE 258 #define AF_NATM 29 /* native ATM access */ 259 #define AF_ATM 30 /* ATM */ 260 #define pseudo_AF_HDRCMPLT 31 /* Used by BPF to not rewrite headers 261 * in interface output routine 262 */ 263 #define AF_NETGRAPH 32 /* Netgraph sockets */ 264 #define AF_SLOW 33 /* 802.3ad slow protocol */ 265 #define AF_SCLUSTER 34 /* Sitara cluster protocol */ 266 #define AF_ARP 35 267 #define AF_BLUETOOTH 36 /* Bluetooth sockets */ 268 #define AF_IEEE80211 37 /* IEEE 802.11 protocol */ 269 #define AF_NETLINK 38 /* Netlink protocol */ 270 #define AF_INET_SDP 40 /* OFED Socket Direct Protocol ipv4 */ 271 #define AF_INET6_SDP 42 /* OFED Socket Direct Protocol ipv6 */ 272 #define AF_HYPERV 43 /* HyperV sockets */ 273 #define AF_DIVERT 44 /* divert(4) */ 274 #define AF_IPFWLOG 46 275 276 #define AF_MAX 47 277 278 /* 279 * When allocating a new AF_ constant, please only allocate 280 * even numbered constants for FreeBSD until 134 as odd numbered AF_ 281 * constants 39-133 are now reserved for vendors. 282 */ 283 #define AF_VENDOR00 39 284 #define AF_VENDOR01 41 285 #define AF_VENDOR03 45 286 #define AF_VENDOR04 47 287 #define AF_VENDOR05 49 288 #define AF_VENDOR06 51 289 #define AF_VENDOR07 53 290 #define AF_VENDOR08 55 291 #define AF_VENDOR09 57 292 #define AF_VENDOR10 59 293 #define AF_VENDOR11 61 294 #define AF_VENDOR12 63 295 #define AF_VENDOR13 65 296 #define AF_VENDOR14 67 297 #define AF_VENDOR15 69 298 #define AF_VENDOR16 71 299 #define AF_VENDOR17 73 300 #define AF_VENDOR18 75 301 #define AF_VENDOR19 77 302 #define AF_VENDOR20 79 303 #define AF_VENDOR21 81 304 #define AF_VENDOR22 83 305 #define AF_VENDOR23 85 306 #define AF_VENDOR24 87 307 #define AF_VENDOR25 89 308 #define AF_VENDOR26 91 309 #define AF_VENDOR27 93 310 #define AF_VENDOR28 95 311 #define AF_VENDOR29 97 312 #define AF_VENDOR30 99 313 #define AF_VENDOR31 101 314 #define AF_VENDOR32 103 315 #define AF_VENDOR33 105 316 #define AF_VENDOR34 107 317 #define AF_VENDOR35 109 318 #define AF_VENDOR36 111 319 #define AF_VENDOR37 113 320 #define AF_VENDOR38 115 321 #define AF_VENDOR39 117 322 #define AF_VENDOR40 119 323 #define AF_VENDOR41 121 324 #define AF_VENDOR42 123 325 #define AF_VENDOR43 125 326 #define AF_VENDOR44 127 327 #define AF_VENDOR45 129 328 #define AF_VENDOR46 131 329 #define AF_VENDOR47 133 330 #endif 331 332 /* 333 * Structure used by kernel to store most 334 * addresses. 335 */ 336 struct sockaddr { 337 unsigned char sa_len; /* total length */ 338 sa_family_t sa_family; /* address family */ 339 char sa_data[14]; /* actually longer; address value */ 340 }; 341 #if __BSD_VISIBLE 342 #define SOCK_MAXADDRLEN 255 /* longest possible addresses */ 343 344 /* 345 * Structure used by kernel to pass protocol 346 * information in raw sockets. 347 */ 348 struct sockproto { 349 unsigned short sp_family; /* address family */ 350 unsigned short sp_protocol; /* protocol */ 351 }; 352 #endif 353 354 #include <sys/_sockaddr_storage.h> 355 356 #if __BSD_VISIBLE 357 /* 358 * Protocol families, same as address families for now. 359 */ 360 #define PF_UNSPEC AF_UNSPEC 361 #define PF_LOCAL AF_LOCAL 362 #define PF_UNIX PF_LOCAL /* backward compatibility */ 363 #define PF_INET AF_INET 364 #define PF_IMPLINK AF_IMPLINK 365 #define PF_PUP AF_PUP 366 #define PF_CHAOS AF_CHAOS 367 #define PF_NETBIOS AF_NETBIOS 368 #define PF_ISO AF_ISO 369 #define PF_OSI AF_ISO 370 #define PF_ECMA AF_ECMA 371 #define PF_DATAKIT AF_DATAKIT 372 #define PF_CCITT AF_CCITT 373 #define PF_SNA AF_SNA 374 #define PF_DECnet AF_DECnet 375 #define PF_DLI AF_DLI 376 #define PF_LAT AF_LAT 377 #define PF_HYLINK AF_HYLINK 378 #define PF_APPLETALK AF_APPLETALK 379 #define PF_ROUTE AF_ROUTE 380 #define PF_LINK AF_LINK 381 #define PF_XTP pseudo_AF_XTP /* really just proto family, no AF */ 382 #define PF_COIP AF_COIP 383 #define PF_CNT AF_CNT 384 #define PF_SIP AF_SIP 385 #define PF_IPX AF_IPX 386 #define PF_RTIP pseudo_AF_RTIP /* same format as AF_INET */ 387 #define PF_PIP pseudo_AF_PIP 388 #define PF_ISDN AF_ISDN 389 #define PF_KEY pseudo_AF_KEY 390 #define PF_INET6 AF_INET6 391 #define PF_NATM AF_NATM 392 #define PF_ATM AF_ATM 393 #define PF_NETGRAPH AF_NETGRAPH 394 #define PF_SLOW AF_SLOW 395 #define PF_SCLUSTER AF_SCLUSTER 396 #define PF_ARP AF_ARP 397 #define PF_BLUETOOTH AF_BLUETOOTH 398 #define PF_IEEE80211 AF_IEEE80211 399 #define PF_NETLINK AF_NETLINK 400 #define PF_INET_SDP AF_INET_SDP 401 #define PF_INET6_SDP AF_INET6_SDP 402 #define PF_HYPERV AF_HYPERV 403 #define PF_DIVERT AF_DIVERT 404 #define PF_IPFWLOG AF_IPFWLOG 405 406 #define PF_MAX AF_MAX 407 408 /* 409 * Definitions for network related sysctl, CTL_NET. 410 * 411 * Second level is protocol family. 412 * Third level is protocol number. 413 * 414 * Further levels are defined by the individual families. 415 */ 416 417 /* 418 * PF_ROUTE - Routing table 419 * 420 * Three additional levels are defined: 421 * Fourth: address family, 0 is wildcard 422 * Fifth: type of info, defined below 423 * Sixth: flag(s) to mask with for NET_RT_FLAGS 424 */ 425 #define NET_RT_DUMP 1 /* dump; may limit to a.f. */ 426 #define NET_RT_FLAGS 2 /* by flags, e.g. RESOLVING */ 427 #define NET_RT_IFLIST 3 /* survey interface list */ 428 #define NET_RT_IFMALIST 4 /* return multicast address list */ 429 #define NET_RT_IFLISTL 5 /* Survey interface list, using 'l'en 430 * versions of msghdr structs. */ 431 #define NET_RT_NHOP 6 /* dump routing nexthops */ 432 #define NET_RT_NHGRP 7 /* dump routing nexthop groups */ 433 #endif /* __BSD_VISIBLE */ 434 435 /* 436 * Maximum queue length specifiable by listen. 437 */ 438 #define SOMAXCONN 128 439 440 /* 441 * Message header for recvmsg and sendmsg calls. 442 * Used value-result for recvmsg, value only for sendmsg. 443 */ 444 struct msghdr { 445 void *msg_name; /* optional address */ 446 socklen_t msg_namelen; /* size of address */ 447 struct iovec *msg_iov; /* scatter/gather array */ 448 int msg_iovlen; /* # elements in msg_iov */ 449 void *msg_control; /* ancillary data, see below */ 450 socklen_t msg_controllen; /* ancillary data buffer len */ 451 int msg_flags; /* flags on received message */ 452 }; 453 454 #define MSG_OOB 0x00000001 /* process out-of-band data */ 455 #define MSG_PEEK 0x00000002 /* peek at incoming message */ 456 #define MSG_DONTROUTE 0x00000004 /* send without using routing tables */ 457 #define MSG_EOR 0x00000008 /* data completes record */ 458 #define MSG_TRUNC 0x00000010 /* data discarded before delivery */ 459 #define MSG_CTRUNC 0x00000020 /* control data lost before delivery */ 460 #define MSG_WAITALL 0x00000040 /* wait for full request or error */ 461 #if __BSD_VISIBLE 462 #define MSG_DONTWAIT 0x00000080 /* this message should be nonblocking */ 463 #define MSG_EOF 0x00000100 /* data completes connection */ 464 /* 0x00000200 unused */ 465 /* 0x00000400 unused */ 466 /* 0x00000800 unused */ 467 /* 0x00001000 unused */ 468 #define MSG_NOTIFICATION 0x00002000 /* SCTP notification */ 469 #define MSG_NBIO 0x00004000 /* FIONBIO mode, used by fifofs */ 470 #define MSG_COMPAT 0x00008000 /* used in sendit() */ 471 #endif 472 #ifdef _KERNEL 473 #define MSG_SOCALLBCK 0x00010000 /* for use by socket callbacks - soreceive (TCP) */ 474 #endif 475 #if __POSIX_VISIBLE >= 200809 476 #define MSG_NOSIGNAL 0x00020000 /* do not generate SIGPIPE on EOF */ 477 #endif 478 #if __BSD_VISIBLE 479 #define MSG_CMSG_CLOEXEC 0x00040000 /* make received fds close-on-exec */ 480 #define MSG_WAITFORONE 0x00080000 /* for recvmmsg() */ 481 #endif 482 #ifdef _KERNEL 483 #define MSG_MORETOCOME 0x00100000 /* additional data pending */ 484 #define MSG_TLSAPPDATA 0x00200000 /* do not soreceive() alert rec. (TLS) */ 485 #endif 486 #if __BSD_VISIBLE 487 #define MSG_CMSG_CLOFORK 0x00400000 /* make received fds close-on-fork */ 488 #endif 489 490 /* 491 * Header for ancillary data objects in msg_control buffer. 492 * Used for additional information with/about a datagram 493 * not expressible by flags. The format is a sequence 494 * of message elements headed by cmsghdr structures. 495 */ 496 struct cmsghdr { 497 socklen_t cmsg_len; /* data byte count, including hdr */ 498 int cmsg_level; /* originating protocol */ 499 int cmsg_type; /* protocol-specific type */ 500 /* followed by u_char cmsg_data[]; */ 501 }; 502 503 #if __BSD_VISIBLE 504 /* 505 * While we may have more groups than this, the cmsgcred struct must 506 * be able to fit in an mbuf and we have historically supported a 507 * maximum of 16 groups. 508 */ 509 #define CMGROUP_MAX 16 510 511 /* 512 * Credentials structure, used to verify the identity of a peer 513 * process that has sent us a message. This is allocated by the 514 * peer process but filled in by the kernel. This prevents the 515 * peer from lying about its identity. (Note that cmcred_groups[0] 516 * is the effective GID.) 517 */ 518 struct cmsgcred { 519 pid_t cmcred_pid; /* PID of sending process */ 520 uid_t cmcred_uid; /* real UID of sending process */ 521 uid_t cmcred_euid; /* effective UID of sending process */ 522 gid_t cmcred_gid; /* real GID of sending process */ 523 short cmcred_ngroups; /* number or groups */ 524 gid_t cmcred_groups[CMGROUP_MAX]; /* groups */ 525 }; 526 527 /* 528 * Socket credentials (LOCAL_CREDS). 529 */ 530 struct sockcred { 531 uid_t sc_uid; /* real user id */ 532 uid_t sc_euid; /* effective user id */ 533 gid_t sc_gid; /* real group id */ 534 gid_t sc_egid; /* effective group id */ 535 int sc_ngroups; /* number of supplemental groups */ 536 gid_t sc_groups[1]; /* variable length */ 537 }; 538 539 /* 540 * Compute size of a sockcred structure with groups. 541 */ 542 #define SOCKCREDSIZE(ngrps) \ 543 (sizeof(struct sockcred) + (sizeof(gid_t) * ((ngrps) - 1))) 544 545 /* 546 * Socket credentials (LOCAL_CREDS_PERSISTENT). 547 */ 548 struct sockcred2 { 549 int sc_version; /* version of this structure */ 550 pid_t sc_pid; /* PID of sending process */ 551 uid_t sc_uid; /* real user id */ 552 uid_t sc_euid; /* effective user id */ 553 gid_t sc_gid; /* real group id */ 554 gid_t sc_egid; /* effective group id */ 555 int sc_ngroups; /* number of supplemental groups */ 556 gid_t sc_groups[1]; /* variable length */ 557 }; 558 #define SOCKCRED2SIZE(ngrps) \ 559 (sizeof(struct sockcred2) + (sizeof(gid_t) * ((ngrps) - 1))) 560 561 #endif /* __BSD_VISIBLE */ 562 563 /* given pointer to struct cmsghdr, return pointer to data */ 564 #define CMSG_DATA(cmsg) ((unsigned char *)(cmsg) + \ 565 _ALIGN(sizeof(struct cmsghdr))) 566 567 /* given pointer to struct cmsghdr, return pointer to next cmsghdr */ 568 #define CMSG_NXTHDR(mhdr, cmsg) \ 569 ((char *)(cmsg) == (char *)0 ? CMSG_FIRSTHDR(mhdr) : \ 570 ((char *)(cmsg) + _ALIGN(((struct cmsghdr *)(cmsg))->cmsg_len) + \ 571 _ALIGN(sizeof(struct cmsghdr)) > \ 572 (char *)(mhdr)->msg_control + (mhdr)->msg_controllen) ? \ 573 (struct cmsghdr *)0 : \ 574 (struct cmsghdr *)(void *)((char *)(cmsg) + \ 575 _ALIGN(((struct cmsghdr *)(cmsg))->cmsg_len))) 576 577 /* 578 * RFC 2292 requires to check msg_controllen, in case that the kernel returns 579 * an empty list for some reasons. 580 */ 581 #define CMSG_FIRSTHDR(mhdr) \ 582 ((mhdr)->msg_controllen >= sizeof(struct cmsghdr) ? \ 583 (struct cmsghdr *)(mhdr)->msg_control : \ 584 (struct cmsghdr *)0) 585 586 #if __BSD_VISIBLE 587 /* RFC 2292 additions */ 588 #define CMSG_SPACE(l) (_ALIGN(sizeof(struct cmsghdr)) + _ALIGN(l)) 589 #define CMSG_LEN(l) (_ALIGN(sizeof(struct cmsghdr)) + (l)) 590 #endif 591 592 #ifdef _KERNEL 593 #define CMSG_ALIGN(n) _ALIGN(n) 594 #endif 595 596 /* "Socket"-level control message types: */ 597 #define SCM_RIGHTS 0x01 /* access rights (array of int) */ 598 #if __BSD_VISIBLE 599 #define SCM_TIMESTAMP 0x02 /* timestamp (struct timeval) */ 600 #define SCM_CREDS 0x03 /* process creds (struct cmsgcred) */ 601 #define SCM_BINTIME 0x04 /* timestamp (struct bintime) */ 602 #define SCM_REALTIME 0x05 /* timestamp (struct timespec) */ 603 #define SCM_MONOTONIC 0x06 /* timestamp (struct timespec) */ 604 #define SCM_TIME_INFO 0x07 /* timestamp info */ 605 #define SCM_CREDS2 0x08 /* process creds (struct sockcred2) */ 606 607 struct sock_timestamp_info { 608 __uint32_t st_info_flags; 609 __uint32_t st_info_pad0; 610 __uint64_t st_info_rsv[7]; 611 }; 612 613 #define ST_INFO_HW 0x0001 /* SCM_TIMESTAMP was hw */ 614 #define ST_INFO_HW_HPREC 0x0002 /* SCM_TIMESTAMP was hw-assisted 615 on entrance */ 616 #endif 617 618 #if __BSD_VISIBLE 619 /* 620 * 4.3 compat sockaddr, move to compat file later 621 */ 622 struct osockaddr { 623 unsigned short sa_family; /* address family */ 624 char sa_data[14]; /* up to 14 bytes of direct address */ 625 }; 626 627 /* 628 * 4.3-compat message header (move to compat file later). 629 */ 630 struct omsghdr { 631 char *msg_name; /* optional address */ 632 int msg_namelen; /* size of address */ 633 struct iovec *msg_iov; /* scatter/gather array */ 634 int msg_iovlen; /* # elements in msg_iov */ 635 char *msg_accrights; /* access rights sent/received */ 636 int msg_accrightslen; 637 }; 638 #endif 639 640 /* 641 * howto arguments for shutdown(2), specified by Posix.1g. 642 */ 643 enum shutdown_how { 644 SHUT_RD = 0, /* shut down the reading side */ 645 #define SHUT_RD SHUT_RD 646 SHUT_WR, /* shut down the writing side */ 647 #define SHUT_WR SHUT_WR 648 SHUT_RDWR /* shut down both sides */ 649 #define SHUT_RDWR SHUT_RDWR 650 }; 651 652 #if __BSD_VISIBLE 653 /* 654 * sendfile(2) header/trailer struct 655 */ 656 struct sf_hdtr { 657 struct iovec *headers; /* pointer to an array of header struct iovec's */ 658 int hdr_cnt; /* number of header iovec's */ 659 struct iovec *trailers; /* pointer to an array of trailer struct iovec's */ 660 int trl_cnt; /* number of trailer iovec's */ 661 }; 662 663 /* 664 * Sendfile-specific flag(s) 665 */ 666 #define SF_NODISKIO 0x00000001 667 #define SF_MNOWAIT 0x00000002 /* obsolete */ 668 /* was SF_SYNC 0x00000004 */ 669 #define SF_USER_READAHEAD 0x00000008 670 #define SF_NOCACHE 0x00000010 671 #define SF_FLAGS(rh, flags) (((rh) << 16) | (flags)) 672 673 #ifdef _KERNEL 674 #define SF_READAHEAD(flags) ((flags) >> 16) 675 #endif /* _KERNEL */ 676 677 /* 678 * Sendmmsg/recvmmsg specific structure(s) 679 */ 680 struct mmsghdr { 681 struct msghdr msg_hdr; /* message header */ 682 ssize_t msg_len; /* message length */ 683 }; 684 685 /* 686 * Structure used for manipulating splice option. 687 */ 688 struct splice { 689 int sp_fd; /* drain socket file descriptor */ 690 off_t sp_max; /* if set, maximum bytes to splice */ 691 struct timeval sp_idle; /* idle timeout */ 692 }; 693 694 #endif /* __BSD_VISIBLE */ 695 696 #ifndef _KERNEL 697 698 #if defined(_FORTIFY_SOURCE) && _FORTIFY_SOURCE > 0 699 #include <ssp/socket.h> 700 #endif 701 702 #include <sys/cdefs.h> 703 704 __BEGIN_DECLS 705 int accept(int, struct sockaddr * __restrict, socklen_t * __restrict); 706 int bind(int, const struct sockaddr *, socklen_t); 707 int connect(int, const struct sockaddr *, socklen_t); 708 #if __BSD_VISIBLE 709 int accept4(int, struct sockaddr * __restrict, socklen_t * __restrict, int); 710 int bindat(int, int, const struct sockaddr *, socklen_t); 711 int connectat(int, int, const struct sockaddr *, socklen_t); 712 #endif 713 int getpeername(int, struct sockaddr * __restrict, socklen_t * __restrict); 714 int getsockname(int, struct sockaddr * __restrict, socklen_t * __restrict); 715 int getsockopt(int, int, int, void * __restrict, socklen_t * __restrict); 716 int listen(int, int); 717 ssize_t recv(int, void *, size_t, int); 718 ssize_t recvfrom(int, void *, size_t, int, struct sockaddr * __restrict, socklen_t * __restrict); 719 ssize_t recvmsg(int, struct msghdr *, int); 720 #if __BSD_VISIBLE 721 struct timespec; 722 ssize_t recvmmsg(int, struct mmsghdr * __restrict, size_t, int, 723 const struct timespec * __restrict); 724 #endif 725 ssize_t send(int, const void *, size_t, int); 726 ssize_t sendto(int, const void *, 727 size_t, int, const struct sockaddr *, socklen_t); 728 ssize_t sendmsg(int, const struct msghdr *, int); 729 #if __BSD_VISIBLE 730 int sendfile(int, int, off_t, size_t, struct sf_hdtr *, off_t *, int); 731 ssize_t sendmmsg(int, struct mmsghdr * __restrict, size_t, int); 732 int setfib(int); 733 #endif 734 int setsockopt(int, int, int, const void *, socklen_t); 735 int shutdown(int, int); 736 int sockatmark(int); 737 int socket(int, int, int); 738 int socketpair(int, int, int, int *); 739 __END_DECLS 740 741 #endif /* !_KERNEL */ 742 743 #ifdef _KERNEL 744 struct socket; 745 746 int so_options_get(const struct socket *); 747 void so_options_set(struct socket *, int); 748 749 int so_error_get(const struct socket *); 750 void so_error_set(struct socket *, int); 751 #endif /* _KERNEL */ 752 #endif /* !_SYS_SOCKET_H_ */ 753