net.h

Go to the documentation of this file.

#ifndef BJ_NET_H
#define BJ_NET_H
 
#include <banjo/api.h>
#include <banjo/error.h>

struct bj_address;

struct bj_tcp_listener;

struct bj_tcp_stream;

struct bj_udp;

struct bj_datagram;

enum bj_net_hints {
    BJ_NET_NOHINT       = 0x0,  
    BJ_RESOLVE_IPV4     = 0x01, 
    BJ_RESOLVE_IPV6     = 0x02, 
    BJ_EXCLUSIVE_BIND   = 0x04, 
    BJ_TCP_DELAY_ACK    = 0x08, 
    BJ_NONBLOCKING      = 0x10, 
    BJ_BROADCAST        = 0x20, 
};


BANJO_EXPORT struct bj_address* bj_resolve_address(
    const char*       host,
    uint16_t          port,
    uint16_t          hints,
    struct bj_error** error
);

BANJO_EXPORT size_t bj_address_string(
    const struct bj_address* addr,
    char*                    buf,
    size_t                   size
);

BANJO_EXPORT uint16_t bj_address_port(const struct bj_address* addr);

BANJO_EXPORT bj_bool bj_address_equals(
    const struct bj_address* a,
    const struct bj_address* b
);

BANJO_EXPORT size_t bj_address_count(const struct bj_address* addr);

BANJO_EXPORT bj_bool bj_address_next(struct bj_address* addr);

BANJO_EXPORT void bj_address_reset(struct bj_address* addr);

BANJO_EXPORT void bj_free_address(struct bj_address* addr);


enum bj_net_shutdown {
    BJ_SHUTDOWN_RECEIVE = 0x01, 
    BJ_SHUTDOWN_SEND    = 0x02, 
    BJ_SHUTDOWN_BOTH    = 0x03  
};

#define BJ_ADDR_STRLEN 46

#define BJ_NET_BACKLOG_DEFAULT 0

#define BJ_NET_BACKLOG_MAX (-1)

BANJO_EXPORT struct bj_tcp_listener* bj_listen_tcp(
    const char*       host,
    uint16_t          port,
    uint16_t          hint,
    int               backlog,
    struct bj_error** error
);

BANJO_EXPORT struct bj_tcp_stream* bj_connect_tcp(
    const char*       host,
    uint16_t          port,
    uint16_t          hint,
    uint32_t          ms_timeout,
    struct bj_error** error
);

BANJO_EXPORT struct bj_tcp_stream* bj_connect_tcp_to(
    struct bj_address* addr,
    uint16_t           hints,
    uint32_t           ms_timeout,
    struct bj_error**  error
);

BANJO_EXPORT struct bj_tcp_stream* bj_accept_tcp(
    struct bj_tcp_listener* listener,
    uint32_t                ms_timeout,
    struct bj_error**       error
);

BANJO_EXPORT int bj_tcp_recv(
    struct bj_tcp_stream* stream,
    void*                 buf,
    size_t                len
);

BANJO_EXPORT int bj_tcp_peek(
    struct bj_tcp_stream* stream,
    void*                 buf,
    size_t                len
);

BANJO_EXPORT int bj_tcp_send(
    struct bj_tcp_stream* stream,
    const void*           buf,
    size_t                len
);

BANJO_EXPORT void bj_tcp_shutdown(
    struct bj_tcp_stream* stream,
    int                   mode
);

BANJO_EXPORT bj_bool bj_set_tcp_keepalive(struct bj_tcp_stream* stream, bj_bool enable);

BANJO_EXPORT bj_bool bj_get_tcp_keepalive(struct bj_tcp_stream* stream);

BANJO_EXPORT bj_bool bj_tcp_wait(
    struct bj_tcp_stream* stream,
    uint32_t              ms_timeout
);

BANJO_EXPORT bj_bool bj_set_tcp_recv_timeout(
    struct bj_tcp_stream* stream,
    uint32_t              ms_timeout
);

BANJO_EXPORT uint32_t bj_get_tcp_recv_timeout(struct bj_tcp_stream* stream);

BANJO_EXPORT bj_bool bj_set_tcp_send_timeout(
    struct bj_tcp_stream* stream,
    uint32_t              ms_timeout
);

BANJO_EXPORT uint32_t bj_get_tcp_send_timeout(struct bj_tcp_stream* stream);

BANJO_EXPORT void bj_close_tcp_stream(
    struct bj_tcp_stream* stream
);

BANJO_EXPORT void bj_close_tcp_listener(
    struct bj_tcp_listener* listener
);

BANJO_EXPORT size_t bj_tcp_peer_address(
    const struct bj_tcp_stream* stream,
    char*                       buf,
    size_t                      size
);

BANJO_EXPORT size_t bj_tcp_local_address(
    const struct bj_tcp_stream* stream,
    char*                       buf,
    size_t                      size
);

BANJO_EXPORT uint16_t bj_tcp_listener_port(
    const struct bj_tcp_listener* listener
);

BANJO_EXPORT int bj_tcp_available(
    struct bj_tcp_stream* stream
);


BANJO_EXPORT struct bj_udp* bj_open_udp(
    const char*       host,
    uint16_t          port,
    uint16_t          hints,
    struct bj_error** error
);

BANJO_EXPORT void bj_close_udp(
    struct bj_udp* udp
);

BANJO_EXPORT int bj_udp_send(
    struct bj_udp*    udp,
    const char*       host,
    uint16_t          port,
    const void*       data,
    size_t            len,
    struct bj_error** error
);

BANJO_EXPORT int bj_udp_send_to(
    struct bj_udp*           udp,
    const struct bj_address* addr,
    const void*              data,
    size_t                   len,
    struct bj_error**        error
);

BANJO_EXPORT struct bj_datagram* bj_udp_recv(
    struct bj_udp*    udp,
    struct bj_error** error
);

BANJO_EXPORT bj_bool bj_udp_available(
    struct bj_udp* udp
);

BANJO_EXPORT bj_bool bj_udp_wait(
    struct bj_udp* udp,
    uint32_t       ms_timeout
);

BANJO_EXPORT uint16_t bj_udp_local_port(
    const struct bj_udp* udp
);

BANJO_EXPORT size_t bj_udp_local_address(
    const struct bj_udp* udp,
    char*                buf,
    size_t               size
);



BANJO_EXPORT size_t bj_datagram_addr(
    const struct bj_datagram* dgram,
    char*                     buf,
    size_t                    size
);

BANJO_EXPORT uint16_t bj_datagram_port(
    const struct bj_datagram* dgram
);

BANJO_EXPORT const void* bj_datagram_data(
    const struct bj_datagram* dgram
);

BANJO_EXPORT size_t bj_datagram_len(
    const struct bj_datagram* dgram
);

BANJO_EXPORT void bj_close_datagram(
    struct bj_datagram* dgram
);


 
#if defined(BJ_BUILD_DEBUG) || defined(BJ_CONFIG_NET_SIMULATION)

BANJO_EXPORT void bj_tcp_simulate_loss(
    struct bj_tcp_stream* stream,
    int                   percent
);

BANJO_EXPORT void bj_udp_simulate_loss(
    struct bj_udp* udp,
    int            percent
);
 
#endif

 
#endif