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)
This commit is contained in:
Matt Caswell 2023-08-11 16:24:47 +01:00
parent b7f3d5d67d
commit 306101e5d9
4 changed files with 23 additions and 18 deletions

View 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

View 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

View 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

View 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