.\" Copyright (c) 2000 Kungliga Tekniska Högskolan
.\" $Id: krb5_appdefault.3,v 1.3 2001/01/05 16:29:42 joda Exp $
.Dd July 25, 2000
.Dt KRB5_APPDEFAULT 3
.Os HEIMDAL
.Sh NAME
.Nm krb5_appdefault_boolean ,
.Nm krb5_appdefault_string ,
.Nm krb5_appdefault_time
.Nd Get application configuration value

.Sh SYNOPSIS
.Fd #include <krb5.h>

.Ft void
.Fn krb5_appdefault_boolean "krb5_context context" "const char *appname" "krb5_realm realm" "const char *option" "krb5_boolean def_val" "krb5_boolean *ret_val"
.Ft void
.Fn krb5_appdefault_string "krb5_context context" "const char *appname" "krb5_realm realm" "const char *option" "const char *def_val" "char **ret_val"
.Ft void
.Fn krb5_appdefault_time "krb5_context context" "const char *appname" "krb5_realm realm" "const char *option" "time_t def_val" "time_t *ret_val"

.Sh DESCRIPTION

These functions get application application defaults from the 
.Dv appdefaults
section of the
.Xr krb5.conf 5 
configuration file. These defaults can be specified per application,
and/or per realm.

These values will be looked for in 
.Xr krb5.conf 5 ,
in order of descending importance.
.Bd -literal -offset indent
[appdefaults]
	appname = {
		realm = {
			option = value
		}
	}
	appname = {
		option = value
	}
	realm = {
		option = value
	}
	option = value
.Ed

If the realm is omitted it will not be used for resolving values.  If
no value can be found,
.Fa def_val
is returned instead.

.Sh SEE ALSO
.Xr krb5_config 3 ,
.Xr krb5.conf 5