Go to main content

man pages section 3: Library Interfaces and Headers

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

brlapi__suspendDriver (3)

Name

brlapi__suspendDriver - Specific modes - Raw and Suspend Modes mechanism.

Synopsis

Functions
int BRLAPI_STDCALL brlapi_enterRawMode (const char *driver)
int BRLAPI_STDCALL brlapi__enterRawMode (brlapi_handle_t *handle, const
char *driver)
int BRLAPI_STDCALL brlapi_leaveRawMode (void)
int BRLAPI_STDCALL brlapi__leaveRawMode (brlapi_handle_t *handle)
ssize_t BRLAPI_STDCALL brlapi_sendRaw (const void *buffer, size_t size)
ssize_t BRLAPI_STDCALL brlapi__sendRaw (brlapi_handle_t *handle, const
void *buffer, size_t size)
ssize_t BRLAPI_STDCALL brlapi_recvRaw (void *buffer, size_t size)
ssize_t BRLAPI_STDCALL brlapi__recvRaw (brlapi_handle_t *handle, void
*buffer, size_t size)
int BRLAPI_STDCALL brlapi_suspendDriver (const char *driver)
int BRLAPI_STDCALL brlapi__suspendDriver (brlapi_handle_t *handle,
const char *driver)
int BRLAPI_STDCALL brlapi_resumeDriver (void)
int BRLAPI_STDCALL brlapi__resumeDriver (brlapi_handle_t *handle)

Description

brlapi_driverspecific(3)            BrlAPI            brlapi_driverspecific(3)



NAME
       brlapi_driverspecific - Driver-Specific modes

        - Raw and Suspend Modes mechanism.


SYNOPSIS
   Functions
       int BRLAPI_STDCALL brlapi_enterRawMode (const char *driver)
       int BRLAPI_STDCALL brlapi__enterRawMode (brlapi_handle_t *handle, const
           char *driver)
       int BRLAPI_STDCALL brlapi_leaveRawMode (void)
       int BRLAPI_STDCALL brlapi__leaveRawMode (brlapi_handle_t *handle)
       ssize_t BRLAPI_STDCALL brlapi_sendRaw (const void *buffer, size_t size)
       ssize_t BRLAPI_STDCALL brlapi__sendRaw (brlapi_handle_t *handle, const
           void *buffer, size_t size)
       ssize_t BRLAPI_STDCALL brlapi_recvRaw (void *buffer, size_t size)
       ssize_t BRLAPI_STDCALL brlapi__recvRaw (brlapi_handle_t *handle, void
           *buffer, size_t size)
       int BRLAPI_STDCALL brlapi_suspendDriver (const char *driver)
       int BRLAPI_STDCALL brlapi__suspendDriver (brlapi_handle_t *handle,
           const char *driver)
       int BRLAPI_STDCALL brlapi_resumeDriver (void)
       int BRLAPI_STDCALL brlapi__resumeDriver (brlapi_handle_t *handle)

Detailed Description
       If the application wants to directly talk to the braille terminal, it
       should use Raw Mode. In this special mode, the driver gives the whole
       control of the terminal to it: brltty doesn't work any more.

       For this, it simply has to call brlapi_enterRawMode(), then
       brlapi_sendRaw() and brlapi_recvRaw(), and finally give control back
       thanks to brlapi_leaveRawMode().

       Special care of the terminal should be taken, since one might
       completely trash the terminal's data, or even lock it! The application
       should always check for terminal's type thanks to
       brlapi_getDriverName().

       The client can also make brltty close the driver by using
       brlapi_suspendDriver(), and resume it again with brlapi_resumeDriver().
       This should not be used if possible: raw mode should be sufficient for
       any use. If not, please ask for features :)

Function Documentation
   int BRLAPI_STDCALL brlapi__enterRawMode (brlapi_handle_t * handle, const
       char * driver)
   int BRLAPI_STDCALL brlapi__leaveRawMode (brlapi_handle_t * handle)
   ssize_t BRLAPI_STDCALL brlapi__recvRaw (brlapi_handle_t * handle, void *
       buffer, size_t size)
   int BRLAPI_STDCALL brlapi__resumeDriver (brlapi_handle_t * handle)
   ssize_t BRLAPI_STDCALL brlapi__sendRaw (brlapi_handle_t * handle, const
       void * buffer, size_t size)
   int BRLAPI_STDCALL brlapi__suspendDriver (brlapi_handle_t * handle, const
       char * driver)
   int BRLAPI_STDCALL brlapi_enterRawMode (const char * driver)
       Switch to Raw mode

       Parameters
           driver Specifies the name of the driver for which the raw
           communication will be established.

       Returns
           0 on success, -1 on error

   int BRLAPI_STDCALL brlapi_leaveRawMode (void)
       Leave Raw mode

       Returns
           0 on success, -1 on error

   ssize_t BRLAPI_STDCALL brlapi_recvRaw (void * buffer, size_t size)
       Get Raw data

       Parameters
           buffer points on a buffer where the function will store the
           received data;
           size holds the buffer size.

       Returns
           its size, -1 on error or signal interruption

   int BRLAPI_STDCALL brlapi_resumeDriver (void)
       Resume braille driver

       Returns
           -1 on error

   ssize_t BRLAPI_STDCALL brlapi_sendRaw (const void * buffer, size_t size)
       Send Raw data

       Parameters
           buffer points on the data;
           size holds the packet size.

       Returns
           size on success, -1 on error

   int BRLAPI_STDCALL brlapi_suspendDriver (const char * driver)
       Suspend braille driver

       Parameters
           driver Specifies the name of the driver which will be suspended.

       Returns
           -1 on error

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



ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+------------------------------+
       |ATTRIBUTE TYPE |       ATTRIBUTE VALUE        |
       +---------------+------------------------------+
       |Availability   | library/accessibility/brltty |
       +---------------+------------------------------+
       |Stability      | Pass-through volatile        |
       +---------------+------------------------------+

NOTES
       Source code for open source software components in Oracle Solaris can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-
       code-downloads.html.

       This software was built from source available at
       https://github.com/oracle/solaris-userland.  The original community
       source was downloaded from
       http://mielke.cc/brltty//archive/brltty-6.0.tar.xz.

       Further information about this software can be found on the open source
       community website at http://mielke.cc/brltty/.



Version 0.7                     Mon Jun 27 2022       brlapi_driverspecific(3)