From: Rich Salz Date: Fri, 1 Nov 2019 20:26:05 +0000 (-0400) Subject: Fix L links to be L X-Git-Tag: openssl-3.0.0-alpha1~983 X-Git-Url: https://git.librecmc.org/?a=commitdiff_plain;h=1903a9b77af1aa289ce858de90790f3e2749fea9;p=oweals%2Fopenssl.git Fix L links to be L Reviewed-by: Richard Levitte Reviewed-by: Matthias St. Pierre (Merged from https://github.com/openssl/openssl/pull/10328) --- diff --git a/doc/internal/man3/cms_add1_signing_cert.pod b/doc/internal/man3/cms_add1_signing_cert.pod index ac7f813e84..97c5a5111d 100644 --- a/doc/internal/man3/cms_add1_signing_cert.pod +++ b/doc/internal/man3/cms_add1_signing_cert.pod @@ -27,7 +27,7 @@ which updates Section 5.4 of RFC 2634. This attribute is mandatory to make a CMS compliant with CAdES-BES (European Standard ETSI EN 319 122-1 V1.1.1). -For a fuller description see L). +For a fuller description see L). =head1 RETURN VALUES diff --git a/doc/man1/openssl.pod b/doc/man1/openssl.pod index e13a6969b7..5fa16f4a27 100644 --- a/doc/man1/openssl.pod +++ b/doc/man1/openssl.pod @@ -49,7 +49,7 @@ the SYNOPSIS above), each of which often has a wealth of options and arguments (I and I in the SYNOPSIS). Detailed documentation and use cases for most standard subcommands are available -(e.g., L or L). +(e.g., L). Many commands use an external configuration file for some or all of their arguments and have a B<-config> option to specify that file. diff --git a/doc/man3/EVP_DigestInit.pod b/doc/man3/EVP_DigestInit.pod index 2c72a0dce3..01da721d56 100644 --- a/doc/man3/EVP_DigestInit.pod +++ b/doc/man3/EVP_DigestInit.pod @@ -591,7 +591,7 @@ digest name passed on the command line. =head1 SEE ALSO L, -L, +L, L, L, L diff --git a/doc/man3/EVP_DigestSignInit.pod b/doc/man3/EVP_DigestSignInit.pod index dbcd38e7ca..af380dab12 100644 --- a/doc/man3/EVP_DigestSignInit.pod +++ b/doc/man3/EVP_DigestSignInit.pod @@ -174,7 +174,7 @@ L, L, L, L, L, L, L, L, -L, L, +L, L, L =head1 HISTORY diff --git a/doc/man3/EVP_DigestVerifyInit.pod b/doc/man3/EVP_DigestVerifyInit.pod index 480c6cb72a..98ca8dcdbc 100644 --- a/doc/man3/EVP_DigestVerifyInit.pod +++ b/doc/man3/EVP_DigestVerifyInit.pod @@ -163,7 +163,7 @@ L, L, L, L, L, L, L, L, -L, L, +L, L, L =head1 HISTORY diff --git a/doc/man3/EVP_SignInit.pod b/doc/man3/EVP_SignInit.pod index 8dbc644ae6..3dad4f105a 100644 --- a/doc/man3/EVP_SignInit.pod +++ b/doc/man3/EVP_SignInit.pod @@ -99,7 +99,7 @@ L, L, L, L, L, L, L, L, -L, L +L, L =head1 COPYRIGHT diff --git a/doc/man3/EVP_VerifyInit.pod b/doc/man3/EVP_VerifyInit.pod index 654c6bc5b3..50afdcf8ce 100644 --- a/doc/man3/EVP_VerifyInit.pod +++ b/doc/man3/EVP_VerifyInit.pod @@ -81,7 +81,7 @@ L, L, L, L, L, L, L, L, -L, L +L, L =head1 COPYRIGHT diff --git a/doc/man3/OPENSSL_init_crypto.pod b/doc/man3/OPENSSL_init_crypto.pod index d1a3fd5d1d..8a8f4615e5 100644 --- a/doc/man3/OPENSSL_init_crypto.pod +++ b/doc/man3/OPENSSL_init_crypto.pod @@ -197,7 +197,7 @@ Attempts to call OPENSSL_init_crypto() will fail and an ERR_R_INIT_FAIL error will be added to the error stack. Note that because initialisation has failed OpenSSL error strings will not be available, only an error code. This code can be put through the openssl errstr command line application to produce a human -readable error (see L). +readable error (see L). The OPENSSL_atexit() function enables the registration of a function to be called during OPENSSL_cleanup(). Stop handlers are diff --git a/doc/man3/SRP_VBASE_new.pod b/doc/man3/SRP_VBASE_new.pod index 0a7b117c0d..aed0fe4771 100644 --- a/doc/man3/SRP_VBASE_new.pod +++ b/doc/man3/SRP_VBASE_new.pod @@ -43,7 +43,7 @@ The verifier file is a text file containing multiple entries, whose format is: flag base64(verifier) base64(salt) username gNid userinfo(optional) where the flag can be 'V' (valid) or 'R' (revoked). Note that the base64 encoding used here is non-standard so it is recommended -to use L to generate this file. +to use L to generate this file. The SRP_VBASE_add0_user() function adds the B verifier information to the B structure. See L to create and populate this @@ -76,7 +76,7 @@ SRP_VBASE_add0_user() returns 1 on success and 0 on failure. =head1 SEE ALSO -L, +L, L, L, L diff --git a/doc/man3/SRP_create_verifier.pod b/doc/man3/SRP_create_verifier.pod index facb530ce3..fb77bba794 100644 --- a/doc/man3/SRP_create_verifier.pod +++ b/doc/man3/SRP_create_verifier.pod @@ -90,7 +90,7 @@ omitted for clarity): =head1 SEE ALSO -L, +L, L, L diff --git a/doc/man3/SRP_user_pwd_new.pod b/doc/man3/SRP_user_pwd_new.pod index 9d9e11d98e..823e32a2cd 100644 --- a/doc/man3/SRP_user_pwd_new.pod +++ b/doc/man3/SRP_user_pwd_new.pod @@ -49,7 +49,7 @@ SRP_user_pwd_set0_sv() returns 1 if both B and B are not NULL, 0 otherwise =head1 SEE ALSO -L, +L, L, L, L diff --git a/doc/man3/SSL_CIPHER_get_name.pod b/doc/man3/SSL_CIPHER_get_name.pod index 26ee6a0fa1..c70e0d2799 100644 --- a/doc/man3/SSL_CIPHER_get_name.pod +++ b/doc/man3/SSL_CIPHER_get_name.pod @@ -183,7 +183,7 @@ protocol-specific ID. =head1 SEE ALSO L, L, -L, L +L, L =head1 HISTORY diff --git a/doc/man3/SSL_CONF_cmd.pod b/doc/man3/SSL_CONF_cmd.pod index 7fba76cf5c..ea1f1e8503 100644 --- a/doc/man3/SSL_CONF_cmd.pod +++ b/doc/man3/SSL_CONF_cmd.pod @@ -113,7 +113,7 @@ associated with B. Sets the available ciphersuites for TLSv1.3 to value. This is a simple colon (":") separated list of TLSv1.3 ciphersuite names in order of preference. This list will be combined any configured TLSv1.2 and below ciphersuites. -See L for more information. +See L for more information. =item B<-cert> @@ -264,7 +264,7 @@ structure is associated with B. Sets the available ciphersuites for TLSv1.3 to B. This is a simple colon (":") separated list of TLSv1.3 ciphersuite names in order of preference. This list will be combined any configured TLSv1.2 and below ciphersuites. -See L for more information. +See L for more information. =item B diff --git a/doc/man3/SSL_CTX_set_cipher_list.pod b/doc/man3/SSL_CTX_set_cipher_list.pod index c602ac0df7..2fdebdf51d 100644 --- a/doc/man3/SSL_CTX_set_cipher_list.pod +++ b/doc/man3/SSL_CTX_set_cipher_list.pod @@ -27,7 +27,7 @@ OSSL_default_ciphersuites SSL_CTX_set_cipher_list() sets the list of available ciphers (TLSv1.2 and below) for B using the control string B. The format of the string is described -in L. The list of ciphers is inherited by all +in L. The list of ciphers is inherited by all B objects created from B. This function does not impact TLSv1.3 ciphersuites. Use SSL_CTX_set_ciphersuites() to configure those. @@ -111,7 +111,7 @@ ciphersuite list was configured, and 0 otherwise. L, L, L, L, -L +L =head1 HISTORY diff --git a/doc/man3/SSL_CTX_set_options.pod b/doc/man3/SSL_CTX_set_options.pod index 00f320b474..dd89125db4 100644 --- a/doc/man3/SSL_CTX_set_options.pod +++ b/doc/man3/SSL_CTX_set_options.pod @@ -364,7 +364,7 @@ secure renegotiation and 0 if it does not. L, L, L, L, L, -L +L =head1 HISTORY diff --git a/doc/man3/SSL_CTX_set_srp_password.pod b/doc/man3/SSL_CTX_set_srp_password.pod index 8f266baa7d..f6a5746a90 100644 --- a/doc/man3/SSL_CTX_set_srp_password.pod +++ b/doc/man3/SSL_CTX_set_srp_password.pod @@ -76,7 +76,7 @@ and the extra argument B set by SSL_CTX_set_srp_cb_arg(). This callback should setup the server for the key exchange by calling SSL_set_srp_server_param() with the appropriate parameters for the received username. The username can be obtained by calling SSL_get_srp_username(). -See L to parse the verifier file created by L or +See L to parse the verifier file created by L or L to generate it. The callback should return B to proceed with the server key exchange, B for a fatal error or any value < 0 for a retryable error. @@ -197,7 +197,7 @@ Setup SRP server with verifier file: =head1 SEE ALSO L, -L, +L, L, L diff --git a/doc/man3/SSL_CTX_set_tmp_dh_callback.pod b/doc/man3/SSL_CTX_set_tmp_dh_callback.pod index bc1dafa53b..0e9108d063 100644 --- a/doc/man3/SSL_CTX_set_tmp_dh_callback.pod +++ b/doc/man3/SSL_CTX_set_tmp_dh_callback.pod @@ -59,14 +59,14 @@ DH parameters can be reused, as the actual key is newly generated during the negotiation. The risk in reusing DH parameters is that an attacker may specialize on a very often used DH group. Applications should therefore generate their own DH parameters during the installation process using the -openssl L application. This application +openssl L application. This application guarantees that "strong" primes are used. Files dh2048.pem, and dh4096.pem in the 'apps' directory of the current version of the OpenSSL distribution contain the 'SKIP' DH parameters, which use safe primes and were generated verifiably pseudo-randomly. These files can be converted into C code using the B<-C> option of the -L application. Generation of custom DH +L application. Generation of custom DH parameters during installation should still be preferred to stop an attacker from specializing on a commonly used group. File dh1024.pem contains old parameters that must not be used by applications. @@ -121,7 +121,7 @@ Code for setting up parameters during server initialization: L, L, L, -L, L +L, L =head1 COPYRIGHT diff --git a/doc/man3/SSL_CTX_set_tmp_ecdh.pod b/doc/man3/SSL_CTX_set_tmp_ecdh.pod index d0367e0000..8e75ec708f 100644 --- a/doc/man3/SSL_CTX_set_tmp_ecdh.pod +++ b/doc/man3/SSL_CTX_set_tmp_ecdh.pod @@ -36,7 +36,7 @@ on failure. L, L, L, L, L, -L, L +L, L =head1 COPYRIGHT diff --git a/doc/man3/SSL_get_verify_result.pod b/doc/man3/SSL_get_verify_result.pod index 45f2f121e1..ac37408748 100644 --- a/doc/man3/SSL_get_verify_result.pod +++ b/doc/man3/SSL_get_verify_result.pod @@ -44,7 +44,7 @@ The verification succeeded or no peer certificate was presented. =item Any other value -Documented in L. +Documented in L. =back @@ -52,7 +52,7 @@ Documented in L. L, L, L, -L +L =head1 COPYRIGHT diff --git a/doc/man3/SSL_set_verify_result.pod b/doc/man3/SSL_set_verify_result.pod index 9b1e11c55f..e095653849 100644 --- a/doc/man3/SSL_set_verify_result.pod +++ b/doc/man3/SSL_set_verify_result.pod @@ -23,7 +23,7 @@ the verification result of the B object. It does not become part of the established session, so if the session is to be reused later, the original value will reappear. -The valid codes for B are documented in L. +The valid codes for B are documented in L. =head1 RETURN VALUES @@ -33,7 +33,7 @@ SSL_set_verify_result() does not provide a return value. L, L, L, -L +L =head1 COPYRIGHT diff --git a/doc/man3/X509_LOOKUP_hash_dir.pod b/doc/man3/X509_LOOKUP_hash_dir.pod index 30fbda8e03..b2f0a6a361 100644 --- a/doc/man3/X509_LOOKUP_hash_dir.pod +++ b/doc/man3/X509_LOOKUP_hash_dir.pod @@ -85,8 +85,8 @@ with a filename of the form I.I for a certificate, or I.BI for a CRL. The I is the value returned by the L function applied to the subject name for certificates or issuer name for CRLs. -The hash can also be obtained via the B<-hash> option of the L or -L commands. +The hash can also be obtained via the B<-hash> option of the +L or L commands. The .I or .BI suffix is a sequence number that starts at zero, and is incremented consecutively for each certificate or CRL with the same I @@ -109,8 +109,8 @@ Note that the hash algorithm used for subject name hashing changed in OpenSSL 1.0.0, and all certificate stores have to be rehashed when moving from OpenSSL 0.9.8 to 1.0.0. -OpenSSL includes a L utility which creates symlinks with correct -hashed names for all files with .pem suffix in a given directory. +OpenSSL includes a L utility which creates symlinks with +hashed names for all files with F<.pem> suffix in a given directory. =head2 OSSL_STORE Method diff --git a/doc/man3/X509_VERIFY_PARAM_set_flags.pod b/doc/man3/X509_VERIFY_PARAM_set_flags.pod index eca2b6d84c..2d161ebbab 100644 --- a/doc/man3/X509_VERIFY_PARAM_set_flags.pod +++ b/doc/man3/X509_VERIFY_PARAM_set_flags.pod @@ -277,7 +277,7 @@ before searching the provided untrusted certificates. Local issuer certificates are often more likely to satisfy local security requirements and lead to a locally trusted root. This is especially important when some certificates in the trust store have -explicit trust settings (see "TRUST SETTINGS" in L). +explicit trust settings (see "TRUST SETTINGS" in L). As of OpenSSL 1.1.0 this option is on by default. The B flag suppresses checking for alternative @@ -364,7 +364,7 @@ L, L, L, L, -L +L =head1 HISTORY diff --git a/doc/man3/X509_check_issued.pod b/doc/man3/X509_check_issued.pod index b89dd932ca..d41dfcd53e 100644 --- a/doc/man3/X509_check_issued.pod +++ b/doc/man3/X509_check_issued.pod @@ -31,7 +31,7 @@ I or some B constant to indicate an error. L, L, -L +L =head1 COPYRIGHT diff --git a/doc/man3/X509_verify_cert.pod b/doc/man3/X509_verify_cert.pod index ec57ba5e36..7b692c493d 100644 --- a/doc/man3/X509_verify_cert.pod +++ b/doc/man3/X509_verify_cert.pod @@ -14,7 +14,7 @@ X509_verify_cert - discover and verify X509 certificate chain The X509_verify_cert() function attempts to discover and validate a certificate chain based on parameters in B. A complete description of -the process is contained in the L manual page. +the process is contained in the L manual page. =head1 RETURN VALUES diff --git a/doc/man5/config.pod b/doc/man5/config.pod index 817a8d1d0c..e727a2e22d 100644 --- a/doc/man5/config.pod +++ b/doc/man5/config.pod @@ -520,7 +520,7 @@ configuration files using that syntax will have to be modified. =head1 SEE ALSO -L, L, L, L +L, L, L, L =head1 COPYRIGHT diff --git a/doc/man5/x509v3_config.pod b/doc/man5/x509v3_config.pod index 3d92c9f098..737c461f0c 100644 --- a/doc/man5/x509v3_config.pod +++ b/doc/man5/x509v3_config.pod @@ -529,7 +529,7 @@ will only recognize the last value. This can be worked around by using the form: =head1 SEE ALSO -L, L, L, +L, L, L, L =head1 COPYRIGHT diff --git a/doc/man7/Ed25519.pod b/doc/man7/Ed25519.pod index 74bf7c31ee..242d561173 100644 --- a/doc/man7/Ed25519.pod +++ b/doc/man7/Ed25519.pod @@ -49,7 +49,8 @@ Ed25519 or Ed448 public keys can be set directly using L or loaded from a SubjectPublicKeyInfo structure in a PEM file using L (or similar function). -Ed25519 and Ed448 can be tested within L application since version 1.1.1. +Ed25519 and Ed448 can be tested with the L application +since version 1.1.1. Valid algorithm names are B, B and B. If B is specified, then both Ed25519 and Ed448 are benchmarked. diff --git a/doc/man7/SM2.pod b/doc/man7/SM2.pod index b2d7c7ae44..c7876a0cc6 100644 --- a/doc/man7/SM2.pod +++ b/doc/man7/SM2.pod @@ -41,8 +41,8 @@ done by calling: And normally there is no need to pass a B parameter to EVP_DigestSignInit() or EVP_DigestVerifyInit() in such a scenario. -SM2 can be tested within L application since version 3.0.0. At current -stage, the only valid algorithm name is B. +SM2 can be tested with the L application since version 3.0.0. +Currently, the only valid algorithm name is B. =head1 EXAMPLES diff --git a/util/find-doc-nits b/util/find-doc-nits index f07929f946..687657bf9d 100755 --- a/util/find-doc-nits +++ b/util/find-doc-nits @@ -458,6 +458,15 @@ sub check { next if $target =~ m@\([1357]\)/.*>$@; # it has a section/anchor err($id, "Section missing in $target") } + # Check for proper links to commands. + while ( $contents =~ /L<([^>]*)\(1\)(?:\/.*)?>/g ) { + my $target = $1; + next if $target =~ /openssl-?/; + next if -f "doc/man1/$target.pod"; + # TODO: Filter out "foreign manual" links. + next if $target =~ /ps|apropos|sha1sum|procmail|perl/; + err($id, "Bad command link L<$target(1)>"); + } # Check for proper in-man-3 API links. while ( $contents =~ /L<([^>]*)\(3\)(?:\/.*)?>/g ) { my $target = $1;