---
name: "gsasl_client_step"
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_client_step"
---

# gsasl\_client\_step(3)

API function

## NAME

gsasl\_client\_step - API function

## SYNOPSIS

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

**int gsasl\_client\_step(Gsasl\_session \*** *sctx***, const char \*** *input***, size\_t** *input\_len***, char \*** *output***, size\_t \*** *output\_len***);**

## ARGUMENTS

- Gsasl\_session \* sctx

  libgsasl client handle.

- const char \* input

  input byte array.

- size\_t input\_len

  size of input byte array.

- char \* output

  output byte array.

- size\_t \* output\_len

  size of output byte array.

## DESCRIPTION

Perform one step of SASL authentication in client.  This reads data from server (specified with input and input\_len), processes it (potentially invoking callbacks to the application), and writes data to server (into variables output and output\_len).

The contents of the output buffer is unspecified if this functions returns anything other than **GSASL\_NEEDS\_MORE**.

Return value: Returns **GSASL\_OK** if authenticated terminated successfully, **GSASL\_NEEDS\_MORE** if more data is needed, or error code.

## DEPRECATED

Use **gsasl\_step()** 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/**