summaryrefslogtreecommitdiffstats
path: root/dselect/methods/media/README.media
diff options
context:
space:
mode:
Diffstat (limited to 'dselect/methods/media/README.media')
-rw-r--r--dselect/methods/media/README.media106
1 files changed, 106 insertions, 0 deletions
diff --git a/dselect/methods/media/README.media b/dselect/methods/media/README.media
new file mode 100644
index 0000000..42be941
--- /dev/null
+++ b/dselect/methods/media/README.media
@@ -0,0 +1,106 @@
+Installation method for multiple binary media
+---------------------------------------------
+
+ This directory contains a method to be used within dselect in order to
+ access Debian binary packages stored across multiple binary media
+ (CDs, DVDs, BDs, or USBs).
+
+Acquiring package data
+---------------------
+
+ It is possible to access the following binary directories within
+ «dists/stable»:
+
+ . main
+ . contrib
+ . non-free-firmware
+ . non-free
+ . local
+
+ The selected method will try to read the «Packages.cd» file from each
+ of these directories if it is available.
+
+Identifying the media
+----------------------
+
+ A unique name is associated to each media disc. This name should correspond
+ with the label on the front of the media disc. The name is also available on
+ the media disc, so the system can find out which media disc is inserted into
+ the computer at any time.
+
+Installing the files
+--------------------
+
+ At the beginning of the installation the “media” method will sort the list
+ of to-be-installed packages and install them media disc by media disc. If a
+ different media disc is required the user will be prompted to exchange
+ the media disc.
+
+Preparing multiple binary media discs
+-------------------------------------
+
+ Since the “media” method needs to know which packages are on which
+ media disc one cannot use regular «Packages» files. An additional data
+ field «X-Medium:» is required. The first media disc from the set should
+ contain all «Packages.cd» files. To be more convenient you should
+ include the «Packages.cd» files on all media discs. This ensures that
+ you do not have to start with the first media disc all the time.
+
+ Additionally the package needs to gain information which media disc is
+ currently used. Thus each media disc contains the file «.disk/info»
+ which contains the symbolic name for the media disc as specified by
+ «X-Medium:».
+
+ In order to be able to create the modified «Packages.cd» files, you
+ have to use the «-M medium» option of dpkg-scanpackages (supported
+ in dpkg-dev since 1.15.5).
+
+ To split the “main” distribution into two media discs you will need to
+ create a «Packages.cd» file for each «binary-$arch» directory.
+ Afterwards you simply append the second one to the first one and
+ put the resulting «Packages.cd» file into both «binary-$arch»
+ directories.
+
+Sample Layout
+-------------
+
+ Media disc 1 .disk/info = "Debian GNU/Linux binary-amd64"
+ dists/stable/main/binary-all/
+ binary-amd64/Packages.cd.gz
+ binary-amd64/net/foo.deb
+ contrib/binary-amd64/Packages.cd.gz
+ non-free-firmware/binary-amd64/Packages.cd.gz
+ non-free/binary-amd64/Packages.cd.gz
+
+ Media disc 2 .disk/info = "Debian GNU/Linux contrib-amd64"
+ dists/stable/main/binary-amd64/Packages.cd.gz
+ contrib/binary-all/
+ binary-amd64/Packages.cd.gz
+ binary-amd64/net/foo.deb
+ non-free-firmware/binary-amd64/Packages.cd.gz
+ non-free/binary-amd64/Packages.cd.gz
+
+ Media disc 3 .disk/info = "Debian GNU/Linux non-free-amd64"
+ dists/stable/main/binary-amd64/Packages.cd.gz
+ contrib/binary-amd64/Packages.cd.gz
+ non-free-firmware/binary-amd64/Packages.cd.gz
+ non-free/binary-all/
+ binary-amd64/Packages.cd.gz
+ binary-amd64/net/foo.deb
+
+ To re-generate the Packages file you have to change directory into
+ «dists/stable/$part» and issue «dpkg-scanpackages» as follows. It is
+ assumed that you use regular compressed overrides files in
+ «/pub/debian/indices».
+
+ Media disc 1: dpkg-scanpackages -M "Debian GNU/Linux binary-amd64" \
+ binary-amd64 /pub/debian/indices/override.buster.gz \
+ dists/stable/ > binary-amd64/Packages
+
+ Media disc 2: dpkg-scanpackages -M "Debian GNU/Linux contrib-amd64" \
+ binary-amd64 /pub/debian/indices/override.buster.contrib.gz \
+ dists/stable/ > binary-amd64/Packages
+
+ Media disc 3: dpkg-scanpackages -M "Debian GNU/Linux non-free-amd64" \
+ binary-amd64 /pub/debian/indices/override.buster.non-free.gz \
+ dists/stable/ > binary-amd64/Packages