Scroll to navigation

SASL_ENCODEV(3) Cyrus SASL SASL_ENCODEV(3)

NAME

sasl_encodev - Cyrus SASL documentation

SYNOPSIS

#include <sasl/sasl.h>
int sasl_encode(sasl_conn_t *conn,


                const char * input,


                unsigned inputlen,


                const char ** output,


                unsigned * outputlen);
int sasl_encodev(sasl_conn_t *conn,


                const struct iovec * invec,


                unsigned numiov,


                const char ** output,


                unsigned * outputlen);

DESCRIPTION

sasl_encode encodes data to be sent to be sent to a remote host who we’ve had a successful authentication session with. If there is a negotiated security the data in signed/encrypted and the output should be sent without modification to the remote host. If there is no security layer the output is identical to the input.

sasl_encodev does the same, but for a struct iovec instead of a character buffer.

  • conn – is the SASL connection context
  • output – contains the decoded data and is allocated/freed by the library.
  • outputlen – length of output.



  • conn – is the SASL connection context
  • output – contains the decoded data and is allocated/freed by the library.
  • outputlen – length of output.



RETURN VALUE

SASL callback functions should return SASL return codes. See sasl.h for a complete list. SASL_OK <#c.SASL_OK> indicates success.

Other return codes indicate errors and should be handled.

SEE ALSO

RFC 4422 <https://datatracker.ietf.org/doc/html/rfc4422.html>,:saslman:sasl(3), sasl_decode(3) <#std-saslman-sasl_decode-3>, sasl_errors(3) <#std-saslman-sasl_errors-3>

Author

The Cyrus Team

Copyright

1993-2016, The Cyrus Team

2026-04-04 2.1.28