Add note for increasing shmmax if necessary
authorRicardo Nabinger Sanchez <rnsanchez@taghos.com.br>
Mon, 9 Oct 2017 23:57:27 +0000 (20:57 -0300)
committerRicardo Nabinger Sanchez <rnsanchez@taghos.com.br>
Tue, 10 Oct 2017 00:08:53 +0000 (21:08 -0300)
When launching a large job, fio can attempt to grab more shared memory
than allowed by the kernel.  Hint the user about increasing such limit
on Linux systems.

Signed-off-by: Ricardo Nabinger Sanchez <rnsanchez@taghos.com.br>
fio.1

diff --git a/fio.1 b/fio.1
index 68ed3ba457b93bd18abfcce5193b39d003f8edf7..6e7d1f8b1e4647e3e87912304a67c5e51101222b 100644 (file)
--- a/fio.1
+++ b/fio.1
@@ -113,6 +113,8 @@ All fio parser warnings are fatal, causing fio to exit with an error.
 .TP
 .BI \-\-max\-jobs \fR=\fPnr
 Set the maximum number of threads/processes to support to \fInr\fR.
+NOTE: On Linux, it may be necessary to increase the shared-memory limit
+(`/proc/sys/kernel/shmmax') if fio runs into errors while creating jobs.
 .TP
 .BI \-\-server \fR=\fPargs
 Start a backend server, with \fIargs\fR specifying what to listen to.