mirror/openssl
2
0
Fork 0
mirror of https://github.com/openssl/openssl.git synced 2025-03-31 20:10:45 +08:00
Code Issues Packages Projects Releases Wiki Activity

Clarify SSL_accept_stream/SSL_new_stream behaviour with a default stream

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

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-21 13:57:39 +01:00
parent 8d74a13160
commit a855ee8576
4 changed files with 10 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

3
doc/man3/SSL_accept_stream.pod
View File

@ -34,6 +34,9 @@ blocking mode (see L<SSL_set_blocking_mode(3)>), but this may be bypassed by
passing the flag B<SSL_ACCEPT_STREAM_NO_BLOCK> in I<flags>. If this flag is set,
this function never blocks.
Calling SSL_accept_stream() if there is no default stream already present
inhibits the future creation of a default stream. See L<openssl-quic(7)>.
SSL_get_accept_stream_queue_len() returns the number of incoming streams
currently waiting in the accept queue.

3
doc/man3/SSL_new_stream.pod
View File

@ -35,6 +35,9 @@ This function can only be used to create stream objects for locally-initiated
streams. To accept incoming streams initiated by a peer, use
L<SSL_accept_stream(3)>.
Calling SSL_new_stream() if there is no default stream already present
inhibits the future creation of a default stream. See L<openssl-quic(7)>.
=head1 RETURN VALUES
SSL_new_stream() returns a new stream object, or NULL on error.

4
doc/man7/openssl-quic.pod
View File

@ -97,6 +97,10 @@ in order to use L<SSL_accept_stream(3)> in this case. However, applications
using additional streams are strongly recommended to use multi-stream mode
instead.
Calling L<SSL_new_stream(3)> or L<SSL_accept_stream(3)> before a default stream
has been associated with the QUIC connection SSL object will inhibit future
creation of a default stream.
=head2 Multi-Stream Mode
The recommended usage mode for new applications adopting QUIC is multi-stream

9
doc/man7/ossl-guide-quic-multi-stream.pod
View File

@ -99,15 +99,6 @@ B<SSL_INCOMING_STREAM_POLICY_ACCEPT>. See the man page for further details. This
is not relevant if the default stream has been disabed as described in
L</THE DEFAULT STREAM> above.
=begin comment
TODO(QUIC): What happens if SSL_accept_stream()/SSL_new_stream() is called and
there is no default stream yet? incoming stream policy suggests that all
incoming streams are rejected by default....but this only applies after a
default stream has been created?
=end comment
Any stream may be bi-directional or uni-directional. If it is uni-directional
then the initiator can write to it but not read from it, and vice-versa for the
peer. You can determine what type of stream an B<SSL> object represents by