Tue Mar 4 02:39:37 2008 UTC ()
audit-packages is now part of pkg_install, so update docs accordingly


(jschauma)
diff -r1.39 -r1.40 pkgsrc/doc/guide/files/faq.xml
diff -r1.34 -r1.35 pkgsrc/doc/guide/files/using.xml

cvs diff -r1.39 -r1.40 pkgsrc/doc/guide/files/faq.xml (expand / switch to unified diff)

--- pkgsrc/doc/guide/files/faq.xml 2008/01/04 15:53:41 1.39
+++ pkgsrc/doc/guide/files/faq.xml 2008/03/04 02:39:37 1.40
@@ -1,14 +1,14 @@ @@ -1,14 +1,14 @@
1<!-- $NetBSD: faq.xml,v 1.39 2008/01/04 15:53:41 rillig Exp $ --> 1<!-- $NetBSD: faq.xml,v 1.40 2008/03/04 02:39:37 jschauma Exp $ -->
2 2
3<chapter id="faq"> <?dbhtml filename="faq.html"?> 3<chapter id="faq"> <?dbhtml filename="faq.html"?>
4<title>Frequently Asked Questions</title> 4<title>Frequently Asked Questions</title>
5 5
6<para>This section contains hints, tips &amp; tricks on special things in 6<para>This section contains hints, tips &amp; tricks on special things in
7pkgsrc that we didn't find a better place for in the previous chapters, and 7pkgsrc that we didn't find a better place for in the previous chapters, and
8it contains items for both pkgsrc users and developers.</para> 8it contains items for both pkgsrc users and developers.</para>
9 9
10<!-- ================================================================== --> 10<!-- ================================================================== -->
11 11
12 <sect1 id="mailing-list-pointers"> 12 <sect1 id="mailing-list-pointers">
13 <title>Are there any mailing lists for pkg-related discussion?</title> 13 <title>Are there any mailing lists for pkg-related discussion?</title>
14 14
@@ -499,57 +499,55 @@ reinstall any affected packages. @@ -499,57 +499,55 @@ reinstall any affected packages.
499</sect1> 499</sect1>
500 500
501<!-- ================================================================== --> 501<!-- ================================================================== -->
502 502
503<sect1 id="audit-packages"> 503<sect1 id="audit-packages">
504<title>Automated security checks</title> 504<title>Automated security checks</title>
505 505
506<para>Please be aware that there can often be bugs in third-party software, 506<para>Please be aware that there can often be bugs in third-party software,
507and some of these bugs can leave a machine vulnerable to exploitation by 507and some of these bugs can leave a machine vulnerable to exploitation by
508attackers. In an effort to lessen the exposure, the NetBSD packages team 508attackers. In an effort to lessen the exposure, the NetBSD packages team
509maintains a database of known-exploits to packages which have at one time 509maintains a database of known-exploits to packages which have at one time
510been included in pkgsrc. The database can be downloaded automatically, and 510been included in pkgsrc. The database can be downloaded automatically, and
511a security audit of all packages installed on a system can take place. To 511a security audit of all packages installed on a system can take place. To
512do this, install the <filename 512do this, refer to the following two tools (installed as part of the
513 role="pkg">security/audit-packages</filename> package. It has two 513<filename role="pkg">pkgtools/pkg_install</filename> package):</para>
514components:</para> 
515 514
516<orderedlist> 515<orderedlist>
517 516
518 <listitem> 517 <listitem>
519 <para><command>download-vulnerability-list</command>, an easy way to 518 <para><command>download-vulnerability-list</command>, an easy way to
520 download a list of the security vulnerabilities information. This list 519 download a list of the security vulnerabilities information. This list
521 is kept up to date by the NetBSD security officer and the NetBSD 520 is kept up to date by the NetBSD security officer and the NetBSD
522 packages team, and is distributed from the NetBSD ftp server:</para> 521 packages team, and is distributed from the NetBSD ftp server:</para>
523 522
524 <para><ulink 523 <para><ulink
525 url="ftp://ftp.NetBSD.org/pub/NetBSD/packages/distfiles/pkg-vulnerabilities"/></para> 524 url="ftp://ftp.NetBSD.org/pub/NetBSD/packages/distfiles/pkg-vulnerabilities"/></para>
526 </listitem> 525 </listitem>
527 526
528 <listitem> 527 <listitem>
529 <para><command>audit-packages</command>, an easy way to audit the 528 <para><command>audit-packages</command>, an easy way to audit the
530 current machine, checking each vulnerability which is known. If a 529 current machine, checking each vulnerability which is known. If a
531 vulnerable package is installed, it will be shown by output to stdout, 530 vulnerable package is installed, it will be shown by output to stdout,
532 including a description of the type of vulnerability, and a URL 531 including a description of the type of vulnerability, and a URL
533 containing more information.</para> 532 containing more information.</para>
534 </listitem> 533 </listitem>
535 534
536</orderedlist> 535</orderedlist>
537 536
538<para>Use of the <filename role="pkg">security/audit-packages</filename> 537<para>Use of these tools is strongly recommended! After
539package is strongly recommended! After 538<quote>pkg_install</quote> is installed, please read
540<quote>audit-packages</quote> is installed, please read 
541the package's message, which you can get by running <userinput>pkg_info -D 539the package's message, which you can get by running <userinput>pkg_info -D
542audit-packages</userinput>.</para> 540pkg_install</userinput>.</para>
543 541
544<para>If this package is installed, pkgsrc builds will use it to 542<para>If this package is installed, pkgsrc builds will use it to
545perform a security check before building any package. See <xref 543perform a security check before building any package. See <xref
546linkend="variables-affecting-build"/> for ways to control this 544linkend="variables-affecting-build"/> for ways to control this
547check.</para> 545check.</para>
548 546
549</sect1> 547</sect1>
550 548
551<sect1 id="ufaq-cflags"> 549<sect1 id="ufaq-cflags">
552<title>Why do some packages ignore my <varname>CFLAGS</varname>?</title> 550<title>Why do some packages ignore my <varname>CFLAGS</varname>?</title>
553 551
554 <para>When you add your own preferences to the 552 <para>When you add your own preferences to the
555 <varname>CFLAGS</varname> variable in your 553 <varname>CFLAGS</varname> variable in your

cvs diff -r1.34 -r1.35 pkgsrc/doc/guide/files/using.xml (expand / switch to unified diff)

--- pkgsrc/doc/guide/files/using.xml 2008/01/04 15:53:41 1.34
+++ pkgsrc/doc/guide/files/using.xml 2008/03/04 02:39:37 1.35
@@ -1,14 +1,14 @@ @@ -1,14 +1,14 @@
1<!-- $NetBSD: using.xml,v 1.34 2008/01/04 15:53:41 rillig Exp $ --> 1<!-- $NetBSD: using.xml,v 1.35 2008/03/04 02:39:37 jschauma Exp $ -->
2 2
3<chapter id="using"> <?dbhtml filename="using.html"?> 3<chapter id="using"> <?dbhtml filename="using.html"?>
4<title>Using pkgsrc</title> 4<title>Using pkgsrc</title>
5 5
6<para>Basically, there are two ways of using pkgsrc. The first 6<para>Basically, there are two ways of using pkgsrc. The first
7is to only install the package tools and to use binary packages 7is to only install the package tools and to use binary packages
8that someone else has prepared. This is the <quote>pkg</quote> 8that someone else has prepared. This is the <quote>pkg</quote>
9in pkgsrc. The second way is to install the <quote>src</quote> 9in pkgsrc. The second way is to install the <quote>src</quote>
10of pkgsrc, too. Then you are able to build your own packages, 10of pkgsrc, too. Then you are able to build your own packages,
11and you can still use binary packages from someone else.</para> 11and you can still use binary packages from someone else.</para>
12 12
13<sect1 id="using-pkg"> 13<sect1 id="using-pkg">
14 <title>Using binary packages</title> 14 <title>Using binary packages</title>
@@ -89,30 +89,29 @@ and you can still use binary packages fr @@ -89,30 +89,29 @@ and you can still use binary packages fr
89&rprompt; <userinput>pkg_add ap2-php5-*</userinput> 89&rprompt; <userinput>pkg_add ap2-php5-*</userinput>
90</screen> 90</screen>
91 91
92 <para>Note that any prerequisite packages needed to run the 92 <para>Note that any prerequisite packages needed to run the
93 package in question will be installed, too, assuming they are 93 package in question will be installed, too, assuming they are
94 present where you install from.</para> 94 present where you install from.</para>
95 95
96 <para>As mentioned above, packages for which vulnerabilities get 96 <para>As mentioned above, packages for which vulnerabilities get
97 known are not stored in the <filename>All</filename> subdirectory. 97 known are not stored in the <filename>All</filename> subdirectory.
98 They don't get deleted since that could be very frustrating if many 98 They don't get deleted since that could be very frustrating if many
99 other packages depend on it. Instead, they are moved to the 99 other packages depend on it. Instead, they are moved to the
100 <filename>vulnerable</filename> subdirectory. So you may need to add 100 <filename>vulnerable</filename> subdirectory. So you may need to add
101 this directory to the <varname>PKG_PATH</varname> variable.  101 this directory to the <varname>PKG_PATH</varname> variable.
102 However, you should run <filename 102 However, you should run <command>audit-packages</command>
103 role="pkg">security/audit-packages</filename> regularly, especially 103 regularly, especially after installing new packages, and verify
104 after installing new packages, and verify that the vulnerabilities 104 that the vulnerabilities are acceptable for your configuration.</para>
105 are acceptable for your configuration.</para> 
106 105
107 <para>After you've installed packages, be sure to have 106 <para>After you've installed packages, be sure to have
108 <filename>/usr/pkg/bin</filename> and <filename>/usr/pkg/sbin</filename> in your 107 <filename>/usr/pkg/bin</filename> and <filename>/usr/pkg/sbin</filename> in your
109 <varname>PATH</varname> so you can actually start the just 108 <varname>PATH</varname> so you can actually start the just
110 installed program.</para> 109 installed program.</para>
111 </sect2> 110 </sect2>
112 111
113 <sect2 id="using.pkg_delete"> 112 <sect2 id="using.pkg_delete">
114 <title>Deinstalling packages</title> 113 <title>Deinstalling packages</title>
115 114
116 <para>To deinstall a package, it does not matter whether it was 115 <para>To deinstall a package, it does not matter whether it was
117 installed from source code or from a binary package. The 116 installed from source code or from a binary package. The
118 <command>pkg_delete</command> command does not know it anyway. 117 <command>pkg_delete</command> command does not know it anyway.