diff --git a/apps/sam/python/doc/guide/eeproxy.html b/apps/sam/python/doc/guide/eeproxy.html
index f5a2e6945e2f95a0c07cfc0379d4f0b15f8f5580..909deea73846e6f1e835a93db4f742eee8cbfd24 100644
--- a/apps/sam/python/doc/guide/eeproxy.html
+++ b/apps/sam/python/doc/guide/eeproxy.html
@@ -4,9 +4,7 @@
<meta http-equiv="Content-type" content="text/html; charset=utf-8">
<meta name="robots" content="index,follow">
<link rel="shortcut icon" href="/favicon.ico">
-<script type="text/javascript" src="/~barnesc/wiki/stylesheets/wikibits.js"></script>
<style type='text/css'><!--
-@import url("/~barnesc/wiki/stylesheets/wikiprintable.css");
/*/*/
a.new, #quickbar a.new { color: #CC2200; }
#quickbar { position: absolute; top: 4px; left: 4px; border-right: 1px solid gray; }
diff --git a/apps/sam/python/doc/guide/i2p.BaseHTTPServer.html b/apps/sam/python/doc/guide/i2p.BaseHTTPServer.html
new file mode 100644
index 0000000000000000000000000000000000000000..0ba4b511b4f238700a4dda2d4602d94ace6bdc08
--- /dev/null
+++ b/apps/sam/python/doc/guide/i2p.BaseHTTPServer.html
@@ -0,0 +1,91 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
+ "http://www.w3.org/TR/html4/loose.dtd">
+<html lang="en"><head><title>User's Guide:i2p.BaseHTTPServer - Wikipedia</title>
+<meta http-equiv="Content-type" content="text/html; charset=utf-8">
+<meta name="robots" content="index,follow">
+<link rel="shortcut icon" href="/favicon.ico">
+<style type='text/css'><!--
+/*/*/
+a.new, #quickbar a.new { color: #CC2200; }
+#quickbar { position: absolute; top: 4px; left: 4px; border-right: 1px solid gray; }
+#article { margin-left: 152px; margin-right: 4px; }
+/* */
+//--></style>
+</head>
+
+<body bgcolor='#FFFFFF' onload=''>
+<h1 class='pagetitle'>User's Guide:i2p.BaseHTTPServer</h1><p class='subtitle'>From Python-I2P.
+
+
+<div class='bodytext'>
+Emulates Python BaseHTTPServer module using I2P sockets.
+
+
+<p>
+
+<h2><a name="Overview"> Overview </a></h2>
+
+<p>
+The Python module is described at <a href="http://www.python.org/doc/current/lib/module-BaseHTTPServer.html" class='printable' title="http://www.python.org/doc/current/lib/module-BaseHTTPServer.html">http://www.python.org/doc/current/lib/module-BaseHTTPServer.html</a>
+
+<p>
+To get a server going, use:
+
+<p>
+<ul ><pre>
+>>> from i2p import BaseHTTPServer
+>>> BaseHTTPServer.test().
+</pre>
+</ul >
+
+<p>
+Consult the documentation for function test() to change basic server settings, such as the session name.
+
+<p>
+A fully customizable example:
+
+<p>
+<ul ><pre>
+>>> from i2p import BaseHTTPServer
+>>> session = "mytestxxx.i2p" # SAM session name
+>>> class MyServer(BaseHTTPServer.HTTPServer): pass
+>>> class MyRequestHandler(BaseHTTPServer.BaseHTTPRequestHandler): pass
+>>> httpd = MyServer(session, MyRequestHandler)
+>>> httpd.socket.dest
+(Base64 Destination of server)
+>>> httpd.serve_forever()
+</pre>
+</ul >
+
+<p>
+
+<h2><a name="Classes"> Classes </a></h2>
+
+<p>
+class <strong>BaseHTTPRequestHandler</strong>
+<ul ><pre>
+Same interface as Python class BaseHTTPServer.BaseHTTPRequestHandler.
+</pre>
+</ul >
+class <strong>HTTPServer</strong>
+<ul ><pre>
+Same interface as Python class BaseHTTPServer.HTTPServer.
+</pre>
+</ul >
+
+<p>
+
+<h2><a name="Functions"> Functions </a></h2>
+
+<p>
+<strong>test</strong>(HandlerClass=BaseHTTPRequestHandler, ServerClass=HTTPServer, protocol='HTTP/1.0', session='mytestxxx.i2p')
+<ul ><pre>
+Test the HTTP request handler class.
+This runs an I2P TCP server under SAM session 'session'. If a single command
+line argument is given, the argument is used instead as the SAM session name.
+</pre>
+</ul >
+
+<p>
+</div>
+</body></html>
\ No newline at end of file
diff --git a/apps/sam/python/doc/guide/i2p.CGIHTTPServer.html b/apps/sam/python/doc/guide/i2p.CGIHTTPServer.html
new file mode 100644
index 0000000000000000000000000000000000000000..15028f581b0bf8e5f7cf57e4a5dbcf0660c70091
--- /dev/null
+++ b/apps/sam/python/doc/guide/i2p.CGIHTTPServer.html
@@ -0,0 +1,90 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
+ "http://www.w3.org/TR/html4/loose.dtd">
+<html lang="en"><head><title>User's Guide:i2p.CGIHTTPServer - Wikipedia</title>
+<meta http-equiv="Content-type" content="text/html; charset=utf-8">
+<meta name="robots" content="index,follow">
+<link rel="shortcut icon" href="/favicon.ico">
+<style type='text/css'><!--
+/*/*/
+a.new, #quickbar a.new { color: #CC2200; }
+#quickbar { position: absolute; top: 4px; left: 4px; border-right: 1px solid gray; }
+#article { margin-left: 152px; margin-right: 4px; }
+/* */
+//--></style>
+</head>
+
+<body bgcolor='#FFFFFF' onload=''>
+<h1 class='pagetitle'>User's Guide:i2p.CGIHTTPServer</h1><p class='subtitle'>From Python-I2P.
+
+
+<div class='bodytext'>
+Module <code >i2p.CGIHTTPServer</code > emulates the Python CGIHTTPServer module using I2P sockets.
+
+
+<p>
+
+<h2><a name="Overview"> Overview </a></h2>
+
+<p>
+The Python module is described at <a href="http://www.python.org/doc/current/lib/module-CGIHTTPServer.html" class='printable' title="http://www.python.org/doc/current/lib/module-CGIHTTPServer.html">http://www.python.org/doc/current/lib/module-CGIHTTPServer.html</a>
+
+<p>
+To get a server going, use:
+
+<p>
+<ul ><pre>
+>>> from i2p import CGIHTTPServer
+>>> CGIHTTPServer.test().
+</pre>
+</ul >
+
+<p>
+Consult the documentation for function test() to change basic server settings, such as the session name.
+
+<p>
+A fully customizable example:
+
+<p>
+<ul ><pre>
+>>> from i2p import BaseHTTPServer, CGIHTTPServer
+>>> session = "mytestxxx.i2p" # SAM session name
+>>> class MyServer(BaseHTTPServer.HTTPServer): pass
+>>> class MyRequestHandler(CGIHTTPServer.CGIHTTPRequestHandler): pass
+>>> httpd = MyServer(session, MyRequestHandler)
+>>> httpd.socket.dest
+(Base64 Destination of server)
+>>> httpd.serve_forever()
+</pre>
+</ul >
+
+<p>
+
+<h2><a name="Classes"> Classes </a></h2>
+
+<p>
+class <strong>CGIHTTPRequestHandler</strong>
+<ul ><pre>
+Same interface as Python class CGIHTTPServer.CGIHTTPRequestHandler.
+</pre>
+</ul >
+
+<p>
+
+<h2><a name="Functions"> Functions </a></h2>
+
+<p>
+
+<strong>test</strong>(HandlerClass=CGIHTTPRequestHandler,
+ServerClass=i2p.BaseHTTPServer.HTTPServer,
+session='mytestxxx.i2p')
+<ul ><pre>
+Test the HTTP CGI request handler class.
+This runs an I2P TCP server under SAM session 'session'. If a single
+command line argument is given, the argument is used instead as the SAM session
+name.
+</pre>
+</ul >
+
+<p>
+</div>
+</body></html>
\ No newline at end of file
diff --git a/apps/sam/python/doc/guide/i2p.SimpleHTTPServer.html b/apps/sam/python/doc/guide/i2p.SimpleHTTPServer.html
new file mode 100644
index 0000000000000000000000000000000000000000..648ecfcf8928e891c28a769b985308f1f0252dee
--- /dev/null
+++ b/apps/sam/python/doc/guide/i2p.SimpleHTTPServer.html
@@ -0,0 +1,88 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
+ "http://www.w3.org/TR/html4/loose.dtd">
+<html lang="en"><head><title>User's Guide:i2p.SimpleHTTPServer - Wikipedia</title>
+<meta http-equiv="Content-type" content="text/html; charset=utf-8">
+<meta name="robots" content="index,follow">
+<link rel="shortcut icon" href="/favicon.ico">
+<style type='text/css'><!--
+/*/*/
+a.new, #quickbar a.new { color: #CC2200; }
+#quickbar { position: absolute; top: 4px; left: 4px; border-right: 1px solid gray; }
+#article { margin-left: 152px; margin-right: 4px; }
+/* */
+//--></style>
+</head>
+
+<body bgcolor='#FFFFFF' onload=''>
+<h1 class='pagetitle'>User's Guide:i2p.SimpleHTTPServer</h1><p class='subtitle'>From Python-I2P.
+
+
+<div class='bodytext'>
+Emulates Python SimpleHTTPServer module using I2P sockets.
+
+
+<p>
+
+<h2><a name="Overview"> Overview </a></h2>
+
+<p>
+The Python module is described at <a href="http://www.python.org/doc/current/lib/module-SimpleHTTPServer.html" class='printable' title="http://www.python.org/doc/current/lib/module-SimpleHTTPServer.html">http://www.python.org/doc/current/lib/module-SimpleHTTPServer.html</a>
+
+<p>
+To get a server going, use:
+
+<p>
+<ul ><pre>
+>>> from i2p import SimpleHTTPServer
+>>> SimpleHTTPServer.test().
+</pre>
+</ul >
+
+<p>
+Consult the documentation for function test() to change basic server settings, such as the session name.
+
+<p>
+A fully customizable example:
+
+<p>
+<ul ><pre>
+>>> from i2p import BaseHTTPServer, SimpleHTTPServer
+>>> session = "mytestxxx.i2p" # SAM session name
+>>> class MyServer(BaseHTTPServer.HTTPServer): pass
+>>> class MyRequestHandler(SimpleHTTPServer.SimpleHTTPRequestHandler): pass
+>>> httpd = MyServer(session, MyRequestHandler)
+>>> httpd.socket.dest
+(Base64 Destination of server)
+>>> httpd.serve_forever()
+</pre>
+</ul >
+
+<p>
+
+<h2><a name="Classes"> Classes </a></h2>
+
+<p>
+class <strong>SimpleHTTPRequestHandler</strong>
+<ul ><pre>
+Same interface as Python class SimpleHTTPServer.SimpleHTTPRequestHandler.
+</pre>
+</ul >
+
+<p>
+
+<h2><a name="Functions"> Functions </a></h2>
+
+<p>
+
+<strong>test</strong>(HandlerClass=SimpleHTTPRequestHandler, ServerClass= i2p.BaseHTTPServer.HTTPServer, session='mytestxxx.i2p')
+<ul ><pre>
+Test the HTTP simple request handler class.
+This runs an I2P TCP server under SAM session 'session'. If a single command
+line argument is given, the argument is used instead as the SAM session name.
+</pre>
+</ul >
+
+<p>
+</div>
+
+</body></html>
\ No newline at end of file
diff --git a/apps/sam/python/doc/guide/i2p.SocketServer.html b/apps/sam/python/doc/guide/i2p.SocketServer.html
new file mode 100644
index 0000000000000000000000000000000000000000..cc588a5166e5710cb2004989705b3a3c2ce39896
--- /dev/null
+++ b/apps/sam/python/doc/guide/i2p.SocketServer.html
@@ -0,0 +1,50 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
+ "http://www.w3.org/TR/html4/loose.dtd">
+<html lang="en"><head><title>User's Guide:i2p.SocketServer - Wikipedia</title>
+<meta http-equiv="Content-type" content="text/html; charset=utf-8">
+<meta name="robots" content="index,follow">
+<link rel="shortcut icon" href="/favicon.ico">
+<style type='text/css'><!--
+/*/*/
+a.new, #quickbar a.new { color: #CC2200; }
+#quickbar { position: absolute; top: 4px; left: 4px; border-right: 1px solid gray; }
+#article { margin-left: 152px; margin-right: 4px; }
+/* */
+//--></style>
+</head>
+
+<body bgcolor='#FFFFFF' onload=''>
+<h1 class='pagetitle'>User's Guide:i2p.SocketServer</h1><p class='subtitle'>From Python-I2P.
+
+
+<div class='bodytext'>
+Emulates Python SocketServer module using I2P sockets.
+
+
+<p>
+The Python module is described at <a href="http://www.python.org/doc/current/lib/module-SocketServer.html" class='printable' title="http://www.python.org/doc/current/lib/module-SocketServer.html">http://www.python.org/doc/current/lib/module-SocketServer.html</a>
+
+<p>
+
+<h2><a name="Classes"> Classes </a></h2>
+
+<p>
+<ul ><pre>
+BaseRequestHandler
+BaseServer
+DatagramRequestHandler
+ForkingMixIn
+ForkingTCPServer
+ForkingUDPServer
+StreamRequestHandler
+TCPServer
+ThreadingMixIn
+ThreadingTCPServer
+ThreadingUDPServer
+UDPServer
+</pre>
+</ul >
+
+<p>
+</div>
+</body></html>
\ No newline at end of file
diff --git a/apps/sam/python/doc/guide/i2p.eep.html b/apps/sam/python/doc/guide/i2p.eep.html
index 3cd24db4d3e4dc8ab4bb5e7395428afabd98c3f1..db2519e2dbe0e1c4fd1d3626cc8dbd73d8085195 100644
--- a/apps/sam/python/doc/guide/i2p.eep.html
+++ b/apps/sam/python/doc/guide/i2p.eep.html
@@ -4,9 +4,7 @@
<meta http-equiv="Content-type" content="text/html; charset=utf-8">
<meta name="robots" content="index,follow">
<link rel="shortcut icon" href="/favicon.ico">
-<script type="text/javascript" src="/~barnesc/wiki/stylesheets/wikibits.js"></script>
<style type='text/css'><!--
-@import url("/~barnesc/wiki/stylesheets/wikiprintable.css");
/*/*/
a.new, #quickbar a.new { color: #CC2200; }
#quickbar { position: absolute; top: 4px; left: 4px; border-right: 1px solid gray; }
diff --git a/apps/sam/python/doc/guide/i2p.html b/apps/sam/python/doc/guide/i2p.html
index a5922a4b81e141eb6b99a66208eb304d398cf206..365f7f78347907faf8bdcf3ca2597dfbeb684d52 100644
--- a/apps/sam/python/doc/guide/i2p.html
+++ b/apps/sam/python/doc/guide/i2p.html
@@ -4,9 +4,7 @@
<meta http-equiv="Content-type" content="text/html; charset=utf-8">
<meta name="robots" content="index,follow">
<link rel="shortcut icon" href="/favicon.ico">
-<script type="text/javascript" src="/~barnesc/wiki/stylesheets/wikibits.js"></script>
<style type='text/css'><!--
-@import url("/~barnesc/wiki/stylesheets/wikiprintable.css");
/*/*/
a.new, #quickbar a.new { color: #CC2200; }
#quickbar { position: absolute; top: 4px; left: 4px; border-right: 1px solid gray; }
@@ -24,19 +22,23 @@ Package <code >i2p</code > is a container package for more specific modules.
<p>
-It exports the following names:
+It contains the following modules:
+
+<p>
<ul >
-<pre> <a href="./i2p.sam.html" class='printable' title ="User's Guide:i2p.sam">sam</a>
- <a href="./i2p.eep.html" class='printable' title ="User's Guide:i2p.eep">eep</a>
- <a href="./i2p.router.html" class='printable' title ="User's Guide:i2p.router">router</a>
- <a href="#Error" class='printable' title ="User's Guide:i2p">Error</a>
- <a href="#RouterError" class='printable' title ="User's Guide:i2p">RouterError</a>
+<pre> <a href="i2p.BaseHTTPServer.html" class='printable' title ="User's Guide:i2p.BaseHTTPServer">i2p.BaseHTTPServer</a> (Emulate Python BaseHTTPServer module)
+ <a href="i2p.CGIHTTPServer.html" class='printable' title ="User's Guide:i2p.CGIHTTPServer">i2p.CGIHTTPServer</a> (Emulate Python CGIHTTPServer module)
+ <a href="i2p.eep.html" class='printable' title ="User's Guide:i2p.eep">i2p.eep</a> (Retrieve eepsites)
+ <a href="i2p.router.html" class='printable' title ="User's Guide:i2p.router">i2p.router</a> (Manage the I2P router)
+ <a href="i2p.select.html" class='printable' title ="User's Guide:i2p.select">i2p.select</a> (Emulate Python select module)
+ <a href="i2p.SimpleHTTPServer.html" class='printable' title ="User's Guide:i2p.SimpleHTTPServer">i2p.SimpleHTTPServer</a> (Emulate Python SimpleHTTPServer module)
+ <a href="i2p.socket.html" class='printable' title ="User's Guide:i2p.socket">i2p.socket</a> (Send and receive across the I2P network)
+ <a href="i2p.SocketServer.html" class='printable' title ="User's Guide:i2p.SocketServer">i2p.SocketServer</a> (Emulate Python SocketServer module)
+ <a href="i2p.tunnel.html" class='printable' title ="User's Guide:i2p.tunnel">i2p.tunnel</a> (Exchange data between I2P and regular sockets)
</pre>
</ul >
-
-<p>
class <strong>Error</strong>(Exception):
<ul >
@@ -46,7 +48,6 @@ class <strong>Error</strong>(Exception):
<p>
class <strong>RouterError</strong>(Error):
-
<ul >
<pre> Could not connect to router.
@@ -55,7 +56,4 @@ class <strong>RouterError</strong>(Error):
<p>
</div>
-<p><em>
-</em><!-- Time since request: 0.85 secs. -->
-
</body></html>
\ No newline at end of file
diff --git a/apps/sam/python/doc/guide/i2p.router.html b/apps/sam/python/doc/guide/i2p.router.html
index 087f3963fd3f12aa132a02364a467d7dd92d2849..c47e1de2366f314d1ce30fb4081f904d481bda1e 100644
--- a/apps/sam/python/doc/guide/i2p.router.html
+++ b/apps/sam/python/doc/guide/i2p.router.html
@@ -4,9 +4,7 @@
<meta http-equiv="Content-type" content="text/html; charset=utf-8">
<meta name="robots" content="index,follow">
<link rel="shortcut icon" href="/favicon.ico">
-<script type="text/javascript" src="/~barnesc/wiki/stylesheets/wikibits.js"></script>
<style type='text/css'><!--
-@import url("/~barnesc/wiki/stylesheets/wikiprintable.css");
/*/*/
a.new, #quickbar a.new { color: #CC2200; }
#quickbar { position: absolute; top: 4px; left: 4px; border-right: 1px solid gray; }
@@ -45,8 +43,8 @@ Module <code >i2p.router</code > allows Python programs to control the I2P route
Find the absolute path to a locally installed I2P router.
An I2P installation is located by looking in the
- environment I2P, then in PATH, then in the dir argument
- given to the function. It looks for startRouter.sh or
+ dir argument given to the function, then in the environment
+ I2P, then in PATH. It looks for startRouter.sh or
startRouter.bat. Raises ValueError if an I2P installation
could not be located.
</pre>
diff --git a/apps/sam/python/doc/guide/i2p.select.html b/apps/sam/python/doc/guide/i2p.select.html
new file mode 100644
index 0000000000000000000000000000000000000000..62b43c3ad353475442d44e40e8f82540296156f8
--- /dev/null
+++ b/apps/sam/python/doc/guide/i2p.select.html
@@ -0,0 +1,60 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
+ "http://www.w3.org/TR/html4/loose.dtd">
+<html lang="en"><head><title>User's Guide:i2p.select - Wikipedia</title>
+<meta http-equiv="Content-type" content="text/html; charset=utf-8">
+<meta name="robots" content="index,follow">
+<link rel="shortcut icon" href="/favicon.ico">
+<style type='text/css'><!--
+/*/*/
+a.new, #quickbar a.new { color: #CC2200; }
+#quickbar { position: absolute; top: 4px; left: 4px; border-right: 1px solid gray; }
+#article { margin-left: 152px; margin-right: 4px; }
+/* */
+//--></style>
+</head>
+
+<body bgcolor='#FFFFFF' onload=''>
+<h1 class='pagetitle'>User's Guide:i2p.select</h1><p class='subtitle'>From Python-I2P.
+
+
+<div class='bodytext'>
+Module <code >i2p.select</code > emulates the Python module <code >select</code >.
+
+
+<p>
+With this module, a program can perform select and poll commands on traditional and I2P sockets.
+
+<p>
+<strong>poll</strong>()
+<ul >
+
+<pre> Returns a polling object. Works on SAM sockets and Python sockets.
+ See <a href='http://www.python.org/doc/current/lib/module-select.html' class='printable' title="http://www.python.org/doc/current/lib/module-select.html">select.poll()</a> in the Python library for more information.
+</pre>
+</ul >
+
+<p>
+<strong>select</strong>(readlist, writelist, errlist, timeout=None)
+<ul >
+
+<pre> Performs a select call. Works on SAM sockets and Python sockets.
+ See <a href='http://www.python.org/doc/current/lib/module-select.html' class='printable' title="http://www.python.org/doc/current/lib/module-select.html">select.select()</a> in the Python library for more information.
+</pre>
+</ul >
+
+<p>
+<strong>Polling flags</strong>
+
+<ul ><pre>
+ POLLIN = 1
+ POLLOUT = 4
+ POLLERR = 8
+ POLLHUP = 16
+ POLLNVAL = 32
+ POLLPRI = 1
+</pre>
+</ul >
+
+<p>
+</div>
+</body></html>
\ No newline at end of file
diff --git a/apps/sam/python/doc/guide/i2p.socket.html b/apps/sam/python/doc/guide/i2p.socket.html
new file mode 100644
index 0000000000000000000000000000000000000000..621ddc83a86b85893c3ccf2e3b7c76b5afe3b5fb
--- /dev/null
+++ b/apps/sam/python/doc/guide/i2p.socket.html
@@ -0,0 +1,376 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
+ "http://www.w3.org/TR/html4/loose.dtd">
+<html lang="en"><head><title>User's Guide:i2p.socket - Wikipedia</title>
+<meta http-equiv="Content-type" content="text/html; charset=utf-8">
+<meta name="robots" content="index,follow">
+<link rel="shortcut icon" href="/favicon.ico">
+<style type='text/css'><!--
+/*/*/
+a.new, #quickbar a.new { color: #CC2200; }
+#quickbar { position: absolute; top: 4px; left: 4px; border-right: 1px solid gray; }
+#article { margin-left: 152px; margin-right: 4px; }
+/* */
+//--></style>
+</head>
+
+<body bgcolor='#FFFFFF' onload=''>
+<h1 class='pagetitle'>User's Guide:i2p.socket</h1><p class='subtitle'>From Python-I2P.
+
+
+<div class='bodytext'><a name="top"></a>
+Module <code >i2p.socket</code > allows Python programs to access the <a href="samproxy.html" class='printable' title ="SAM proxy">SAM proxy</a>. It emulates the Python module <code >socket</code >.
+
+
+<p>
+With this module, a program can send stream data, datagrams, and raw packets across the I2P network.
+
+<p>
+
+<p><table border="0" id="toc"><tr><td align="center">
+<b>Table of contents</b></td></tr><tr id='tocinside'><td>
+<div style="margin-bottom:0px;">
+<A CLASS="internal" HREF="#Sockets">1 Sockets</A><BR>
+</div>
+<div style="margin-bottom:0px;">
+<A CLASS="internal" HREF="#Functions">2 Functions</A><BR>
+</div>
+<div style="margin-bottom:0px;">
+<A CLASS="internal" HREF="#Errors">3 Errors</A><BR>
+
+</div>
+<div style="margin-bottom:0px;">
+<A CLASS="internal" HREF="#Constants">4 Constants</A><BR>
+</div>
+</td></tr></table><P>
+<h2><a name="Sockets"> Sockets </a></h2>
+
+<p>
+class <strong>socket</strong>(session, type, samaddr='127.0.0.1:7656', **kwargs)
+<ul ><pre>
+ Create a new socket. Argument session should be a session
+ name -- if the name has not yet been used, an I2P
+ Destination will be created for it, otherwise, the
+ existing Destination will be re-used. An empty session
+ string causes a transient session to be created. Argument
+ type is one of SOCK_STREAM, SOCK_DGRAM, or SOCK_RAW.
+
+ I2P configuration keyword arguments:
+
+ - in_depth - depth of incoming tunnel (default 2)
+ - out_depth - depth of outgoing tunnel (default 2)
+
+ A single session may be shared by more than one socket, if
+ the sockets are the same type, and if the sockets are
+ created within the same Python process. The socket
+ objects are multithread-safe.
+
+ Examples:
+ >>> a = i2p.socket('Alice', i2p.SOCK_STREAM)
+ >>> b = i2p.socket('Bob', i2p.SOCK_DGRAM,
+ in_depth=2, out_depth=5)
+
+ The created object behaves identically to a socket from
+ module socket, with the following exceptions:
+
+ * I2P Destinations are used as address arguments [1].
+ * bind is a no-op: sockets are always bound.
+ * send* methods send all data and are non-blocking.
+
+ A given session name can only be open in a single Python
+ program at a time. If you need to overcome this
+ limitation, consider patching I2P.
+
+ [1]. Alternatively, a host name can be used as an address.
+ It will be resolved using hosts.txt.
+
+</pre>
+
+
+<pre> For details on how to use socket objects, see
+ <a href="http://www.python.org/doc/current/lib/socket-objects.html" class='printable' title="http://www.python.org/doc/current/lib/socket-objects.html">http://www.python.org/doc/current/lib/socket-objects.html</a>
+</pre>
+<p>
+
+<pre> See the examples directory for code examples.
+</pre>
+</ul >
+The class <code >socket</code > defines the following properties:
+
+<ul >
+
+<pre> dest - Local I2P Destination of socket
+ session - Session name
+ type - Socket type: SOCK_STREAM, SOCK_DGRAM, or SOCK_RAW.
+</pre>
+</ul >
+
+<p>
+The class <code >socket</code > defines the following methods:
+
+<p>
+<strong>accept</strong>(self)
+<ul ><pre>
+ Accept an incoming connection. The socket must be type SOCK_STREAM, and
+ listen() must be called prior to this command. The return value is (conn,
+ remotedest), where conn is a new socket object made for the connection, and
+ remotedest is the remote Destination from which the connection was made.
+
+ Example:
+
+ >>> from i2p import socket
+ >>> s = socket.socket('Alice', socket.SOCK_STREAM)
+ >>> s.listen(10)
+
+ This prepares the server. Now accept an incoming connection:
+
+ >>> c, remotedest = s.accept()
+ >>> c.send('hello world!')
+
+ If accept() is called on a socket that is in non-blocking mode or has a
+ timeout, i2p.socket.BlockError or i2p.socket.Timeout may be raised. This
+ indicates that no incoming connection is currently available.
+
+</pre>
+</ul >
+<strong>bind</strong>(self, address)
+<ul ><pre>
+ Does nothing. Provided for compatibility with the Python socket command
+ bind(), which binds a server to a port.
+</pre>
+</ul >
+<strong>close</strong>(self)
+<ul ><pre>
+ Closes the socket. It is an error to call any method other than recv() or
+ recvfrom() on a closed socket. For streams, the receive methods return data
+ that was received prior to the closing of the socket. For datagram and raw
+ sockets, the receive methods cannot be used on a closed socket.
+</pre>
+</ul >
+<strong>connect</strong>(self, address)
+
+<ul ><pre>
+ Connect to a remote dest, identified in local SAM bridge's hosts file as host
+ 'address'.
+
+ For example:
+
+ >>> s.connect('duck.i2p')
+
+ Alternatively, you can use a full base64 Destination:
+ Example:
+
+ >>> s.connect('238797sdfh2k34kjh....AAAA')
+
+ If connect() is called on a socket that is in non-blocking mode or has a
+ timeout, i2p.socket.BlockError or i2p.socket.Timeout may be raised. This
+ indicates that the connection is still being initiated. Use i2p.select.select()
+ to determine when the connection is ready.
+</pre>
+</ul >
+<strong>connect_ex</strong>(self, address)
+<ul ><pre>
+ Like connect(), but return any error that is raised. Returns None if no error
+ is raised.
+</pre>
+</ul >
+<strong>getpeername</strong>(self)
+
+<ul ><pre>
+ Get the remote Destination associated with the socket. This is equivalent to
+ s.remotedest, and is provided for compatibility with the Python socket module.
+</pre>
+</ul >
+<strong>getsockname</strong>(self)
+<ul ><pre>
+ Get the local Destination associated with the socket. This is equivalent to
+ s.dest, and is provided for compatibility with the Python socket module.
+</pre>
+</ul >
+<strong>gettimeout</strong>(self)
+<ul ><pre>
+ Get the timeout value.
+
+</pre>
+</ul >
+<strong>listen</strong>(self, backlog)
+<ul ><pre>
+ Listen for connections made to the socket. This method must be called before
+ accept(). The backlog argument specifies the maximum number of queued incoming
+ connections.
+</pre>
+</ul >
+<strong>makefile</strong>(self, mode='r', bufsize=-1)
+<ul ><pre>
+ Return a file object for the socket. See socket.makefile() in the Python
+ documentation for more information.
+</pre>
+</ul >
+<strong>recv</strong>(self, bufsize, flags=0)
+
+<ul ><pre>
+ Receive string data from the socket.
+
+ The maximum amount of data to be received is given by bufsize. If bufsize is
+ zero, this function returns an empty string immediately. If bufsize is nonzero,
+ this function blocks until at least one character is available for reading. If
+ the socket has been closed, an empty string is returned as an end of file
+ indicator.
+
+ If recv() is called on a socket that is in non-blocking mode or has a timeout,
+ i2p.socket.BlockError or i2p.socket.Timeout will be raised if data is not
+ available within the given timeframe.
+
+ For a datagram or raw socket, the first bufsize characters of the packet are
+ read, and the remainder of the packet is discarded. To read the entire packet,
+ use bufsize = -1.
+
+ For datagram and raw sockets, the packet may originate from any Destination.
+ Use recvfrom() with datagrams to determine the Destination from which the
+ packet was received.
+
+ The flags argument can be a bitwise OR of MSG_PEEK, MSG_WAITALL, and/or
+ MSG_DONTWAIT. MSG_PEEK indicates that any data read should not be removed from
+ the socket's incoming buffer. MSG_WAITALL indicates to wait for exactly bufsize
+ characters or an error. MSG_DONTWAIT indicates that the recv() command should
+ not block execution.
+</pre>
+</ul >
+<strong>recvfrom</strong>(self, bufsize, flags=0)
+<ul ><pre>
+ Like recv(), but returns a tuple (data, remoteaddr), where data is the string
+ data received, and remoteaddr is the remote Destination.
+</pre>
+</ul >
+<strong>send</strong>(self, string, flags=0)
+<ul ><pre>
+ Sends string data to a remote Destination.
+
+ For a stream, connect() must be called prior to send(). Once close() is called,
+ no further data can be sent, and the stream cannot be re-opened.
+
+ For datagram and raw sockets, connect() only specifies a Destination to which
+ packets are sent to. send() will then send a packet to the given Destination.
+ connect() can be used multiple times.
+
+ The send() command never blocks execution. The flags argument is ignored.
+
+</pre>
+</ul >
+<strong>sendall</strong>(self, string, flags=0)
+<ul ><pre>
+ Identical to send().
+</pre>
+</ul >
+<strong>sendto</strong>(self, string, flags, address)
+<ul ><pre>
+ Send a packet to the given Destination.
+
+ Only valid for datagram and raw sockets. The address argument should be either
+ a name from the hosts file, or a base64 Destination.
+
+ The sendto() command never blocks execution. The flags argument is ignored.
+</pre>
+</ul >
+<strong>setblocking</strong>(self, flag)
+
+<ul ><pre>
+ Set blocking or non-blocking mode for the socket.
+
+ If flag is True, any method called on the socket will hang until the method has
+ completed. If flag is False, all methods will raise i2p.socket.BlockError() if
+ they cannot complete instantly.
+
+ s.setblocking(False) is equivalent to s.settimeout(0); s.setblocking(True) is
+ equivalent to s.settimeout(None).
+</pre>
+</ul >
+<strong>settimeout</strong>(self, value)
+<ul ><pre>
+ Set a timeout for the socket.
+
+ The value argument should be a timeout value in seconds, or None. None is
+ equivalent to an infinite timeout.
+
+ A socket operation will raise a i2p.socket.Timeout if the operation cannot
+ complete within in the specified time limit.
+</pre>
+</ul >
+
+<p>
+
+<h2><a name="Functions"> Functions </a></h2>
+
+<p>
+Functions defined in module <code >i2p.socket</code >:
+
+<p>
+<strong>resolve</strong>(host, samaddr='127.0.0.1:7656')
+<ul >
+
+<pre> Resolve I2P host name --> I2P Destination.
+ Returns the same string if host is already a Destination.
+</pre>
+</ul >
+
+<p>
+
+<h2><a name="Errors"> Errors </a></h2>
+
+<p>
+class <strong>Error</strong>(i2p.Error)
+<ul ><pre>
+ Base class for all SAM errors.
+</pre>
+</ul >
+class <strong>BlockError</strong>(Error)
+
+<ul ><pre>
+ Socket call would have blocked.
+</pre>
+</ul >
+class <strong>ClosedError</strong>(Error)
+<ul ><pre>
+ A command was used on a socket that closed gracefully.
+</pre>
+</ul >
+class <strong>NetworkError</strong>(Error)
+<ul ><pre>
+
+ Network error occurred within I2P.
+
+ The error object is a 2-tuple: (errtag, errdesc).
+ errtag is a SAM error string,
+ errdesc is a human readable error description.
+</pre>
+</ul >
+
+<p>
+
+<h2><a name="Constants"> Constants </a></h2>
+
+<p>
+<strong>Socket types</strong>
+<ul ><pre>
+ SOCK_STREAM = 1
+ SOCK_DGRAM = 2
+ SOCK_RAW = 3
+
+</pre>
+</ul >
+<strong>Packet sizes</strong>
+<ul ><pre>
+ MAX_DGRAM = 31744 # Maximum size for datagram packet
+ MAX_RAW = 32768 # Maximum size for raw packet
+</pre>
+</ul >
+<strong>Flags for recv()</strong>
+<ul ><pre>
+ MSG_DONTWAIT = 128 # Don't block
+ MSG_PEEK = 2 # Peek at incoming data
+ MSG_WAITALL = 64 # Wait for all data or error
+</pre>
+</ul >
+
+<p>
+</div>
+</body></html>
\ No newline at end of file
diff --git a/apps/sam/python/doc/guide/i2p.tunnel.html b/apps/sam/python/doc/guide/i2p.tunnel.html
new file mode 100644
index 0000000000000000000000000000000000000000..b4410a0b42496436da5047f716eab28bbf70c8db
--- /dev/null
+++ b/apps/sam/python/doc/guide/i2p.tunnel.html
@@ -0,0 +1,124 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
+ "http://www.w3.org/TR/html4/loose.dtd">
+<html lang="en"><head><title>User's Guide:i2p.tunnel - Wikipedia</title>
+<meta http-equiv="Content-type" content="text/html; charset=utf-8">
+<meta name="robots" content="index,follow">
+<link rel="shortcut icon" href="/favicon.ico">
+<style type='text/css'><!--
+/*/*/
+a.new, #quickbar a.new { color: #CC2200; }
+#quickbar { position: absolute; top: 4px; left: 4px; border-right: 1px solid gray; }
+#article { margin-left: 152px; margin-right: 4px; }
+/* */
+//--></style>
+</head>
+
+<body bgcolor='#FFFFFF' onload=''>
+<h1 class='pagetitle'>User's Guide:i2p.tunnel</h1><p class='subtitle'>From Python-I2P.
+
+
+<div class='bodytext'>
+Module <code >i2p.tunnel</code > allows data to be exchanged between traditional TCP sockets and I2P sockets.
+
+
+<p>
+
+<h2><a name="Tunnels"> Tunnels </a></h2>
+
+<p>
+Tunnels allow stream sockets to be joined, so that connections to a listening socket are relayed to one or more sending sockets. This allows an ordinary web server to be exposed as an I2P Destination, or an I2P Destination to be bound as a local port, and so on.
+
+<p>
+class <strong>Tunnel</strong>(self, receive, make_send, nconnect=-1, timeout=60.0)
+<ul ><pre>
+ A Tunnel relays connections from a 'receive' socket to one
+ or more 'send' sockets. The receive socket must be bound
+ and listening. For each incoming connection, a new send
+ socket is created by calling make_send(). Data is then
+ exchanged between the created streams until one socket is
+ closed. nconnect is the maximum number of simultaneous
+ connections (-1 for infinite), and timeout is the time that
+ a single connection can last for (None allows a connection
+ to last forever).
+
+ Sockets must accept stream traffic and support the Python
+ socket interface. A separate daemonic thread is created to
+ manage the tunnel. For high performance, make_send() should
+ make a socket and connect in non-blocking mode (you should
+ catch and discard the i2p.socket.BlockError or socket.error
+ due to executing connect on a non-blocking socket).
+
+ Security Note:
+ A firewall is needed to maintain the end user's anonymity.
+ An attacker could keep a tunnel socket open by pinging it
+ regularly. The accepted sockets from 'receive' must prevent
+ this by closing down eventually.
+
+ Socket errors do not cause the Tunnel to shut down.
+</pre>
+</ul >
+
+<p>
+<strong>close</strong>()
+<ul >
+
+<pre> Close all connections made for this tunnel.
+</pre>
+</ul >
+
+<p>
+
+<h3><a name="Tunnel_Server"> Tunnel Server </a></h3>
+
+<p>
+class <strong>TunnelServer</strong>(session, port, samaddr='127.0.0.1:7656', nconnect=-1, timeout=None, **kwargs)
+<ul ><pre>
+ Tunnels incoming SAM streams --> localhost:port.
+
+ nconnect and timeout are the maximum number of connections
+ and maximum time per connection. All other arguments are
+ passed to i2p.socket.socket(). This call blocks until the
+ tunnel is ready.
+</pre>
+</ul >
+
+<p>
+<strong>TunnelServer</strong> properties:
+<ul ><pre>
+
+ dest - I2P Destination of server.
+ session - Session name for server.
+</pre>
+</ul >
+
+<p>
+
+<h3><a name="Tunnel_Client"> Tunnel Client </a></h3>
+
+<p>
+class <strong>TunnelClient</strong>(session, port, dest, samaddr='127.0.0.1:7656', nconnect=-1, timeout=None, **kwargs)
+<ul ><pre>
+ Derived from Tunnel.
+ Tunnels localhost:port --> I2P Destination dest.
+
+ A session named 'session' is created locally, for purposes
+ of routing to 'dest'. nconnect and timeout are the maximum
+ number of connections and maximum time per connection. All
+ other arguments are passed to i2p.socket.socket(). This call
+ blocks until the tunnel is ready.
+
+</pre>
+</ul >
+
+<p>
+<strong>TunnelClient</strong> properties:
+<ul ><pre>
+ dest - Local Destination used for routing.
+ remotedest - Remote Destination.
+ session - Session name for local Destination.
+</pre>
+</ul >
+
+<p>
+</div>
+</body></html>
\ No newline at end of file
diff --git a/apps/sam/python/doc/guide/index.html b/apps/sam/python/doc/guide/index.html
index 3c9f587d0f16e969cfdea1d0f544451511c49b40..a231c44f9f73622ed3458e2fbb5ecea7d30dbf7e 100644
--- a/apps/sam/python/doc/guide/index.html
+++ b/apps/sam/python/doc/guide/index.html
@@ -4,9 +4,7 @@
<meta http-equiv="Content-type" content="text/html; charset=utf-8">
<meta name="robots" content="index,follow">
<link rel="shortcut icon" href="/favicon.ico">
-<script type="text/javascript" src="/~barnesc/wiki/stylesheets/wikibits.js"></script>
<style type='text/css'><!--
-@import url("/~barnesc/wiki/stylesheets/wikiprintable.css");
/*/*/
a.new, #quickbar a.new { color: #CC2200; }
#quickbar { position: absolute; top: 4px; left: 4px; border-right: 1px solid gray; }
@@ -42,8 +40,8 @@ Use:
<p>
<ul ><pre>
->>> from i2p import sam
->>> s = sam.socket('Alice', sam.SOCK_STREAM)
+>>> from i2p import socket
+>>> s = socket.socket('Alice', socket.SOCK_STREAM)
>>> s.connect('duck.i2p')
>>> s.send('GET / HTTP/1.0\r\n\r\n')
>>> s.recv(1000)
@@ -53,6 +51,10 @@ Use:
<p>
+See the <a href="../../src/examples/">src/examples/</a> directory for more code examples.
+
+<p>
+
<h2><a name="User's_Guide"> User's Guide </a></h2>
<p>
@@ -61,16 +63,20 @@ The following modules are available:
<p>
<ul >
-<pre> <a href="./i2p.html" class='printable' title ="User's Guide:i2p">i2p</a> (Container package)
- <a href="./i2p.sam.html" class='printable' title ="User's Guide:i2p.sam">i2p.sam</a> (Send and receive across the I2P network)
- <a href="./i2p.eep.html" class='printable' title ="User's Guide:i2p.eep">i2p.eep</a> (Retrieve eepsites)
- <a href="./i2p.router.html" class='printable' title ="User's Guide:i2p.router">i2p.router</a> (Manage the I2P router)
+<pre> <a href="i2p.html" class='printable' title ="User's Guide:i2p">i2p</a> (Container package)
+ <a href="i2p.BaseHTTPServer.html" class='printable' title ="User's Guide:i2p.BaseHTTPServer">i2p.BaseHTTPServer</a> (Emulate Python BaseHTTPServer module)
+ <a href="i2p.CGIHTTPServer.html" class='printable' title ="User's Guide:i2p.CGIHTTPServer">i2p.CGIHTTPServer</a> (Emulate Python CGIHTTPServer module)
+ <a href="i2p.eep.html" class='printable' title ="User's Guide:i2p.eep">i2p.eep</a> (Retrieve eepsites)
+ <a href="i2p.router.html" class='printable' title ="User's Guide:i2p.router">i2p.router</a> (Manage the I2P router)
+ <a href="i2p.select.html" class='printable' title ="User's Guide:i2p.select">i2p.select</a> (Emulate Python select module)
+ <a href="i2p.SimpleHTTPServer.html" class='printable' title ="User's Guide:i2p.SimpleHTTPServer">i2p.SimpleHTTPServer</a> (Emulate Python SimpleHTTPServer module)
+ <a href="i2p.socket.html" class='printable' title ="User's Guide:i2p.socket">i2p.socket</a> (Send and receive across the I2P network)
+ <a href="i2p.SocketServer.html" class='printable' title ="User's Guide:i2p.SocketServer">i2p.SocketServer</a> (Emulate Python SocketServer module)
+ <a href="i2p.tunnel.html" class='printable' title ="User's Guide:i2p.tunnel">i2p.tunnel</a> (Exchange data between I2P and regular sockets)
</pre>
</ul >
<p>
</div>
-<p><em>
-</em><!-- Time since request: 0.78 secs. -->
-</body></html>
+</body></html>
\ No newline at end of file
diff --git a/apps/sam/python/doc/guide/samproxy.html b/apps/sam/python/doc/guide/samproxy.html
index ff43ebdd67ae93a639e9fba3cc05309a974caae1..60decf1a2263d48e7b2f5e3d10e317e52b0a39b8 100644
--- a/apps/sam/python/doc/guide/samproxy.html
+++ b/apps/sam/python/doc/guide/samproxy.html
@@ -4,9 +4,7 @@
<meta http-equiv="Content-type" content="text/html; charset=utf-8">
<meta name="robots" content="index,follow">
<link rel="shortcut icon" href="/favicon.ico">
-<script type="text/javascript" src="/~barnesc/wiki/stylesheets/wikibits.js"></script>
<style type='text/css'><!--
-@import url("/~barnesc/wiki/stylesheets/wikiprintable.css");
/*/*/
a.new, #quickbar a.new { color: #CC2200; }
#quickbar { position: absolute; top: 4px; left: 4px; border-right: 1px solid gray; }