README for IPtools (Release 0.9.9)
----------------------------------
1. Introduction
IPtools is a set of handy TCP/IP programs that can be all put into an USB flash, so that no installation is required. These tools include different kinds of server programs such as ftp server, tftp server, syslog server, mini Webserver, Remote command server (like a telnet server - yet "like"!), generic UDP server and so on ...
While client tools include snmp browser, host scanner, tftp client, Multicast client and so on ...
Release 0.2.0 includes a tool UBridge to bridge the dynamips (Cisco Router Simulator) and Lito (H3C Router Simulator) interfaces, this tools can also be used to bridge 2 or more UDP sessions (like a UDP proxy).
For release 0.3.0, the UBridge is greatly enhanced to be integrated with Winpcap. This not only able to directly bridge the Lito with the physical interface of the Windows. UBridge can also being used as a Ethernet over UDP light weight tunnel to arbitrary bridge the interfaces between Windows PC over the IP network to form a layer 2 network. Please refer to my Blog at http://apps.e5link.com/blog or the project WIKI page at http://sourceforge.net/p/iptools/wiki/Home/ for detail.
In release 0.4.0, the pmon program (a powerful IP protocol monitor program) originally available in my other open source project is integrated into this package. This program is developed under Linux 13 years ago! Until recently (Dec 2013), I have time to migrate it to Windows, as there are some limitations in Windows TK feature, it needs to have some workaround for monitoring the incoming packets and display it under the TK widget.
pmon becomes the first GUI tool that available under this IPtools package (other tools will be graduately migrated to provide GUI version provided that I have time to migration them). pmon can be used to monitor what IP sessions are being created under your PC (and possible other sessions under the same LAN segment), its very useful to troubleshooting and finding out if your PC is infected by trojans, adware or any kinds of spyware, to discover hidden connections that are being originated by your Windows.
In release 0.5.0, a GUI TFTP server program is provided.
While in release 0.6.0, a GUI tool snmpscan is available, you can use this tools to scan a range of IP address using SNMP. You can configure the SNMP parameters such as coummnity (v1/v2), username/password (v3). It immediately displays the MIB tree under the OID that you specified for scanning of the scanned device.
Release 0.7.0 includes a syslogd server as a new feature.
Starting on release 0.7.1, the snmpscan tool is greatly enhanced to support the parallel scanning using multithreading. You can configure the number of scanning threads. It greatly increase the scanning performance, e.g. by using 10 parallel scans, it shortens the scanning time to become just one tenth of the previous version.
Release 0.7.2 further optimize the memory utilization, so as to allow more parallel scanning by using same amount of system memory.
Release 0.7.3 greatly enhances the GUI for those GUI utilities, such as supporting multiple selection and a right-click popup menu.
In new release 0.8.0, a network scanning GUI tools is added. This tool can use either ICMP (ping) or TCP port scanning to detect the status of hosts in a range of IP addresses. Like the snmpscan tool, it supports parallel scanning, so that within a second, it can scan over hundreds of hosts (depending on your PC's available memory). You can also use this tool to resolve the host names in a range of IP addresses.
While release 0.8.1 further improve the GUI of the snmpcan and ipscan tools to support the selection of only display those successfully access IP addresses.
In release 0.9.0, a GUI FTP server program is added. Release (0.9.1) further enhances the security, and provides an option to restrict the client access within the home directory, also a readonly option.
Release 0.9.3 improves the display of pmon and UBridge tools.
For release 0.9.4, it adds the support of server mode in ubridge tool, so that you can create a UDP leg (server end) without specifying the other peer and waiting for another peer to connect this server leg.
In release 0.9.5, "Delete All" option is available in all GUI tools, so that it can be easier to clear all the items in the display widget.
Release 0.9.6 add the enhancement for the UDP and multicast client/server tools to select the LAN card (by specific the corresponding IP) for those PC that have multiple LAN cards. Besides, there are certain bug fixes are implemented. Please read the corresponding release note under DOC folder.
Starting on release 0.9.7, the new VXLAN bridge feature in the UBridge is added. With this feature you can directly bridge your local host to a VXLAN segment without a VXLAN gateway switch. You can also use this feature to bridge several hosts over the IP network even without the VMware infrastructure.
Release 0.9.8 further enhances the UBridge to support VXLAN head end replication (HER) -- the head end VTEP replicates all BUM (broadcast, unknown unicast and multicast) frames to other VTEPs by unicast IP packets. This eliminates the multicast requirement of the transport IP network.
While this release, three major enhancements have been made in UBridge to let you extend your data center VXLAN anywhere, any time to any Windows PC over the Internet.
These enhancements include VXLAN relay, provider and access mode VTEPs, VXLAN encryption. Please read the corresponding release note for detail.
These tools are very good for testing and ad hoc setup, since no complicated installation is required, you can just bring your usb flash to any Windows base PC and directly run these tools.
If you are a person working in networking field or infrastructure support, these are indispensable tools for you.
2. How to build IPtools
All the tools are written in Perl. Starting on release 060, Stawberry Perl is being used instead of ActivePerl for Windows before, in order to be easier for distribution. Also the Perl version is upgraded from v5.8.8 to v5.8.9. You don't actually need to build these tools. The perl executable and the corresponding dependent modules that just enough to run these tools are already included in the ZIP file. If you want to have the full perl version, you can download it at strawberryperl.com.
3. Installation and run
Extract the package by using any decompress utility such as Winzip to any directory you want. To run the different tools, just open the MS-DOS command prompt, and change to the directory that you just extract the files. Enter the command directly under the command prompt. For GUI tools, you can just use the Windows explorer, browse to the installed directory and double click the corresponding BAT file.
For Ubridge and pmon, you need to install the winpcap (a copy of the winpcap installer is included in the package under the 'winpcap_installer' folder).
As of this release, the following programs are available. The examples assume that the installation directory is C:\iptools.
3.1 Webserver
To run the Webserver:
C:\iptools> Thttpd [<port #>]
3.2 Remote command server
Enter:
C:\iptools> rcmd [<port #>]
3.3 tftp client
Enter:
C:\iptools> tftp [-{get|put} <filename>] [-{netascii|ascii|octet|binary}] <server> [<port>]
3.4 Multicast Client (read the notes on release 012 and 096)
Enter:
C:\iptools> multc [-p <port_no>] [-l <listen IP>] <Multicast address> ...
The program will join the multicast group address and listen for new message
3.5 UDP client/Multicast Server (read the notes on release 012, 014, 030 and 096)
Enter:
C:\iptools> udpc [-p <port_no>] [-m <message>] [-c <count>] [-l <length>] [-c <count>] [-r <pps>] [-s <source IP>] <server> ...
C:\iptools> mults [-p <port_no>] [-m <message>] [-c <count>] [-l <length>] [-c <count>] [-r <pps>] [-s <source IP>] <multicast_group_address> ...
3.6 UDP server (read the notes on release 030 and 096)
Enter:
C:\iptools> udps [-p <port_no>] [-l <listen IP>]
Default UDP port # 5413
3.7 UDP bridge (read the notes on release 020, 094, 097, 098 , 099 and the UBridge_tutoral under the "doc" folder for detail)
Enter:
C:\iptools> ubdg [-c <file>] [-l <count>] <leg>...
<file> :configuration file
<leg> :<group>#<vendor>:<ltype>@<local_port>:<remote_ip>:<remote_port> for UDP leg
:<group>#W:E@[<Winpcap name of the interface>]
:<VNID>#V:E@<local_vtep>[*]:{0|<multicast_group>|<remote_vtep>[+<remote_vtep>]...}[*<PSK>][:<port>] for VXLAN leg
<vendor> :'C' for Cisco or 'H' for H3C
<ltype> :'E' for Ethernet or 'S' for Serial
e.g. 1#C:E@2001:10.1.1.1:3001 - leg to a Cisco Router's Ethernet port in group 1
2#W:E@\Device\NPF_{5F97CBE5-7D16-48FB-BC77-0E0DE084F049} - wire to a Winpcap interface in group 2
1#C:E@2001:0.0.0.0:0 - create a server mode UDP leg that listen to port 2001
1#C:E@2001:10.1.1.1:3001 1#W:E - will prompt you to select your NIC and forward to UDP leg
5000#V:E@10.1.1.1:225.1.1.1:8472 5000#W:E - forward local NIC to VXLAN leg using local VTEP 10.1.1.1
5000#V:E\@10.1.1.1:10.1.2.1+10.1.3.1:8472 5000#W:E - forward local NIC to VXLAN on remote VTEP 10.1.2.1 and 10.1.3.1
5000#V:E@10.1.1.1:0 5000#V:E@10.1.1.1:10.1.3.1 - use local VTEP 10.1.1.1 as provider mode and relay access VTEPs to remote VTEP 10.1.3.1
5000#V:E@10.1.1.1*:10.1.2.1*secret 5000#W:E - bridge local NIC using VTEP 10.1.1.1 as access mode to VXLAN on remote VTEP 10.1.2.1 with encryption key 'secret'
3.8 Pmon (GUI) - protocol monitor (read the notes on release 040 and 073 under the "doc" folder for detail)
Enter:
C:\iptools> pmon
3.9 TFTPD (GUI) - TFTP Server (read the notes on release 050 and 073 under the "doc" folder for detail)
Enter:
C:\iptools> tftpd
3.10 Snmpscan (GUI) - snmp scanning tool (read the notes on release 060, 071, 072, 073 and 081 under the "doc" folder for detail)
Enter:
C:\iptools> snmpscan [-n <number of parallel scanning>]
3.11 syslogd (GUI) - syslog server (read the notes on release 070 and 073 under the "doc" folder for detail)
Enter:
C:\iptools> syslogd
3.12 IPscan (GUI) - network scanning tool (read the notes on release 080 and 081 under the "doc" folder for detail)
Enter:
C:\iptools> ipscan [-n <number of parallel scanning>]
3.13 FTP Server (GUI) - ftp server program (read the notes on release 090 under the "doc" folder for detail)
Enter:
C:\iptools> ftpd
4. Current known restrictions
- For the remote command server, this one is not a telnet server, it can only execute one line commands i.e. commands that doesn't need interactive input.
If you run interactive commands like edit, ftp those need further keyboard entering, the server will hang.
- For the ubdg program, it finds that for some older PC with slower CPU, if you define a UDP leg that the remote end doesn't exist, it may consume 100% CPU time. To work around, make sure that the remote end (i.e. UDP port of the remote host) is terminated in a running router.
- To exit the server, just do a "Ctrl-C", or close your MS-DOS Window.
- For the TFTP server program, currently its only single thread (meaning that only one TFTP session can be activated at any time, you need to wait for its completion for another new file transfer). It will be improved as a multithread server in future release.
- For the snmpscan tool, AES algorithm only supported for 128 bits.
- For the IPscan tool, it requires the administrator privilege to run. In Windows 8, you need to run it under a DOS prompt that with administrator privilege. To do so, when you open the command prompt, right click to select "Run as administrator".
- In the FTP server, for security reason, the client is not allowed to browse directory across other Windows drive. However, you can set the home directory to any drive. Note that you need to use absolute path name.
- Due to the multicast issues of Windows 8, it was tested that the multc, mults and VXLAN leg of the Ubridge tool may not works properly. Some workaround is to disable the "Base Packet Filter" service, yet its not guarantee. Can google search the solution for sending and receiving multicast packets in Windows 8.
5. Online resources
http://iptools.sourceforge.net/
http://apps.e5link.com/blog
6. Credits to following people
Sbastien Aperghis-Tramoni - for the NET::PCAP library
Luigino Masarati - for the NET::TFTPd library
G. S. Marzot - for the TFTP client library
David M. Town - for the NET::SNMP library
Fabien Tassin - for the SNMP::MIB compiler library
Michael Vincent - for the NET::Syslogd library
Rob Brown and Colin McMillen - for the NET::Ping library
Richard Jones - for the NET::FTPServer.pm
And many others that provide effort to make Perl as a very powerful programming language, such as the Thread library, TK library. Many thanks to all those people that cannot be listed one by one in here (can refer to the Author of the seperate library), as without them, its not possible to create this project.
Author : Kepler Lam (First created on: September 5, 2001. Last update: Aug 22,2015) Email: keplerlam@yahoo.com
Download Latest Version
iptools-0.9.9.zip (8.7 MB)
