Go to main content

man pages section 3: Extended Library Functions, Volume 1

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

sasl_getopt_t (3sasl)

Name

sasl_getopt_t - The SASL get option callback

Synopsis

#include <sasl/sasl.h>


int sasl_getopt_t(void *context,
const char *plugin_name,
const char *option,
const char ** result,
unsigned * len);

Description

sasl_getopt_t(3sasl)            SASL man pages            sasl_getopt_t(3sasl)



NAME
       sasl_getopt_t - The SASL get option callback



SYNOPSIS
       #include <sasl/sasl.h>


       int sasl_getopt_t(void *context,
                      const char *plugin_name,
                      const char *option,
                      const char ** result,
                      unsigned * len);


DESCRIPTION
       sasl_getopt_t  is used to retrieve an option, often mechanism specific,
       from the application. An example of this is requested what  KERBEROS_V4
       srvtab  file  to  use.   plugin_name  is  the plugin this value if for.
       option is a string representing the option. A common  option  that  all
       server  applications  should  handle  is  method for checking plaintext
       passwords. See the administrators guide for a full description of  this
       option.

       Memory  management of options supplied by the getopt callback should be
       done by the application, however,  any  requested  option  must  remain
       available  until  the  callback  is  no  longer  valid.   That is, when
       sasl_dispose is called for a the connection it is associated  with,  or
       sasl_done is called for global callbacks.

RETURN VALUE
       SASL callback functions should return SASL return codes. See sasl.h for
       a complete list. SASL_OK indicates success.


CONFORMING TO
       RFC 4422


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


       +---------------+----------------------------------+
       |ATTRIBUTE TYPE |         ATTRIBUTE VALUE          |
       +---------------+----------------------------------+
       |Availability   | system/library/security/libsasl2 |
       +---------------+----------------------------------+
       |Stability      | Pass-through volatile            |
       +---------------+----------------------------------+

SEE ALSO
       sasl(3SASL), sasl_callbacks(3SASL), sasl_errors(3SASL)



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   ftp://ftp.cyrusimap.org/cyrus-sasl/cyrus-
       sasl-2.1.26.tar.gz.

       Further information about this software can be found on the open source
       community website at https://www.cyrusimap.org/sasl/.



SASL                             10 July 2001             sasl_getopt_t(3sasl)