tor_extend 1.0.2 → 2.0.0

data/doc/lib/constants_rb.html

@@ -65,8 +65,12 @@
   
     <li><a href="../Tor/CachedDesc.html">Tor::CachedDesc</a>
   
+    <li><a href="../Tor/Circuit.html">Tor::Circuit</a>
+  
     <li><a href="../Tor/Constants.html">Tor::Constants</a>
   
+    <li><a href="../Tor/LongCircuit.html">Tor::LongCircuit</a>
+  
     <li><a href="../Tor/Router.html">Tor::Router</a>
   
     <li><a href="../Tor/StatsObj.html">Tor::StatsObj</a>

data/doc/lib/httpmod_rb.html

@@ -65,8 +65,12 @@
   
     <li><a href="../Tor/CachedDesc.html">Tor::CachedDesc</a>
   
+    <li><a href="../Tor/Circuit.html">Tor::Circuit</a>
+  
     <li><a href="../Tor/Constants.html">Tor::Constants</a>
   
+    <li><a href="../Tor/LongCircuit.html">Tor::LongCircuit</a>
+  
     <li><a href="../Tor/Router.html">Tor::Router</a>
   
     <li><a href="../Tor/StatsObj.html">Tor::StatsObj</a>

data/doc/lib/tcontroller_rb.html

@@ -65,8 +65,12 @@
   
     <li><a href="../Tor/CachedDesc.html">Tor::CachedDesc</a>
   
+    <li><a href="../Tor/Circuit.html">Tor::Circuit</a>
+  
     <li><a href="../Tor/Constants.html">Tor::Constants</a>
   
+    <li><a href="../Tor/LongCircuit.html">Tor::LongCircuit</a>
+  
     <li><a href="../Tor/Router.html">Tor::Router</a>
   
     <li><a href="../Tor/StatsObj.html">Tor::StatsObj</a>

data/doc/lib/tor_extend_rb.html

@@ -65,8 +65,12 @@
   
     <li><a href="../Tor/CachedDesc.html">Tor::CachedDesc</a>
   
+    <li><a href="../Tor/Circuit.html">Tor::Circuit</a>
+  
     <li><a href="../Tor/Constants.html">Tor::Constants</a>
   
+    <li><a href="../Tor/LongCircuit.html">Tor::LongCircuit</a>
+  
     <li><a href="../Tor/Router.html">Tor::Router</a>
   
     <li><a href="../Tor/StatsObj.html">Tor::StatsObj</a>

data/doc/lib/tstats_rb.html

@@ -65,8 +65,12 @@
   
     <li><a href="../Tor/CachedDesc.html">Tor::CachedDesc</a>
   
+    <li><a href="../Tor/Circuit.html">Tor::Circuit</a>
+  
     <li><a href="../Tor/Constants.html">Tor::Constants</a>
   
+    <li><a href="../Tor/LongCircuit.html">Tor::LongCircuit</a>
+  
     <li><a href="../Tor/Router.html">Tor::Router</a>
   
     <li><a href="../Tor/StatsObj.html">Tor::StatsObj</a>

data/doc/table_of_contents.html

@@ -41,9 +41,15 @@
   </li>
     <li class="class">
     <a href="Tor/CachedDesc.html">Tor::CachedDesc</a>
+  </li>
+    <li class="class">
+    <a href="Tor/Circuit.html">Tor::Circuit</a>
   </li>
     <li class="module">
     <a href="Tor/Constants.html">Tor::Constants</a>
+  </li>
+    <li class="class">
+    <a href="Tor/LongCircuit.html">Tor::LongCircuit</a>
   </li>
     <li class="class">
     <a href="Tor/Router.html">Tor::Router</a>
@@ -62,16 +68,46 @@
   
     <li class="method"><a href="Tor/CachedDesc.html#method-c-new">::new &mdash; Tor::CachedDesc</a>
   
+    <li class="method"><a href="Tor/Circuit.html#method-c-new">::new &mdash; Tor::Circuit</a>
+  
+    <li class="method"><a href="Tor/LongCircuit.html#method-c-new">::new &mdash; Tor::LongCircuit</a>
+  
+    <li class="method"><a href="Tor/TController.html#method-c-new">::new &mdash; Tor::TController</a>
+  
     <li class="method"><a href="Tor/TController.html#method-i-attach_stream">#attach_stream &mdash; Tor::TController</a>
   
+    <li class="method"><a href="Tor/Circuit.html#method-i-attach_streams">#attach_streams &mdash; Tor::Circuit</a>
+  
+    <li class="method"><a href="Tor/LongCircuit.html#method-i-attach_streams">#attach_streams &mdash; Tor::LongCircuit</a>
+  
     <li class="method"><a href="Tor/TController.html#method-i-bridges">#bridges &mdash; Tor::TController</a>
   
+    <li class="method"><a href="Tor/LongCircuit.html#method-i-built-3F">#built? &mdash; Tor::LongCircuit</a>
+  
+    <li class="method"><a href="Tor/Circuit.html#method-i-built-3F">#built? &mdash; Tor::Circuit</a>
+  
     <li class="method"><a href="Tor/TController.html#method-i-cir_status">#cir_status &mdash; Tor::TController</a>
   
+    <li class="method"><a href="Tor/LongCircuit.html#method-i-circuit">#circuit &mdash; Tor::LongCircuit</a>
+  
+    <li class="method"><a href="Tor/Circuit.html#method-i-circuit">#circuit &mdash; Tor::Circuit</a>
+  
+    <li class="method"><a href="Tor/LongCircuit.html#method-i-cirnum">#cirnum &mdash; Tor::LongCircuit</a>
+  
+    <li class="method"><a href="Tor/Circuit.html#method-i-cirnum">#cirnum &mdash; Tor::Circuit</a>
+  
+    <li class="method"><a href="Tor/LongCircuit.html#method-i-close_apps">#close_apps &mdash; Tor::LongCircuit</a>
+  
+    <li class="method"><a href="Tor/Circuit.html#method-i-close_apps">#close_apps &mdash; Tor::Circuit</a>
+  
     <li class="method"><a href="Tor/TController.html#method-i-closeallcircuits">#closeallcircuits &mdash; Tor::TController</a>
   
+    <li class="method"><a href="Tor/Circuit.html#method-i-closecir">#closecir &mdash; Tor::Circuit</a>
+  
     <li class="method"><a href="Tor/TController.html#method-i-closecircuit">#closecircuit &mdash; Tor::TController</a>
   
+    <li class="method"><a href="Tor/Circuit.html#method-i-closed-3F">#closed? &mdash; Tor::Circuit</a>
+  
     <li class="method"><a href="Tor/StatsObj.html#method-i-continent_count">#continent_count &mdash; Tor::StatsObj</a>
   
     <li class="method"><a href="Tor/StatsObj.html#method-i-continent_count_uniq">#continent_count_uniq &mdash; Tor::StatsObj</a>
@@ -84,6 +120,8 @@
   
     <li class="method"><a href="Tor/StatsObj.html#method-i-continent_stat_uniq">#continent_stat_uniq &mdash; Tor::StatsObj</a>
   
+    <li class="method"><a href="Tor/Circuit.html#method-i-controller">#controller &mdash; Tor::Circuit</a>
+  
     <li class="method"><a href="Tor/StatsObj.html#method-i-country_count">#country_count &mdash; Tor::StatsObj</a>
   
     <li class="method"><a href="Tor/StatsObj.html#method-i-country_count_uniq">#country_count_uniq &mdash; Tor::StatsObj</a>
@@ -102,6 +140,10 @@
   
     <li class="method"><a href="Tor/TController.html#method-i-ds">#ds &mdash; Tor::TController</a>
   
+    <li class="method"><a href="Tor/Circuit.html#method-i-extend">#extend &mdash; Tor::Circuit</a>
+  
+    <li class="method"><a href="Tor/LongCircuit.html#method-i-extend">#extend &mdash; Tor::LongCircuit</a>
+  
     <li class="method"><a href="Tor/TController.html#method-i-extendcir">#extendcir &mdash; Tor::TController</a>
   
     <li class="method"><a href="Tor/TController.html#method-i-extendcir_slowly">#extendcir_slowly &mdash; Tor::TController</a>
@@ -110,6 +152,8 @@
   
     <li class="method"><a href="Tor/TController.html#method-i-get_bridges">#get_bridges &mdash; Tor::TController</a>
   
+    <li class="method"><a href="Tor/Circuit.html#method-i-get_bridges">#get_bridges &mdash; Tor::Circuit</a>
+  
     <li class="method"><a href="Tor/StatsObj.html#method-i-get_countryname">#get_countryname &mdash; Tor::StatsObj</a>
   
     <li class="method"><a href="Tor/TController.html#method-i-get_entryguards">#get_entryguards &mdash; Tor::TController</a>
@@ -128,6 +172,10 @@
   
     <li class="method"><a href="Tor/TController.html#method-i-getinfo">#getinfo &mdash; Tor::TController</a>
   
+    <li class="method"><a href="Tor/Circuit.html#method-i-launch">#launch &mdash; Tor::Circuit</a>
+  
+    <li class="method"><a href="Tor/Circuit.html#method-i-launched-3F">#launched? &mdash; Tor::Circuit</a>
+  
     <li class="method"><a href="Tor/TController.html#method-i-net_status">#net_status &mdash; Tor::TController</a>
   
     <li class="method"><a href="Tor/TController.html#method-i-newstreams">#newstreams &mdash; Tor::TController</a>
@@ -142,6 +190,8 @@
   
     <li class="method"><a href="Tor/TController.html#method-i-sr">#sr &mdash; Tor::TController</a>
   
+    <li class="method"><a href="Tor/Circuit.html#method-i-start">#start &mdash; Tor::Circuit</a>
+  
     <li class="method"><a href="Tor/CachedDesc.html#method-i-stat">#stat &mdash; Tor::CachedDesc</a>
   
     <li class="method"><a href="Tor/StatsObj.html#method-i-topcountries">#topcountries &mdash; Tor::StatsObj</a>

data/lib/circuits.rb

@@ -0,0 +1,370 @@
+module Tor
+
+    #    This is a single (sub-)circuit object over exactly 3 nodes.Suitable nodes must be chosesn to allow the creation of a successful circuit.
+    class Circuit
+
+        #    Initialises a Tor::Circuit instance variable with attibutes including the @built, @cirnum and @torcontroller
+        #    Use nil for proxyport if Tor is running already.
+        def initialize(ctrller_config, circuitarray, proxyconfig)
+            @built = true
+	    @closed = true
+            @circuitarray = circuitarray
+            @cirnum = nil
+            @ctrller_config = ctrller_config
+            @proxyconfig = proxyconfig
+            if @proxyconfig.nil?                  # When proxyconfig.nil?, then it's an existing 
+                @launched = true
+                @torcontroller = Tor::TController.new(@ctrller_config)
+            else
+	        @launched = false
+            end
+        end
+
+        # Returns the nodes that make up the circuit.
+        def circuit
+            @circuitarray
+	end
+
+        # Returns the Tor:Controller used for the circuit.
+        def controller
+            if defined?(@torcontroller)
+                @torcontroller
+            end
+	end
+
+        # Returns the circuit number. Returns 0 if it has not been attached
+        def cirnum
+            @cirnum
+	end
+
+        #    Checks if the application instances for Tor and polipo have been closed
+        def closed?
+	    @closed
+        end
+
+        #    This creates / builds the actual circuit using @circuitarray.
+        def extend
+            if defined?(@torcontroller)
+                @cirnum = @torcontroller.extendcir(0,@circuitarray)
+            else
+                    puts "launch before extending\n"
+                    return nil
+            end
+        end
+
+        #    This attaches all streams on this controller to a prebuilt circuit that has been 
+        def start
+            if ! launched?
+                launch
+            end
+            if ! built?
+                extend
+            end
+            # sleep(3.5)            ###################### wait 3 seconds before checking if built. # May not be needed
+            # use events here instead to (build) no matter what. or (launch and build). If built, attach existing streams from preceeding subcircuit
+            if built?
+                streams_array = @torcontroller.newstreams
+		if ! streams_array.empty? and ! @cirnum.nil?
+                    streams_array.each{|each_stream|
+                        @torcontroller.attach_stream(each_stream, @cirnum)
+	            }
+		end
+            end
+        end
+
+        # This methods checks if the circuit has been built. It only reflects a single segment of the circuit
+        def built?
+            if defined?(@torcontroller)     # cant check built? before launching.
+                @built = ! @torcontroller.cir_status.detect{|z| z =~ /#{@cirnum} BUILT/   }.nil? if not @cirnum.nil?
+            else
+                false
+            end 
+        end
+
+        #    Checks if the launched method has been called
+        def launched?
+            @launched
+        end
+
+        #    Run this after initializing a Tor::Circuit instaance. This writes the following Tor configuration options to a temp file if proxyport not nil: Write HttpProxy, HttpsProxy , DataDirectory /tmp/dir, __LeaveStreamUnattached  1. 
+        #    This also writes polipoo configuration to a temporary file and executes polipo 
+        #    It executes Tor and polipo if proxyport is not nil
+        #    Note: The applicaitons will continue running even if the ruby shell is exited. The Circuit.close_apps method can be used to terminate the application and remove the temp dir
+        def launch
+            # should I use popen3? dont need stdin and stderror from tor or polipo
+            if ! @proxyconfig.nil?
+                @path = Dir.mktmpdir if not defined?(@path)
+                @pid= {}
+                torrc_filename = File.join(@path,"torrc")
+                torrc = File.new( torrc_filename, "w")
+                # populate torrc
+                socks_port = @ctrller_config[:port] - 1
+                torrc.puts "ControlPort #{@ctrller_config[:port]}\n"
+                torrc.puts "DataDirectory #{@path}\n"
+                torrc.puts "HttpProxy 127.0.0.1:#{@proxyconfig - 1}\n"      # Use the preceeding polipo port
+                torrc.puts "HttpsProxy 127.0.0.1:#{@proxyconfig - 1}\n"
+                torrc.puts "RunAsDaemon 1\n"
+                torrc.puts "SocksPort #{socks_port}\n"
+                torrc.puts "SocksListenAddress 127.0.0.1\n"
+                # can add a random password and call tor --hashcontrolpassword read stdout..but feels like long thing. Or ruby implementation of hash
+                torrc.close
+                puts "Torrc config written \n"
+                #puts @tor_io=Process.spawn("tor","-f",torrc_filename)     # stdin, stdout, stderr, thread
+                #puts @tor_io=Open3.popen3("tor","-f",torrc_filename)     # stdin, stdout, stderr, thread
+                @pid[:tor] = Process.spawn("tor","-f",torrc_filename)
+                sleep(7) # wait 7 seconds to download cached consensus and descriptors. -Consider copuing the existing one from the previous directory
+		# check here # **************** why sleep? can I use the cached desc from the first tor process
+                @torcontroller = Tor::TController.new(@ctrller_config)
+                # write proxyconfig to polipo
+                polipo_filename = File.join(@path,"polipo_config")
+                polipo_config = File.new( polipo_filename , "w")
+                polipo_config.puts "proxyPort = #{@proxyconfig}\n"
+                polipo_config.puts "socksParentProxy = localhost:#{socks_port}\n"
+                polipo_config.puts "socksProxyType = socks5\n"
+                polipo_config.puts "daemonise = true\n"
+                polipo_log = File.join(@path,"polipo_log")
+                polipo_pid = File.join(@path,"polipo.pid")
+                polipo_forbid = File.join(@path,"forbidden")
+                polipo_config.puts "logFile = #{polipo_log}\n"
+                polipo_config.puts "pidFile = #{polipo_pid}\n"
+                polipo_config.puts "forbiddenFile = #{polipo_forbid}\n"
+                polipo_config.close
+                @pid[:polipo]= Process.spawn( "polipo", "-c", polipo_filename)
+            end
+            @torcontroller = Tor::TController.new(@ctrller_config)
+            # @path = @torcontroller.getconf("DataDirectory") when proxyconfig==nil # dont need path for the first Tor
+            @torcontroller.setconf("__DisablePredictedCircuits",1)
+            @torcontroller.setconf("newcircuitperiod",999999999)
+            @torcontroller.setconf("maxcircuitdirtiness",999999999)
+            @torcontroller.setconf("MaxOnionsPending",0)
+            @torcontroller.setconf("__LeaveStreamsUnattached",1)
+            @launched = true
+            @closed = false
+        end
+
+        #    Closes the circuit
+        def closecir
+            @torcontroller.closecircuit(@cirnum) if ! @cirnum.nil?
+            @built=false
+        end
+
+        #    Closes the Tor and Polipo launched by the instance of this class, and removes the tmp directory
+        def close_apps
+            if defined?(@pid)
+                @torcontroller.signal("SHUTDOWN")
+                Process.kill("KILL",@pid[:polipo])
+                FileUtils.remove_entry_secure @path # srm path ( delete tmp directory recursively )
+                @launched=false
+                @built=false
+            end
+            @closed = true
+        end
+
+        # This tries to attach all streams to the circuit.
+        def attach_streams
+            controller.newstreams.each{|z|
+                controller.attach_stream(z,@cirnum)
+            }
+        end
+
+        #    This gets 3 bridge IP addresses from the Tor bridge website. proxyconfig is optional.
+	#    default proxyconfig = {:type=>'polipo' ,:port=>8118,:addr=>'127.0.0.1'}
+	#    The return format is fo the form:  
+	#    [HTTPcode, [{:bridgeip, :bridgeport},{:bridgeip, :bridgeport},{:bridgeip, :bridgeport}].
+	#    The types can be one of 'tor', 'polipo', 'socks', 'http', 'https',nil, 'none'.
+	#
+	#    <b>Get 3 bridges</b>
+	#
+        #        Tor::Circuit.get_bridges( Tor::Cacheddesc, {:proxytype=>'polipo',:proxyport=>8118,:proxyaddr=>'127.0.0.1'}  )
+        #
+        #    cachedDesc can be nil if the Google Earth file is not needed.
+        def get_bridges(cacheddesc, *config)
+            url = URI.parse "https://bridges.torproject.org/"
+            if config.empty?
+                proxyconfig={:type=>'polipo' ,:port=>8118,:addr=>'127.0.0.1'}
+            else
+                proxyconfig = config[0]
+            end
+
+            if ! defined?(@myhttperrors)
+                 @myhttperrors=0
+            end
+            case proxyconfig[:type]
+              when /none/i,nil
+                http_session=Net::HTTP.new(url.host,url.port)
+              when /socks/i,/tor/i
+                http_session=Net::HTTP.SOCKSProxy(proxyconfig[:addr], proxyconfig[:port]).new(url.host,url.port)
+              when /http/i,/https/i,/polipo/i
+                http_session=Net::HTTP::Proxy(proxyconfig[:addr], proxyconfig[:port]).new(url.host,url.port)
+            end
+
+            if url.scheme=="https"
+                http_session.use_ssl = true
+                http_session.verify_mode = OpenSSL::SSL::VERIFY_NONE
+            else
+                http_session.use_ssl=false
+            end
+            bridges=[]
+            # Rescue from http error
+            begin
+                resp = http_session.get2 url.path # Let Tor choose circuit itself
+                # Additional code will be added shortly to attach the stream to the circuit directly
+                puts "#{resp.code} HTTP response"
+                # puts resp.body
+                respcode= resp.code=="200" ? 200:nil
+                if resp.code == "200"
+                    torbridgeip=resp.body.scan(/\d+\.\d+\.\d+\.\d+\:\d+/)
+                    torbridgeip.each{|eachbridge|
+                        bridgeip,bridgeport= eachbridge.split(':')
+                        x = Tor::Bridge.where(:ipaddr=>bridgeip, :port =>bridgeport)
+                        if x.empty?
+                            if cacheddesc.nil? or (bridge_geoip = cacheddesc.get_geoiprecord(bridgeip)).nil?
+                                Tor::Bridge.create(:ipaddr=>bridgeip, :port =>bridgeport,
+                                                      :lat=>0, :lng=>0)
+                            else
+                                Tor::Bridge.create(:ipaddr=>bridgeip, :port =>bridgeport,
+                                                      :lat=>bridge_geoip.latitude.to_f,
+                                                      :lng=>bridge_geoip.longitude.to_f )
+                            end
+                        end
+                    }
+                end
+             bridges = torbridgeip
+            rescue
+                @myhttperrors +=1
+                respcode=nil
+                bridges=[]
+            end
+            bridges.nil? ? [] : bridges #Return array of all bridges
+        end
+
+    end
+
+#             tcontrolarray = [ {:host=>'127.0.0.1',:port => 9051, :password=> "test1234"}, {:host=>'127.0.0.1',:port => 9053},
+#                                        {:host=>'127.0.0.1',:port => 9055}, {:host=>'127.0.0.1',:port => 9057}     ]
+#             proxyconfig = 8100  # I can "getconf SocksPort" from circuitarray[0]  to determine the first array member here 
+#             orarray = ["A","B","C", "E","F","G", "A","B","C", "E","F","G"]
+#             test = Tor::LongCircuit.new(tcontrolarray, orarray,proxyconfig)
+
+    #    This creates a Long circuit comprising of multiple sub-circuits. Methods include LongCircuit.built?, LongCircuit.extend,LongCircuit..attach_streams,  
+    class LongCircuit
+
+        #    Creates an instance of Tor::LongCircuit and initialises the attributes of the instance including the cirnum, @built and @circuitarray containing an sub-circuits that are instances of Tor::Circuit
+        def initialize( tcontrolarray=[], circuitarray=[], proxyconfig )
+            #    Would it be better to get proxyconfig from mytor.getconf("SocksPort") 
+            @built = false
+            @cirnum = 0
+            @circuitarray = []
+            i = 0; j = 2;  k=0
+            while i < circuitarray.count
+                if tcontrolarray[k]
+                    if k == 0
+                      @circuitarray << Circuit.new( tcontrolarray[k], circuitarray[ i..j ] , nil )
+                    else
+                      @circuitarray << Circuit.new( tcontrolarray[k], circuitarray[ i..j ] , proxyconfig + k )
+                    end
+                    i +=3
+                    j +=3
+                    k +=1
+                end
+            end
+        end
+
+        #    This tries to attach all streams to to a single pre-established circuit.
+        def attach_streams
+            #    fork_reactor runs the reactor in a new thread thus allowing other methods to e run. Should I store the pid? When do I close the pid?
+            #    EM.fork_reactor{
+            EM.run {
+                #    @counter = 0 if not defined?(@seun)    # To count how many times an event has been triggered
+                @timer=Array.new(@circuitarray.count)
+                0.upto(@circuitarray.count - 1){|z|
+                    if ! @circuitarray[z].launched?
+                        @circuitarray[z].launch
+                    end
+
+                    # Periodic timer to fire an event, in this case launch/attach sub circuits. If a custom value (Tor::PERIODIC_TIMER) is defined, use it instead 
+                    timer = (defined? Tor::PERIODIC_TIMER) ?  Tor::PERIODIC_TIMER : Tor::Constants::PERIODIC_TIMER
+
+                    # Keep checking if any of the subcircuits has been closed using the timer duration
+                    @timer[z] = EventMachine::PeriodicTimer.new(timer) do
+                        @timer[z].cancel if @circuitarray[z].closed?
+                        # puts "Counter = #{@counter+=1}\n"
+                        @circuitarray[z].start
+                    end
+                }
+            }
+
+            y = ( built? ).index(false)
+            puts "#{y} - #{built?}\n"
+            extend y
+            return nil
+        end
+
+        #
+        def cirnum
+            @circuitarray[0].cirnum
+        end
+
+        #    Checks if the subcircuits have been built.
+        def built?
+            @built = true
+            truth_table = @circuitarray.collect{|each_circuit| each_circuit.built? } # To know where the circuit is failing
+	    truth_table.each{|truth_value| @built = @built & truth_value }
+            truth_table
+        end
+
+        #    This closes all the sub-circuits.
+        def close_apps
+            @circuitarray.each{|z|
+                z.close_apps
+            }
+        end
+
+        # Returns the array of Tor::Circuit instances that make up the LongCircuit instance.
+        def circuit
+            @circuitarray
+        end
+
+        #    Returns the circuit number of the entry circuit. 
+        def cirnum
+            @circuitarray[0].cirnum    # built? ? @circuitarray[0].cirnum : nil 
+        end
+
+        #    Extend circuits from startcir position in the circuit array. This is used internally by Tor.attach_streams There is no need to call this directly, instead use attach_streams method.
+        def extend(*startcir)
+            if startcir.empty?
+                tmp=0
+            elsif startcir[0].nil?
+                tmp=0
+            else
+                tmp = startcir[0]
+            end
+
+            #  Extend all sub-circuits or extend  only circuits from startcir index.
+            tmp.upto(@circuitarray.count - 1 ){ |y|
+                each_circuit = @circuitarray[y]
+                counter_z=0
+                while ! each_circuit.built?  and counter_z < 15     # Try up to 15 times to build the same circuit before giving up
+                    # each_circuit.launch if y != 0   # here I need to launch tor and polipo in this method with the right config file after adding tmpdir path and configs
+                    cirnum = each_circuit.extend
+                    if each_circuit.built?
+                        next
+                    else
+                        sleep( 2 * @circuitarray.index(each_circuit) + 2 )      # arithmetic progression time possible delay between each circuits [2,4,6,8,10,12]...
+                        next if each_circuit.built?
+                    end
+                    z += 1
+                end
+
+                if z == 15
+                    puts "Circuit failed \n" 
+                    return nil
+                else
+                    cirnum
+                end
+            }
+        end    # end extend()
+
+
+    end   # end of class
+end  #end of module