BrlAPI 0.8

Data Fields
brlapi_connectionSettings_t Struct Reference
Connecting to BrlAPI

Settings structure for BrlAPI connection. More...

`#include <brlapi.h>`

## Data Fields
const char * | auth
const char * | host

## Detailed Description

This structure holds every parameter needed to connect to BrlAPI: which file the authorization key can be found in and which computer to connect to.

Examples:
  brlapi_connectionSettings_t settings;
  settings.auth="/etc/brlapi.key";
  settings.host="foo";
  brlapi_connectionSettings_t
  Settings structure for BrlAPI connection.
  Definition brlapi.h:214
  brlapi_connectionSettings_t::host
  const char * host
  Definition brlapi.h:232
  brlapi_connectionSettings_t::auth
  const char * auth
  Definition brlapi.h:222

libbrlapi will read authorization key from file `/etc/brlapi`.key and connect to the machine called "foo", on the default TCP port.

settings.host="10.1.0.2";

lets directly enter an IP address instead of a machine name.

settings.host=":1";

lets libbrlapi connect to the local computer, on port BRLAPI_SOCKETPORTNUM+1

See also
  brlapi_openConnection()

## Field Documentation

## ◆ auth

const char* brlapi_connectionSettings_t::auth

For security reasons, libbrlapi has to get authorized to connect to the BrlAPI server. This can be done via a secret key, for instance. This is the path to the file which holds it; it will hence have to be readable by the application.

Setting `NULL` defaults it to local installation setup or to the content of the BRLAPI_AUTH environment variable, if it exists.

## ◆ host

const char* brlapi_connectionSettings_t::host

This tells where the BrlAPI server resides: it might be listening on another computer, on any TCP port. It should look like "foo:1", which means TCP port number BRLAPI_SOCKETPORTNUM+1 on computer called "foo".

Note
  Please check that resolving this name works before complaining

Settings `NULL` defaults it to localhost, using the local installation's default TCP port, or to the content of the BRLAPI_HOST environment variable, if it exists.

The documentation for this struct was generated from the following file:

- brlapi.h