xref: /freebsd/crypto/krb5/doc/html/_sources/appdev/refs/api/krb5_expand_hostname.rst.txt (revision 7f2fe78b9dd5f51c821d771b63d2e096f6fd49e9)
1krb5_expand_hostname -  Canonicalize a hostname, possibly using name service.
2==============================================================================
3
4..
5
6.. c:function:: krb5_error_code krb5_expand_hostname(krb5_context context, const char * host, char ** canonhost_out)
7
8..
9
10
11:param:
12
13	          **[in]** **context** - Library context
14
15	          **[in]** **host** - Input hostname
16
17	          **[out]** **canonhost_out** - Canonicalized hostname
18
19
20..
21
22
23
24..
25
26
27
28
29
30
31
32This function canonicalizes orig_hostname, possibly using name service lookups if configuration permits. Use krb5_free_string() to free *canonhost_out* when it is no longer needed.
33
34
35
36
37
38
39
40
41
42
43..
44
45
46
47
48.. note::
49
50	 New in 1.15
51
52
53