All source code and binaries available for download from this site are subject
to the following license:
Copyright (c) 2004-2005, Kyle Smith
All rights reserved.
Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are met:
* Redistributions of source code must retain the above copyright notice,
this list of conditions and the following disclaimer.
* Redistributions in binary form must reproduce the above copyright
notice, this list of conditions and the following disclaimer in the
documentation and/or other materials provided with the distribution.
* Neither the name of the author nor the names of its contributors may be
used to endorse or promote products derived from this software without
specific prior written permission.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE
FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
First and foremost, make sure you have Java 1.4.2 or later installed. It
can be downloaded
here
(you probably want the JRE). J2SE 5.0 should work but the itemcollector
has not been tested with it.
You will also need libpcap installed to be able to capture the network
traffic. Linux users should install the appropriate package for their
distribution. Windows users will need to download winpcap from
here.
Once you have both java and libpcap (or winpcap) installed, grab the item
collector itself, this includes the sourcecode and is about 1.5MB.
Download the latest jar file and
overwrite the itemcollect.jar from the tar.gz or zip archive you downloaded.
Uncompress the archive and run either run.bat (Windows) or run.sh (Linux)
and the item collector should start. Please note that the item collector
must be run as root on Linux for it to be able to sniff the network traffic.
To set the name you submit items as, edit the run.sh (or run.bat) and
change 'default' to the name you wish to submit items as.
This is what it should look like when you start the item collector.
PacketCapture: loading native library jpcap.. ok
Devices[0] = 'lo'
Devices[1] = 'eth0'
Listening on 'eth0'
Waiting for client...
Server Version: 0.2.0
ItemStore: items.db
Added PCL
User Name: ksmith
ItemCollect
-- Press 'f' to flush the item store --
-- Press 'q' to exit --
All incoming items must be approved by hand before they are viewable on the
website.