summaryrefslogtreecommitdiff
path: root/src/admin/8_fslayout.xml
blob: e34b78c1cc04be6389dda76b7ef0930b39f0be61 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
<?xml version="1.0" encoding="utf-8"?>
<chapter label="8" id="fslayout">
    <title>File System Layout</title>
    <highlights><para>In this chapter, we will review directories and files common to all Adélie Linux systems.  Adélie Linux is based on the Filesystem Hierarchy Standard (FHS) 3.0 specification; directories and files specified in FHS are not covered here.</para></highlights>
    <section id="etc">
        <title><filename class="directory">/etc</filename>: Host-specific system configuration</title>
        <section role="NotInToc">
            <title>Purpose</title>
            <para>As in FHS, the /etc hierarchy contains configuration files specific to a single host.</para>
        </section>
        <section role="NotInToc">
            <title>Requirements</title>
            <para>The following directories, or symbolic links to directories, must be present in <filename class="directory">/etc</filename>:</para>
            <table frame="none">
                <title>Directories required in <filename class="directory">/etc</filename></title>
                <tgroup cols="2" align="left" colsep="1" rowsep="1">
                <thead>
                    <row>
                        <entry>Directory</entry>
                        <entry>Description</entry>
                    </row>
                </thead>
                <tbody>
                    <row>
                        <entry><filename class="directory">apk</filename></entry>
                        <entry>Configuration for the package manager</entry>
                    </row>
                </tbody>
                </tgroup>
            </table>
            <para>The following files, or symbolic links to files, must be present in <filename class="directory">/etc</filename>:</para>
            <table frame="none">
                <title>Files required in <filename class="directory">/etc</filename></title>
                <tgroup cols="2" align="left" colsep="1" rowsep="1">
                <thead>
                    <row>
                        <entry>File</entry>
                        <entry>Description</entry>
                    </row>
                </thead>
                <tbody>
                    <row>
                        <entry><filename>adelie-release</filename></entry>
                        <entry>Version and release information about the currently installed system software</entry>
                    </row>
                </tbody>
                </tgroup>
            </table>
        </section>
        <section role="NotInToc">
            <title>Specific Options</title>
            <para>The following files, or symbolic links to files, must be present in <filename class="directory">/etc</filename>, if the corresponding subsystem is installed:</para>
            <table frame="none">
                <title>Files optional in <filename class="directory">/etc</filename></title>
                <tgroup cols="2" align="left" colsep="1" rowsep="1">
                <thead>
                    <row>
                        <entry>File</entry>
                        <entry>Description</entry>
                    </row>
                </thead>
                <tbody>
                    <row>
                        <entry><filename>abuild.conf</filename></entry>
                        <entry>Configuration for building packages (optional)</entry>
                    </row>
                    <row>
                        <entry><filename>inputrc</filename></entry>
                        <entry>Configuration for Bash shell (optional)</entry>
                    </row>
                    <row>
                        <entry><filename>ld-musl-<envar>$ARCH</envar>.path</filename></entry>
                        <entry>Additional search paths for the dynamic linker (optional)</entry>
                    </row>
                </tbody>
                </tgroup>
            </table>
        </section>
        <section id="etc-apk">
            <title><filename class="directory">/etc/apk</filename>: Configuration files for the package manager</title>
            <section role="NotInToc">
                <title>Purpose</title>
                <para><filename class="directory">/etc/apk</filename> is used for configuring the Adélie Linux package manager, as described in <xref linkend="packages"/>.</para>
            </section>
            <section role="NotInToc">
                <title>Requirements</title>
                <para>The following directories, or symbolic links to directories, must be present in <filename class="directory">/etc/apk</filename>:</para>
                <table frame="none">
                    <title>Directories required in <filename class="directory">/etc/apk</filename></title>
                    <tgroup cols="2" align="left" colsep="1" rowsep="1">
                    <thead>
                        <row>
                            <entry>Directory</entry>
                            <entry>Description</entry>
                        </row>
                    </thead>
                    <tbody>
                        <row>
                            <entry><filename class="directory">keys</filename></entry>
                            <entry>Public keys for the repositories listed in <filename>repositories</filename> to ensure package integrity</entry>
                        </row>
                    </tbody>
                    </tgroup>
                </table>
                <para>The following files, or symbolic links to files, must be present in <filename class="directory">/etc/apk</filename>:</para>
                <table frame="none">
                    <title>Files required in <filename class="directory">/etc/apk</filename></title>
                    <tgroup cols="2" align="left" colsep="1" rowsep="1">
                    <thead>
                        <row>
                            <entry>File</entry>
                            <entry>Description</entry>
                        </row>
                    </thead>
                    <tbody>
                        <row>
                            <entry><filename>repositories</filename></entry>
                            <entry>A list of repositories for search and retrieval of packages</entry>
                        </row>
                        <row>
                            <entry><filename>world</filename></entry>
                            <entry>A list of packages currently required for the host</entry>
                        </row>
                    </tbody>
                    </tgroup>
                </table>
            </section>
        </section>
    </section>
</chapter>