Differences between version 5 and predecessor to the previous major change of apt-cdrom(8).
Other diffs: Previous Revision, Previous Author, or view the Annotated Edit History
| Newer page: | version 5 | Last edited on Monday, July 14, 2003 3:55:19 pm | by CraigBox | Revert |
| Older page: | version 4 | Last edited on Tuesday, June 4, 2002 12:31:08 am | by perry | Revert |
@@ -1,209 +1,65 @@
-APT-CDROM
-!!APT-CDROM
-NAME
-SYNOPSIS
-DESCRIPTION
-OPTIONS
-SEE ALSO
-DIAGNOSTICS
-BUGS
-AUTHOR
-----
-!!NAME
-
+!Name
apt-cdrom - APT CDROM managment utility
-!!SYNOPSIS
+!Synopsis
-__apt-cdrom__ [[ __-hvrmfan__ ] [[ __-d=__''cdrom
-
-
-
-!!DESCRIPTION
+__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
-
-
-
-
+__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.
-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 commands below
must be present
.
-
-Unless the __-h__, or __--help__ option is given one
-of the commands 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 currently 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 current disc as well as the stored file name
-__ident__
-
-
-A debugging tool to report the identity of the current disc
-as well as the stored file name
-!OPTIONS
-
-
-All command line options may be set using the configuration
-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 override 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. Configuration 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 Package 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''(5) 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 configuration file and then
-this configuration file. See ''apt.conf''(5) for syntax
-information.
-
-
-__-o__
-
-
-__--option__
+!Options
+All command line options may be set using the configuration 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.
-Set a Configuration Option; This will set an arbitary
-
+; __-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 override 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. Configuration 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
+Package 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''(5) 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
+configuration file and then this configuration file. See ''apt.conf''(5) 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
+!See also
-''
apt.conf''
(5), apt-get(8),
-''
sources.list''
(5)
-!!DIAGNOSTICS
+apt.conf(5), apt-get(8), sources.list(5)
+!Diagnostics
-__apt-cdrom__ returns zero on normal operation, decimal
-
-!!BUGS
+__apt-cdrom__ returns zero on normal operation, decimal 100 on error.
+!Bugs
-See the APT bug page
-''
or the
-
-!!AUTHOR
+See the APT bug page,
/usr/share/doc/debian/bug-reporting.txt or the bug(1) command.
+!Author
-APT was written by the APT team
-----
+APT was written by the APT team.
