other versions
- jessie 5.2~20141018-5
- jessie-backports 5.4-7~bpo8+1
- stretch 5.4-7
- testing 5.6-5
- stretch-backports 5.6-4~bpo9+1
- unstable 5.6-5
Connecting to BrlAPI(3) | BrlAPI | Connecting to BrlAPI(3) |
NAME¶
Connecting to BrlAPI -Data Structures¶
struct brlapi_connectionSettings_t
Macros¶
#define BRLAPI_SOCKETPORTNUM 4101
Typedefs¶
typedef int brlapi_fileDescriptor
Functions¶
brlapi_fileDescriptor
Detailed Description¶
Before calling any other function of the library, calling brlapi_openConnection() is needed to establish a connection to BrlAPI 's server. When the connection is not needed any more, brlapi_closeConnection() must be called to close the connection.Macro Definition Documentation¶
#define BRLAPI_AUTHKEYFILE 'brlapi.key'¶
Default name of the file containing BrlAPI 's authorization key This name is relative to BRLAPI_ETCDIR#define BRLAPI_DEFAUTH BRLAPI_ETCDIR '/' BRLAPI_AUTHKEYFILE¶
Default authorization setting#define BRLAPI_ETCDIR '/etc'¶
brltty 's settings directory This is where authorization key and driver-dependent key names are found for instance.#define BRLAPI_SETTINGS_INITIALIZER { NULL, NULL }¶
Allows to initialize a structure of type brlapi_connectionSettings_t * with default values.#define BRLAPI_SOCKETPATH '/var/lib/BrlAPI'¶
Default unix path on which connections to BrlAPI can be established#define BRLAPI_SOCKETPORT '4101'¶
#define BRLAPI_SOCKETPORTNUM 4101¶
Default port number on which connections to BrlAPI can be establishedTypedef Documentation¶
typedef int brlapi_fileDescriptor¶
Function Documentation¶
void BRLAPI_STDCALL brlapi__closeConnection (brlapi_handle_t *handle)¶
brlapi_fileDescriptor BRLAPI_STDCALL brlapi__openConnection (brlapi_handle_t *handle, const brlapi_connectionSettings_t *desiredSettings, brlapi_connectionSettings_t *actualSettings)¶
void BRLAPI_STDCALL brlapi_closeConnection (void)¶
Cleanly close the socket This function locks until a closing acknowledgement is received from the server. The socket is then freed, so the file descriptor brlapi_openConnection() gave has no meaning any morebrlapi_fileDescriptor BRLAPI_STDCALL brlapi_openConnection (const brlapi_connectionSettings_t *desiredSettings, brlapi_connectionSettings_t *actualSettings)¶
Open a socket and connect it to BrlAPI 's server This function first loads an authorization key as specified in settings. It then creates a TCP socket and connects it to the specified machine, on the specified port. It writes the authorization key on the socket and waits for acknowledgement. Returns:the file descriptor, or -1 on error
Note:
The file descriptor is returned in case the client wants
to communicate with the server without using libbrlapi functions. If it
uses them however, it won't have to pass the file descriptor later, since the
library keeps a copy of it. But that also means that
brlapi_openConnection() may be called several times, but
libbrlapi functions will always work with the last call's
descriptor
Example:
1 if (brlapi_openConnection(&settings,&settings)<0) { 2 fprintf(stderr,"couldn't connect to BrlAPI at %s: %s0, 3 settings.host, brlapi_strerror(&brlapi_error)); 4 exit(1); 5 }
BrlAPI might not be on this TCP port, the host
name might not be resolvable, the authorization may fail,...
Parameters:
desiredSettings this gives the desired connection
parameters, as described in brlapi_connectionSettings_t. If NULL,
defaults values are used, so that it is generally a good idea to give NULL as
default, and only fill a brlapi_connectionSettings_t structure when the
user gave parameters to the program for instance;
actualSettings if not NULL, parameters which were actually used are
stored here, if the application ever needs them.
See also:
brlapi_connectionSettings_t
brlapi_writePacket() brlapi_readPacketHeader()
brlapi_readPacketContent() brlapi_readPacket()
Author¶
Generated automatically by Doxygen for BrlAPI from the source code.Thu Apr 16 2015 | Version 1.0 |