---
name: "gsasl_saslprep"
section: "3"
platform: "linux"
package: "gsasl"
version: "2.2.4-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/gsasl_saslprep"
---

# gsasl\_saslprep(3)

API function

## NAME

gsasl\_saslprep - API function

## SYNOPSIS

**#include \<gsasl.h\>**

**int gsasl\_saslprep(const char \*** *in***, Gsasl\_saslprep\_flags** *flags***, char \*\*** *out***, int \*** *stringpreprc***);**

## ARGUMENTS

- const char \* in

  a UTF-8 encoded string.

- Gsasl\_saslprep\_flags flags

  any SASLprep flag, e.g., **GSASL\_ALLOW\_UNASSIGNED**.

- char \*\* out

  on exit, contains newly allocated output string.

- int \* stringpreprc

  if non-NULL, will hold precise stringprep return code.

## DESCRIPTION

Prepare string using SASLprep.  On success, the  *out* variable must be deallocated by the caller.

Return value: Returns **GSASL\_OK** on success, or **GSASL\_SASLPREP\_ERROR** on error.

## SINCE

0\.2.3

## REPORTING BUGS

Report bugs to \<bug-gsasl@gnu.org\>.\
 General guidelines for reporting bugs: https://www.gnu.org/gethelp/\
 GNU SASL home page: https://www.gnu.org/software/gsasl/

## COPYRIGHT

Copyright © 2002-2026 Simon Josefsson.\
 Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved.

## SEE ALSO

The full documentation for **gsasl** is maintained as a Texinfo manual.  If the **info** and **gsasl** programs are properly installed at your site, the command

-

  **info gsasl**

should give you access to the complete manual. As an alternative you may obtain the manual from:

-

  **https://www.gnu.org/software/libidn/gsasl/manual/**