KRB5_TICKET(3)          NetBSD Library Functions Manual         KRB5_TICKET(3)

NAME
     krb5_ticket, krb5_free_ticket, krb5_copy_ticket,
     krb5_ticket_get_authorization_data_type, krb5_ticket_get_client,
     krb5_ticket_get_server, krb5_ticket_get_endtime -- Kerberos 5 ticket
     access and handling functions

LIBRARY
     Kerberos 5 Library (libkrb5, -lkrb5)

SYNOPSIS
     #include <krb5/krb5.h>

     krb5_ticket;

     krb5_error_code
     krb5_free_ticket(krb5_context context, krb5_ticket *ticket);

     krb5_error_code
     krb5_copy_ticket(krb5_context context, const krb5_ticket *from,
         krb5_ticket **to);

     krb5_error_code
     krb5_ticket_get_authorization_data_type(krb5_context context,
         krb5_ticket *ticket, int type, krb5_data *data);

     krb5_error_code
     krb5_ticket_get_client(krb5_context context, const krb5_ticket *ticket,
         krb5_principal *client);

     krb5_error_code
     krb5_ticket_get_server(krb5_context context, const krb5_ticket *ticket,
         krb5_principal *server);

     time_t
     krb5_ticket_get_endtime(krb5_context context, const krb5_ticket *ticket);

DESCRIPTION
     krb5_ticket holds a kerberos ticket.  The internals of the structure
     should never be accessed directly, functions exist for extracting infor-
     mation.

     krb5_free_ticket() frees the ticket and its content.  Used to free the
     result of krb5_copy_ticket() and krb5_recvauth().

     krb5_copy_ticket() copies the content of the ticket from to the ticket
     to.  The result to should be freed with krb5_free_ticket().

     krb5_ticket_get_authorization_data_type() fetches the authorization data
     of the type type from the ticket.  If there isn't any authorization data
     of type type, ENOENT is returned.  data needs to be freed with
     krb5_data_free() on success.

     krb5_ticket_get_client() and krb5_ticket_get_server() returns a copy of
     the client/server principal from the ticket.  The principal returned
     should be free using krb5_free_principal(3).

     krb5_ticket_get_endtime() return the end time of the ticket.

SEE ALSO
     krb5(3)

NetBSD 5.0_STABLE                 May 1, 2006                NetBSD 5.0_STABLE
