Provided by: apt-move_4.2.27-6build2_amd64 
NAME
apt-move - move cache of Debian packages into a mirror hierarchy.
SYNOPSIS
apt-move [-c conffile] [-d dist] [-afqt] command
DESCRIPTION
The apt-move script is used to move a collection of Debian package files into a proper archive hierarchy
of the form $LOCALDIR/pool/... where LOCALDIR is specified in the configuration file. It is intended as
a tool to help manage the apt-get(8) file cache, but could be configured to work with any collection of
Debian packages.
Additionally, using the sync and mirror commands, you can build your own local mirror of portions of a
selected binary and/or source distribution.
Running apt-move periodically will assist in managing the resulting partial mirror by (optionally)
removing obsolete packages and creating valid local Packages.gz and Sources.gz.
Commands
The following commands are accepted by apt-move:
get [ dir ]
This generates the master files using Packages and Sources files from the apt(8) cache. The
master files are used to keep track of what packages are available, and where packages should be
installed. If dir is specified, it will be used in lieu of the LISTSTATE variable.
getlocal [ dir ]
This is an alias of get. It may be removed in future releases.
move Moves a collection of packages into the local mirror tree. Uses existing master files (see get)
to repair any mangling done to the package names. Any packages that aren't listed in the master
files or are obsolete will be left in the file cache directory. Obsolete packages will also be
copied into the archive but they will be removed after the next delete operation. In the these
two cases, the package is considered to have been skipped.
delete Delete obsolete package files. Configurable through the DELETE and MAXDELETE settings in the
/etc/apt-move.conf file (see the CONFIGURATION section below). It also deletes any index files of
packages that are no longer in the archive. This means that you can simply delete packages from
the archive without affecting its consistency as long as you run the delete command afterwards.
packages
Builds new local versions of Packages.gz and Sources.gz files.
fsck Rebuilds all index files used to make Packages and Sources files and reprocess all packages in the
archive by calling movefile on them. Use this if you are upgrading from an old version (<< 4.2)
of apt-move.
update This is an alias, equivalent to 'get move delete packages'. This is the preferred method for
moving package files from your cache into a local mirror.
local This is an alias, equivalent to 'move delete packages'.
localupdate
This is an alias for update. It may be removed in future releases.
mirror This command automatically runs get, then uses /usr/lib/apt-move/fetch and apt-get(8) to download
any packages missing from your mirror. The downloaded files will be installed into the repository
using move. Finally, it runs packages and exits. See the DIST and PKGTYPE settings in
/etc/apt-move.conf. Before using this command, you need to set up a $LOCALDIR/.exclude file
containing patterns to exclude unwanted files from your mirror. See the SAMPLE.exclude file for
an example. See also the Exclude file section of NOTES below. Note that this command will only
mirror packages for the architecture that you are running on. It will, however, mirror all source
packages.
sync Similar to the mirror function, but only gets the packages that are currently installed on your
system. It uses dpkg(8) --get-selections to find out what files to download. It will skip any
files that match one of the patterns in the $LOCALDIR/.exclude file (if it exists). sync will get
the latest versions of the packages, regardless of the version currently installed on your system
(think about it).
exclude
This command is used to test your $LOCALDIR/.exclude pattern file. It will go through the master
lists and print any file that matches one of the patters in $LOCALDIR/.exclude. This will show
you exactly what files you have EXCLUDED from your mirror. The -t (test) flag has no affect on
this command. This uses your existing master files, and does not require an internet connection.
movefile files...
This command is similar to move. Instead of moving files from FILECACHE, it will move the files
specified on the command line.
copydir directory...
This command is similar to movefile. Instead of moving files from the command line, it will copy
.deb files from the specified directory. This is useful for copying the pool of a Debian CD to an
apt repository.
listbin [ mirror | sync | repo ]
This command prints a list of packages which may serve as the input to mirrorbin or mirrorsrc. If
the argument is mirror or sync, it will produce the same lists that the mirror and sync commands
use. If the argument is repo, the list produced will contain the packages that are currently in
the apt-move repository.
mirrorbin
This command will fetch the list of packages specified on the standard input, and place them into
the archive in the same way as mirror does.
mirrorsrc
This commands acts like mirrorbin, except that it fetches source packages instead of binary ones.
Options
The following options are available from the command line:
-a Process all packages. By default, commands like listbin and mirrorbin only process packages that
differ in version between the apt-move repository and the archive being mirrored. This option
causes all packages to be considered even if the apt-move repository already contains the latest
version.
-c conffile
Use conffile as the configuration file instead of /etc/apt-move.conf.
-d dist
Use dist as the default suite instead of the value of DIST from the configuration file.
-f Forces deletion of files even when the percentage of files to delete exceeds the MAXDELETE
setting. This is useful if apt-move aborts with an error saying that too many files would be
deleted, and you want to delete the files anyway. (Use with caution.) If you get this error,
using -ft will show you the complete list of files, so you can verify them before you use -f.
-q Suppresses normal output. This option is useful when apt-move is used in a non-interactive
script.
-t Makes a 'test run' and reports what WOULD be done for option but does not modify any of the cache
or mirror files.
CONFIGURATION
Before using apt-move, edit the /etc/apt-move.conf file to match your local setup. Always remember to
use the test parameter after any change in your configuration to make sure it will work like you want it
to. You may also want to set the DELETE option to no to turn off file deletes until everything else is
working successfully.
The file is read as a Bourne shell script. So you must obey the syntactical rules of sh(1). In
particular, values with spaces in them must be quoted with single or double quotes.
The following settings are recognized by apt-move (shown here with their defaults):
APTSITES="debian.midco.net non-us.debian.org"
Set this to the names of sites in your /etc/apt/sources.list that you wish to mirror. The value
/all/ refers to all non-file URIs.
LOCALDIR=/mirrors/debian
This is the full (absolute) path to your debian directory (the top of your local mirror).
DIST=stable
This is the default suite assigned to packages when the Release file is missing. It does not have
any effect on whether a suite is stored in the archive.
PKGTYPE=binary
Set this to your choice of: binary, source or both to tell the mirror, sync and movefile which
type(s) of files to get.
FILECACHE=/var/cache/apt/archives
The directory where your local cache of packages are. The default will work for the apt-get(8)
packages, unless you've changed the configuration in /etc/apt/apt.conf.
LISTSTATE=/var/lib/apt/lists
The directory to your local cache of Packages files. The default will work for the apt-get(8)
packages, unless you've changed the configuration in /etc/apt/apt.conf.
DELETE=no
Determines whether obsolete packages (packages not listed in the master file, or packages that
have been superceded in the repository) are to be removed.
MAXDELETE=20
Maximum percentage of files apt-move is allowed to delete during a normal run. Anything exceeding
this will produce an error and abort the script. I added this as a precaution so that you won't
lose your entire mirror when a new distribution is released. You can override this (with caution)
using the -f parameter with apt-move.
COPYONLY=no
If this is set to yes, then move and movefile will copy instead of move. That is, the originals
will be left alone.
PKGCOMP=gzip
This should be set to a space-separated list of compression formats that apt-move should provide
when generating Packages and Sources files. The possible values are none, gzip and bzip2. With
the current apt package you should include at least none, as otherwise apt will complain about
missing files.
CONTENTS=no
If this is set to yes, then packages will generate Contents files.
GPGKEY=
If this is set to non-empty string, then packages will sign generated Release files with the
specified key. You must install gnupg before enabling this option.
For the sync and mirror commands to function correctly, you need to list your apt-move repository at the
top of /etc/apt/sources.list as a file URI.
FILES
/usr/bin/apt-move
The script.
/etc/apt-move.conf
Configuration file for the script.
/usr/share/man/man8/apt-move.8.gz
The manpage.
/tmp/MOVE_*
The temporary files created at runtime.
/usr/lib/apt-move/fetch
Utility to fetch files just like apt-get install -d. Except that no dependency analysis is done.
.apt-move/*.{binary, source}.local
Put entries of local packages here. The fields are ``package priority section source version
task'' for the binary file, and ``package priority section version'' for the source file. The
version field may be set to a single dash to refer to the latest version in the archive. Blank
lines and lines beginning with a hash are ignored.
SEE ALSO
dpkg(8), apt-get(8)
NOTES
Exclude file
The mirror command uses a file in the $LOCALDIR/ directory called '.exclude' which contains exclude
patterns that are applied against the files to be mirrored. These patterns were created with the
following limitation: they must work the same with with grep(1), after any '*' characters are removed.
Unless you're careful setting this up, you'll get unexpected results. Run 'apt-move -t mirror' first, to
make sure you're getting the results you intended. Another way to verify your exclude file is the use
the exclude command for apt-move to print a list of files your are excluding from your mirror. See the
sample
.exclude file (SAMPLE.exclude) for an example of an .exclude file.
Mirroring
The apt-move mirror and sync commands do not test for available disk space. The current potato (main
binary) distribution is over 1Gb in size. Add the sources to that and it can eat up the space on a
partition really fast. I would advise you to put your mirror somewhere other than the root partition.
Set up your exclude file and run apt-move -t mirror and examine the result.
Code names
Since apt-move gets the suite names from Release files, which usually use the names stable, testing and
unstable, the suites in the repository are named accordingly. You can simulate the code names by
creating symbolic links in the dists directory. For example, in order to make testing equivalent to
sarge, you could run ln -s testing $LOCALDIR/dists/sarge. Alternatively, you could delete the testing
subdirectory and run ln -s sarge $LOCALDIR/dists/testing. This will cause future executions of the get
operation to use sarge whenever it sees testing in the Release file.
DIAGNOSTICS
apt-move may exit with one of the following error messages:
Could not read configuration.
apt-move could not find the /etc/apt-move.conf file. Run the install script.
Could not create directory.
For some reason, a necessary directory could not be created.
You failed to select a distribution.
You did not configure a DIST setting in /etc/apt-move.conf.
You specified an invalid package type.
You can only use binary, source or both for the PKGTYPE setting.
No master files exist!
You need to run apt-ve with the get command at least once in order to create the master files
which determine where packages are to be installed.
bc calculation returned invalid result
apt-move uses the bc(1) program to determine when the number of files to delete will exceed the
MAXDELETE setting in apt-move.conf. If you get this error, make sure that MAXDELETE is set to a
number in the range of 1 to 100, without the % sign. Otherwise you need to report this as a bug.
Too many files to delete!
apt-move will report this error if the number of files to be deleted exceeds the MAXDELETE setting
in apt-move.conf. You need to study the output to determine if this is normal (in which case you
can override this using the force parameter), or if its due to some drastic change on the mirror
site (like a new release) or possibly due to a partial download of the master Packages.gz or
Sources.gz file.
Your current mirror directory is incompatible...
You have just upgraded from an old version of apt-move. Update your configuration, then run apt-
move fsck and finally remove .apt-move/ancient.
Could not read Release files.
apt-move could not read the release files needed to build the master files. Make sure you have
run apt-get update and try again.
Failed to remove original files.
apt-move could not remove the original copies of files that have just entered the apt-move
archive. Make sure that you have permission to delete those files.
Please remove $LOCALDIR/backup.
You must remove LOCALDIR/backup before running the fsck command.
Unknown DIST setting.
The value of DIST must match the Archive field in the Release file of the distribution that you
are trying to mirror.
Cannot find index files for APTSITES.
apt-move could not find any index files for the get operation. You should either run apt-get
update, or run apt-move with -f if only the *.local files have been changed.
BUGS
The exclusion system was designed prior to the introduction to the package pools. Hence its content
still relates to the old structure of the Debian archive. This is confusing and it should be replaced
with a new exclusion system.
The DIST variable does not control what is actually downloaded by the fetch utility. It should have a
similar effect to that of apt-get -t.
AUTHOR
Michael Merten <mikemerten@yahoo.com>
Herbert Xu <herbert@debian.org>
APT-MOVE 2002 Oct 7th APT-MOVE(8)