1
0
mirror of https://github.com/samba-team/samba.git synced 2024-12-23 17:34:34 +03:00

krb5_wrap: Document smb_krb5_kt_open_relative()

Signed-off-by: Andreas Schneider <asn@samba.org>
Reviewed-by: Andrew Bartlett <abartlet@samba.org>
This commit is contained in:
Andreas Schneider 2016-08-29 10:46:26 +02:00 committed by Andrew Bartlett
parent 81da37eb90
commit 28a03a72a6

View File

@ -973,21 +973,29 @@ krb5_error_code smb_krb5_enctype_to_string(krb5_context context,
#endif #endif
} }
/**********************************************************************
* Open a krb5 keytab with flags, handles readonly or readwrite access and
* allows one to process non-default keytab names.
* @param context krb5_context
* @param keytab_name_req string
* @param write_access bool if writable keytab is required
* @param krb5_keytab pointer to krb5_keytab (close with krb5_kt_close())
* @return krb5_error_code
**********************************************************************/
/* This MAX_NAME_LEN is a constant defined in krb5.h */ /* This MAX_NAME_LEN is a constant defined in krb5.h */
#ifndef MAX_KEYTAB_NAME_LEN #ifndef MAX_KEYTAB_NAME_LEN
#define MAX_KEYTAB_NAME_LEN 1100 #define MAX_KEYTAB_NAME_LEN 1100
#endif #endif
/**
* @brief Open a key table readonly or with readwrite access.
*
* Allows to use a different keytab than the default one using a relative
* path to the keytab.
*
* @param[in] context The library context
*
* @param[in] keytab_name_req The path to the key table.
*
* @param[in] write_access Open with readwrite access.
*
* @param[in] keytab A pointer o the opended key table.
*
* The keytab pointer should be freed using krb5_kt_close().
*
* @return 0 on success, a Kerberos error code otherwise.
*/
krb5_error_code smb_krb5_kt_open_relative(krb5_context context, krb5_error_code smb_krb5_kt_open_relative(krb5_context context,
const char *keytab_name_req, const char *keytab_name_req,
bool write_access, bool write_access,