File: krb5_sname_to_principal.txt

package info (click to toggle)
krb5 1.15-1%2Bdeb9u1
  • links: PTS, VCS
  • area: main
  • in suites: stretch
  • size: 54,220 kB
  • ctags: 32,381
  • sloc: ansic: 310,596; cpp: 16,220; exp: 13,350; python: 7,990; makefile: 7,223; sh: 6,185; perl: 3,518; asm: 1,460; yacc: 1,006; xml: 503; awk: 396; csh: 147; lisp: 104; sed: 43
file content (74 lines) | stat: -rw-r--r-- 1,375 bytes parent folder | download | duplicates (6)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
krb5_sname_to_principal -  Generate a full principal name from a service name. 
===============================================================================

..

.. c:function:: krb5_error_code krb5_sname_to_principal(krb5_context context, const char * hostname, const char * sname, krb5_int32 type, krb5_principal * ret_princ)

..


:param:

	          **[in]** **context** - Library context

	          **[in]** **hostname** - Host name, or NULL to use local host

	          **[in]** **sname** - Service name, or NULL to use **"host"**

	          **[in]** **type** - Principal type

	          **[out]** **ret_princ** - Generated principal


..


:retval:
         -   0   Success


:return:
         -  Kerberos error codes 

..







This function converts a *hostname* and *sname* into *krb5_principal* structure *ret_princ* . The returned principal will be of the form *sname\/hostname@REALM* where REALM is determined by :c:func:`krb5_get_host_realm()` . In some cases this may be the referral (empty) realm.



The *type* can be one of the following:



 
 
	 - :data:`KRB5_NT_SRV_HST` canonicalizes the host name before looking up the realm and generating the principal.
 
 
 
	 - :data:`KRB5_NT_UNKNOWN` accepts the hostname as given, and does not canonicalize it.
 
 Use krb5_free_principal to free *ret_princ* when it is no longer needed.










..