diff options
| author | Martin Pitt <martin.pitt@ubuntu.com> | 2009-12-22 13:08:23 +0100 |
|---|---|---|
| committer | Martin Pitt <martin.pitt@ubuntu.com> | 2009-12-22 13:08:23 +0100 |
| commit | 7729cd2fadbe0a5dd1eea3b81050616431d93af6 (patch) | |
| tree | a21644278705672f460b515e9cd9be019c66b1da | |
| parent | b24e3bb62f6af0e9d8968ce6ca98641aacde1e88 (diff) | |
Clarify RUN/IMPORT documentation
Explain command/argument separation rules, search path, and quoting for RUN and
IMPORT.
http://bugs.debian.org/550206
| -rw-r--r-- | udev/udev.xml | 10 |
1 files changed, 9 insertions, 1 deletions
diff --git a/udev/udev.xml b/udev/udev.xml index ff01fefe58..b6c5933419 100644 --- a/udev/udev.xml +++ b/udev/udev.xml @@ -347,12 +347,18 @@ <option>RUN{<replaceable>fail_event_on_error</replaceable>}</option> is specified, and the executed program returns non-zero, the event will be marked as failed for a possible later handling.</para> + <para>If no path is given, the program must be in + <filename>/lib/udev</filename>, otherwise the full path must be + specified.</para> <para>If the specified string starts with <option>socket:<replaceable>path</replaceable></option>, all current event values will be passed to the specified socket, as a message in the same format the kernel sends an uevent. If the first character of the specified path is an @ character, an abstract namespace socket is used, instead of an existing socket file.</para> + <para>Program name and arguments are separated with spaces. To + include spaces in an argument, use single quotes. Please note + that this does not run through a shell.</para> </listitem> </varlistentry> @@ -380,7 +386,9 @@ <term><option>program</option></term> <listitem> <para>Execute an external program specified as the assigned value and - import its output, which must be in environment key format.</para> + import its output, which must be in environment key + format. Path specification, command/argument separation, + and quoting work like in <option>RUN</option>.</para> </listitem> </varlistentry> <varlistentry> |