debpartial-mirror(1) [debian man page]
DEBPARTIAL-MIRROR(1) General Commands Manual DEBPARTIAL-MIRROR(1) NAME
debpartial-mirror -- debpartial-mirror is a program to generate partial Debian packages archives mirrors. SYNOPSIS
apt-get [-hvs] [-o=config string] [-c=file] {update | upgrade | dselect-upgrade | install pkg ... | remove pkg ... | source pkg ... | build-dep pkg ... | check | clean | autoclean } DESCRIPTION
debpartial-mirror is a command-line tool to generate partial Debian packages archives mirrors. It is designed to work (in particular) in Custom Debian Distributions framework, as an aid to create customization of debian systems. Partial mirrors can be generated from different apt repositories (local created or remote ones) and can contain binary as well as sources packages. Generated partial mirrors have the structure of standard apt repositories: please referr to APT documentation for explanation about this. debpartial-mirror uses a configuration file to determine which packages, are to be downloaded and monitored to generate a local partial mirror. Packages can be specified by regular expressions, by list or by mirrors sections. Default configuration file is /etc/debpartial-mirror.conf. debpartial-mirror accept commands in the same way apt-get does, and unless the -h or --help is given, one of the commands below must be presented. update update update is used to resynchronize the package index files from specified sources. upgrade upgrade upgrade is used to dowload selected binary and source packages from specified mirrors. The first time this command is ran the partial mirror is generated: after this, only newer or updated packages will be downloaded into the mirror. all all all is used to perform both update and upgrade commands. OPTIONS
This program follows the usual GNU command line syntax, with long options starting with two dashes (`-'). A summary of options is included below. -h --help Show summary of options. -v --version Show version of program. -cCONFIGFILE --configfile=CONFIGFILE Select the confiruration file. -s --simulate Do nothing, only simulate all. Actually it is not implemented -sf --skip-files Skip downloading of files. Actually it is not implemented -sp --skip-packages Skip downloading of packages. Actually it is not implemented AUTHOR
This manual page was written by Otavio Salvador (otavio@debian.org). Permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License, Version 2 any later version published by the Free Software Foundation. On Debian systems, the complete text of the GNU General Public License can be found in /usr/share/common-licenses/GPL. DEBPARTIAL-MIRROR(1)
Check Out this Related Man Page
APT-SPY(8) System Manager's Manual APT-SPY(8) NAME
apt-spy - program to generate a /etc/apt/sources.list.d/apt-spy.list file SYNOPSIS
apt-spy -d distribution [ -a area ] [ -c config ] [ -e number ] [ -f file ] [ -i file ] [ -m mirror-list ] [ -o output-file ] [ -p proxy ] [ -s country-list ] [ -t time ] [ -u update-URL ] [ -w file ] [ -n number ] [ -h ] [ -v ] [ update ] DESCRIPTION
This manual page briefly documents the apt-spy command. apt-spy is a program that tests all of the Debian archive mirrors the user specifies for bandwith and writes, by default, to /etc/apt/sources.list.d/apt-spy.list the fastest server. The user can select which of the many Debian sites to benchmark by geographical location. apt-spy does not need to be run by root if the user provides a configuration file, a place where to store the mirror list and an output file. See examples for more details. OPTIONS
-d distribution Debian distribution to use. Sensible values would be `stable', `testing' or `unstable'. Distribution names can also be used. This value is directly used in the generated sources.list, and is required unless updating. -a area This will cause only servers in the specified area to be benchmarked. By default, valid values for area are `Africa', `Asia', `Europe', `North-America', `Oceania' and `South-America'. It is very easy to define your own areas or subset of servers to bench- mark. For further details see apt-spy.conf(5). -c config configuration file to use instead of /etc/apt-spy.conf. -e number `early finish'. Stop benchmarking after number of servers have been completed. Act as if all servers were benchmarked upon comple- tion. -f file file to grab from the Debian servers. By default apt-spy will test the servers by getting part of the `ls-lR' file in the base of the Debian tree on the mirror. This tells apt-spy to get file instead. It is assumed that this file is also relative to the Debian base directory. -i file use file as input for apt-spy. You should generate this input file using the -w option. -m mirror-list where to load the mirrors list from or where to save it to. The default location is /var/lib/apt-spy/mirrors.txt. Using this option allows you to specify a different location. When updating, this defines where the updated mirrors list will be saved. -o output-file location for the new sources.list. By default the new file is created as /etc/apt/sources.list. -p proxy use proxy as a proxy server. This should be specified as `hostname:port'. -s country-list A comma-separated list of countries to benchmark. At the moment, this cannot be used with the "area" option. -t time how long (approximately) in seconds to download for. By default time is 15 seconds. How long the benchmark actually downloads for varies due to the way libcurl works. With the default 15 seconds, the benchmark generally takes beween 10 and 25 seconds. Each server has potentially two protocols (ftp and http) so roughly one minute per server would be a reasonable estimate of how long it should take. Be aware that this does vary considerably, and that benchmarking any more than a very few servers takes considerable time (possibly several hours for `-a All'). -u update-URL specify custom URL to get an updated mirrors list from. This can be http, ftp, file, or any other URL type supported by libcurl. -w file write a number of top servers to file in a format suitable for use with the -i option. The number of servers to output can be speci- fied with the -n option, and defaults to 5. -n number the number of top servers to write with the -w option. update connect to http.us.debian.org and download the mirror list to /var/lib/apt-spy/mirrors.txt. The -u or -m options may be used to respectively specify a different URL for the mirrors list or a different location for the downloaded file. -v output a version number. -h print a short usage message. EXAMPLES
Non root usage: apt-spy -d stable -a Europe -m ./mirror.txt -o apt-spy.list -c apt-spy.conf Above command tests European mirrors for stable Debian release saving http://http.us.debian.org/debian/README.mirrors.txt into mirror.txt, writing source file into apt-spy.list using configuration from apt-spy.conf. Note that not root users need to specified all these parame- ters. Updating mirror list file: apt-spy update Creating the /etc/apt/sources.list.d/apt-spy.list file: apt-spy -d stable SEE ALSO
sources.list(5), apt-spy.conf(5), apt(8). AUTHOR
apt-spy and this manual page was written by Steven Holmes <steg@bsdeviant.org> and updated by Stefano Canepa <sc@linux.it>. The original version of apt-spy was written by Danny Rodriguez <messiah@optonline.net>. This version is a total rewrite. 17th December, 2011 APT-SPY(8)