Go to main content

man pages section 3: Extended Library Functions, Volume 1

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

sasl_setpass (3sasl)

Name

sasl_setpass - Check a plaintext password

Synopsis

#include <sasl/sasl.h>

int sasl_setpass(sasl_conn_t *conn,
const char *user,
const char *pass, unsigned passlen,
const char *oldpass, unsigned oldpasslen,
unsigned flags)

Description

sasl_setpass(3sasl)             SASL man pages             sasl_setpass(3sasl)



NAME
       sasl_setpass - Check a plaintext password

SYNOPSIS
       #include <sasl/sasl.h>

       int sasl_setpass(sasl_conn_t *conn,
                        const char *user,
                        const char *pass, unsigned passlen,
                         const char *oldpass, unsigned oldpasslen,
                         unsigned flags)


DESCRIPTION
       sasl_setpass  will set passwords in the sasldb, and trigger the setpass
       callbacks for all available mechanisms.

       user is the username to set the password for.

       pass and passlen are the password to set and its length

       oldpass and oldpasslen are the old  password  &  its  length  (and  are
       optional)

       flags  Are  flags  including  SASL_SET_CREATE  and SASL_SET_DISABLE (to
       cause the creating of nonexistent accounts  and  the  disabling  of  an
       account, respectively)



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


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

NOTES
       oldpass  and  oldpasslen  are  unused in the Cyrus SASL implementation,
       though are passed on to any mechanisms that may require them.


       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/.

RETURN VALUE
       Returns SASL_OK on success. SASL error code on failure.


CONFORMING TO
       RFC 4422

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



SASL                             10 July 2001              sasl_setpass(3sasl)