xref: /freebsd/crypto/krb5/doc/html/_sources/appdev/refs/api/krb5_524_conv_principal.rst.txt (revision 7f2fe78b9dd5f51c821d771b63d2e096f6fd49e9)
1krb5_524_conv_principal -  Convert a Kerberos V5 principal to a Kerberos V4 principal.
2=======================================================================================
3
4..
5
6.. c:function:: krb5_error_code krb5_524_conv_principal(krb5_context context, krb5_const_principal princ, char * name, char * inst, char * realm)
7
8..
9
10
11:param:
12
13	          **[in]** **context** - Library context
14
15	          **[in]** **princ** - V5 Principal
16
17	          **[out]** **name** - V4 principal's name to be filled in
18
19	          **[out]** **inst** - V4 principal's instance name to be filled in
20
21	          **[out]** **realm** - Principal's realm name to be filled in
22
23
24..
25
26
27:retval:
28         -   0   Success
29         -   KRB5_INVALID_PRINCIPAL   Invalid principal name
30         -   KRB5_CONFIG_CANTOPEN   Can't open or find Kerberos configuration file
31
32
33:return:
34         -  Kerberos error codes
35
36..
37
38
39
40
41
42
43
44This function separates a V5 principal *princ* into *name* , *instance* , and *realm* .
45
46
47
48
49
50
51
52
53
54
55..
56
57
58
59
60
61