Data Fields | |
| void(* | server_ready )(vtm_nm_dgram_srv *srv, struct vtm_nm_dgram_srv_opts *opts) |
| void(* | worker_init )(vtm_nm_dgram_srv *srv, vtm_dataset *wd) |
| void(* | worker_end )(vtm_nm_dgram_srv *srv, vtm_dataset *wd) |
| void(* | msg_recv )(vtm_nm_dgram_srv *srv, vtm_dataset *wd, vtm_dataset *msg, const struct vtm_socket_saddr *saddr) |
Holds the user defined callbacks for a NM datagram server.
When a specific callback is not needed, then is MUST be set to NULL.
Unless otherwise stated each callback function is called from a worker-thread. When the server runs in single-threaded mode, the functions are called from the main thread that started the server.
| void(* vtm_nm_dgram_srv_cbs::server_ready)(vtm_nm_dgram_srv *srv, struct vtm_nm_dgram_srv_opts *opts) |
This function is called when the socket of the server was successfully created and is ready to receive incoming datagram packets.
The function is called in the same thread that called vtm_nm_dgram_srv_run().
| srv | the server which is ready |
| opts | the options with which the server was started |
| void(* vtm_nm_dgram_srv_cbs::worker_init)(vtm_nm_dgram_srv *srv, vtm_dataset *wd) |
This function is is called during startup phase of the server for each worker thread.
| srv | the server |
| wd | an empty dataset set. The same dataset is later delivered to this thread in the other callbacks. You can store things here that may be used during processing of client messages, for example a database connection. |
| void(* vtm_nm_dgram_srv_cbs::worker_end)(vtm_nm_dgram_srv *srv, vtm_dataset *wd) |
This function is called during shutdown phase of the server for each worker thread.
| srv | the server |
| wd | the working dataset |
| void(* vtm_nm_dgram_srv_cbs::msg_recv)(vtm_nm_dgram_srv *srv, vtm_dataset *wd, vtm_dataset *msg, const struct vtm_socket_saddr *saddr) |
A new message was received.
| srv | the server |
| wd | the working dataset |
| msg | the received message |
| saddr | the address from where the message was sent |
1.8.8