libosmocore  1.5.1
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 
18 #define OSMO_SOCK_NAME_MAXLEN (2 + INET6_ADDRSTRLEN + 1 + 5 + 3 + 2 + INET6_ADDRSTRLEN + 1 + 5 + 1)
19 
20 struct sockaddr_in;
21 struct sockaddr;
22 struct osmo_fd;
23 
24 struct osmo_sockaddr {
25  union {
26  struct sockaddr sa;
27  struct sockaddr_storage sas;
28  struct sockaddr_in sin;
29  struct sockaddr_in6 sin6;
30  } u;
31 };
32 
33 /* flags for osmo_sock_init. */
35 #define OSMO_SOCK_F_CONNECT (1 << 0)
36 
37 #define OSMO_SOCK_F_BIND (1 << 1)
38 
39 #define OSMO_SOCK_F_NONBLOCK (1 << 2)
40 
41 #define OSMO_SOCK_F_NO_MCAST_LOOP (1 << 3)
42 
43 #define OSMO_SOCK_F_NO_MCAST_ALL (1 << 4)
44 
45 #define OSMO_SOCK_F_UDP_REUSEADDR (1 << 5)
46 
48 #define OSMO_SOCK_MAX_ADDRS 32
49 
50 int osmo_sock_init(uint16_t family, uint16_t type, uint8_t proto,
51  const char *host, uint16_t port, unsigned int flags);
52 
53 int osmo_sock_init2(uint16_t family, uint16_t type, uint8_t proto,
54  const char *local_host, uint16_t local_port,
55  const char *remote_host, uint16_t remote_port, unsigned int flags);
56 
57 int osmo_sock_init2_multiaddr(uint16_t family, uint16_t type, uint8_t proto,
58  const char **local_hosts, size_t local_hosts_cnt, uint16_t local_port,
59  const char **remote_hosts, size_t remote_hosts_cnt, uint16_t remote_port, unsigned int flags);
60 
61 int osmo_sock_init_osa(uint16_t type, uint8_t proto,
62  const struct osmo_sockaddr *local,
63  const struct osmo_sockaddr *remote,
64  unsigned int flags);
65 
66 int osmo_sock_init_ofd(struct osmo_fd *ofd, int family, int type, int proto,
67  const char *host, uint16_t port, unsigned int flags);
68 
69 int osmo_sock_init2_ofd(struct osmo_fd *ofd, int family, int type, int proto,
70  const char *local_host, uint16_t local_port,
71  const char *remote_host, uint16_t remote_port, unsigned int flags);
72 
73 int osmo_sock_init_osa_ofd(struct osmo_fd *ofd, int type, int proto,
74  const struct osmo_sockaddr *local,
75  const struct osmo_sockaddr *remote,
76  unsigned int flags);
77 
78 int osmo_sock_init_sa(struct sockaddr *ss, uint16_t type,
79  uint8_t proto, unsigned int flags);
80 
81 int osmo_sockaddr_is_local(struct sockaddr *addr, unsigned int addrlen);
82 
83 unsigned int osmo_sockaddr_to_str_and_uint(char *addr, unsigned int addr_len, uint16_t *port,
84  const struct sockaddr *sa);
85 size_t osmo_sockaddr_in_to_str_and_uint(char *addr, unsigned int addr_len, uint16_t *port,
86  const struct sockaddr_in *sin);
87 
88 const char *osmo_sockaddr_ntop(const struct sockaddr *sa, char *dst);
89 uint16_t osmo_sockaddr_port(const struct sockaddr *sa);
90 
91 int osmo_sock_unix_init(uint16_t type, uint8_t proto,
92  const char *socket_path, unsigned int flags);
93 
94 int osmo_sock_unix_init_ofd(struct osmo_fd *ofd, uint16_t type, uint8_t proto,
95  const char *socket_path, unsigned int flags);
96 
97 char *osmo_sock_get_name(const void *ctx, int fd);
98 const char *osmo_sock_get_name2(int fd);
99 char *osmo_sock_get_name2_c(const void *ctx, int fd);
100 int osmo_sock_get_name_buf(char *str, size_t str_len, int fd);
101 int osmo_sock_get_ip_and_port(int fd, char *ip, size_t ip_len, char *port, size_t port_len, bool local);
102 int osmo_sock_get_local_ip(int fd, char *host, size_t len);
103 int osmo_sock_get_local_ip_port(int fd, char *port, size_t len);
104 int osmo_sock_get_remote_ip(int fd, char *host, size_t len);
105 int osmo_sock_get_remote_ip_port(int fd, char *port, size_t len);
106 
107 
108 int osmo_sock_mcast_loop_set(int fd, bool enable);
109 int osmo_sock_mcast_ttl_set(int fd, uint8_t ttl);
110 int osmo_sock_mcast_all_set(int fd, bool enable);
111 int osmo_sock_mcast_iface_set(int fd, const char *ifname);
112 int osmo_sock_mcast_subscribe(int fd, const char *grp_addr);
113 
114 int osmo_sock_local_ip(char *local_ip, const char *remote_ip);
115 
116 int osmo_sockaddr_local_ip(struct osmo_sockaddr *local_ip,
117  const struct osmo_sockaddr *remote_ip);
118 int osmo_sockaddr_cmp(const struct osmo_sockaddr *a,
119  const struct osmo_sockaddr *b);
120 
121 const char *osmo_sockaddr_to_str(const struct osmo_sockaddr *sockaddr);
122 char *osmo_sockaddr_to_str_buf(char *buf, size_t buf_len,
123  const struct osmo_sockaddr *sockaddr);
124 
125 #endif /* (!EMBEDDED) */
126 
osmo_sock_mcast_loop_set
int osmo_sock_mcast_loop_set(int fd, bool enable)
Activate or de-activate local loop-back of transmitted multicast packets.
Definition: socket.c:1470
osmo_sockaddr_ntop
const char * osmo_sockaddr_ntop(const struct sockaddr *sa, char *dst)
inet_ntop() wrapper for a struct sockaddr.
Definition: socket.c:1177
osmo_sockaddr::sa
struct sockaddr sa
Definition: socket.h:26
osmo_sockaddr_cmp
int osmo_sockaddr_cmp(const struct osmo_sockaddr *a, const struct osmo_sockaddr *b)
Compare two osmo_sockaddr.
Definition: socket.c:1693
osmo_sock_init_osa
int osmo_sock_init_osa(uint16_t type, uint8_t proto, const struct osmo_sockaddr *local, const struct osmo_sockaddr *remote, unsigned int flags)
Initialize a socket (including bind and/or connect)
Definition: socket.c:491
osmo_sock_init
int osmo_sock_init(uint16_t family, uint16_t type, uint8_t proto, const char *host, uint16_t port, unsigned int flags)
Initialize a socket (including bind/connect)
Definition: socket.c:868
osmo_sock_get_remote_ip
int osmo_sock_get_remote_ip(int fd, char *host, size_t len)
Get remote IP address on socket.
Definition: socket.c:1361
len
static size_t len(const char *str)
osmo_sock_init_osa_ofd
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)
Definition: socket.c:1015
osmo_sock_get_name2_c
char * osmo_sock_get_name2_c(const void *ctx, int fd)
Get address/port information on socket in static string, like "r=1.2.3.4:5<->l=6.7....
Definition: socket.c:1437
osmo_sockaddr_port
uint16_t osmo_sockaddr_port(const struct sockaddr *sa)
Get sockaddr port content (in host byte order)
Definition: socket.c:1191
osmo_sockaddr
Definition: socket.h:24
osmo_sockaddr_to_str
const char * osmo_sockaddr_to_str(const struct osmo_sockaddr *sockaddr)
string-format a given osmo_sockaddr address
Definition: socket.c:1722
osmo_sockaddr::sin6
struct sockaddr_in6 sin6
Definition: socket.h:29
osmo_sock_unix_init
int osmo_sock_unix_init(uint16_t type, uint8_t proto, const char *socket_path, unsigned int flags)
Initialize a unix domain socket (including bind/connect)
Definition: socket.c:1217
osmo_sock_mcast_all_set
int osmo_sock_mcast_all_set(int fd, bool enable)
Enable/disable receiving all multicast packets, even for non-subscribed groups.
Definition: socket.c:1538
osmo_sockaddr_to_str_buf
char * osmo_sockaddr_to_str_buf(char *buf, size_t buf_len, const struct osmo_sockaddr *sockaddr)
string-format a given osmo_sockaddr address into a user-supplied buffer
Definition: socket.c:1736
osmo_sock_get_local_ip_port
int osmo_sock_get_local_ip_port(int fd, char *port, size_t len)
Get local port on socket.
Definition: socket.c:1350
osmo_sock_unix_init_ofd
int osmo_sock_unix_init_ofd(struct osmo_fd *ofd, uint16_t type, uint8_t proto, const char *socket_path, unsigned int flags)
Initialize a unix domain socket and fill osmo_fd.
Definition: socket.c:1294
osmo_sock_init_ofd
int osmo_sock_init_ofd(struct osmo_fd *ofd, int family, int type, int proto, const char *host, uint16_t port, unsigned int flags)
Initialize a socket and fill osmo_fd.
Definition: socket.c:986
osmo_sock_mcast_ttl_set
int osmo_sock_mcast_ttl_set(int fd, uint8_t ttl)
Set the TTL of outbound multicast packets.
Definition: socket.c:1495
osmo_sock_mcast_subscribe
int osmo_sock_mcast_subscribe(int fd, const char *grp_addr)
Subscribe to the given IP multicast group.
Definition: socket.c:1570
osmo_sockaddr_in_to_str_and_uint
size_t osmo_sockaddr_in_to_str_and_uint(char *addr, unsigned int addr_len, uint16_t *port, const struct sockaddr_in *sin)
Convert sockaddr_in to IP address as char string and port as uint16_t.
Definition: socket.c:1131
osmo_sockaddr_is_local
int osmo_sockaddr_is_local(struct sockaddr *addr, unsigned int addrlen)
Determine if the given address is a local address.
Definition: socket.c:1101
osmo_sock_init2
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)
Initialize a socket (including bind and/or connect)
Definition: socket.c:282
osmo_sock_init2_multiaddr
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)
Initialize a socket (including bind and/or connect) with multiple local or remote addresses.
Definition: socket.c:695
osmo_sockaddr_to_str_and_uint
unsigned int osmo_sockaddr_to_str_and_uint(char *addr, unsigned int addr_len, uint16_t *port, const struct sockaddr *sa)
Convert sockaddr to IP address as char string and port as uint16_t.
Definition: socket.c:1150
osmo_sock_get_ip_and_port
int osmo_sock_get_ip_and_port(int fd, char *ip, size_t ip_len, char *port, size_t port_len, bool local)
Get the IP and/or port number on socket in separate string buffers.
Definition: socket.c:1309
osmo_sockaddr::u
union osmo_sockaddr::@22 u
osmo_sock_local_ip
int osmo_sock_local_ip(char *local_ip, const char *remote_ip)
Determine the matching local IP-address for a given remote IP-Address.
Definition: socket.c:1609
osmo_sock_init2_ofd
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)
Initialize a socket and fill osmo_fd.
Definition: socket.c:1007
osmo_sockaddr::sin
struct sockaddr_in sin
Definition: socket.h:28
host
type
enum osmo_sub_auth_type type
osmo_sock_get_name_buf
int osmo_sock_get_name_buf(char *str, size_t str_len, int fd)
Get address/port information on socket in provided string buffer, like "r=1.2.3.4:5<->l=6....
Definition: socket.c:1401
osmo_sock_get_remote_ip_port
int osmo_sock_get_remote_ip_port(int fd, char *port, size_t len)
Get remote port on socket.
Definition: socket.c:1372
osmo_sockaddr::sas
struct sockaddr_storage sas
Definition: socket.h:27
osmo_sock_get_name
char * osmo_sock_get_name(const void *ctx, int fd)
Get address/port information on socket in dyn-alloc string like "(r=1.2.3.4:5<->l=6....
Definition: socket.c:1384
osmo_fd
Structure representing a file dsecriptor.
Definition: select.h:31
osmo_sockaddr_local_ip
int osmo_sockaddr_local_ip(struct osmo_sockaddr *local_ip, const struct osmo_sockaddr *remote_ip)
Determine the matching local address for a given remote address.
Definition: socket.c:1670
osmo_sock_init_sa
int osmo_sock_init_sa(struct sockaddr *ss, uint16_t type, uint8_t proto, unsigned int flags)
Initialize a socket and fill sockaddr.
Definition: socket.c:1032
osmo_sock_mcast_iface_set
int osmo_sock_mcast_iface_set(int fd, const char *ifname)
Set the network device to which we should bind the multicast socket.
Definition: socket.c:1517
osmo_sock_get_name2
const char * osmo_sock_get_name2(int fd)
Get address/port information on socket in static string, like "r=1.2.3.4:5<->l=6.7....
Definition: socket.c:1425
osmo_sock_get_local_ip
int osmo_sock_get_local_ip(int fd, char *host, size_t len)
Get local IP address on socket.
Definition: socket.c:1339