xref: /freebsd/crypto/krb5/doc/html/_sources/appdev/refs/api/krb5_get_default_realm.rst.txt (revision 7f2fe78b9dd5f51c821d771b63d2e096f6fd49e9)
1krb5_get_default_realm -  Retrieve the default realm.
2======================================================
3
4..
5
6.. c:function:: krb5_error_code krb5_get_default_realm(krb5_context context, char ** lrealm)
7
8..
9
10
11:param:
12
13	          **[in]** **context** - Library context
14
15	          **[out]** **lrealm** - Default realm name
16
17
18..
19
20
21:retval:
22         -   0   Success
23
24
25:return:
26         -  Kerberos error codes
27
28..
29
30
31
32
33
34
35
36Retrieves the default realm to be used if no user-specified realm is available.
37
38
39
40Use krb5_free_default_realm() to free *lrealm* when it is no longer needed.
41
42
43
44
45
46
47
48
49
50
51..
52
53
54
55
56
57