[openssl/openssl] d07b76: Add a new advanced command mode to s_client

[Matt Caswell]

  Branch: refs/heads/master
  Home:   https://github.com/openssl/openssl
  Commit: d07b763bb9073945ba5e9912e56bc51fe18bdcb5
      https://github.com/openssl/openssl/commit/d07b763bb9073945ba5e9912e56bc51fe18bdcb5
  Author: Matt Caswell <matt at openssl.org>
  Date:   2023-03-30 (Thu, 30 Mar 2023)

  Changed paths:
    M apps/s_client.c

  Log Message:
  -----------
  Add a new advanced command mode to s_client

The s_client command mode just looks at the first letter on a line
and if it is one that maps to a "command" then that command is executed
and everything else on the line is ignored.

This means it is impossible to send anything over s_client that starts with
one of the "magic" letters unless you switch off command processing
entirely.

With the forthcoming quic support that will be added to s_client we expect
a significant new number of commands being added (for example to send fin
on a stream, or to list or swap between different streams, etc). This will
use up more "letters" and reduces the usability of s_client.

This PR adds a new "advanced" command processing mode. Commands are enclosed
in braces {}, and can appear anywhere in the text typed into s_client. A
brace can be escaped by sending a double {{. This gives much more
flexibility without reducing the usability of s_client. Commands can also
have "arguments" which also extends the scope of what they can be used for.

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


  Commit: b21306b9300996b0e69947d6b4cfa64e4c62ec07
      https://github.com/openssl/openssl/commit/b21306b9300996b0e69947d6b4cfa64e4c62ec07
  Author: Matt Caswell <matt at openssl.org>
  Date:   2023-03-30 (Thu, 30 Mar 2023)

  Changed paths:
    M CHANGES.md
    M doc/man1/openssl-s_client.pod.in

  Log Message:
  -----------
  Add some documentation for the new advanced s_client command mode

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


Compare: https://github.com/openssl/openssl/compare/7c966ab6b332...b21306b93009