Update some links within the guide to not use crypto(7)
authorMatt Caswell <matt@openssl.org>
Fri, 11 Aug 2023 15:24:47 +0000 (16:24 +0100)
committerMatt Caswell <matt@openssl.org>
Fri, 25 Aug 2023 10:42:51 +0000 (11:42 +0100)
Reviewed-by: Tomas Mraz <tomas@openssl.org>
Reviewed-by: Hugo Landau <hlandau@openssl.org>
(Merged from https://github.com/openssl/openssl/pull/21765)

doc/man7/ossl-guide-quic-client-block.pod
doc/man7/ossl-guide-quic-introduction.pod
doc/man7/ossl-guide-tls-client-block.pod
doc/man7/ossl-guide-tls-introduction.pod

index ec6bc95e57860962f0b6c0f0611c992b4cfbf443..551d6bbe4fcd5a79db8534db53714e882dcc3183 100644 (file)
@@ -22,8 +22,8 @@ This is for demonstration purposes only.
 
 We assume that you already have OpenSSL installed on your system; that you
 already have some fundamental understanding of OpenSSL concepts, TLS and QUIC
-(see L<crypto(7)>, L<ossl-guide-tls-introduction(7)> and
-L<ossl-guide-quic-introduction(7)>); and that you know how to
+(see L<ossl-guide-libraries-introduction(7)>, L<ossl-guide-tls-introduction(7)>
+and L<ossl-guide-quic-introduction(7)>); and that you know how to
 write and build C code and link it against the libcrypto and libssl libraries
 that are provided by OpenSSL. It also assumes that you have a basic
 understanding of UDP/IP and sockets. The example code that we build in this
@@ -290,7 +290,8 @@ successfully L<SSL_shutdown(3)> will return 1 to indicate success.
 
 =head1 SEE ALSO
 
-L<crypto(7)>, L<ossl-guide-tls-introduction(7)>,
+L<ossl-guide-introduction(7)>, L<ossl-guide-libraries-introduction(7)>,
+L<ossl-guide-libssl-introduction(7)>, L<ossl-guide-tls-introduction(7)>,
 L<ossl-guide-tls-client-block(7)>, L<ossl-guide-quic-introduction(7)>
 
 =head1 COPYRIGHT
index 33f9c3e0034751ec9b4dba5fcc98083a8a7b2a5b..bb79e5b4384e4f9607d812402659a78317590097 100644 (file)
@@ -10,8 +10,8 @@ ossl-guide-quic-introduction
 This page will provide an introduction to some basic QUIC concepts and
 background and how it is used within OpenSSL. It assumes that you have a basic
 understanding of UDP/IP and sockets. It also assumes that you are familiar with
-some OpenSSL and TLS fundamentals (see L<crypto(7)> and
-L<ossl-guide-tls-introduction(7)>).
+some OpenSSL and TLS fundamentals (see L<ossl-guide-libraries-introduction(7)>
+and L<ossl-guide-tls-introduction(7)>).
 
 =head1 WHAT IS QUIC?
 
@@ -120,8 +120,9 @@ concepts in order to write a simple blocking QUIC client.
 
 =head1 SEE ALSO
 
-L<crypto(7)>, L<bio(7)>, L<ossl-guide-tls-introduction(7)>,
-L<ossl-guide-tls-client-block(7)>, L<ossl-guide-quic-client-block(7)>
+L<ossl-guide-introduction(7)>, L<ossl-guide-libraries-introduction(7)>,
+L<ossl-guide-libssl-introduction(7)>, L<ossl-guide-tls-introduction(7)>,
+L<ossl-guide-tls-client-block(7)>, L<ossl-guide-quic-client-block(7)>, L<bio(7)>
 
 =head1 COPYRIGHT
 
index 1116b26cae1a11b5fd5ab3ff54ec21f86daff08e..8f04ec6428af7e97589c8f41ad2cba11ef8e759f 100644 (file)
@@ -36,21 +36,22 @@ L<https://github.com/openssl/openssl/blob/master/demos/guide/tls-client-block.c>
 
 We assume that you already have OpenSSL installed on your system; that you
 already have some fundamental understanding of OpenSSL concepts and TLS (see
-L<crypto(7)> and L<ossl-guide-tls-introduction(7)>); and that you know how to
-write and build C code and link it against the libcrypto and libssl libraries
-that are provided by OpenSSL. It also assumes that you have a basic
-understanding of TCP/IP and sockets.
+L<ossl-guide-libraries-introduction(7)> and L<ossl-guide-tls-introduction(7)>);
+and that you know how to write and build C code and link it against the
+libcrypto and libssl libraries that are provided by OpenSSL. It also assumes
+that you have a basic understanding of TCP/IP and sockets.
 
 =head2 Creating the SSL_CTX and SSL objects
 
 The first step is to create an B<SSL_CTX> object for our client. We use the
 L<SSL_CTX_new(3)> function for this purpose. We could alternatively use
 L<SSL_CTX_new_ex(3)> if we want to associate the B<SSL_CTX> with a particular
-B<OSSL_LIB_CTX> (see L<crypto(7)> to learn about B<OSSL_LIB_CTX>). We pass as an
-argument the return value of the function L<TLS_client_method(3)>. You should
-use this method whenever you are writing a TLS client. This method will
-automatically use TLS version negotiation to select the highest version of the
-protocol that is mutually supported by both the client and the server.
+B<OSSL_LIB_CTX> (see L<ossl-guide-libraries-introduction(7)> to learn about
+B<OSSL_LIB_CTX>). We pass as an argument the return value of the function
+L<TLS_client_method(3)>. You should use this method whenever you are writing a
+TLS client. This method will automatically use TLS version negotiation to select
+the highest version of the protocol that is mutually supported by both the
+client and the server.
 
     /*
      * Create an SSL_CTX which we can use to create SSL objects from. We
@@ -550,7 +551,8 @@ client developed on this page to support QUIC instead of TLS.
 
 =head1 SEE ALSO
 
-L<crypto(7)>, L<ossl-guide-tls-introduction(7)>
+L<ossl-guide-introduction(7)>, L<ossl-guide-libraries-introduction(7)>,
+L<ossl-guide-libssl-introduction(7)>, L<ossl-guide-tls-introduction(7)>
 
 =head1 COPYRIGHT
 
index 28e52b86047bf574a4709a7c8af9f02ddcf6f6fd..e85fb8e3f90aa6eed02281d87a8d16c06939f8fc 100644 (file)
@@ -301,7 +301,8 @@ See L<ossl-guide-quic-introduction(7)> for an introduction to QUIC in OpenSSL.
 
 =head1 SEE ALSO
 
-L<crypto(7)>, L<ossl-guide-tls-client-block(7)>,
+L<ossl-guide-introduction(7)>, L<ossl-guide-libraries-introduction(7)>,
+L<ossl-guide-libssl-introduction(7)>, L<ossl-guide-tls-client-block(7)>,
 L<ossl-guide-quic-introduction(7)>
 
 =head1 COPYRIGHT