xref: /freebsd/crypto/krb5/doc/html/_sources/appdev/refs/api/krb5_aname_to_localname.rst.txt (revision 7f2fe78b9dd5f51c821d771b63d2e096f6fd49e9)
1krb5_aname_to_localname -  Convert a principal name to a local name.
2=====================================================================
3
4..
5
6.. c:function:: krb5_error_code krb5_aname_to_localname(krb5_context context, krb5_const_principal aname, int lnsize_in, char * lname)
7
8..
9
10
11:param:
12
13	          **[in]** **context** - Library context
14
15	          **[in]** **aname** - Principal name
16
17	          **[in]** **lnsize_in** - Space available in *lname*
18
19	          **[out]** **lname** - Local name buffer to be filled in
20
21
22..
23
24
25:retval:
26         -   0   Success
27         -   System   errors
28
29
30:return:
31         -  Kerberos error codes
32
33..
34
35
36
37
38
39
40
41If *aname* does not correspond to any local account, KRB5_LNAME_NOTRANS is returned. If *lnsize_in* is too small for the local name, KRB5_CONFIG_NOTENUFSPACE is returned.
42
43
44
45Local names, rather than principal names, can be used by programs that translate to an environment-specific name (for example, a user account name).
46
47
48
49
50
51
52
53
54
55
56..
57
58
59
60
61
62