Go to main content

man pages section 3: Extended Library Functions, Volume 1

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

sasl_getcallback_t (3sasl)

Name

sasl_getcallback_t - callback function to lookup a sasl_callback_t for a connection

Synopsis

cc [ flag ... ] file ... -lsasl   [ library ... ]
#include <sasl/saslplug.h>

int sasl_getcallback_t(sasl_conn_t *conn,
unsigned long callbacknum,
int (**proc)( ),
void **pcontext);

Description

sasl_getcallback_t(3sasl)       SASL man pages       sasl_getcallback_t(3sasl)



NAME
       sasl_getcallback_t  - callback function to lookup a sasl_callback_t for
       a connection


SYNOPSIS
       cc [ flag ... ] file ... -lsasl   [ library ... ]
       #include <sasl/saslplug.h>

       int sasl_getcallback_t(sasl_conn_t *conn,
                      unsigned long callbacknum,
                                int (**proc)( ),
                                void **pcontext);


DESCRIPTION
       The sasl_getcallback_t() function is a callback to lookup a  sasl_call-
       back_t for a connection.


PARAMETERS
       conn The connection to lookup a callback for.

       callbacknum The number of the callback.

       proc Pointer to the callback function. The value of proc is set to NULL
       upon failure.

       pcontext Pointer to the callback context. The value of pcontext is  set
       to NULL upon failure.


RETURN VALUES
       Like  other  SASL  callback  functions, sasl_getcallback_t() returns an
       integer that corresponds to a SASL error code. See <sasl.h> for a  com-
       plete list of SASL error codes.


ERRORS
       SASL_OK The call to sasl_getcallback_t() was successful.

       SASL_FAIL
               Unable to find a callback of the requested type.

       SASL_INTERACT
               The caller must use interaction to get data.

               See sasl_errors(3SASL) for information on SASL error codes.



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_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                              27 Oct 2003        sasl_getcallback_t(3sasl)