Annotation of htdocs/docs/pkgsrc/users-guide.html, revision 1.7
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">
1.7 ! rillig 8: <link rel="home" href="index.html" title="The pkgsrc guide">
1.1 dsieger 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>
1.7 ! rillig 90: <dt><span class="sect2"><a href="configuring.html#conf.cflags">5.4.2. Additional flags to the compiler (CFLAGS)</a></span></dt>
! 91: <dt><span class="sect2"><a href="configuring.html#conf.ldflags">5.4.3. Additional flags to the linker (LDFLAGS)</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>
1.7 ! rillig 118: <dd><dl>
! 119: <dt><span class="sect2"><a href="bulk.html#bulk.pbulk.prepare">7.4.1. Preparation</a></span></dt>
! 120: <dt><span class="sect2"><a href="bulk.html#bulk.pbulk.conf">7.4.2. Configuration</a></span></dt>
! 121: </dl></dd>
1.4 rillig 122: <dt><span class="sect1"><a href="bulk.html#creating-cdroms">7.5. Creating a multiple CD-ROM packages collection</a></span></dt>
123: <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 124: </dl></dd>
1.4 rillig 125: <dt><span class="chapter"><a href="files.html">8. Directory layout of the installed files</a></span></dt>
1.1 dsieger 126: <dd><dl>
1.7 ! rillig 127: <dt><span class="sect1"><a href="files.html#files.localbase">8.1. File system layout in ${LOCALBASE}</a></span></dt>
! 128: <dt><span class="sect1"><a href="files.html#files.varbase">8.2. File system layout in ${VARBASE}</a></span></dt>
1.1 dsieger 129: </dl></dd>
1.4 rillig 130: <dt><span class="chapter"><a href="faq.html">9. Frequently Asked Questions</a></span></dt>
1.1 dsieger 131: <dd><dl>
1.4 rillig 132: <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>
133: <dt><span class="sect1"><a href="faq.html#pkgviews-docs">9.2. Where's the pkgviews documentation?</a></span></dt>
134: <dt><span class="sect1"><a href="faq.html#faq-pkgtools">9.3. Utilities for package management (pkgtools)</a></span></dt>
135: <dt><span class="sect1"><a href="faq.html#non-root-pkgsrc">9.4. How to use pkgsrc as non-root</a></span></dt>
136: <dt><span class="sect1"><a href="faq.html#resume-transfers">9.5. How to resume transfers when fetching distfiles?</a></span></dt>
137: <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>
138: <dt><span class="sect1"><a href="faq.html#fetch-behind-firewall">9.7. How to fetch files from behind a firewall</a></span></dt>
1.7 ! rillig 139: <dt><span class="sect1"><a href="faq.html#passive-ftp">9.8. How do I tell make fetch to do passive FTP?</a></span></dt>
1.4 rillig 140: <dt><span class="sect1"><a href="faq.html#fetching-all-distfiles">9.9. How to fetch all distfiles at once</a></span></dt>
1.7 ! rillig 141: <dt><span class="sect1"><a href="faq.html#tmac.andoc-missing">9.10. What does Don't know how to make
! 142: /usr/share/tmac/tmac.andoc mean?</a></span></dt>
! 143: <dt><span class="sect1"><a href="faq.html#bsd.own.mk-missing">9.11. What does Could not find bsd.own.mk mean?</a></span></dt>
1.4 rillig 144: <dt><span class="sect1"><a href="faq.html#using-sudo-with-pkgsrc">9.12. Using 'sudo' with pkgsrc</a></span></dt>
145: <dt><span class="sect1"><a href="faq.html#faq.conf">9.13. How do I change the location of configuration files?</a></span></dt>
146: <dt><span class="sect1"><a href="faq.html#audit-packages">9.14. Automated security checks</a></span></dt>
1.7 ! rillig 147: <dt><span class="sect1"><a href="faq.html#ufaq-cflags">9.15. Why do some packages ignore my CFLAGS?</a></span></dt>
1.4 rillig 148: <dt><span class="sect1"><a href="faq.html#ufaq-fail">9.16. A package does not build. What shall I do?</a></span></dt>
1.7 ! rillig 149: <dt><span class="sect1"><a href="faq.html#faq.rcs-conflicts">9.17. What does Makefile appears to contain unresolved cvs/rcs/??? merge conflicts mean?</a></span></dt>
1.1 dsieger 150: </dl></dd>
151: </dl>
152: </div>
153: </div>
154: <div class="navfooter">
155: <hr>
156: <table width="100%" summary="Navigation footer">
157: <tr>
158: <td width="40%" align="left">
159: <a accesskey="p" href="introduction.html">Prev</a> </td>
160: <td width="20%" align="center"> </td>
161: <td width="40%" align="right"> <a accesskey="n" href="getting.html">Next</a>
162: </td>
163: </tr>
164: <tr>
165: <td width="40%" align="left" valign="top">Chapter 1. What is pkgsrc? </td>
166: <td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td>
167: <td width="40%" align="right" valign="top"> Chapter 2. Where to get pkgsrc and how to keep it up-to-date</td>
168: </tr>
169: </table>
170: </div>
171: </body>
172: </html>
CVSweb <webmaster@jp.NetBSD.org>