Annotation of htdocs/docs/pkgsrc/users-guide.html, revision 1.5
1.1 dsieger 1: <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2: <html>
3: <head>
4: <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
5: <title>Part I. The pkgsrc user's guide</title>
1.2 rillig 6: <link rel="stylesheet" href="/global.css" type="text/css">
1.1 dsieger 7: <meta name="generator" content="DocBook XSL Stylesheets VX.X.X">
8: <link rel="start" href="index.html" title="The pkgsrc guide">
9: <link rel="up" href="index.html" title="The pkgsrc guide">
10: <link rel="prev" href="introduction.html" title="Chapter 1. What is pkgsrc?">
11: <link rel="next" href="getting.html" title="Chapter 2. Where to get pkgsrc and how to keep it up-to-date">
12: </head>
13: <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
14: <div class="navheader">
15: <table width="100%" summary="Navigation header">
16: <tr><th colspan="3" align="center">Part I. The pkgsrc user's guide</th></tr>
17: <tr>
18: <td width="20%" align="left">
19: <a accesskey="p" href="introduction.html">Prev</a> </td>
20: <th width="60%" align="center"> </th>
21: <td width="20%" align="right"> <a accesskey="n" href="getting.html">Next</a>
22: </td>
23: </tr>
24: </table>
25: <hr>
26: </div>
27: <div class="part" lang="en">
28: <div class="titlepage"><div><div><h1 class="title">
29: <a name="users-guide"></a>Part I. The pkgsrc user's guide</h1></div></div></div>
30: <div class="toc">
31: <p><b>Table of Contents</b></p>
32: <dl>
33: <dt><span class="chapter"><a href="getting.html">2. Where to get pkgsrc and how to keep it up-to-date</a></span></dt>
34: <dd><dl>
35: <dt><span class="sect1"><a href="getting.html#getting-first">2.1. Getting pkgsrc for the first time</a></span></dt>
36: <dd><dl>
37: <dt><span class="sect2"><a href="getting.html#getting-via-tar">2.1.1. As tar file</a></span></dt>
38: <dt><span class="sect2"><a href="getting.html#getting-via-sup">2.1.2. Via SUP</a></span></dt>
39: <dt><span class="sect2"><a href="getting.html#getting-via-cvs">2.1.3. Via anonymous CVS</a></span></dt>
40: </dl></dd>
41: <dt><span class="sect1"><a href="getting.html#uptodate">2.2. Keeping pkgsrc up-to-date</a></span></dt>
42: <dd><dl>
43: <dt><span class="sect2"><a href="getting.html#uptodate-tar">2.2.1. Via tar files</a></span></dt>
44: <dt><span class="sect2"><a href="getting.html#uptodate-cvs">2.2.2. Via CVS</a></span></dt>
45: </dl></dd>
46: </dl></dd>
47: <dt><span class="chapter"><a href="platforms.html">3. Using pkgsrc on systems other than NetBSD</a></span></dt>
48: <dd><dl>
49: <dt><span class="sect1"><a href="platforms.html#binarydist">3.1. Binary distribution</a></span></dt>
50: <dt><span class="sect1"><a href="platforms.html#bootstrapping-pkgsrc">3.2. Bootstrapping pkgsrc</a></span></dt>
51: <dt><span class="sect1"><a href="platforms.html#platform-specific-notes">3.3. Platform-specific notes</a></span></dt>
52: <dd><dl>
53: <dt><span class="sect2"><a href="platforms.html#darwin">3.3.1. Darwin (Mac OS X)</a></span></dt>
54: <dt><span class="sect2"><a href="platforms.html#freebsd">3.3.2. FreeBSD</a></span></dt>
55: <dt><span class="sect2"><a href="platforms.html#interix">3.3.3. Interix</a></span></dt>
56: <dt><span class="sect2"><a href="platforms.html#irix">3.3.4. IRIX</a></span></dt>
57: <dt><span class="sect2"><a href="platforms.html#linux">3.3.5. Linux</a></span></dt>
58: <dt><span class="sect2"><a href="platforms.html#openbsd">3.3.6. OpenBSD</a></span></dt>
59: <dt><span class="sect2"><a href="platforms.html#solaris">3.3.7. Solaris</a></span></dt>
60: </dl></dd>
61: </dl></dd>
62: <dt><span class="chapter"><a href="using.html">4. Using pkgsrc</a></span></dt>
63: <dd><dl>
64: <dt><span class="sect1"><a href="using.html#using-pkg">4.1. Using binary packages</a></span></dt>
65: <dd><dl>
66: <dt><span class="sect2"><a href="using.html#finding-binary-packages">4.1.1. Finding binary packages</a></span></dt>
67: <dt><span class="sect2"><a href="using.html#installing-binary-packages">4.1.2. Installing binary packages</a></span></dt>
68: <dt><span class="sect2"><a href="using.html#using.pkg_delete">4.1.3. Deinstalling packages</a></span></dt>
69: <dt><span class="sect2"><a href="using.html#using.pkg_info">4.1.4. Getting information about installed packages</a></span></dt>
70: <dt><span class="sect2"><a href="using.html#vulnerabilities">4.1.5. Checking for security vulnerabilities in installed packages</a></span></dt>
71: <dt><span class="sect2"><a href="using.html#pkg_versions">4.1.6. Finding if newer versions of your installed packages are in pkgsrc</a></span></dt>
72: <dt><span class="sect2"><a href="using.html#using.pkg_admin">4.1.7. Other administrative functions</a></span></dt>
73: <dt><span class="sect2"><a href="using.html#a-word-of-warning">4.1.8. A word of warning</a></span></dt>
74: </dl></dd>
75: <dt><span class="sect1"><a href="using.html#building-packages-from-source">4.2. Building packages from source</a></span></dt>
76: <dd><dl>
77: <dt><span class="sect2"><a href="using.html#requirements">4.2.1. Requirements</a></span></dt>
78: <dt><span class="sect2"><a href="using.html#fetching-distfiles">4.2.2. Fetching distfiles</a></span></dt>
79: <dt><span class="sect2"><a href="using.html#how-to-build-and-install">4.2.3. How to build and install</a></span></dt>
80: </dl></dd>
81: </dl></dd>
82: <dt><span class="chapter"><a href="configuring.html">5. Configuring pkgsrc</a></span></dt>
83: <dd><dl>
84: <dt><span class="sect1"><a href="configuring.html#general-configuration">5.1. General configuration</a></span></dt>
85: <dt><span class="sect1"><a href="configuring.html#variables-affecting-build">5.2. Variables affecting the build process</a></span></dt>
1.5 ! rillig 86: <dt><span class="sect1"><a href="configuring.html#variables-affecting-installation">5.3. Variables affecting the installation process</a></span></dt>
1.3 rillig 87: <dt><span class="sect1"><a href="configuring.html#conf.compiler">5.4. Selecting and configuring the compiler</a></span></dt>
1.1 dsieger 88: <dd><dl>
1.3 rillig 89: <dt><span class="sect2"><a href="configuring.html#selecting-the-compiler">5.4.1. Selecting the compiler</a></span></dt>
90: <dt><span class="sect2"><a href="configuring.html#conf.cflags">5.4.2. Additional flags to the compiler (<code class="varname">CFLAGS</code>)</a></span></dt>
91: <dt><span class="sect2"><a href="configuring.html#conf.ldflags">5.4.3. Additional flags to the linker (<code class="varname">LDFLAGS</code>)</a></span></dt>
1.1 dsieger 92: </dl></dd>
1.3 rillig 93: <dt><span class="sect1"><a href="configuring.html#developer-advanced-settings">5.5. Developer/advanced settings</a></span></dt>
94: <dt><span class="sect1"><a href="configuring.html#selecting-build-options">5.6. Selecting Build Options</a></span></dt>
1.1 dsieger 95: </dl></dd>
96: <dt><span class="chapter"><a href="binary.html">6. Creating binary packages</a></span></dt>
97: <dd><dl>
98: <dt><span class="sect1"><a href="binary.html#building-a-single-binary-package">6.1. Building a single binary package</a></span></dt>
99: <dt><span class="sect1"><a href="binary.html#settings-for-creationg-of-binary-packages">6.2. Settings for creation of binary packages</a></span></dt>
1.4 rillig 100: </dl></dd>
101: <dt><span class="chapter"><a href="bulk.html">7. Creating binary packages for everything in pkgsrc (bulk
102: builds)</a></span></dt>
103: <dd><dl>
104: <dt><span class="sect1"><a href="bulk.html#bulk.pre">7.1. Think first, build later</a></span></dt>
105: <dt><span class="sect1"><a href="bulk.html#bulk.req">7.2. Requirements of a bulk build</a></span></dt>
106: <dt><span class="sect1"><a href="bulk.html#bulk.old">7.3. Running an old-style bulk build</a></span></dt>
1.1 dsieger 107: <dd><dl>
1.4 rillig 108: <dt><span class="sect2"><a href="bulk.html#binary.configuration">7.3.1. Configuration</a></span></dt>
109: <dt><span class="sect2"><a href="bulk.html#other-environmental-considerations">7.3.2. Other environmental considerations</a></span></dt>
110: <dt><span class="sect2"><a href="bulk.html#operation">7.3.3. Operation</a></span></dt>
111: <dt><span class="sect2"><a href="bulk.html#what-it-does">7.3.4. What it does</a></span></dt>
112: <dt><span class="sect2"><a href="bulk.html#disk-space-requirements">7.3.5. Disk space requirements</a></span></dt>
113: <dt><span class="sect2"><a href="bulk.html#setting-up-a-sandbox">7.3.6. Setting up a sandbox for chrooted builds</a></span></dt>
114: <dt><span class="sect2"><a href="bulk.html#building-a-partial-set">7.3.7. Building a partial set of packages</a></span></dt>
115: <dt><span class="sect2"><a href="bulk.html#bulk-upload">7.3.8. Uploading results of a bulk build</a></span></dt>
1.1 dsieger 116: </dl></dd>
1.4 rillig 117: <dt><span class="sect1"><a href="bulk.html#bulk.pbulk">7.4. Running a pbulk-style bulk build</a></span></dt>
118: <dd><dl><dt><span class="sect2"><a href="bulk.html#bulk.pbulk.conf">7.4.1. Configuration</a></span></dt></dl></dd>
119: <dt><span class="sect1"><a href="bulk.html#creating-cdroms">7.5. Creating a multiple CD-ROM packages collection</a></span></dt>
120: <dd><dl><dt><span class="sect2"><a href="bulk.html#cdpack-example">7.5.1. Example of cdpack</a></span></dt></dl></dd>
1.1 dsieger 121: </dl></dd>
1.4 rillig 122: <dt><span class="chapter"><a href="files.html">8. Directory layout of the installed files</a></span></dt>
1.1 dsieger 123: <dd><dl>
1.4 rillig 124: <dt><span class="sect1"><a href="files.html#files.localbase">8.1. File system layout in <code class="literal">${LOCALBASE}</code></a></span></dt>
125: <dt><span class="sect1"><a href="files.html#files.varbase">8.2. File system layout in <code class="literal">${VARBASE}</code></a></span></dt>
1.1 dsieger 126: </dl></dd>
1.4 rillig 127: <dt><span class="chapter"><a href="faq.html">9. Frequently Asked Questions</a></span></dt>
1.1 dsieger 128: <dd><dl>
1.4 rillig 129: <dt><span class="sect1"><a href="faq.html#mailing-list-pointers">9.1. Are there any mailing lists for pkg-related discussion?</a></span></dt>
130: <dt><span class="sect1"><a href="faq.html#pkgviews-docs">9.2. Where's the pkgviews documentation?</a></span></dt>
131: <dt><span class="sect1"><a href="faq.html#faq-pkgtools">9.3. Utilities for package management (pkgtools)</a></span></dt>
132: <dt><span class="sect1"><a href="faq.html#non-root-pkgsrc">9.4. How to use pkgsrc as non-root</a></span></dt>
133: <dt><span class="sect1"><a href="faq.html#resume-transfers">9.5. How to resume transfers when fetching distfiles?</a></span></dt>
134: <dt><span class="sect1"><a href="faq.html#x.org-from-pkgsrc">9.6. How can I install/use modular X.org from pkgsrc?</a></span></dt>
135: <dt><span class="sect1"><a href="faq.html#fetch-behind-firewall">9.7. How to fetch files from behind a firewall</a></span></dt>
136: <dt><span class="sect1"><a href="faq.html#passive-ftp">9.8. How do I tell <span><strong class="command">make fetch</strong></span> to do passive FTP?</a></span></dt>
137: <dt><span class="sect1"><a href="faq.html#fetching-all-distfiles">9.9. How to fetch all distfiles at once</a></span></dt>
138: <dt><span class="sect1"><a href="faq.html#tmac.andoc-missing">9.10. What does “<span class="quote">Don't know how to make
1.1 dsieger 139: /usr/share/tmac/tmac.andoc</span>” mean?</a></span></dt>
1.4 rillig 140: <dt><span class="sect1"><a href="faq.html#bsd.own.mk-missing">9.11. What does “<span class="quote">Could not find bsd.own.mk</span>” mean?</a></span></dt>
141: <dt><span class="sect1"><a href="faq.html#using-sudo-with-pkgsrc">9.12. Using 'sudo' with pkgsrc</a></span></dt>
142: <dt><span class="sect1"><a href="faq.html#faq.conf">9.13. How do I change the location of configuration files?</a></span></dt>
143: <dt><span class="sect1"><a href="faq.html#audit-packages">9.14. Automated security checks</a></span></dt>
144: <dt><span class="sect1"><a href="faq.html#ufaq-cflags">9.15. Why do some packages ignore my <code class="varname">CFLAGS</code>?</a></span></dt>
145: <dt><span class="sect1"><a href="faq.html#ufaq-fail">9.16. A package does not build. What shall I do?</a></span></dt>
146: <dt><span class="sect1"><a href="faq.html#faq.rcs-conflicts">9.17. What does “<span class="quote">Makefile appears to contain unresolved cvs/rcs/??? merge conflicts</span>” mean?</a></span></dt>
1.1 dsieger 147: </dl></dd>
148: </dl>
149: </div>
150: </div>
151: <div class="navfooter">
152: <hr>
153: <table width="100%" summary="Navigation footer">
154: <tr>
155: <td width="40%" align="left">
156: <a accesskey="p" href="introduction.html">Prev</a> </td>
157: <td width="20%" align="center"> </td>
158: <td width="40%" align="right"> <a accesskey="n" href="getting.html">Next</a>
159: </td>
160: </tr>
161: <tr>
162: <td width="40%" align="left" valign="top">Chapter 1. What is pkgsrc? </td>
163: <td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td>
164: <td width="40%" align="right" valign="top"> Chapter 2. Where to get pkgsrc and how to keep it up-to-date</td>
165: </tr>
166: </table>
167: </div>
168: </body>
169: </html>
CVSweb <webmaster@jp.NetBSD.org>