Merge pull request #3 from cbaines/debian/sid

[apt.git] / doc / apt-cdrom.8.xml

<?xml version="1.0" encoding="utf-8" standalone="no"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
  "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [

<!ENTITY % aptent SYSTEM "apt.ent">
%aptent;

<!ENTITY % aptverbatiment SYSTEM "apt-verbatim.ent">
%aptverbatiment;

]>

<refentry>

 <refentryinfo>
   &apt-author.jgunthorpe;
   &apt-author.team;
   &apt-email;
   &apt-product;
   <date>2012-06-09T00:00:00Z</date>
 </refentryinfo>

 <refmeta>
   <refentrytitle>apt-cdrom</refentrytitle>
   <manvolnum>8</manvolnum>
   <refmiscinfo class="manual">APT</refmiscinfo>
 </refmeta>
 
 <!-- Man page title -->
 <refnamediv>
    <refname>apt-cdrom</refname>
    <refpurpose>APT CD-ROM management utility</refpurpose>
 </refnamediv>

 &synopsis-command-apt-cdrom;

 <refsect1><title>Description</title>
   <para><command>apt-cdrom</command> is used to add a new CD-ROM to APT's list
    of available sources. <command>apt-cdrom</command> takes care of
   determining the structure of
   the disc as well as correcting for several possible mis-burns and 
   verifying the index files.   
   </para>

   <para>It is necessary to use <command>apt-cdrom</command> to add CDs to the
   APT system;
   it cannot be done by hand. Furthermore each disc in a multi-CD set must be
   inserted and scanned separately to account for possible mis-burns.
   </para>

   <para>Unless the <option>-h</option>, or <option>--help</option> option is
   given, one of the commands below must be present.</para>

    <variablelist>
     <varlistentry><term><option>add</option></term>
     <listitem><para><literal>add</literal> is used to add a new disc to the
     source list. It will unmount the
     CD-ROM device, prompt for a disc to be inserted and then proceed to 
     scan it and copy the index files. If the disc does not have a proper
     <filename>.disk</filename> directory you will be prompted for a descriptive 
     title.
     </para>

     <para>APT uses a CD-ROM ID to track which disc is currently in the drive and
     maintains a database of these IDs in 
     <filename>&statedir;/cdroms.list</filename>
     </para>
     </listitem>
     </varlistentry>
     
     <varlistentry><term><option>ident</option></term>
     <listitem><para>A debugging tool to report the identity of the current
      disc as well as the stored file name
     </para>
     </listitem>
     </varlistentry>
    </variablelist>
 </refsect1>

 <refsect1><title>Options</title>
   &apt-cmdblurb;
   
   <variablelist>
     <varlistentry><term><option>--no-auto-detect</option></term><term><option>--cdrom</option></term>
     <listitem><para>Do not try to auto-detect the CD-ROM path. Usually combined with the <option>--cdrom</option> option.
      Configuration Item: <literal>Acquire::cdrom::AutoDetect</literal>.
     </para>
     </listitem>
     </varlistentry>
     

     <varlistentry><term><option>-d</option></term><term><option>--cdrom</option></term>
     <listitem><para>Mount point; specify the location to mount the CD-ROM. This
      mount point must be listed in <filename>/etc/fstab</filename> and
      properly configured.
      Configuration Item: <literal>Acquire::cdrom::mount</literal>.
     </para>
     </listitem>
     </varlistentry>
     
     <varlistentry><term><option>-r</option></term><term><option>--rename</option></term>
     <listitem><para>Rename a disc; change the label of a disc or override the
      disc's given label. This option will cause <command>apt-cdrom</command> to
      prompt for a new label.
     Configuration Item: <literal>APT::CDROM::Rename</literal>.
     </para>
     </listitem>
     </varlistentry>
     
     <varlistentry><term><option>-m</option></term><term><option>--no-mount</option></term>
     <listitem><para>No mounting; prevent <command>apt-cdrom</command> from
      mounting and unmounting the mount point.
     Configuration Item: <literal>APT::CDROM::NoMount</literal>.
     </para>
     </listitem>
     </varlistentry>
     
     <varlistentry><term><option>-f</option></term><term><option>--fast</option></term>
     <listitem><para>Fast Copy; Assume the package files are valid and do not
      check every package. This option should be used only if
     <command>apt-cdrom</command> has been run on this disc before and did not
     detect any errors.
     Configuration Item: <literal>APT::CDROM::Fast</literal>.
     </para>
     </listitem>
     </varlistentry>

     <varlistentry><term><option>-a</option></term><term><option>--thorough</option></term>
     <listitem><para>Thorough Package Scan; This option may be needed with some
      old Debian 1.1/1.2 discs that have Package files in strange places. It 
      takes much longer to scan the CD but will pick them all up.
     </para>
     </listitem>
     </varlistentry>
     
     <varlistentry><term><option>-n</option></term>
                   <term><option>--just-print</option></term>
                   <term><option>--recon</option></term>
                   <term><option>--no-act</option></term>
     <listitem><para>No Changes; Do not change the &sources-list; file and do
     not write index files. Everything is still checked however.
     Configuration Item: <literal>APT::CDROM::NoAct</literal>.
     </para>
     </listitem>
     </varlistentry> 

     &apt-commonoptions;

   </variablelist>
 </refsect1>

 <refsect1><title>See Also</title>
   <para>&apt-conf;, &apt-get;, &sources-list;
   </para>
 </refsect1>

 <refsect1><title>Diagnostics</title>
   <para><command>apt-cdrom</command> returns zero on normal operation, decimal 100 on error.
   </para>
 </refsect1>

 &manbugs;

</refentry>