60ff0b5c321e8c2ec4a58d419dd962172c34ba58
[platform/upstream/krb5.git] / doc / html / _sources / appdev / refs / api / krb5_expand_hostname.txt
1 krb5_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
32 This function canonicalizes orig_hostname, possibly using name service lookups if configuration permits. Use :c:func:`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