From e8c2525e5578172d8f1fd1e86c571ed491fd2c11 Mon Sep 17 00:00:00 2001 From: Andreas Schneider Date: Mon, 29 Aug 2016 17:09:02 +0200 Subject: [PATCH] krb5_wrap: Document smb_krb5_make_pac_checksum() Signed-off-by: Andreas Schneider Reviewed-by: Andrew Bartlett --- lib/krb5_wrap/krb5_samba.c | 23 +++++++++++++++++++++++ 1 file changed, 23 insertions(+) diff --git a/lib/krb5_wrap/krb5_samba.c b/lib/krb5_wrap/krb5_samba.c index 5c8d796068d..b797989ebb2 100644 --- a/lib/krb5_wrap/krb5_samba.c +++ b/lib/krb5_wrap/krb5_samba.c @@ -2411,6 +2411,29 @@ void smb_krb5_free_checksum_contents(krb5_context ctx, krb5_checksum *cksum) } #endif +/** + * @brief Compute a checksum operating on a keyblock. + * + * This function computes a checksum over a PAC using the keyblock for a keyed + * checksum. + * + * @param[in] mem_ctx A talloc context to alocate the signature on. + * + * @param[in] pac_data The PAC as input. + * + * @param[in] context The library context. + * + * @param[in] keyblock Encryption key for a keyed checksum. + * + * @param[out] sig_type The checksum type + * + * @param[out] sig_blob The talloc'ed checksum + * + * The caller must free the sig_blob with talloc_free() when it is not needed + * anymore. + * + * @return 0 on success, a Kerberos error code otherwise. + */ krb5_error_code smb_krb5_make_pac_checksum(TALLOC_CTX *mem_ctx, DATA_BLOB *pac_data, krb5_context context,