Annotation of htdocs/docs/pkgsrc/users-guide.html, revision 1.41
1.31 sevan 1: <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
1.1 dsieger 2: <html>
3: <head>
1.40 martin 4: <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5: <title>Part I. The pkgsrc user's guide</title>
1.9 spz 6: <link rel="stylesheet" type="text/css" href="/global.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">
1.40 martin 10: <link rel="prev" href="introduction.html" title="Chapter 1. What is pkgsrc?">
11: <link rel="next" href="help-user.html" title="Chapter 2. Getting help">
1.1 dsieger 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">
1.40 martin 16: <tr><th colspan="3" align="center">Part I. The pkgsrc user's guide</th></tr>
1.1 dsieger 17: <tr>
18: <td width="20%" align="left">
1.40 martin 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="help-user.html">Next</a>
1.1 dsieger 22: </td>
23: </tr>
24: </table>
25: <hr>
26: </div>
1.10 asau 27: <div class="part">
1.1 dsieger 28: <div class="titlepage"><div><div><h1 class="title">
1.40 martin 29: <a name="users-guide"></a>Part I. The pkgsrc user's guide</h1></div></div></div>
1.1 dsieger 30: <div class="toc">
31: <p><b>Table of Contents</b></p>
1.27 leot 32: <dl class="toc">
1.32 rillig 33: <dt><span class="chapter"><a href="help-user.html">2. Getting help</a></span></dt>
34: <dt><span class="chapter"><a href="getting.html">3. Where to get pkgsrc and how to keep it up-to-date</a></span></dt>
1.1 dsieger 35: <dd><dl>
1.32 rillig 36: <dt><span class="sect1"><a href="getting.html#getting-first">3.1. Getting pkgsrc for the first time</a></span></dt>
1.1 dsieger 37: <dd><dl>
1.32 rillig 38: <dt><span class="sect2"><a href="getting.html#getting-via-tar">3.1.1. As tar archive</a></span></dt>
39: <dt><span class="sect2"><a href="getting.html#getting-via-cvs">3.1.2. Via anonymous CVS</a></span></dt>
1.1 dsieger 40: </dl></dd>
1.32 rillig 41: <dt><span class="sect1"><a href="getting.html#uptodate">3.2. Keeping pkgsrc up-to-date</a></span></dt>
1.1 dsieger 42: <dd><dl>
1.32 rillig 43: <dt><span class="sect2"><a href="getting.html#uptodate-tar">3.2.1. Via tar files</a></span></dt>
44: <dt><span class="sect2"><a href="getting.html#uptodate-cvs">3.2.2. Via CVS</a></span></dt>
1.1 dsieger 45: </dl></dd>
46: </dl></dd>
1.32 rillig 47: <dt><span class="chapter"><a href="platforms.html">4. Using pkgsrc on systems other than NetBSD</a></span></dt>
1.1 dsieger 48: <dd><dl>
1.32 rillig 49: <dt><span class="sect1"><a href="platforms.html#binarydist">4.1. Binary distribution</a></span></dt>
50: <dt><span class="sect1"><a href="platforms.html#bootstrapping-pkgsrc">4.2. Bootstrapping pkgsrc</a></span></dt>
1.1 dsieger 51: </dl></dd>
1.32 rillig 52: <dt><span class="chapter"><a href="using.html">5. Using pkgsrc</a></span></dt>
1.1 dsieger 53: <dd><dl>
1.32 rillig 54: <dt><span class="sect1"><a href="using.html#using-pkg">5.1. Using binary packages</a></span></dt>
1.1 dsieger 55: <dd><dl>
1.32 rillig 56: <dt><span class="sect2"><a href="using.html#finding-binary-packages">5.1.1. Finding binary packages</a></span></dt>
57: <dt><span class="sect2"><a href="using.html#installing-binary-packages">5.1.2. Installing binary packages</a></span></dt>
1.37 nia 58: <dt><span class="sect2"><a href="using.html#using.pkgin_update">5.1.3. Updating packages</a></span></dt>
59: <dt><span class="sect2"><a href="using.html#using.pkg_delete">5.1.4. Deinstalling packages</a></span></dt>
60: <dt><span class="sect2"><a href="using.html#using.pkg_info">5.1.5. Getting information about installed packages</a></span></dt>
61: <dt><span class="sect2"><a href="using.html#vulnerabilities">5.1.6. Checking for security vulnerabilities in installed packages</a></span></dt>
62: <dt><span class="sect2"><a href="using.html#pkg_versions">5.1.7. Finding if newer versions of your installed packages are in pkgsrc</a></span></dt>
63: <dt><span class="sect2"><a href="using.html#using.pkg_admin">5.1.8. Other administrative functions</a></span></dt>
1.1 dsieger 64: </dl></dd>
1.32 rillig 65: <dt><span class="sect1"><a href="using.html#building-packages-from-source">5.2. Building packages from source</a></span></dt>
1.1 dsieger 66: <dd><dl>
1.32 rillig 67: <dt><span class="sect2"><a href="using.html#requirements">5.2.1. Requirements</a></span></dt>
68: <dt><span class="sect2"><a href="using.html#fetching-distfiles">5.2.2. Fetching distfiles</a></span></dt>
69: <dt><span class="sect2"><a href="using.html#how-to-build-and-install">5.2.3. How to build and install</a></span></dt>
1.1 dsieger 70: </dl></dd>
71: </dl></dd>
1.32 rillig 72: <dt><span class="chapter"><a href="configuring.html">6. Configuring pkgsrc</a></span></dt>
1.1 dsieger 73: <dd><dl>
1.32 rillig 74: <dt><span class="sect1"><a href="configuring.html#general-configuration">6.1. General configuration</a></span></dt>
75: <dt><span class="sect1"><a href="configuring.html#variables-affecting-build">6.2. Variables affecting the build process</a></span></dt>
1.39 rillig 76: <dt><span class="sect1"><a href="configuring.html#native-or-pkgsrc-preference">6.3. Preferences for native or pkgsrc software</a></span></dt>
77: <dt><span class="sect1"><a href="configuring.html#variables-affecting-installation">6.4. Variables affecting the installation process</a></span></dt>
78: <dt><span class="sect1"><a href="configuring.html#conf.compiler">6.5. Selecting and configuring the compiler</a></span></dt>
79: <dd><dl>
80: <dt><span class="sect2"><a href="configuring.html#selecting-the-compiler">6.5.1. Selecting the compiler</a></span></dt>
81: <dt><span class="sect2"><a href="configuring.html#conf.cflags">6.5.2. Additional flags to the compiler (<code class="varname">CFLAGS</code>)</a></span></dt>
82: <dt><span class="sect2"><a href="configuring.html#conf.ldflags">6.5.3. Additional flags to the linker (<code class="varname">LDFLAGS</code>)</a></span></dt>
1.1 dsieger 83: </dl></dd>
1.39 rillig 84: <dt><span class="sect1"><a href="configuring.html#developer-advanced-settings">6.6. Developer/advanced settings</a></span></dt>
85: <dt><span class="sect1"><a href="configuring.html#selecting-build-options">6.7. Selecting Build Options</a></span></dt>
1.1 dsieger 86: </dl></dd>
1.32 rillig 87: <dt><span class="chapter"><a href="binary.html">7. Creating binary packages</a></span></dt>
1.1 dsieger 88: <dd><dl>
1.32 rillig 89: <dt><span class="sect1"><a href="binary.html#building-a-single-binary-package">7.1. Building a single binary package</a></span></dt>
90: <dt><span class="sect1"><a href="binary.html#settings-for-creationg-of-binary-packages">7.2. Settings for creation of binary packages</a></span></dt>
1.4 rillig 91: </dl></dd>
1.32 rillig 92: <dt><span class="chapter"><a href="bulk.html">8. Creating binary packages for everything in pkgsrc (bulk
1.4 rillig 93: builds)</a></span></dt>
94: <dd><dl>
1.32 rillig 95: <dt><span class="sect1"><a href="bulk.html#bulk.pre">8.1. Preparations</a></span></dt>
1.35 rillig 96: <dt><span class="sect1"><a href="bulk.html#bulk.pbulk">8.2. Running a bulk build</a></span></dt>
1.32 rillig 97: <dd><dl><dt><span class="sect2"><a href="bulk.html#bulk.pbulk.conf">8.2.1. Configuration</a></span></dt></dl></dd>
1.41 ! wiz 98: <dt><span class="sect1"><a href="bulk.html#bulk.scan">8.3. Speeding up bulk build scans</a></span></dt>
! 99: <dt><span class="sect1"><a href="bulk.html#bulk.req">8.4. Requirements of a full bulk build</a></span></dt>
! 100: <dt><span class="sect1"><a href="bulk.html#bulk.var">8.5. Bulk build variants</a></span></dt>
1.33 rillig 101: <dd><dl>
1.41 ! wiz 102: <dt><span class="sect2"><a href="bulk.html#bulk.var.confopt">8.5.1. Detect unknown configure options</a></span></dt>
! 103: <dt><span class="sect2"><a href="bulk.html#bulk.var.comperr">8.5.2. Detect classes of bugs by forcing compiler warnings</a></span></dt>
! 104: <dt><span class="sect2"><a href="bulk.html#bulk.var.builderr">8.5.3. Force compiler options only in the build phase</a></span></dt>
! 105: <dt><span class="sect2"><a href="bulk.html#bulk.var.dirs">8.5.4. Use custom directories</a></span></dt>
! 106: <dt><span class="sect2"><a href="bulk.html#bulk.var.warn">8.5.5. Turn warnings into errors</a></span></dt>
! 107: <dt><span class="sect2"><a href="bulk.html#bulk.var.pkglint">8.5.6. Reject packages for which pkglint reports errors</a></span></dt>
! 108: <dt><span class="sect2"><a href="bulk.html#bulk.var.strings">8.5.7. Reject packages that contain forbidden strings</a></span></dt>
! 109: <dt><span class="sect2"><a href="bulk.html#bulk.var.test">8.5.8. Reject packages whose self-test fails</a></span></dt>
! 110: <dt><span class="sect2"><a href="bulk.html#bulk.var.shvar">8.5.9. Reject packages that use undefined shell variables</a></span></dt>
! 111: <dt><span class="sect2"><a href="bulk.html#bulk.var.quiet">8.5.10. Turn off verbose logging</a></span></dt>
1.33 rillig 112: </dl></dd>
1.41 ! wiz 113: <dt><span class="sect1"><a href="bulk.html#creating-cdroms">8.6. Creating a multiple CD-ROM packages collection</a></span></dt>
! 114: <dd><dl><dt><span class="sect2"><a href="bulk.html#cdpack-example">8.6.1. Example of cdpack</a></span></dt></dl></dd>
1.32 rillig 115: </dl></dd>
116: <dt><span class="chapter"><a href="files.html">9. Directory layout of the installed files</a></span></dt>
117: <dd><dl>
118: <dt><span class="sect1"><a href="files.html#files.localbase">9.1. File system layout in <code class="literal">${LOCALBASE}</code></a></span></dt>
119: <dt><span class="sect1"><a href="files.html#files.varbase">9.2. File system layout in <code class="literal">${VARBASE}</code></a></span></dt>
120: </dl></dd>
121: <dt><span class="chapter"><a href="faq.html">10. Frequently Asked Questions</a></span></dt>
122: <dd><dl>
123: <dt><span class="sect1"><a href="faq.html#mailing-list-pointers">10.1. Are there any mailing lists for pkg-related discussion?</a></span></dt>
124: <dt><span class="sect1"><a href="faq.html#faq-pkgtools">10.2. Utilities for package management (pkgtools)</a></span></dt>
125: <dt><span class="sect1"><a href="faq.html#non-root-pkgsrc">10.3. How to use pkgsrc as non-root</a></span></dt>
126: <dt><span class="sect1"><a href="faq.html#resume-transfers">10.4. How to resume transfers when fetching distfiles?</a></span></dt>
127: <dt><span class="sect1"><a href="faq.html#x.org-from-pkgsrc">10.5. How can I install/use modular X.org from pkgsrc?</a></span></dt>
128: <dt><span class="sect1"><a href="faq.html#fetch-behind-firewall">10.6. How to fetch files from behind a firewall</a></span></dt>
129: <dt><span class="sect1"><a href="faq.html#fetch-https">10.7. How to fetch files from HTTPS sites</a></span></dt>
130: <dt><span class="sect1"><a href="faq.html#passive-ftp">10.8. How do I tell <span class="command"><strong>make fetch</strong></span> to do passive FTP?</a></span></dt>
131: <dt><span class="sect1"><a href="faq.html#fetching-all-distfiles">10.9. How to fetch all distfiles at once</a></span></dt>
1.40 martin 132: <dt><span class="sect1"><a href="faq.html#tmac.andoc-missing">10.10. What does <span class="quote">“<span class="quote">Don't know how to make
133: /usr/share/tmac/tmac.andoc</span>”</span> mean?</a></span></dt>
134: <dt><span class="sect1"><a href="faq.html#bsd.own.mk-missing">10.11. What does <span class="quote">“<span class="quote">Could not find bsd.own.mk</span>”</span> mean?</a></span></dt>
1.38 nia 135: <dt><span class="sect1"><a href="faq.html#using-sudo-with-pkgsrc">10.12. Using 'sudo' or `priv` with pkgsrc</a></span></dt>
1.32 rillig 136: <dt><span class="sect1"><a href="faq.html#faq.conf">10.13. How do I change the location of configuration files?</a></span></dt>
137: <dt><span class="sect1"><a href="faq.html#audit-packages">10.14. Automated security checks</a></span></dt>
138: <dt><span class="sect1"><a href="faq.html#ufaq-cflags">10.15. Why do some packages ignore my <code class="varname">CFLAGS</code>?</a></span></dt>
139: <dt><span class="sect1"><a href="faq.html#ufaq-fail">10.16. A package does not build. What shall I do?</a></span></dt>
1.40 martin 140: <dt><span class="sect1"><a href="faq.html#faq.rcs-conflicts">10.17. What does <span class="quote">“<span class="quote">Makefile appears to contain unresolved cvs/rcs/??? merge conflicts</span>”</span> mean?</a></span></dt>
1.1 dsieger 141: </dl></dd>
142: </dl>
143: </div>
144: </div>
145: <div class="navfooter">
146: <hr>
147: <table width="100%" summary="Navigation footer">
148: <tr>
149: <td width="40%" align="left">
1.40 martin 150: <a accesskey="p" href="introduction.html">Prev</a> </td>
151: <td width="20%" align="center"> </td>
152: <td width="40%" align="right"> <a accesskey="n" href="help-user.html">Next</a>
1.1 dsieger 153: </td>
154: </tr>
155: <tr>
1.40 martin 156: <td width="40%" align="left" valign="top">Chapter 1. What is pkgsrc? </td>
1.1 dsieger 157: <td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td>
1.40 martin 158: <td width="40%" align="right" valign="top"> Chapter 2. Getting help</td>
1.1 dsieger 159: </tr>
160: </table>
161: </div>
162: </body>
163: </html>
CVSweb <webmaster@jp.NetBSD.org>