NAME
krb5_context
,
krb5_init_context
,
krb5_free_context
,
krb5_init_ets
,
krb5_add_et_list
,
krb5_add_extra_addresses
,
krb5_add_ignore_addresses
,
krb5_get_extra_addresses
,
krb5_get_ignore_addresses
,
krb5_set_extra_addresses
,
krb5_set_ignore_addresses
,
krb5_set_fcache_version
,
krb5_get_fcache_version
,
krb5_set_config_files
,
krb5_prepend_config_files
,
krb5_prepend_config_files_default
,
krb5_get_default_config_files
,
krb5_free_config_files
,
krb5_set_use_admin_kdc
,
krb5_get_use_admin_kdc
—
create, modify and delete krb5_context
structures
LIBRARY
Kerberos 5 Library (libkrb5, -lkrb5)
SYNOPSIS
#include
<krb5.h>
struct krb5_context;
krb5_error_code
krb5_init_context
(krb5_context
*context);
void
krb5_free_context
(krb5_context
context);
void
krb5_init_ets
(krb5_context
context);
krb5_error_code
krb5_add_et_list
(krb5_context
context, void (*func)(struct et_list **));
krb5_error_code
krb5_add_extra_addresses
(krb5_context
context, krb5_addresses *addresses);
krb5_error_code
krb5_set_extra_addresses
(krb5_context
context, const krb5_addresses *addresses);
krb5_error_code
krb5_get_extra_addresses
(krb5_context
context, krb5_addresses *addresses);
krb5_error_code
krb5_add_ignore_addresses
(krb5_context
context, krb5_addresses *addresses);
krb5_error_code
krb5_set_ignore_addresses
(krb5_context
context, const krb5_addresses *addresses);
krb5_error_code
krb5_get_ignore_addresses
(krb5_context
context, krb5_addresses *addresses);
krb5_error_code
krb5_set_fcache_version
(krb5_context
context, int version);
krb5_error_code
krb5_get_fcache_version
(krb5_context
context, int *version);
krb5_error_code
krb5_set_config_files
(krb5_context
context, char **filenames);
krb5_error_code
krb5_prepend_config_files
(const char
*filelist, char **pq, char
***ret_pp);
krb5_error_code
krb5_prepend_config_files_default
(const
char *filelist, char ***pfilenames);
krb5_error_code
krb5_get_default_config_files
(char
***pfilenames);
void
krb5_free_config_files
(char
**filenames);
void
krb5_set_use_admin_kdc
(krb5_context
context, krb5_boolean flag);
krb5_boolean
krb5_get_use_admin_kdc
(krb5_context
context);
DESCRIPTION
The
krb5_init_context
()
function initializes the context structure and reads
the configuration file /etc/kerberosV/krb5.conf.
The structure should be freed by calling
krb5_free_context
()
when it is no longer being used.
krb5_init_context
()
returns 0 to indicate success. Otherwise an errno code is returned. Failure
means either that something bad happened during initialization (typically
[ENOMEM]) or that Kerberos should not be used [ENXIO].
krb5_init_ets
()
adds all com_err(3) libs to context. This is
done by krb5_init_context
().
krb5_add_et_list
()
adds a com_err(3) error-code handler func to
the specified context. The error handler must
generated by the the re-rentrant version of the
compile_et(3) program.
krb5_add_extra_addresses
()
add a list of addresses that should be added when requesting tickets.
krb5_add_ignore_addresses
()
add a list of addresses that should be ignored when requesting tickets.
krb5_get_extra_addresses
()
get the list of addresses that should be added when requesting tickets.
krb5_get_ignore_addresses
()
get the list of addresses that should be ignored when requesting
tickets.
krb5_set_ignore_addresses
()
set the list of addresses that should be ignored when requesting
tickets.
krb5_set_extra_addresses
()
set the list of addresses that should be added when requesting tickets.
krb5_set_fcache_version
()
sets the version of file credentials caches that should be used.
krb5_get_fcache_version
()
gets the version of file credentials caches that should be used.
krb5_set_config_files
()
set the list of configuration files to use and re-initialize the
configuration from the files.
krb5_prepend_config_files
()
parse the filelist and prepend the result to the
already existing list pq The result is returned in
ret_pp and should be freed with
krb5_free_config_files
().
krb5_prepend_config_files_default
()
parse the filelist and append that to the default list
of configuration files.
krb5_get_default_config_files
()
get a list of default configuration files.
krb5_free_config_files
()
free a list of configuration files returned by
krb5_get_default_config_files
(),
krb5_prepend_config_files_default
(), or
krb5_prepend_config_files
().
krb5_set_use_admin_kdc
()
sets if all KDC requests should go admin KDC.
krb5_get_use_admin_kdc
()
gets if all KDC requests should go admin KDC.
SEE ALSO
errno(2), krb5(3), krb5_config(3), krb5_context(3), kerberos(8)