RSP_init

Name

RSP_init -- Initializes RSP Module library.

Synopsis

RSP_moduleBackend RSP_init(const char *name);

Description

This function must be called before any other RSP Module API function can be called. It sets up internal data structures and attempts to establish a connection with the RSPD. Because the RSPD communicates with its modules via pipes, this function sets up those communications channels and prepares them to be used again later.

Returns

A data structure containing the information about your module and the communications channels with the RSPD is returned (if no error occurred). This structure must be passed to other RSP Module API functions.

Error Conditions

If an error occurs, this function will return NULL and set rsp_error to one of the following values: