Go to main content

man pages section 3: Extended Library Functions, Volume 1

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

sasl_canon_user_t (3sasl)

Name

sasl_canon_user_t - back

Synopsis

#include <sasl/sasl.h>


int sasl_canon_user_t(sasl_conn_t *conn,
void *context,
const char *user, unsigned ulen,
unsigned flags,
const char *user_realm,
char *out_user, unsigned out_umax,
unsigned *out_ulen)

Description

SASL man pages                           sasl_server_userdb_checkpass_t(3sasl)



NAME
       sasl_server_userdb_checkpass_t  - Plaintext Password Verification Call-
       back


SYNOPSIS
       #include <sasl/sasl.h>


       int sasl_canon_user_t(sasl_conn_t *conn,
                             void *context,
                         const char *user, unsigned ulen,
                             unsigned flags,
                             const char *user_realm,
                             char *out_user, unsigned out_umax,
                             unsigned *out_ulen)


DESCRIPTION
       sasl_canon_user_t Is the  callback  for  an  application-supplied  user
       canonicalization  function.   This  function is subject to the require-
       ments that all user canonicalization functions are: It  must  copy  the
       result  into  the  output buffers, but the output buffers and the input
       buffers may be the same.

       context context from the callback record

       user and ulen Un-canonicalized username (and length)

       flags Either SASL_CU_AUTHID (indicating the authentication ID is  being
       canonicalized)  or  SASL_CU_AUTHZID (indicating the authorization ID is
       to be canonicalized) or a bitwise OR of the the two.

       user_realm Realm of authentication.

       out_user and out_umax and out_ulen The output buffer, max  length,  and
       actual length for the username.


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



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_server_userdb_checkpass_t(3sasl)