oysteikt/heimdal
0
0
Fork 0
Code Issues 5 Pull Requests Releases Activity

document krb5_{de,en}crypt_ivec

Browse Source 
git-svn-id: svn://svn.h5l.se/heimdal/trunk/heimdal@13778 ec53bebd-3082-4978-b11e-865c3cabbd6b
This commit is contained in:
Love Hörnquist Åstrand
2004-04-25 14:50:13 +00:00
parent 89f71476cb
commit 8eb58824b5
1 changed files with 80 additions and 8 deletions
Download Patch File Download Diff File Expand all files Collapse all files

88
lib/krb5/krb5_encrypt.3
View File

@@ -41,9 +41,11 @@
.Nm krb5_crypto_getpadsize ,
.Nm krb5_decrypt ,
.Nm krb5_decrypt_EncryptedData ,
.Nm krb5_decrypt_ivec ,
.Nm krb5_decrypt_ticket ,
.Nm krb5_encrypt ,
.Nm krb5_encrypt_EncryptedData,
.Nm krb5_encrypt_ivec ,
.Nm krb5_enctype_disable ,
.Nm krb5_enctype_is_disabled ,
.Nm krb5_enctype_keysize ,
@@ -56,15 +58,69 @@ Kerberos 5 Library (libkrb5, -lkrb5)
.Sh SYNOPSIS
.In krb5.h
.Ft krb5_error_code
.Fn krb5_encrypt "krb5_context context" "krb5_crypto crypto" "unsigned usage" "void *data" "size_t len" "krb5_data *result"
.Fo krb5_encrypt
.Fa "krb5_context context"
.Fa "krb5_crypto crypto"
.Fa "unsigned usage"
.Fa "void *data"
.Fa "size_t len"
.Fa "krb5_data *result"
.Fc
.Ft krb5_error_code
.Fn krb5_encrypt_EncryptedData "krb5_context context" "krb5_crypto crypto" "unsigned usage" "void *data" "size_t len" "int kvno" "EncryptedData *result"
.Fo krb5_encrypt_EncryptedData
.Fa "krb5_context context"
.Fa "krb5_crypto crypto"
.Fa "unsigned usage"
.Fa "void *data"
.Fa "size_t len"
.Fa "int kvno"
.Fa "EncryptedData *result"
.Fc
.Ft krb5_error_code
.Fn krb5_decrypt "krb5_context context" "krb5_crypto crypto" "unsigned usage" "void *data" "size_t len" "krb5_data *result"
.Fo krb5_encrypt_ivec
.Fa "krb5_context context"
.Fa "krb5_crypto crypto"
.Fa "unsigned usage"
.Fa "void *data"
.Fa "size_t len"
.Fa "krb5_data *result"
.Fa "void *ivec"
.Fc
.Ft krb5_error_code
.Fn krb5_decrypt_EncryptedData "krb5_context context" "krb5_crypto crypto" "unsigned usage" "EncryptedData *e" "krb5_data *result"
.Fo krb5_decrypt
.Fa "krb5_context context"
.Fa "krb5_crypto crypto"
.Fa "unsigned usage"
.Fa "void *data"
.Fa "size_t len"
.Fa "krb5_data *result"
.Fc
.Ft krb5_error_code
.Fn krb5_decrypt_ticket "krb5_context context" "Ticket *ticket" "krb5_keyblock *key" "EncTicketPart *out" "krb5_flags flags"
.Fo krb5_decrypt_EncryptedData
.Fa "krb5_context context"
.Fa "krb5_crypto crypto"
.Fa "unsigned usage"
.Fa "EncryptedData *e"
.Fa "krb5_data *result"
.Fc
.Ft krb5_error_code
.Fo krb5_decrypt_ivec
.Fa "krb5_context context"
.Fa "krb5_crypto crypto"
.Fa "unsigned usage"
.Fa "void *data"
.Fa "size_t len"
.Fa "krb5_data *result"
.Fa "void *ivec"
.Fc
.Ft krb5_error_code
.Fo krb5_decrypt_ticket
.Fa "krb5_context context"
.Fa "Ticket *ticket"
.Fa "krb5_keyblock *key"
.Fa "EncTicketPart *out"
.Fa "krb5_flags flags"
.Fc
.Ft krb5_error_code
.Fo krb5_crypto_getblocksize
.Fa "krb5_context context"
@@ -124,7 +180,7 @@ Kerberos 5 Library (libkrb5, -lkrb5)
.Sh DESCRIPTION
These functions are used to encrypt and decrypt data.
.Pp
.Fn krb5_encrypt
.Fn krb5_encrypt_ivec
puts the encrypted version of
.Fa data
(of size
@@ -134,6 +190,20 @@ in
If the encryption type supports using derived keys,
.Fa usage
should be the appropriate key-usage.
.Fa ivec
is a pointer to a initial IV, its modified to the end IV at the end of
the round.
Ivec should be the size of
If
.Dv NULL
is passed in, the default IV is used.
.Fn krb5_encrypt
does the same as
.Fn krb5_encrypt_ivec
but with
.Fa ivec
being
.Dv NULL .
.Fn krb5_encrypt_EncryptedData
does the same as
.Fn krb5_encrypt ,
@@ -141,10 +211,12 @@ but it puts the encrypted data in a
.Fa EncryptedData
structure instead. If
.Fa kvno
is not zero, it will be put in the
.Fa kvno field in the
is not zero, it will be put in the (optional)
.Fa kvno
field in the
.Fa EncryptedData .
.Pp
.Fn krb5_decrypt_ivec ,
.Fn krb5_decrypt ,
and
.Fn krb5_decrypt_EncryptedData