Data Structures
struct	N_SOCKET
	Structure of a N_SOCKET. More...

struct	NETWORK
	Structure of a NETWORK. More...

struct	NETWORK_POOL
	structure of a network pool More...

Macros
#define	HEAD_CODE 3
	Code of a HEAD message. More...

#define	HEAD_SIZE 10
	Size of a HEAD message. More...

#define	N_ENUM_netw_code_type(_)
	Network codes definition. More...

#define	NETWORK_CONSECUTIVE_SEND_TIMEOUT 8192
	Flag to set consecutive send waiting timeout More...

#define	NETWORK_DEPLETE_TIMEOUT 4096
	Flag to set send buffer depletion timeout More...

#define	NETWORK_IPALL 0
	Flag for auto detection by OS of ip version to use. More...

#define	NETWORK_IPV4 1
	Flag to force IPV4 More...

#define	NETWORK_IPV6 2
	Flag to force IPV6 More...

#define	SOCKET SOCKET_TYPE
	socket macro shortcut More...

Typedefs
typedef int(*	netw_func) (SOCKET, char *, NSTRBYTE)
	send/recv func ptr type More...

typedef int	SOCKET_TYPE
	default socket declaration More...

Functions
	N_ENUM_DECLARE (N_ENUM_netw_code_type, __netw_code_type)
	Network codes declaration.

NETWORK *	netw_accept_from (NETWORK *from)
	make a normal blocking 'accept' . More...

NETWORK *	netw_accept_from_ex (NETWORK from, int send_list_limit, int recv_list_limit, int non_blocking, int retval)
	make a normal 'accept' . More...

NETWORK *	netw_accept_nonblock_from (NETWORK *from, int blocking)
	make a normal blocking 'accept' . More...

int	netw_add_msg (NETWORK netw, N_STR msg)
	Add a message to send in aimed NETWORK. More...

int	netw_add_msg_ex (NETWORK netw, char str, unsigned int length)
	Add a message to send in aimed NETWORK. More...

int	netw_close (NETWORK **netw)
	Closing a specified Network, destroy queues, free the structure. More...

int	netw_connect (NETWORK *netw, char host, char *port, int ip_version)
	Use this to connect a NETWORK to any listening one, unrestricted send/recv lists. More...

int	netw_connect_ex (NETWORK *netw, char host, char *port, int send_list_limit, int recv_list_limit, int ip_version)
	Use this to connect a NETWORK to any listening one. More...

int	netw_destroy_pool (NETWORK_POOL **netw_pool)
	free a NETWORK_POOL *pool More...

N_STR *	netw_get_msg (NETWORK *netw)
	Get a message from aimed NETWORK. More...

int	netw_get_queue_status (NETWORK netw, int nb_to_send, int *nb_to_read)
	retrieve network send queue status More...

int	netw_get_state (NETWORK netw, int state, int *thr_engine_status)
	Get the state of a network. More...

int	netw_init_wsa (int mode, int v1, int v2)
	Do not directly use, internal api. More...

int	netw_make_listening (NETWORK *netw, char addr, char *port, int nbpending, int ip_version)
	Make a NETWORK be a Listening network. More...

NETWORK_POOL *	netw_new_pool (int nb_min_element)
	return a new network pool of nb_min_element More...

int	netw_pool_add (NETWORK_POOL netw_pool, NETWORK netw)
	add a NETWORK netw to a NETWORK_POOL pool More...

int	netw_pool_broadcast (NETWORK_POOL netw_pool, NETWORK from, N_STR *net_msg)
	add net_msg to all network in netork pool More...

int	netw_pool_nbclients (NETWORK_POOL *netw_pool)
	return the number of networks in netw_pool More...

void	netw_pool_netw_close (void *netw_ptr)
	close a network from a network pool More...

int	netw_pool_remove (NETWORK_POOL netw_pool, NETWORK netw)
	remove a NETWORK netw to a NETWORK_POOL pool More...

void *	netw_recv_func (void *NET)
	To Thread Receiving function. More...

void *	netw_send_func (void *NET)
	Thread send function. More...

int	netw_send_ident (NETWORK netw, int type, int id, N_STR name, N_STR *passwd)
	Add a formatted NETWMSG_IDENT message to the specified network. More...

int	netw_send_ping (NETWORK *netw, int type, int id_from, int id_to, int time)
	Add a ping reply to the network. More...

int	netw_send_position (NETWORK *netw, int id, double X, double Y, double vx, double vy, double acc_x, double acc_y, int time_stamp)
	Add a formatted NETWMSG_IDENT message to the specified network. More...

int	netw_send_quit (NETWORK *netw)
	Add a formatted NETMSG_QUIT message to the specified network. More...

int	netw_send_string_to (NETWORK netw, int id_to, N_STR name, N_STR chan, N_STR txt, int color)
	Add a string to the network, aiming a specific user. More...

int	netw_send_string_to_all (NETWORK netw, N_STR name, N_STR chan, N_STR txt, int color)
	Add a string to the network, aiming all server-side users. More...

int	netw_set (NETWORK *netw, int flag)
	Restart or reset the specified network ability. More...

int	netw_set_blocking (NETWORK *netw, unsigned long int is_blocking)
	Modify blocking socket mode. More...

int	netw_set_user_id (NETWORK *netw, int id)
	associate an id and a network More...

int	netw_setsockopt (NETWORK *netw, int optname, int value)
	Modify common socket options on the given netw. More...

int	netw_start_thr_engine (NETWORK *netw)
	Start the NETWORK netw Threaded Engine. More...

int	netw_stop_thr_engine (NETWORK *netw)
	Stop a NETWORK connection sending and receing thread. More...

int	netw_wait_close (NETWORK **netw)
	Wait for peer closing a specified Network, destroy queues, free the structure. More...

int	netw_wait_close_timed (NETWORK **netw, size_t timeout)
	Wait for peer closing a specified Network, destroy queues, free the structure. More...

N_STR *	netw_wait_msg (NETWORK *netw, size_t refresh, size_t timeout)
	Wait a message from aimed NETWORK. More...

int	recv_data (SOCKET s, char *buf, NSTRBYTE n)
	recv data from the socket More...

int	recv_php (SOCKET s, int _code, char *buf)
	recv data from the socket More...

int	send_data (SOCKET s, char *buf, NSTRBYTE n)
	send data onto the socket More...

int	send_php (SOCKET s, int _code, char *buf, int n)
	send data onto the socket More...

Detailed Description

Data Structure Documentation

◆ N_SOCKET

struct N_SOCKET

Structure of a N_SOCKET.

Definition at line 230 of file n_network.h.

Collaboration diagram for N_SOCKET:

Data Fields
struct addrinfo	hints	address of local machine
char *	ip	ip of the connected socket
unsigned long int	is_blocking	flag to quickly check socket mode
char *	port	port of socket
struct sockaddr_storage	raddr	connected remote addr
struct addrinfo *	rhost	getaddrinfo results
SOCKET	sock	a normal socket

◆ NETWORK

struct NETWORK

Structure of a NETWORK.

Examples: ex_network.c.

Definition at line 251 of file n_network.h.

Collaboration diagram for NETWORK:

Data Fields
int	addr_infos_loaded	Internal flag to know if we have to free addr infos.
int	crypto_algo	if encryption is on, which one (flags NETW_ENCRYPT_*)
int	crypto_mode	tell if the socket have to be encrypted (flags NETW_CRYPTO_*)
size_t	deplete_timeout	deplete send buffer ( 0 disabled, > 0 wait for timeout and check unset/unack datas)
pthread_mutex_t	eventbolt	mutex for threaded access of state event
N_SOCKET	link	networking socket
int	mode	NETWORK mode , 1 listening, 0 connecting.
int	nb_pending	Nb pending connection,if listening.
int	nb_running_threads	nb running threads, if > 0 thread engine is still running
LIST *	pools	pointers to network pools if members of any
LIST *	recv_buf	reveicing buffer (for incomming usage)
netw_func	recv_data	receive func ptr
pthread_t	recv_thr	receiving thread
pthread_mutex_t	recvbolt	mutex for threaded access of recv buf
sem_t	send_blocker	block sending func
LIST *	send_buf	sending buffer (for outgoing queuing )
netw_func	send_data	send func ptr
int	send_queue_consecutive_wait	send queue consecutive pool interval, used when there are still items to send, in usec
pthread_t	send_thr	sending thread
pthread_mutex_t	sendbolt	mutex for threaded access of send_buf
int	so_linger	close lingering value (-1 disabled, 0 force close, >0 linger )
int	so_rcvbuf	size of the socket recv buffer, 0 untouched, else size in bytes
int	so_rcvtimeo	send timeout value
int	so_reuseaddr	so reuseaddr state
int	so_sndbuf	size of the socket send buffer, 0 untouched, else size in bytes
int	so_sndtimeo	send timeout value
int	state	state of the connection , NETW_RUN, NETW_QUIT, NETW_STOP , NETW_ERR
int	tcpnodelay	state of naggle algorythm, 0 untouched, 1 forcibly disabled
int	threaded_engine_status	Threaded network engine state for this network. NETW_THR_ENGINE_STARTED or NETW_THR_ENGINE_STOPPED
int	user_id	if part of a user property, id of the user
char *	vigenere_key	vigenere key

◆ NETWORK_POOL

struct NETWORK_POOL

structure of a network pool

Definition at line 340 of file n_network.h.

Collaboration diagram for NETWORK_POOL:

Data Fields
HASH_TABLE *	pool	table of clients
pthread_rwlock_t	rwlock	thread safety

Macro Definition Documentation

◆ HEAD_CODE

#define HEAD_CODE 3

Code of a HEAD message.

Definition at line 39 of file n_network.h.

◆ HEAD_SIZE

#define HEAD_SIZE 10

Size of a HEAD message.

Definition at line 37 of file n_network.h.

◆ N_ENUM_netw_code_type

#define N_ENUM_netw_code_type ( _ )

Value:

                _(NETW_CLIENT, 2)\
                _(NETW_SERVER, 4)\
                _(NETW_RESTART_TIMER, 8)\
                _(NETW_EMPTY_SENDBUF, 16)\
                _(NETW_EMPTY_RECVBUF, 32)\
                _(NETW_RUN, 64)\
                _(NETW_EXIT_ASKED, 128)\
                _(NETW_EXITED, 256)\
                _(NETW_ERROR, 512)\
                _(NETW_CRYPTO_NONE, 1024)\
                _(NETW_CRYPTO_NEGOCIATE, 2048)\
                _(NETW_CRYPTO_MANDATORY, 4096)\
                _(NETW_ENCRYPT_NONE, 8192)\
                _(NETW_ENCRYPT_VIGENERE, 16384)\
                _(NETW_ENCRYPT_OPENSSL, 32768)\
                _(NETW_THR_ENGINE_STARTED, 65536)\
                _(NETW_THR_ENGINE_STOPPED, 131072)\
                _(NETW_DESTROY_RECVBUF, 262144)\
                _(NETW_DESTROY_SENDBUF, 524288)

Network codes definition.

Definition at line 202 of file n_network.h.

◆ NETWORK_CONSECUTIVE_SEND_TIMEOUT

#define NETWORK_CONSECUTIVE_SEND_TIMEOUT 8192

Flag to set consecutive send waiting timeout

Definition at line 35 of file n_network.h.

◆ NETWORK_DEPLETE_TIMEOUT

#define NETWORK_DEPLETE_TIMEOUT 4096

Flag to set send buffer depletion timeout

Definition at line 33 of file n_network.h.

◆ NETWORK_IPALL

#define NETWORK_IPALL 0

Flag for auto detection by OS of ip version to use.

Examples: ex_network.c.

Definition at line 27 of file n_network.h.

◆ NETWORK_IPV4

#define NETWORK_IPV4 1

Flag to force IPV4

Examples: ex_network.c.

Definition at line 29 of file n_network.h.

◆ NETWORK_IPV6

#define NETWORK_IPV6 2

Flag to force IPV6

Examples: ex_network.c.

Definition at line 31 of file n_network.h.

◆ SOCKET

#define SOCKET SOCKET_TYPE

socket macro shortcut

Definition at line 54 of file n_network.h.

Typedef Documentation

◆ netw_func

typedef int(* netw_func) (SOCKET, char *, NSTRBYTE)

send/recv func ptr type

Definition at line 227 of file n_network.h.

◆ SOCKET_TYPE

typedef int SOCKET_TYPE

default socket declaration

socket type for windows

Definition at line 52 of file n_network.h.

Function Documentation

◆ netw_accept_from()

NETWORK * netw_accept_from ( NETWORK * from )

make a normal blocking 'accept' .

Network 'from' must be allocated with netw_make_listening.

Parameters

from	The network from which to obtaion the connection

Returns: NULL

Definition at line 1940 of file n_network.c.

References netw_accept_from_ex().

Here is the call graph for this function:

◆ netw_accept_from_ex()

NETWORK * netw_accept_from_ex	(	NETWORK *	from,
		int	send_list_limit,
		int	recv_list_limit,
		int	non_blocking,
		int *	retval
	)

make a normal 'accept' .

Network 'from' must be allocated with netw_make_listening.

Parameters

from	the network from where we accept
send_list_limit	Internal sending list maximum number of item. 0 or negative for unrestricted
recv_list_limit	Internal receiving list maximum number of item. 0 or negative for unrestricted
non_blocking	set to -1 to make it non blocking, to 0 for blocking, else it's the select timeout value in msecs.
retval	EAGAIN ou EWOULDBLOCK or neterrno (use netstrerr( retval) to obtain a string describing the code )

Returns: NULL on failure, if not a pointer to the connected network

Definition at line 1791 of file n_network.c.

References __n_assert, _str, FreeNoLog, get_in_addr(), LOG_DEBUG, LOG_ERR, LOG_INFO, Malloc, n_log, neterrno, netstrerror, netw_close(), netw_init_wsa(), netw_new(), netw_set(), netw_set_blocking(), and netw_setsockopt().

Referenced by netw_accept_from(), and netw_accept_nonblock_from().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ netw_accept_nonblock_from()

NETWORK * netw_accept_nonblock_from	(	NETWORK *	from,
		int	blocking
	)

make a normal blocking 'accept' .

Network 'from' must be allocated with netw_make_listening.

Parameters

from	The network from which to obtaion the connection
blocking	set to -1 to make it non blocking, to 0 for blocking, else it's the select timeout value in mseconds.

Returns: NULL

Definition at line 1953 of file n_network.c.

References netw_accept_from_ex().

Here is the call graph for this function:

◆ netw_add_msg()

int netw_add_msg	(	NETWORK *	netw,
		N_STR *	msg
	)

Add a message to send in aimed NETWORK.

Parameters

netw	NETWORK where add the message
msg	the message to add

Returns: TRUE if success FALSE on error

Definition at line 1965 of file n_network.c.

References __n_assert, free_nstr_ptr(), list_push(), LOG_ERR, and n_log.

Referenced by netw_pool_broadcast(), netw_send_ident(), netw_send_ping(), netw_send_position(), netw_send_quit(), netw_send_string_to(), netw_send_string_to_all(), send_net_datas(), userlist_add_msg_to_ex(), userlist_send_waiting_msgs(), and userlist_user_send_waiting_msgs().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ netw_add_msg_ex()

int netw_add_msg_ex	(	NETWORK *	netw,
		char *	str,
		unsigned int	length
	)

Add a message to send in aimed NETWORK.

Parameters

netw	NETWORK where add the message
str	the message to add
length	the size of the message to add

Returns: TRUE if success FALSE on error

Definition at line 2001 of file n_network.c.

References __n_assert, free_nstr_ptr(), list_push(), LOG_ERR, Malloc, and n_log.

Here is the call graph for this function:

◆ netw_close()

int netw_close ( NETWORK ** netw )

Closing a specified Network, destroy queues, free the structure.

Parameters

netw	A NETWORK *network to close

Returns: TRUE on success , FALSE on failure

Definition at line 1480 of file n_network.c.

References __n_assert, Free, FreeNoLog, list_destroy(), list_foreach, LOG_DEBUG, n_log, netw_get_state(), netw_pool_remove(), netw_set(), and netw_stop_thr_engine().

Referenced by netw_accept_from_ex(), netw_connect_ex(), netw_make_listening(), netw_new(), netw_set_blocking(), and netw_wait_close_timed().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ netw_connect()

int netw_connect	(	NETWORK **	netw,
		char *	host,
		char *	port,
		int	ip_version
	)

Use this to connect a NETWORK to any listening one, unrestricted send/recv lists.

Parameters

netw	a NETWORK *object
host	Host or IP to connect to
port	Port to use to connect
ip_version	NETWORK_IPALL for both ipv4 and ipv6 , NETWORK_IPV4 or NETWORK_IPV6

Returns: TRUE or FALSE

Definition at line 1361 of file n_network.c.

References _str, LOG_INFO, n_log, and netw_connect_ex().

Here is the call graph for this function:

◆ netw_connect_ex()

int netw_connect_ex	(	NETWORK **	netw,
		char *	host,
		char *	port,
		int	send_list_limit,
		int	recv_list_limit,
		int	ip_version
	)

Use this to connect a NETWORK to any listening one.

Parameters

netw	a NETWORK *object
host	Host or IP to connect to
port	Port to use to connect
send_list_limit	Internal sending list maximum number of item. 0 or negative for unrestricted
recv_list_limit	Internal receiving list maximum number of item. 0 or negative for unrestricted
ip_version	NETWORK_IPALL for both ipv4 and ipv6 , NETWORK_IPV4 or NETWORK_IPV6

Returns: TRUE or FALSE

Definition at line 1226 of file n_network.c.

References __n_assert, _str, Free, FreeNoLog, get_in_addr(), LOG_DEBUG, LOG_ERR, LOG_INFO, Malloc, n_log, neterrno, netstrerror, netw_close(), netw_init_wsa(), netw_new(), netw_set(), NETWORK_IPV4, and NETWORK_IPV6.

Referenced by netw_connect().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ netw_destroy_pool()

int netw_destroy_pool ( NETWORK_POOL ** netw_pool )

free a NETWORK_POOL *pool

Parameters

netw_pool the address of a NETWORK_POOL *pointer to free

Returns: TRUE or FALSE

Definition at line 2869 of file n_network.c.

References __n_assert, destroy_ht(), Free, rw_lock_destroy, unlock, and write_lock.

Here is the call graph for this function:

◆ netw_get_msg()

N_STR * netw_get_msg ( NETWORK * netw )

Get a message from aimed NETWORK.

Parameters

netw	NETWORK where get the msg

Returns: NULL or a filled N_STR

Definition at line 2044 of file n_network.c.

References __n_assert, and list_shift.

Referenced by manage_client(), and netw_wait_msg().

Here is the caller graph for this function:

◆ netw_get_queue_status()

int netw_get_queue_status	(	NETWORK *	netw,
		int *	nb_to_send,
		int *	nb_to_read
	)

retrieve network send queue status

Parameters

netw	NETWORK object
nb_to_send	Number of messages still in send buffer (not yet submitted to kernel)
nb_to_read	Number of message already read by the kernel, waiting in the local message list

Returns: TRUE or FALSE

Definition at line 2825 of file n_network.c.

References __n_assert.

◆ netw_get_state()

int netw_get_state	(	NETWORK *	netw,
		int *	state,
		int *	thr_engine_status
	)

Get the state of a network.

Parameters

netw	The NETWORK *connection to query
state	pointer to network status storage , NETW_RUN , NETW_EXIT_ASKED , NETW_EXITED
thr_engine_status	pointer to network thread engine status storage ,NETW_THR_ENGINE_STARTED , NETW_THR_ENGINE_STOPPED

Returns: TRUE or FALSE

Definition at line 1376 of file n_network.c.

References LOG_ERR, and n_log.

Referenced by manage_client(), netw_close(), netw_recv_func(), netw_send_func(), netw_stop_thr_engine(), netw_wait_close_timed(), and netw_wait_msg().

Here is the caller graph for this function:

◆ netw_init_wsa()

int netw_init_wsa	(	int	mode,
		int	v1,
		int	v2
	)

Do not directly use, internal api.

Initialize winsock dll loading on windows if needed.

Parameters

mode	1 for opening 0 for close 2 for status
v1	First digit of version requested
v2	Second digit of version requested

Returns: TRUE on success FALSE on error

Definition at line 719 of file n_network.c.

Referenced by netw_accept_from_ex(), netw_connect_ex(), and netw_make_listening().

Here is the caller graph for this function:

◆ netw_make_listening()

int netw_make_listening	(	NETWORK **	netw,
		char *	addr,
		char *	port,
		int	nbpending,
		int	ip_version
	)

Make a NETWORK be a Listening network.

Parameters

netw	A NETWORK **network to make listening
addr	Adress to bind, NULL for automatic address filling
port	For choosing a PORT to listen to
nbpending	Number of pending connection when listening
ip_version	NETWORK_IPALL for both ipv4 and ipv6 , NETWORK_IPV4 or NETWORK_IPV6

Returns: TRUE on success, FALSE on error

Definition at line 1665 of file n_network.c.

References __n_assert, _str, FreeNoLog, get_in_addr(), LOG_ERR, Malloc, n_log, neterrno, netstrerror, netw_close(), netw_init_wsa(), netw_new(), netw_set(), netw_setsockopt(), NETWORK_IPV4, and NETWORK_IPV6.

Here is the call graph for this function:

◆ netw_new_pool()

NETWORK_POOL * netw_new_pool ( int nb_min_element )

return a new network pool of nb_min_element

Parameters

nb_min_element size of internal hash table for network pool

Returns: a new NETWORK_POOL or NULL

Definition at line 2847 of file n_network.c.

References __n_assert, Free, init_lock, Malloc, and new_ht().

Here is the call graph for this function:

◆ netw_pool_add()

int netw_pool_add	(	NETWORK_POOL *	netw_pool,
		NETWORK *	netw
	)

add a NETWORK *netw to a NETWORK_POOL *pool

Parameters

netw_pool	targeted network pool
netw	network to add

Returns: TRUE or FALSE

Definition at line 2907 of file n_network.c.

References __n_assert, _nstr, free_nstr, ht_get_ptr(), ht_put_ptr(), list_push(), LOG_DEBUG, LOG_ERR, n_log, netw_pool_netw_close(), nstrprintf, unlock, and write_lock.

Here is the call graph for this function:

◆ netw_pool_broadcast()

int netw_pool_broadcast	(	NETWORK_POOL *	netw_pool,
		NETWORK *	from,
		N_STR *	net_msg
	)

add net_msg to all network in netork pool

Parameters

netw_pool	targeted network pool
from	source network
net_msg	mesage to broadcast

Returns: TRUE or FALSE

Definition at line 3001 of file n_network.c.

References __n_assert, hash_val, ht_foreach, netw_add_msg(), nstrdup(), read_lock, and unlock.

Here is the call graph for this function:

◆ netw_pool_nbclients()

int netw_pool_nbclients ( NETWORK_POOL * netw_pool )

return the number of networks in netw_pool

Parameters

netw_pool targeted network pool

Returns: -1 or the number of networks in netw_pool

Definition at line 3032 of file n_network.c.

References __n_assert, read_lock, and unlock.

◆ netw_pool_netw_close()

void netw_pool_netw_close ( void * netw_ptr )

close a network from a network pool

Parameters

netw_ptr NETWORK *network pointer

Definition at line 2891 of file n_network.c.

References __n_assert, LOG_DEBUG, and n_log.

Referenced by netw_pool_add().

Here is the caller graph for this function:

◆ netw_pool_remove()

int netw_pool_remove	(	NETWORK_POOL *	netw_pool,
		NETWORK *	netw
	)

remove a NETWORK *netw to a NETWORK_POOL *pool

Parameters

netw_pool	targeted network pool
netw	network to remove

Returns: TRUE or FALSE

Definition at line 2960 of file n_network.c.

References __n_assert, _nstr, free_nstr, ht_remove(), list_search(), LOG_DEBUG, LOG_ERR, n_log, nstrprintf, remove_list_node, unlock, and write_lock.

Referenced by netw_close().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ netw_recv_func()

void * netw_recv_func ( void * NET )

To Thread Receiving function.

Parameters

NET	the NETWORK connection to use

Returns: NULL ;

Definition at line 2296 of file n_network.c.

References __n_assert, _str, free_nstr_ptr(), list_push(), LOG_DEBUG, LOG_ERR, Malloc, n_log, netw_get_state(), netw_set(), and NETWORK::recv_data.

Referenced by netw_start_thr_engine().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ netw_send_func()

void * netw_send_func ( void * NET )

Thread send function.

Parameters

NET	the NETWORK connection to use, casted into (void*)

Returns: NULL

Definition at line 2166 of file n_network.c.

References __n_assert, _str, free_nstr, list_shift, LOG_DEBUG, LOG_ERR, n_log, netw_get_state(), netw_set(), NETWORK::send_data, and u_sleep().

Referenced by netw_start_thr_engine().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ netw_send_ident()

int netw_send_ident	(	NETWORK *	netw,
		int	type,
		int	id,
		N_STR *	name,
		N_STR *	passwd
	)

Add a formatted NETWMSG_IDENT message to the specified network.

Parameters

netw	The aimed NETWORK where we want to add something to send
type	type of identification ( NETW_IDENT_REQUEST , NETW_IDENT_NEW )
id	The ID of the sending client
name	Username
passwd	Password

Returns: TRUE or FALSE

Definition at line 3092 of file n_network.c.

References __n_assert, netmsg_make_ident(), and netw_add_msg().

Here is the call graph for this function:

◆ netw_send_ping()

int netw_send_ping	(	NETWORK *	netw,
		int	type,
		int	id_from,
		int	id_to,
		int	time
	)

Add a ping reply to the network.

Parameters

netw	The aimed NETWORK where we want to add something to send
id_from	Identifiant of the sender
id_to	Identifiant of the destination, -1 if the serveur itslef is targetted
time	The time it was when the ping was sended
type	NETW_PING_REQUEST or NETW_PING_REPLY

Returns: TRUE or FALSE

Definition at line 3070 of file n_network.c.

References __n_assert, netmsg_make_ping(), and netw_add_msg().

Here is the call graph for this function:

◆ netw_send_position()

int netw_send_position	(	NETWORK *	netw,
		int	id,
		double	X,
		double	Y,
		double	vx,
		double	vy,
		double	acc_x,
		double	acc_y,
		int	time_stamp
	)

Add a formatted NETWMSG_IDENT message to the specified network.

Parameters

netw	The aimed NETWORK where we want to add something to send
id	The ID of the sending client
X	X position inside a big grid
Y	Y position inside a big grid
vx	X speed
vy	Y speed
acc_x	Y acceleration
acc_y	X acceleration
time_stamp	Current Time when sending (for some delta we would want to compute )

Returns: TRUE or FALSE

Definition at line 3119 of file n_network.c.

References __n_assert, netmsg_make_position_msg(), and netw_add_msg().

Here is the call graph for this function:

◆ netw_send_quit()

int netw_send_quit ( NETWORK * netw )

Add a formatted NETMSG_QUIT message to the specified network.

Parameters

netw	The aimed NETWORK

Returns: TRUE or FALSE

Definition at line 3186 of file n_network.c.

References __n_assert, netmsg_make_quit_msg(), and netw_add_msg().

Here is the call graph for this function:

◆ netw_send_string_to()

int netw_send_string_to	(	NETWORK *	netw,
		int	id_to,
		N_STR *	name,
		N_STR *	chan,
		N_STR *	txt,
		int	color
	)

Add a string to the network, aiming a specific user.

Parameters

netw	The aimed NETWORK where we want to add something to send
id_to	The ID of the targetted client
name	Sender Name
chan	channel to use
txt	Sender text
color	Sender text color

Returns: TRUE or FALSE

Definition at line 3144 of file n_network.c.

References __n_assert, netmsg_make_string_msg(), and netw_add_msg().

Here is the call graph for this function:

◆ netw_send_string_to_all()

int netw_send_string_to_all	(	NETWORK *	netw,
		N_STR *	name,
		N_STR *	chan,
		N_STR *	txt,
		int	color
	)

Add a string to the network, aiming all server-side users.

Parameters

netw	The aimed NETWORK where we want to add something to send
name	Name of user
chan	Target Channel, if any. Pass "ALL" to target the default channel
txt	The text to send
color	The color of the text

Returns: TRUE or FALSE;

Definition at line 3167 of file n_network.c.

References __n_assert, netmsg_make_string_msg(), and netw_add_msg().

Here is the call graph for this function:

◆ netw_set()

int netw_set	(	NETWORK *	netw,
		int	flag
	)

Restart or reset the specified network ability.

Parameters

netw	The NETWORK *connection to modify
flag	NETW_EMPTY_SENDBUF, NETW_EMPTY_RECVBUF, NETW_RUN , NETW_EXIT_ASKED , NETW_EXITED

Returns: TRUE or FALSE

Definition at line 1403 of file n_network.c.

References list_destroy(), and list_empty().

Referenced by netw_accept_from_ex(), netw_close(), netw_connect_ex(), netw_make_listening(), netw_recv_func(), netw_send_func(), and netw_stop_thr_engine().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ netw_set_blocking()

int netw_set_blocking	(	NETWORK *	netw,
		unsigned long int	is_blocking
	)

Modify blocking socket mode.

Parameters

netw	The network to configure
is_blocking	0 NON BLOCk , 1 BLOCK

Returns: TRUE or FALSE

Definition at line 773 of file n_network.c.

References __n_assert, _str, FreeNoLog, LOG_DEBUG, LOG_ERR, n_log, neterrno, netstrerror, and netw_close().

Referenced by netw_accept_from_ex().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ netw_set_user_id()

int netw_set_user_id	(	NETWORK *	netw,
		int	id
	)

associate an id and a network

Parameters

netw	targeted network
id	id we want to associated with

Returns: TRUE or FALSE

Definition at line 3052 of file n_network.c.

References __n_assert.

◆ netw_setsockopt()

int netw_setsockopt	(	NETWORK *	netw,
		int	optname,
		int	value
	)

Modify common socket options on the given netw.

Parameters

netw	The socket to configure
optname	NETWORK_DEPLETE_TIMEOUT,NETWORK_CONSECUTIVE_SEND_TIMEOUT ,SO_REUSEADDR,TCP_NODELAY,SO_SNDBUF,SO_RCVBUF,SO_LINGER,SO_RCVTIMEO,SO_SNDTIMEO. Please refer to man setsockopt for details
value	The value of the socket parameter

Returns: TRUE or FALSE

Definition at line 830 of file n_network.c.

References __n_assert, _str, FreeNoLog, LOG_ERR, n_log, neterrno, netstrerror, NETWORK_CONSECUTIVE_SEND_TIMEOUT, and NETWORK_DEPLETE_TIMEOUT.

Referenced by netw_accept_from_ex(), and netw_make_listening().

Here is the caller graph for this function:

◆ netw_start_thr_engine()

int netw_start_thr_engine ( NETWORK * netw )

Start the NETWORK netw Threaded Engine.

Create a sending & receiving thread.

Parameters

netw	The aimed NETWORK connection to start receiving data

Returns: TRUE on success FALSE on failure

Definition at line 2125 of file n_network.c.

References __n_assert, _str, LOG_ERR, n_log, netw_recv_func(), and netw_send_func().

Referenced by manage_client().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ netw_stop_thr_engine()

int netw_stop_thr_engine ( NETWORK * netw )

Stop a NETWORK connection sending and receing thread.

Parameters

netw	The aimed NETWORK conection to stop

Returns: TRUE on success FALSE on failure

Definition at line 2446 of file n_network.c.

References __n_assert, LOG_DEBUG, LOG_ERR, n_log, netw_get_state(), and netw_set().

Referenced by netw_close().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ netw_wait_close()

int netw_wait_close ( NETWORK ** netw )

Wait for peer closing a specified Network, destroy queues, free the structure.

Default 30 seconds timeout

Warning: Do not use on the accept socket itself (the server socket) as it will display false errors

Parameters

netw	A NETWORK *network to close

Returns: TRUE on success , FALSE on failure

Definition at line 1574 of file n_network.c.

References netw_wait_close_timed().

Referenced by manage_client().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ netw_wait_close_timed()

int netw_wait_close_timed	(	NETWORK **	netw,
		size_t	timeout
	)

Wait for peer closing a specified Network, destroy queues, free the structure.

Warning: Do not use on the accept socket itself (the server socket) as it will display false errors

Parameters

netw	A NETWORK *network to close
timeout	timeout in seconds before force close engine , 0 to instantly close (not recommanded)

Returns: TRUE on success , FALSE on failure

Definition at line 1589 of file n_network.c.

References __n_assert, _str, deplete_send_buffer(), FreeNoLog, LOG_ERR, N_ENUM_ENTRY, n_log, neterrno, netstrerror, netw_close(), and netw_get_state().

Referenced by netw_wait_close().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ netw_wait_msg()

N_STR * netw_wait_msg	(	NETWORK *	netw,
		size_t	refresh,
		size_t	timeout
	)

Wait a message from aimed NETWORK.

Recheck each usec until a valid

Parameters

netw	The link on which we wait a message
refresh	The time in usec between each check until there is a message
timeout	in usecs , maximum amount of time to wait before return. 0 to disable.

Returns: NULL or a filled N_STR

Definition at line 2068 of file n_network.c.

References __n_assert, LOG_ERR, N_ENUM_ENTRY, n_log, netw_get_msg(), netw_get_state(), and u_sleep().

Here is the call graph for this function:

◆ recv_data()

int recv_data	(	SOCKET	s,
		char *	buf,
		NSTRBYTE	n
	)

recv data from the socket

Parameters

s	connected socket
buf	pointer to buffer
n	number of characters we want

Returns: -1 on error, -2 on disconnection n on success

Definition at line 2541 of file n_network.c.

References __n_assert, _str, CALL_RETRY, FreeNoLog, LOG_DEBUG, LOG_ERR, n_log, neterrno, and netstrerror.

Referenced by netw_new().

Here is the caller graph for this function:

◆ recv_php()

int recv_php	(	SOCKET	s,
		int *	_code,
		char **	buf
	)

recv data from the socket

Parameters

s	connected socket
_code	pointer to store the code
buf	pointer to buffer

Returns: -1 on error, size on success

Definition at line 2695 of file n_network.c.

References _str, Free, FreeNoLog, HEAD_CODE, HEAD_SIZE, LOG_ERR, Malloc, n_log, neterrno, and netstrerror.

◆ send_data()

int send_data	(	SOCKET	s,
		char *	buf,
		NSTRBYTE	n
	)

send data onto the socket

Parameters

s	connected socket
buf	pointer to buffer
n	number of characters we want to send

Returns: -1 on error, -2 on disconnection, n on success

Definition at line 2489 of file n_network.c.

References __n_assert, _str, FreeNoLog, LOG_DEBUG, LOG_ERR, n_log, neterrno, and netstrerror.

Referenced by netw_new().

Here is the caller graph for this function:

◆ send_php()

int send_php	(	SOCKET	s,
		int	_code,
		char *	buf,
		int	n
	)

send data onto the socket

Parameters

s	connected socket
buf	pointer to buffer
n	number of characters we want to send
_code	Code for php decoding rule

Returns: -1 on error, n on success

Definition at line 2596 of file n_network.c.

References _str, CALL_RETRY, FreeNoLog, HEAD_CODE, HEAD_SIZE, LOG_ERR, n_log, neterrno, and netstrerror.

Data Structures

Macros

Typedefs

Functions

Detailed Description

Data Structure Documentation

◆ N_SOCKET

◆ NETWORK

◆ NETWORK_POOL

Macro Definition Documentation

◆ HEAD_CODE

◆ HEAD_SIZE

◆ N_ENUM_netw_code_type

◆ NETWORK_CONSECUTIVE_SEND_TIMEOUT

◆ NETWORK_DEPLETE_TIMEOUT

◆ NETWORK_IPALL

◆ NETWORK_IPV4

◆ NETWORK_IPV6

◆ SOCKET

Typedef Documentation

◆ netw_func

◆ SOCKET_TYPE

Function Documentation

◆ netw_accept_from()

◆ netw_accept_from_ex()

◆ netw_accept_nonblock_from()

◆ netw_add_msg()

◆ netw_add_msg_ex()

◆ netw_close()

◆ netw_connect()

◆ netw_connect_ex()

◆ netw_destroy_pool()

◆ netw_get_msg()

◆ netw_get_queue_status()

◆ netw_get_state()

◆ netw_init_wsa()

◆ netw_make_listening()

◆ netw_new_pool()

◆ netw_pool_add()

◆ netw_pool_broadcast()

◆ netw_pool_nbclients()

◆ netw_pool_netw_close()

◆ netw_pool_remove()

◆ netw_recv_func()

◆ netw_send_func()

◆ netw_send_ident()

◆ netw_send_ping()

◆ netw_send_position()

◆ netw_send_quit()

◆ netw_send_string_to()

◆ netw_send_string_to_all()

◆ netw_set()

◆ netw_set_blocking()

◆ netw_set_user_id()

◆ netw_setsockopt()

◆ netw_start_thr_engine()

◆ netw_stop_thr_engine()

◆ netw_wait_close()

◆ netw_wait_close_timed()

◆ netw_wait_msg()

◆ recv_data()

◆ recv_php()

◆ send_data()

◆ send_php()