Annotation of htdocs/docs/pkgsrc/users-guide.html, revision 1.3

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.3     ! rillig     86: <dt><span class="sect1"><a href="configuring.html#variables-affecting-installation">5.3. Variables affecting the installion process</a></span></dt>
        !            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>
                    100: <dt><span class="sect1"><a href="binary.html#bulkbuild">6.3. Doing a bulk build of all packages</a></span></dt>
                    101: <dd><dl>
                    102: <dt><span class="sect2"><a href="binary.html#binary.configuration">6.3.1. Configuration</a></span></dt>
                    103: <dt><span class="sect2"><a href="binary.html#other-environmental-considerations">6.3.2. Other environmental considerations</a></span></dt>
                    104: <dt><span class="sect2"><a href="binary.html#operation">6.3.3. Operation</a></span></dt>
                    105: <dt><span class="sect2"><a href="binary.html#what-it-does">6.3.4. What it does</a></span></dt>
                    106: <dt><span class="sect2"><a href="binary.html#disk-space-requirements">6.3.5. Disk space requirements</a></span></dt>
                    107: <dt><span class="sect2"><a href="binary.html#setting-up-a-sandbox">6.3.6. Setting up a sandbox for chrooted builds</a></span></dt>
                    108: <dt><span class="sect2"><a href="binary.html#building-a-partial-set">6.3.7. Building a partial set of packages</a></span></dt>
                    109: <dt><span class="sect2"><a href="binary.html#bulk-upload">6.3.8. Uploading results of a bulk build</a></span></dt>
                    110: </dl></dd>
                    111: <dt><span class="sect1"><a href="binary.html#creating-cdroms">6.4. Creating a multiple CD-ROM packages collection</a></span></dt>
                    112: <dd><dl><dt><span class="sect2"><a href="binary.html#cdpack-example">6.4.1. Example of cdpack</a></span></dt></dl></dd>
                    113: </dl></dd>
                    114: <dt><span class="chapter"><a href="files.html">7. Directory layout of the installed files</a></span></dt>
                    115: <dd><dl>
                    116: <dt><span class="sect1"><a href="files.html#files.localbase">7.1. File system layout in <code class="literal">${LOCALBASE}</code></a></span></dt>
                    117: <dt><span class="sect1"><a href="files.html#files.varbase">7.2. File system layout in <code class="literal">${VARBASE}</code></a></span></dt>
                    118: </dl></dd>
                    119: <dt><span class="chapter"><a href="faq.html">8. Frequently Asked Questions</a></span></dt>
                    120: <dd><dl>
                    121: <dt><span class="sect1"><a href="faq.html#mailing-list-pointers">8.1. Are there any mailing lists for pkg-related discussion?</a></span></dt>
                    122: <dt><span class="sect1"><a href="faq.html#pkgviews-docs">8.2. Where's the pkgviews documentation?</a></span></dt>
                    123: <dt><span class="sect1"><a href="faq.html#faq-pkgtools">8.3. Utilities for package management (pkgtools)</a></span></dt>
                    124: <dt><span class="sect1"><a href="faq.html#non-root-pkgsrc">8.4. How to use pkgsrc as non-root</a></span></dt>
                    125: <dt><span class="sect1"><a href="faq.html#resume-transfers">8.5. How to resume transfers when fetching distfiles?</a></span></dt>
1.3     ! rillig    126: <dt><span class="sect1"><a href="faq.html#x.org-from-pkgsrc">8.6. How can I install/use modular X.org from pkgsrc?</a></span></dt>
        !           127: <dt><span class="sect1"><a href="faq.html#fetch-behind-firewall">8.7. How to fetch files from behind a firewall</a></span></dt>
        !           128: <dt><span class="sect1"><a href="faq.html#passive-ftp">8.8. How do I tell <span><strong class="command">make fetch</strong></span> to do passive FTP?</a></span></dt>
        !           129: <dt><span class="sect1"><a href="faq.html#fetching-all-distfiles">8.9. How to fetch all distfiles at once</a></span></dt>
        !           130: <dt><span class="sect1"><a href="faq.html#tmac.andoc-missing">8.10. What does &#8220;<span class="quote">Don't know how to make
1.1       dsieger   131: /usr/share/tmac/tmac.andoc</span>&#8221; mean?</a></span></dt>
1.3     ! rillig    132: <dt><span class="sect1"><a href="faq.html#bsd.own.mk-missing">8.11. What does &#8220;<span class="quote">Could not find bsd.own.mk</span>&#8221; mean?</a></span></dt>
        !           133: <dt><span class="sect1"><a href="faq.html#using-sudo-with-pkgsrc">8.12. Using 'sudo' with pkgsrc</a></span></dt>
        !           134: <dt><span class="sect1"><a href="faq.html#faq.conf">8.13. How do I change the location of configuration files?</a></span></dt>
        !           135: <dt><span class="sect1"><a href="faq.html#audit-packages">8.14. Automated security checks</a></span></dt>
        !           136: <dt><span class="sect1"><a href="faq.html#ufaq-cflags">8.15. Why do some packages ignore my <code class="varname">CFLAGS</code>?</a></span></dt>
        !           137: <dt><span class="sect1"><a href="faq.html#ufaq-fail">8.16. A package does not build.  What shall I do?</a></span></dt>
        !           138: <dt><span class="sect1"><a href="faq.html#faq.rcs-conflicts">8.17. What does &#8220;<span class="quote">Makefile appears to contain unresolved cvs/rcs/??? merge conflicts</span>&#8221; mean?</a></span></dt>
1.1       dsieger   139: </dl></dd>
                    140: </dl>
                    141: </div>
                    142: </div>
                    143: <div class="navfooter">
                    144: <hr>
                    145: <table width="100%" summary="Navigation footer">
                    146: <tr>
                    147: <td width="40%" align="left">
                    148: <a accesskey="p" href="introduction.html">Prev</a> </td>
                    149: <td width="20%" align="center"> </td>
                    150: <td width="40%" align="right"> <a accesskey="n" href="getting.html">Next</a>
                    151: </td>
                    152: </tr>
                    153: <tr>
                    154: <td width="40%" align="left" valign="top">Chapter 1. What is pkgsrc? </td>
                    155: <td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td>
                    156: <td width="40%" align="right" valign="top"> Chapter 2. Where to get pkgsrc and how to keep it up-to-date</td>
                    157: </tr>
                    158: </table>
                    159: </div>
                    160: </body>
                    161: </html>

CVSweb <webmaster@jp.NetBSD.org>