Almost valid xhtml at this point. (b1c9b3adb) - tor-webwml.git

new-contribute.html
@@ -39,144 +39,202 @@
 <div class="main-column">
 
 <!-- PUT CONTENT AFTER THIS TAG -->
-<pre>
-    Six things everyone can do now:
+    <h2>Six things everyone can do now:</h2>
     <ol>
-    <li> We need users like you to try Tor out, and let the Tor
-    developers know about bugs you find or features you don't find.</li>
-    <li> Please consider running a server to help the Tor network
-    grow.</li>
-    <li> We especially need people with Windows programming skills to run
-    an exit server on Windows, to help us debug.</li>
+    <li> We need users like you to try Tor out, and let the Tor developers know about bugs you find or features you don't find.</li>
+    <li> Please consider running a server to help the Tor network grow.</li>
+    <li> We especially need people with Windows programming skills to run an exit server on Windows, to help us debug.</li>
     <li> Run a Tor hidden service and put interesting content on it.</li>
-    <li> Tell your friends! Get them to run servers. Get them to run hidden
-    services. Get them to tell their friends.</li>
-    <li> Consider joining the Electronic Frontier Foundation. More EFF
-    donations means more freedom in the world, including more Tor
-    development.</li>
+    <li> Tell your friends! Get them to run servers. Get them to run hidden services. Get them to tell their friends.</li>
+    <li> Consider joining the Electronic Frontier Foundation. More EFF donations means more freedom in the world, including more Tor development.</li>
     </ol>
 
-****coding challenges****
+<h2>Coding Challenges</h2>
 	**easy**
 	**medium**
 	**hard**
-  - Update crypto usage to use openssl aes when available.
-  - Implement a buffer design modelled after the linux kernel buffer design.
-  - how do ulimits work on win32, anyway?  (We should handle WSAENOBUFS as needed, look at the MaxConnections registry entry, look at the MaxUserPort entry, and look at the TcpTimedWaitDelay entry. We may also want to provide a way to set them as needed. See bug 98.)
-  - Implement reverse DNS (already specified)
-  - Implement a FirewalledIPs config option that works like FirewallPorts.
-  - Make configure.in handle cross-compilation
-    - Have NULL_REP_IS_ZERO_BYTES default to 1.
-    - Make with-ssl-dir disable search for ssl.
-  - Implement preservation of reputation through reboots for clients and dirservers. 
-  - Add in support egd or other non-OS-integrated strong entropy sources.
-  - Implement password protection for on-disk identity key
-  - Implement a way to get autoconf to install things into ~/.tor.
-  - Change server descriptors to declare log level.
-  - Add in support for clients to avoid servers that are too loggy based upon user configuration of acceptable log level.
-  - Separate node discovery from routing to allow neat extensions. [Goodell?]
-    - Add SetServerStatus control event to adjust verified/running status of nodes.
-    - Add NoDownload config option to prevent regular directory downloads from happening.
-  - Choosing exit node by meta-data, e.g. country.
-  - Use cpuworker for more heavy lifting.
-    - Signing (and verifying) hidserv descriptors
-    - Signing (and verifying) intro/rend requests
-    - Signing (and verifying) router descriptors
-    - Signing (and verifying) directories
-    - Doing TLS handshake (this is very hard to separate out, though)
-  - Buffer size pool: allocate a maximum size for all buffers, not a maximum size for each buffer. So we don't have to give up as quickly (and kill the thickpipe!) when there's congestion.
-  - Add alternative versions of crypto.c and tortls.c to use libnss or libgcrypt+gnutls.
-  - Implement a way to stop falling back to forbidden ports when FascistFirewall blocks all good dirservers, if there is already a good, cached directory locally.
-  - Extend our NSIS-based windows installer to include FreeCap and/or Privoxy.
-  - Develop a way to handle OS X installation and uninstallation.
-  - Develop a GUI or other controller program, to do configuration, etc. See our control specification for details, and the rudimentary demonstration Python control script. 
-  	-Design an interface for the control program. You can use any license you want, but we'd recommend 3-clause BSD or maybe GPL; and we can only help out if your license conforms to the DFSG.
-    - Periodically people running servers tells us they want to have one BandwidthRate during some part of the day, and a different BandwidthRate at other parts of the day. Rather than coding this inside Tor, we should have a little script that speaks via the Tor Controller Interface, and does a setconf to change the bandwidth rate. Perhaps it would run out of cron, or perhaps it would sleep until appropriate times and then do its tweak (that's probably more portable). Can somebody write one for us and we'll put it inside tor/contrib/?
-    - Develop a way to become a Windows NT service.  
-    - Develop a systray app for Tor under MS Windows (all versions). 
-    - Integrate a good (portable, fast, clean, BSD-free) asynchronous DNS library so we don't have to keep forking DNS worker threads to do gethostbyname.
-
-****documentation challenges****
+<ul>
+<li>Update crypto usage to use openssl aes when available.</li>
+<li>Implement a buffer design modelled after the linux kernel buffer design.</li>
+<li>how do ulimits work on win32, anyway?  (We should handle WSAENOBUFS as needed, look at the MaxConnections registry entry, look at the MaxUserPort entry, and look at the TcpTimedWaitDelay entry. We may also want to provide a way to set them as needed. See bug 98.)</li>
+<li>Implement reverse DNS (already specified)</li>
+<li>Implement a FirewalledIPs config option that works like FirewallPorts.</li>
+<li>Make configure.in handle cross-compilation</li>
+<li>Have NULL_REP_IS_ZERO_BYTES default to 1.</li>
+<li>Make with-ssl-dir disable search for ssl.</li>
+<li>Implement preservation of reputation through reboots for clients and dirservers. </li>
+<li>Add in support egd or other non-OS-integrated strong entropy sources.</li>
+<li>Implement password protection for on-disk identity key</li>
+<li>Implement a way to get autoconf to install things into ~/.tor.</li>
+<li>Change server descriptors to declare log level.</li>
+<li>Add in support for clients to avoid servers that are too loggy based upon user configuration of acceptable log level.</li>
+<li>Separate node discovery from routing to allow neat extensions.  [Goodell?]</li>
+<ul>
+<li>Add SetServerStatus control event to adjust verified/running status of nodes.</li>
+<li>Add NoDownload config option to prevent regular directory downloads from happening.</li>
+</ul>
+<li>Choosing exit node by meta-data, e.g. country.</li>
+<li>Use cpuworker for more heavy lifting.</li>
+<ul>
+<li>Signing (and verifying) hidserv descriptors</li>
+<li>Signing (and verifying) intro/rend requests</li>
+<li>Signing (and verifying) router descriptors</li>
+<li>Signing (and verifying) directories</li>
+<li>Doing TLS handshake (this is very hard to separate out, though)</li>
+</ul>
+<li>Buffer size pool: allocate a maximum size for all buffers, not a maximum size for each buffer. So we don't have to give up as quickly (and kill the thickpipe!) when there's congestion.</li>
+<li>Add alternative versions of crypto.c and tortls.c to use libnss or libgcrypt+gnutls.</li>
+<li>Implement a way to stop falling back to forbidden ports when FascistFirewall blocks all good dirservers, if there is already a good, cached directory locally.</li>
+<li>Extend our NSIS-based windows installer to include FreeCap and/or Privoxy.</li>
+<li>Develop a way to handle OS X installation and uninstallation.</li>
+<li>Develop a GUI or other controller program, to do configuration, etc.  See our control specification for details, and the rudimentary demonstration Python control script. </li>
+<ul>
+<li>Design an interface for the control program. You can use any license you want, but we'd recommend 3-clause BSD or maybe GPL; and we can only help out if your license conforms to the DFSG.</li>
+<li>Periodically people running servers tells us they want to have one
+    BandwidthRate during some part of the day, and a different
+    BandwidthRate at other parts of the day. Rather than coding this
+    inside Tor, we should have a little script that speaks via the Tor
+    Controller Interface, and does a setconf to change the bandwidth
+    rate. Perhaps it would run out of cron, or perhaps it would sleep
+    until appropriate times and then do its tweak (that's probably more
+    portable). Can somebody write one for us and we'll put it inside
+    tor/contrib/?</li>
+</ul>
+<li>Develop a way to become a Windows NT service.  </li>
+<li>Develop a systray app for Tor under MS Windows (all versions).  </li>
+<li>Integrate a good (portable, fast, clean, BSD-free) asynchronous DNS library so we don't have to keep forking DNS worker threads to do gethostbyname.</li>
+</ul>
+
+<h2>Documentation Challenges</h2>
 	**easy**
 	**medium**
 	**hard**
-
-  - Write server instructions for OSX and Windows operators.
-  - Improve and clarify the wiki entry on port forwarding. url?
-  - Document how to do exit node caching: tie into squid or other caching web proxy.
-  - Help maintain this website; code, content, css, overall layout,
-  - Help with documentation 
-  - Help consolidate documentation.  We may have too much documentation. It's spread out too far and duplicates itself in places. 
-  - Help translate the web page and documentation into other languages. See the translation guidelines if you want to help out. (Examples: French , Persian and Vietnamese.)
-  - If you know the answer to a Wiki question in the "unanswered FAQs" list, please answer it. url?
-  - Take a look at Martin's Squid and Tor page, and update it to reflect Tor's RedirectExit config option. url?
-
-****testing challenges****
+<ul>
+<li>Write server instructions for OSX and Windows operators.</li>
+<li>Improve and clarify the wiki entry on port forwarding. url?</li>
+<li>Document how to do exit node caching: tie into squid or other caching web proxy.</li>
+<li>Help maintain this website; code, content, css, overall layout,</li>
+<li>Help with documentation </li>
+<li>Help consolidate documentation.  We may have too much documentation.  It's spread out too far and duplicates itself in places. </li>
+<li>Help translate the web page and documentation into other languages.  See the translation guidelines if you want to help out. (Examples: French , Persian and Vietnamese.)</li>
+<li>If you know the answer to a Wiki question in the "unanswered FAQs" list, please answer it. url?</li>
+<li>Take a look at Martin's Squid and Tor page, and update it to reflect Tor's RedirectExit config option. url?</li>
+</ul>
+
+<h2>Testing Challenges</h2>
 	**easy**
 	**medium**
 	**hard**
-
-  - Test out why some of our tor servers have dns resolvers that resolve unknown addresses to 127.0.0.1.  
-  	- Identify the servers that experience this issue. 
-	- Identify how to cause and repair the issue in BIND, DJBDNS, or whatever daemon the misconfigured servers use.
-  - Figure out how to setup web proxy gateways to let normal people browse hidden services.  (This has been done a few times, but nobody has sent us code.)
-  - Investigate privoxy vs. freecap for win32 clients
-  - Evaluate, create, and document a list of programs that work with Tor.  
-  - Perform a security analysis of Tor with "fuzz". Determine if there good libraries out there for what we want. Win fame by getting credit when we put out a new release because of you!
-  - Website volume fingerprinting attacks (Back et al, Hintz). Defenses include a large cell size, defensive dropping, etc. How well does each approach work?
-  - The end-to-end traffic confirmation attack. We need to study long-range dummies more, along with traffic shaping. How much traffic of what sort of distribution is needed before the adversary is confident he has won?
-  - Determine what sensitive info squeaks by privoxy. 
-  - Deteremine if there are other html scrubbers that are better than privoxy.
-
-****research challenges****
+<ul>
+<li>Test out why some of our tor servers have dns resolvers that resolve
+unknown addresses to 127.0.0.1.</li>
+<ul>
+<li>Identify the servers that experience this issue. </li>
+<li>Identify how to cause and repair the issue in BIND, DJBDNS, or
+whatever daemon the misconfigured servers use.</li>
+</ul>
+<li>Figure out how to setup web proxy gateways to let normal people
+browse hidden services.  (This has been done a few times, but nobody has
+sent us code.)</li>
+<li>Investigate privoxy vs. freecap for win32 clients</li>
+<li>Evaluate, create, and document a list of programs that work with
+Tor.  </li>
+<li>Perform a security analysis of Tor with "fuzz". Determine if there
+good libraries out there for what we want. Win fame by getting credit
+when we put out a new release because of you!</li>
+<li>Website volume fingerprinting attacks (Back et al, Hintz). Defenses
+include a large cell size, defensive dropping, etc. How well does each
+approach work?</li>
+<li>The end-to-end traffic confirmation attack. We need to study
+long-range dummies more, along with traffic shaping. How much traffic of
+what sort of distribution is needed before the adversary is confident he
+has won?</li>
+<li>Determine what sensitive info squeaks by privoxy. </li>
+<li>Deteremine if there are other html scrubbers that are better than
+privoxy.</li>
+</ul>
+
+<h2>Research Challenges</h2>
 	**easy**
 	**medium**
 	**hard**
-
-  - Arranging membership management for independence.
-    Sybil defenses without having a human bottleneck.
-    How to gather random sample of nodes.
-    How to handle nodelist recommendations.
-    Consider incremental switches: a p2p tor with only 50 users has
-      different anonymity properties than one with 10k users, and should
-      be treated differently.
-  - Incentives to relay; incentives to exit.
-  - Allowing dissidents to relay through Tor clients.
-  - Experiment with mid-latency systems. How do they impact usability,
-    how do they impact safety?
-  - Understand how powerful fingerprinting attacks are, and experiment
-    with ways to foil them (long-range padding?).
-  - Come up with practical approximations to picking entry and exit in
-    different routing zones.
-  - Find ideal churn rate for helper nodes; how safe is it?
-  - Attacking freenet-gnunet/timing-delay-randomness-arguments.
-  - Is exiting from the middle of the circuit always a bad idea?
-  - IPv6 support (For exit addresses)
-    - Spec issue: if a resolve returns an IP4 and an IP6 address,
-      which to use?
-    - Add to exit policy code
-    - Make tor_gethostbyname into tor_getaddrinfo
-    - Make everything that uses uint32_t as an IP address change to use
-      a generalize address struct.
-    - Change relay cell types to accept new addresses.
-    - Add flag to serverdescs to tell whether IPv6 is supported.
-  - patch tsocks with our current patches + gethostbyname, getpeername, etc.
-  - make freecap (or whichever) do what we want.
-  - scrubbing proxies for protocols other than http.
-  - We need better default privoxy configs to ship.
-  - We need a good scrubbing HTTP proxy; privoxy is unmaintained and sucky.
-  - A DNS proxy would let unmodified socks4/socks5 apps to work well.
-  - Add SOCKS support to more applications
-  - store hidden service information to disk: dirservers forget service
+<ul>
+<li>Arranging membership management for independence.</li>
+<ul>
+<li>Sybil defenses without having a human bottleneck.</li>
+<li>How to gather random sample of nodes.</li>
+<li>How to handle nodelist recommendations.</li>
+<li>Consider incremental switches: a p2p tor with only 50 users has
+different anonymity properties than one with 10k users, and should be
+treated differently.</li>
+</ul>
+<li>Incentives to relay; incentives to exit.</li>
+<li>Allowing dissidents to relay through Tor clients.</li>
+<li>Experiment with mid-latency systems. How do they impact usability,
+    how do they impact safety?</li>
+<li>Understand how powerful fingerprinting attacks are, and experiment
+    with ways to foil them (long-range padding?).</li>
+<li>Come up with practical approximations to picking entry and exit in
+    different routing zones.</li>
+<li>Find ideal churn rate for helper nodes; how safe is it?</li>
+<li>Attacking freenet-gnunet/timing-delay-randomness-arguments.</li>
+<li>Is exiting from the middle of the circuit always a bad idea?</li>
+<li>IPv6 support (For exit addresses)</li>
+<ul>
+<li>Spec issue: if a resolve returns an IP4 and an IP6 address,
+      which to use?</li>
+<li>Add to exit policy code</li>
+<li>Make tor_gethostbyname into tor_getaddrinfo</li>
+<li>Make everything that uses uint32_t as an IP address change to use
+      a generalize address struct.</li>
+<li>Change relay cell types to accept new addresses.</li>
+<li>Add flag to serverdescs to tell whether IPv6 is supported.</li>
+</ul>
+<li>patch tsocks with our current patches + gethostbyname, getpeername,
+etc.</li>
+<li>make freecap (or whichever) do what we want.</li>
+<li>scrubbing proxies for protocols other than http.</li>
+<li>We need better default privoxy configs to ship.</li>
+<li>We need a good scrubbing HTTP proxy; privoxy is unmaintained and
+sucky.</li>
+<li>A DNS proxy would let unmodified socks4/socks5 apps to work
+well.</li>
+<li>Add SOCKS support to more applications</li>
+<li>store hidden service information to disk: dirservers forget service
 descriptors when they restart; nodes offering hidden services forget
-    their chosen intro points when they restart.
-  - It's not that hard to DoS Tor servers or dirservers. Are puzzles the right answer? What other practical approaches are there?
-    - Server CPU load is high because clients keep asking to make new circuits, which uses public key crypto. Possible defenses include: using helper nodes (fixed entry nodes); rate limiting the number of create cells handled per second; having clients retry failed extensions a few times; implementing ssl sessions; and using hardware crypto when available.
-    - We fear we might not work very well when servers have asymmetric bandwidth. Because Tor has separate TCP connections between each hop, if the incoming bytes are arriving just fine and the outgoing bytes are all getting dropped on the floor, the TCP push-back mechanisms don't really transmit this information back to the incoming streams. Perhaps Tor should detect when it's dropping a lot of outgoing packets, and rate-limit incoming streams to regulate this itself? We need somebody who's good with networks to simulate this and help design solutions.
-    - Right now the hidden service descriptors are being stored on the dirservers, but any reliable distributed storage system would do (for example, a DHT that allows authenticated updates). Can somebody figure out our best options and decide if they're good enough?
-    - How hard is it to patch bind or a DNS proxy to redirect requests to Tor via our tor-resolve socks extension? What about to convert UDP DNS requests to TCP requests and send them through Tor?
-    - Tor provides anonymous connections, but if you want to keep multiple pseudonyms in practice (say, in case you frequently go to two websites and if anybody knew about both of them they would conclude it's you), we don't support that well yet. We should find a good approach and interface for handling pseudonymous profiles in Tor. See this post and followup for details.
-  - Congestion control. Is our current design sufficient once we have heavy use? Need to measure and tweak, or maybe overhaul.
+their chosen intro points when they restart.</li>
+<li>It's not that hard to DoS Tor servers or dirservers. Are puzzles the
+right answer? What other practical approaches are there?</li>
+<li>Server CPU load is high because clients keep asking to make new
+circuits, which uses public key crypto. Possible defenses include: using
+helper nodes (fixed entry nodes); rate limiting the number of create
+cells handled per second; having clients retry failed extensions a few
+times; implementing ssl sessions; and using hardware crypto when
+available.</li>
+<li>We fear we might not work very well when servers have asymmetric
+bandwidth. Because Tor has separate TCP connections between each hop, if
+the incoming bytes are arriving just fine and the outgoing bytes are all
+getting dropped on the floor, the TCP push-back mechanisms don't really
+transmit this information back to the incoming streams. Perhaps Tor
+should detect when it's dropping a lot of outgoing packets, and
+rate-limit incoming streams to regulate this itself? We need somebody
+who's good with networks to simulate this and help design
+solutions.</li>
+<li>Right now the hidden service descriptors are being stored on the
+dirservers, but any reliable distributed storage system would do (for
+example, a DHT that allows authenticated updates). Can somebody figure
+out our best options and decide if they're good enough?</li>
+<li>How hard is it to patch bind or a DNS proxy to redirect requests to
+Tor via our tor-resolve socks extension? What about to convert UDP DNS
+requests to TCP requests and send them through Tor?</li>
+<li>Tor provides anonymous connections, but if you want to keep multiple
+pseudonyms in practice (say, in case you frequently go to two websites
+and if anybody knew about both of them they would conclude it's you), we
+don't support that well yet. We should find a good approach and
+interface for handling pseudonymous profiles in Tor. See this post and
+followup for details.</li>
+<li>Congestion control. Is our current design sufficient once we have
+heavy use? Need to measure and tweak, or maybe overhaul.</li>
 
 Drop by the #tor IRC channel at irc.oftc.net or email tor-volunteer@freehaven.net if you want to help out!
 
