Lines Matching +full:side +full:- +full:by +full:- +full:side
1 .\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.42)
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-MAC 7ossl"
134 .TH PROVIDER-MAC 7ossl "2023-09-19" "3.0.11" "OpenSSL"
140 provider\-mac \- The mac library <\-> provider functions
179 The \s-1MAC\s0 operation enables providers to implement mac algorithms and make
180 them available to applications via the \s-1API\s0 functions \fBEVP_MAC_init\fR\|(3),
184 \&\fIlibcrypto\fR and the provider in \s-1\fBOSSL_DISPATCH\s0\fR\|(3) arrays via
185 \&\s-1\fBOSSL_ALGORITHM\s0\fR\|(3) arrays that are returned by the provider's
187 (see \*(L"Provider Functions\*(R" in \fBprovider\-base\fR\|(7)).
191 function pointer from an \s-1\fBOSSL_DISPATCH\s0\fR\|(3) element named
201 \&\s-1\fBOSSL_DISPATCH\s0\fR\|(3) arrays are indexed by numbers that are provided as
202 macros in \fBopenssl\-core_dispatch.h\fR\|(7), as follows:
229 \&\fBOSSL_FUNC_mac_newctx()\fR should create and return a pointer to a provider side
236 \&\fBOSSL_FUNC_mac_freectx()\fR is passed a pointer to the provider side mac context in
238 If it receives \s-1NULL\s0 as \fImctx\fR value, it should not do anything other than
242 \&\fBOSSL_FUNC_mac_dupctx()\fR should duplicate the provider side mac context in the
247 side mac context in the \fImctx\fR parameter. The \fIparams\fR are set before setting
248 the \s-1MAC\s0 \fIkey\fR of \fIkeylen\fR bytes.
250 \&\fBOSSL_FUNC_mac_update()\fR is called to supply data for \s-1MAC\s0 computation of a previously
253 side context.
256 \&\fBOSSL_FUNC_mac_final()\fR completes the \s-1MAC\s0 computation started through previous
258 The \fImctx\fR parameter contains a pointer to the provider side context.
259 The resulting \s-1MAC\s0 should be written to \fIout\fR and the amount of data written
265 See \s-1\fBOSSL_PARAM\s0\fR\|(3) for further details on the parameters structure used by
272 provider side mac context \fImctx\fR to \fIparams\fR.
274 Passing \s-1NULL\s0 for \fIparams\fR should return true.
277 associated with the given provider side mac context \fImctx\fR and stores them
279 Passing \s-1NULL\s0 for \fIparams\fR should return true.
282 and \fBOSSL_FUNC_mac_settable_ctx_params()\fR all return constant \s-1\fBOSSL_PARAM\s0\fR\|(3)
287 with the provider side context \fImctx\fR in its current state if it is
288 not \s-1NULL.\s0 Otherwise, they return the parameters associated with the
289 provider side algorithm \fIprovctx\fR.
291 All \s-1MAC\s0 implementations are expected to handle the following parameters:
300 Sets the key in the associated \s-1MAC\s0 ctx. This is identical to passing a \fIkey\fR
313 Can be used to get the default \s-1MAC\s0 size (which might be the only allowable
314 \&\s-1MAC\s0 size for the implementation).
316 Note that some implementations allow setting the size that the resulting \s-1MAC\s0
323 Can be used to get the \s-1MAC\s0 block size (if supported by the algorithm).
329 The \s-1MAC\s0 life-cycle is described in \fBlife_cycle\-rand\fR\|(7). Providers should
331 the \s-1EVP\s0 layer will begin enforcing the listed transitions.
335 provider side mac context, or \s-1NULL\s0 on failure.
342 \&\fBOSSL_FUNC_mac_settable_ctx_params()\fR should return a constant \s-1\fBOSSL_PARAM\s0\fR\|(3)
343 array, or \s-1NULL\s0 if none is offered.
347 \&\s-1\fBEVP_MAC\-BLAKE2\s0\fR\|(7), \s-1\fBEVP_MAC\-CMAC\s0\fR\|(7), \s-1\fBEVP_MAC\-GMAC\s0\fR\|(…
348 \&\s-1\fBEVP_MAC\-HMAC\s0\fR\|(7), \s-1\fBEVP_MAC\-KMAC\s0\fR\|(7), \fBEVP_MAC\-Poly1305\fR\|(7),
349 \&\fBEVP_MAC\-Siphash\fR\|(7),
350 \&\fBlife_cycle\-mac\fR\|(7), \s-1\fBEVP_MAC\s0\fR\|(3)
353 The provider \s-1MAC\s0 interface was introduced in OpenSSL 3.0.
356 Copyright 2019\-2022 The OpenSSL Project Authors. All Rights Reserved.
360 in the file \s-1LICENSE\s0 in the source distribution or at