apt-cdrom(8)

1APT-CDROM(8)                       apt-cdrom                      APT-CDROM(8)
2
3
4

NAME

6       apt-cdrom - APT CDROM management utility
7
8

SYNOPSIS

10       apt-cdrom  [options] [-d=mount_point] [-o config=string] [-c=file] com‐
11       mand
12
13

DESCRIPTION

15       apt-cdrom is used to add  a  new  CDROM  to  APT's  list  of  available
16       sources.  apt-cdrom takes care of determining the structure of the disc
17       as well as correcting for several possible mis-burns and verifying  the
18       index files.
19
20       It  is necessary to use apt-cdrom to add CDs to the APT system; it can‐
21       not be done by hand.  Furthermore each disk in a multi-CD set  must  be
22       inserted and scanned separately to account for possible mis-burns.
23
24

COMMANDS

26       Unless the -h, or --help option is given one of the commands below must
27       be present.
28
29
30       add    Used to add a new disc to the source list.  It will unmount  the
31              CDROM  device, prompt for a disk to be inserted and then proceed
32              to scan it and copy the index files.  If the disc does not  have
33              a proper .disk/ directory you will be prompted for a descriptive
34              title.
35
36              APT uses a CDROM ID to track which  disc  is  currently  in  the
37              drive    and    maintains   a   database   of   these   IDs   in
38              /var/lib/apt/cdroms.list.
39
40
41       ident  A debugging tool to report the identity of the current  disc  as
42              well as the stored file name.
43
44

OPTIONS

46       All  command-line  options may be set using the configuration file, the
47       descriptions indicate the configuration option  to  set.   For  boolean
48       options  you  can  override  the  config  file  by using something like
49       -f-,--no-f, -f=no or several other variations.
50
51
52       -d, --cdrom
53              Mount point.  Specify the location to  mount  the  cdrom.   This
54              mount  point  must  be listed in /etc/fstab and properly config‐
55              ured.
56
57              Configuration Item: Acquire::cdrom::mount.
58
59
60       -r, --rename
61              Rename a disc.  Change the label  of  a  disk  or  override  the
62              disk's  given label.  This option will cause apt-cdrom to prompt
63              for a new label.
64
65              Configuration Item: APT::CDROM::Rename.
66
67
68       -m, --no-mount
69              No mounting.  Prevent apt-cdrom from mounting and unmounting the
70              mount point.
71
72              Configuration Item: APT::CDROM::NoMount.
73
74
75       -f, --fast
76              Fast  Copy.  Assume the package files are valid and do not check
77              every package.  This option should be used only if apt-cdrom has
78              been run on this disc before and did not detect any errors.
79
80              Configuration Item: APT::CDROM::Fast.
81
82
83       -a, --thorough
84              Thorough  Package Scan.  This option may be needed with some old
85              discs that have Package files in strange places.  It takes  much
86              longer to scan the CD but will pick them all up.
87
88
89       -n, --just-print, --recon, --no-act
90              No  Changes.   Do not change the sources.list(5) file and do not
91              write index files.  Everything is still checked however.
92
93              Configuration Item: APT::CDROM::NoAct.
94
95
96       -h, --help
97              Show a short usage summary.
98
99
100       -v, --version
101              Show the program version.
102
103
104       -c, --config-file
105              Configuration File.  Specify a configuration file  to  use.  The
106              program  will  read the default configuration file and then this
107              configuration file.  See apt.conf(5) for syntax information.
108
109
110       -o, --option
111              Set a Configuration Option.  This will set an arbitrary configu‐
112              ration option.  The syntax is -o Foo::Bar=bar.
113
114

DIAGNOSTICS

120       apt-cdrom returns zero on normal operation, decimal 100 on error.
121
122

BUGS

124       Reporting  bugs  in  APT-RPM is best done in the APT-RPM mailinglist at
125       http://apt-rpm.org/mailinglist.shtml.
126
127

AUTHOR

129       Maintainer and contributor information can be found in the credits page
130       http://apt-rpm.org/about.shtml of APT-RPM.
131
132
133
134APT-RPM                           14 Jun 2006                     APT-CDROM(8)