document krb5_free_salt

git-svn-id: svn://svn.h5l.se/heimdal/trunk/heimdal@14115 ec53bebd-3082-4978-b11e-865c3cabbd6b
This commit is contained in:
Love Hörnquist Åstrand
2004-08-13 13:23:57 +00:00
parent b3c377ae79
commit b7664ac1cb

View File

@@ -31,7 +31,7 @@
.\" .\"
.\" $Id$ .\" $Id$
.\" .\"
.Dd April 22, 2004 .Dd August 13, 2004
.Dt KRB5_STRING_TO_KEY 3 .Dt KRB5_STRING_TO_KEY 3
.Os HEIMDAL .Os HEIMDAL
.Sh NAME .Sh NAME
@@ -42,7 +42,8 @@
.Nm krb5_string_to_key_derived , .Nm krb5_string_to_key_derived ,
.Nm krb5_string_to_key_salt , .Nm krb5_string_to_key_salt ,
.Nm krb5_string_to_key_salt_opaque , .Nm krb5_string_to_key_salt_opaque ,
.Nm krb5_get_pw_salt .Nm krb5_get_pw_salt ,
.Nm krb5_free_salt
.Nd turns a string to to a Kerberos key .Nd turns a string to to a Kerberos key
.Sh LIBRARY .Sh LIBRARY
Kerberos 5 Library (libkrb5, -lkrb5) Kerberos 5 Library (libkrb5, -lkrb5)
@@ -104,6 +105,11 @@ Kerberos 5 Library (libkrb5, -lkrb5)
.Fa "krb5_const_principal principal" .Fa "krb5_const_principal principal"
.Fa "krb5_salt *salt" .Fa "krb5_salt *salt"
.Fc .Fc
.Ft krb5_error_code
.Fo krb5_free_salt
.Fa "krb5_context context"
.Fa "krb5_salt salt"
.Fc
.Sh DESCRIPTION .Sh DESCRIPTION
The string to key functions convert a string to a kerberos key. The string to key functions convert a string to a kerberos key.
.Pp .Pp
@@ -133,11 +139,17 @@ should be freed with
If one of the functions that doesn't take a If one of the functions that doesn't take a
.Li krb5_salt .Li krb5_salt
as it argument as it argument
.Nm krb5_get_pw_salt .Fn krb5_get_pw_salt
is used to get the salt value. is used to get the salt value.
.Pp .Pp
.Nm krb5_get_pw_salt .Fn krb5_get_pw_salt
get the default password salt for a principal. get the default password salt for a principal, use
.Fn krb5_free_salt
to free the salt when done.
.Pp
.Fn krb5_free_salt
frees the content of
.Fa salt .
.Pp .Pp
.Fn krb5_string_to_key_derived .Fn krb5_string_to_key_derived
is deprecated, see the BUGS section below. is deprecated, see the BUGS section below.