File: krb5_k_encrypt.rst.txt

package info (click to toggle)
krb5 1.18.3-6%2Bdeb11u5
  • links: PTS, VCS
  • area: main
  • in suites: bullseye
  • size: 52,500 kB
  • sloc: ansic: 302,656; exp: 13,173; cpp: 9,693; python: 9,298; javascript: 9,118; makefile: 7,158; sh: 6,305; perl: 1,926; asm: 1,460; yacc: 1,005; awk: 396; csh: 147; xml: 135; lisp: 104; sed: 41
file content (65 lines) | stat: -rw-r--r-- 1,436 bytes parent folder | download | duplicates (6)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
krb5_k_encrypt -  Encrypt data using a key (operates on opaque key). 
=====================================================================

..

.. c:function:: krb5_error_code krb5_k_encrypt(krb5_context context, krb5_key key, krb5_keyusage usage, const krb5_data * cipher_state, const krb5_data * input, krb5_enc_data * output)

..


:param:

	          **[in]** **context** - Library context

	          **[in]** **key** - Encryption key

	          **[in]** **usage** - Key usage (see :data:`KRB5_KEYUSAGE` types)

	          **[inout]** **cipher_state** - Cipher state; specify NULL if not needed

	          **[in]** **input** - Data to be encrypted

	          **[out]** **output** - Encrypted data


..


:retval:
         -   0   Success; otherwise - Kerberos error codes


..







This function encrypts the data block *input* and stores the output into *output* . The actual encryption key will be derived from *key* and *usage* if key derivation is specified for the encryption type. If non-null, *cipher_state* specifies the beginning state for the encryption operation, and is updated with the state to be passed as input to the next operation.










..






.. note::

	 The caller must initialize *output* and allocate at least enough space for the result (using :c:func:`krb5_c_encrypt_length()` to determine the amount of space needed). *output->length* will be set to the actual length of the ciphertext.