tor_extend 1.0.2

data/Change.log

@@ -0,0 +1,12 @@
+Changes since version 1.0.1 -> 1.0.2
+~~~~~~~~~~~~~~~~~~~~~~~
+
+1. Added Tor::TController.ds : returns ["w.x.y.z:port", ...]
+2. Removed the Tor::Cacheddesc.ds
+3. Removed the database column for dssource
+4. Added a few more documentation to the source
+
+# version 1.0.3
+Added circuit.rb
+added class Circuit, and methods including Circuit.built?
+-extending.... almost done

data/ReadME.txt

@@ -0,0 +1,190 @@
+Please see the Unlicence disclaimer in Bendiken's tor-ruby gem.
+
+<b>Installation instruction </b>
+
+Run "gem install tor_extend"
+
+If internet connection is available, it will install the Bendiken's Tor gem as well if it is not already installed. As well as socksify
+For offline users, obtain a local copy of the Tor gem and install before proceeding. 
+Visit Bendiken's page[http://cypherpunk.rubyforge.org/tor/] for details on .
+
+ri documentation included with examples.
+Run "ri Tor::TController" after install to see examples.
+
+<b>Examples</b>.
+
+- How to use Tor control
+
+    require 'tor_extend'
+    proxy_config={:type=>'tor' ,:port=>9050,:addr=>'127.0.0.1'},
+    tor_config={:host=>'127.0.0.1',:port => 9051}
+    x=Tor::TController.new(tor_config)
+    x.connect
+    x.authenticate("\"test1234\"")
+    x.authenticate("\"TorCtrlPasswd\"")
+    x.setconf("__DisablePredictedCircuits",1)
+    x.setconf('orport',9001)
+    x.signal("HUP")
+    x.cir_status
+    x.net_status
+    x.getinfo("stream-status")
+    x.getconf('orport')
+    x.sr(:resetconf,'orport')
+    x.extendcir(0, [A,B,C,D,E,F,G] )
+    x.extendcir_slowly([A,B,C,D,E,F,G] )
+    x.ds     => ["a.b.c.d:z", "e.f.g.h:y",...]   
+
+*Note*: The sr() function sends protocol messages and retrieves the response up to the next "250 OK" or error "5YZ". 
+It can send the setevents protocol command, but more work has to be done to receive and filter the events. 
+The delay used by between extendcir_slowly() can be altered by setting Tor::EXTEND_DELAY. The default is 2 seconds.
+
+
+- Reading cached descriptor.
+
+    require "tor_extend"
+    geoipdb=["/home/seun/dat/GeoLiteCityAug.dat","/home/seun/dat/GeoLiteCityJuly.dat"]
+    cacheddf = Tor::CachedDesc.new geoipdb
+    Tor::CachedDesc.dbconnect
+    dbconfig={:adapter => "sqlite3",:database => "db.sqlite3"}
+    Tor::CachedDesc.dbconnect(dbconfig)
+    Tor::CachedDesc.readall("cached_descriptor_filename")
+    Tor::CachedDesc.stat.get_latlng "countrycode" = [latitude, longitude]
+    Tor::CachedDesc.stat.continent_list
+    Tor::CachedDesc.stat.continent_stat(Tor::CachedDesc.stat.continent_list)
+    Tor::CachedDesc.stat.continent_stat(["EU","NA","AS"])
+    Tor::CachedDesc.stat.continent_stat_uniq(["EU","NA","AS"])
+    Tor::CachedDesc.stat.continent_stat_uniq("EU", "UNIX")
+    Tor::CachedDesc.stat.continent_count "EU"
+    Tor::CachedDesc.stat.continent_count_uniq "EU"
+    Tor::CachedDesc.stat.continent_getfingerprint "EU"
+    Tor::CachedDesc.country_count("FR")
+    Tor::CachedDesc.country_count("FR","UNIX")
+    Tor::CachedDesc.country_count( ["FR","DE"] ,[ "UNIX", "LINUX" ] )
+    Tor::CachedDesc.stat.country_stat(Tor::CachedDesc.stat.country_list)
+    Tor::CachedDesc.stat.country_stat(Tor::CachedDesc.stat.country_list, "UNIX")
+    Tor::CachedDesc.stat.country_stat_uniq(["FR","UK"])
+    Tor::CachedDesc.stat.country_stat(["FR","UK"], "WINDOWS")
+    Tor::CachedDesc.stat.country_stat_uniq(["FR","UK"], ["WINDOWS","UNIX"])
+    Tor::CachedDesc.stat.country_stat(["FR","UK"], "OTHERS")
+    Tor::CachedDesc.stat.topcountries(10)
+    Tor::CachedDesc.stat.topcountries_uniq(10)
+    Tor::CachedDesc.stat.topcountries_uniq(10,"UNIX")
+    Tor::CachedDesc.stat.topcountries_uniq(10,["UNIX","LINUX"])
+    Tor::CachedDesc.stat.country_getip("FR")
+    xml = Tor::CachedDesc.stat.genkml("Onion Routers")  
+    xml = Tor::CachedDesc.stat.genkml("Windows Onion Routers","WINDOWS")
+    Tor::CachedDesc.each{ }      => each Router table entry
+    Tor::CachedDesc.ors          => active record table if you know what you're doing
+    Tor::CachedDesc.ors  => 
+    proxy_config={:type=>'polipo' ,:port=>8118,:addr=>'127.0.0.1'},
+    url = URI.parse "https://bridges.torproject.org/
+    x.getbridges(url, cachedf, proxy_config)
+
+    Tor::Router(id: integer, ipaddr: string, platform: text, fingerprint: string, city: string, country: string,
+                       country_code: string, continent: string, dssource: string, lat: decimal, lng: decimal,
+                       published_at: datetime, created_at: datetime, updated_at: datetime)
+
+
+- <b>KML</b>
+
+Only uniq ORs are placed in the KML string returned. Two tours are also generated; the first going around the world, using 
+different countries as the center, with ballons popping up at some locations if available.
+
+The locations in each country are numbered from 1 to country_count_uniq(), which is the order they appear in Google Earth
+under each folder. The keys represent the view centres that are used when opening ballon descriptions of the values.
+The default tour is shown below
+
+    WORLDTOUR={"ZA" => ["ZA1","NA1","KE1"],
+               "BJ" => ["BJ1","A11","NG1","CI1","SN1","DZ1","MA1","EG1","TN1"], 
+               "CH" => ["FR1","ES1","LU1","GB1","BE1","NL1","DE1","IT1","IE1","AT1","SE1","DK1","UA1"],
+               "UA" => ["SA1","TR1","SY1","RU1","IR1"],
+               "IN" => ["IN1","KZ1","CN1","TH1","PK1"],
+               "AU" => ["AU1","NC1"],
+               "PY" => ["PY1","BR1","AR1","CL1"],
+               "US" => ["US1","US2","US3","US4","CA1","MX1"],
+               "FR" => ["FR1"] }
+
+A different tour can be set by defining WORLDTOUR constant in the Tor moodule
+
+    Tor::WORLDTOUR = {"AU"=>["GB1","FR1","US1","DE1"]}
+
+
+The second tour uses a coordinate(:lat,:lng) as centre, and 2 arrays of 'red' ORs and 'black'. All locations remain green, The 'red' points are set black, and all 'black' location goes from green to black one at a time every 2 seconds. 
+Tor::Constants::ATTACK_TOUR is used by default. This can also be changed by defining Tor::ATTACK_TOUR constant.
+The default attack tour is shown below
+ 
+    ATTACK_TOUR = {:lat   => 46.0,
+                   :lng   => 2.0,
+                   "red"  => (1..90).collect{|eachnum| "FR" + eachnum.to_s},
+                   "black"=> (91..200).collect{|eachnum| "FR" + eachnum.to_s} }
+
+-    <b>Customizing the Tour</b>.
+
+    Tor::ATTACK_TOUR = { :lat  =>cachedf.stat.get_latlng("US")[0],
+                         :lng  =>cachedf.stat.get_latlng("US")[1],
+                         'red' =>['US1','US2','US3','US10'],
+                         'black' =>['US4','US5','US6','US12']}
+
+*OR*
+
+    Tor::ATTACK_TOUR = { :lat  =>Tor::Constants::COUNLATLNG["US"][:lat],
+                         :lng  =>Tor::Constants::COUNLATLNG["US"][:lng],
+                         'red' =>['US1','US2','US3','US10'],
+                         'black' =>['US4','US5','US6','US12']}
+
+-    <b>Reset using this</b>: 
+    Tor::ATTACK_TOUR=Tor::Constants::ATTACK_TOUR
+    if the country is not defined, define a constant Tor::COUNLATLNG, get_latlng() will check it automatically.
+
+    cachedf.stat.get_latlng("AV")
+    AV,  - not in the country-latitude file, using cordinates(0,0)
+     => [0.0, 0.0] 
+
+    Tor::COUNLATLNG = {"AV"=>{:lat=>1, :lng=>1}}
+    cachedf.stat.get_latlng("AV")
+    => [1, 1] 
+
+
+
+<b> Obtain bridges</b>.
+
+Some of these fingerprints might have changed, but you can obtain fast relays for the test below
+
+    require 'tor_extend'
+    geoipdb=["/home/seun/dat/GeoLiteCityOct.dat","/home/seun/dat/GeoLiteCityJuly.dat"]
+    cachedf = Tor::CachedDesc.new geoipdb
+    cachedf.dbconnect
+    cachedf.readall("/home/seun/.tor/cached-descriptors")
+    cachedf.readall("/home/seun/.tor/cached-descriptors.new")
+    tctrl={:host=>'127.0.0.1',:port => 9051}
+    ctrlpasswd="mycontrolpassword"
+    proxyconfig={:type=>'polipo' ,:port=>8118, :addr=>'127.0.0.1'}
+    mytor=Tor::TController.new(tctrl)
+    # mytor.connect
+    mytor.authenticate "\"#{ctrlpasswd}\""
+    mytor.closeallcircuits
+    puts mytor.cir_status
+    A= [ "FateTestarrosa", "mindfields", "BeMyGuest" , "$AE55AECC4C68573F32F0ECFF6303A3FAEFFCD70E" ] +  mytor.get_entryguards
+    # A can be mytor.get_purposeip("fast guard")
+    B= ["GreenLantern", "atlgonyovLi", "bauruine1" ]
+    # or use B = mytor.get_purposeip("fast !exit !guard")
+    # But B can also be an guard or exit relay, no restrictions
+    C = mytor.get_purposeip("exit fast")
+    url = URI.parse "https://bridges.torproject.org/"
+    C.count.times{|z|
+        entryg = A[rand(A.count)]
+        relayg = B[rand(B.count)]
+        exitn  = C[z]
+        circuit1 = [entryg,relayg, exitn]
+        cir_num = mytor.extendcir(0, circuit1)
+        if mytor.cir_status.detect{|p| p =~ /#{cir_num} BUILT/}
+            mytor.get_bridges(url,cachedf)
+        else
+            sleep(2)
+            puts mytor.get_bridges( url, cachedf )    #bridges are added to the database automatically
+        end 
+    }
+
+
+more results can be obtained using all exits, instead of just fast exits.
+Or other distributed networks.

data/doc/ReadME_txt.html

@@ -0,0 +1,301 @@
+<!DOCTYPE html>
+
+<html>
+<head>
+<meta content="text/html; charset=UTF-8" http-equiv="Content-Type">
+
+<title>ReadME</title>
+
+<link type="text/css" media="screen" href="./rdoc.css" rel="stylesheet">
+
+<script type="text/javascript">
+  var rdoc_rel_prefix = "./";
+</script>
+
+<script type="text/javascript" charset="utf-8" src="./js/jquery.js"></script>
+<script type="text/javascript" charset="utf-8" src="./js/navigation.js"></script>
+<script type="text/javascript" charset="utf-8" src="./js/search_index.js"></script>
+<script type="text/javascript" charset="utf-8" src="./js/search.js"></script>
+<script type="text/javascript" charset="utf-8" src="./js/searcher.js"></script>
+<script type="text/javascript" charset="utf-8" src="./js/darkfish.js"></script>
+
+
+<body class="file">
+<nav id="metadata">
+  <nav id="home-section" class="section">
+  <h3 class="section-header">
+    <a href="./index.html">Home</a>
+    <a href="./table_of_contents.html#classes">Classes</a>
+    <a href="./table_of_contents.html#methods">Methods</a>
+  </h3>
+</nav>
+
+
+  <nav id="search-section" class="section project-section" class="initially-hidden">
+  <form action="#" method="get" accept-charset="utf-8">
+    <h3 class="section-header">
+      <input type="text" name="search" placeholder="Search" id="search-field"
+             title="Type to search, Up and Down to navigate, Enter to load">
+    </h3>
+  </form>
+
+  <ul id="search-results" class="initially-hidden"></ul>
+</nav>
+
+
+  <div id="project-metadata">
+    <nav id="fileindex-section" class="section project-section">
+  <h3 class="section-header">Pages</h3>
+
+  <ul>
+  
+    <li class="file"><a href="./ReadME_txt.html">ReadME</a>
+  
+  </ul>
+</nav>
+
+    <nav id="classindex-section" class="section project-section">
+  <h3 class="section-header">Class and Module Index</h3>
+
+  <ul class="link-list">
+  
+    <li><a href="./Tor.html">Tor</a>
+  
+    <li><a href="./Tor/Bridge.html">Tor::Bridge</a>
+  
+    <li><a href="./Tor/CachedDesc.html">Tor::CachedDesc</a>
+  
+    <li><a href="./Tor/Constants.html">Tor::Constants</a>
+  
+    <li><a href="./Tor/Router.html">Tor::Router</a>
+  
+    <li><a href="./Tor/StatsObj.html">Tor::StatsObj</a>
+  
+    <li><a href="./Tor/TController.html">Tor::TController</a>
+  
+  </ul>
+</nav>
+
+  </div>
+</nav>
+
+<div id="documentation" class="description">
+  
+<p>Please see the Unlicence disclaimer in Bendiken’s tor-ruby gem.</p>
+
+<p><strong>Installation instruction </strong></p>
+
+<p>Run “gem install tor_extend”</p>
+
+<p>If internet connection is available, it will install the Bendiken’s <a
+href="Tor.html">Tor</a> gem as well if it is not already installed. As well
+as socksify For offline users, obtain a local copy of the <a
+href="Tor.html">Tor</a> gem and install before proceeding.  Visit
+Bendiken’s <a href="http://cypherpunk.rubyforge.org/tor/">page</a> for
+details on .</p>
+
+<p>ri documentation included with examples. Run “ri Tor::TController” after
+install to see examples.</p>
+
+<p><strong>Examples</strong>.</p>
+<ul><li>
+<p>How to use <a href="Tor.html">Tor</a> control</p>
+
+<pre class="ruby"><span class="ruby-identifier">require</span> <span class="ruby-string">'tor_extend'</span>
+<span class="ruby-identifier">proxy_config</span>={:<span class="ruby-identifier">type=</span><span class="ruby-operator">&gt;</span><span class="ruby-string">'tor'</span> ,:<span class="ruby-identifier">port=</span><span class="ruby-operator">&gt;</span><span class="ruby-value">9050</span>,:<span class="ruby-identifier">addr=</span><span class="ruby-operator">&gt;</span><span class="ruby-string">'127.0.0.1'</span>},
+<span class="ruby-identifier">tor_config</span>={:<span class="ruby-identifier">host=</span><span class="ruby-operator">&gt;</span><span class="ruby-string">'127.0.0.1'</span>,:<span class="ruby-identifier">port</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-value">9051</span>}
+<span class="ruby-identifier">x</span>=<span class="ruby-constant">Tor</span><span class="ruby-operator">::</span><span class="ruby-constant">TController</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">tor_config</span>)
+<span class="ruby-identifier">x</span>.<span class="ruby-identifier">connect</span>
+<span class="ruby-identifier">x</span>.<span class="ruby-identifier">authenticate</span>(<span class="ruby-string">&quot;\&quot;test1234\&quot;&quot;</span>)
+<span class="ruby-identifier">x</span>.<span class="ruby-identifier">authenticate</span>(<span class="ruby-string">&quot;\&quot;TorCtrlPasswd\&quot;&quot;</span>)
+<span class="ruby-identifier">x</span>.<span class="ruby-identifier">setconf</span>(<span class="ruby-string">&quot;__DisablePredictedCircuits&quot;</span>,<span class="ruby-value">1</span>)
+<span class="ruby-identifier">x</span>.<span class="ruby-identifier">setconf</span>(<span class="ruby-string">'orport'</span>,<span class="ruby-value">9001</span>)
+<span class="ruby-identifier">x</span>.<span class="ruby-identifier">signal</span>(<span class="ruby-string">&quot;HUP&quot;</span>)
+<span class="ruby-identifier">x</span>.<span class="ruby-identifier">cir_status</span>
+<span class="ruby-identifier">x</span>.<span class="ruby-identifier">net_status</span>
+<span class="ruby-identifier">x</span>.<span class="ruby-identifier">getinfo</span>(<span class="ruby-string">&quot;stream-status&quot;</span>)
+<span class="ruby-identifier">x</span>.<span class="ruby-identifier">getconf</span>(<span class="ruby-string">'orport'</span>)
+<span class="ruby-identifier">x</span>.<span class="ruby-identifier">sr</span>(:<span class="ruby-identifier">resetconf</span>,<span class="ruby-string">'orport'</span>)
+<span class="ruby-identifier">x</span>.<span class="ruby-identifier">extendcir</span>(<span class="ruby-value">0</span>, [<span class="ruby-constant">A</span>,<span class="ruby-constant">B</span>,<span class="ruby-constant">C</span>,<span class="ruby-constant">D</span>,<span class="ruby-constant">E</span>,<span class="ruby-constant">F</span>,<span class="ruby-constant">G</span>] )
+<span class="ruby-identifier">x</span>.<span class="ruby-identifier">extendcir_slowly</span>([<span class="ruby-constant">A</span>,<span class="ruby-constant">B</span>,<span class="ruby-constant">C</span>,<span class="ruby-constant">D</span>,<span class="ruby-constant">E</span>,<span class="ruby-constant">F</span>,<span class="ruby-constant">G</span>] )
+<span class="ruby-identifier">x</span>.<span class="ruby-identifier">ds</span>     =<span class="ruby-operator">&gt;</span> [<span class="ruby-string">&quot;a.b.c.d:z&quot;</span>, <span class="ruby-string">&quot;e.f.g.h:y&quot;</span>,<span class="ruby-operator">...</span>]
+</pre>
+</li></ul>
+
+<p><strong>Note</strong>: The sr() function sends protocol messages and
+retrieves the response up to the next "250 OK" or error "5YZ".  It can send
+the setevents protocol command, but more work has to be done to receive and
+filter the events.  The delay used by between extendcir_slowly() can be
+altered by setting Tor::EXTEND_DELAY. The default is 2 seconds.</p>
+<ul><li>
+<p>Reading cached descriptor.</p>
+
+<pre class="ruby"><span class="ruby-identifier">require</span> <span class="ruby-string">&quot;tor_extend&quot;</span>
+<span class="ruby-identifier">geoipdb</span>=[<span class="ruby-string">&quot;/home/seun/dat/GeoLiteCityAug.dat&quot;</span>,<span class="ruby-string">&quot;/home/seun/dat/GeoLiteCityJuly.dat&quot;</span>]
+<span class="ruby-identifier">cacheddf</span> = <span class="ruby-constant">Tor</span><span class="ruby-operator">::</span><span class="ruby-constant">CachedDesc</span>.<span class="ruby-identifier">new</span> <span class="ruby-identifier">geoipdb</span>
+<span class="ruby-constant">Tor</span><span class="ruby-operator">::</span><span class="ruby-constant">CachedDesc</span>.<span class="ruby-identifier">dbconnect</span>
+<span class="ruby-identifier">dbconfig</span>={:<span class="ruby-identifier">adapter</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-string">&quot;sqlite3&quot;</span>,:<span class="ruby-identifier">database</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-string">&quot;db.sqlite3&quot;</span>}
+<span class="ruby-constant">Tor</span><span class="ruby-operator">::</span><span class="ruby-constant">CachedDesc</span>.<span class="ruby-identifier">dbconnect</span>(<span class="ruby-identifier">dbconfig</span>)
+<span class="ruby-constant">Tor</span><span class="ruby-operator">::</span><span class="ruby-constant">CachedDesc</span>.<span class="ruby-identifier">readall</span>(<span class="ruby-string">&quot;cached_descriptor_filename&quot;</span>)
+<span class="ruby-constant">Tor</span><span class="ruby-operator">::</span><span class="ruby-constant">CachedDesc</span>.<span class="ruby-identifier">stat</span>.<span class="ruby-identifier">get_latlng</span> <span class="ruby-string">&quot;countrycode&quot;</span> = [<span class="ruby-identifier">latitude</span>, <span class="ruby-identifier">longitude</span>]
+<span class="ruby-constant">Tor</span><span class="ruby-operator">::</span><span class="ruby-constant">CachedDesc</span>.<span class="ruby-identifier">stat</span>.<span class="ruby-identifier">continent_list</span>
+<span class="ruby-constant">Tor</span><span class="ruby-operator">::</span><span class="ruby-constant">CachedDesc</span>.<span class="ruby-identifier">stat</span>.<span class="ruby-identifier">continent_stat</span>(<span class="ruby-constant">Tor</span><span class="ruby-operator">::</span><span class="ruby-constant">CachedDesc</span>.<span class="ruby-identifier">stat</span>.<span class="ruby-identifier">continent_list</span>)
+<span class="ruby-constant">Tor</span><span class="ruby-operator">::</span><span class="ruby-constant">CachedDesc</span>.<span class="ruby-identifier">stat</span>.<span class="ruby-identifier">continent_stat</span>([<span class="ruby-string">&quot;EU&quot;</span>,<span class="ruby-string">&quot;NA&quot;</span>,<span class="ruby-string">&quot;AS&quot;</span>])
+<span class="ruby-constant">Tor</span><span class="ruby-operator">::</span><span class="ruby-constant">CachedDesc</span>.<span class="ruby-identifier">stat</span>.<span class="ruby-identifier">continent_stat_uniq</span>([<span class="ruby-string">&quot;EU&quot;</span>,<span class="ruby-string">&quot;NA&quot;</span>,<span class="ruby-string">&quot;AS&quot;</span>])
+<span class="ruby-constant">Tor</span><span class="ruby-operator">::</span><span class="ruby-constant">CachedDesc</span>.<span class="ruby-identifier">stat</span>.<span class="ruby-identifier">continent_stat_uniq</span>(<span class="ruby-string">&quot;EU&quot;</span>, <span class="ruby-string">&quot;UNIX&quot;</span>)
+<span class="ruby-constant">Tor</span><span class="ruby-operator">::</span><span class="ruby-constant">CachedDesc</span>.<span class="ruby-identifier">stat</span>.<span class="ruby-identifier">continent_count</span> <span class="ruby-string">&quot;EU&quot;</span>
+<span class="ruby-constant">Tor</span><span class="ruby-operator">::</span><span class="ruby-constant">CachedDesc</span>.<span class="ruby-identifier">stat</span>.<span class="ruby-identifier">continent_count_uniq</span> <span class="ruby-string">&quot;EU&quot;</span>
+<span class="ruby-constant">Tor</span><span class="ruby-operator">::</span><span class="ruby-constant">CachedDesc</span>.<span class="ruby-identifier">stat</span>.<span class="ruby-identifier">continent_getfingerprint</span> <span class="ruby-string">&quot;EU&quot;</span>
+<span class="ruby-constant">Tor</span><span class="ruby-operator">::</span><span class="ruby-constant">CachedDesc</span>.<span class="ruby-identifier">country_count</span>(<span class="ruby-string">&quot;FR&quot;</span>)
+<span class="ruby-constant">Tor</span><span class="ruby-operator">::</span><span class="ruby-constant">CachedDesc</span>.<span class="ruby-identifier">country_count</span>(<span class="ruby-string">&quot;FR&quot;</span>,<span class="ruby-string">&quot;UNIX&quot;</span>)
+<span class="ruby-constant">Tor</span><span class="ruby-operator">::</span><span class="ruby-constant">CachedDesc</span>.<span class="ruby-identifier">country_count</span>( [<span class="ruby-string">&quot;FR&quot;</span>,<span class="ruby-string">&quot;DE&quot;</span>] ,[ <span class="ruby-string">&quot;UNIX&quot;</span>, <span class="ruby-string">&quot;LINUX&quot;</span> ] )
+<span class="ruby-constant">Tor</span><span class="ruby-operator">::</span><span class="ruby-constant">CachedDesc</span>.<span class="ruby-identifier">stat</span>.<span class="ruby-identifier">country_stat</span>(<span class="ruby-constant">Tor</span><span class="ruby-operator">::</span><span class="ruby-constant">CachedDesc</span>.<span class="ruby-identifier">stat</span>.<span class="ruby-identifier">country_list</span>)
+<span class="ruby-constant">Tor</span><span class="ruby-operator">::</span><span class="ruby-constant">CachedDesc</span>.<span class="ruby-identifier">stat</span>.<span class="ruby-identifier">country_stat</span>(<span class="ruby-constant">Tor</span><span class="ruby-operator">::</span><span class="ruby-constant">CachedDesc</span>.<span class="ruby-identifier">stat</span>.<span class="ruby-identifier">country_list</span>, <span class="ruby-string">&quot;UNIX&quot;</span>)
+<span class="ruby-constant">Tor</span><span class="ruby-operator">::</span><span class="ruby-constant">CachedDesc</span>.<span class="ruby-identifier">stat</span>.<span class="ruby-identifier">country_stat_uniq</span>([<span class="ruby-string">&quot;FR&quot;</span>,<span class="ruby-string">&quot;UK&quot;</span>])
+<span class="ruby-constant">Tor</span><span class="ruby-operator">::</span><span class="ruby-constant">CachedDesc</span>.<span class="ruby-identifier">stat</span>.<span class="ruby-identifier">country_stat</span>([<span class="ruby-string">&quot;FR&quot;</span>,<span class="ruby-string">&quot;UK&quot;</span>], <span class="ruby-string">&quot;WINDOWS&quot;</span>)
+<span class="ruby-constant">Tor</span><span class="ruby-operator">::</span><span class="ruby-constant">CachedDesc</span>.<span class="ruby-identifier">stat</span>.<span class="ruby-identifier">country_stat_uniq</span>([<span class="ruby-string">&quot;FR&quot;</span>,<span class="ruby-string">&quot;UK&quot;</span>], [<span class="ruby-string">&quot;WINDOWS&quot;</span>,<span class="ruby-string">&quot;UNIX&quot;</span>])
+<span class="ruby-constant">Tor</span><span class="ruby-operator">::</span><span class="ruby-constant">CachedDesc</span>.<span class="ruby-identifier">stat</span>.<span class="ruby-identifier">country_stat</span>([<span class="ruby-string">&quot;FR&quot;</span>,<span class="ruby-string">&quot;UK&quot;</span>], <span class="ruby-string">&quot;OTHERS&quot;</span>)
+<span class="ruby-constant">Tor</span><span class="ruby-operator">::</span><span class="ruby-constant">CachedDesc</span>.<span class="ruby-identifier">stat</span>.<span class="ruby-identifier">topcountries</span>(<span class="ruby-value">10</span>)
+<span class="ruby-constant">Tor</span><span class="ruby-operator">::</span><span class="ruby-constant">CachedDesc</span>.<span class="ruby-identifier">stat</span>.<span class="ruby-identifier">topcountries_uniq</span>(<span class="ruby-value">10</span>)
+<span class="ruby-constant">Tor</span><span class="ruby-operator">::</span><span class="ruby-constant">CachedDesc</span>.<span class="ruby-identifier">stat</span>.<span class="ruby-identifier">topcountries_uniq</span>(<span class="ruby-value">10</span>,<span class="ruby-string">&quot;UNIX&quot;</span>)
+<span class="ruby-constant">Tor</span><span class="ruby-operator">::</span><span class="ruby-constant">CachedDesc</span>.<span class="ruby-identifier">stat</span>.<span class="ruby-identifier">topcountries_uniq</span>(<span class="ruby-value">10</span>,[<span class="ruby-string">&quot;UNIX&quot;</span>,<span class="ruby-string">&quot;LINUX&quot;</span>])
+<span class="ruby-constant">Tor</span><span class="ruby-operator">::</span><span class="ruby-constant">CachedDesc</span>.<span class="ruby-identifier">stat</span>.<span class="ruby-identifier">country_getip</span>(<span class="ruby-string">&quot;FR&quot;</span>)
+<span class="ruby-identifier">xml</span> = <span class="ruby-constant">Tor</span><span class="ruby-operator">::</span><span class="ruby-constant">CachedDesc</span>.<span class="ruby-identifier">stat</span>.<span class="ruby-identifier">genkml</span>(<span class="ruby-string">&quot;Onion Routers&quot;</span>)  
+<span class="ruby-identifier">xml</span> = <span class="ruby-constant">Tor</span><span class="ruby-operator">::</span><span class="ruby-constant">CachedDesc</span>.<span class="ruby-identifier">stat</span>.<span class="ruby-identifier">genkml</span>(<span class="ruby-string">&quot;Windows Onion Routers&quot;</span>,<span class="ruby-string">&quot;WINDOWS&quot;</span>)
+<span class="ruby-constant">Tor</span><span class="ruby-operator">::</span><span class="ruby-constant">CachedDesc</span>.<span class="ruby-identifier">each</span>{ }      =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">each</span> <span class="ruby-constant">Router</span> <span class="ruby-identifier">table</span> <span class="ruby-identifier">entry</span>
+<span class="ruby-constant">Tor</span><span class="ruby-operator">::</span><span class="ruby-constant">CachedDesc</span>.<span class="ruby-identifier">ors</span>          =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">active</span> <span class="ruby-identifier">record</span> <span class="ruby-identifier">table</span> <span class="ruby-keyword">if</span> <span class="ruby-identifier">you</span> <span class="ruby-identifier">know</span> <span class="ruby-identifier">what</span> <span class="ruby-identifier">you</span><span class="ruby-string">'re doing
+Tor::CachedDesc.ors  =&gt; 
+proxy_config={:type=&gt;'</span><span class="ruby-identifier">polipo</span><span class="ruby-string">' ,:port=&gt;8118,:addr=&gt;'</span><span class="ruby-value">127.0</span><span class="ruby-value">.0</span><span class="ruby-value">.1</span><span class="ruby-string">'},
+url = URI.parse &quot;https://bridges.torproject.org/
+x.getbridges(url, cachedf, proxy_config)
+Tor::Router(id: integer, ipaddr: string, platform: text, fingerprint: string, city: string, country: string,
+                   country_code: string, continent: string, dssource: string, lat: decimal, lng: decimal,
+                   published_at: datetime, created_at: datetime, updated_at: datetime)
+</span></pre>
+</li><li>
+<p><strong>KML</strong></p>
+</li></ul>
+
+<p>Only uniq ORs are placed in the KML string returned. Two tours are also
+generated; the first going around the world, using  different countries as
+the center, with ballons popping up at some locations if available.</p>
+
+<p>The locations in each country are numbered from 1 to country_count_uniq(),
+which is the order they appear in Google Earth under each folder. The keys
+represent the view centres that are used when opening ballon descriptions
+of the values. The default tour is shown below</p>
+
+<pre class="ruby"><span class="ruby-constant">WORLDTOUR</span>={<span class="ruby-string">&quot;ZA&quot;</span> =<span class="ruby-operator">&gt;</span> [<span class="ruby-string">&quot;ZA1&quot;</span>,<span class="ruby-string">&quot;NA1&quot;</span>,<span class="ruby-string">&quot;KE1&quot;</span>],
+           <span class="ruby-string">&quot;BJ&quot;</span> =<span class="ruby-operator">&gt;</span> [<span class="ruby-string">&quot;BJ1&quot;</span>,<span class="ruby-string">&quot;A11&quot;</span>,<span class="ruby-string">&quot;NG1&quot;</span>,<span class="ruby-string">&quot;CI1&quot;</span>,<span class="ruby-string">&quot;SN1&quot;</span>,<span class="ruby-string">&quot;DZ1&quot;</span>,<span class="ruby-string">&quot;MA1&quot;</span>,<span class="ruby-string">&quot;EG1&quot;</span>,<span class="ruby-string">&quot;TN1&quot;</span>], 
+           <span class="ruby-string">&quot;CH&quot;</span> =<span class="ruby-operator">&gt;</span> [<span class="ruby-string">&quot;FR1&quot;</span>,<span class="ruby-string">&quot;ES1&quot;</span>,<span class="ruby-string">&quot;LU1&quot;</span>,<span class="ruby-string">&quot;GB1&quot;</span>,<span class="ruby-string">&quot;BE1&quot;</span>,<span class="ruby-string">&quot;NL1&quot;</span>,<span class="ruby-string">&quot;DE1&quot;</span>,<span class="ruby-string">&quot;IT1&quot;</span>,<span class="ruby-string">&quot;IE1&quot;</span>,<span class="ruby-string">&quot;AT1&quot;</span>,<span class="ruby-string">&quot;SE1&quot;</span>,<span class="ruby-string">&quot;DK1&quot;</span>,<span class="ruby-string">&quot;UA1&quot;</span>],
+           <span class="ruby-string">&quot;UA&quot;</span> =<span class="ruby-operator">&gt;</span> [<span class="ruby-string">&quot;SA1&quot;</span>,<span class="ruby-string">&quot;TR1&quot;</span>,<span class="ruby-string">&quot;SY1&quot;</span>,<span class="ruby-string">&quot;RU1&quot;</span>,<span class="ruby-string">&quot;IR1&quot;</span>],
+           <span class="ruby-string">&quot;IN&quot;</span> =<span class="ruby-operator">&gt;</span> [<span class="ruby-string">&quot;IN1&quot;</span>,<span class="ruby-string">&quot;KZ1&quot;</span>,<span class="ruby-string">&quot;CN1&quot;</span>,<span class="ruby-string">&quot;TH1&quot;</span>,<span class="ruby-string">&quot;PK1&quot;</span>],
+           <span class="ruby-string">&quot;AU&quot;</span> =<span class="ruby-operator">&gt;</span> [<span class="ruby-string">&quot;AU1&quot;</span>,<span class="ruby-string">&quot;NC1&quot;</span>],
+           <span class="ruby-string">&quot;PY&quot;</span> =<span class="ruby-operator">&gt;</span> [<span class="ruby-string">&quot;PY1&quot;</span>,<span class="ruby-string">&quot;BR1&quot;</span>,<span class="ruby-string">&quot;AR1&quot;</span>,<span class="ruby-string">&quot;CL1&quot;</span>],
+           <span class="ruby-string">&quot;US&quot;</span> =<span class="ruby-operator">&gt;</span> [<span class="ruby-string">&quot;US1&quot;</span>,<span class="ruby-string">&quot;US2&quot;</span>,<span class="ruby-string">&quot;US3&quot;</span>,<span class="ruby-string">&quot;US4&quot;</span>,<span class="ruby-string">&quot;CA1&quot;</span>,<span class="ruby-string">&quot;MX1&quot;</span>],
+           <span class="ruby-string">&quot;FR&quot;</span> =<span class="ruby-operator">&gt;</span> [<span class="ruby-string">&quot;FR1&quot;</span>] }
+</pre>
+
+<p>A different tour can be set by defining WORLDTOUR constant in the <a
+href="Tor.html">Tor</a> moodule</p>
+
+<pre class="ruby"><span class="ruby-constant">Tor</span><span class="ruby-operator">::</span><span class="ruby-constant">WORLDTOUR</span> = {<span class="ruby-string">&quot;AU&quot;</span>=<span class="ruby-operator">&gt;</span>[<span class="ruby-string">&quot;GB1&quot;</span>,<span class="ruby-string">&quot;FR1&quot;</span>,<span class="ruby-string">&quot;US1&quot;</span>,<span class="ruby-string">&quot;DE1&quot;</span>]}
+</pre>
+
+<p>The second tour uses a coordinate(:lat,:lng) as centre, and 2 arrays of
+‘red’ ORs and ‘black’. All locations remain green, The ‘red’ points are set
+black, and all ‘black’ location goes from green to black one at a time
+every 2 seconds.  Tor::Constants::ATTACK_TOUR is used by default. This can
+also be changed by defining Tor::ATTACK_TOUR constant. The default attack
+tour is shown below</p>
+
+<pre class="ruby"><span class="ruby-constant">ATTACK_TOUR</span> = {:<span class="ruby-identifier">lat</span>   =<span class="ruby-operator">&gt;</span> <span class="ruby-value">46.0</span>,
+               :<span class="ruby-identifier">lng</span>   =<span class="ruby-operator">&gt;</span> <span class="ruby-value">2.0</span>,
+               <span class="ruby-string">&quot;red&quot;</span>  =<span class="ruby-operator">&gt;</span> (<span class="ruby-value">1</span><span class="ruby-operator">..</span><span class="ruby-value">90</span>).<span class="ruby-identifier">collect</span>{<span class="ruby-operator">|</span><span class="ruby-identifier">eachnum</span><span class="ruby-operator">|</span> <span class="ruby-string">&quot;FR&quot;</span> <span class="ruby-operator">+</span> <span class="ruby-identifier">eachnum</span>.<span class="ruby-identifier">to_s</span>},
+               <span class="ruby-string">&quot;black&quot;</span>=<span class="ruby-operator">&gt;</span> (<span class="ruby-value">91</span><span class="ruby-operator">..</span><span class="ruby-value">200</span>).<span class="ruby-identifier">collect</span>{<span class="ruby-operator">|</span><span class="ruby-identifier">eachnum</span><span class="ruby-operator">|</span> <span class="ruby-string">&quot;FR&quot;</span> <span class="ruby-operator">+</span> <span class="ruby-identifier">eachnum</span>.<span class="ruby-identifier">to_s</span>} }
+</pre>
+<ul><li>
+<p><strong>Customizing the Tour</strong>.</p>
+</li></ul>
+
+<pre class="ruby"><span class="ruby-constant">Tor</span><span class="ruby-operator">::</span><span class="ruby-constant">ATTACK_TOUR</span> = { :<span class="ruby-identifier">lat</span>  =<span class="ruby-operator">&gt;</span><span class="ruby-identifier">cachedf</span>.<span class="ruby-identifier">stat</span>.<span class="ruby-identifier">get_latlng</span>(<span class="ruby-string">&quot;US&quot;</span>)[<span class="ruby-value">0</span>],
+                     :<span class="ruby-identifier">lng</span>  =<span class="ruby-operator">&gt;</span><span class="ruby-identifier">cachedf</span>.<span class="ruby-identifier">stat</span>.<span class="ruby-identifier">get_latlng</span>(<span class="ruby-string">&quot;US&quot;</span>)[<span class="ruby-value">1</span>],
+                     <span class="ruby-string">'red'</span> =<span class="ruby-operator">&gt;</span>[<span class="ruby-string">'US1'</span>,<span class="ruby-string">'US2'</span>,<span class="ruby-string">'US3'</span>,<span class="ruby-string">'US10'</span>],
+                     <span class="ruby-string">'black'</span> =<span class="ruby-operator">&gt;</span>[<span class="ruby-string">'US4'</span>,<span class="ruby-string">'US5'</span>,<span class="ruby-string">'US6'</span>,<span class="ruby-string">'US12'</span>]}
+</pre>
+
+<p><strong>OR</strong></p>
+
+<pre class="ruby"><span class="ruby-constant">Tor</span><span class="ruby-operator">::</span><span class="ruby-constant">ATTACK_TOUR</span> = { :<span class="ruby-identifier">lat</span>  =<span class="ruby-operator">&gt;</span><span class="ruby-constant">Tor</span><span class="ruby-operator">::</span><span class="ruby-constant">Constants</span><span class="ruby-operator">::</span><span class="ruby-constant">COUNLATLNG</span>[<span class="ruby-string">&quot;US&quot;</span>][:<span class="ruby-identifier">lat</span>],
+                     :<span class="ruby-identifier">lng</span>  =<span class="ruby-operator">&gt;</span><span class="ruby-constant">Tor</span><span class="ruby-operator">::</span><span class="ruby-constant">Constants</span><span class="ruby-operator">::</span><span class="ruby-constant">COUNLATLNG</span>[<span class="ruby-string">&quot;US&quot;</span>][:<span class="ruby-identifier">lng</span>],
+                     <span class="ruby-string">'red'</span> =<span class="ruby-operator">&gt;</span>[<span class="ruby-string">'US1'</span>,<span class="ruby-string">'US2'</span>,<span class="ruby-string">'US3'</span>,<span class="ruby-string">'US10'</span>],
+                     <span class="ruby-string">'black'</span> =<span class="ruby-operator">&gt;</span>[<span class="ruby-string">'US4'</span>,<span class="ruby-string">'US5'</span>,<span class="ruby-string">'US6'</span>,<span class="ruby-string">'US12'</span>]}
+</pre>
+<ul><li>
+<p><strong>Reset using this</strong>:</p>
+</li></ul>
+
+<pre class="ruby"><span class="ruby-constant">Tor</span><span class="ruby-operator">::</span><span class="ruby-constant">ATTACK_TOUR</span>=<span class="ruby-constant">Tor</span><span class="ruby-operator">::</span><span class="ruby-constant">Constants</span><span class="ruby-operator">::</span><span class="ruby-constant">ATTACK_TOUR</span>
+<span class="ruby-keyword">if</span> <span class="ruby-identifier">the</span> <span class="ruby-identifier">country</span> <span class="ruby-identifier">is</span> <span class="ruby-keyword">not</span> <span class="ruby-identifier">defined</span>, <span class="ruby-identifier">define</span> <span class="ruby-identifier">a</span> <span class="ruby-identifier">constant</span> <span class="ruby-constant">Tor</span><span class="ruby-operator">::</span><span class="ruby-constant">COUNLATLNG</span>, <span class="ruby-identifier">get_latlng</span>() <span class="ruby-identifier">will</span> <span class="ruby-identifier">check</span> <span class="ruby-identifier">it</span> <span class="ruby-identifier">automatically</span>.
+<span class="ruby-identifier">cachedf</span>.<span class="ruby-identifier">stat</span>.<span class="ruby-identifier">get_latlng</span>(<span class="ruby-string">&quot;AV&quot;</span>)
+<span class="ruby-constant">AV</span>,  <span class="ruby-operator">-</span> <span class="ruby-keyword">not</span> <span class="ruby-keyword">in</span> <span class="ruby-identifier">the</span> <span class="ruby-identifier">country</span><span class="ruby-operator">-</span><span class="ruby-identifier">latitude</span> <span class="ruby-identifier">file</span>, <span class="ruby-identifier">using</span> <span class="ruby-identifier">cordinates</span>(<span class="ruby-value">0</span>,<span class="ruby-value">0</span>)
+ =<span class="ruby-operator">&gt;</span> [<span class="ruby-value">0.0</span>, <span class="ruby-value">0.0</span>] 
+<span class="ruby-constant">Tor</span><span class="ruby-operator">::</span><span class="ruby-constant">COUNLATLNG</span> = {<span class="ruby-string">&quot;AV&quot;</span>=<span class="ruby-operator">&gt;</span>{:<span class="ruby-identifier">lat=</span><span class="ruby-operator">&gt;</span><span class="ruby-value">1</span>, :<span class="ruby-identifier">lng=</span><span class="ruby-operator">&gt;</span><span class="ruby-value">1</span>}}
+<span class="ruby-identifier">cachedf</span>.<span class="ruby-identifier">stat</span>.<span class="ruby-identifier">get_latlng</span>(<span class="ruby-string">&quot;AV&quot;</span>)
+=<span class="ruby-operator">&gt;</span> [<span class="ruby-value">1</span>, <span class="ruby-value">1</span>]
+</pre>
+
+<p><strong> Obtain bridges</strong>.</p>
+
+<p>Some of these fingerprints might have changed, but you can obtain fast
+relays for the test below</p>
+
+<pre class="ruby"><span class="ruby-identifier">require</span> <span class="ruby-string">'tor_extend'</span>
+<span class="ruby-identifier">geoipdb</span>=[<span class="ruby-string">&quot;/home/seun/dat/GeoLiteCityOct.dat&quot;</span>,<span class="ruby-string">&quot;/home/seun/dat/GeoLiteCityJuly.dat&quot;</span>]
+<span class="ruby-identifier">cachedf</span> = <span class="ruby-constant">Tor</span><span class="ruby-operator">::</span><span class="ruby-constant">CachedDesc</span>.<span class="ruby-identifier">new</span> <span class="ruby-identifier">geoipdb</span>
+<span class="ruby-identifier">cachedf</span>.<span class="ruby-identifier">dbconnect</span>
+<span class="ruby-identifier">cachedf</span>.<span class="ruby-identifier">readall</span>(<span class="ruby-string">&quot;/home/seun/.tor/cached-descriptors&quot;</span>)
+<span class="ruby-identifier">cachedf</span>.<span class="ruby-identifier">readall</span>(<span class="ruby-string">&quot;/home/seun/.tor/cached-descriptors.new&quot;</span>)
+<span class="ruby-identifier">tctrl</span>={:<span class="ruby-identifier">host=</span><span class="ruby-operator">&gt;</span><span class="ruby-string">'127.0.0.1'</span>,:<span class="ruby-identifier">port</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-value">9051</span>}
+<span class="ruby-identifier">ctrlpasswd</span>=<span class="ruby-string">&quot;mycontrolpassword&quot;</span>
+<span class="ruby-identifier">proxyconfig</span>={:<span class="ruby-identifier">type=</span><span class="ruby-operator">&gt;</span><span class="ruby-string">'polipo'</span> ,:<span class="ruby-identifier">port=</span><span class="ruby-operator">&gt;</span><span class="ruby-value">8118</span>, :<span class="ruby-identifier">addr=</span><span class="ruby-operator">&gt;</span><span class="ruby-string">'127.0.0.1'</span>}
+<span class="ruby-identifier">mytor</span>=<span class="ruby-constant">Tor</span><span class="ruby-operator">::</span><span class="ruby-constant">TController</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">tctrl</span>)
+<span class="ruby-comment"># mytor.connect</span>
+<span class="ruby-identifier">mytor</span>.<span class="ruby-identifier">authenticate</span> <span class="ruby-node">&quot;\&quot;#{ctrlpasswd}\&quot;&quot;</span>
+<span class="ruby-identifier">mytor</span>.<span class="ruby-identifier">closeallcircuits</span>
+<span class="ruby-identifier">puts</span> <span class="ruby-identifier">mytor</span>.<span class="ruby-identifier">cir_status</span>
+<span class="ruby-constant">A</span>= [ <span class="ruby-string">&quot;FateTestarrosa&quot;</span>, <span class="ruby-string">&quot;mindfields&quot;</span>, <span class="ruby-string">&quot;BeMyGuest&quot;</span> , <span class="ruby-string">&quot;$AE55AECC4C68573F32F0ECFF6303A3FAEFFCD70E&quot;</span> ] <span class="ruby-operator">+</span>  <span class="ruby-identifier">mytor</span>.<span class="ruby-identifier">get_entryguards</span>
+<span class="ruby-comment"># A can be mytor.get_purposeip(&quot;fast guard&quot;)</span>
+<span class="ruby-constant">B</span>= [<span class="ruby-string">&quot;GreenLantern&quot;</span>, <span class="ruby-string">&quot;atlgonyovLi&quot;</span>, <span class="ruby-string">&quot;bauruine1&quot;</span> ]
+<span class="ruby-comment"># or use B = mytor.get_purposeip(&quot;fast !exit !guard&quot;)</span>
+<span class="ruby-comment"># But B can also be an guard or exit relay, no restrictions</span>
+<span class="ruby-constant">C</span> = <span class="ruby-identifier">mytor</span>.<span class="ruby-identifier">get_purposeip</span>(<span class="ruby-string">&quot;exit fast&quot;</span>)
+<span class="ruby-identifier">url</span> = <span class="ruby-constant">URI</span>.<span class="ruby-identifier">parse</span> <span class="ruby-string">&quot;https://bridges.torproject.org/&quot;</span>
+<span class="ruby-constant">C</span>.<span class="ruby-identifier">count</span>.<span class="ruby-identifier">times</span>{<span class="ruby-operator">|</span><span class="ruby-identifier">z</span><span class="ruby-operator">|</span>
+    <span class="ruby-identifier">entryg</span> = <span class="ruby-constant">A</span>[<span class="ruby-identifier">rand</span>(<span class="ruby-constant">A</span>.<span class="ruby-identifier">count</span>)]
+    <span class="ruby-identifier">relayg</span> = <span class="ruby-constant">B</span>[<span class="ruby-identifier">rand</span>(<span class="ruby-constant">B</span>.<span class="ruby-identifier">count</span>)]
+    <span class="ruby-identifier">exitn</span>  = <span class="ruby-constant">C</span>[<span class="ruby-identifier">z</span>]
+    <span class="ruby-identifier">circuit1</span> = [<span class="ruby-identifier">entryg</span>,<span class="ruby-identifier">relayg</span>, <span class="ruby-identifier">exitn</span>]
+    <span class="ruby-identifier">cir_num</span> = <span class="ruby-identifier">mytor</span>.<span class="ruby-identifier">extendcir</span>(<span class="ruby-value">0</span>, <span class="ruby-identifier">circuit1</span>)
+    <span class="ruby-keyword">if</span> <span class="ruby-identifier">mytor</span>.<span class="ruby-identifier">cir_status</span>.<span class="ruby-identifier">detect</span>{<span class="ruby-operator">|</span><span class="ruby-identifier">p</span><span class="ruby-operator">|</span> <span class="ruby-identifier">p</span> <span class="ruby-operator">=~</span> <span class="ruby-node">/#{cir_num} BUILT/</span>}
+        <span class="ruby-identifier">mytor</span>.<span class="ruby-identifier">get_bridges</span>(<span class="ruby-identifier">url</span>,<span class="ruby-identifier">cachedf</span>)
+    <span class="ruby-keyword">else</span>
+        <span class="ruby-identifier">sleep</span>(<span class="ruby-value">2</span>)
+        <span class="ruby-identifier">puts</span> <span class="ruby-identifier">mytor</span>.<span class="ruby-identifier">get_bridges</span>( <span class="ruby-identifier">url</span>, <span class="ruby-identifier">cachedf</span> )    <span class="ruby-comment">#bridges are added to the database automatically</span>
+    <span class="ruby-keyword">end</span> 
+}
+</pre>
+
+<p>more results can be obtained using all exits, instead of just fast exits.
+Or other distributed networks.</p>
+
+</div>
+
+
+
+<footer id="validator-badges">
+  <p><a href="http://validator.w3.org/check/referer">[Validate]</a>
+  <p>Generated by <a href="https://github.com/rdoc/rdoc">RDoc</a> 3.11.
+  <p>Generated with the <a href="http://deveiate.org/projects/Darkfish-Rdoc/">Darkfish Rdoc Generator</a> 3.
+</footer>
+