---
name: "gsasl_stringprep_trace"
section: "3"
platform: "linux"
package: "libgsasl-dev"
version: "1.10.0-4+deb11u1"
release: "Debian 11 (Bullseye)"
platforms: ["linux"]
url: "https://new.carta.tech/gsasl_stringprep_trace"
---

# gsasl\_stringprep\_trace(3)

API function

## NAME

gsasl\_stringprep\_trace - API function

## SYNOPSIS

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

**char \* gsasl\_stringprep\_trace(const char \*** *in***, int \*** *stringprep\_rc***);**

## ARGUMENTS

- const char \* in

  input ASCII or UTF-8 string with data to prepare according to "trace".

- int \* stringprep\_rc

  pointer to output variable with stringprep error code, or NULL to indicate that you don't care about it.

## DESCRIPTION

Process a Unicode string for use as trace information, according to the "trace" stringprep profile.  The profile is designed for use with the SASL ANONYMOUS Mechanism.

Return value: Return a newly allocated string that is the "trace" processed form of the input string, or NULL on error, in which case  *stringprep\_rc* contain the stringprep library error code.

## DEPRECATED

No replacement functionality in GNU SASL, use GNU Libidn instead.

## REPORTING BUGS

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

## COPYRIGHT

Copyright © 2002-2021 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:

-

  **http://www.gnu.org/software/gsasl/manual/**