diff options
| author | Enji Cooper <ngie@FreeBSD.org> | 2024-06-20 23:24:17 +0000 |
|---|---|---|
| committer | Enji Cooper <ngie@FreeBSD.org> | 2024-06-20 23:24:17 +0000 |
| commit | 1070e7dca8223387baf5155524b28f62bfe7da3c (patch) | |
| tree | eaa96223b0f6fd1e86ecd5165af26a4d85a3fff2 /doc/man1 | |
| parent | 9dd13e84fa8eca8f3462bd55485aa3da8c37f54a (diff) | |
Diffstat (limited to 'doc/man1')
| -rw-r--r-- | doc/man1/openssl-crl.pod.in | 5 | ||||
| -rw-r--r-- | doc/man1/openssl-mac.pod.in | 17 | ||||
| -rw-r--r-- | doc/man1/openssl-req.pod.in | 33 | ||||
| -rw-r--r-- | doc/man1/openssl-smime.pod.in | 18 | ||||
| -rw-r--r-- | doc/man1/openssl-storeutl.pod.in | 5 | ||||
| -rw-r--r-- | doc/man1/openssl-ts.pod.in | 8 |
6 files changed, 51 insertions, 35 deletions
diff --git a/doc/man1/openssl-crl.pod.in b/doc/man1/openssl-crl.pod.in index 7e15f6445a6f..5ace18f5807f 100644 --- a/doc/man1/openssl-crl.pod.in +++ b/doc/man1/openssl-crl.pod.in @@ -95,6 +95,9 @@ Print out the CRL in text form. Verify the signature in the CRL. +This option is implicitly enabled if any of B<-CApath>, B<-CAfile> +or B<-CAstore> is specified. + =item B<-noout> Don't output the encoded version of the CRL. @@ -162,7 +165,7 @@ L<ossl_store-file(7)> =head1 COPYRIGHT -Copyright 2000-2021 The OpenSSL Project Authors. All Rights Reserved. +Copyright 2000-2024 The OpenSSL Project Authors. All Rights Reserved. Licensed under the Apache License 2.0 (the "License"). You may not use this file except in compliance with the License. You can obtain a copy diff --git a/doc/man1/openssl-mac.pod.in b/doc/man1/openssl-mac.pod.in index 563974799109..5ed979697381 100644 --- a/doc/man1/openssl-mac.pod.in +++ b/doc/man1/openssl-mac.pod.in @@ -123,26 +123,31 @@ To see the list of supported MAC's use the command C<openssl list =head1 EXAMPLES -To create a hex-encoded HMAC-SHA1 MAC of a file and write to stdout: \ +To create a hex-encoded HMAC-SHA1 MAC of a file and write to stdout: + openssl mac -digest SHA1 \ -macopt hexkey:000102030405060708090A0B0C0D0E0F10111213 \ -in msg.bin HMAC -To create a SipHash MAC from a file with a binary file output: \ +To create a SipHash MAC from a file with a binary file output: + openssl mac -macopt hexkey:000102030405060708090A0B0C0D0E0F \ -in msg.bin -out out.bin -binary SipHash -To create a hex-encoded CMAC-AES-128-CBC MAC from a file:\ +To create a hex-encoded CMAC-AES-128-CBC MAC from a file: + openssl mac -cipher AES-128-CBC \ -macopt hexkey:77A77FAF290C1FA30C683DF16BA7A77B \ -in msg.bin CMAC To create a hex-encoded KMAC128 MAC from a file with a Customisation String -'Tag' and output length of 16: \ +'Tag' and output length of 16: + openssl mac -macopt custom:Tag -macopt hexkey:40414243444546 \ -macopt size:16 -in msg.bin KMAC128 -To create a hex-encoded GMAC-AES-128-GCM with a IV from a file: \ +To create a hex-encoded GMAC-AES-128-GCM with a IV from a file: + openssl mac -cipher AES-128-GCM -macopt hexiv:E0E00F19FED7BA0136A797F3 \ -macopt hexkey:77A77FAF290C1FA30C683DF16BA7A77B -in msg.bin GMAC @@ -165,7 +170,7 @@ L<EVP_MAC-Poly1305(7)> =head1 COPYRIGHT -Copyright 2018-2022 The OpenSSL Project Authors. All Rights Reserved. +Copyright 2018-2024 The OpenSSL Project Authors. All Rights Reserved. Licensed under the Apache License 2.0 (the "License"). You may not use this file except in compliance with the License. You can obtain a copy diff --git a/doc/man1/openssl-req.pod.in b/doc/man1/openssl-req.pod.in index 31fd71418773..a56f548de8ee 100644 --- a/doc/man1/openssl-req.pod.in +++ b/doc/man1/openssl-req.pod.in @@ -472,16 +472,29 @@ any digest that has been set. =item B<string_mask> This option masks out the use of certain string types in certain -fields. Most users will not need to change this option. +fields. Most users will not need to change this option. It can be set to +several values: -It can be set to several values B<default> which is also the default -option uses PrintableStrings, T61Strings and BMPStrings if the -B<pkix> value is used then only PrintableStrings and BMPStrings will -be used. This follows the PKIX recommendation in RFC2459. If the -B<utf8only> option is used then only UTF8Strings will be used: this -is the PKIX recommendation in RFC2459 after 2003. Finally the B<nombstr> -option just uses PrintableStrings and T61Strings: certain software has -problems with BMPStrings and UTF8Strings: in particular Netscape. +=over 4 + +=item B<utf8only> +- only UTF8Strings are used (this is the default value) + +=item B<pkix> +- any string type except T61Strings + +=item B<nombstr> +- any string type except BMPStrings and UTF8Strings + +=item B<default> +- any kind of string type + +=back + +Note that B<utf8only> is the PKIX recommendation in RFC2459 after 2003, and the +default B<string_mask>; B<default> is not the default option. The B<nombstr> +value is a workaround for some software that has problems with variable-sized +BMPStrings and UTF8Strings. =item B<req_extensions> @@ -765,7 +778,7 @@ The <-nodes> option was deprecated in OpenSSL 3.0, too; use B<-noenc> instead. =head1 COPYRIGHT -Copyright 2000-2021 The OpenSSL Project Authors. All Rights Reserved. +Copyright 2000-2024 The OpenSSL Project Authors. All Rights Reserved. Licensed under the Apache License 2.0 (the "License"). You may not use this file except in compliance with the License. You can obtain a copy diff --git a/doc/man1/openssl-smime.pod.in b/doc/man1/openssl-smime.pod.in index e438c866c383..0b5dbb5df8f7 100644 --- a/doc/man1/openssl-smime.pod.in +++ b/doc/man1/openssl-smime.pod.in @@ -195,14 +195,14 @@ Don't try to verify the signatures on the message. =item B<-nocerts> -When signing a message the signer's certificate is normally included -with this option it is excluded. This will reduce the size of the -signed message but the verifier must have a copy of the signers certificate +When signing a message, the signer's certificate is normally included. +With this option it is excluded. This will reduce the size of the +signed message, but the verifier must have a copy of the signers certificate available locally (passed using the B<-certfile> option for example). =item B<-noattr> -Normally when a message is signed a set of attributes are included which +Normally, when a message is signed, a set of attributes are included which include the signing time and supported symmetric algorithms. With this option they are not included. @@ -243,14 +243,6 @@ used multiple times if more than one signer is required. If a message is being verified then the signers certificates will be written to this file if the verification was successful. -=item B<-nocerts> - -Don't include signers certificate when signing. - -=item B<-noattr> - -Don't include any signed attributes when signing. - =item B<-recip> I<file> The recipients certificate when decrypting a message. This certificate @@ -482,7 +474,7 @@ The B<-engine> option was deprecated in OpenSSL 3.0. =head1 COPYRIGHT -Copyright 2000-2021 The OpenSSL Project Authors. All Rights Reserved. +Copyright 2000-2024 The OpenSSL Project Authors. All Rights Reserved. Licensed under the Apache License 2.0 (the "License"). You may not use this file except in compliance with the License. You can obtain a copy diff --git a/doc/man1/openssl-storeutl.pod.in b/doc/man1/openssl-storeutl.pod.in index 26d5ee28e647..2b619d7c356e 100644 --- a/doc/man1/openssl-storeutl.pod.in +++ b/doc/man1/openssl-storeutl.pod.in @@ -79,6 +79,9 @@ returned. Note that all options must be given before the I<uri> argument. Otherwise they are ignored. +Note I<-keys> selects exclusively private keys, there is no selector for public +keys only. + =item B<-subject> I<arg> Search for an object having the subject name I<arg>. @@ -137,7 +140,7 @@ The B<-engine> option was deprecated in OpenSSL 3.0. =head1 COPYRIGHT -Copyright 2016-2023 The OpenSSL Project Authors. All Rights Reserved. +Copyright 2016-2024 The OpenSSL Project Authors. All Rights Reserved. Licensed under the Apache License 2.0 (the "License"). You may not use this file except in compliance with the License. You can obtain a copy diff --git a/doc/man1/openssl-ts.pod.in b/doc/man1/openssl-ts.pod.in index 3e7f7c4be94b..5f4895b34d6c 100644 --- a/doc/man1/openssl-ts.pod.in +++ b/doc/man1/openssl-ts.pod.in @@ -163,9 +163,9 @@ use its own default policy. (Optional) =item B<-no_nonce> No nonce is specified in the request if this option is -given. Otherwise a 64 bit long pseudo-random none is -included in the request. It is recommended to use nonce to -protect against replay-attacks. (Optional) +given. Otherwise, a 64-bit long pseudo-random nonce is +included in the request. It is recommended to use a nonce to +protect against replay attacks. (Optional) =item B<-cert> @@ -652,7 +652,7 @@ L<ossl_store-file(7)> =head1 COPYRIGHT -Copyright 2006-2023 The OpenSSL Project Authors. All Rights Reserved. +Copyright 2006-2024 The OpenSSL Project Authors. All Rights Reserved. Licensed under the Apache License 2.0 (the "License"). You may not use this file except in compliance with the License. You can obtain a copy |
