KRB5\_CREDS(3) Library Functions Manual KRB5\_CREDS(3)

# [NAME](#NAME)

`krb5_creds`, `krb5_copy_creds`, `krb5_copy_creds_contents`, `krb5_free_creds`, `krb5_free_cred_contents` — Kerberos 5 credential handling functions

# [LIBRARY](#LIBRARY)

Kerberos 5 Library (libkrb5, -lkrb5)

# [SYNOPSIS](#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](#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`](#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`](#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_contents)().

[`krb5_free_creds`](#krb5_free_creds)() frees the content of the `cred` structure and the structure itself.

[`krb5_free_cred_contents`](#krb5_free_cred_contents)() frees the content of the `cred` structure.

# [SEE ALSO](#SEE_ALSO)

[krb5(3)](/man/os/heimdal/krb5.3), [krb5\_compare\_creds(3)](/man/os/heimdal/krb5_compare_creds.3), [krb5\_get\_init\_creds(3)](/man/os/heimdal/krb5_get_init_creds.3), [kerberos(8)](/man/os/heimdal/kerberos.8)

May 1, 2006 HEIMDAL

---

Document: krb5_copy_creds(3) from heimdal 7.8.0-r52 (Chainguard OS)
Source: https://github.com/heimdal/heimdal