From f66a6f7987da4a1898533c1c53a936fda5fa351a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Love=20H=C3=B6rnquist=20=C3=85strand?= <lha@kth.se>
Date: Thu, 8 Jan 2004 09:01:33 +0000
Subject: [PATCH] add prototypes, describe krb5_keyblock_zero

git-svn-id: svn://svn.h5l.se/heimdal/trunk/heimdal@13258 ec53bebd-3082-4978-b11e-865c3cabbd6b
---
 lib/krb5/krb5_keyblock.3 | 26 ++++++++++++++++++++++++--
 1 file changed, 24 insertions(+), 2 deletions(-)

diff --git a/lib/krb5/krb5_keyblock.3 b/lib/krb5/krb5_keyblock.3
index 9c5539ae5..69e5a871b 100644
--- a/lib/krb5/krb5_keyblock.3
+++ b/lib/krb5/krb5_keyblock.3
@@ -31,7 +31,7 @@
 .\"
 .\" $Id$
 .\"
-.Dd July 22, 2003
+.Dd January  8, 2004
 .Dt KRB5_KEYBLOCK 3
 .Os HEIMDAL
 .Sh NAME
@@ -39,7 +39,8 @@
 .Nm krb5_keyblock_get_enctype ,
 .Nm krb5_copy_keyblock_contents ,
 .Nm krb5_free_keyblock ,
-.Nm krb5_free_keyblock_contents
+.Nm krb5_free_keyblock_contents ,
+.Nm krb5_keyblock_zero
 .Nd Kerberos 5 key handling functions.
 .Sh LIBRARY
 Kerberos 5 Library (libkrb5, -lkrb5)
@@ -57,6 +58,20 @@ Kerberos 5 Library (libkrb5, -lkrb5)
 .Fa "const krb5_keyblock *inblock"
 .Fa "krb5_keyblock *to"
 .Fc
+.Ft void
+.Fo krb5_free_keyblock
+.Fa "krb5_context context"
+.Fa "krb5_keyblock *keyblock"
+.Fc
+.Ft void
+.Fo krb5_free_keyblock_contents
+.Fa "krb5_context context"
+.Fa "krb5_keyblock *keyblock"
+.Fc
+.Ft void
+.Fo krb5_keyblock_zero
+.Fa "krb5_keyblock *keyblock"
+.Fc
 .Sh DESCRIPTION
 .Li krb5_keyblock
 holds the encryption key for a specific encryption type.
@@ -80,6 +95,13 @@ free the content and the keyblock itself.
 .Pp
 .Fn krb5_free_keyblock_contents
 frees the content of the keyblock.
+.Pp
+.Fn krb5_keyblock_zero
+zeros out the keyblock to to make sure no keymaterial is in
+memory.
+Note that
+.Fn krb5_free_keyblock_contents
+also zeros out the memory.
 .\" .Sh EXAMPLES
 .Sh SEE ALSO
 .Xr krb5 3 ,