svn commit: r40010 - projects/pkgng/en_US.ISO8859-1/books/handbook/ports

[Glen Barber]

Author: gjb
Date: Thu Nov 15 20:54:04 2012
New Revision: 40010
URL: http://svnweb.freebsd.org/changeset/doc/40010

Log:
  Document pkg-audit.

Modified:
  projects/pkgng/en_US.ISO8859-1/books/handbook/ports/chapter.xml

Modified: projects/pkgng/en_US.ISO8859-1/books/handbook/ports/chapter.xml
==============================================================================
--- projects/pkgng/en_US.ISO8859-1/books/handbook/ports/chapter.xml	Thu Nov 15 20:54:02 2012	(r40009)
+++ projects/pkgng/en_US.ISO8859-1/books/handbook/ports/chapter.xml	Thu Nov 15 20:54:04 2012	(r40010)
@@ -874,8 +874,23 @@ curl-7.24.0_1.txz    100% 1108KB   
 Checking integrity... done
 Upgrading curl from 7.24.0 to 7.24.0_1... done</screen>
 
-	<para><!-- pkg audit --></para>
-      </sect3>
+	<para>Occasionally, software vulnerabilities may be discovered
+	  in software within the Ports Collection.
+	  <application>pkgng</application> includes built-in auditing,
+	  similar to the <filename
+	    role="package">ports-mgmt/portaudit</filename> package.
+	  To audit the software installed on the system, run:</para>
+
+	<screen>&prompt.root; <userinput>pkg audit</userinput></screen>
+
+	<tip>
+	  <para>If running <command>pkg audit</command> for the first
+	    time, the audit database file must be downloaded.  Run
+	    <command>pkg audit -F</command> to fetch the audit
+	    database file.</para>
+	</tip>
+
+	</sect3>
     </sect2>
 
   </sect1><!-- PKGNG -->