Bug 595594 - udev man page appears to be missing descriptions for some match keys
Summary: udev man page appears to be missing descriptions for some match keys
Keywords:
Status: CLOSED NOTABUG
Alias: None
Product: Red Hat Enterprise Linux 6
Classification: Red Hat
Component: udev
Version: 6.0
Hardware: All
OS: Linux
low
medium
Target Milestone: rc
: ---
Assignee: Harald Hoyer
QA Contact: qe-baseos-daemons
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2010-05-25 06:26 UTC by Justin Clift
Modified: 2010-05-25 08:07 UTC (History)
0 users

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 2010-05-25 08:07:41 UTC
Target Upstream Version:


Attachments (Terms of Use)

Description Justin Clift 2010-05-25 06:26:19 UTC
Description of problem:

While building udev rules, noticing the "BUS" key word used in some of the shipped udev rules is not documented in the udev man page.

For example:

  $ grep BUS /lib/udev/rules.d/40-redhat.rules
  ACTION=="add", KERNEL=="sg[0-9]*", BUS=="scsi", ATTRS{type}=="3|6", SYMLINK+="scanner scanner-%k", MODE="0660"
  ACTION=="add", KERNEL=="sg[0-9]*", BUS=="scsi", ATTRS{type}=="8", SYMLINK+="changer changer-%k", MODE="0660", GROUP="disk"
  BUS=="usb", KERNEL=="sd*", ATTRS{bInterfaceClass}=="08", ATTRS{bInterfaceSubClass}=="04", GROUP="floppy", MODE="0660", 	SYMLINK+="floppy floppy-%k"
  $

I'm trying to develop a working rule for single path iSCSI storage so it can be documented.  However the existing example in the virtualisation guide uses BUS (plus others) and isn't working "out of the box".  As BUS isn't documented, it's leaving me wondering if that needs to be changed to SUBSYSTEM or something.


Version-Release number of selected component (if applicable):

$ rpm -qa | grep udev
udev-debuginfo-147-2.6.el6.x86_64
libudev-147-2.6.el6.x86_64
libgudev1-147-2.6.el6.x86_64
udev-147-2.6.el6.x86_64
$


How reproducible:

Every time.


Steps to Reproduce:
1. n/a
2.
3.

Actual results:

Undocumented udev key word, making me wonder if the shipped rules files are wrong, or if the man page is incomplete.


Expected results:

All available udev key words documented.


Additional info:

Comment 2 Harald Hoyer 2010-05-25 08:07:41 UTC
BUS is obsolete... use SUBSYSTEM(s)


Note You need to log in before you can comment on or make changes to this bug.