<!-- -*- mode: sgml; mode: fold -*- --> <!doctype refentry PUBLIC "-//OASIS//DTD DocBook V3.1//EN" [ <!ENTITY % aptent SYSTEM "apt.ent"> %aptent; ]> <refentry> &apt-docinfo; <refmeta> <refentrytitle>apt-cdrom</> <manvolnum>8</> </refmeta> <!-- Man page title --> <refnamediv> <refname>apt-cdrom</> <refpurpose>APT CDROM managment utility</> </refnamediv> <!-- Arguments --> <refsynopsisdiv> <cmdsynopsis> <command>apt-cdrom</> <arg><option>-hvrmfan</></arg> <arg><option>-d=<replaceable/cdrom mount point/</></arg> <arg><option>-o=<replaceable/config string/</></arg> <arg><option>-c=<replaceable/file/</></arg> <group choice=req> <arg>add</> <arg>ident</> </group> </cmdsynopsis> </refsynopsisdiv> <RefSect1><Title>Description</> <para> <command/apt-cdrom/ is used to add a new CDROM to APTs list of available sources. <command/apt-cdrom/ takes care of determining the structure of the disc as well as correcting for several possible mis-burns and verifying the index files. <para> It is necessary to use <command/apt-cdrom/ to add CDs to the APT system, it cannot be done by hand. Furthermore each disk in a multi-cd set must be inserted and scanned separately to account for possible mis-burns. <para> Unless the <option/-h/, or <option/--help/ option is given one of the commands below must be present. <VariableList> <VarListEntry><Term>add</Term> <ListItem><Para> <literal/add/ is used to add a new disc to the source list. It will unmount the CDROM device, prompt for a disk to be inserted and then procceed to scan it and copy the index files. If the disc does not have a proper <filename>.disk/</> directory you will be prompted for a descriptive title. <para> APT uses a CDROM ID to track which disc is currently in the drive and maintains a database of these IDs in <filename>&statedir;/cdroms.list</> </VarListEntry> <VarListEntry><Term>ident</Term> <ListItem><Para> A debugging tool to report the identity of the current disc as well as the stored file name </VarListEntry> </VariableList> </RefSect1> <RefSect1><Title>Options</> &apt-cmdblurb; <VariableList> <VarListEntry><term><option/-d/</><term><option/--cdrom/</> <ListItem><Para> Mount point; specify the location to mount the cdrom. This mount point must be listed in <filename>/etc/fstab</> and propely configured. Configuration Item: <literal/Acquire::cdrom::mount/. </VarListEntry> <VarListEntry><term><option/-r/</><term><option/--rename/</> <ListItem><Para> Rename a disc; change the label of a disk or override the disks given label. This option will cause <command/apt-cdrom/ to prompt for a new label. Configuration Item: <literal/APT::CDROM::Rename/. </VarListEntry> <VarListEntry><term><option/-m/</><term><option/--no-mount/</> <ListItem><Para> No mounting; prevent <command/apt-cdrom/ from mounting and unmounting the mount point. Configuration Item: <literal/APT::CDROM::NoMount/. </VarListEntry> <VarListEntry><term><option/-f/</><term><option/--fast/</> <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/ has been run on this disc before and did not detect any errors. Configuration Item: <literal/APT::CDROM::Fast/. </VarListEntry> <VarListEntry><term><option/-a/</><term><option/--thorough/</> <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. </VarListEntry> <VarListEntry><term><option/-n/</> <term><option/--just-print/</> <term><option/--recon/</> <term><option/--no-act/</> <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/. </VarListEntry> &apt-commonoptions; </VariableList> </RefSect1> <RefSect1><Title>See Also</> <para> &apt-conf;, &apt-get;, &sources-list; </RefSect1> <RefSect1><Title>Diagnostics</> <para> <command/apt-cdrom/ returns zero on normal operation, decimal 100 on error. </RefSect1> &manbugs; &manauthor; </refentry>