yum-software-management/en_US customizing-yum.xml,1.3,1.4

[Jared Smith (jsmith)]

Author: jsmith

Update of /cvs/docs/yum-software-management/en_US
In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv6418

Modified Files:
	customizing-yum.xml 
Log Message:
Add the section for the yum-security plugin, and comment out the section for
the downloadonly plugin, as it's not currently documented



Index: customizing-yum.xml
===================================================================
RCS file: /cvs/docs/yum-software-management/en_US/customizing-yum.xml,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- customizing-yum.xml	24 Jan 2008 03:18:03 -0000	1.3
+++ customizing-yum.xml	24 Jan 2008 15:16:01 -0000	1.4
@@ -190,12 +190,66 @@
         <para>You can configure various settings of this plugin in the file
         <filename>/etc/yum/pluginconf.d/fastestmirror.conf</filename></para>
       </section>
+      <section>
+        <title>Security Plugin</title>
+        <para>This plugin extends yum to allow lists and updates to be limited
+        using security relevant criteria. This may be important to you if you
+        are using Fedora in a production mode and you don't want to break your
+        software with an untested upgrade.</para>
+        <para>For installing it, use the following command
+        <command>su -c 'yum install yum-security'</command>
+        or from
+        the<guimenu>Applications</guimenu> menu select
+        <guimenuitem>Add/Remove Software</guimenuitem> 
+        </para>
+        <para>There are two yum commands that are used with this plugin:</para>
+        <itemizedlist>
+          <listitem><para>info-sec</para></listitem>
+          <listitem><para>list-sec</para></listitem>
+        </itemizedlist>
+        <para>Both of these commands take these sub-commands:</para>
+        <itemizedlist>
+          <listitem>
+            <para>&lt;advisory&gt; [advisory...]</para>
+          </listitem>
+          <listitem><para>bugzillas</para></listitem>
+          <listitem><para>cves</para></listitem>
+          <listitem><para>security</para></listitem>
+        </itemizedlist>
+        <section>
+          <title>Examples</title>
+          <para>To list all updates that are security relevant, and get a
+          return code on whether there are security updates use:</para>
+          <para>
+            <command>su -c 'yum --security check-update'</command>
+          </para>
+          <para>To apply updates that are security relevant use:</para>
+          <para>
+            <command>su -c 'yum --security update'</command>
+          </para>
+          <para>To get a list of all BZs that are fixed for packages you have
+          installed use:</para>
+          <para>
+            <command>su -c 'yum list-sec bugzillas'</command>
+          </para>
+          <para>To get the information on advisory FEDORA-2707-4567 use:</para>
+          <para>
+            <command>su -c 'yum info-sec FEDORA-2707-4567'</command>
+          </para>
+          <para>For additional information, view the man page:</para>
+          <para>
+            <command>man yum-security</command>
+          </para>
+        </section>
+      </section>
+      <!--
       <section id="sn-YumPluginDownloadonly">
         <title>Downloadonly Plugin</title>
         <para>FIXME: Figure out how plugin works and document
         that.</para>
         <para />
       </section>
+      -->
       <section id="sn-YumPluginChangelog">
         <title>Changelog Plugin</title>
         <para>When Fedora developers provide a update to a existing
@@ -204,7 +258,7 @@
         package changelog before doing a update. This plugin is not
         installed by default. For installing it, use the following
         command or from the <guimenu>Applications
-        </guimenu>menu use<guimenuitem>Add/Remove
+        </guimenu> menu use <guimenuitem>Add/Remove
         Software"</guimenuitem>.</para>
         <para><command>su -c 'yum install
         yum-changelog'</command></para>