aboutsummaryrefslogtreecommitdiffstats
path: root/doc/man7
diff options
context:
space:
mode:
authorMatt Caswell <matt@openssl.org>2023-08-11 16:24:47 +0100
committerMatt Caswell <matt@openssl.org>2023-08-25 11:42:51 +0100
commit306101e5d919476a4f68ae8e6f73993d8ebe269e (patch)
tree9ecb0687ee811b75bf0261022d4cf817040b3c4d /doc/man7
parentb7f3d5d67d17aa1a384811014e79b461ce0e23ca (diff)
downloadopenssl-306101e5d919476a4f68ae8e6f73993d8ebe269e.tar.gz
Update some links within the guide to not use crypto(7)
Reviewed-by: Tomas Mraz <tomas@openssl.org> Reviewed-by: Hugo Landau <hlandau@openssl.org> (Merged from https://github.com/openssl/openssl/pull/21765)
Diffstat (limited to 'doc/man7')
-rw-r--r--doc/man7/ossl-guide-quic-client-block.pod7
-rw-r--r--doc/man7/ossl-guide-quic-introduction.pod9
-rw-r--r--doc/man7/ossl-guide-tls-client-block.pod22
-rw-r--r--doc/man7/ossl-guide-tls-introduction.pod3
4 files changed, 23 insertions, 18 deletions
diff --git a/doc/man7/ossl-guide-quic-client-block.pod b/doc/man7/ossl-guide-quic-client-block.pod
index ec6bc95e57..551d6bbe4f 100644
--- a/doc/man7/ossl-guide-quic-client-block.pod
+++ b/doc/man7/ossl-guide-quic-client-block.pod
@@ -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
diff --git a/doc/man7/ossl-guide-quic-introduction.pod b/doc/man7/ossl-guide-quic-introduction.pod
index 33f9c3e003..bb79e5b438 100644
--- a/doc/man7/ossl-guide-quic-introduction.pod
+++ b/doc/man7/ossl-guide-quic-introduction.pod
@@ -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
diff --git a/doc/man7/ossl-guide-tls-client-block.pod b/doc/man7/ossl-guide-tls-client-block.pod
index 1116b26cae..8f04ec6428 100644
--- a/doc/man7/ossl-guide-tls-client-block.pod
+++ b/doc/man7/ossl-guide-tls-client-block.pod
@@ -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
diff --git a/doc/man7/ossl-guide-tls-introduction.pod b/doc/man7/ossl-guide-tls-introduction.pod
index 28e52b8604..e85fb8e3f9 100644
--- a/doc/man7/ossl-guide-tls-introduction.pod
+++ b/doc/man7/ossl-guide-tls-introduction.pod
@@ -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