GPS v1.2 readme.txt
Updated June 20, 2005 by Weishuai Yang

All feedback appreciated to wyang@cs.binghamton.edu
 
WHAT IS GPS
================
GPS is a general P2P simulation framework for efficient and accurate modeling and 
simulation of P2P protocols and applications, including the download component 
(which is commonly abstracted away in P2P simulators). 


DISTRIBUTION
================
The distribution tree contains: 

README.TXT
	--this file
build.xml
	--used by ant
Manifest
	--for generating jar file
src/ 
	--source files
config/	
	--configuration file(including simulator.ini, bt.cfg, events.txt, and documents.txt)
graph/
	--network topology files generated by other tools
doc/
	--mannual(not ready yet)
javadoc/
	--java api reference
classes/
	--compiled code
output/
	--trace files go here



COMPILATION AND RUN
============
Compiling this package requires Ant and Java 1.5. These can be downloaded respectively from:  
http://jakarta.apache.org/ant/index.html 
http://java.sun.com/j2se/

- compile
     ant 
- run with command line
     ant sim
- run with gui
     ant gui
- make jar file for command line running
     ant jarcmd
- make jar file for gui running
     ant jargui
     
CONFIGURATION
============
simulator.ini -- configuration for simulator overall
bt.cfg -- protocol specific configuration
events.txt -- events configuration
documents.txt -- documents configuration
topology file is specified in configuration file.