130#define BJ_NET_NOHINT BJ_NET_HINT_NONE
132#define BJ_RESOLVE_IPV4 BJ_NET_HINT_IPV4
134#define BJ_RESOLVE_IPV6 BJ_NET_HINT_IPV6
136#define BJ_EXCLUSIVE_BIND BJ_NET_HINT_EXCLUSIVE_BIND
138#define BJ_TCP_DELAY_ACK BJ_NET_HINT_DELAY_ACK
140#define BJ_NONBLOCKING BJ_NET_HINT_NONBLOCKING
142#define BJ_BROADCAST BJ_NET_HINT_BROADCAST
263#define BJ_SHUTDOWN_RECEIVE BJ_NET_SHUTDOWN_RECEIVE
265#define BJ_SHUTDOWN_SEND BJ_NET_SHUTDOWN_SEND
267#define BJ_SHUTDOWN_BOTH BJ_NET_SHUTDOWN_BOTH
275#define BJ_ADDR_STRLEN 46
282#define BJ_NET_BACKLOG_DEFAULT 0
289#define BJ_NET_BACKLOG_MAX (-1)
917 uint16_t hint,
int backlog,
921 uint16_t hint, uint32_t ms_timeout,
925 uint32_t ms_timeout,
struct bj_error** error);
928 uint32_t ms_timeout,
struct bj_error** error);
955 uint16_t hints,
struct bj_error** error);
General-purpose definitions for Banjo API.
bj_audio_play_note_data data
Recoverable error handling.
struct bj_datagram bj_datagram
struct bj_stream bj_stream
struct bj_address bj_address
uint32_t bj_bool
Boolean type used throughout the Banjo API.
struct bj_tcp_listener bj_tcp_listener
struct bj_tcp_stream bj_tcp_stream
struct bj_address * bj_resolve_address(const char *host, uint16_t port, uint16_t hints, struct bj_error **error)
Resolves a hostname to a network address.
bj_bool bj_udp_has_data(struct bj_udp *udp)
Checks if a datagram is available without blocking.
struct bj_datagram * bj_receive_udp(struct bj_udp *udp, struct bj_error **error)
Receives a datagram from the UDP socket.
size_t bj_datagram_addr(const struct bj_datagram *dgram, char *buf, size_t size)
void bj_shutdown_tcp(struct bj_tcp_stream *stream, int mode)
Shuts down part or all of a TCP connection.
bj_bool bj_address_next(struct bj_address *addr)
Advances to the next resolved address.
bj_bool bj_address_equals(const struct bj_address *a, const struct bj_address *b)
Compares two addresses for equality.
bj_bool bj_wait_udp(struct bj_udp *udp, uint32_t ms_timeout)
Waits for data to become available on a UDP socket.
size_t bj_datagram_length(const struct bj_datagram *dgram)
Gets the data length from a datagram.
int bj_send_tcp(struct bj_tcp_stream *stream, const void *buf, size_t len)
Sends data over a TCP stream.
uint16_t bj_tcp_listener_port(const struct bj_tcp_listener *listener)
Get the listening port of the given server.
void bj_close_datagram(struct bj_datagram *dgram)
int bj_tcp_recv(struct bj_tcp_stream *stream, void *buf, size_t len)
uint32_t bj_get_tcp_recv_timeout(struct bj_tcp_stream *stream)
void bj_destroy_tcp_listener(struct bj_tcp_listener *listener)
Closes a TCP listener and releases associated resources.
struct bj_udp * bj_open_udp(const char *host, uint16_t port, uint16_t hints, struct bj_error **error)
size_t bj_tcp_peer_address(const struct bj_tcp_stream *stream, char *buf, size_t size)
Gets the remote address of a TCP stream.
uint16_t bj_datagram_port(const struct bj_datagram *dgram)
Gets the sender's port from a datagram.
void bj_destroy_datagram(struct bj_datagram *dgram)
Closes a datagram and frees resources.
size_t bj_datagram_len(const struct bj_datagram *dgram)
bj_bool bj_set_tcp_send_timeout(struct bj_tcp_stream *stream, uint32_t ms_timeout)
Sets the send timeout for a TCP stream.
uint32_t bj_tcp_receive_timeout(struct bj_tcp_stream *stream)
Gets the current receive timeout.
int bj_send_udp_to(struct bj_udp *udp, const struct bj_address *addr, const void *data, size_t len, struct bj_error **error)
Sends a datagram to a pre-resolved address (no DNS lookup).
struct bj_tcp_stream * bj_connect_tcp_to(struct bj_address *addr, uint16_t hints, uint32_t ms_timeout, struct bj_error **error)
bj_bool bj_set_tcp_keepalive(struct bj_tcp_stream *stream, bj_bool enable)
bj_bool bj_get_tcp_keepalive(struct bj_tcp_stream *stream)
size_t bj_tcp_local_address(const struct bj_tcp_stream *stream, char *buf, size_t size)
Gets the local address of a TCP stream.
bj_bool bj_set_tcp_recv_timeout(struct bj_tcp_stream *stream, uint32_t ms_timeout)
int bj_receive_tcp(struct bj_tcp_stream *stream, void *buf, size_t len)
Receives data from a TCP stream.
void bj_free_address(struct bj_address *addr)
void bj_close_tcp_stream(struct bj_tcp_stream *stream)
int bj_tcp_available(struct bj_tcp_stream *stream)
Checks bytes available to read without blocking.
size_t bj_address_count(const struct bj_address *addr)
Returns number of resolved addresses.
void bj_destroy_udp(struct bj_udp *udp)
Closes a UDP socket.
int bj_udp_send(struct bj_udp *udp, const char *host, uint16_t port, const void *data, size_t len, struct bj_error **error)
struct bj_udp * bj_create_udp(const char *host, uint16_t port, uint16_t hints, struct bj_error **error)
Opens a UDP socket bound to the specified port.
uint16_t bj_udp_local_port(const struct bj_udp *udp)
Gets the local port of a UDP socket.
size_t bj_address_string(const struct bj_address *addr, char *buf, size_t size)
bj_net_hint
Hint flags for network operations.
int bj_tcp_peek(struct bj_tcp_stream *stream, void *buf, size_t len)
uint32_t bj_tcp_send_timeout(struct bj_tcp_stream *stream)
Gets the current send timeout.
int bj_peek_tcp(struct bj_tcp_stream *stream, void *buf, size_t len)
Peek at incoming data without consuming it.
void bj_destroy_address(struct bj_address *addr)
Frees a resolved address.
void bj_address_reset(struct bj_address *addr)
Resets address iteration to the first resolved address.
uint32_t bj_get_tcp_send_timeout(struct bj_tcp_stream *stream)
struct bj_tcp_stream * bj_connect_tcp_stream(const char *host, uint16_t port, uint16_t hint, uint32_t ms_timeout, struct bj_error **error)
Connects to a TCP server at the specified host and port.
bj_bool bj_enable_tcp_keepalive(struct bj_tcp_stream *stream)
Turns on TCP keep-alive probes for a stream.
bj_bool bj_wait_tcp(struct bj_tcp_stream *stream, uint32_t ms_timeout)
Waits for data to become available on a TCP stream.
void bj_tcp_shutdown(struct bj_tcp_stream *stream, int mode)
struct bj_tcp_stream * bj_connect_tcp_stream_to(struct bj_address *addr, uint16_t hints, uint32_t ms_timeout, struct bj_error **error)
Connects to a pre-resolved address, trying all resolved IPs.
bj_bool bj_disable_tcp_keepalive(struct bj_tcp_stream *stream)
Turns off TCP keep-alive probes for a stream.
struct bj_stream * bj_create_stream_from_tcp(struct bj_tcp_stream *tcp, uint32_t flags)
Turns a connected TCP stream into a bj_stream.
struct bj_tcp_stream * bj_accept_tcp_stream(struct bj_tcp_listener *listener, uint32_t ms_timeout, struct bj_error **error)
Accepts an incoming connection on a TCP listener with timeout.
struct bj_tcp_stream * bj_accept_tcp(struct bj_tcp_listener *listener, uint32_t ms_timeout, struct bj_error **error)
void bj_close_tcp_listener(struct bj_tcp_listener *listener)
uint16_t bj_address_port(const struct bj_address *addr)
Gets the port from a resolved address.
bj_bool bj_tcp_has_keepalive(struct bj_tcp_stream *stream)
Reports whether TCP keep-alive is currently enabled on a stream.
int bj_tcp_send(struct bj_tcp_stream *stream, const void *buf, size_t len)
struct bj_tcp_listener * bj_listen_tcp(const char *host, uint16_t port, uint16_t hint, int backlog, struct bj_error **error)
struct bj_tcp_stream * bj_connect_tcp(const char *host, uint16_t port, uint16_t hint, uint32_t ms_timeout, struct bj_error **error)
struct bj_tcp_listener * bj_create_tcp_listener(const char *host, uint16_t port, uint16_t hint, int backlog, struct bj_error **error)
Creates a TCP listener bound to the specified host and port.
bj_bool bj_set_tcp_receive_timeout(struct bj_tcp_stream *stream, uint32_t ms_timeout)
Sets the receive timeout for a TCP stream.
int bj_send_udp(struct bj_udp *udp, const char *host, uint16_t port, const void *data, size_t len, struct bj_error **error)
Sends a datagram to the specified destination.
size_t bj_udp_local_address(const struct bj_udp *udp, char *buf, size_t size)
Gets the local address of a UDP socket (snprintf-style).
bj_bool bj_udp_available(struct bj_udp *udp)
bj_net_shutdown
Shutdown mode for bj_shutdown_tcp.
struct bj_datagram * bj_udp_recv(struct bj_udp *udp, struct bj_error **error)
size_t bj_datagram_address(const struct bj_datagram *dgram, char *buf, size_t size)
Gets the sender's address from a datagram.
void bj_destroy_tcp_stream(struct bj_tcp_stream *stream)
Closes a TCP stream and releases associated resources.
bj_bool bj_tcp_wait(struct bj_tcp_stream *stream, uint32_t ms_timeout)
void bj_close_udp(struct bj_udp *udp)
const void * bj_datagram_data(const struct bj_datagram *dgram)
Gets the data pointer from a datagram.
int bj_udp_send_to(struct bj_udp *udp, const struct bj_address *addr, const void *data, size_t len, struct bj_error **error)
bj_bool bj_udp_wait(struct bj_udp *udp, uint32_t ms_timeout)
size_t bj_address_to_string(const struct bj_address *addr, char *buf, size_t size)
Gets the IP address string from a resolved address.
@ BJ_NET_HINT_EXCLUSIVE_BIND
Disable address reuse.
@ BJ_NET_HINT_BROADCAST
Enable UDP broadcast (SO_BROADCAST).
@ BJ_NET_HINT_NONBLOCKING
Non-blocking mode.
@ BJ_NET_HINT_IPV4
Restrict address resolution to IPv4.
@ BJ_NET_HINT_NONE
No hint provided.
@ BJ_NET_HINT_DELAY_ACK
Enable Nagle's algorithm.
@ BJ_NET_HINT_IPV6
Restrict address resolution to IPv6.
@ BJ_NET_SHUTDOWN_BOTH
Shutdown both send and receive.
@ BJ_NET_SHUTDOWN_RECEIVE
Shutdown receive operations.
@ BJ_NET_SHUTDOWN_SEND
Shutdown send operations.