IPtools
-------

1. Introduction

IPtools is a set of small tiny TCP/IP programs that can be all put into one 
single floppy, so that no installation is required. These tools include many 
small IP servers e.g mini Webserver, Remote command server (like a telnet 
server - yet "like"!), tftp server (in future) and so on ... Also client tools include 
tftp client, Mulitcast client, snmp browser (in future) and so on ...  

Release 1.5 include a tools 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). 

These small tools are very good for testing TCP/IP connectivities, since no 
complicate installation is required, you can just bring your usb flash to any 
Windows base PC and directly run those tools.

2. How to build IPtools

As IPtools is written in ActivePerl for Windows, you don't actually need to 
build it. I have already included the perl executable (v5.6) which is just 
enough to support IPtools in the distribution. If you want to have the full 
perl version, try download it at www.activestate.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.

As of this release (0.15), 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

Enter:

C:\iptools> multc [-p <port_no>] [<Multicast address> ...]

The program will join the multicast group address and listen for new message


3.5 UDP client (read the notes on release 013)

Enter:

C:\iptools> udpc [-p <port_no>] [-m <message>] [-c <count>] [-r <pps>] [-w] <server> ...

3.6 UDP bridge (read the notes on release 015 for detail)

Enter:

C:\iptools> ubdg apps\ubdg.pl [-c <file>] <wire>...
  <file>   :configuration file
  <wire>   :<group>#<vendor>:<ltype>@<local_port>:<remote_ip>:<remote_port>
  <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 - wire to a Cisco Router's Ethernet port in group 1

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.

5. Online resources

  http://iptools.sourceforge.net/




Author : Kepler Lam  (Created on: September 5, 2001. Last update: Oct 29,2013)    Email: keplerlam@hotmail.com