globus_gsi_gss_assist_tokens(3) [debian man page]
Security Token Transport(3) globus gss assist Security Token Transport(3) NAME
Security Token Transport - Token Get File Descriptor int globus_gss_assist_token_get_fd (void *arg, void **bufp, size_t *sizep) Token Send File Descriptor int globus_gss_assist_token_send_fd (void *arg, void *buf, size_t size) Token Send File Descriptor Without Length int globus_gss_assist_token_send_fd_without_length (void *arg, void *buf, size_t size) Token Send File Descriptor Flag EX int globus_gss_assist_token_send_fd_ex (void *exp, void *buf, size_t size) Detailed Description Token routines using fread and fwrite. Additional code has been added to detect tokens which are sent without a length field. These can currently be only SSL tokens. This does require some knowledge of the underlying GSSAPI, by the application, but is within the guidelines of the GSSAPI specifications. The get routine will automaticly attempt this test, while a new send routine will check a flag. The old send routine will work as before, sending a 4-byte length. Function Documentation int globus_gss_assist_token_get_fd (void *arg, void **bufp, size_t *sizep) Use a open file discriptor to get a token. This function provides parameter types that allow it to be passed to globus_gss_assist_init_sec_context and globus_gss_assist_accept_sec_context Parameters: arg the FILE * stream cast to a void pointer bufp the resulting token sizep the size (number of bytes) read into bufp Returns: 0 on success > 0 is internal return < 0 is the -errno int globus_gss_assist_token_send_fd (void *arg, void *buf, size_tsize) Write a token to the open file descriptor. WIll write it with a 4 byte length. This function provides parameter types that allow it to be passed to globus_gss_assist_init_sec_context and globus_gss_assist_accept_sec_context Parameters: arg the FILE * stream to send the token on buf the token size the size of the token in bytes Returns: 0 on success >0 on error <0 on errno error int globus_gss_assist_token_send_fd_without_length (void *arg, void *buf, size_tsize) Write a token to the open file descripter. Will write it without a length. so as to int globus_gss_assist_token_send_fd_ex (void *exp, void *buf, size_tsize) Write a token to the open file descripter. will look at the flag to determine if the length field need to be written. Parameters: exp the globus_gss_assist_ex variable that holds the FILE * stream and flags to bet set buf the token buffer to send size size of the token buffer Returns: 0 on success >0 on error <0 on errno error (-errno) Author Generated automatically by Doxygen for globus gss assist from the source code. Version 8.5 Mon Apr 30 2012 Security Token Transport(3)
Check Out this Related Man Page
Driver-Specific modes(3) BrlAPI Driver-Specific modes(3) NAME
Driver-Specific modes - Raw and Suspend Modes mechanism. 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_tsize) int BRLAPI_STDCALL brlapi__resumeDriver (brlapi_handle_t *handle) ssize_t BRLAPI_STDCALL brlapi__sendRaw (brlapi_handle_t *handle, const void *buffer, size_tsize) 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_tsize) 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_tsize) 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. Version 1.0 Mon Apr 1 2013 Driver-Specific modes(3)