
KRB5_CREDS(3)            BSD Library Functions Manual            KRB5_CREDS(3)

NAME
     krb5_creds, krb5_copy_creds, krb5_copy_creds_contents, krb5_free_creds,
     krb5_free_cred_contents -- Kerberos 5 credential handling functions

LIBRARY
     Kerberos 5 Library (libkrb5, -lkrb5)

SYNOPSIS
     #include <krb5.h>

     krb5_error_code
     krb5_copy_creds(krb5_context context, const krb5_creds *incred,
         krb5_creds **outcred);

     krb5_error_code
     krb5_copy_creds_contents(krb5_context context, const krb5_creds *incred,
         krb5_creds *outcred);

     krb5_error_code
     krb5_free_creds(krb5_context context, krb5_creds *outcred);

     krb5_error_code
     krb5_free_cred_contents(krb5_context context, krb5_creds *cred);

DESCRIPTION
     krb5_creds holds Kerberos credentials:

     typedef struct krb5_creds {
         krb5_principal      client;
         krb5_principal      server;
         krb5_keyblock       session;
         krb5_times          times;
         krb5_data           ticket;
         krb5_data           second_ticket;
         krb5_authdata       authdata;
         krb5_addresses      addresses;
         krb5_ticket_flags   flags;
     } krb5_creds;

     krb5_copy_creds() makes a copy of incred to outcred.  outcred should be
     freed with krb5_free_creds() by the caller.

     krb5_copy_creds_contents() makes a copy of the content of incred to
     outcreds.  outcreds should be freed by the called with
     krb5_free_creds_contents().

     krb5_free_creds() frees the content of the cred structure and the struc-
     ture itself.

     krb5_free_cred_contents() frees the content of the cred structure.

SEE ALSO
     krb5(3), krb5_compare_creds(3), krb5_get_init_creds(3), kerberos(8)

HEIMDAL                           May 1, 2006                          HEIMDAL
