mirror of
https://github.com/oxen-io/lokinet
synced 2023-12-14 06:53:00 +01:00
93 lines
2.6 KiB
C
93 lines
2.6 KiB
C
#pragma once
|
|
|
|
#include "lokinet_context.h"
|
|
#include "lokinet_os.h"
|
|
|
|
#ifdef __cplusplus
|
|
extern "C"
|
|
{
|
|
#endif
|
|
|
|
/// information about a udp flow
|
|
struct lokinet_udp_flow
|
|
{
|
|
/// the socket id for this flow used for i/o purposes and closing this socket
|
|
int socket_id;
|
|
/// remote endpoint's .loki or .snode address
|
|
char remote_addr[256];
|
|
/// local endpoint's ip address
|
|
char local_addr[64];
|
|
/// remote endpont's port
|
|
int remote_port;
|
|
/// local endpoint's port
|
|
int local_port;
|
|
};
|
|
|
|
/// establish an outbound udp flow
|
|
/// remoteHost is the remote .loki or .snode address conneting to
|
|
/// remotePort is either a string integer or an srv record name to lookup, e.g. thingservice in
|
|
/// which we do a srv lookup for _udp.thingservice.remotehost.tld and use the "best" port provided
|
|
/// localAddr is the local ip:port to bind our socket to, if localAddr is NULL then
|
|
/// lokinet_udp_sendmmsg MUST be used to send packets return 0 on success return nonzero on fail,
|
|
/// containing an errno value
|
|
int
|
|
lokinet_udp_establish(
|
|
char* remoteHost,
|
|
char* remotePort,
|
|
char* localAddr,
|
|
struct lokinet_udp_flow* flow,
|
|
struct lokinet_context* ctx);
|
|
|
|
/// a result from a lokinet_udp_bind call
|
|
struct lokinet_udp_bind_result
|
|
{
|
|
/// a socket id used to close a lokinet udp socket
|
|
int socket_id;
|
|
};
|
|
|
|
/// inbound listen udp socket
|
|
/// expose udp port exposePort to the void
|
|
/// if srv is not NULL add an srv record for this port, the format being "thingservice" in which
|
|
/// will add a srv record "_udp.thingservice.ouraddress.tld" that advertises this port provide
|
|
/// localAddr to forward inbound udp packets to "ip:port" if localAddr is NULL then the resulting
|
|
/// socket MUST be drained by lokinet_udp_recvmmsg
|
|
///
|
|
/// returns 0 on success
|
|
/// returns nonzero on error in which it is an errno value
|
|
int
|
|
lokinet_udp_bind(
|
|
int exposedPort,
|
|
char* srv,
|
|
char* localAddr,
|
|
struct lokinet_udp_listen_result* result,
|
|
struct lokinet_context* ctx);
|
|
|
|
/// poll many udp sockets for activity
|
|
/// returns 0 on sucess
|
|
///
|
|
/// returns non zero errno on error
|
|
int
|
|
lokinet_udp_poll(
|
|
const int* socket_ids,
|
|
size_t numsockets,
|
|
const struct timespec* timeout,
|
|
struct lokinet_context* ctx);
|
|
|
|
struct lokinet_udp_pkt
|
|
{
|
|
char remote_addr[256];
|
|
int remote_port;
|
|
struct iovec pkt;
|
|
};
|
|
|
|
/// analog to recvmmsg
|
|
ssize_t
|
|
lokinet_udp_recvmmsg(
|
|
int socket_id,
|
|
struct lokinet_udp_pkt* events,
|
|
size_t max_events,
|
|
struct lokient_context* ctx);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|