Download Latest Version SubSp4ce.tar.gz (81.1 kB) Google Add to Preferred Sources
Home / alpha_0_0_2
Name Modified Size InfoDownloads / Week
Parent folder
Tachyon.c 2011-12-06 19.0 kB
README 2011-12-06 5.4 kB
SubSp4ce.tar.gz 2011-12-06 81.1 kB
Screenshot at 2011-12-06 02_37_06.png 2011-12-06 203.0 kB
Totals: 4 Items   308.6 kB 0
//////////////////////////////////////////////////////////////////////////////
|                 _____       _     _____         ___                        | 
|                /  ___|     | |   /  ___|       /   |                       | 
|                \ `--. _   _| |__ \ `--. _ __  / /| | ___  ___              |
|                 `--. \ | | | '_ \ `--. \ '_ \/ /_| |/ __|/ _ \             |
|                /\__/ / |_| | |_) /\__/ / |_) \___  | (__|  __/             |
|                \____/ \__,_|_.__/\____/| .__/    |_/\___|\___|             |
|                                        | |                                 |
|                                        |_|                                 |
//////////////////////////////////////////////////////////////////////////////

	 	    		 Alpha 0.02
		     		 ==========

+=~-=~-=~-=+
|Background|
+=~-=~-=~-=+------------------------------------------------------------------
The following document describes how to get subspace running from scratch.
Please keep in mind that this is a WORK IN PROGRESS. Right now there's a LOT
of "planned" items that have yet to be added, so please bear with me.

Before jumping into the directions I feel a diagram will better show where the
files lie in the grand scheme of SubSp4ce:

	   	         .~~~~~~~~~~~~~~~~~~~~~~~~~~~.
	           __~~~/                             \~~~__
	          (	     ___  ___  __        ___ ___    )
                  (   | |\ |  |  |__  |__) |\ | |__   |     )
                  (   | | \|  |  |___ |  \ | \| |___  |     ) 
                  (__ 					  __)
	            ~~~\                             /~~~
	                .~~~~~~~~~~~~~~~~~~~~~~~~~~~.
	                             ^   
                                    / \   
                                     |          .---------------------------.
                                     |          |                           |
	                            \ /         |          SubSp4ce         |
	                             v		|           (PHP)           |
                               .-----------.    |                           |
                               |   Modem   |    |    !Network Monitoring    |
                               '-----------'    |            Info           |
                                     ^          |                           |
                                    / \         |  ! Worm Hole Filter Maker |
                                     |          |                           |
                                     |          |   +=============+         |
		                    \ /         |   |   Tachyon   |         |
            	    	             v          |   |  (libpcap)  |         |
  .-------------------.        .-----------.    |   |(MYSQL C API)|         |
  |Black List Incoming|        | Worm Hole*|    |   | Packet Dump |         |
  |White List Outgoing|------->| (iptables)|    |   +=============+         |
  '-------------------'        '-----------'    |                           |
                                     ^          '---------------------------'
                                    / \           /
                                     |           /
                                    (*)-/<------/
				     |
		                    \ /
		    	             v
                  .---------------------------------------.
                  |     Local Router / Local IP Space     |
	          |          ex. 192.168.1.0/24           |		
                  '---------------------------------------'

Subspace will simply show the packet source/destination and ports that is
occuring on the network as captured by Tachyon. SubSp4ce is a collection
of PHP files which can run on any php supported web server.

Tachyon is considered a module of SubSp4ce, since it's a meshing of the C
API from MySQL's client software and that of libpcap.

* Wormhole is a non-implemented feature, but it's planned capability that
may occur after the completion of SubSp4ce.
 
---------------------------------------------------------------------------


+=~-=~-=~-=~-+
|Installation|
+=~-=~-=~-=~-+-------------------------------------------------------------
SubSpace:
	1. Move the table.php file into /var/www/
	2. Configure the MySQL settings to allow DB access

Tachyon:
	1. Execute the .sql file (phpmyadmin?) to add the database
	2. Download the source for libpcap (1.0 or greater)
		1. Extract Files. 
		2. Step through the make/configure/ install
	 	3. Ensure that your library extracts
		4. Meet Dependencies
			1. Ubuntu needs flex, byacc, and build-essential	 	
		4. ./configure && make && makeinstall
		5. Copy the libpcap.so.1.X.X to /usr/bin/*
			1. You may have to rename the file to
			   libpcap.so.1
	3. obtain mysqlclient-dev
		1. Ubuntu: libmysqlclient15-dev
	        2. Run the command(gcc)/update DB login info
	4. Build the SubSp4ce.c file
		1. Change the Mysql credentials in the .c file
		   (Look at build command in file)
---------------------------------------------------------------------------

+=~-=~-=~-=~-=+
|Release Notes|
+=~-=~-=~-=~-=+-------------------------------------------------------------
0.01: Intial Release to public. Terrible web interface and Tachyon.

0.02: Updated Web Interface (looks nicer/menu browser). Tachyon now will log
ALL packet time stamps (but SubSp4ce hasn't yet implemented this feature).


Source: README, updated 2011-12-06