mirror of https://github.com/oxen-io/lokinet
You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
100 lines
2.8 KiB
C
100 lines
2.8 KiB
C
#pragma once
|
|
|
|
#include "lokinet_context.h"
|
|
|
|
#ifdef _WIN32
|
|
extern "C"
|
|
{
|
|
struct iovec
|
|
{
|
|
void* iov_base;
|
|
size_t iov_len;
|
|
};
|
|
}
|
|
#else
|
|
#include <sys/uio.h>
|
|
#endif
|
|
|
|
#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 EXPORT
|
|
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
|
|
/// localAddr to forward inbound udp packets to "ip:port"
|
|
/// returns 0 on success
|
|
/// returns nonzero on error in which it is an errno value
|
|
int EXPORT
|
|
lokinet_udp_bind(
|
|
int exposedPort,
|
|
char* localAddr,
|
|
struct lokinet_udp_listen_result* result,
|
|
struct lokinet_context* ctx);
|
|
|
|
/// get remote peer information about a local udp flow coming from localaddr
|
|
/// returns 0 on success
|
|
/// returns nonzero on error in which it is an errno value
|
|
int EXPORT
|
|
lokinet_udp_peername(char* localAddr, struct lokinet_udp_flow* flow, struct lokinet_context* ctx);
|
|
|
|
/*
|
|
|
|
Packet arrives for new flow:
|
|
- call "new_flow" callback, which can return:
|
|
- drop
|
|
- accept, returns (context pointer, flow timeout).
|
|
|
|
If accepted then this packet and subsequent packets on the flow:
|
|
- call "new_packet" callback, given it the context pointer from accept.
|
|
|
|
If no packets for (timeout) we call
|
|
- "flow_timeout" with the context pointer
|
|
|
|
int new_flow(const struct remote_details* remote, void** user_ctx, int* flow_timeout);
|
|
void new_packet(const struct remote_details* remote, char* data, size_t len, void* user_ctx);
|
|
void flow_timeout(const struct remote_details* remote, void* user_ctx);
|
|
|
|
*/
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|