home *** CD-ROM | disk | FTP | other *** search
/ Chip 2001 May / W2KPRK.iso / apps / InternetScanner / data1.cab / Tools_Files / PingerDoc.txt < prev    next >
Text File  |  1999-11-22  |  3KB  |  65 lines
  1. ISS Pinger v1.0
  2.  
  3. This program will send ICMP echo requests to a range of IP addresses and track
  4. the hosts that respond.  The simple form of the command line is:
  5.  
  6.     "pinger <IP address range>"
  7.  
  8. where the address range may be specified as a single IP address or as a
  9. range in the form "XXX.XXX.XXX.XXX-YYY.YYY.YYY.YYY".  For example,
  10.  
  11.     "pinger 10.1.1.25"
  12.  
  13. will ping the IP address 10.1.1.25.
  14.  
  15.     "pinger 10.1.1.1-10.1.2.255"
  16.  
  17. will ping the IP addresses in the range from 10.1.1.1 to 10.1.2.255, inclusive.
  18.  
  19. The performance of the pinger app may vary widely depending on network topology
  20. and available bandwidth.  For this reason, the speed at which the program
  21. operates is tunable via command-line options.  To tune the pinger properly
  22. requires an understanding of the operation of the program, so here's a quick
  23. tutorial.
  24.  
  25. The pinger will make up to 5 passes through the specified IP address range,
  26. pinging each host in the range once per pass.  At the end of each pass, any
  27. hosts from which responses have been received will be removed from the list so
  28. that they will not be pinged again.  After the last pass has been completed,
  29. the pinger will keep listening for replies for one second.  When a full second
  30. has elapsed during which no further replies have been received, the program
  31. will exit.  The length of this "trailing timeout" is configurable via the
  32. "-t" command-line option.  For example, the command
  33.  
  34.     "pinger 10.1.1.1-10.1.2.255 -t 2.5"
  35.  
  36. will ping the specified address range and will listen for 2.5 seconds after
  37. the last pass has been completed.  When 2.5 seconds have elapsed during which
  38. no replies have been received, the program will terminate.
  39.  
  40. The ICMP echo request packets are sent in bursts with a pause between each
  41. burst.  Both the size of a burst and the duration of the pause between bursts
  42. are configurable.  To set the number of packets per burst, use the "-c"
  43. command-line option.  The default value for "-c" is 64 packets/burst.  To
  44. set the duration of the wait period between bursts, use the "-w" command-line
  45. option.  "-w" is specified in seconds; and the default value for "-w" is 0.125,
  46. or 125 milliseconds.  For example, the command
  47.  
  48.     "pinger 10.1.1.1-10.1.2.255 -c 32 -w 0.5"
  49.  
  50. will ping the specified address range, sending 32 ICMP echo request packets per
  51. burst and pausing for 500 milliseconds between each burst.
  52.  
  53. The burst size and wait period are crucial parameters, and may be used to
  54. speed up or slow down the pinger.  WARNING:  if it's run too quickly, the pinger
  55. may flood a network and miss host replies due to lost packets.
  56.  
  57. The "-h" command-line option may be used to generate a host file suitable for
  58. input to ISS's Internet Scanner.  For example, the command
  59.  
  60.     "pinger 10.1.1.1-10.1.2.255 -h hostfile.txt"
  61.  
  62. will ping the specified address range and generate a host file in a file named
  63. "hostfile.txt".  The pinger identifies and filters broadcast addresses, so the
  64. host file will not include any broadcast addresses.
  65.