source: trunk/doc-new/man/xml/porthier.7.xml @ 81656

Last change on this file since 81656 was 81656, checked in by jmr@…, 9 years ago

guide: update porthier

File size: 11.4 KB
Line 
1<?xml version="1.0" encoding="UTF-8"?>
2<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
4<refentry id="porthier">
5  <refmeta>
6    <refentrytitle>PORTHIER</refentrytitle>
7
8    <manvolnum>7</manvolnum>
9  </refmeta>
10
11  <refnamediv>
12    <refname>porthier</refname>
13
14    <refpurpose>layout of the ports filesystems</refpurpose>
15  </refnamediv>
16
17  <refsection>
18    <title>Description</title>
19
20    <para>A map of the filesystem hierarchy used by MacPorts and the ports it
21    installs. Much of it is based on <citerefentry>
22        <refentrytitle>hier</refentrytitle>
23
24        <manvolnum>7</manvolnum>
25      </citerefentry>.</para>
26
27    <variablelist>
28      <varlistentry>
29        <term><varname>${prefix}</varname></term>
30
31        <listitem>
32          <para>The base of the MacPorts filesystem hierarchy.</para>
33
34          <para>Default: <filename>/opt/local/</filename></para>
35
36          <variablelist>
37            <varlistentry>
38              <term><filename>bin/</filename></term>
39
40              <listitem>
41                <para>Common utilities, programming tools, and
42                applications.</para>
43              </listitem>
44            </varlistentry>
45          </variablelist>
46
47          <variablelist>
48            <varlistentry>
49              <term><filename>etc/</filename></term>
50
51              <listitem>
52                <para>System configuration files and scripts.</para>
53              </listitem>
54            </varlistentry>
55          </variablelist>
56
57          <variablelist>
58            <varlistentry>
59              <term><filename>include/</filename></term>
60
61              <listitem>
62                <para>Standard C include files.</para>
63              </listitem>
64            </varlistentry>
65          </variablelist>
66
67          <variablelist>
68            <varlistentry>
69              <term><filename>lib/</filename></term>
70
71              <listitem>
72                <para>Archive libraries.</para>
73              </listitem>
74            </varlistentry>
75          </variablelist>
76
77          <variablelist>
78            <varlistentry>
79              <term><filename>libexec/</filename></term>
80
81              <listitem>
82                <para>System daemons and system utilities (executed by other
83                programs).</para>
84              </listitem>
85            </varlistentry>
86          </variablelist>
87
88          <variablelist>
89            <varlistentry>
90              <term><filename>Library/Frameworks/</filename></term>
91
92              <listitem>
93                <para>Native Mac OS X Library Frameworks</para>
94              </listitem>
95            </varlistentry>
96          </variablelist>
97
98          <variablelist>
99            <varlistentry>
100              <term><filename>sbin/</filename></term>
101
102              <listitem>
103                <para>System programs and administration utilities.</para>
104              </listitem>
105            </varlistentry>
106          </variablelist>
107
108          <variablelist>
109            <varlistentry>
110              <term><filename>share/</filename></term>
111
112              <listitem>
113                <para>Architecture-independent files.</para>
114
115                <variablelist>
116                  <varlistentry>
117                    <term><filename>doc/</filename></term>
118
119                    <listitem>
120                      <para>Miscellaneous documentation.</para>
121                    </listitem>
122                  </varlistentry>
123                </variablelist>
124
125                <variablelist>
126                  <varlistentry>
127                    <term><filename>examples/</filename></term>
128
129                    <listitem>
130                      <para>Examples for users and programmers.</para>
131                    </listitem>
132                  </varlistentry>
133                </variablelist>
134
135                <variablelist>
136                  <varlistentry>
137                    <term><filename>info/</filename></term>
138
139                    <listitem>
140                      <para>GNU Info hypertext system.</para>
141                    </listitem>
142                  </varlistentry>
143                </variablelist>
144
145                <variablelist>
146                  <varlistentry>
147                    <term><filename>locale/</filename></term>
148
149                    <listitem>
150                      <para>Localization files.</para>
151                    </listitem>
152                  </varlistentry>
153                </variablelist>
154
155                <variablelist>
156                  <varlistentry>
157                    <term><filename>man/</filename></term>
158
159                    <listitem>
160                      <para>Manual pages.</para>
161                    </listitem>
162                  </varlistentry>
163                </variablelist>
164
165                <variablelist>
166                  <varlistentry>
167                    <term><filename>misc/</filename></term>
168
169                    <listitem>
170                      <para>Miscellaneous system-wide ASCII text files.</para>
171                    </listitem>
172                  </varlistentry>
173                </variablelist>
174              </listitem>
175            </varlistentry>
176
177            <varlistentry>
178              <term><filename>src/</filename></term>
179
180              <listitem>
181                <para>Source code.</para>
182              </listitem>
183            </varlistentry>
184
185            <varlistentry>
186              <term><filename>var/</filename></term>
187
188              <listitem>
189                <para>Multi-purpose log, temporary, transient and spool
190                files.</para>
191
192                <variablelist>
193                  <varlistentry>
194                    <term><filename>db/</filename></term>
195
196                    <listitem>
197                      <para>Miscellaneous automatically generated
198                      system-specific database files.</para>
199                    </listitem>
200                  </varlistentry>
201
202                  <varlistentry>
203                    <term><filename>macports/</filename></term>
204
205                    <listitem>
206                      <para>MacPorts package building topdir.</para>
207
208                      <variablelist>
209                        <varlistentry>
210                          <term><filename>build/</filename></term>
211
212                          <listitem>
213                            <para>Where ports are built and destrooted.</para>
214                          </listitem>
215                        </varlistentry>
216
217                        <varlistentry>
218                          <term><filename>distfiles/</filename></term>
219
220                          <listitem>
221                            <para>Storage location for the distfiles of fetched
222                            ports.</para>
223                          </listitem>
224                        </varlistentry>
225
226                        <varlistentry>
227                          <term><filename>packages/</filename></term>
228
229                          <listitem>
230                            <para>Obsolete. Formerly contained archives (packages) of installed
231                            ports.</para>
232                          </listitem>
233                        </varlistentry>
234
235                        <varlistentry>
236                          <term><filename>receipts/</filename></term>
237
238                          <listitem>
239                            <para>Obsolete. Formerly contained the registry information and receipts
240                            for installed ports, in flat-file format.</para>
241                          </listitem>
242                        </varlistentry>
243
244                        <varlistentry>
245                          <term><filename>registry/</filename></term>
246
247                          <listitem>
248                            <para>Contains the registry database in sqlite format.</para>
249                          </listitem>
250                        </varlistentry>
251
252
253                        <varlistentry>
254                          <term><filename>software/</filename></term>
255
256                          <listitem>
257                            <para>The files for each installed port are stored here.</para>
258                          </listitem>
259                        </varlistentry>
260
261                        <varlistentry>
262                          <term><filename>sources/</filename></term>
263
264                          <listitem>
265                            <para>Holds the sources for the ports tree (the
266                            Portfiles) and also MacPorts base.</para>
267                          </listitem>
268                        </varlistentry>
269                      </variablelist>
270                    </listitem>
271                  </varlistentry>
272                </variablelist>
273
274                <variablelist>
275                  <varlistentry>
276                    <term><filename>spool/</filename></term>
277
278                    <listitem>
279                      <para>Directory containing output spool files.</para>
280                    </listitem>
281                  </varlistentry>
282                </variablelist>
283
284                <variablelist>
285                  <varlistentry>
286                    <term><filename>log/</filename></term>
287
288                    <listitem>
289                      <para>Miscellaneous system log files.</para>
290                    </listitem>
291                  </varlistentry>
292                </variablelist>
293
294                <variablelist>
295                  <varlistentry>
296                    <term><filename>run/</filename></term>
297
298                    <listitem>
299                      <para>System information files describing various
300                      information about the system since it was booted.</para>
301                    </listitem>
302                  </varlistentry>
303                </variablelist>
304              </listitem>
305            </varlistentry>
306
307            <varlistentry>
308              <term><filename>www/</filename></term>
309
310              <listitem>
311                <para>Files to be served by an http server.</para>
312
313                <variablelist>
314                  <varlistentry>
315                    <term><filename>cgi-bin/</filename></term>
316
317                    <listitem>
318                      <para>Directory for cgi executables.</para>
319                    </listitem>
320                  </varlistentry>
321                </variablelist>
322              </listitem>
323            </varlistentry>
324          </variablelist>
325        </listitem>
326      </varlistentry>
327    </variablelist>
328
329    <variablelist>
330      <varlistentry>
331        <term><filename>/Applications/MacPorts/</filename></term>
332
333        <listitem>
334          <para>Native Mac OS X applications.</para>
335        </listitem>
336      </varlistentry>
337    </variablelist>
338  </refsection>
339
340  <refsection>
341    <title>SEE ALSO</title>
342
343    <para><citerefentry>
344        <refentrytitle>port</refentrytitle>
345
346        <manvolnum>1</manvolnum>
347      </citerefentry>, <citerefentry>
348        <refentrytitle>macports.conf</refentrytitle>
349
350        <manvolnum>5</manvolnum>
351      </citerefentry>, <citerefentry>
352        <refentrytitle>portfile</refentrytitle>
353
354        <manvolnum>7</manvolnum>
355      </citerefentry>, <citerefentry>
356        <refentrytitle>portgroup</refentrytitle>
357
358        <manvolnum>7</manvolnum>
359      </citerefentry>, <citerefentry>
360        <refentrytitle>portstyle</refentrytitle>
361
362        <manvolnum>7</manvolnum>
363      </citerefentry>, <citerefentry>
364        <refentrytitle>hier</refentrytitle>
365
366        <manvolnum>7</manvolnum>
367      </citerefentry></para>
368  </refsection>
369
370  <refsection>
371    <title>AUTHORS</title>
372
373    <para>Felix Kroniage <email>fkr@opendarwin.org</email></para>
374
375    <para>Juan Manuel Palacios <email>jmpp@macports.org</email></para>
376  </refsection>
377</refentry>
Note: See TracBrowser for help on using the repository browser.