diff options
author | Tim Retout <tim@retout.co.uk> | 2014-04-20 13:51:10 +0100 |
---|---|---|
committer | Tim Retout <tim@retout.co.uk> | 2014-04-20 13:51:10 +0100 |
commit | 3c2edc4a92bd373d384a9c025c193fe3084e9704 (patch) | |
tree | 91acdcdaf54156be16afe01801b4f06ded585d68 | |
parent | 3b501823ab07123588a365bddc330ce36b94fec8 (diff) |
Add build system and README.md
-rw-r--r-- | Makefile.am | 4 | ||||
-rw-r--r-- | README.md | 90 | ||||
-rw-r--r-- | config.h | 1 | ||||
-rw-r--r-- | configure.ac | 10 |
4 files changed, 104 insertions, 1 deletions
diff --git a/Makefile.am b/Makefile.am new file mode 100644 index 0000000..93c08f9 --- /dev/null +++ b/Makefile.am @@ -0,0 +1,4 @@ +methodsdir = $(libdir)/apt/methods + +methods_PROGRAMS = tor +tor_SOURCES = tor.cc server.cc diff --git a/README.md b/README.md new file mode 100644 index 0000000..1b39ca6 --- /dev/null +++ b/README.md @@ -0,0 +1,90 @@ +# apt-transport-tor + +Easily install Debian packages via Tor. + +This package implements an APT "acquire method" that handles URLs starting +with "tor://" in your sources.list. + +## Installation + +### Via apt + +This package will soon be available in Debian: + + apt-get install apt-transport-tor + +### From source + +If you are working from a git checkout, first run: + + autoreconf -i + +Then, or if installing from a tarball: + + ./configure --prefix=/usr + make + sudo make install + +## Usage + +Edit your /etc/apt/sources.list like so, adjusting the suite/components +appropriately for your system: + + deb tor://http.debian.net/debian unstable main + deb-src tor://http.debian.net/debian unstable main + +Note the use of http.debian.net so that a mirror close to your exit node +will be automatically chosen. + +Alternatively, if you have the Tor hidden service address of a Debian +mirror, you can use that: + + deb tor://<long string>.onion/debian unstable main + deb-src tor://<long string>.onion/debian unstable main + +## Caveats + +Downloading your Debian packages over Tor prevents an attacker who is +sniffing your network connection from being able to tell which packages +you are fetching, or even that your traffic is Debian-related. + +However, this does not necessarily defend you from, amongst other things: + +* a global passive adversary (who could potentially correlate the exit + node's traffic with your local Tor traffic) +* an attacker looking at the size of your downloads, and making an + educated guess about the contents +* an attacker who has broken into your machine + +Download speeds will be slower via Tor. + +## Copyright & Licensing + +Copyright (C) 2014 Tim Retout <diocles@debian.org> + +apt-transport-tor was forked from the APT https transport. APT has this +copyright notice: + + Apt is copyright 1997, 1998, 1999 Jason Gunthorpe and others. + +License: + + This program is free software; you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation; either version 2 of the License, or + (at your option) any later version. + + This program is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + GNU General Public License for more details. + + You should have received a copy of the GNU General Public License + along with this program; if not, write to the Free Software + Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA. + +## Feedback + +Comments and suggestions to: Tim Retout <diocles@debian.org> + +Bug reports should be sent to the Debian BTS. diff --git a/config.h b/config.h deleted file mode 100644 index aac2e04..0000000 --- a/config.h +++ /dev/null @@ -1 +0,0 @@ -#define PACKAGE_VERSION "1" diff --git a/configure.ac b/configure.ac new file mode 100644 index 0000000..21f82ab --- /dev/null +++ b/configure.ac @@ -0,0 +1,10 @@ +AC_INIT([apt-transport-tor], [0.1], [diocles@debian.org]) +AM_INIT_AUTOMAKE([-Wall -Werror foreign]) +AC_PROG_CXX +AC_CONFIG_HEADERS([config.h]) +AC_CHECK_LIB([apt-pkg], [main]) +AC_CHECK_LIB([curl], [curl_version]) +AC_CONFIG_FILES([ + Makefile +]) +AC_OUTPUT |