[openssl/openssl] b7f3d5: Update the desciption of shutdown in the QUIC clie...

[Matt Caswell]

  Branch: refs/heads/master
  Home:   https://github.com/openssl/openssl
  Commit: b7f3d5d67d17aa1a384811014e79b461ce0e23ca
      https://github.com/openssl/openssl/commit/b7f3d5d67d17aa1a384811014e79b461ce0e23ca
  Author: Matt Caswell <matt at openssl.org>
  Date:   2023-08-25 (Fri, 25 Aug 2023)

  Changed paths:
    M demos/guide/quic-client-block.c
    M doc/man7/ossl-guide-quic-client-block.pod

  Log Message:
  -----------
  Update the desciption of shutdown in the QUIC client blocking tutorial

Give a better description of the shutdown process in QUIC.

Reviewed-by: Tomas Mraz <tomas at openssl.org>
Reviewed-by: Hugo Landau <hlandau at openssl.org>
(Merged from https://github.com/openssl/openssl/pull/21765)


  Commit: 306101e5d919476a4f68ae8e6f73993d8ebe269e
      https://github.com/openssl/openssl/commit/306101e5d919476a4f68ae8e6f73993d8ebe269e
  Author: Matt Caswell <matt at openssl.org>
  Date:   2023-08-25 (Fri, 25 Aug 2023)

  Changed paths:
    M doc/man7/ossl-guide-quic-client-block.pod
    M doc/man7/ossl-guide-quic-introduction.pod
    M doc/man7/ossl-guide-tls-client-block.pod
    M doc/man7/ossl-guide-tls-introduction.pod

  Log Message:
  -----------
  Update some links within the guide to not use crypto(7)

Reviewed-by: Tomas Mraz <tomas at openssl.org>
Reviewed-by: Hugo Landau <hlandau at openssl.org>
(Merged from https://github.com/openssl/openssl/pull/21765)


  Commit: 344ae0f39afa0b4cc352eac64d6e7d25bb37e9bd
      https://github.com/openssl/openssl/commit/344ae0f39afa0b4cc352eac64d6e7d25bb37e9bd
  Author: Matt Caswell <matt at openssl.org>
  Date:   2023-08-25 (Fri, 25 Aug 2023)

  Changed paths:
    M doc/build.info
    A doc/man7/ossl-guide-quic-multi-stream.pod

  Log Message:
  -----------
  Add an initial guide page for writing a multi-stream QUIC client

Reviewed-by: Tomas Mraz <tomas at openssl.org>
Reviewed-by: Hugo Landau <hlandau at openssl.org>
(Merged from https://github.com/openssl/openssl/pull/21765)


  Commit: 584140fa4b0a037c85b58722a08ba6fd0ee086ce
      https://github.com/openssl/openssl/commit/584140fa4b0a037c85b58722a08ba6fd0ee086ce
  Author: Matt Caswell <matt at openssl.org>
  Date:   2023-08-25 (Fri, 25 Aug 2023)

  Changed paths:
    M demos/guide/Makefile
    M demos/guide/quic-client-block.c
    A demos/guide/quic-multi-stream.c
    M demos/guide/tls-client-block.c

  Log Message:
  -----------
  Add a QUIC multi-stream client demo

Demonstrate how to use the QUIC multi-stream APIs with a simple blocking
client.

Reviewed-by: Tomas Mraz <tomas at openssl.org>
Reviewed-by: Hugo Landau <hlandau at openssl.org>
(Merged from https://github.com/openssl/openssl/pull/21765)


  Commit: f6225f4f692ab45c0e891f83a7782a7dcd211204
      https://github.com/openssl/openssl/commit/f6225f4f692ab45c0e891f83a7782a7dcd211204
  Author: Matt Caswell <matt at openssl.org>
  Date:   2023-08-25 (Fri, 25 Aug 2023)

  Changed paths:
    M util/quicserver.c

  Log Message:
  -----------
  Update quicserver to be able to handle multiple streams

We extend quicserver so that it can handle multiple requests with an
HTTP request on each one. If a uni-directional stream comes in we create
a uni-directional stream for the response

Reviewed-by: Tomas Mraz <tomas at openssl.org>
Reviewed-by: Hugo Landau <hlandau at openssl.org>
(Merged from https://github.com/openssl/openssl/pull/21765)


  Commit: 4a5ba9ae1325f2a02ab670b530a39568cb4f691f
      https://github.com/openssl/openssl/commit/4a5ba9ae1325f2a02ab670b530a39568cb4f691f
  Author: Matt Caswell <matt at openssl.org>
  Date:   2023-08-25 (Fri, 25 Aug 2023)

  Changed paths:
    M doc/man7/ossl-guide-quic-client-block.pod
    M doc/man7/ossl-guide-quic-multi-stream.pod

  Log Message:
  -----------
  Provide introduction/tutorial page for QUIC multi-stream

Reviewed-by: Tomas Mraz <tomas at openssl.org>
Reviewed-by: Hugo Landau <hlandau at openssl.org>
(Merged from https://github.com/openssl/openssl/pull/21765)


  Commit: 8d74a1316025a4730f18674ccf187c3d630d7c92
      https://github.com/openssl/openssl/commit/8d74a1316025a4730f18674ccf187c3d630d7c92
  Author: Matt Caswell <matt at openssl.org>
  Date:   2023-08-25 (Fri, 25 Aug 2023)

  Changed paths:
    M demos/guide/quic-client-block.c
    M demos/guide/quic-multi-stream.c
    M doc/man7/ossl-guide-quic-client-block.pod

  Log Message:
  -----------
  Add some additional comments to the demos

Add some additional explanation for some code lines in the demos that did
not have a comment.

Reviewed-by: Tomas Mraz <tomas at openssl.org>
Reviewed-by: Hugo Landau <hlandau at openssl.org>
(Merged from https://github.com/openssl/openssl/pull/21765)


  Commit: a855ee857645614483976fb1be1b3907a2fe94d8
      https://github.com/openssl/openssl/commit/a855ee857645614483976fb1be1b3907a2fe94d8
  Author: Matt Caswell <matt at openssl.org>
  Date:   2023-08-25 (Fri, 25 Aug 2023)

  Changed paths:
    M doc/man3/SSL_accept_stream.pod
    M doc/man3/SSL_new_stream.pod
    M doc/man7/openssl-quic.pod
    M doc/man7/ossl-guide-quic-multi-stream.pod

  Log Message:
  -----------
  Clarify SSL_accept_stream/SSL_new_stream behaviour with a default stream

Explain what happens if you call those functions and there is no default
stream present yet.

Reviewed-by: Tomas Mraz <tomas at openssl.org>
Reviewed-by: Hugo Landau <hlandau at openssl.org>
(Merged from https://github.com/openssl/openssl/pull/21765)


  Commit: 02e36ed3525a2f0fda1b21e948ec5f522cf9379c
      https://github.com/openssl/openssl/commit/02e36ed3525a2f0fda1b21e948ec5f522cf9379c
  Author: Matt Caswell <matt at openssl.org>
  Date:   2023-08-25 (Fri, 25 Aug 2023)

  Changed paths:
    M demos/guide/quic-client-block.c
    M demos/guide/quic-multi-stream.c
    M doc/man7/ossl-guide-quic-client-block.pod
    M doc/man7/ossl-guide-quic-multi-stream.pod

  Log Message:
  -----------
  Update demos/tutorial to distinguish between stream and connection errors

We can use SSL_get_stream_read_state() to distinguish these cases.

Reviewed-by: Tomas Mraz <tomas at openssl.org>
Reviewed-by: Hugo Landau <hlandau at openssl.org>
(Merged from https://github.com/openssl/openssl/pull/21765)


  Commit: 675481ee7a8a7fe55aa387b1ccc4ba3b579bc2ff
      https://github.com/openssl/openssl/commit/675481ee7a8a7fe55aa387b1ccc4ba3b579bc2ff
  Author: Matt Caswell <matt at openssl.org>
  Date:   2023-08-25 (Fri, 25 Aug 2023)

  Changed paths:
    M doc/man7/ossl-guide-introduction.pod

  Log Message:
  -----------
  Add a link to the multi-stream QUIC client tutorial from the introduction

We've added a new page to the guide so we should add a link to it.

Reviewed-by: Tomas Mraz <tomas at openssl.org>
Reviewed-by: Hugo Landau <hlandau at openssl.org>
(Merged from https://github.com/openssl/openssl/pull/21765)


Compare: https://github.com/openssl/openssl/compare/8c5284ff194f...675481ee7a8a