libdrizzle Developer Documentation

Functions
Connection Declarations for Servers
Drizzle Server Interface

Functions

drizzle_return_t drizzle_con_listen (drizzle_con_st *con)
int drizzle_con_backlog (const drizzle_con_st *con)
void drizzle_con_set_backlog (drizzle_con_st *con, int backlog)
void drizzle_con_set_protocol_version (drizzle_con_st *con, uint8_t protocol_version)
void drizzle_con_set_server_version (drizzle_con_st *con, const char *server_version)
void drizzle_con_set_thread_id (drizzle_con_st *con, uint32_t thread_id)
void drizzle_con_set_scramble (drizzle_con_st *con, const uint8_t *scramble)
void drizzle_con_set_capabilities (drizzle_con_st *con, drizzle_capabilities_t capabilities)
void drizzle_con_set_charset (drizzle_con_st *con, drizzle_charset_t charset)
void drizzle_con_set_status (drizzle_con_st *con, drizzle_con_status_t status)
void drizzle_con_set_max_packet_size (drizzle_con_st *con, uint32_t max_packet_size)
void drizzle_con_copy_handshake (drizzle_con_st *con, drizzle_con_st *from)
void * drizzle_con_command_read (drizzle_con_st *con, drizzle_command_t *command, size_t *offset, size_t *size, size_t *total, drizzle_return_t *ret_ptr)
void * drizzle_con_command_buffer (drizzle_con_st *con, drizzle_command_t *command, size_t *total, drizzle_return_t *ret_ptr)

Detailed Description

These functions extend the core connection functions with a set of functions for server application use. These functions allow you to set raw handshake information for use with the handshake write functions.


Function Documentation

Put a connection into listening mode.

Parameters:
[in]conConnection structure previously initialized with drizzle_con_create(), drizzle_con_clone(), or related functions.
Returns:
Standard drizzle return value.

Definition at line 510 of file conn.c.

int drizzle_con_backlog ( const drizzle_con_st con)

Get connection backlog queue length.

Parameters:
[in]conConnection structure previously initialized with drizzle_con_create(), drizzle_con_clone(), or related functions.
Returns:
Backlog for connection

Definition at line 524 of file conn.c.

void drizzle_con_set_backlog ( drizzle_con_st con,
int  backlog 
)

Set connection backlog queue length.

Parameters:
[in]conConnection structure previously initialized with drizzle_con_create(), drizzle_con_clone(), or related functions.
[in]backlogBacklog to use for connection

Definition at line 529 of file conn.c.

void drizzle_con_set_protocol_version ( drizzle_con_st con,
uint8_t  protocol_version 
)

Set protocol version for a connection.

Parameters:
[in]conConnection structure previously initialized with drizzle_con_create(), drizzle_con_clone(), or related functions.
[in]protocol_versionProtocol version to use for connection

Definition at line 534 of file conn.c.

void drizzle_con_set_server_version ( drizzle_con_st con,
const char *  server_version 
)

Set server version string for a connection.

Parameters:
[in]conConnection structure previously initialized with drizzle_con_create(), drizzle_con_clone(), or related functions.
[in]server_versionServer version to use for connection

Definition at line 540 of file conn.c.

void drizzle_con_set_thread_id ( drizzle_con_st con,
uint32_t  thread_id 
)

Set thread ID for a connection.

Parameters:
[in]conConnection structure previously initialized with drizzle_con_create(), drizzle_con_clone(), or related functions.
[in]thread_idThread ID to use for connection

Definition at line 553 of file conn.c.

void drizzle_con_set_scramble ( drizzle_con_st con,
const uint8_t *  scramble 
)

Set scramble buffer for a connection.

Parameters:
[in]conConnection structure previously initialized with drizzle_con_create(), drizzle_con_clone(), or related functions.
[in]scrambleScramble to use for connection

Definition at line 558 of file conn.c.

Set capabilities for a connection.

Parameters:
[in]conConnection structure previously initialized with drizzle_con_create(), drizzle_con_clone(), or related functions.
[in]capabilitiesCapabilities to use for connection

Definition at line 569 of file conn.c.

Set charset for a connection.

Parameters:
[in]conConnection structure previously initialized with drizzle_con_create(), drizzle_con_clone(), or related functions.
[in]charsetCharacter set to use for connection

Definition at line 575 of file conn.c.

Set status for a connection.

Parameters:
[in]conConnection structure previously initialized with drizzle_con_create(), drizzle_con_clone(), or related functions.
[in]statusStatus to use for connection

Definition at line 580 of file conn.c.

void drizzle_con_set_max_packet_size ( drizzle_con_st con,
uint32_t  max_packet_size 
)

Set max packet size for a connection.

Parameters:
[in]conConnection structure previously initialized with drizzle_con_create(), drizzle_con_clone(), or related functions.
[in]max_packet_sizeMax packet size to use for connection

Definition at line 585 of file conn.c.

Copy all handshake information from one connection into another.

Parameters:
[in]conConnection structure previously initialized with drizzle_con_create(), drizzle_con_clone(), or related functions.
[in]fromConnection structure to copy from.

Definition at line 591 of file conn.c.

void* drizzle_con_command_read ( drizzle_con_st con,
drizzle_command_t command,
size_t *  offset,
size_t *  size,
size_t *  total,
drizzle_return_t ret_ptr 
)

Read command without buffering.

Parameters:
[in]conConnection structure previously initialized with drizzle_con_create(), drizzle_con_clone(), or related functions.
[out]commandCommand that was read.
[out]offsetWhere the data being returned begins in the command data.
[out]sizeThe size of the data chunk being returned.
[out]totalThe total size of all command data being read.
[out]ret_ptrStandard drizzle return value.
Returns:
On success, a pointer to an internal buffer with the command data. It will be *size bytes in length.

Definition at line 606 of file conn.c.

void* drizzle_con_command_buffer ( drizzle_con_st con,
drizzle_command_t command,
size_t *  total,
drizzle_return_t ret_ptr 
)

Read command and buffer it.

Parameters:
[in]conConnection structure previously initialized with drizzle_con_create(), drizzle_con_clone(), or related functions.
[out]commandCommand that was read.
[out]totalThe total size of all command data being read.
[out]ret_ptrStandard drizzle return value.
Returns:
On success, allocated buffer that holds the command data of length *total.

Definition at line 634 of file conn.c.