Lines Matching +full:out +full:- +full:functions
18 .\" Set up some character translations and predefined strings. \*(-- will
24 .tr \(*W-
27 . ds -- \(*W-
29 . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
30 . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
37 . ds -- \|\(em\|
71 .\" Fear. Run. Save yourself. No user-serviceable parts.
81 . ds #H ((1u-(\\\\n(.fu%2u))*.13m)
97 . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
98 . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
99 . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
100 . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
101 . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
102 . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
104 . \" troff and (daisy-wheel) nroff accents
123 . ds d- d\h'-1'\(ga
124 . ds D- D\h'-1'\(hy
133 .IX Title "PROVIDER-ASYM_CIPHER 7ossl"
134 .TH PROVIDER-ASYM_CIPHER 7ossl "2023-09-19" "3.0.11" "OpenSSL"
140 provider\-asym_cipher \- The asym_cipher library <\-> provider functions
148 \& * None of these are actual functions, but are displayed like this for
149 \& * the function signatures for functions that are offered as function
161 \& int OSSL_FUNC_asym_cipher_encrypt(void *ctx, unsigned char *out, size_t *outlen,
168 \& int OSSL_FUNC_asym_cipher_decrypt(void *ctx, unsigned char *out, size_t *outlen,
183 The asymmetric cipher (\s-1OSSL_OP_ASYM_CIPHER\s0) operation enables providers to
185 via the \s-1API\s0 functions \fBEVP_PKEY_encrypt\fR\|(3),
187 other related functions).
189 All \*(L"functions\*(R" mentioned here are passed as function pointers between
190 \&\fIlibcrypto\fR and the provider in \s-1\fBOSSL_DISPATCH\s0\fR\|(3) arrays via
191 \&\s-1\fBOSSL_ALGORITHM\s0\fR\|(3) arrays that are returned by the provider's
193 (see \*(L"Provider Functions\*(R" in \fBprovider\-base\fR\|(7)).
195 All these \*(L"functions\*(R" have a corresponding function type definition
197 function pointer from an \s-1\fBOSSL_DISPATCH\s0\fR\|(3) element named
207 \&\s-1\fBOSSL_DISPATCH\s0\fR\|(3) arrays are indexed by numbers that are provided as
208 macros in \fBopenssl\-core_dispatch.h\fR\|(7), as follows:
228 functions.
229 In order to be a consistent set of functions a provider must implement
240 loading or importing keys via the key management (\s-1OSSL_OP_KEYMGMT\s0) operation.
241 See \fBprovider\-keymgmt\fR\|(7) for further details.
242 .SS "Context Management Functions"
243 .IX Subsection "Context Management Functions"
257 .SS "Encryption Functions"
258 .IX Subsection "Encryption Functions"
262 The \fIparams\fR, if not \s-1NULL,\s0 should be set on the context in a manner similar to
265 the provider using the key management (\s-1OSSL_OP_KEYMGMT\s0) operation (see \fBprovider\-keymgmt\…
271 Unless \fIout\fR is \s-1NULL,\s0 the encrypted data should be written to the location
272 pointed to by the \fIout\fR parameter and it should not exceed \fIoutsize\fR bytes in
275 If \fIout\fR is \s-1NULL\s0 then the maximum length of the encrypted data should be
277 .SS "Decryption Functions"
278 .IX Subsection "Decryption Functions"
282 The \fIparams\fR, if not \s-1NULL,\s0 should be set on the context in a manner similar to
285 the provider using the key management (\s-1OSSL_OP_KEYMGMT\s0) operation (see
286 \&\fBprovider\-keymgmt\fR\|(7)).
293 Unless \fIout\fR is \s-1NULL,\s0 the decrypted data should be written to the location
294 pointed to by the \fIout\fR parameter and it should not exceed \fIoutsize\fR bytes in
297 If \fIout\fR is \s-1NULL\s0 then the maximum length of the decrypted data should be
301 See \s-1\fBOSSL_PARAM\s0\fR\|(3) for further details on the parameters structure used by
303 functions.
308 Passing \s-1NULL\s0 for \fIparams\fR should return true.
313 Passing \s-1NULL\s0 for \fIparams\fR should return true.
315 Parameters currently recognised by built-in asymmetric cipher algorithms are as
321 .IX Item "pad-mode (OSSL_ASYM_CIPHER_PARAM_PAD_MODE) <UTF8 string> OR <integer>"
327 Gets or sets the name of the \s-1OAEP\s0 digest algorithm used when \s-1OAEP\s0 padding is in
336 .IX Item "digest-props (OSSL_ASYM_CIPHER_PARAM_OAEP_DIGEST_PROPS) <UTF8 string>"
337 Gets or sets the properties to use when fetching the \s-1OAEP\s0 digest algorithm.
340 .IX Item "digest-props (OSSL_ASYM_CIPHER_PARAM_DIGEST_PROPS) <UTF8 string>"
344 .IX Item "mgf1-digest (OSSL_ASYM_CIPHER_PARAM_MGF1_DIGEST) <UTF8 string>"
345 Gets or sets the name of the \s-1MGF1\s0 digest algorithm used when \s-1OAEP\s0 or \s-1PSS\s0 paddi…
349 .IX Item "mgf1-digest-props (OSSL_ASYM_CIPHER_PARAM_MGF1_DIGEST_PROPS) <UTF8 string>"
350 Gets or sets the properties to use when fetching the \s-1MGF1\s0 digest algorithm.
353 .IX Item "oaep-label (OSSL_ASYM_CIPHER_PARAM_OAEP_LABEL) <octet string ptr>"
354 Gets the \s-1OAEP\s0 label used when \s-1OAEP\s0 padding is in use.
357 .IX Item "oaep-label (OSSL_ASYM_CIPHER_PARAM_OAEP_LABEL) <octet string>"
358 Sets the \s-1OAEP\s0 label used when \s-1OAEP\s0 padding is in use.
361 .IX Item "tls-client-version (OSSL_ASYM_CIPHER_PARAM_TLS_CLIENT_VERSION) <unsigned integer>"
362 The \s-1TLS\s0 protocol version first requested by the client.
365 .IX Item "tls-negotiated-version (OSSL_ASYM_CIPHER_PARAM_TLS_CLIENT_VERSION) <unsigned integer>"
366 The negotiated \s-1TLS\s0 protocol version.
369 get a constant \s-1\fBOSSL_PARAM\s0\fR\|(3) array that describes the gettable and settable
375 created provider side asymmetric cipher context, or \s-1NULL\s0 on failure.
377 All other functions should return 1 for success or 0 on error.
383 The provider \s-1ASYM_CIPHER\s0 interface was introduced in OpenSSL 3.0.
386 Copyright 2019\-2023 The OpenSSL Project Authors. All Rights Reserved.
390 in the file \s-1LICENSE\s0 in the source distribution or at