May 1, 2006 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

```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 information.

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)