349 lines
12 KiB
C
349 lines
12 KiB
C
/* Declarations of socket constants, types, and functions.
|
|
Copyright (C) 1991-2022 Free Software Foundation, Inc.
|
|
This file is part of the GNU C Library.
|
|
|
|
The GNU C Library is free software; you can redistribute it and/or
|
|
modify it under the terms of the GNU Lesser General Public
|
|
License as published by the Free Software Foundation; either
|
|
version 2.1 of the License, or (at your option) any later version.
|
|
|
|
The GNU C Library is distributed in the hope that it will be useful,
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
Lesser General Public License for more details.
|
|
|
|
You should have received a copy of the GNU Lesser General Public
|
|
License along with the GNU C Library; if not, see
|
|
<https://www.gnu.org/licenses/>. */
|
|
|
|
#ifndef _SYS_SOCKET_H
|
|
#define _SYS_SOCKET_H 1
|
|
|
|
#include <features.h>
|
|
|
|
__BEGIN_DECLS
|
|
|
|
#include <bits/types/struct_iovec.h>
|
|
#define __need_size_t
|
|
#include <stddef.h>
|
|
|
|
/* This operating system-specific header file defines the SOCK_*, PF_*,
|
|
AF_*, MSG_*, SOL_*, and SO_* constants, and the `struct sockaddr',
|
|
`struct msghdr', and `struct linger' types. */
|
|
#include <bits/socket.h>
|
|
|
|
#ifdef __USE_MISC
|
|
# include <bits/types/struct_osockaddr.h>
|
|
#endif
|
|
|
|
/* The following constants should be used for the second parameter of
|
|
`shutdown'. */
|
|
enum
|
|
{
|
|
SHUT_RD = 0, /* No more receptions. */
|
|
#define SHUT_RD SHUT_RD
|
|
SHUT_WR, /* No more transmissions. */
|
|
#define SHUT_WR SHUT_WR
|
|
SHUT_RDWR /* No more receptions or transmissions. */
|
|
#define SHUT_RDWR SHUT_RDWR
|
|
};
|
|
|
|
/* This is the type we use for generic socket address arguments.
|
|
|
|
With GCC 2.7 and later, the funky union causes redeclarations or
|
|
uses with any of the listed types to be allowed without complaint.
|
|
G++ 2.7 does not support transparent unions so there we want the
|
|
old-style declaration, too. */
|
|
#if defined __cplusplus || !__GNUC_PREREQ (2, 7) || !defined __USE_GNU
|
|
# define __SOCKADDR_ARG struct sockaddr *__restrict
|
|
# define __CONST_SOCKADDR_ARG const struct sockaddr *
|
|
#else
|
|
/* Add more `struct sockaddr_AF' types here as necessary.
|
|
These are all the ones I found on NetBSD and Linux. */
|
|
# define __SOCKADDR_ALLTYPES \
|
|
__SOCKADDR_ONETYPE (sockaddr) \
|
|
__SOCKADDR_ONETYPE (sockaddr_at) \
|
|
__SOCKADDR_ONETYPE (sockaddr_ax25) \
|
|
__SOCKADDR_ONETYPE (sockaddr_dl) \
|
|
__SOCKADDR_ONETYPE (sockaddr_eon) \
|
|
__SOCKADDR_ONETYPE (sockaddr_in) \
|
|
__SOCKADDR_ONETYPE (sockaddr_in6) \
|
|
__SOCKADDR_ONETYPE (sockaddr_inarp) \
|
|
__SOCKADDR_ONETYPE (sockaddr_ipx) \
|
|
__SOCKADDR_ONETYPE (sockaddr_iso) \
|
|
__SOCKADDR_ONETYPE (sockaddr_ns) \
|
|
__SOCKADDR_ONETYPE (sockaddr_un) \
|
|
__SOCKADDR_ONETYPE (sockaddr_x25)
|
|
|
|
# define __SOCKADDR_ONETYPE(type) struct type *__restrict __##type##__;
|
|
typedef union { __SOCKADDR_ALLTYPES
|
|
} __SOCKADDR_ARG __attribute__ ((__transparent_union__));
|
|
# undef __SOCKADDR_ONETYPE
|
|
# define __SOCKADDR_ONETYPE(type) const struct type *__restrict __##type##__;
|
|
typedef union { __SOCKADDR_ALLTYPES
|
|
} __CONST_SOCKADDR_ARG __attribute__ ((__transparent_union__));
|
|
# undef __SOCKADDR_ONETYPE
|
|
#endif
|
|
|
|
#ifdef __USE_GNU
|
|
/* For `recvmmsg' and `sendmmsg'. */
|
|
struct mmsghdr
|
|
{
|
|
struct msghdr msg_hdr; /* Actual message header. */
|
|
unsigned int msg_len; /* Number of received or sent bytes for the
|
|
entry. */
|
|
};
|
|
#endif
|
|
|
|
|
|
/* Create a new socket of type TYPE in domain DOMAIN, using
|
|
protocol PROTOCOL. If PROTOCOL is zero, one is chosen automatically.
|
|
Returns a file descriptor for the new socket, or -1 for errors. */
|
|
extern int socket (int __domain, int __type, int __protocol) __THROW;
|
|
|
|
/* Create two new sockets, of type TYPE in domain DOMAIN and using
|
|
protocol PROTOCOL, which are connected to each other, and put file
|
|
descriptors for them in FDS[0] and FDS[1]. If PROTOCOL is zero,
|
|
one will be chosen automatically. Returns 0 on success, -1 for errors. */
|
|
extern int socketpair (int __domain, int __type, int __protocol,
|
|
int __fds[2]) __THROW;
|
|
|
|
/* Give the socket FD the local address ADDR (which is LEN bytes long). */
|
|
extern int bind (int __fd, __CONST_SOCKADDR_ARG __addr, socklen_t __len)
|
|
__THROW;
|
|
|
|
/* Put the local address of FD into *ADDR and its length in *LEN. */
|
|
extern int getsockname (int __fd, __SOCKADDR_ARG __addr,
|
|
socklen_t *__restrict __len) __THROW;
|
|
|
|
/* Open a connection on socket FD to peer at ADDR (which LEN bytes long).
|
|
For connectionless socket types, just set the default address to send to
|
|
and the only address from which to accept transmissions.
|
|
Return 0 on success, -1 for errors.
|
|
|
|
This function is a cancellation point and therefore not marked with
|
|
__THROW. */
|
|
extern int connect (int __fd, __CONST_SOCKADDR_ARG __addr, socklen_t __len);
|
|
|
|
/* Put the address of the peer connected to socket FD into *ADDR
|
|
(which is *LEN bytes long), and its actual length into *LEN. */
|
|
extern int getpeername (int __fd, __SOCKADDR_ARG __addr,
|
|
socklen_t *__restrict __len) __THROW;
|
|
|
|
|
|
/* Send N bytes of BUF to socket FD. Returns the number sent or -1.
|
|
|
|
This function is a cancellation point and therefore not marked with
|
|
__THROW. */
|
|
extern ssize_t send (int __fd, const void *__buf, size_t __n, int __flags);
|
|
|
|
/* Read N bytes into BUF from socket FD.
|
|
Returns the number read or -1 for errors.
|
|
|
|
This function is a cancellation point and therefore not marked with
|
|
__THROW. */
|
|
extern ssize_t recv (int __fd, void *__buf, size_t __n, int __flags);
|
|
|
|
/* Send N bytes of BUF on socket FD to peer at address ADDR (which is
|
|
ADDR_LEN bytes long). Returns the number sent, or -1 for errors.
|
|
|
|
This function is a cancellation point and therefore not marked with
|
|
__THROW. */
|
|
extern ssize_t sendto (int __fd, const void *__buf, size_t __n,
|
|
int __flags, __CONST_SOCKADDR_ARG __addr,
|
|
socklen_t __addr_len);
|
|
|
|
/* Read N bytes into BUF through socket FD.
|
|
If ADDR is not NULL, fill in *ADDR_LEN bytes of it with tha address of
|
|
the sender, and store the actual size of the address in *ADDR_LEN.
|
|
Returns the number of bytes read or -1 for errors.
|
|
|
|
This function is a cancellation point and therefore not marked with
|
|
__THROW. */
|
|
extern ssize_t recvfrom (int __fd, void *__restrict __buf, size_t __n,
|
|
int __flags, __SOCKADDR_ARG __addr,
|
|
socklen_t *__restrict __addr_len);
|
|
|
|
|
|
/* Send a message described MESSAGE on socket FD.
|
|
Returns the number of bytes sent, or -1 for errors.
|
|
|
|
This function is a cancellation point and therefore not marked with
|
|
__THROW. */
|
|
#ifndef __USE_TIME_BITS64
|
|
extern ssize_t sendmsg (int __fd, const struct msghdr *__message,
|
|
int __flags);
|
|
#else
|
|
# ifdef __REDIRECT
|
|
extern ssize_t __REDIRECT (sendmsg, (int __fd, const struct msghdr *__message,
|
|
int __flags),
|
|
__sendmsg64);
|
|
# else
|
|
extern ssize_t __sendmsg64 (int __fd, const struct msghdr *__message,
|
|
int __flags);
|
|
# define sendmsg __sendmsg64
|
|
# endif
|
|
#endif
|
|
|
|
#ifdef __USE_GNU
|
|
/* Send a VLEN messages as described by VMESSAGES to socket FD.
|
|
Returns the number of datagrams successfully written or -1 for errors.
|
|
|
|
This function is a cancellation point and therefore not marked with
|
|
__THROW. */
|
|
# ifndef __USE_TIME_BITS64
|
|
extern int sendmmsg (int __fd, struct mmsghdr *__vmessages,
|
|
unsigned int __vlen, int __flags);
|
|
# else
|
|
# ifdef __REDIRECT
|
|
extern int __REDIRECT (sendmmsg, (int __fd, struct mmsghdr *__vmessages,
|
|
unsigned int __vlen, int __flags),
|
|
__sendmmsg64);
|
|
# else
|
|
extern int __sendmmsg64 (int __fd, struct mmsghdr *__vmessages,
|
|
unsigned int __vlen, int __flags);
|
|
# define sendmmsg __sendmmsg64
|
|
# endif
|
|
# endif /* __USE_TIME_BITS64 */
|
|
#endif /* __USE_GNU */
|
|
|
|
/* Receive a message as described by MESSAGE from socket FD.
|
|
Returns the number of bytes read or -1 for errors.
|
|
|
|
This function is a cancellation point and therefore not marked with
|
|
__THROW. */
|
|
#ifndef __USE_TIME_BITS64
|
|
extern ssize_t recvmsg (int __fd, struct msghdr *__message, int __flags);
|
|
#else
|
|
# ifdef __REDIRECT
|
|
extern ssize_t __REDIRECT (recvmsg,
|
|
(int __fd, struct msghdr *__message, int __flags),
|
|
__recvmsg64);
|
|
# else
|
|
extern ssize_t __recvmsg64 (int __fd, struct msghdr *__message, int __flags);
|
|
# define recvmsg __recvmsg64
|
|
# endif
|
|
#endif
|
|
|
|
#ifdef __USE_GNU
|
|
/* Receive up to VLEN messages as described by VMESSAGES from socket FD.
|
|
Returns the number of messages received or -1 for errors.
|
|
|
|
This function is a cancellation point and therefore not marked with
|
|
__THROW. */
|
|
# ifndef __USE_TIME_BITS64
|
|
extern int recvmmsg (int __fd, struct mmsghdr *__vmessages,
|
|
unsigned int __vlen, int __flags,
|
|
struct timespec *__tmo);
|
|
# else
|
|
# ifdef __REDIRECT
|
|
extern int __REDIRECT (recvmmsg, (int __fd, struct mmsghdr *__vmessages,
|
|
unsigned int __vlen, int __flags,
|
|
struct timespec *__tmo),
|
|
__recvmmsg64);
|
|
# else
|
|
# define recvmmsg __recvmmsg64
|
|
# endif
|
|
# endif
|
|
#endif
|
|
|
|
|
|
/* Put the current value for socket FD's option OPTNAME at protocol level LEVEL
|
|
into OPTVAL (which is *OPTLEN bytes long), and set *OPTLEN to the value's
|
|
actual length. Returns 0 on success, -1 for errors. */
|
|
#ifndef __USE_TIME_BITS64
|
|
extern int getsockopt (int __fd, int __level, int __optname,
|
|
void *__restrict __optval,
|
|
socklen_t *__restrict __optlen) __THROW;
|
|
#else
|
|
# ifdef __REDIRECT
|
|
extern int __REDIRECT_NTH (getsockopt,
|
|
(int __fd, int __level, int __optname,
|
|
void *__restrict __optval,
|
|
socklen_t *__restrict __optlen),
|
|
__getsockopt64);
|
|
# else
|
|
extern int __getsockopt64 (int __fd, int __level, int __optname,
|
|
void *__restrict __optval,
|
|
socklen_t *__restrict __optlen) __THROW;
|
|
# define getsockopt __getsockopt64
|
|
# endif
|
|
#endif
|
|
|
|
/* Set socket FD's option OPTNAME at protocol level LEVEL
|
|
to *OPTVAL (which is OPTLEN bytes long).
|
|
Returns 0 on success, -1 for errors. */
|
|
#ifndef __USE_TIME_BITS64
|
|
extern int setsockopt (int __fd, int __level, int __optname,
|
|
const void *__optval, socklen_t __optlen) __THROW;
|
|
#else
|
|
# ifdef __REDIRECT
|
|
extern int __REDIRECT_NTH (setsockopt,
|
|
(int __fd, int __level, int __optname,
|
|
const void *__optval, socklen_t __optlen),
|
|
__setsockopt64);
|
|
# else
|
|
extern int __setsockopt64 (int __fd, int __level, int __optname,
|
|
const void *__optval, socklen_t __optlen) __THROW;
|
|
# define setsockopt __setsockopt64
|
|
# endif
|
|
#endif
|
|
|
|
|
|
/* Prepare to accept connections on socket FD.
|
|
N connection requests will be queued before further requests are refused.
|
|
Returns 0 on success, -1 for errors. */
|
|
extern int listen (int __fd, int __n) __THROW;
|
|
|
|
/* Await a connection on socket FD.
|
|
When a connection arrives, open a new socket to communicate with it,
|
|
set *ADDR (which is *ADDR_LEN bytes long) to the address of the connecting
|
|
peer and *ADDR_LEN to the address's actual length, and return the
|
|
new socket's descriptor, or -1 for errors.
|
|
|
|
This function is a cancellation point and therefore not marked with
|
|
__THROW. */
|
|
extern int accept (int __fd, __SOCKADDR_ARG __addr,
|
|
socklen_t *__restrict __addr_len);
|
|
|
|
#ifdef __USE_GNU
|
|
/* Similar to 'accept' but takes an additional parameter to specify flags.
|
|
|
|
This function is a cancellation point and therefore not marked with
|
|
__THROW. */
|
|
extern int accept4 (int __fd, __SOCKADDR_ARG __addr,
|
|
socklen_t *__restrict __addr_len, int __flags);
|
|
#endif
|
|
|
|
/* Shut down all or part of the connection open on socket FD.
|
|
HOW determines what to shut down:
|
|
SHUT_RD = No more receptions;
|
|
SHUT_WR = No more transmissions;
|
|
SHUT_RDWR = No more receptions or transmissions.
|
|
Returns 0 on success, -1 for errors. */
|
|
extern int shutdown (int __fd, int __how) __THROW;
|
|
|
|
|
|
#ifdef __USE_XOPEN2K
|
|
/* Determine whether socket is at a out-of-band mark. */
|
|
extern int sockatmark (int __fd) __THROW;
|
|
#endif
|
|
|
|
|
|
#ifdef __USE_MISC
|
|
/* FDTYPE is S_IFSOCK or another S_IF* macro defined in <sys/stat.h>;
|
|
returns 1 if FD is open on an object of the indicated type, 0 if not,
|
|
or -1 for errors (setting errno). */
|
|
extern int isfdtype (int __fd, int __fdtype) __THROW;
|
|
#endif
|
|
|
|
|
|
/* Define some macros helping to catch buffer overflows. */
|
|
#if __USE_FORTIFY_LEVEL > 0 && defined __fortify_function
|
|
# include <bits/socket2.h>
|
|
#endif
|
|
|
|
__END_DECLS
|
|
|
|
#endif /* sys/socket.h */
|