Bug 595594

Summary: udev man page appears to be missing descriptions for some match keys
Product: Red Hat Enterprise Linux 6 Reporter: Justin Clift <justin>
Component: udevAssignee: Harald Hoyer <harald>
Status: CLOSED NOTABUG QA Contact: qe-baseos-daemons
Severity: medium Docs Contact:
Priority: low    
Version: 6.0   
Target Milestone: rc   
Target Release: ---   
Hardware: All   
OS: Linux   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2010-05-25 08:07:41 UTC Type: ---
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:

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)