aboutsummaryrefslogtreecommitdiff
path: root/docs/tools
diff options
context:
space:
mode:
authorEric Blake <eblake@redhat.com>2025-02-03 16:26:06 -0600
committerEric Blake <eblake@redhat.com>2025-02-11 13:45:46 -0600
commit617017f8dce8d8f0cd4d175cbfaac0b4077b4a1e (patch)
tree3e18b095108fe5c453286ac0aff374e786576e98 /docs/tools
parentffaf7f0376f8040ce9068d71ae9ae8722505c42e (diff)
downloadqemu-617017f8dce8d8f0cd4d175cbfaac0b4077b4a1e.zip
qemu-617017f8dce8d8f0cd4d175cbfaac0b4077b4a1e.tar.gz
qemu-617017f8dce8d8f0cd4d175cbfaac0b4077b4a1e.tar.bz2
qemu-nbd: Allow users to adjust handshake limit
Although defaulting the handshake limit to 10 seconds was a nice QoI change to weed out intentionally slow clients, it can interfere with integration testing done with manual NBD_OPT commands over 'nbdsh --opt-mode'. Expose a command line option to allow the user to alter the timeout away from the default. This option is unlikely to be used in enough scenarios to warrant a short option letter. The option --handshake-limit intentionally differs from the name of the constant added in commit fb1c2aaa98 (limit instead of max_secs) and the QMP name to be added in the next commit; this is because typing a longer command-line name is undesirable and there is sufficient --help text to document the units. Signed-off-by: Eric Blake <eblake@redhat.com> Message-ID: <20250203222722.650694-5-eblake@redhat.com> Reviewed-by: Vladimir Sementsov-Ogievskiy <vsementsov@yandex-team.ru>
Diffstat (limited to 'docs/tools')
-rw-r--r--docs/tools/qemu-nbd.rst5
1 files changed, 5 insertions, 0 deletions
diff --git a/docs/tools/qemu-nbd.rst b/docs/tools/qemu-nbd.rst
index 4f21b79..f82ea5f 100644
--- a/docs/tools/qemu-nbd.rst
+++ b/docs/tools/qemu-nbd.rst
@@ -156,6 +156,11 @@ driver options if :option:`--image-opts` is specified.
Set the NBD volume export description, as a human-readable
string.
+.. option:: --handshake-limit=N
+
+ Set the timeout for a client to successfully complete its handshake
+ to N seconds (default 10), or 0 for no limit.
+
.. option:: -L, --list
Connect as a client and list all details about the exports exposed by