summaryrefslogtreecommitdiff
path: root/src/usr.bin/openssl/openssl.1
diff options
context:
space:
mode:
Diffstat (limited to 'src/usr.bin/openssl/openssl.1')
-rw-r--r--src/usr.bin/openssl/openssl.152
1 files changed, 14 insertions, 38 deletions
diff --git a/src/usr.bin/openssl/openssl.1 b/src/usr.bin/openssl/openssl.1
index 6ceb53ef5c..40defdc38b 100644
--- a/src/usr.bin/openssl/openssl.1
+++ b/src/usr.bin/openssl/openssl.1
@@ -1,4 +1,4 @@
1.\" $OpenBSD: openssl.1,v 1.162 2025/01/19 10:24:17 tb Exp $ 1.\" $OpenBSD: openssl.1,v 1.167 2025/06/07 08:29:20 tb Exp $
2.\" ==================================================================== 2.\" ====================================================================
3.\" Copyright (c) 1998-2002 The OpenSSL Project. All rights reserved. 3.\" Copyright (c) 1998-2002 The OpenSSL Project. All rights reserved.
4.\" 4.\"
@@ -110,7 +110,7 @@
110.\" copied and put under another distribution licence 110.\" copied and put under another distribution licence
111.\" [including the GNU Public Licence.] 111.\" [including the GNU Public Licence.]
112.\" 112.\"
113.Dd $Mdocdate: January 19 2025 $ 113.Dd $Mdocdate: June 7 2025 $
114.Dt OPENSSL 1 114.Dt OPENSSL 1
115.Os 115.Os
116.Sh NAME 116.Sh NAME
@@ -325,7 +325,6 @@ into a nested structure.
325.Op Fl keyfile Ar file 325.Op Fl keyfile Ar file
326.Op Fl keyform Cm pem | der 326.Op Fl keyform Cm pem | der
327.Op Fl md Ar alg 327.Op Fl md Ar alg
328.Op Fl msie_hack
329.Op Fl multivalue-rdn 328.Op Fl multivalue-rdn
330.Op Fl name Ar section 329.Op Fl name Ar section
331.Op Fl noemailDN 330.Op Fl noemailDN
@@ -422,17 +421,6 @@ Possible values include
422and 421and
423.Ar sha1 . 422.Ar sha1 .
424This option also applies to CRLs. 423This option also applies to CRLs.
425.It Fl msie_hack
426This is a legacy option to make
427.Nm ca
428work with very old versions of the IE certificate enrollment control
429.Qq certenr3 .
430It used UniversalStrings for almost everything.
431Since the old control has various security bugs,
432its use is strongly discouraged.
433The newer control
434.Qq Xenroll
435does not need this option.
436.It Fl multivalue-rdn 424.It Fl multivalue-rdn
437This option causes the 425This option causes the
438.Fl subj 426.Fl subj
@@ -629,11 +617,9 @@ specified using
629.Cm default_ca 617.Cm default_ca
630or 618or
631.Fl name . 619.Fl name .
632The options 620The
633.Cm preserve 621.Cm preserve
634and 622option is read directly from the
635.Cm msie_hack
636are read directly from the
637.Cm ca 623.Cm ca
638section. 624section.
639.Pp 625.Pp
@@ -746,9 +732,6 @@ simply set this to
746.Qq no . 732.Qq no .
747If not present, the default is to allow for the EMAIL field in the 733If not present, the default is to allow for the EMAIL field in the
748certificate's DN. 734certificate's DN.
749.It Cm msie_hack
750The same as
751.Fl msie_hack .
752.It Cm name_opt , cert_opt 735.It Cm name_opt , cert_opt
753These options allow the format used to display the certificate details 736These options allow the format used to display the certificate details
754when asking the user to confirm signing. 737when asking the user to confirm signing.
@@ -1108,7 +1091,7 @@ The encryption algorithm to use.
1108128-, 192-, or 256-bit AES, 128-, 192-, or 256-bit CAMELLIA, 1091128-, 192-, or 256-bit AES, 128-, 192-, or 256-bit CAMELLIA,
1109DES (56 bits), triple DES (168 bits), 1092DES (56 bits), triple DES (168 bits),
1110or 40-, 64-, or 128-bit RC2, respectively; 1093or 40-, 64-, or 128-bit RC2, respectively;
1111if not specified, triple DES is 1094if not specified, 256-bit AES is
1112used. 1095used.
1113Only used with 1096Only used with
1114.Fl encrypt 1097.Fl encrypt
@@ -2990,9 +2973,6 @@ command processes private keys
2990(both encrypted and unencrypted) 2973(both encrypted and unencrypted)
2991in PKCS#8 format 2974in PKCS#8 format
2992with a variety of PKCS#5 (v1.5 and v2.0) and PKCS#12 algorithms. 2975with a variety of PKCS#5 (v1.5 and v2.0) and PKCS#12 algorithms.
2993The default encryption is only 56 bits;
2994keys encrypted using PKCS#5 v2.0 algorithms and high iteration counts
2995are more secure.
2996.Pp 2976.Pp
2997The options are as follows: 2977The options are as follows:
2998.Bl -tag -width Ds 2978.Bl -tag -width Ds
@@ -3038,16 +3018,12 @@ which allow strong encryption algorithms like triple DES or 128-bit RC2.
3038.El 3018.El
3039.It Fl v2 Ar alg 3019.It Fl v2 Ar alg
3040Use PKCS#5 v2.0 algorithms. 3020Use PKCS#5 v2.0 algorithms.
3041Supports algorithms such as 168-bit triple DES or 128-bit RC2, 3021These are block ciphers used in CBC mode.
3042however not many implementations support PKCS#5 v2.0 yet 3022The default is AES-256-CBC.
3043(if using private keys with 3023With the exception of AES, the choices available in RFC 8018
3044.Nm openssl 3024are considered decrepit.
3045this doesn't matter). 3025They can be enabled with des, des3, and rc2
3046.Pp 3026(rc5 is no longer supported).
3047.Ar alg
3048is the encryption algorithm to use;
3049valid values include des, des3, and rc2.
3050It is recommended that des3 is used.
3051.El 3027.El
3052.Tg pkcs12 3028.Tg pkcs12
3053.Sh PKCS12 3029.Sh PKCS12
@@ -5122,7 +5098,7 @@ The remaining options are as follows:
5122The encryption algorithm to use. 5098The encryption algorithm to use.
5123128-, 192-, or 256-bit AES, DES (56 bits), triple DES (168 bits), 5099128-, 192-, or 256-bit AES, DES (56 bits), triple DES (168 bits),
5124or 40-, 64-, or 128-bit RC2, respectively; 5100or 40-, 64-, or 128-bit RC2, respectively;
5125if not specified, 40-bit RC2 is 5101if not specified, 256-bit AES is
5126used. 5102used.
5127Only used with 5103Only used with
5128.Fl encrypt . 5104.Fl encrypt .
@@ -6165,7 +6141,7 @@ either using a list of comma-separated options or by specifying
6165.Fl nameopt 6141.Fl nameopt
6166multiple times. 6142multiple times.
6167The default behaviour is to use the 6143The default behaviour is to use the
6168.Cm oneline 6144.Cm compat
6169format. 6145format.
6170The options, 6146The options,
6171which can be preceded by a dash to turn them off, 6147which can be preceded by a dash to turn them off,
@@ -6247,7 +6223,7 @@ A one line format which is more readable than
6247.Cm RFC2253 . 6223.Cm RFC2253 .
6248Equivalent to 6224Equivalent to
6249.Cm esc_2253 , esc_ctrl , esc_msb , utf8 , 6225.Cm esc_2253 , esc_ctrl , esc_msb , utf8 ,
6250.Cm dump_nostr , dump_der , use_quote , sep_comma_plus_spc , 6226.Cm dump_nostr , dump_der , use_quote , sep_comma_plus_space ,
6251.Cm space_eq , 6227.Cm space_eq ,
6252and 6228and
6253.Cm sname . 6229.Cm sname .