The files inside the distribution

Source distribution

Dumperw.pm Hacked version of Data::Dumper Perl module, which allows certain null and undefined values to be used.
LpTests.pm Perl module which contains the localProxy internal test code
WLib.pm Perl module which contains a lot of code common to all the proxyTools
Wires.pm Perl module which provides the 'wire' object and related methods. The wire object encapsulates the information (socket handles, service, commStrat, layers, hosts/proxies, URLs, errors, speed etc.) related to any single connection through localProxy.
advert.gif Image used to display when the 'ad-zapping' mechanism is used.
cgiAmbles.txt CGI proxies usable by localProxy in commStrat 2(g).
cleanHosts.pl Perl script which allows removal of disabled proxies from the proxy database (hosts.xml) and config files
commStrats.xml Requirements for localProxy to use when building each service.commStrat.
config-KSA-arabnet.xml Configuration files. These files may override data from any of the other data files. These appear in the localProxy GUI 'Configurations' list in an abbreviated form (in this case, as 'KSA-arabnet')
config-KSA-atheer.xml
config-KSA-awalnet.xml
config-KSA-medunet.xml
config-KSA-naseej.xml
config-KSA-nesma.xml
config-KSA-ogertel.xml
config-KSA-sbm.xml
config-KSA-zajil.xml
config-UAE-ADSL.xml Config file for UAE ADSL users.
config-UAE-dialup.xml Config file for UAE dialp users.
config-User0.xml Config file for a corporate firewall.
config-free.xml Config file for users with no firewall, or proxies.
config-minimalServices.xml Config file for a localProxy build with the absolute minimum of services. The quickest build.
config-sshOnly.xml Config file for a build using only CONNECT. Allows the user to use ssh for everything else (port forwarding, socks proxy, etc).
config-syria-scs-net.xml
config-template.txt A template configuration file, used when generating an 'auto' configuration.
config-wayne-ADSL.xml My config file for UAE ADSL, provided as an example of the use of tags to override those from other data files.
config-wayne-dialup.xml My config file for UAE-dialup, provided as an example of the use of tags to override those from other data files.
configs/ Directory containing various old config files for use with proxyTools utilities (still functional, but not used much any more)
extractHosts.pl Perl script to extract proxies from the hosts.xml database. This allows selection based on tags, by firewall they are in, by firewall the user needs to penetrate, by speed, etc.
findProxy.pl Perl script to extract proxy-like strings from web pages, files, bulletin boards, forums etc. Normally used to provide statProxy with a list to test. FindProxy has many other options, but most have been superseded by options in statProxy.
findProxyVlad.pl A version of findProxy which was specifically tailored for use with a particular proxy list site. Not used now.
firewalls.xml Known firewall/ISP specifications. Blocked ports, name servers, subnets, transparent proxy info, etc.
globals.xml Top level parameters (debug level, commStrat 2 substrategy selection probabilities, build limits, run thresholds, etc.)
groups.xml unused
help/ Directory containing the majority of the help documentation in html format. Accessed from the front page in the main directory (readme.html)
httpw.pm Perl LWP module hacked to allow findProxy to use CONNECT proxies to access external sites. This is no longer needed and will be removed in future versions. StatProxy performs this function now, using direct socket code.
localProxy.ico LocalProxy icon.
localProxy.pl Perl script often referred to as the localProxy GUI. The starting point for Windows users, and Unix users with Tk.
localProxy.tam A Tiki Artist (the GUI builder I used) control file
localProxy.tas Tiki Artist Perl source code body.
localProxy.taw Tiki Artist file used to generate the GUI (Windows, buttons, events, etc.)
localProxy2.pl LocalProxy back end. This is the packet switching engine which does all the work. It provides local proxy services as specified, and the adaptive nature of the experience. Logging etc., are also provided.
localProxyUnix.rc Config file for Unix users with no X toolkit, or Perl XML modules installed.
master.pl Perl script which maps the user's firewall rules. Optionally also tests any given proxies (by calling statProxy).
mergeHosts.pl Perl script which takes proxy test results from statProxy and merges these into hosts.xml or into a user configuration file.
pfProxy.pl Perl script which provides a 'preforking' proxy for web browsing. Not used by many, and not written by me.
proxy.pac The proxy autoconfiguration file used when the localProxy autoconfiguration service (ad-zapping, etc.) is used.
random.html File containing a yahoo URL which provides a redirection to a random URL. Was used by localProxy for automatic learning ('Train me'). Now the internal tests replace use of this file (though they still use the Yahoo URL to 'seed' the web spidering used for these internal tests).
random.txt File which was used only to display a message in the localProxy 'Train me' page.
readme.html The front page for all the help documentation.
releaseNotes.txt Release notes for this version.
script-wayne Unix script which can be run from the localProxy's 'Run setup script' button. The script is not needed, but may be used to log the user into a shell account, start ssh with port forwarding, socks proxy etc., for use by localProxy when it is started.
script-wayne.bat DOS version of the above script.
services.xml Specifications for each service, used by localProxy during build.
sortProxy.pl Perl script which merges, resolves IP addresses, dedupes, etc. files containing lists of proxies.
statProxy.pl Perl script which tests proxies vrey comprehensively (20 tests). The results are merged into the various databases by mergeHosts. StatProxy tests command-line specified proxies, or files of proxies, is able to scan proxy ports, test via CONNECT proxies, etc.
tee.pl Perl script provided to allow simultaneous logging of a proxyTools utility's output to the screen and to a file.

Files which are created in use

config-*.old.xml, hosts.old.xml
Backup file created by mergeHosts when the original file is updated with statProxy results.
config-auto.xml The configuration file created when the localProxy GUI 'AutoConfigure' button is used.
config-last.xml The configuration file created when the localProxy back end is terminated.
config-saved.xml
The configuration file created when the localProxy GUI 'Save running config' button is used.
statProxy.<date>.out Unique file containing a copy of the statProxy results.
findProxy.<date>.out Unique file containing a copy of the findProxy results.
*.orig ???
temp.stored LocalProxy data file containing all the xml files loaded before the build, quickly reloaded when 'Add plugin service' is used.
tests-auto.txt File created by localProxy GUI when 'AutoConfigure' button is used, containing proxy test results.
tests-userSpecd.txt File created by localProxy GUI when 'Test/merge proxies' button is used, containing proxy test results.
master.log File created by localProxy GUI when 'AutoConfigure' button is used, containing errors when master was run.
master.xml File created by localProxy GUI when 'AutoConfigure' button is used, or by master, containing network info and firewall analysis results.
localInfo-last.xml Data file created when localProxy GUI's 'Exit' button is used, or localProxy back end exits. Contains a set of proxies which failed at some time during the running of the back end. Normally statProxy is run on this to retest these proxies, and mergeHosts is used to merge those results back into hosts.xml or config-*.xml.
localInfo-saved.xml Data file created when localProxy GUI's 'Save running config' button is used. Contains a set of proxies which failed at some time during the running of the back end. Normally statProxy is run on this to retest these proxies, and mergeHosts is used to merge those results back into hosts.xml or config-*.xml.
hosts.old.zip Backup of the hosts.zip file after it has been automatically decompressed to hosts.xml.
hosts.xml The proxy database, created from hosts.zip the first time any proxyTool utility which needs it is run. Contain the proxy capabilities, past reliability, past speed, authentication requirements, access info, etc.