[tor-commits] [tech-reports/master] Turn tor-nat-plan into a Tor Tech Report.

karsten at torproject.org karsten at torproject.org
Wed Aug 22 09:31:17 UTC 2012


commit df7b3707a9a082377772e9bc580f0094d9bee742
Author: Karsten Loesing <karsten.loesing at gmx.net>
Date:   Wed Aug 22 08:01:07 2012 +0200

    Turn tor-nat-plan into a Tor Tech Report.
---
 2012/tor-nat-plan/.gitignore       |    1 +
 2012/tor-nat-plan/tor-nat-plan.bib |   56 +++++++++---------------------------
 2012/tor-nat-plan/tor-nat-plan.tex |   50 +++++++++++---------------------
 2012/tor-nat-plan/tortechrep.cls   |    1 +
 4 files changed, 33 insertions(+), 75 deletions(-)

diff --git a/2012/tor-nat-plan/.gitignore b/2012/tor-nat-plan/.gitignore
index 59cf12a..1053ba0 100644
--- a/2012/tor-nat-plan/.gitignore
+++ b/2012/tor-nat-plan/.gitignore
@@ -1,2 +1,3 @@
 tor-nat-plan.pdf
+tor-nat-plan-2012-08-22.pdf
 
diff --git a/2012/tor-nat-plan/tor-nat-plan.bib b/2012/tor-nat-plan/tor-nat-plan.bib
index e2a5dfd..35715bd 100644
--- a/2012/tor-nat-plan/tor-nat-plan.bib
+++ b/2012/tor-nat-plan/tor-nat-plan.bib
@@ -1,47 +1,19 @@
- at MISC{dummy,
-  author={nobody},
-  title = {nothing},
-  note = {\url{http://example.com}},
-  year = {2011}
+ at inproceedings{dingledine2004tor,
+  title = {{Tor}: The Second-Generation Onion Router},
+  author = {Roger Dingledine and Nick Mathewson and Paul Syverson},
+  booktitle = {Proceedings of the 13th USENIX Security Symposium},
+  year = {2004},
+  month = {August},
+  note = {\url{https://svn.torproject.org/svn/projects/design-paper/tor-design.pdf}},
 }
 
-
- at techreport{dingledine2004tor,
-  title={Tor: The second-generation onion router},
-  author={Dingledine, R. and Mathewson, N. and Syverson, P.},
-  year={2004},
-  institution={DTIC Document}
-}
 @inproceedings{muller2010autonomous,
-  title={Autonomous nat traversal},
-  author={Muller, A. and Evans, N. and Grothoff, C. and Kamkar, S.},
-  booktitle={Peer-to-Peer Computing (P2P), 2010 IEEE Tenth International
-Conference on},
-  pages={1--4},
-  year={2010},
-  organization={IEEE}
-}
-
- at misc{wiki:000,
-  author = "Wikipedia",
-  title = "STUN --- {W}ikipedia{,} The Free Encyclopedia",
-  year = "2012",
-   url = "\url{https://en.wikipedia.org/w/index.php?title=STUN&oldid=480053418}",
-  note = "[Online; accessed 20-March-2012]"
+  title = {Autonomous {NAT} Traversal},
+  author = {Andreas M\"{u}ller and Nathan Evans and Christian Grothoff and Samy Kamkar},
+  booktitle = {10th IEEE International Conference on Peer-to-Peer Computing (P2P)},
+  year = {2010},
+  month = {August},
+  pages = {1--4},
+  organization={IEEE},
 }
 
- at misc{wiki:001,
-  author = "Wikipedia",
-  title = "TURN --- {W}ikipedia{,} The Free Encyclopedia",
-  year = "2012",
-   url = "\url{https://en.wikipedia.org/w/index.php?title=Traversal_Using_Relays_around_NAT&oldid=480053422}",
-  note = "[Online; accessed 20-March-2012]"
-}
-
- at misc{wiki:002,
-  author = "Wikipedia",
-  title = "ICE --- {W}ikipedia{,} The Free Encyclopedia",
-  year = "2012",
-   url = "\url{https://en.wikipedia.org/w/index.php?title=Interactive_Connectivity_Establishment&oldid=472491355}",
-  note = "[Online; accessed 20-March-2012]"
-}
diff --git a/2012/tor-nat-plan/tor-nat-plan.tex b/2012/tor-nat-plan/tor-nat-plan.tex
index af19aff..0c0b44d 100644
--- a/2012/tor-nat-plan/tor-nat-plan.tex
+++ b/2012/tor-nat-plan/tor-nat-plan.tex
@@ -1,17 +1,5 @@
-\documentclass{article}
-%\usepackage{palatcm}
-\usepackage{censor}
-
-\usepackage{listings}
-\lstset{language=python,breaklines=true}
-
-\usepackage{fancyhdr}
-\usepackage{color}
+\documentclass{tortechrep}
 \usepackage{graphicx}
-\usepackage{fullpage}
-\setlength{\headheight}{12pt}
-\setlength{\headsep}{12pt}
-\addtolength{\textheight}{-24pt}
 
 \usepackage{prettyref}
 \newrefformat{sec}{Section~\ref{#1}}
@@ -42,26 +30,20 @@
 \newcommand{\ia}{inter alia\xspace}
 \makeatother
 
-
-\newcommand{\thetitle}{Tor and NAT devices: increasing bridge \& relay reachability}
-\title{\thetitle\\or,\\enabling the use of NAT--PMP and UPnP by default}
+\title{Tor and NAT devices:\\increasing bridge \& relay reachability\\%
+or,\\enabling the use of NAT--PMP and UPnP by default}
 
 %% Please add your name in here if you contribute
-\author{Jacob Appelbaum
-       \\jacob at torproject.org
-       }
-\pagestyle{fancy}
-\fancyhf{}
-
-\fancyhead[C]{\thetitle}
-\fancyfoot[C]{\thepage}
+\author{Jacob Appelbaum}
+\contact{jacob at torproject.org}
+\reportid{2012-08-001}
+\date{August 22, 2012}
 
 \begin{document}
 
-\thispagestyle{plain}
-
 \maketitle
 
+\begin{abstract}
 Tor relays and Tor bridges require at least a single reachable TCP port. This
 document discusses the current methods for enabling and enhancing Tor
 bridge and Tor relay reachability when behind a consumer grade
@@ -69,10 +51,7 @@ NAT device. Such reachability improvements are extremely important for embedded
 devices that provide Tor relaying or Tor bridging services. We propose the use
 of NAT--PMP and/or UPnP protocol(s) to ensure that inbound connectivity is
 possible.
-
-\pagebreak
-\tableofcontents
-\pagebreak
+\end{abstract}
 
 %\section{License}
 %This work is released under the Creative Commons
@@ -87,7 +66,7 @@ possible.
 \label{introduction}
 
 
-Tor\cite{dingledine2004tor} is the second-generation onion router -- it is both
+Tor~\cite{dingledine2004tor} is the second-generation onion router -- it is both
 client and server software in a single program. When {\em Tor} is configured to
 be a relay or bridge, it requires a public IPv4 address and at least a single
 TCP port for its Onion Router Port (ORPort). Tor does not directly need to be
@@ -115,7 +94,13 @@ mention it when applicable.
 
 While other methods of NAT traversal are possible, we consider them
 to be out of scope at this time due to their reliance on third parties
-(STUN~\cite{wiki:000}, TURN~\cite{wiki:001}, ICE~\cite{wiki:002}, etc) or
+(STUN%
+\footnote{\url{https://en.wikipedia.org/w/index.php?title=STUN\&oldid=480053418}},
+TURN%
+\footnote{\url{https://en.wikipedia.org/w/index.php?title=Traversal\_Using\_Relays\_around\_NAT&oldid=480053422}},
+ICE%
+\footnote{\url{https://en.wikipedia.org/w/index.php?title=Interactive\_Connectivity\_Establishment\&oldid=472491355}},
+etc) or
 because they require specialized client software
 (pwnat~\cite{muller2010autonomous}, etc) to access services offered behind a
 NAT device; this topic is discussed in section \ref{third}. The
@@ -297,7 +282,6 @@ size or complexity.
 I would like to thank the University of Washington Security and Privacy
 Research Lab and other anonymous cypherpunks who contributed valuable feedback.
 
-\bibliographystyle{acm}
 \bibliography{tor-nat-plan}
 
 \end{document}
diff --git a/2012/tor-nat-plan/tortechrep.cls b/2012/tor-nat-plan/tortechrep.cls
new file mode 120000
index 0000000..4c24db2
--- /dev/null
+++ b/2012/tor-nat-plan/tortechrep.cls
@@ -0,0 +1 @@
+../../tortechrep.cls
\ No newline at end of file



More information about the tor-commits mailing list