Lines Matching +full:per +full:- +full:string
1 .\" -*- mode: troff; coding: utf-8 -*-
57 .IX Title "OPENSSL-MAC 1ossl"
58 .TH OPENSSL-MAC 1ossl 2025-09-30 3.5.4 OpenSSL
64 openssl\-mac \- perform Message Authentication Code operations
68 [\fB\-help\fR]
69 [\fB\-cipher\fR]
70 [\fB\-digest\fR]
71 [\fB\-macopt\fR]
72 [\fB\-in\fR \fIfilename\fR]
73 [\fB\-out\fR \fIfilename\fR]
74 [\fB\-binary\fR]
75 [\fB\-provider\fR \fIname\fR]
76 [\fB\-provider\-path\fR \fIpath\fR]
77 [\fB\-provparam\fR \fI[name:]key=value\fR]
78 [\fB\-propquery\fR \fIpropq\fR]
86 .IP \fB\-help\fR 4
87 .IX Item "-help"
89 .IP "\fB\-in\fR \fIfilename\fR" 4
90 .IX Item "-in filename"
92 Standard input is used if the filename is '\-'.
94 .IP "\fB\-out\fR \fIfilename\fR" 4
95 .IX Item "-out filename"
97 .IP \fB\-binary\fR 4
98 .IX Item "-binary"
100 .IP "\fB\-cipher\fR \fIname\fR" 4
101 .IX Item "-cipher name"
103 For CMAC it should be a CBC mode cipher e.g. AES\-128\-CBC.
104 For GMAC it should be a GCM mode cipher e.g. AES\-128\-GCM.
105 .IP "\fB\-digest\fR \fIname\fR" 4
106 .IX Item "-digest name"
107 Used by HMAC as an alphanumeric string (use if the key contains printable
109 The string length must conform to any restrictions of the MAC algorithm.
110 To see the list of supported digests, use \f(CW\*(C`openssl list \-digest\-commands\*(C'\fR.
111 .IP "\fB\-macopt\fR \fInm\fR:\fIv\fR" 4
112 .IX Item "-macopt nm:v"
118 .IP \fBkey:\fR\fIstring\fR 4
119 .IX Item "key:string"
120 Specifies the MAC key as an alphanumeric string (use if the key contains
122 The string length must conform to any restrictions of the MAC algorithm.
124 .IP \fBhexkey:\fR\fIstring\fR 4
125 .IX Item "hexkey:string"
126 Specifies the MAC key in hexadecimal form (two hex digits per byte).
129 .IP \fBiv:\fR\fIstring\fR 4
130 .IX Item "iv:string"
131 Used by GMAC to specify an IV as an alphanumeric string (use if the IV contains
133 .IP \fBhexiv:\fR\fIstring\fR 4
134 .IX Item "hexiv:string"
135 Used by GMAC to specify an IV in hexadecimal form (two hex digits per byte).
140 .IP \fBcustom:\fR\fIstring\fR 4
141 .IX Item "custom:string"
142 Used by KMAC128 or KMAC256 to specify a customization string.
143 The default is the empty string "".
144 .IP \fBdigest:\fR\fIstring\fR 4
145 .IX Item "digest:string"
146 This option is identical to the \fB\-digest\fR option.
147 .IP \fBcipher:\fR\fIstring\fR 4
148 .IX Item "cipher:string"
149 This option is identical to the \fB\-cipher\fR option.
153 .IP "\fB\-provider\fR \fIname\fR" 4
154 .IX Item "-provider name"
156 .IP "\fB\-provider\-path\fR \fIpath\fR" 4
157 .IX Item "-provider-path path"
158 .IP "\fB\-provparam\fR \fI[name:]key=value\fR" 4
159 .IX Item "-provparam [name:]key=value"
160 .IP "\fB\-propquery\fR \fIpropq\fR" 4
161 .IX Item "-propquery propq"
168 \&\-mac\-algorithms\*(C'\fR.
171 To create a hex-encoded HMAC\-SHA1 MAC of a file and write to stdout:
174 \& openssl mac \-digest SHA1 \e
175 \& \-macopt hexkey:000102030405060708090A0B0C0D0E0F10111213 \e
176 \& \-in msg.bin HMAC
182 \& openssl mac \-macopt hexkey:000102030405060708090A0B0C0D0E0F \e
183 \& \-in msg.bin \-out out.bin \-binary SipHash
186 To create a hex-encoded CMAC\-AES\-128\-CBC MAC from a file:
189 \& openssl mac \-cipher AES\-128\-CBC \e
190 \& \-macopt hexkey:77A77FAF290C1FA30C683DF16BA7A77B \e
191 \& \-in msg.bin CMAC
194 To create a hex-encoded KMAC128 MAC from a file with a Customisation String
198 \& openssl mac \-macopt custom:Tag \-macopt hexkey:40414243444546 \e
199 \& \-macopt size:16 \-in msg.bin KMAC128
202 To create a hex-encoded GMAC\-AES\-128\-GCM with a IV from a file:
205 \& openssl mac \-cipher AES\-128\-GCM \-macopt hexiv:E0E00F19FED7BA0136A797F3 \e
206 \& \-macopt hexkey:77A77FAF290C1FA30C683DF16BA7A77B \-in msg.bin GMAC
212 Use \f(CW\*(C`openssl list \-mac\-algorithms\*(C'\fR to list them.
217 \&\fBEVP_MAC\-CMAC\fR\|(7),
218 \&\fBEVP_MAC\-GMAC\fR\|(7),
219 \&\fBEVP_MAC\-HMAC\fR\|(7),
220 \&\fBEVP_MAC\-KMAC\fR\|(7),
221 \&\fBEVP_MAC\-Siphash\fR\|(7),
222 \&\fBEVP_MAC\-Poly1305\fR\|(7)
225 Copyright 2018\-2024 The OpenSSL Project Authors. All Rights Reserved.