Description

distsync

distsync allows to check/synch a local mirror from a distribution package mirror (currently only Debian). All the distribution control files (i.e. Packages, Sources) which where listed in a distribution list file are processed. Processing of the packages within these control files can be filtered based on either dist/comp/arch and/or the package name/infos. Synchronization between the mirrors is always done using rsync.

Standard features

• Checks and/or synchronizes a local mirror with a distribution mirror (Debian)
• Uses the distribution control files listed in a distribution list file
• Distribution list file could be apt's "sources.list" within limits
• Processes packages and/or sources
• Handles "non-US" mirror
• Allows to filter the distribution control files on arches/dists/comps
• Allows to filter the packages within control files on names/infos
• Optionally checks MD5sums on the synchronized packages
• Can replace or keep previous versions of packages
• With the "keep" option, the local mirror is anytime complete
• Would decrease needed band wide depending on gzip --rsyncable
• Can produce an outfile of wrong items instead of synchronizing
• Can set the user (i.e. to "debadmin") for correct items
• Can set the time to 1. Jan. 1970 for wrong items
• May cleanup afterwards, remove obsolete packages from the local mirror
• Configurable through a config file

Extended features

• Processes utilities if the distribution provides a control file
• May change information's within the control files (i.e. priority)
• Allows to build multiple local mirror with hardlinks/symlinks
• Transforms an official mirror into any better structured local mirror
• Allows for location and naming of control files at will

Efficiency

distsync always syncs only one file at a time to prevent the time consuming sync file list generation on the server. It also moves any old version of the synced file into the place of the new one, even gaining sometimes a few per sents with gzip compressed files. Of course the efficiency would tremendous increase if gzip --rsyncable were used.

dsc2man

dsc2man converts package descriptions into man pages. To prevent possible name conflicts, the man pages are created in subsection "7dsc" under "/use/local/man". Of course this can be changed in the config file. The distribution control files (Packages), where the descriptions where taken from, have do be defined through the distribution list file.

Features

• Creates man pages from the package descriptions
• Uses the distribution control files listed in a distribution list file
• Distribution list file could be apt's "sources.list" within limits
• Handles "non-US" mirror
• Allows to filter the distribution control files on arches/dists/comps
• Allows to filter the packages within control files on names/infos
• Can produce an outfile of processed items
• Configurable through a config file