diff options
Diffstat (limited to 'dselect/methods/media/README.media')
| -rw-r--r-- | dselect/methods/media/README.media | 106 |
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 |