APT-CDROM(M)                                         APT-CDROM(M)



NAME
       apt-cdrom - APT CDROM managment utility

SYNOPSIS
       apt-cdrom  [  -hvrmfan  ]   [  -d=cdrom  mount  point ]  [
       -o=config string ]  [ -c=file ]   [ add ]  [ ident ]

DESCRIPTION
       apt-cdrom is used to add a  new  CDROM  to  APTs  list  of
       available sources. 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.

       It  is  necessary  to  use 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.

       Unless the -h, or --help option is given one of  the  com-
       mands below must be present.

       add    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  .disk/ directory you will be prompted for a
              descriptive title.

              APT uses a CDROM ID to track  which  disc  is  cur-
              rently  in  the  drive  and maintains a database of
              these IDs in /var/lib/apt/cdroms.list

       ident  A debugging tool to report the identity of the cur-
              rent disc as well as the stored file name


OPTIONS
       All  command  line options may be set using the configura-
       tion file, the  descriptions  indicate  the  configuration
       option  to  set.  For boolean options you can override the
       config file by using something like -f-,--no-f,  -f=no  or
       several other variations.

       -d

       --cdrom
              Mount  point;  specify  the  location  to mount the
              cdrom.  This  mount  point  must   be   listed   in
              /etc/fstab  and  propely configured.  Configuration
              Item: Acquire::cdrom::mount.

       -r

       --rename
              Rename a disc; change the label of a disk or  over-
              ride  the disks given label. This option will cause
              apt-cdrom to prompt for a new label.  Configuration
              Item: APT::CDROM::Rename.

       -m

       --no-mount
              No  mounting;  prevent  apt-cdrom from mounting and
              unmounting the mount  point.   Configuration  Item:
              APT::CDROM::NoMount.

       -f

       --fast Fast  Copy;  Assume the package files are valid and
              do not check every package. This option  should  be
              used  only  if  apt-cdrom has been run on this disc
              before and did not detect any  errors.   Configura-
              tion Item: APT::CDROM::Fast.

       -a

       --thorough
              Thorough  Package  Scan;  This option may be needed
              with some old Debian 1.1/1.2 discs that have  Pack-
              age  files  in strange places. It takes much longer
              to scan the CD but will pick them all up.

       -n

       --just-print

       --recon

       --no-act
              No Changes; Do not change the sources.list(t)  file
              and  do  not write index files. Everything is still
              checked     however.       Configuration      Item:
              APT::CDROM::NoAct.

       -h

       --help Show a short usage summary.

       -v

       --version
              Show the program verison.

       -c

       --config-file
              Configuration File; Specify a configuration file to
              use.  The program will read the default  configura-
              tion  file  and  then  this configuration file. See
              apt.conf(f) for syntax information.

       -o

       --option
              Set  a  Configuration  Option;  This  will  set  an
              arbitary  configuration  option.  The  syntax is -o
              Foo::Bar=bar.

SEE ALSO
       apt.conf(f), apt-get(t), sources.list(t)

DIAGNOSTICS
       apt-cdrom returns zero on normal operation, decimal 100 on
       error.

BUGS
       See the APT bug page <URL:http://bugs.debian.org/apt>.  If
       you  wish  to  report   a   bug   in   APT,   please   see
       /usr/share/doc/debian/bug-reporting.txt or the bug(g) com-
       mand.

AUTHOR
       APT was written by the APT team <apt@packages.debian.org>.



                          12 March 2001              APT-CDROM(M)