r7157 - trunk/BOOK/general/sysutils

alexander at linuxfromscratch.org alexander at linuxfromscratch.org
Fri Dec 21 23:15:43 PST 2007


Author: alexander
Date: 2007-12-22 00:15:43 -0700 (Sat, 22 Dec 2007)
New Revision: 7157

Modified:
   trunk/BOOK/general/sysutils/hal.xml
Log:
Improved wording on HAL page, following suggestions from Archaic.


Modified: trunk/BOOK/general/sysutils/hal.xml
===================================================================
--- trunk/BOOK/general/sysutils/hal.xml	2007-12-22 06:36:38 UTC (rev 7156)
+++ trunk/BOOK/general/sysutils/hal.xml	2007-12-22 07:15:43 UTC (rev 7157)
@@ -244,6 +244,7 @@
     </sect3>
 
     <sect3><title>Configuration Information</title>
+    <sect4><title>Allowing users to invoke HAL methods</title>
 
       <para>The default setup for <application>HAL</application> is to allow
       only certain users to invoke methods such as Mount(). These are
@@ -302,7 +303,9 @@
 </device>
 </deviceinfo></literal>
 EOF</userinput></screen>
+      </sect4>
 
+      <sect4><title>Installing mount helpers</title>
       <para><application>HAL</application> only provides the methods such
       as Mount() to act on hardware. In order to take advantage of these,
       a <application>HAL</application> event handler such as
@@ -310,7 +313,11 @@
       url="http://ivman.sourceforge.net/">Ivman</ulink> should be
       installed.</para>
       <!-- FIXME: is Ivman still alive? -->
+      <!-- FIXME: explicitly name the mount helpers
+           from KDE (???) and Xfce (exo-mount) -->
+      </sect4>
 
+      <sect4><title>Changing default mount options</title>
       <para>In some cases, it is necessary to specify some default mount
       options for filesystems. E.g., in non-English environments, the
       <option>iocharset</option> and <option>codepage</option> options
@@ -351,19 +358,9 @@
 
       <para>The important point above is that the configuration procedure is
       desktop-specific. However, as of December, 2007, only GNOME allows the
-      user to set default mount options on a per-filesystem basis. To do so,
-      change the
-      <systemitem>/system/storage/default_options/[fs_type]/mount_options</systemitem>
-      GConf key either using <xref linkend="gconf-editor"/>, or from the
-      command line, as demonstrated in the following example:</para>
-
-<screen><userinput>gconftool-2 --type list --list-type=string \
-    --set /system/storage/default_options/vfat/mount_options \
-    "[shortname=mixed,uid=,usefree,iocharset=koi8-r,codepage=866]"</userinput></screen>
-
-      <para>See more details in the gnome-mount(1) manual page.</para>
-      
-      <para>KDE allows the mount options to be set only on a per-volume basis,
+      user to set default mount options on a per-filesystem basis,
+      as described in the next paragraph.
+      KDE allows the mount options to be set only on a per-volume basis,
       not per-filesystem, which is a
       <ulink url="http://bugs.kde.org/show_bug.cgi?id=133456">bug</ulink>,
       because, as mentioned in the report, <quote>for every new device (let's
@@ -376,17 +373,34 @@
            solution, but, from the description, policy-kit looks like
            an XML-ized sudo-like confguration parser, which has nothing
            common with the "default mount options" problem. -->
-      In these desktop environments, if the built-in
-      default mount options are not suitable, it is needed to mention every
-      possible removable storage device in <filename>/etc/fstab</filename>
-      with the correct options, thus mostly defeating the point of
-      installing HAL.</para>
+      In KDE and Xfce, if the built-in default mount options are not suitable,
+      it is needed to mention every possible removable storage device in
+      <filename>/etc/fstab</filename> with the correct options, thus mostly
+      defeating the point of installing HAL.</para>
+      
+      <para>In order to adjust the default mount options, GNOME users should
+      change the
+      <systemitem>/system/storage/default_options/[fs_type]/mount_options</systemitem>
+      GConf key either using <xref linkend="gconf-editor"/>, or from the
+      command line, as demonstrated in the following example:</para>
 
-      <para>If HAL does not accept new mount options by default,
-      (in the above example, this happens with the <option>usefree</option>
-      option), as <systemitem class="username">root</systemitem> user,
-      create a custom policy file that mentions unknown mount options:</para>
+<screen><userinput>gconftool-2 --type list --list-type=string \
+    --set /system/storage/default_options/vfat/mount_options \
+    "[shortname=mixed,uid=,usefree,iocharset=koi8-r,codepage=866]"</userinput></screen>
 
+      <para>See more details in the gnome-mount(1) manual page.</para>
+      </sect4>
+
+      <sect4><title>Adding allowed mount options</title>
+      <para>The list of mount options permitted in the default HAL
+      configuration resides in the
+      <filename>/usr/share/hal/fdi/policy/10osvendor/20-storage-methods.fdi</filename>
+      file. GNOME and KDE users may want to use options not in this
+      list (in the above example, this applies to the <option>usefree</option>
+      option). In this case, as <systemitem class="username">root</systemitem>
+      user, create a custom policy file that mentions unknown mount
+      options:</para>
+
 <screen role="root"><userinput>install -v -m755 -d /etc/hal/fdi/policy/30user &&
 cat > /etc/hal/fdi/policy/30user/30user-options.fdi << "EOF"
 <literal><?xml version="1.0" encoding="UTF-8"?> <!- -*- SGML -*- ->
@@ -406,6 +420,7 @@
     <match key="storage.media_check_enabled" bool="false">
       <match key="storage.no_partitions_hint" bool="true">
         <append key="volume.mount.valid_options" type="strlist">usefree</append>
+        <!-- Insert other options here -->
       </match>
     </match>
 
@@ -414,6 +429,7 @@
       <!-- allow these mount options for vfat -->
       <match key="volume.fstype" string="vfat">
         <append key="volume.mount.valid_options" type="strlist">usefree</append>
+        <!-- Insert other options here -->
       </match>
     </match>
 
@@ -421,6 +437,7 @@
 </deviceinfo></literal>
 EOF</userinput></screen>
 
+    </sect4>
     </sect3>
 
     <sect3  id="hal-init">




More information about the blfs-book mailing list