48 lines
1.1 KiB
C
48 lines
1.1 KiB
C
/* Handles communication with clients. */
|
|
|
|
#include <moxerver.h>
|
|
|
|
/**
|
|
* Closes a client connection.
|
|
*/
|
|
void client_close(client_t *client);
|
|
|
|
/**
|
|
* Reads data from a client into the client data buffer.
|
|
* Also updates the timestamp of the client's last activity.
|
|
*
|
|
* Returns:
|
|
* - number of read bytes on success,
|
|
* - negative ENODATA value (-ENODATA) if the client has disconnected,
|
|
* - negative errno value set by an error while reading
|
|
*/
|
|
int client_read(client_t *client);
|
|
|
|
/**
|
|
* Sends data from a buffer to the client.
|
|
*
|
|
* Returns:
|
|
* - number of sent bytes on success,
|
|
* - negative errno value set by an error while sending
|
|
*/
|
|
int client_write(client_t *client, char *databuf, int datalen);
|
|
|
|
/**
|
|
* Waits for input from the client in "line mode" (client sends a whole line of
|
|
* characters). The function blocks until input arrives.
|
|
*
|
|
* Returns:
|
|
* - 0 on success
|
|
* - negative value if error occurred
|
|
*/
|
|
int client_wait_line(client_t *client);
|
|
|
|
/**
|
|
* Asks the client to provide a username.
|
|
* Blocks until a string is provided.
|
|
*
|
|
* Returns:
|
|
* - 0 on success
|
|
* - negative value if error occurred
|
|
*/
|
|
int client_ask_username(client_t *client);
|