.\" DO NOT MODIFY THIS FILE!  It was generated by gdoc.
.TH "shishi_tkts_get_tgt" 3 "1.0.2" "shishi" "shishi"
.SH NAME
shishi_tkts_get_tgt \- API function
.SH SYNOPSIS
.B #include <shishi.h>
.sp
.BI "Shishi_tkt * shishi_tkts_get_tgt(Shishi_tkts * " tkts ", Shishi_tkts_hint * " hint ");"
.SH ARGUMENTS
.IP "Shishi_tkts * tkts" 12
ticket set handle as allocated by \fBshishi_tkts()\fP.
.IP "Shishi_tkts_hint * hint" 12
structure with characteristics of ticket to begot.
.SH "DESCRIPTION"
Get a ticket granting ticket (TGT) suitable for acquiring ticket
matching the hint.  I.e., get a TGT for the server realm in the
hint structure (hint\->serverrealm), or the default realm if the
serverrealm field is NULL.  Can result in AS exchange.

Currently this function do not implement cross realm logic.

This function is used by \fBshishi_tkts_get()\fP, which is probably what
you really want to use unless you have special needs.
.SH "RETURN VALUE"
Returns a ticket granting ticket if successful, or
NULL if this function is unable to acquire on.
.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.