summaryrefslogtreecommitdiffstats
path: root/crypto/heimdal/lib/krb5/krb5_appdefault.3
blob: 3ce6fc9432bdff6ca4a04afb042d40dcf748886d (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
.\" 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
OpenPOWER on IntegriCloud