xref: /freebsd/crypto/krb5/doc/html/_sources/appdev/refs/api/krb5_425_conv_principal.rst.txt (revision 7f2fe78b9dd5f51c821d771b63d2e096f6fd49e9)
1krb5_425_conv_principal -  Convert a Kerberos V4 principal to a Kerberos V5 principal.
2=======================================================================================
3
4..
5
6.. c:function:: krb5_error_code krb5_425_conv_principal(krb5_context context, const char * name, const char * instance, const char * realm, krb5_principal * princ)
7
8..
9
10
11:param:
12
13	          **[in]** **context** - Library context
14
15	          **[in]** **name** - V4 name
16
17	          **[in]** **instance** - V4 instance
18
19	          **[in]** **realm** - Realm
20
21	          **[out]** **princ** - V5 principal
22
23
24..
25
26
27:retval:
28         -   0   Success; otherwise - Kerberos error codes
29
30
31..
32
33
34
35
36
37
38
39This function builds a *princ* from V4 specification based on given input *name.instance@realm* .
40
41
42
43Use krb5_free_principal() to free *princ* when it is no longer needed.
44
45
46
47
48
49
50
51
52
53
54..
55
56
57
58
59
60