libosmocore  1.9.0.169-ada8.202403032026
Osmocom core library
osmo_io.h
Go to the documentation of this file.
1 
5 #pragma once
6 
7 #include <sys/socket.h>
8 
10 #include <osmocom/core/logging.h>
11 #include <osmocom/core/msgb.h>
12 #include <osmocom/core/socket.h>
13 #include <osmocom/core/utils.h>
14 
15 
16 #define LOGPIO(iofd, level, fmt, args...) \
17  LOGP(DLIO, level, "iofd(%s)" fmt, iofd->name, ## args)
18 
19 struct osmo_io_fd;
20 
28 };
29 
33 };
34 
35 extern const struct value_string osmo_io_backend_names[];
36 static inline const char *osmo_io_backend_name(enum osmo_io_backend val)
38 
39 struct osmo_io_ops {
40  /* mode OSMO_IO_FD_MODE_READ_WRITE: */
41  struct {
43  void (*read_cb)(struct osmo_io_fd *iofd, int res, struct msgb *msg);
45  void (*write_cb)(struct osmo_io_fd *iofd, int res,
46  struct msgb *msg);
56  int (*segmentation_cb)(struct msgb *msg);
57  };
58 
59  /* mode OSMO_IO_FD_MODE_RECVFROM_SENDTO: */
60  struct {
62  void (*recvfrom_cb)(struct osmo_io_fd *iofd, int res,
63  struct msgb *msg,
64  const struct osmo_sockaddr *saddr);
66  void (*sendto_cb)(struct osmo_io_fd *iofd, int res,
67  struct msgb *msg,
68  const struct osmo_sockaddr *daddr);
69  };
70 
71  /* mode OSMO_IO_FD_MODE_RECVMSG_SENDMSG: */
72  struct {
73  void (*recvmsg_cb)(struct osmo_io_fd *iofd, int res,
74  struct msgb *msg, const struct msghdr *msgh);
75  void (*sendmsg_cb)(struct osmo_io_fd *iofd, int res, struct msgb *msg);
76  };
77 };
78 
79 void osmo_iofd_init(void);
80 
81 struct osmo_io_fd *osmo_iofd_setup(const void *ctx, int fd, const char *name,
82  enum osmo_io_fd_mode mode, const struct osmo_io_ops *ioops, void *data);
83 int osmo_iofd_set_cmsg_size(struct osmo_io_fd *iofd, size_t cmsg_size);
84 int osmo_iofd_register(struct osmo_io_fd *iofd, int fd);
85 int osmo_iofd_unregister(struct osmo_io_fd *iofd);
86 unsigned int osmo_iofd_txqueue_len(struct osmo_io_fd *iofd);
88 int osmo_iofd_close(struct osmo_io_fd *iofd);
89 void osmo_iofd_free(struct osmo_io_fd *iofd);
90 
92 
93 int osmo_iofd_write_msgb(struct osmo_io_fd *iofd, struct msgb *msg);
94 int osmo_iofd_sendto_msgb(struct osmo_io_fd *iofd, struct msgb *msg, int sendto_flags,
95  const struct osmo_sockaddr *dest);
96 int osmo_iofd_sendmsg_msgb(struct osmo_io_fd *iofd, struct msgb *msg, int sendmsg_flags,
97  const struct msghdr *msgh);
98 
99 void osmo_iofd_set_alloc_info(struct osmo_io_fd *iofd, unsigned int size, unsigned int headroom);
100 void osmo_iofd_set_txqueue_max_length(struct osmo_io_fd *iofd, unsigned int size);
101 void *osmo_iofd_get_data(const struct osmo_io_fd *iofd);
102 void osmo_iofd_set_data(struct osmo_io_fd *iofd, void *data);
103 
104 unsigned int osmo_iofd_get_priv_nr(const struct osmo_io_fd *iofd);
105 void osmo_iofd_set_priv_nr(struct osmo_io_fd *iofd, unsigned int priv_nr);
106 
107 int osmo_iofd_get_fd(const struct osmo_io_fd *iofd);
108 const char *osmo_iofd_get_name(const struct osmo_io_fd *iofd);
109 void osmo_iofd_set_name(struct osmo_io_fd *iofd, const char *name);
110 
111 int osmo_iofd_set_ioops(struct osmo_io_fd *iofd, const struct osmo_io_ops *ioops);
112 void osmo_iofd_get_ioops(struct osmo_io_fd *iofd, struct osmo_io_ops *ioops);
const char * name
uint8_t res[16]
uint8_t data[0]
const char * get_value_string(const struct value_string *vs, uint32_t val)
get human-readable string for given value
Definition: utils.c:54
uint8_t msg[0]
Simple doubly linked list implementation.
void * osmo_iofd_get_data(const struct osmo_io_fd *iofd)
void osmo_iofd_set_data(struct osmo_io_fd *iofd, void *data)
int osmo_iofd_write_msgb(struct osmo_io_fd *iofd, struct msgb *msg)
const char * osmo_iofd_get_name(const struct osmo_io_fd *iofd)
osmo_io_fd_mode
Definition: osmo_io.h:21
@ OSMO_IO_FD_MODE_RECVFROM_SENDTO
use recvfrom() / sendto() calls
Definition: osmo_io.h:25
@ OSMO_IO_FD_MODE_RECVMSG_SENDMSG
emulate recvmsg() / sendmsg()
Definition: osmo_io.h:27
@ OSMO_IO_FD_MODE_READ_WRITE
use read() / write() calls
Definition: osmo_io.h:23
void osmo_iofd_set_txqueue_max_length(struct osmo_io_fd *iofd, unsigned int size)
void osmo_iofd_get_ioops(struct osmo_io_fd *iofd, struct osmo_io_ops *ioops)
int osmo_iofd_set_ioops(struct osmo_io_fd *iofd, const struct osmo_io_ops *ioops)
int osmo_iofd_unregister(struct osmo_io_fd *iofd)
void osmo_iofd_notify_connected(struct osmo_io_fd *iofd)
void osmo_iofd_set_priv_nr(struct osmo_io_fd *iofd, unsigned int priv_nr)
osmo_io_backend
Definition: osmo_io.h:30
@ OSMO_IO_BACKEND_POLL
Definition: osmo_io.h:31
@ OSMO_IO_BACKEND_IO_URING
Definition: osmo_io.h:32
void osmo_iofd_txqueue_clear(struct osmo_io_fd *iofd)
struct osmo_io_fd * osmo_iofd_setup(const void *ctx, int fd, const char *name, enum osmo_io_fd_mode mode, const struct osmo_io_ops *ioops, void *data)
void osmo_iofd_set_name(struct osmo_io_fd *iofd, const char *name)
static const char * osmo_io_backend_name(enum osmo_io_backend val)
Definition: osmo_io.h:36
int osmo_iofd_get_fd(const struct osmo_io_fd *iofd)
void osmo_iofd_free(struct osmo_io_fd *iofd)
const struct value_string osmo_io_backend_names[]
int osmo_iofd_register(struct osmo_io_fd *iofd, int fd)
int osmo_iofd_sendmsg_msgb(struct osmo_io_fd *iofd, struct msgb *msg, int sendmsg_flags, const struct msghdr *msgh)
unsigned int osmo_iofd_txqueue_len(struct osmo_io_fd *iofd)
void osmo_iofd_init(void)
void osmo_iofd_set_alloc_info(struct osmo_io_fd *iofd, unsigned int size, unsigned int headroom)
unsigned int osmo_iofd_get_priv_nr(const struct osmo_io_fd *iofd)
int osmo_iofd_close(struct osmo_io_fd *iofd)
int osmo_iofd_sendto_msgb(struct osmo_io_fd *iofd, struct msgb *msg, int sendto_flags, const struct osmo_sockaddr *dest)
int osmo_iofd_set_cmsg_size(struct osmo_io_fd *iofd, size_t cmsg_size)
Osmocom socket convenience functions.
Osmocom message buffer.
Definition: msgb.h:31
Definition: osmo_io_internal.h:52
enum osmo_io_fd_mode mode
type of read/write mode to use
Definition: osmo_io_internal.h:58
size_t cmsg_size
size of iofd_msghdr.cmsg[] when allocated in recvmsg path
Definition: osmo_io_internal.h:77
unsigned int headroom
headroom to allocate when allocating msgb's
Definition: osmo_io_internal.h:85
unsigned int size
size of msgb to allocate (excluding headroom)
Definition: osmo_io_internal.h:83
int fd
actual operating-system level file decriptor
Definition: osmo_io_internal.h:56
const void * ctx
talloc context from which to allocate msgb when reading
Definition: osmo_io_internal.h:81
unsigned int priv_nr
private number, extending data
Definition: osmo_io_internal.h:74
Definition: osmo_io.h:39
void(* read_cb)(struct osmo_io_fd *iofd, int res, struct msgb *msg)
call-back function when something was read from fd
Definition: osmo_io.h:43
void(* recvfrom_cb)(struct osmo_io_fd *iofd, int res, struct msgb *msg, const struct osmo_sockaddr *saddr)
call-back function emulating recvfrom
Definition: osmo_io.h:62
void(* write_cb)(struct osmo_io_fd *iofd, int res, struct msgb *msg)
call-back function when write has completed on fd
Definition: osmo_io.h:45
void(* sendto_cb)(struct osmo_io_fd *iofd, int res, struct msgb *msg, const struct osmo_sockaddr *daddr)
call-back function emulating sendto
Definition: osmo_io.h:66
void(* sendmsg_cb)(struct osmo_io_fd *iofd, int res, struct msgb *msg)
Definition: osmo_io.h:75
void(* recvmsg_cb)(struct osmo_io_fd *iofd, int res, struct msgb *msg, const struct msghdr *msgh)
Definition: osmo_io.h:73
int(* segmentation_cb)(struct msgb *msg)
call-back function to segment the data at message boundaries.
Definition: osmo_io.h:56
Definition: socket.h:38
A mapping between human-readable string and numeric value.
Definition: utils.h:51