krb5_c encryption glue
git-svn-id: svn://svn.h5l.se/heimdal/trunk/heimdal@12449 ec53bebd-3082-4978-b11e-865c3cabbd6b
This commit is contained in:
@@ -35,21 +35,70 @@
|
||||
.Dt KRB5_CCACHE 3
|
||||
.Os HEIMDAL
|
||||
.Sh NAME
|
||||
.Nm krb5_checksum ,
|
||||
.Nm krb5_c_block_size ,
|
||||
.Nm krb5_c_decrypt ,
|
||||
.Nm krb5_c_encrypt ,
|
||||
.Nm krb5_c_encrypt_length ,
|
||||
.Nm krb5_c_enctype_compare ,
|
||||
.Nm krb5_c_get_checksum ,
|
||||
.Nm krb5_c_make_checksum ,
|
||||
.Nm krb5_c_verify_checksum ,
|
||||
.Nm krb5_c_make_random_key ,
|
||||
.Nm krb5_c_set_checksum ,
|
||||
.Nm krb5_c_verify_checksum ,
|
||||
.Nm krb5_copy_checksum ,
|
||||
.Nm krb5_free_checksum ,
|
||||
.Nm krb5_free_checksum_contents
|
||||
.Nd create and verify checksums
|
||||
.Nd kerberos crypto API
|
||||
.Sh LIBRARY
|
||||
Kerberos 5 Library (libkrb5, -lkrb5)
|
||||
.Sh SYNOPSIS
|
||||
.In krb5.h
|
||||
.Pp
|
||||
.Ft krb5_error_code
|
||||
.Fo krb5_c_block_size
|
||||
.Fa "krb5_context context"
|
||||
.Fa "krb5_enctype enctype"
|
||||
.Fa "size_t *blocksize"
|
||||
.Fc
|
||||
.Ft krb5_error_code
|
||||
.Fo krb5_c_decrypt
|
||||
.Fa "krb5_context context"
|
||||
.Fa "const krb5_keyblock key"
|
||||
.Fa "krb5_keyusage usage"
|
||||
.Fa "const krb5_data *ivec"
|
||||
.Fa "krb5_enc_data *input"
|
||||
.Fa "krb5_data *output"
|
||||
.Fc
|
||||
.Ft krb5_error_code
|
||||
.Fo krb5_c_encrypt
|
||||
.Fa "krb5_context context"
|
||||
.Fa "const krb5_keyblock *key"
|
||||
.Fa "krb5_keyusage usage"
|
||||
.Fa "const krb5_data *ivec"
|
||||
.Fa "const krb5_data *input"
|
||||
.Fa "krb5_enc_data *output"
|
||||
.Fc
|
||||
.Ft krb5_error_code
|
||||
.Fo krb5_c_encrypt_length
|
||||
.Fa "krb5_context context"
|
||||
.Fa "krb5_enctype enctype"
|
||||
.Fa "size_t inputlen"
|
||||
.Fa "size_t *length"
|
||||
.Fc
|
||||
.Ft krb5_error_code
|
||||
.Fo krb5_c_enctype_compare
|
||||
.Fa "krb5_context context"
|
||||
.Fa "krb5_enctype e1"
|
||||
.Fa "krb5_enctype e2"
|
||||
.Fa "krb5_boolean *similar"
|
||||
.Fc
|
||||
.Ft krb5_error_code
|
||||
.Fo krb5_c_make_random_key
|
||||
.Fa "krb5_context context"
|
||||
.Fa "krb5_enctype enctype"
|
||||
.Fa "krb5_keyblock *random_key"
|
||||
.Fc
|
||||
.Ft krb5_error_code
|
||||
.Fo krb5_c_make_checksum
|
||||
.Fa "krb5_context context"
|
||||
.Fa "krb5_cksumtype cksumtype"
|
||||
@@ -107,11 +156,49 @@ Kerberos 5 Library (libkrb5, -lkrb5)
|
||||
The
|
||||
.Li krb5_checksum
|
||||
structure holds a Kerberos checksum.
|
||||
.Pp
|
||||
There is no component inside
|
||||
.Li krb5_checksum
|
||||
that is directly referable.
|
||||
.Pp
|
||||
The
|
||||
.Li krb5_enc_data
|
||||
structure holds and encrypted data.
|
||||
There are two public accessable members of
|
||||
.Li krb5_enc_data .
|
||||
.Li enctype
|
||||
that holds the encryption type of the data encrypted and
|
||||
.Li ciphertext
|
||||
that is a
|
||||
.Ft krb5_data
|
||||
that might contain the encrypted data.
|
||||
.Pp
|
||||
.Fn krb5_c_block_size
|
||||
returns the blocksize of the encryption type.
|
||||
.Pp
|
||||
.Fn krb5_c_decrypt
|
||||
decrypts
|
||||
.Fa input
|
||||
and store the data in
|
||||
.Fa output.
|
||||
If
|
||||
.Fa ivec
|
||||
is
|
||||
.Dv NULL
|
||||
the default initialization vector for that encryption type will be used.
|
||||
.Pp
|
||||
.Fn krb5_c_encrypt
|
||||
encrypts the plaintext in
|
||||
.Fa input
|
||||
and store the ciphertext in
|
||||
.Fa output .
|
||||
.Pp
|
||||
.Fn krb5_c_encrypt_length
|
||||
returns the length the encrypted data given the plaintext length.
|
||||
.Pp
|
||||
.Fn krb5_c_enctype_compare
|
||||
compares to encryption types and returns if they use compatible
|
||||
encryption key types.
|
||||
.Pp
|
||||
.Fn krb5_c_make_checksum
|
||||
creates a checksum
|
||||
.Fa cksum
|
||||
|
Reference in New Issue
Block a user