.TH "apt-p2p" "8" 
.SH "NAME" 
apt-p2p \(em apt helper for peer-to-peer downloads of Debian packages 
.SH "SYNOPSIS" 
.PP 
Normally apt-p2p is run from init.d using \fBtwistd\fR, in which case no apt-p2p 
options can be specified on the command-line, and all configuration variables are 
read from the default config file locations of $HOME/.apt-p2p/apt-p2p.conf and /etc/apt-p2p/apt-p2p.conf. 
The command is then: 
.PP 
\fBtwistd\fR \-y /path/to/apt-p2p [\fBtwistd options\fP \&...]  
.PP 
For a detailed listing of the \fBtwistd\fR options, see 
\fBtwistd\fP\fB(1)\fP 
.PP 
apt-p2p can also be run without \fBtwistd\fR by executing: 
.PP 
\fBapt-p2p\fR [\fBoptions\fP \&...]  
.PP 
In this case, you can specify the options documented below on the command-line. 
.SH "DESCRIPTION" 
.PP 
\fBapt-p2p\fR is a helper for downloading Debian packages files with APT. 
It will download any needed files from other Apt-P2P peers in a 
peer-to-peer manner, and so reduce the strain on the Debian mirrors. 
.SS "APT SETUP" 
.PP 
In order for APT to send it's requests to apt-p2p, the sources.list entries must be modified to point to the 
local apt-p2p address. Unless you have changed the default port, then adding "localhost:9977/" to the beginning 
of each entry should be sufficient. For example, if your sources.list contains a line like this: 
.PP 
.RS 
.PP 
deb http://ftp.us.debian.org/debian etch main contrib non-free 
.RE 
.PP 
then replace it with this: 
.PP 
.RS 
.PP 
deb http://localhost:9977/ftp.us.debian.org/debian etch main contrib non-free 
.RE 
.PP 
You can do the same with 'deb-src' lines as well, and apt-p2p 
will be used to download and share your source packages as well. 
.SS "PORT FORWARDING" 
.PP 
It is VERY important that Apt-P2P's ports be reachable by other peers. 
This is needed both to share files with others, and to connect to 
others through the DHT to find peers for files. If you aren't 
accessible by others, you will not only not share anything, but your 
performance during downloading will be affected. 
.PP 
Apt-P2P uses a default port of 9977, over both TCP and UDP, for it's 
communication. You can change this port in the 
/etc/apt-p2p/apt-p2p.conf file, and use different ports for TCP and 
UDP, if desired. Whatever port you use, make sure to forward it 
through your NAT or firewall to improve your performance and share 
with others. Information on port forwarding can be found here: 
.PP 
\fI (link to URL http://portforward.com/) \fR 
.SS "PRIVATE NETWORKS" 
.PP 
Apt-P2P is not designed to function as a downloader for multiple 
clients on a private network. Apt-P2P checks the source of incoming 
requests and only responds to those from the localhost. For more 
information: 
.PP 
\fI (link to URL http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=481243) \fR 
.SH "OPTIONS" 
.PP 
These programs follow the usual GNU command line syntax, 
with short options starting with a single dash ('\-'), 
and long options starting with two dashes ('\-\-'). 
A summary of options is included below. 
.IP "\fB-c \fIfilename\fR,\fP \fB\-\-configfile=\fIfilename\fR\fP" 10 
the \fIfilename\fR to use for the configuration file, options found in this 
file are combined with those in $HOME/.apt-p2p/apt-p2p.conf and /etc/apt-p2p/apt-p2p.conf 
(see \fBapt-p2p.conf\fP\fB(5)\fP for the format of the file) 
.IP "\fB-l \fIfilename\fR,\fP \fB\-\-logfile=\fIfilename\fR\fP" 10 
the \fIfilename\fR to print log messages to, 
or '\-' to log to standard output, if not specified then 
/var/log/apt-p2p.log will be used 
.IP "\fB-h\fP, \fB\-\-help\fP" 10 
print a help message describing the invocation of the program 
.IP "\fB-v\fP, \fB\-\-version\fP" 10 
print the version of the program 
.SH "SEE ALSO" 
.PP 
\fBapt-p2p.conf\fP\fB(5)\fP, 
\fBtwistd\fP\fB(1)\fP      
.SH "AUTHOR" 
.PP 
This manual page was written by Cameron Dale <camrdale@gmail.com> for 
the \fBDebian\fP system (but may be used by others).  Permission is 
granted to copy, distribute and/or modify this document under 
the terms of the GNU General Public License, Version 2 or any 
later version published by the Free Software Foundation. 
 
.PP 
On Debian systems, the complete text of the GNU General Public 
License can be found in /usr/share/common-licenses/GPL. 
 
.\" created by instant / docbook-to-man, Sun 22 Feb 2015, 01:31