From 306101e5d919476a4f68ae8e6f73993d8ebe269e Mon Sep 17 00:00:00 2001 From: Matt Caswell Date: Fri, 11 Aug 2023 16:24:47 +0100 Subject: [PATCH] Update some links within the guide to not use crypto(7) Reviewed-by: Tomas Mraz Reviewed-by: Hugo Landau (Merged from https://github.com/openssl/openssl/pull/21765) --- doc/man7/ossl-guide-quic-client-block.pod | 7 ++++--- doc/man7/ossl-guide-quic-introduction.pod | 9 +++++---- doc/man7/ossl-guide-tls-client-block.pod | 22 ++++++++++++---------- doc/man7/ossl-guide-tls-introduction.pod | 3 ++- 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 ec6bc95e578..551d6bbe4fc 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, L and -L); and that you know how to +(see L, L +and L); 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 will return 1 to indicate success. =head1 SEE ALSO -L, L, +L, L, +L, L, L, L =head1 COPYRIGHT diff --git a/doc/man7/ossl-guide-quic-introduction.pod b/doc/man7/ossl-guide-quic-introduction.pod index 33f9c3e0034..bb79e5b4384 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 and -L). +some OpenSSL and TLS fundamentals (see L +and L). =head1 WHAT IS QUIC? @@ -120,8 +120,9 @@ concepts in order to write a simple blocking QUIC client. =head1 SEE ALSO -L, L, L, -L, L +L, L, +L, L, +L, L, L =head1 COPYRIGHT diff --git a/doc/man7/ossl-guide-tls-client-block.pod b/doc/man7/ossl-guide-tls-client-block.pod index 1116b26cae1..8f04ec6428a 100644 --- a/doc/man7/ossl-guide-tls-client-block.pod +++ b/doc/man7/ossl-guide-tls-client-block.pod @@ -36,21 +36,22 @@ L 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 and L); 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 and L); +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 object for our client. We use the L function for this purpose. We could alternatively use L if we want to associate the B with a particular -B (see L to learn about B). We pass as an -argument the return value of the function L. 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 (see L to learn about +B). We pass as an argument the return value of the function +L. 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, L +L, L, +L, L =head1 COPYRIGHT diff --git a/doc/man7/ossl-guide-tls-introduction.pod b/doc/man7/ossl-guide-tls-introduction.pod index 28e52b86047..e85fb8e3f90 100644 --- a/doc/man7/ossl-guide-tls-introduction.pod +++ b/doc/man7/ossl-guide-tls-introduction.pod @@ -301,7 +301,8 @@ See L for an introduction to QUIC in OpenSSL. =head1 SEE ALSO -L, L, +L, L, +L, L, L =head1 COPYRIGHT -- 2.47.3