---
name: "sasl_errors"
section: "3"
platform: "linux"
package: "libsasl2-dev"
version: "2.1.28+dfsg1-9"
release: "Debian 13 (Trixie)"
platforms: ["linux", "macos"]
url: "https://new.carta.tech/sasl_errors"
---

# sasl\_errors(3)

Cyrus SASL documentation

## NAME

sasl\_errors - Cyrus SASL documentation

## SYNOPSIS

```
#include <sasl/sasl.h>
```

## DESCRIPTION

The  following  are  the  general  error codes that may be returned by calls into the SASL library, and  their  meanings (that may vary slightly based on context).

### Common Result Codes

- **SASL\_OK**

  Success

- **SASL\_CONTINUE**

  Another step is needed in authentication

- **SASL\_FAIL**

  Generic Failure

- **SASL\_NOMEM**

  Memory shortage failure

- **SASL\_BUFOVER**

  Overflowed buffer

- **SASL\_NOMECH**

  Mechanism  not  supported  / No mechanisms matched requirements

- **SASL\_BADPROT**

  Bad / Invalid Protocol or Protocol cancel

- **SASL\_NOTDONE**

  Cannot request information / Not  applicable  until later in exchange

- **SASL\_BADPARAM**

  Invalid Parameter Supplied

- **SASL\_TRYAGAIN**

  Transient Failure (e.g. weak key)

- **SASL\_BADMAC**

  Integrity Check Failed

- **SASL\_NOTINIT**

  SASL library not initialized

### Client-only Result Codes

- **SASL\_INTERACT**

  Needs user interaction

- **SASL\_BADSERV**

  Server failed mutual authentication step

- **SASL\_WRONGMECH**

  Mechanism does not support requested feature

### Server-only Result Codes

- **SASL\_BADAUTH**

  Authentication Failure

- **SASL\_NOAUTHZ**

  Authorization Failure

- **SASL\_TOOWEAK**

  Mechanism too weak for this user

- **SASL\_ENCRYPT**

  Encryption needed to use mechanism

- **SASL\_TRANS**

  One  time  use of a plaintext password will enable requested mechanism for user

- **SASL\_EXPIRED**

  Passphrase expired, must be reset

- **SASL\_DISABLED**

  Account Disabled

- **SASL\_NOUSER**

  User Not Found

- **SASL\_BADVERS**

  Version mismatch with plug-in

- **SASL\_NOVERIFY**

  User exists, but no verifier for user

### Password Setting Result Codes

- **SASL\_PWLOCK**

  Passphrase locked

- **SASL\_NOCHANGE**

  Requested change was not needed

- **SASL\_WEAKPASS**

  Passphrase is too week for security policy.

- **SASL\_NOUSERPASS**

  User supplied passwords are not permitted

## CONFORMING TO

*RFC 4422*

## SEE ALSO

*[sasl(3)](/sasl/3.md)*

## AUTHOR

The Cyrus Team

## COPYRIGHT

1993-2016, The Cyrus Team