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>