QUIC I/O Architecture Design: Add block diagram, tweak wording

Reviewed-by: Tomas Mraz <tomas@openssl.org>
Reviewed-by: Paul Dale <pauli@openssl.org>
(Merged from https://github.com/openssl/openssl/pull/19770)

diff --git a/doc/designs/quic-design/images/quic-io-arch-1.png b/doc/designs/quic-design/images/quic-io-arch-1.png
new file mode 100644 (file)
index 0000000..3c6ccba
Binary files /dev/null and b/doc/designs/quic-design/images/quic-io-arch-1.png differ

diff --git a/doc/designs/quic-design/quic-io-arch.md b/doc/designs/quic-design/quic-io-arch.md
index 09115e65a227299b94624f053ec50bcb0b244766..403e3a11e0a71ce522a61ace1befb5df192b8e88 100644 (file)
--- a/doc/designs/quic-design/quic-io-arch.md
+++ b/doc/designs/quic-design/quic-io-arch.md
@@ -104,10 +104,10 @@ parallel threads. Under this model, there would be three threads:
 This has a large number of disadvantages:
 
 - There is a hard requirement for threading functionality in order to be
-  able to support blocking semantics at the application level. Use of blocking
-  semantics at the application level will have a hard requirement on use of the
-  thread assisted mode. In environments where threading support is not available
-  or desired, our APIs will only be usable in a non-blocking fashion.
+  able to support blocking semantics at the application level. Applications
+  which require blocking semantics would only be able to function in thread
+  assisted mode. In environments where threading support is not available or
+  desired, our APIs would only be usable in a non-blocking fashion.
 
 - Several threads are spawned which the application is not in control of.
   This undermines our general approach of providing the application with control
@@ -282,6 +282,8 @@ non-blocking I/O internally. Applications can use blocking or non-blocking I/O
 at the libssl API level. Network-level BIOs must operate in a non-blocking mode
 or be configurable by QUIC to this end.
 
+![Block Diagram](images/quic-io-arch-1.png "Block Diagram")
+
 ### Support of arbitrary BIOs
 
 We need to support not just socket FDs but arbitrary BIOs as the basis for the