[PATCH 2/2] man: SYMLINK can be matched as well as assigned

[PATCH 2/2] man: SYMLINK can be matched as well as assigned

[Alan Jenkins]

If by-path / by-id links don't quite do what you want, this is a nice
clean way to extend the behaviour.  Real example:

SYMLINK="serial/by-id/usb-Novatel_Wireless_Inc*CDMA*-if00-port0", \\
 SYMLINK+="cellcard"

Some users ask how to do things like this.

 - create an additional link with a shorter name
 - create a link which matches more loosely
    (omit certain path segments e.g. serial numbers)
 - change permissions on certain USB device nodes

Allow them to realize this without reading the friendly *.c files.

Signed-off-by: Alan Jenkins <alan-jenkins@tuffmail.co.uk>
---
 udev/udev.xml |   12 +++++++++++-
 1 files changed, 11 insertions(+), 1 deletions(-)

diff --git a/udev/udev.xml b/udev/udev.xml
index 0ea5892..c34a106 100644
--- a/udev/udev.xml
+++ b/udev/udev.xml
@@ -167,6 +167,16 @@
             </varlistentry>
 
             <varlistentry>
+              <term><option>SYMLINK</option></term>
+              <listitem>
+                <para>Match the name of a symlink targeting the node. It can
+                be used once a SYMLINK key has been set in one of the preceding
+                rules. There may be multiple symlinks; only one needs to match.
+                </para>
+              </listitem>
+            </varlistentry>
+
+            <varlistentry>
               <term><option>SUBSYSTEM</option></term>
               <listitem>
                 <para>Match the subsystem of the event device.</para>
@@ -295,7 +305,7 @@
             <varlistentry>
               <term><option>SYMLINK</option></term>
               <listitem>
-                <para>The name of a symlink targeting the node. Every matching rule can add
+                <para>The name of a symlink targeting the node. Every matching rule will add
                 this value to the list of symlinks to be created along with the device  node.
                 Multiple symlinks may be specified by separating the names by the space
                 character.</para>
-- 
1.5.6.5

Re: [PATCH 2/2] man: SYMLINK can be matched as well as assigned

[Kay Sievers]

On Fri, Aug 7, 2009 at 14:29, Alan Jenkins<alan-jenkins@tuffmail.co.uk> wrote:
> If by-path / by-id links don't quite do what you want, this is a nice
> clean way to extend the behaviour.  Real example:

Applied.

Thanks,
Kay

Re: [PATCH 2/2] man: SYMLINK can be matched as well as assigned

[Matthias Schwarzott]

On Freitag, 7. August 2009, Alan Jenkins wrote:
> If by-path / by-id links don't quite do what you want, this is a nice
> clean way to extend the behaviour.  Real example:
>
> SYMLINK="serial/by-id/usb-Novatel_Wireless_Inc*CDMA*-if00-port0", \\
>  SYMLINK+="cellcard"
>
Some man-pages have example-sections, why not add this rule there?

Regards
Matthias

Re: [PATCH 2/2] man: SYMLINK can be matched as well as assigned

[Alan Jenkins]

Matthias Schwarzott wrote:
> On Freitag, 7. August 2009, Alan Jenkins wrote:
>   
>> If by-path / by-id links don't quite do what you want, this is a nice
>> clean way to extend the behaviour.  Real example:
>>
>> SYMLINK="serial/by-id/usb-Novatel_Wireless_Inc*CDMA*-if00-port0", \\
>>  SYMLINK+="cellcard"
>>
>>     
> Some man-pages have example-sections, why not add this rule there?
>   

Awkward question.  The easy answer is that this manpage doesn't have an
example-section yet.  I don't think adding that rule on it's own would
help.  For one, it begs an explanation of what set the by-id SYMLINK in
the first place.

I will have a look at the lonely docs/writing_udev_files.  Maybe it
could fit in there.

Thanks
Alan