[Lsb-messages] /var/www/bzr/lsb/devel/fhs-spec r57: another try at cleaning up /home wording (bug 788)
Mats Wichmann
mats at linuxfoundation.org
Fri Mar 27 14:16:54 UTC 2015
------------------------------------------------------------
revno: 57
committer: Mats Wichmann <mats at linuxfoundation.org>
branch nick: fhs-spec
timestamp: Fri 2015-03-27 08:16:54 -0600
message:
another try at cleaning up /home wording (bug 788)
modified:
root-filesystem.xml
-------------- next part --------------
=== modified file 'root-filesystem.xml'
--- a/root-filesystem.xml 2015-03-21 00:30:57 +0000
+++ b/root-filesystem.xml 2015-03-27 14:16:54 +0000
@@ -988,11 +988,12 @@
Different people prefer to place user accounts in a variety of places.
This section describes only a suggested placement for user home
directories; nevertheless we recommend that all FHS-compliant
-distributions use this as the default location for home
-directories.</para>
+distributions use this as the default location for user home
+directories. Non-login accounts created for administrative
+purposes often have their home directories elsewhere.</para>
-<para>On small systems, each user's directory is typically one of the
-many subdirectories of <filename>/home</filename> such as
+<para>On smaller systems, each user's home directory is typically implemented
+as a subdirectory directly under <filename>/home</filename>, for example
<filename>/home/smith</filename>, <filename>/home/torvalds</filename>,
<filename>/home/operator</filename>, etc. On large systems
(especially when the <filename>/home</filename> directories are shared
@@ -1003,14 +1004,15 @@
<filename>/home/students</filename>, etc.
</para>
</footnote>
-
The setup will differ from host to host. Therefore, no program should
-rely on this location.
-
+assume any specific location for a home directory, rather it
+should query for it.
<footnote>
<para>
-If you want to find out a user's home directory, you should use the
-<filename>getpwent(3)</filename> library function rather than relying
+To find a user's home directory, use a library function such
+as <function>getpwent</function>,
+<function>getpwent_r</function> of
+<function>fgetpwent</function> rather than relying
on <filename>/etc/passwd</filename> because user information may be
stored remotely using systems such as NIS.
</para>
@@ -1030,9 +1032,9 @@
files should not start with the '.' character.
<footnote>
<para>
-It is recommended that apart from autosave and lock files programs
+It is recommended that, apart from autosave and lock files, programs
should refrain from creating non dot files or directories in a home
-directory without user intervention.
+directory without user consent.
</para>
</footnote>
</para>
@@ -1041,8 +1043,9 @@
<section id='homeReferences'><title>References</title>
<para>
-A number of efforts have been made to standardize the layout of home
-directories, including the XDG Base Directories specification
+A number of efforts have been made in the past to standardize
+the layout of home directories,
+including the XDG Base Directories specification
<footnote>
<para>Found at
<ulink url="http://standards.freedesktop.org/basedir-spec/basedir-spec-latest.html" />
@@ -1057,9 +1060,11 @@
<ulink url="http://developer.gnome.org/glib/unstable/glib-Miscellaneous-Utility-Functions.html#GUserDirectory" />.
</para>
</footnote>
+Additional efforts in this direction are possible in the future.
To accomodate software which makes use of these conventions,
-distributions may create directory hierarchies underneath home
-directories which conform to them.
+distributions may create directory hierarchies which follow
+the conventions. Those directory hierarchies may be located
+underneath home directories.
</para>
</section>
</section>
More information about the lsb-messages
mailing list