aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authoraggieNick02 <nick@pcpartpicker.com>2023-09-19 18:14:54 -0500
committeraggieNick02 <nick@pcpartpicker.com>2023-09-19 18:20:19 -0500
commit702e3f34787c027daf03af22cd71459feb344432 (patch)
tree0942206a77ebf5e9056dd401cb74776c79fcca70
parente2c5f17e3559cc7c96706cd75c2609f12675c60b (diff)
downloadfio-702e3f34787c027daf03af22cd71459feb344432.tar.gz
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
-rw-r--r--HOWTO.rst3
-rw-r--r--fio.13
2 files changed, 6 insertions, 0 deletions
diff --git a/HOWTO.rst b/HOWTO.rst
index 7f26978a7..cc7124b13 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=<server1> <job file(s)> --client=<server2> <job file(s)>
diff --git a/fio.1 b/fio.1
index 8159caa47..628e278df 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