diff options
Diffstat (limited to 'doc/apt-cdrom.8.sgml')
-rw-r--r-- | doc/apt-cdrom.8.sgml | 147 |
1 files changed, 0 insertions, 147 deletions
diff --git a/doc/apt-cdrom.8.sgml b/doc/apt-cdrom.8.sgml deleted file mode 100644 index 468146ca7..000000000 --- a/doc/apt-cdrom.8.sgml +++ /dev/null @@ -1,147 +0,0 @@ -<!-- -*- 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 management 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 properly 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> - |