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.
..
|