You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 

162 lines
5.6 KiB

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