diff options
Diffstat (limited to 'filesystem.html')
| -rw-r--r-- | filesystem.html | 151 |
1 files changed, 93 insertions, 58 deletions
diff --git a/filesystem.html b/filesystem.html index 92860f5..2d3db1d 100644 --- a/filesystem.html +++ b/filesystem.html @@ -15,10 +15,10 @@ <link href="https://assets.gentoo.org/tyrian/bootstrap.min.css" rel="stylesheet" media="screen"> <link href="https://assets.gentoo.org/tyrian/tyrian.min.css" rel="stylesheet" media="screen"> <script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script> - <script type="text/javascript" src="_static/jquery.js"></script> - <script type="text/javascript" src="_static/underscore.js"></script> - <script type="text/javascript" src="_static/doctools.js"></script> - <script type="text/javascript" src="_static/language_data.js"></script> + <script src="_static/jquery.js"></script> + <script src="_static/underscore.js"></script> + <script src="_static/doctools.js"></script> + <script src="_static/language_data.js"></script> <link rel="index" title="Index" href="genindex.html" /> <link rel="search" title="Search" href="search.html" /> <link rel="next" title="Installed files" href="installed-files.html" /> @@ -76,8 +76,25 @@ <li class=""><a href="_sources/filesystem.rst.txt">Source</a></li> <li> <a href="search.html">Search</a></li> + + + <li> + + <a href="genindex.html">General Index</a> + + </li> + <li> - <a href="genindex.html">Index</a></li> + + <a href="std-policy-index.html">Policy Index</a> + + </li> + + + + + + @@ -115,17 +132,20 @@ <div class="section" id="file-system-layout"> <h1>File system layout<a class="headerlink" href="#file-system-layout" title="Permalink to this headline">¶</a></h1> -<div class="section" id="installation-paths"> -<span id="index-0"></span><h2>Installation paths<a class="headerlink" href="#installation-paths" title="Permalink to this headline">¶</a></h2> +<div class="section" id="pg0201"> +<span id="installation-paths"></span><span id="index-0"></span><h2>Installation paths<a class="headerlink" href="#pg0201" title="Permalink to this headline">¶</a></h2> <dl class="field-list simple"> -<dt class="field-odd">Source</dt> -<dd class="field-odd"><p>QA</p> +<dt class="field-odd">PG</dt> +<dd class="field-odd"><p>0201</p> </dd> -<dt class="field-even">Reference</dt> -<dd class="field-even"><p><a class="reference external" href="https://gitweb.gentoo.org/repo/gentoo.git/tree/metadata/install-qa-check.d/08gentoo-paths">https://gitweb.gentoo.org/repo/gentoo.git/tree/metadata/install-qa-check.d/08gentoo-paths</a></p> +<dt class="field-even">Source</dt> +<dd class="field-even"><p>QA</p> </dd> -<dt class="field-odd">Reported</dt> -<dd class="field-odd"><p>via install-qa-check.d</p> +<dt class="field-odd">Reference</dt> +<dd class="field-odd"><p><a class="reference external" href="https://gitweb.gentoo.org/repo/gentoo.git/tree/metadata/install-qa-check.d/08gentoo-paths">https://gitweb.gentoo.org/repo/gentoo.git/tree/metadata/install-qa-check.d/08gentoo-paths</a></p> +</dd> +<dt class="field-even">Reported</dt> +<dd class="field-even"><p>via install-qa-check.d</p> </dd> </dl> <p>Gentoo packages may only install into one of the following top-level @@ -181,18 +201,21 @@ exceptions are:</p> <li><p>/nix for the nix package manager</p></li> </ul> </div> -<div class="section" id="support-for-separate-usr"> -<span id="index-1"></span><h2>Support for separate /usr<a class="headerlink" href="#support-for-separate-usr" title="Permalink to this headline">¶</a></h2> +<div class="section" id="pg0202"> +<span id="support-for-separate-usr"></span><span id="index-1"></span><h2>Support for separate /usr<a class="headerlink" href="#pg0202" title="Permalink to this headline">¶</a></h2> <dl class="field-list simple"> -<dt class="field-odd">Source</dt> -<dd class="field-odd"><p>QA</p> +<dt class="field-odd">PG</dt> +<dd class="field-odd"><p>0202</p> +</dd> +<dt class="field-even">Source</dt> +<dd class="field-even"><p>QA</p> </dd> -<dt class="field-even">Reference</dt> -<dd class="field-even"><p><a class="reference external" href="https://projects.gentoo.org/council/meeting-logs/20130813-summary.txt">https://projects.gentoo.org/council/meeting-logs/20130813-summary.txt</a> +<dt class="field-odd">Reference</dt> +<dd class="field-odd"><p><a class="reference external" href="https://projects.gentoo.org/council/meeting-logs/20130813-summary.txt">https://projects.gentoo.org/council/meeting-logs/20130813-summary.txt</a> <a class="reference external" href="https://projects.gentoo.org/council/meeting-logs/20130924-summary.txt">https://projects.gentoo.org/council/meeting-logs/20130924-summary.txt</a></p> </dd> -<dt class="field-odd">Reported</dt> -<dd class="field-odd"><p>no</p> +<dt class="field-even">Reported</dt> +<dd class="field-even"><p>no</p> </dd> </dl> <p>Developers are not required to support using separate /usr filesystem @@ -203,17 +226,20 @@ works, it is either subtly broken or relying on hacks (udev). In setups using initramfs, some of the boot and repair functionality can be moved from rootfs to initramfs.</p> </div> -<div class="section" id="strict-multilib-layout"> -<span id="index-2"></span><h2>Strict multilib layout<a class="headerlink" href="#strict-multilib-layout" title="Permalink to this headline">¶</a></h2> +<div class="section" id="pg0203"> +<span id="strict-multilib-layout"></span><span id="index-2"></span><h2>Strict multilib layout<a class="headerlink" href="#pg0203" title="Permalink to this headline">¶</a></h2> <dl class="field-list simple"> -<dt class="field-odd">Source</dt> -<dd class="field-odd"><p>QA</p> +<dt class="field-odd">PG</dt> +<dd class="field-odd"><p>0203</p> </dd> -<dt class="field-even">Reference</dt> -<dd class="field-even"><p><a class="reference external" href="https://gitweb.gentoo.org/proj/portage.git/tree/bin/install-qa-check.d/80multilib-strict">https://gitweb.gentoo.org/proj/portage.git/tree/bin/install-qa-check.d/80multilib-strict</a></p> +<dt class="field-even">Source</dt> +<dd class="field-even"><p>QA</p> </dd> -<dt class="field-odd">Reported</dt> -<dd class="field-odd"><p>via install-qa-check.d, fatal</p> +<dt class="field-odd">Reference</dt> +<dd class="field-odd"><p><a class="reference external" href="https://gitweb.gentoo.org/proj/portage.git/tree/bin/install-qa-check.d/80multilib-strict">https://gitweb.gentoo.org/proj/portage.git/tree/bin/install-qa-check.d/80multilib-strict</a></p> +</dd> +<dt class="field-even">Reported</dt> +<dd class="field-even"><p>via install-qa-check.d, fatal</p> </dd> </dl> <p>Libraries must be installed into an appropriate /lib* or /usr/lib* @@ -227,17 +253,20 @@ path. With modern Gentoo profiles, this is no longer the case and packages must install libraries into appropriate directory for them to be correctly found by the dynamic loader.</p> </div> -<div class="section" id="static-libraries-and-libtool-files"> -<span id="index-3"></span><h2>Static libraries and libtool files<a class="headerlink" href="#static-libraries-and-libtool-files" title="Permalink to this headline">¶</a></h2> +<div class="section" id="pg0204"> +<span id="static-libraries-and-libtool-files"></span><span id="index-3"></span><h2>Static libraries and libtool files<a class="headerlink" href="#pg0204" title="Permalink to this headline">¶</a></h2> <dl class="field-list simple"> -<dt class="field-odd">Source</dt> -<dd class="field-odd"><p>QA</p> +<dt class="field-odd">PG</dt> +<dd class="field-odd"><p>0204</p> </dd> -<dt class="field-even">Reference</dt> -<dd class="field-even"><p><a class="reference external" href="https://gitweb.gentoo.org/proj/portage.git/tree/bin/install-qa-check.d/80libraries">https://gitweb.gentoo.org/proj/portage.git/tree/bin/install-qa-check.d/80libraries</a></p> +<dt class="field-even">Source</dt> +<dd class="field-even"><p>QA</p> </dd> -<dt class="field-odd">Reported</dt> -<dd class="field-odd"><p>via install-qa-check.d, fatal</p> +<dt class="field-odd">Reference</dt> +<dd class="field-odd"><p><a class="reference external" href="https://gitweb.gentoo.org/proj/portage.git/tree/bin/install-qa-check.d/80libraries">https://gitweb.gentoo.org/proj/portage.git/tree/bin/install-qa-check.d/80libraries</a></p> +</dd> +<dt class="field-even">Reported</dt> +<dd class="field-even"><p>via install-qa-check.d, fatal</p> </dd> </dl> <p>Static libraries and libtool files (.la) must be installed into /usr @@ -250,18 +279,21 @@ installations may still use small / partition. Static libraries are used only during package builds, and installing them to rootfs would be a waste of space.</p> </div> -<div class="section" id="game-install-locations-and-ownership"> -<span id="index-4"></span><h2>Game install locations and ownership<a class="headerlink" href="#game-install-locations-and-ownership" title="Permalink to this headline">¶</a></h2> +<div class="section" id="pg0205"> +<span id="game-install-locations-and-ownership"></span><span id="index-4"></span><h2>Game install locations and ownership<a class="headerlink" href="#pg0205" title="Permalink to this headline">¶</a></h2> <dl class="field-list simple"> -<dt class="field-odd">Source</dt> -<dd class="field-odd"><p>Council, clarified by QA</p> +<dt class="field-odd">PG</dt> +<dd class="field-odd"><p>0205</p> +</dd> +<dt class="field-even">Source</dt> +<dd class="field-even"><p>Council, clarified by QA</p> </dd> -<dt class="field-even">Reference</dt> -<dd class="field-even"><p><a class="reference external" href="https://projects.gentoo.org/council/meeting-logs/20151213-summary.txt">https://projects.gentoo.org/council/meeting-logs/20151213-summary.txt</a> +<dt class="field-odd">Reference</dt> +<dd class="field-odd"><p><a class="reference external" href="https://projects.gentoo.org/council/meeting-logs/20151213-summary.txt">https://projects.gentoo.org/council/meeting-logs/20151213-summary.txt</a> <a class="reference external" href="https://projects.gentoo.org/council/meeting-logs/20151011-summary.txt">https://projects.gentoo.org/council/meeting-logs/20151011-summary.txt</a></p> </dd> -<dt class="field-odd">Reported</dt> -<dd class="field-odd"><p>via install-qa-check.d</p> +<dt class="field-even">Reported</dt> +<dd class="field-even"><p>via install-qa-check.d</p> </dd> </dl> <p>The historical game install locations (/usr/games and /etc/games) must @@ -286,14 +318,17 @@ share data files. Since the latter implied users must not be added to the games group, a new group (gamestat) needed to be created to fulfill that purpose.</p> </div> -<div class="section" id="absolute-symbolic-link-targets"> -<span id="index-5"></span><h2>Absolute symbolic link targets<a class="headerlink" href="#absolute-symbolic-link-targets" title="Permalink to this headline">¶</a></h2> +<div class="section" id="pg0206"> +<span id="absolute-symbolic-link-targets"></span><span id="index-5"></span><h2>Absolute symbolic link targets<a class="headerlink" href="#pg0206" title="Permalink to this headline">¶</a></h2> <dl class="field-list simple"> -<dt class="field-odd">Source</dt> -<dd class="field-odd"><p>QA</p> +<dt class="field-odd">PG</dt> +<dd class="field-odd"><p>0206</p> </dd> -<dt class="field-even">Reported</dt> -<dd class="field-even"><p>by repoman and pkgcheck (when ebuild-generated)</p> +<dt class="field-even">Source</dt> +<dd class="field-even"><p>QA</p> +</dd> +<dt class="field-odd">Reported</dt> +<dd class="field-odd"><p>by repoman and pkgcheck (when ebuild-generated)</p> </dd> </dl> <p>Packages must not install symbolic links with absolute targets. @@ -364,12 +399,12 @@ it is mounted in another location, e.g. for the purposes of recovery.</p> <li class="toctree-l1"><a class="reference internal" href="dependencies.html">Dependencies</a></li> <li class="toctree-l1"><a class="reference internal" href="ebuild-format.html">Ebuild file format</a></li> <li class="toctree-l1 current"><a class="current reference internal" href="#">File system layout</a><ul class='nav'> -<li class="toctree-l2"><a class="reference internal" href="#installation-paths">Installation paths</a></li> -<li class="toctree-l2"><a class="reference internal" href="#support-for-separate-usr">Support for separate /usr</a></li> -<li class="toctree-l2"><a class="reference internal" href="#strict-multilib-layout">Strict multilib layout</a></li> -<li class="toctree-l2"><a class="reference internal" href="#static-libraries-and-libtool-files">Static libraries and libtool files</a></li> -<li class="toctree-l2"><a class="reference internal" href="#game-install-locations-and-ownership">Game install locations and ownership</a></li> -<li class="toctree-l2"><a class="reference internal" href="#absolute-symbolic-link-targets">Absolute symbolic link targets</a></li> +<li class="toctree-l2"><a class="reference internal" href="#pg0201">Installation paths</a></li> +<li class="toctree-l2"><a class="reference internal" href="#pg0202">Support for separate /usr</a></li> +<li class="toctree-l2"><a class="reference internal" href="#pg0203">Strict multilib layout</a></li> +<li class="toctree-l2"><a class="reference internal" href="#pg0204">Static libraries and libtool files</a></li> +<li class="toctree-l2"><a class="reference internal" href="#pg0205">Game install locations and ownership</a></li> +<li class="toctree-l2"><a class="reference internal" href="#pg0206">Absolute symbolic link targets</a></li> </ul> </li> <li class="toctree-l1"><a class="reference internal" href="installed-files.html">Installed files</a></li> @@ -397,7 +432,7 @@ it is mounted in another location, e.g. for the purposes of recovery.</p> <h3 class="footerhead">Gentoo Policy Guide </h3> <div class="row"> <div class="col-xs-12 col-md-4"> - <span class="kk-group-header">Powered by</span><br><span><a href="http://sphinx-doc.org/">Sphinx 2.3.1</a> & <a href="https://github.com/mmagorsc/tyrian_sphinx_theme">Tyrian Theme 0.0.2</a></span> + <span class="kk-group-header">Powered by</span><br><span><a href="http://sphinx-doc.org/">Sphinx 2.4.3</a> & <a href="https://github.com/mmagorsc/tyrian_sphinx_theme">Tyrian Theme 0.0.7</a></span> </div> <div class="col-xs-12 col-md-4"> </div> |