---
name: "sasl_errstring"
section: "3"
platform: "macos"
package: "passwordserver_sasl"
version: "215"
release: "macOS 26.5"
platforms: ["linux", "macos"]
url: "https://new.carta.tech/sasl_errstring"
---

# sasl\_errstring(3)

Translate a SASL return code to a human-readable form

## NAME

sasl\_errstring - Translate a SASL return code to a human-readable form

## SYNOPSIS

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

const char * sasl_errstring(int saslerr,
			        const char * langlist,
			        const char ** outlang);
```

## DESCRIPTION

**sasl\_usererr** is called to convert a SASL return code (an integer) into a human readable string. At this time the only language available is american english written by programmers (aka gobbledygook). Note that a server should call sasl\_usererr on a return code first if the string is going to be sent to the client.

*saslerr* specifies the error number to convert.

*langlist* is currently unused; Use NULL.

*outlang* specifies the desired RFC 1766 language for output.  NULL defaults to "en-us," currently the only supported language.

It should be noted that this function is not the recommended means of extracting error code information from SASL, instead application should use [sasl\_errdetail(3)](/sasl_errdetail/3.md), which contains this information (and more)

## RETURN VALUE

Returns the string.  If langlist is NULL, US-ASCII is used.

## CONFORMING TO

RFC 4422

## SEE ALSO

[sasl(3)](/sasl/3.md), [sasl\_errdetail(3)](/sasl_errdetail/3.md), [sasl\_errors(3)](/sasl_errors/3.md)
