aboutsummaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorLaurent Bercot <ska-skaware@skarnet.org>2025-05-02 17:04:50 +0000
committerLaurent Bercot <ska@appnovation.com>2025-05-02 17:04:50 +0000
commitbff439345cafa59a4bd72c2a20591e7bd8441b47 (patch)
tree6dec677348dfb61fff299fb164300387bd57ec0b /doc
parent777100e73376d0977ee4300b5580670edb6df08f (diff)
downloadmdevd-bff439345cafa59a4bd72c2a20591e7bd8441b47.tar.gz
Increase default kbufsz to 1 MiB; don't die on ENOBUFS (but spam)
Signed-off-by: Laurent Bercot <ska@appnovation.com>
Diffstat (limited to 'doc')
-rw-r--r--doc/mdevd-coldplug.html6
-rw-r--r--doc/mdevd.html6
2 files changed, 6 insertions, 6 deletions
diff --git a/doc/mdevd-coldplug.html b/doc/mdevd-coldplug.html
index 36654eb..b26d4c9 100644
--- a/doc/mdevd-coldplug.html
+++ b/doc/mdevd-coldplug.html
@@ -28,7 +28,7 @@ for all these devices.
<h2> Interface </h2>
<pre>
- mdevd-coldplug [ -v <em>verbosity</em> ] [ -s <em>slashsys</em> ] [ -O <em>nlgroup</em> ] [ -b <em>kbufsize</em> ]
+ mdevd-coldplug [ -v <em>verbosity</em> ] [ -s <em>slashsys</em> ] [ -O <em>nlgroup</em> ] [ -b <em>kbufsz</em> ]
</pre>
<ul>
@@ -57,8 +57,8 @@ if <a href="mdevd.html">mdevd</a> is running with a similar <tt>-O</tt>
option with a compatible value; else, <tt>mdevd-coldplug</tt> will wait
forever. </li>
<li> <tt>-b</tt>&nbsp;<em>kbufsz</em>&nbsp;: try and reserve a kernel buffer of
-<em>kbufsz</em> bytes for the netlink queue. The default is 500 kB;
-if you're getting "No buffer space available" errors, try increasing this number.
+<em>kbufsz</em> bytes for the netlink queue. The default is 1 MiB;
+if you're getting related warnings on stderr, try increasing this number.
This option is only meaningful when paired with the <tt>-O</tt> option. </li>
</ul>
diff --git a/doc/mdevd.html b/doc/mdevd.html
index ca39b02..7c2a869 100644
--- a/doc/mdevd.html
+++ b/doc/mdevd.html
@@ -119,9 +119,9 @@ cause a loop by chaining two separate instances of mdevd. mdevd will protect
you against accidents, not against intentional stupidity.) </li>
<li> <tt>-b</tt>&nbsp;<em>kbufsz</em>&nbsp;: try and reserve a kernel buffer of
<em>kbufsz</em> bytes for the netlink queue. Too large a buffer wastes kernel memory;
-too small a buffer risks losing events. The default is <strong>512288</strong>,
-meaning 500 kB, which should be
-enough for most systems; if you're getting "No buffer space available" errors
+too small a buffer risks losing events. The default is <strong>1048576</strong>,
+meaning 1 MiB, which should be
+enough for most systems; if you're getting "missed events" warnings
from mdevd at coldplug time, try increasing this number. </li>
<li> <tt>-n</tt>&nbsp;: dry run. mdevd will not create or delete
device nodes, and it will not spawn commands. Instead, it will print to stdout