.\" DO NOT MODIFY THIS FILE!  It was generated by gdoc.
.TH "shishi_kdc_sendrecv_hint" 3 "1.0.2" "shishi" "shishi"
.SH NAME
shishi_kdc_sendrecv_hint \- API function
.SH SYNOPSIS
.B #include <shishi.h>
.sp
.BI "int shishi_kdc_sendrecv_hint(Shishi * " handle ", const char * " realm ", const char * " indata ", size_t " inlen ", char ** " outdata ", size_t * " outlen ", Shishi_tkts_hint * " hint ");"
.SH ARGUMENTS
.IP "Shishi * handle" 12
Shishi library handle create by \fBshishi_init()\fP.
.IP "const char * realm" 12
string with realm name.
.IP "const char * indata" 12
Packet to send to KDC.
.IP "size_t inlen" 12
Length of \fIindata\fP.
.IP "char ** outdata" 12
Newly allocated string with data returned from KDC.
.IP "size_t * outlen" 12
Length of \fIoutdata\fP.
.IP "Shishi_tkts_hint * hint" 12
a \fBShishi_tkts_hint\fP structure with flags.
.SH "DESCRIPTION"
Send packet to KDC for realm and receive response.  The code finds
KDC addresses from configuration file, then by querying for SRV
records for the realm, and finally by using the realm name as a
hostname.
.SH "RETURNS"
\fBSHISHI_OK\fP on success, \fBSHISHI_KDC_TIMEOUT\fP if a timeout
was reached, or other errors.
.SH "REPORTING BUGS"
Report bugs to <bug-shishi@gnu.org>.
.SH COPYRIGHT
Copyright \(co 2002-2010 Simon Josefsson.
.br
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.
.SH "SEE ALSO"
The full documentation for
.B shishi
is maintained as a Texinfo manual.  If the
.B info
and
.B shishi
programs are properly installed at your site, the command
.IP
.B info shishi
.PP
should give you access to the complete manual.