xbrlapi(1) [debian man page]

XBRLAPI(1)							The BRLTTY Project							XBRLAPI(1)

NAME

       xbrlapi - X11 BrlAPI helper for Linux/Unix

SYNOPSIS

       xbrlapi [option ...]

DESCRIPTION

       xbrlapi	connects  to  a BrlAPI server in order to provide it with the ID of the X11 window which currently has focus.  It also simulates X
       keysyms from braille key presses (else brltty would simulate them using a qwerty keyboard).

OPTIONS

       Options are processed sequentially from left to right.  If an option is specified more than once, or in case of a conflict,  the  rightmost
       specification takes precedence.

       The following options are supported:

       -b [host][:port] (--brlapi=)
	      The BrlAPI server to connect to.

       -a string (--auth=)
	      The BrlAPI authorization/authentication string.

       -d display (--display=)
	      The X display to connect to.  If not specified, the content of the DISPLAY environment variable is used.

       -q (--quiet)
	      Do not write any text to the braille device.

       -h (--help)
	      Print a command line usage summary and then exit.

       -H (--full-help)
	      Print a thorough command line usage summary and then exit.

SEE ALSO

       For   more   details   on   the	purpose  of  xbrlapi,  see  BrlAPI's  on-line  manual  at  [http://mielke.cc/brltty/doc/Manual-BrlAPI/Eng-
       lish/BrlAPI-3.html].

brltty 4.3							     Oct 2011								XBRLAPI(1)

brlapi_connectionSettings_t(3)					      BrlAPI					    brlapi_connectionSettings_t(3)

NAME

       brlapi_connectionSettings_t -

       Settings structure for BrlAPI connection.

SYNOPSIS

       #include <brlapi.h>

   Data Fields
       char * auth
       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';

       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
   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.

   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.

Author
       Generated automatically by Doxygen for BrlAPI from the source code.

Version 1.0							  Fri Jun 7 2013				    brlapi_connectionSettings_t(3)