Documentation/crypto/userspace-if.rst

13 consumer and never as a provider of a transformation or cipher
56 A cipher is accessed with the same name as done for the in-kernel API
61 user space application. User space invokes the cipher operation with the
62 send()/write() system call family. The result of the cipher operation is
73    parameter specified below for the different cipher types.
79    particular cipher instance. When invoking send/write or recv/read
83 In-place Cipher operation
87 space interface allows the cipher operation in-place. That means that
90 is of particular interest for symmetric cipher operations where a
101 The message digest type to be used for the cipher operation is selected
111         .salg_name = "sha1" /* this is the cipher name */
138 Symmetric Cipher API
149         .salg_type = "skcipher", /* this selects the symmetric cipher */
150         .salg_name = "cbc(aes)" /* this is the cipher name */
168 -  specification of the cipher operation type with one of these flags:
179    cipher update function where more input data is expected with a
184 /proc/crypto for the selected cipher.
187 cipher operation from the kernel crypto API. The output buffer must be
192 AEAD Cipher API
195 The operation is very similar to the symmetric cipher discussion. During
203         .salg_type = "aead", /* this selects the symmetric cipher */
204         .salg_name = "gcm(aes)" /* this is the cipher name */
227 -  specification of the cipher operation type with one of these flags:
242    cipher update function where more input data is expected with a
247 /proc/crypto for the selected cipher.
250 cipher operation from the kernel crypto API. The output buffer must be
252 output data size is smaller, the cipher operation is not performed.
260 The AEAD cipher operates with the following information that is
364 and retrieve data subject to the cipher operation, a consumer also needs
365 to set the additional information for the cipher operation. This
367 be invoked with the file descriptor of the open cipher (i.e. the file
377    -  the skcipher cipher type (symmetric ciphers)
379    -  the hash cipher type (keyed message digests)
381    -  the AEAD cipher type
383    -  the RNG cipher type to provide the seed
401    This option is applicable to RNG cipher type only.