shaba/systemd-stable
1
1
Fork 0
mirror of https://github.com/systemd/systemd-stable.git synced 2025-01-24 02:03:54 +03:00
Code

man: a couple of additions to file-hierarchy(7)

Browse Source
This commit is contained in:
Lennart Poettering 2014-06-30 19:52:44 +02:00
parent 6fc2766795
commit 9fc25924be
1 changed files with 45 additions and 17 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

62
man/file-hierarchy.xml
View File

@ -130,7 +130,13 @@
network file systems, hence network file systems, hence
applications should not assume the applications should not assume the
full set of file API is available on full set of file API is available on
this directory.</para></listitem> this directory. Applications should
generally not reference this directory
directly, but via the per-user
<varname>$HOME</varname> environment
variable, or via the home directory
field of the user
database.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
@ -165,7 +171,9 @@
usually mounted as usually mounted as
<literal>tmpfs</literal> instance, and <literal>tmpfs</literal> instance, and
should hence not be used for larger should hence not be used for larger
files. Since the directory is files. (Use
<filename>/var/tmp</filename> for
larger files.) Since the directory is
accessible to other users of the accessible to other users of the
system it is essential that this system it is essential that this
directory is only written to with the directory is only written to with the
@ -175,7 +183,13 @@
usually flushed at boot-up. Also, usually flushed at boot-up. Also,
files that are not accessed within a files that are not accessed within a
certain time are usually automatically certain time are usually automatically
deleted.</para></listitem> deleted. If applications find the
environment variable
<varname>$TMP</varname> set they
should prefer using the directory
specified in it over directly
referencing
<filename>/tmp</filename>.</para></listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
@ -278,11 +292,13 @@
<listitem><para>Secondary library <listitem><para>Secondary library
directory for placing 64bit versions directory for placing 64bit versions
of system libraries in, if the primary of system libraries in, if the primary
architecture of the system is architecture of the system is 32bit,
32bit. This directory should not be and <filename>/usr/lib64</filename> is
used for package-specific data, unless defined in the platform ABI. This
this data requires 64bit-specific directory should not be used for
versions, too.</para></listitem> package-specific data, unless this
data requires 64bit-specific versions,
too.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
@ -291,7 +307,11 @@
betwen multiple packages, such as betwen multiple packages, such as
documentation, man pages, time zone documentation, man pages, time zone
information, fonts and other information, fonts and other
resources.</para></listitem> resources. Usually, the precise
location and format of files stored
below this directory is subject to
specifications that ensure
interoperability.</para></listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
@ -403,18 +423,26 @@
contrast to <filename>/tmp</filename> contrast to <filename>/tmp</filename>
this directory is usually mounted from this directory is usually mounted from
a persistent physical file system and a persistent physical file system and
can thus accept larger files. This can thus accept larger files. (Use
directory is generally not flushed at <filename>/tmp</filename> for smaller
boot-up, but time-based cleanup of files.) This directory is generally
files that have not been accessed for not flushed at boot-up, but time-based
a certain time is applied. The same cleanup of files that have not been
security restrictions as with accessed for a certain time is
applied. The same security
restrictions as with
<filename>/tmp</filename> apply, and <filename>/tmp</filename> apply, and
hence only hence only
<citerefentry><refentrytitle>mkstemp</refentrytitle><manvolnum>3</manvolnum></citerefentry>, <citerefentry><refentrytitle>mkstemp</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
<citerefentry><refentrytitle>mkdtemp</refentrytitle><manvolnum>3</manvolnum></citerefentry> <citerefentry><refentrytitle>mkdtemp</refentrytitle><manvolnum>3</manvolnum></citerefentry>
or similar calls should be used to or similar calls should be used to
make use of this directory. make use of this directory. If
applications find the environment
variable <varname>$TMP</varname> set
they should prefer using the directory
specified in it over directly
referencing
<filename>/var/tmp</filename>.
</para></listitem> </para></listitem>
</varlistentry> </varlistentry>
@ -607,7 +635,7 @@
</row> </row>
<row> <row>
<entry><filename>/usr/lib64</filename></entry> <entry><filename>/usr/lib64</filename></entry>
<entry>Public shared libraries of the package, compiled for the secondary, 64bit architecture, if this is part of the Operating System ABI.</entry> <entry>Public shared libraries of the package, compiled for the secondary, 64bit architecture, if this is part of the platform ABI of the architecture.</entry>
</row> </row>
<row> <row>
<entry><filename>/usr/lib64/<replaceable>package</replaceable></filename></entry> <entry><filename>/usr/lib64/<replaceable>package</replaceable></filename></entry>