summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorLaurent Bercot <ska-skaware@skarnet.org>2021-02-23 17:18:38 +0000
committerLaurent Bercot <ska-skaware@skarnet.org>2021-02-23 17:18:38 +0000
commit9358ede0e510fe25cf26fd6cc349395ac8bc8558 (patch)
treee3e7797efce9efc18747aa8eb34b52f701be0c1e /doc
parent05024f93d3cd75c86a89ed1ae6fea0c2b1f1c187 (diff)
downloadmdevd-9358ede0e510fe25cf26fd6cc349395ac8bc8558.tar.xz
Prepare for 1.0.4.0; new +,-,& directives for execlineb cmd interp
Diffstat (limited to 'doc')
-rw-r--r--doc/index.html8
-rw-r--r--doc/mdevd.html28
-rw-r--r--doc/upgrade.html12
3 files changed, 46 insertions, 2 deletions
diff --git a/doc/index.html b/doc/index.html
index 0f03ac9..d6ea237 100644
--- a/doc/index.html
+++ b/doc/index.html
@@ -98,9 +98,13 @@ and does not pull in any unnecessary code. </li>
The Linux kernel must be 2.6.10 or later. </li>
<li> GNU make, version 3.81 or later </li>
<li> <a href="//skarnet.org/software/skalibs/">skalibs</a> version
-2.10.0.0 or later. It's a build-time requirement. It's also a run-time
+2.10.0.2 or later. It's a build-time requirement. It's also a run-time
requirement if you link against the shared version of the skalibs
library. </li>
+ <li> Optionally: <a href="//skarnet.org/software/execline/">execline</a>
+version 2.8.0.0 or later. It's a only a run-time requirement, and only
+if your <tt>mdev.conf</tt> file contains <tt>+</tt>, <tt>-</tt> or
+<tt>&amp;</tt> command directives. </li>
</ul>
<h3> Licensing </h3>
@@ -114,7 +118,7 @@ library. </li>
<ul>
<li> The current released version of mdevd is
-<a href="mdevd-0.1.3.0.tar.gz">0.1.3.0</a>. </li>
+<a href="mdevd-0.1.4.0.tar.gz">0.1.4.0</a>. </li>
<li> Alternatively, you can checkout a copy of the
<a href="//git.skarnet.org/cgi-bin/cgit.cgi/mdevd/">mdevd
git repository</a>:
diff --git a/doc/mdevd.html b/doc/mdevd.html
index 3412253..58568cd 100644
--- a/doc/mdevd.html
+++ b/doc/mdevd.html
@@ -151,6 +151,34 @@ configuration where it can create device nodes as root or delete them, and does
nothing else.
</p>
+<h3> execline command support </h3>
+
+<p>
+ In addition to the traditional shell command spawning via the <tt>@</tt>,
+<tt>$</tt> and <tt>*</tt> directives, mdevd also supports spawning a command
+with the
+<a href="https://skarnet.org/software/execline/execlineb.html">execlineb</a>
+launcher:
+</p>
+
+<ul>
+ <li> <tt>+<em>cmd</em></tt>&nbsp;: spawns <tt>execlineb -Pc <em>cmd</em></tt>
+when this line catches an event that has <tt>ACTION=add</tt>. This is the
+equivalent of <tt>@<em>cmd</em></tt>. </li>
+ <li> <tt>-<em>cmd</em></tt>&nbsp;: spawns <tt>execlineb -Pc <em>cmd</em></tt>
+when this line catches an event that has <tt>ACTION=remove</tt>. This is the
+equivalent of <tt>$<em>cmd</em></tt>. </li>
+ <li> <tt>&amp;<em>cmd</em></tt>&nbsp;: spawns <tt>execlineb -Pc <em>cmd</em></tt>
+when this line catches an event no matter its action type. This is the
+equivalent of <tt>*<em>cmd</em></tt>. </li>
+</ul>
+
+<p>
+ Note that unlike <tt>/bin/sh</tt>, <tt>execlineb</tt> is spawned without an
+absolute path, so in order for <tt>+</tt>, <tt>-</tt> and <tt>&amp;</tt> to
+work, the <tt>execlineb</tt> command must be available in mdevd's PATH.
+</p>
+
<h2> Notes </h2>
<ul>
diff --git a/doc/upgrade.html b/doc/upgrade.html
index 7775575..90fdac3 100644
--- a/doc/upgrade.html
+++ b/doc/upgrade.html
@@ -18,6 +18,18 @@
<h1> What has changed in mdevd </h1>
+<h2> in 0.1.4.0 </h2>
+
+<ul>
+ <li> <a href="//skarnet.org/software/skalibs/">skalibs</a>
+dependency bumped to 2.10.0.2. </li>
+ <li> New <tt>+</tt>, <tt>-</tt> and <tt>&amp;</tt> command
+directives supported in <tt>mdev.conf</tt>. These directives
+spawn a command interpreted by the
+<a href="https://skarnet.org/software/execline/execlineb.html">execlineb</a>
+program launcher instead of <tt>/bin/sh</tt>. </li>
+</ul>
+
<h2> in 0.1.3.0 </h2>
<ul>