doc/apt-cdrom.8.xml

   1 <?xml version="1.0" encoding="utf-8" standalone="no"?>
   2 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
   3   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
   4
   5 <!ENTITY % aptent SYSTEM "apt.ent">
   6 %aptent;
   7
   8 <!ENTITY % aptverbatiment SYSTEM "apt-verbatim.ent">
   9 %aptverbatiment;
  10
  11 ]>
  12
  13 <refentry>
  14
  15  <refentryinfo>
  16    &apt-author.jgunthorpe;
  17    &apt-author.team;
  18    &apt-email;
  19    &apt-product;
  20    <date>2012-06-09T00:00:00Z</date>
  21  </refentryinfo>
  22
  23  <refmeta>
  24    <refentrytitle>apt-cdrom</refentrytitle>
  25    <manvolnum>8</manvolnum>
  26    <refmiscinfo class="manual">APT</refmiscinfo>
  27  </refmeta>
  28
  29  <!-- Man page title -->
  30  <refnamediv>
  31     <refname>apt-cdrom</refname>
  32     <refpurpose>APT CD-ROM management utility</refpurpose>
  33  </refnamediv>
  34
  35  &synopsis-command-apt-cdrom;
  36
  37  <refsect1><title>Description</title>
  38    <para><command>apt-cdrom</command> is used to add a new CD-ROM to APT's list
  39     of available sources. <command>apt-cdrom</command> takes care of
  40    determining the structure of
  41    the disc as well as correcting for several possible mis-burns and
  42    verifying the index files.
  43    </para>
  44
  45    <para>It is necessary to use <command>apt-cdrom</command> to add CDs to the
  46    APT system;
  47    it cannot be done by hand. Furthermore each disc in a multi-CD set must be
  48    inserted and scanned separately to account for possible mis-burns.
  49    </para>
  50
  51    <para>Unless the <option>-h</option>, or <option>--help</option> option is
  52    given, one of the commands below must be present.</para>
  53
  54     <variablelist>
  55      <varlistentry><term><option>add</option></term>
  56      <listitem><para><literal>add</literal> is used to add a new disc to the
  57      source list. It will unmount the
  58      CD-ROM device, prompt for a disc to be inserted and then proceed to
  59      scan it and copy the index files. If the disc does not have a proper
  60      <filename>.disk</filename> directory you will be prompted for a descriptive
  61      title.
  62      </para>
  63
  64      <para>APT uses a CD-ROM ID to track which disc is currently in the drive and
  65      maintains a database of these IDs in
  66      <filename>&statedir;/cdroms.list</filename>
  67      </para>
  68      </listitem>
  69      </varlistentry>
  70
  71      <varlistentry><term><option>ident</option></term>
  72      <listitem><para>A debugging tool to report the identity of the current
  73       disc as well as the stored file name
  74      </para>
  75      </listitem>
  76      </varlistentry>
  77     </variablelist>
  78  </refsect1>
  79
  80  <refsect1><title>Options</title>
  81    &apt-cmdblurb;
  82
  83    <variablelist>
  84      <varlistentry><term><option>--no-auto-detect</option></term><term><option>--cdrom</option></term>
  85      <listitem><para>Do not try to auto-detect the CD-ROM path. Usually combined with the <option>--cdrom</option> option.
  86       Configuration Item: <literal>Acquire::cdrom::AutoDetect</literal>.
  87      </para>
  88      </listitem>
  89      </varlistentry>
  90
  91
  92      <varlistentry><term><option>-d</option></term><term><option>--cdrom</option></term>
  93      <listitem><para>Mount point; specify the location to mount the CD-ROM. This
  94       mount point must be listed in <filename>/etc/fstab</filename> and
  95       properly configured.
  96       Configuration Item: <literal>Acquire::cdrom::mount</literal>.
  97      </para>
  98      </listitem>
  99      </varlistentry>
 100
 101      <varlistentry><term><option>-r</option></term><term><option>--rename</option></term>
 102      <listitem><para>Rename a disc; change the label of a disc or override the
 103       disc's given label. This option will cause <command>apt-cdrom</command> to
 104       prompt for a new label.
 105      Configuration Item: <literal>APT::CDROM::Rename</literal>.
 106      </para>
 107      </listitem>
 108      </varlistentry>
 109
 110      <varlistentry><term><option>-m</option></term><term><option>--no-mount</option></term>
 111      <listitem><para>No mounting; prevent <command>apt-cdrom</command> from
 112       mounting and unmounting the mount point.
 113      Configuration Item: <literal>APT::CDROM::NoMount</literal>.
 114      </para>
 115      </listitem>
 116      </varlistentry>
 117
 118      <varlistentry><term><option>-f</option></term><term><option>--fast</option></term>
 119      <listitem><para>Fast Copy; Assume the package files are valid and do not
 120       check every package. This option should be used only if
 121      <command>apt-cdrom</command> has been run on this disc before and did not
 122      detect any errors.
 123      Configuration Item: <literal>APT::CDROM::Fast</literal>.
 124      </para>
 125      </listitem>
 126      </varlistentry>
 127
 128      <varlistentry><term><option>-a</option></term><term><option>--thorough</option></term>
 129      <listitem><para>Thorough Package Scan; This option may be needed with some
 130       old Debian 1.1/1.2 discs that have Package files in strange places. It
 131       takes much longer to scan the CD but will pick them all up.
 132      </para>
 133      </listitem>
 134      </varlistentry>
 135
 136      <varlistentry><term><option>-n</option></term>
 137                    <term><option>--just-print</option></term>
 138                    <term><option>--recon</option></term>
 139                    <term><option>--no-act</option></term>
 140      <listitem><para>No Changes; Do not change the &sources-list; file and do
 141      not write index files. Everything is still checked however.
 142      Configuration Item: <literal>APT::CDROM::NoAct</literal>.
 143      </para>
 144      </listitem>
 145      </varlistentry>
 146
 147      &apt-commonoptions;
 148
 149    </variablelist>
 150  </refsect1>
 151
 152  <refsect1><title>See Also</title>
 153    <para>&apt-conf;, &apt-get;, &sources-list;
 154    </para>
 155  </refsect1>
 156
 157  <refsect1><title>Diagnostics</title>
 158    <para><command>apt-cdrom</command> returns zero on normal operation, decimal 100 on error.
 159    </para>
 160  </refsect1>
 161
 162  &manbugs;
 163
 164 </refentry>
 165