1 /* SPDX-License-Identifier: LGPL-2.1+ */
5 This file is part of systemd.
7 Copyright 2010 Lennart Poettering
9 systemd is free software; you can redistribute it and/or modify it
10 under the terms of the GNU Lesser General Public License as published by
11 the Free Software Foundation; either version 2.1 of the License, or
12 (at your option) any later version.
14 systemd is distributed in the hope that it will be useful, but
15 WITHOUT ANY WARRANTY; without even the implied warranty of
16 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
17 Lesser General Public License for more details.
19 You should have received a copy of the GNU Lesser General Public License
20 along with systemd; If not, see <http://www.gnu.org/licenses/>.
23 #include <netinet/ether.h>
24 #include <netinet/in.h>
27 #include <sys/socket.h>
28 #include <sys/types.h>
30 #include <linux/netlink.h>
31 #include <linux/if_infiniband.h>
32 #include <linux/if_packet.h>
38 union sockaddr_union {
39 /* The minimal, abstract version */
42 /* The libc provided version that allocates "enough room" for every protocol */
43 struct sockaddr_storage storage;
45 /* Protoctol-specific implementations */
46 struct sockaddr_in in;
47 struct sockaddr_in6 in6;
48 struct sockaddr_un un;
49 #if 0 /// UNNEEDED by elogind, only 'sa', 'in', 'in6' and 'un' are used in all of elogind.
50 struct sockaddr_nl nl;
51 struct sockaddr_ll ll;
52 struct sockaddr_vm vm;
55 /* Ensure there is enough space to store Infiniband addresses */
56 uint8_t ll_buffer[offsetof(struct sockaddr_ll, sll_addr) + CONST_MAX(ETH_ALEN, INFINIBAND_ALEN)];
58 /* Ensure there is enough space after the AF_UNIX sun_path for one more NUL byte, just to be sure that the path
59 * component is always followed by at least one NUL byte. */
60 uint8_t un_buffer[sizeof(struct sockaddr_un) + 1];
63 #if 0 /// UNNEEDED by elogind
64 typedef struct SocketAddress {
65 union sockaddr_union sockaddr;
67 /* We store the size here explicitly due to the weird
68 * sockaddr_un semantics for abstract sockets */
71 /* Socket type, i.e. SOCK_STREAM, SOCK_DGRAM, ... */
74 /* Socket protocol, IPPROTO_xxx, usually 0, except for netlink */
78 typedef enum SocketAddressBindIPv6Only {
79 SOCKET_ADDRESS_DEFAULT,
81 SOCKET_ADDRESS_IPV6_ONLY,
82 _SOCKET_ADDRESS_BIND_IPV6_ONLY_MAX,
83 _SOCKET_ADDRESS_BIND_IPV6_ONLY_INVALID = -1
84 } SocketAddressBindIPv6Only;
86 #define socket_address_family(a) ((a)->sockaddr.sa.sa_family)
88 const char* socket_address_type_to_string(int t) _const_;
89 int socket_address_type_from_string(const char *s) _pure_;
91 int socket_address_parse(SocketAddress *a, const char *s);
92 int socket_address_parse_and_warn(SocketAddress *a, const char *s);
93 int socket_address_parse_netlink(SocketAddress *a, const char *s);
94 int socket_address_print(const SocketAddress *a, char **p);
95 int socket_address_verify(const SocketAddress *a) _pure_;
96 int socket_address_unlink(SocketAddress *a);
98 bool socket_address_can_accept(const SocketAddress *a) _pure_;
100 int socket_address_listen(
101 const SocketAddress *a,
104 SocketAddressBindIPv6Only only,
105 const char *bind_to_device,
109 mode_t directory_mode,
112 int make_socket_fd(int log_level, const char* address, int type, int flags);
114 bool socket_address_is(const SocketAddress *a, const char *s, int type);
115 bool socket_address_is_netlink(const SocketAddress *a, const char *s);
117 bool socket_address_matches_fd(const SocketAddress *a, int fd);
119 bool socket_address_equal(const SocketAddress *a, const SocketAddress *b) _pure_;
121 const char* socket_address_get_path(const SocketAddress *a);
123 bool socket_ipv6_is_supported(void);
125 int sockaddr_port(const struct sockaddr *_sa, unsigned *port);
127 int sockaddr_pretty(const struct sockaddr *_sa, socklen_t salen, bool translate_ipv6, bool include_port, char **ret);
128 int getpeername_pretty(int fd, bool include_port, char **ret);
129 int getsockname_pretty(int fd, char **ret);
131 int socknameinfo_pretty(union sockaddr_union *sa, socklen_t salen, char **_ret);
133 const char* socket_address_bind_ipv6_only_to_string(SocketAddressBindIPv6Only b) _const_;
134 SocketAddressBindIPv6Only socket_address_bind_ipv6_only_from_string(const char *s) _pure_;
135 SocketAddressBindIPv6Only parse_socket_address_bind_ipv6_only_or_bool(const char *s);
137 int netlink_family_to_string_alloc(int b, char **s);
138 int netlink_family_from_string(const char *s) _pure_;
140 bool sockaddr_equal(const union sockaddr_union *a, const union sockaddr_union *b);
143 int fd_inc_sndbuf(int fd, size_t n);
144 int fd_inc_rcvbuf(int fd, size_t n);
145 #if 0 /// UNNEEDED by elogind
147 int ip_tos_to_string_alloc(int i, char **s);
148 int ip_tos_from_string(const char *s);
150 bool ifname_valid(const char *p);
151 bool address_label_valid(const char *p);
154 int getpeercred(int fd, struct ucred *ucred);
155 int getpeersec(int fd, char **ret);
156 int getpeergroups(int fd, gid_t **ret);
158 int send_one_fd_sa(int transport_fd,
160 const struct sockaddr *sa, socklen_t len,
162 #define send_one_fd(transport_fd, fd, flags) send_one_fd_sa(transport_fd, fd, NULL, 0, flags)
163 #if 0 /// UNNEEDED by elogind
164 int receive_one_fd(int transport_fd, int flags);
166 ssize_t next_datagram_size_fd(int fd);
168 int flush_accept(int fd);
171 #define CMSG_FOREACH(cmsg, mh) \
172 for ((cmsg) = CMSG_FIRSTHDR(mh); (cmsg); (cmsg) = CMSG_NXTHDR((mh), (cmsg)))
174 #if 0 /// UNNEEDED by elogind
175 struct cmsghdr* cmsg_find(struct msghdr *mh, int level, int type, socklen_t length);
179 * Certain hardware address types (e.g Infiniband) do not fit into sll_addr
180 * (8 bytes) and run over the structure. This macro returns the correct size that
181 * must be passed to kernel.
183 #define SOCKADDR_LL_LEN(sa) \
185 const struct sockaddr_ll *_sa = &(sa); \
186 size_t _mac_len = sizeof(_sa->sll_addr); \
187 assert(_sa->sll_family == AF_PACKET); \
188 if (be16toh(_sa->sll_hatype) == ARPHRD_ETHER) \
189 _mac_len = MAX(_mac_len, (size_t) ETH_ALEN); \
190 if (be16toh(_sa->sll_hatype) == ARPHRD_INFINIBAND) \
191 _mac_len = MAX(_mac_len, (size_t) INFINIBAND_ALEN); \
192 offsetof(struct sockaddr_ll, sll_addr) + _mac_len; \
195 /* Covers only file system and abstract AF_UNIX socket addresses, but not unnamed socket addresses. */
196 #define SOCKADDR_UN_LEN(sa) \
198 const struct sockaddr_un *_sa = &(sa); \
199 assert(_sa->sun_family == AF_UNIX); \
200 offsetof(struct sockaddr_un, sun_path) + \
201 (_sa->sun_path[0] == 0 ? \
202 1 + strnlen(_sa->sun_path+1, sizeof(_sa->sun_path)-1) : \
203 strnlen(_sa->sun_path, sizeof(_sa->sun_path))); \
206 #if 0 /// UNNEEDED by elogind
207 int socket_ioctl_fd(void);