Provided by: apt-move_4.2.27-3_amd64 bug

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>