hal/doc/spec hal-spec.html,1.18,1.19

David Zeuthen david at freedesktop.org
Thu Aug 26 15:16:19 PDT 2004


Update of /cvs/hal/hal/doc/spec
In directory gabe:/tmp/cvs-serv15305/doc/spec

Modified Files:
	hal-spec.html 
Log Message:
2004-08-27  David Zeuthen  <david at fubar.dk>

	* AUTHORS: Add Kay Sievers <kay.sievers at vrfy.org> cause he rocks.
	Sort the list in alphabetical order of surname (I'm just soo
	political correct :-)

	* fdi/20freedesktop/canon-digital-ixus-v.fdi: Merge onto usb_device
	since we really don't know what interface to target

	* hald/linux/hald_helper.h: Change comment about seqnum

	* hald/linux/libsysfs/sysfs_dir.c (sysfs_open_link): Patch from
	Steve Grubb <linux4_ever at yahoo.com> to fix leak on error condition.

	* hald/linux/osspec.c: 
	(add_computer_callouts_done): Move from TDL to GDL
	(osspec_probe): Add to TDL; callouts may need it (seen by Kristof
	Vansant <de_lupus at pandora.be>
	(hald_helper_device_node): Print out seqnum
	(hald_helper_data): Pass seqnum

	* hald/logger.h: Ignore ENABLE_VERBOSE_MODE; always compile all
	logging statements in (should take the heat of some bugreports)

	* tools/linux/hal_dev.c (main): Pass seqnum if available; otherwise
	pass -1.



Index: hal-spec.html
===================================================================
RCS file: /cvs/hal/hal/doc/spec/hal-spec.html,v
retrieving revision 1.18
retrieving revision 1.19
diff -u -d -r1.18 -r1.19
--- hal-spec.html	25 Aug 2004 21:06:45 -0000	1.18
+++ hal-spec.html	26 Aug 2004 22:16:16 -0000	1.19
@@ -264,6 +264,14 @@
 ></DT
 ><DT
 ><A
+HREF="#device-properties-kernel"
+><TT
+CLASS="literal"
+>kernel</TT
+> namespace</A
+></DT
+><DT
+><A
 HREF="#device-properties-volume-disc"
 ><TT
 CLASS="literal"
@@ -384,26 +392,26 @@
 ><DL
 ><DT
 ><A
-HREF="#AEN1715"
+HREF="#AEN1774"
 >Interface org.freedesktop.Hal.Manager</A
 ></DT
 ><DD
 ><DL
 ><DT
 ><A
-HREF="#AEN1726"
+HREF="#AEN1785"
 >Example</A
 ></DT
 ></DL
 ></DD
 ><DT
 ><A
-HREF="#AEN1734"
+HREF="#AEN1793"
 >Interface org.freedesktop.Hal.Device</A
 ></DT
 ><DT
 ><A
-HREF="#AEN1743"
+HREF="#AEN1802"
 >Interface org.freedesktop.Hal.AgentManager</A
 ></DT
 ></DL
@@ -3326,17 +3334,65 @@
 ><TD
 ><TT
 CLASS="literal"
->volume.is_filesystem</TT
-> (bool)</TD
+>volume.fsusage</TT
+> (string)</TD
 ><TD
->&nbsp;</TD
+>example: filesystem</TD
 ><TD
 >Yes</TD
 ><TD
->&#13;		This property is TRUE if the volume indeed contains a mountable
-		filesystem. If it's FALSE the volume contain other data such
-		as swap or partition maps.
-	      </TD
+>&#13;                This property specifies the expected usage of the volume
+              </TD
+></TR
+><TR
+><TD
+>&nbsp;</TD
+><TD
+>filesystem</TD
+><TD
+>&nbsp;</TD
+><TD
+>The volume is a mountable filesystem</TD
+></TR
+><TR
+><TD
+>&nbsp;</TD
+><TD
+>partitiontable</TD
+><TD
+>&nbsp;</TD
+><TD
+>The volume conatains a partitiontable</TD
+></TR
+><TR
+><TD
+>&nbsp;</TD
+><TD
+>raid</TD
+><TD
+>&nbsp;</TD
+><TD
+>The volume is a member of a raid set and not mountable</TD
+></TR
+><TR
+><TD
+>&nbsp;</TD
+><TD
+>other</TD
+><TD
+>&nbsp;</TD
+><TD
+>The volume is not mountable like a swap partition</TD
+></TR
+><TR
+><TD
+>&nbsp;</TD
+><TD
+>unused</TD
+><TD
+>&nbsp;</TD
+><TD
+>The volume is marked a unused or free</TD
 ></TR
 ><TR
 ><TD
@@ -3450,7 +3506,7 @@
 ><P
 ></P
 ><A
-NAME="AEN972"
+NAME="AEN997"
 ></A
 ><TABLE
 BORDER="1"
@@ -3571,6 +3627,109 @@
 ><HR><H3
 CLASS="sect2"
 ><A
+NAME="device-properties-kernel"
+><TT
+CLASS="literal"
+>kernel</TT
+> namespace</A
+></H3
+><P
+>&#13;
+	This namespace is found on the toplevel "Computer" device,
+	and represents information about the currently running kernel.
+
+      </P
+><DIV
+CLASS="informaltable"
+><P
+></P
+><A
+NAME="AEN1040"
+></A
+><TABLE
+BORDER="1"
+BGCOLOR="#E0E0E0"
+CELLSPACING="0"
+CELLPADDING="4"
+CLASS="CALSTABLE"
+><THEAD
+><TR
+><TH
+>Key (type)</TH
+><TH
+>Values</TH
+><TH
+>Mandatory</TH
+><TH
+>Description</TH
+></TR
+></THEAD
+><TBODY
+><TR
+><TD
+><TT
+CLASS="literal"
+>kernel.name</TT
+> (string)</TD
+><TD
+>example: Linux</TD
+><TD
+>No</TD
+><TD
+>&#13;                The name of the kernel, usually the equivalent of
+                <TT
+CLASS="literal"
+>uname -s</TT
+>.
+              </TD
+></TR
+><TR
+><TD
+><TT
+CLASS="literal"
+>kernel.version</TT
+> (string)</TD
+><TD
+>example: 2.6.5-7.104-default</TD
+><TD
+>No</TD
+><TD
+>&#13;                The version of the currently running kernel.  Usually
+                the equivalent of <TT
+CLASS="literal"
+>uname -r</TT
+>.
+              </TD
+></TR
+><TR
+><TD
+><TT
+CLASS="literal"
+>kernel.machine</TT
+> (string)</TD
+><TD
+>example: i686</TD
+><TD
+>No</TD
+><TD
+>&#13;                The "machine hardware name" of the currently running kernel.
+                Usually the equivalent of <TT
+CLASS="literal"
+>uname -m</TT
+>.
+	      </TD
+></TR
+></TBODY
+></TABLE
+><P
+></P
+></DIV
+></DIV
+><DIV
+CLASS="sect2"
+><HR><H3
+CLASS="sect2"
+><A
 NAME="device-properties-volume-disc"
 ><TT
 CLASS="literal"
@@ -3596,7 +3755,7 @@
 ><P
 ></P
 ><A
-NAME="AEN1017"
+NAME="AEN1076"
 ></A
 ><TABLE
 BORDER="1"
@@ -3858,7 +4017,7 @@
 ><P
 ></P
 ><A
-NAME="AEN1124"
+NAME="AEN1183"
 ></A
 ><TABLE
 BORDER="1"
@@ -4277,7 +4436,7 @@
 ><P
 ></P
 ><A
-NAME="AEN1293"
+NAME="AEN1352"
 ></A
 ><TABLE
 BORDER="1"
@@ -4476,7 +4635,7 @@
 ><P
 ></P
 ><A
-NAME="AEN1373"
+NAME="AEN1432"
 ></A
 ><TABLE
 BORDER="1"
@@ -4603,7 +4762,7 @@
 ><P
 ></P
 ><A
-NAME="AEN1419"
+NAME="AEN1478"
 ></A
 ><TABLE
 BORDER="1"
@@ -4727,7 +4886,7 @@
 ><P
 ></P
 ><A
-NAME="AEN1464"
+NAME="AEN1523"
 ></A
 ><TABLE
 BORDER="1"
@@ -4794,7 +4953,7 @@
 ><P
 ></P
 ><A
-NAME="AEN1484"
+NAME="AEN1543"
 ></A
 ><TABLE
 BORDER="1"
@@ -4859,7 +5018,7 @@
 ><P
 ></P
 ><A
-NAME="AEN1504"
+NAME="AEN1563"
 ></A
 ><TABLE
 BORDER="1"
@@ -4986,7 +5145,7 @@
 ><P
 ></P
 ><A
-NAME="AEN1548"
+NAME="AEN1607"
 ></A
 ><TABLE
 BORDER="1"
@@ -5133,7 +5292,7 @@
 ><P
 ></P
 ><A
-NAME="AEN1596"
+NAME="AEN1655"
 ></A
 ><TABLE
 BORDER="1"
@@ -5351,9 +5510,9 @@
 
 &#60;deviceinfo version="0.2"&#62;
   &#60;device&#62;
-    &#60;match key="info.bus" string="usb"&#62;
-      &#60;match key="usb.vendor_id" int="0x04a9"&#62;
-        &#60;match key="usb.product_id" int="0x3052"&#62;
+    &#60;match key="info.bus" string="usb_device"&#62;
+      &#60;match key="usb_device.vendor_id" int="0x04a9"&#62;
+        &#60;match key="usb_device.product_id" int="0x3052"&#62;
           &#60;merge key="info.category" type="string"&#62;camera&#60;/merge&#62;
           &#60;merge key="info.capabilities" type="string"&#62;camera&#60;/merge&#62;
           &#60;merge key="camera.access_method" type="string"&#62;user&#60;/merge&#62;
@@ -5487,7 +5646,7 @@
 ><P
 ></P
 ><A
-NAME="AEN1673"
+NAME="AEN1732"
 ></A
 ><TABLE
 BORDER="1"
@@ -5647,7 +5806,7 @@
 ><HR><H2
 CLASS="sect1"
 ><A
-NAME="AEN1715"
+NAME="AEN1774"
 >Interface org.freedesktop.Hal.Manager</A
 ></H2
 ><P
@@ -5763,7 +5922,7 @@
 ><HR><H3
 CLASS="sect2"
 ><A
-NAME="AEN1726"
+NAME="AEN1785"
 >Example</A
 ></H3
 ><P
@@ -5881,7 +6040,7 @@
 ><HR><H2
 CLASS="sect1"
 ><A
-NAME="AEN1734"
+NAME="AEN1793"
 >Interface org.freedesktop.Hal.Device</A
 ></H2
 ><P
@@ -6034,7 +6193,7 @@
 ><HR><H2
 CLASS="sect1"
 ><A
-NAME="AEN1743"
+NAME="AEN1802"
 >Interface org.freedesktop.Hal.AgentManager</A
 ></H2
 ><P




More information about the hal-commit mailing list