.\" DO NOT MODIFY THIS FILE!  It was generated by gdoc.
.TH "gsasl_encode" 3 "0.2.21" "gsasl" "gsasl"
.SH NAME
gsasl_encode \- API function
.SH SYNOPSIS
.B #include <gsasl.h>
.sp
.BI "int gsasl_encode(Gsasl_session * " sctx ", const char * " input ", size_t " input_len ", char ** " output ", size_t * " output_len ");"
.SH ARGUMENTS
.IP "Gsasl_session * sctx" 12
libgsasl session handle.
.IP "const char * input" 12
input byte array.
.IP "size_t input_len" 12
size of input byte array.
.IP "char ** output" 12
newly allocated output byte array.
.IP "size_t * output_len" 12
size of output byte array.
.SH "DESCRIPTION"
Encode data according to negotiated SASL mechanism.  This might mean
that data is integrity or privacy protected.

The \fIoutput\fP buffer is allocated by this function, and it is the
responsibility of caller to deallocate it by calling free(\fIoutput\fP).
.SH "RETURN VALUE"
Returns GSASL_OK if encoding was successful, otherwise
an error code.
.SH "REPORTING BUGS"
Report bugs to <bug-gsasl@gnu.org>.
.SH COPYRIGHT
Copyright \(co 2002, 2003, 2004, 2005, 2006, 2007 Simon Josefsson.
.br
Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are
preserved on all copies.
.SH "SEE ALSO"
The full documentation for
.B gsasl
is maintained as a Texinfo manual.  If the
.B info
and
.B gsasl
programs are properly installed at your site, the command
.IP
.B info gsasl
.PP
should give you access to the complete manual.