diff options
Diffstat (limited to 'secure/usr.bin/openssl/man/openssl-kdf.1')
| -rw-r--r-- | secure/usr.bin/openssl/man/openssl-kdf.1 | 29 |
1 files changed, 16 insertions, 13 deletions
diff --git a/secure/usr.bin/openssl/man/openssl-kdf.1 b/secure/usr.bin/openssl/man/openssl-kdf.1 index 8a548f379726..8004da8496f3 100644 --- a/secure/usr.bin/openssl/man/openssl-kdf.1 +++ b/secure/usr.bin/openssl/man/openssl-kdf.1 @@ -1,5 +1,5 @@ .\" -*- mode: troff; coding: utf-8 -*- -.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45) +.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45) .\" .\" Standard preamble: .\" ======================================================================== @@ -52,10 +52,13 @@ . \} .\} .rr rF +.\" +.\" Required to disable full justification in groff 1.23.0. +.if n .ds AD l .\" ======================================================================== .\" .IX Title "OPENSSL-KDF 1ossl" -.TH OPENSSL-KDF 1ossl 2025-09-30 3.5.4 OpenSSL +.TH OPENSSL-KDF 1ossl 2026-04-07 3.5.6 OpenSSL .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l @@ -139,7 +142,7 @@ Alternative to the \fBpass:\fR option where the password is specified in hexadecimal form (two hex digits per byte). .IP \fBsalt:\fR\fIstring\fR 4 .IX Item "salt:string" -Specifies a non-secret unique cryptographic salt as an alphanumeric string +Specifies a non\-secret unique cryptographic salt as an alphanumeric string (use if it contains printable characters only). The length must conform to any restrictions of the KDF algorithm. A salt parameter is required for several KDF algorithms, @@ -150,9 +153,9 @@ Alternative to the \fBsalt:\fR option where the salt is specified in hexadecimal form (two hex digits per byte). .IP \fBinfo:\fR\fIstring\fR 4 .IX Item "info:string" -Some KDF implementations, such as \fBEVP_KDF\-HKDF\fR\|(7), take an 'info' parameter +Some KDF implementations, such as \fBEVP_KDF\-HKDF\fR\|(7), take an \*(Aqinfo\*(Aq parameter for binding the derived key material -to application\- and context-specific information. +to application\- and context\-specific information. Specifies the info, fixed info, other info or shared info argument as an alphanumeric string (use if it contains printable characters only). The length must conform to any restrictions of the KDF algorithm. @@ -190,21 +193,21 @@ The supported algorithms names include TLS1\-PRF, HKDF, SSKDF, PBKDF2, SSHKDF, X942KDF\-ASN1, X942KDF\-CONCAT, X963KDF and SCRYPT. .SH EXAMPLES .IX Header "EXAMPLES" -Use TLS1\-PRF to create a hex-encoded derived key from a secret key and seed: +Use TLS1\-PRF to create a hex\-encoded derived key from a secret key and seed: .PP .Vb 2 \& openssl kdf \-keylen 16 \-kdfopt digest:SHA2\-256 \-kdfopt key:secret \e \& \-kdfopt seed:seed TLS1\-PRF .Ve .PP -Use HKDF to create a hex-encoded derived key from a secret key, salt and info: +Use HKDF to create a hex\-encoded derived key from a secret key, salt and info: .PP .Vb 2 \& openssl kdf \-keylen 10 \-kdfopt digest:SHA2\-256 \-kdfopt key:secret \e \& \-kdfopt salt:salt \-kdfopt info:label HKDF .Ve .PP -Use SSKDF with KMAC to create a hex-encoded derived key from a secret key, salt and info: +Use SSKDF with KMAC to create a hex\-encoded derived key from a secret key, salt and info: .PP .Vb 3 \& openssl kdf \-keylen 64 \-kdfopt mac:KMAC\-128 \-kdfopt maclen:20 \e @@ -212,7 +215,7 @@ Use SSKDF with KMAC to create a hex-encoded derived key from a secret key, salt \& \-kdfopt hexsalt:3638271ccd68a2 SSKDF .Ve .PP -Use SSKDF with HMAC to create a hex-encoded derived key from a secret key, salt and info: +Use SSKDF with HMAC to create a hex\-encoded derived key from a secret key, salt and info: .PP .Vb 3 \& openssl kdf \-keylen 16 \-kdfopt mac:HMAC \-kdfopt digest:SHA2\-256 \e @@ -220,7 +223,7 @@ Use SSKDF with HMAC to create a hex-encoded derived key from a secret key, salt \& \-kdfopt hexsalt:3638271c SSKDF .Ve .PP -Use SSKDF with Hash to create a hex-encoded derived key from a secret key, salt and info: +Use SSKDF with Hash to create a hex\-encoded derived key from a secret key, salt and info: .PP .Vb 3 \& openssl kdf \-keylen 14 \-kdfopt digest:SHA2\-256 \e @@ -228,7 +231,7 @@ Use SSKDF with Hash to create a hex-encoded derived key from a secret key, salt \& \-kdfopt hexinfo:a1b2c3d4 SSKDF .Ve .PP -Use SSHKDF to create a hex-encoded derived key from a secret key, hash and session_id: +Use SSHKDF to create a hex\-encoded derived key from a secret key, hash and session_id: .PP .Vb 5 \& openssl kdf \-keylen 16 \-kdfopt digest:SHA2\-256 \e @@ -238,14 +241,14 @@ Use SSHKDF to create a hex-encoded derived key from a secret key, hash and sessi \& \-kdfopt type:A SSHKDF .Ve .PP -Use PBKDF2 to create a hex-encoded derived key from a password and salt: +Use PBKDF2 to create a hex\-encoded derived key from a password and salt: .PP .Vb 2 \& openssl kdf \-keylen 32 \-kdfopt digest:SHA256 \-kdfopt pass:password \e \& \-kdfopt salt:salt \-kdfopt iter:2 PBKDF2 .Ve .PP -Use scrypt to create a hex-encoded derived key from a password and salt: +Use scrypt to create a hex\-encoded derived key from a password and salt: .PP .Vb 3 \& openssl kdf \-keylen 64 \-kdfopt pass:password \-kdfopt salt:NaCl \e |