libosmocore 1.9.0.67-be3c3.202311292026
Osmocom core library
socket.h
Go to the documentation of this file.
1
4#pragma once
5#if (!EMBEDDED)
6
11#include <stdint.h>
12#include <stdbool.h>
13#include <stddef.h>
14
15#include <arpa/inet.h>
16
17#include <osmocom/core/defs.h>
18
20#define OSMO_SOCK_NAME_MAXLEN (2 + INET6_ADDRSTRLEN + 1 + 5 + 3 + 2 + INET6_ADDRSTRLEN + 1 + 5 + 1)
21
22struct sockaddr_in;
23struct sockaddr;
24struct osmo_fd;
25
27 union {
28 struct sockaddr sa;
29 struct sockaddr_storage sas;
30 struct sockaddr_in sin;
31 struct sockaddr_in6 sin6;
32 } u;
33};
34
35int osmo_sockaddr_is_local(struct sockaddr *addr, unsigned int addrlen);
36int osmo_sockaddr_is_any(const struct osmo_sockaddr *addr);
37
46static inline socklen_t osmo_sockaddr_size(const struct osmo_sockaddr *addr)
47{
48 if (!addr)
49 return 0;
50
51 switch (addr->u.sa.sa_family) {
52 case AF_INET:
53 return sizeof(struct sockaddr_in);
54 case AF_INET6:
55 return sizeof(struct sockaddr_in6);
56 default:
57 return sizeof(struct osmo_sockaddr);
58 }
59}
60
61unsigned int osmo_sockaddr_to_str_and_uint(char *addr, unsigned int addr_len, uint16_t *port,
62 const struct sockaddr *sa);
63size_t osmo_sockaddr_in_to_str_and_uint(char *addr, unsigned int addr_len, uint16_t *port,
64 const struct sockaddr_in *sin);
65
66const char *osmo_sockaddr_ntop(const struct sockaddr *sa, char *dst);
67uint16_t osmo_sockaddr_port(const struct sockaddr *sa);
68void osmo_sockaddr_set_port(struct sockaddr *sa, uint16_t port);
69
71 const struct osmo_sockaddr *remote_ip);
72int osmo_sockaddr_cmp(const struct osmo_sockaddr *a,
73 const struct osmo_sockaddr *b);
74
75int osmo_sockaddr_to_octets(uint8_t *dst, size_t dst_maxlen, const struct osmo_sockaddr *os);
76int osmo_sockaddr_from_octets(struct osmo_sockaddr *os, const void *src, size_t src_len);
77int osmo_sockaddr_from_str_and_uint(struct osmo_sockaddr *osa_out, const char *ipstr, uint16_t port);
78
80
81const char *osmo_sockaddr_to_str(const struct osmo_sockaddr *sockaddr);
82char *osmo_sockaddr_to_str_buf(char *buf, size_t buf_len,
83 const struct osmo_sockaddr *sockaddr);
84int osmo_sockaddr_to_str_buf2(char *buf, size_t buf_len, const struct osmo_sockaddr *sockaddr);
85char *osmo_sockaddr_to_str_c(void *ctx, const struct osmo_sockaddr *sockaddr);
86
87/* flags for osmo_sock_init. */
89#define OSMO_SOCK_F_CONNECT (1 << 0)
91#define OSMO_SOCK_F_BIND (1 << 1)
93#define OSMO_SOCK_F_NONBLOCK (1 << 2)
95#define OSMO_SOCK_F_NO_MCAST_LOOP (1 << 3)
97#define OSMO_SOCK_F_NO_MCAST_ALL (1 << 4)
99#define OSMO_SOCK_F_UDP_REUSEADDR (1 << 5)
100
102#define OSMO_SOCK_F_DSCP(x) (((x)&0x3f) << 24)
103#define GET_OSMO_SOCK_F_DSCP(f) (((f) >> 24) & 0x3f)
104
106#define OSMO_SOCK_F_PRIO(x) (((x)&0xff) << 16)
107#define GET_OSMO_SOCK_F_PRIO(f) (((f) >> 16) & 0xff)
108
109
111#define OSMO_SOCK_MAX_ADDRS 32
112
113int osmo_sock_init(uint16_t family, uint16_t type, uint8_t proto,
114 const char *host, uint16_t port, unsigned int flags);
115
116int osmo_sock_init2(uint16_t family, uint16_t type, uint8_t proto,
117 const char *local_host, uint16_t local_port,
118 const char *remote_host, uint16_t remote_port, unsigned int flags);
119
121 union {
122 struct {
123 uint8_t version; /* set to 0 */
124 struct {
125 bool set;
127 uint32_t value;
129 struct {
130 bool set;
131 bool abort_on_failure;
132 uint32_t value;
134 struct {
135 bool set;
136 bool abort_on_failure;
147 };
148};
149int osmo_sock_init2_multiaddr(uint16_t family, uint16_t type, uint8_t proto,
150 const char **local_hosts, size_t local_hosts_cnt, uint16_t local_port,
151 const char **remote_hosts, size_t remote_hosts_cnt, uint16_t remote_port, unsigned int flags)
152 OSMO_DEPRECATED_OUTSIDE("Use osmo_sock_init2_multiaddr2() instead");
153int osmo_sock_init2_multiaddr2(uint16_t family, uint16_t type, uint8_t proto,
154 const char **local_hosts, size_t local_hosts_cnt, uint16_t local_port,
155 const char **remote_hosts, size_t remote_hosts_cnt, uint16_t remote_port,
156 unsigned int flags, struct osmo_sock_init2_multiaddr_pars *pars);
157
158int osmo_sock_init_osa(uint16_t type, uint8_t proto,
159 const struct osmo_sockaddr *local,
160 const struct osmo_sockaddr *remote,
161 unsigned int flags);
162
163int osmo_sock_init_ofd(struct osmo_fd *ofd, int family, int type, int proto,
164 const char *host, uint16_t port, unsigned int flags);
165
166int osmo_sock_init2_ofd(struct osmo_fd *ofd, int family, int type, int proto,
167 const char *local_host, uint16_t local_port,
168 const char *remote_host, uint16_t remote_port, unsigned int flags);
169
170int osmo_sock_init_osa_ofd(struct osmo_fd *ofd, int type, int proto,
171 const struct osmo_sockaddr *local,
172 const struct osmo_sockaddr *remote,
173 unsigned int flags);
174
175int osmo_sock_init_sa(struct sockaddr *ss, uint16_t type,
176 uint8_t proto, unsigned int flags);
177
178int osmo_sock_unix_init(uint16_t type, uint8_t proto,
179 const char *socket_path, unsigned int flags);
180
181int osmo_sock_unix_init_ofd(struct osmo_fd *ofd, uint16_t type, uint8_t proto,
182 const char *socket_path, unsigned int flags);
183
184char *osmo_sock_get_name(const void *ctx, int fd);
185const char *osmo_sock_get_name2(int fd);
186char *osmo_sock_get_name2_c(const void *ctx, int fd);
187int osmo_sock_get_name_buf(char *str, size_t str_len, int fd);
188int osmo_sock_get_ip_and_port(int fd, char *ip, size_t ip_len, char *port, size_t port_len, bool local);
189int osmo_sock_get_local_ip(int fd, char *host, size_t len);
190int osmo_sock_get_local_ip_port(int fd, char *port, size_t len);
191int osmo_sock_get_remote_ip(int fd, char *host, size_t len);
192int osmo_sock_get_remote_ip_port(int fd, char *port, size_t len);
193
194int osmo_sock_multiaddr_add_local_addr(int sfd, const char **addrs, size_t addrs_cnt);
195int osmo_sock_multiaddr_del_local_addr(int sfd, const char **addrs, size_t addrs_cnt);
196
197int osmo_sock_mcast_loop_set(int fd, bool enable);
198int osmo_sock_mcast_ttl_set(int fd, uint8_t ttl);
199int osmo_sock_mcast_all_set(int fd, bool enable);
200int osmo_sock_mcast_iface_set(int fd, const char *ifname);
201int osmo_sock_mcast_subscribe(int fd, const char *grp_addr);
202
203int osmo_sock_local_ip(char *local_ip, const char *remote_ip);
204
205int osmo_sock_set_dscp(int fd, uint8_t dscp);
206int osmo_sock_set_priority(int fd, int prio);
207
208#endif /* (!EMBEDDED) */
General definitions that are meant to be included from header files.
enum osmo_sub_auth_type type
static size_t len(const char *str)
int osmo_sockaddr_cmp(const struct osmo_sockaddr *a, const struct osmo_sockaddr *b)
size_t osmo_sockaddr_in_to_str_and_uint(char *addr, unsigned int addr_len, uint16_t *port, const struct sockaddr_in *sin)
int osmo_sock_init_osa(uint16_t type, uint8_t proto, const struct osmo_sockaddr *local, const struct osmo_sockaddr *remote, unsigned int flags)
int osmo_sock_multiaddr_add_local_addr(int sfd, const char **addrs, size_t addrs_cnt)
static socklen_t osmo_sockaddr_size(const struct osmo_sockaddr *addr)
Return the size of the variant used in the address NOTE: This does not return the size of the in{,...
Definition: socket.h:46
const char * osmo_sockaddr_ntop(const struct sockaddr *sa, char *dst)
int osmo_sock_get_local_ip(int fd, char *host, size_t len)
void osmo_sockaddr_set_port(struct sockaddr *sa, uint16_t port)
char * osmo_sockaddr_to_str_buf(char *buf, size_t buf_len, const struct osmo_sockaddr *sockaddr)
char * osmo_sockaddr_to_str_c(void *ctx, const struct osmo_sockaddr *sockaddr)
uint16_t osmo_sockaddr_port(const struct sockaddr *sa)
char * osmo_sock_get_name2_c(const void *ctx, int fd)
char * osmo_sock_get_name(const void *ctx, int fd)
int osmo_sockaddr_local_ip(struct osmo_sockaddr *local_ip, const struct osmo_sockaddr *remote_ip)
int osmo_sock_get_name_buf(char *str, size_t str_len, int fd)
int osmo_sockaddr_is_any(const struct osmo_sockaddr *addr)
int osmo_sock_set_priority(int fd, int prio)
int osmo_sock_mcast_loop_set(int fd, bool enable)
int osmo_sock_get_ip_and_port(int fd, char *ip, size_t ip_len, char *port, size_t port_len, bool local)
int osmo_sock_multiaddr_del_local_addr(int sfd, const char **addrs, size_t addrs_cnt)
int osmo_sockaddr_from_str_and_uint(struct osmo_sockaddr *osa_out, const char *ipstr, uint16_t port)
int osmo_sock_get_local_ip_port(int fd, char *port, size_t len)
int osmo_sock_init(uint16_t family, uint16_t type, uint8_t proto, const char *host, uint16_t port, unsigned int flags)
int osmo_sock_init_ofd(struct osmo_fd *ofd, int family, int type, int proto, const char *host, uint16_t port, unsigned int flags)
int osmo_sock_init2_ofd(struct osmo_fd *ofd, int family, int type, int proto, const char *local_host, uint16_t local_port, const char *remote_host, uint16_t remote_port, unsigned int flags)
int osmo_sockaddr_to_octets(uint8_t *dst, size_t dst_maxlen, const struct osmo_sockaddr *os)
int osmo_sockaddr_netmask_to_prefixlen(const struct osmo_sockaddr *addr)
const char * osmo_sockaddr_to_str(const struct osmo_sockaddr *sockaddr)
const char * osmo_sock_get_name2(int fd)
int osmo_sock_get_remote_ip_port(int fd, char *port, size_t len)
int osmo_sock_mcast_all_set(int fd, bool enable)
int osmo_sockaddr_to_str_buf2(char *buf, size_t buf_len, const struct osmo_sockaddr *sockaddr)
unsigned int osmo_sockaddr_to_str_and_uint(char *addr, unsigned int addr_len, uint16_t *port, const struct sockaddr *sa)
int osmo_sockaddr_from_octets(struct osmo_sockaddr *os, const void *src, size_t src_len)
int osmo_sock_init2(uint16_t family, uint16_t type, uint8_t proto, const char *local_host, uint16_t local_port, const char *remote_host, uint16_t remote_port, unsigned int flags)
int osmo_sock_unix_init_ofd(struct osmo_fd *ofd, uint16_t type, uint8_t proto, const char *socket_path, unsigned int flags)
int osmo_sock_mcast_ttl_set(int fd, uint8_t ttl)
int osmo_sock_set_dscp(int fd, uint8_t dscp)
int osmo_sock_init2_multiaddr2(uint16_t family, uint16_t type, uint8_t proto, const char **local_hosts, size_t local_hosts_cnt, uint16_t local_port, const char **remote_hosts, size_t remote_hosts_cnt, uint16_t remote_port, unsigned int flags, struct osmo_sock_init2_multiaddr_pars *pars)
int osmo_sockaddr_is_local(struct sockaddr *addr, unsigned int addrlen)
int osmo_sock_init2_multiaddr(uint16_t family, uint16_t type, uint8_t proto, const char **local_hosts, size_t local_hosts_cnt, uint16_t local_port, const char **remote_hosts, size_t remote_hosts_cnt, uint16_t remote_port, unsigned int flags) OSMO_DEPRECATED_OUTSIDE("Use osmo_sock_init2_multiaddr2() instead")
int osmo_sock_get_remote_ip(int fd, char *host, size_t len)
int osmo_sock_mcast_iface_set(int fd, const char *ifname)
int osmo_sock_init_osa_ofd(struct osmo_fd *ofd, int type, int proto, const struct osmo_sockaddr *local, const struct osmo_sockaddr *remote, unsigned int flags)
int osmo_sock_unix_init(uint16_t type, uint8_t proto, const char *socket_path, unsigned int flags)
int osmo_sock_init_sa(struct sockaddr *ss, uint16_t type, uint8_t proto, unsigned int flags)
int osmo_sock_local_ip(char *local_ip, const char *remote_ip)
int osmo_sock_mcast_subscribe(int fd, const char *grp_addr)
#define OSMO_DEPRECATED_OUTSIDE(text)
Definition: defs.h:49
Structure representing a file dsecriptor.
Definition: select.h:31
Definition: socket.h:120
uint8_t version
Definition: socket.h:123
bool max_init_timeo_present
Definition: socket.h:140
struct osmo_sock_init2_multiaddr_pars::@29::@31::@32 sockopt_auth_supported
bool abort_on_failure
Definition: socket.h:126
bool set
Definition: socket.h:125
uint16_t max_init_timeo_value
Definition: socket.h:144
uint16_t max_instreams_value
Definition: socket.h:142
uint16_t num_ostreams_value
Definition: socket.h:141
bool max_attempts_present
Definition: socket.h:139
uint32_t value
Definition: socket.h:127
bool num_ostreams_present
Definition: socket.h:137
bool max_instreams_present
Definition: socket.h:138
struct osmo_sock_init2_multiaddr_pars::@29::@31 sctp
struct osmo_sock_init2_multiaddr_pars::@29::@31::@33 sockopt_asconf_supported
uint16_t max_attempts_value
Definition: socket.h:143
struct osmo_sock_init2_multiaddr_pars::@29::@31::@34 sockopt_initmsg
Definition: socket.h:26
struct sockaddr_storage sas
Definition: socket.h:29
struct sockaddr_in sin
Definition: socket.h:30
struct sockaddr_in6 sin6
Definition: socket.h:31
struct sockaddr sa
Definition: socket.h:28
union osmo_sockaddr::@28 u