From 702e3f34787c027daf03af22cd71459feb344432 Mon Sep 17 00:00:00 2001 From: aggieNick02 Date: Tue, 19 Sep 2023 18:14:54 -0500 Subject: [PATCH] Update docs to clarify how to pass job options in client mode When run in client mode, fio does not pass any job options specified on the command line to the fio server. When run in client mode, all job options must be specified via local or remote job files. Update the docs to indicate this to avoid end-user confusion. Fixes #1629 Signed-off-by: Nick Neumann nick@pcpartpicker.com --- HOWTO.rst | 3 +++ fio.1 | 3 +++ 2 files changed, 6 insertions(+) diff --git a/HOWTO.rst b/HOWTO.rst index 7f26978a..cc7124b1 100644 --- a/HOWTO.rst +++ b/HOWTO.rst @@ -5105,6 +5105,9 @@ is the connect string, and `remote-args` and `job file(s)` are sent to the server. The `server` string follows the same format as it does on the server side, to allow IP/hostname/socket and port strings. +Note that all job options must be defined in job files when running fio as a +client. Any job options specified in `remote-args` will be ignored. + Fio can connect to multiple servers this way:: fio --client= --client= diff --git a/fio.1 b/fio.1 index 8159caa4..628e278d 100644 --- a/fio.1 +++ b/fio.1 @@ -4838,6 +4838,9 @@ is the connect string, and `remote\-args' and `job file(s)' are sent to the server. The `server' string follows the same format as it does on the server side, to allow IP/hostname/socket and port strings. .P +Note that all job options must be defined in job files when running fio as a +client. Any job options specified in `remote\-args' will be ignored. +.P Fio can connect to multiple servers this way: .RS .P -- 2.25.1