home *** CD-ROM | disk | FTP | other *** search
/ PC Online 1996 December / PCO1296.ISO / filesbbs / os2 / ping.arj / README.1ST < prev   
Encoding:
Text File  |  1995-03-04  |  2.9 KB  |  80 lines
  1. Archive Name: ping.zip
  2. Program Description: enhanced ping utility for TCP/IP, EMX 0.9a emxrt.zip req.
  3. Operating System Versions: OS/2 2.x with TCP/IP 2.0, Warp?
  4. Program Source: Jack Grey, org. source Public Domain from UC Berkeley
  5. Replaces:
  6.  
  7. Your name: Jack Grey
  8. Your email address: jackgrey@iglou.com
  9.  
  10. Proposed directory for placement: /os2/network/tcpip
  11.  
  12. Built March 1995
  13.  
  14. Compiled with the GNU C Compiler version 2.6.3 for EMX 0.9a with EMX
  15. libraries at patch level 2. The EMX .DLL files are required and may be
  16. found at various sites under the name emxrt.zip.
  17.  
  18. ----------------------------------------------------------------------------
  19.  
  20. DISCLAIMER:
  21. -----------
  22.  
  23. In consideration of the use of this program, all USERS ACKNOWLEDGE
  24. THAT THERE ARE NO WARRANTIES AS TO MERCHANTABILITY OR FITNESS FOR
  25. A PARTICULAR PURPOSE AND USERS ACCEPT THE RESPONSIBILITY TO TAKE
  26. SUCH STEPS AS THEY DEEM NECESSARY TO PROTECT THEIR SYSTEMS AND DATA.
  27. THE AUTHOR CANNOT BE LIABLE FOR ANY LOSSES OCCURRING AS A RESULT OF
  28. THE USE OF THIS PROGRAM.
  29.  
  30. YOU USE THIS PROGRAM ENTIRELY AT YOUR OWN RISK.
  31.  
  32. ----------------------------------------------------------------------------
  33.  
  34. This is a very minor enhancement of a rather full-featured version of ping.
  35. My most minor contribution was to port it to OS/2 and add an errorlevel
  36. return facility; if no reply frames are received ( the target does not
  37. respond to ping ) errorlevel 1 is returned; if at least one reply is
  38. received errorlevel 0 is returned. This allows the program to be used in
  39. .cmd files to test whether or not a connection/host is reachable, as follows
  40. in pseudo-code resembling a .cmd file:
  41.  
  42. :pingloop
  43. ping -c 1 -s 1 -n -q somehost
  44. if errorlevel 1 goto nohost
  45. sleep forawhile
  46. goto pingloop
  47.  
  48. :nohost
  49. echo 'somehost' does not respond to ping!
  50.  
  51.  
  52.  
  53. In this example, errorlevel 1 is returned if somehost doesn't respond in
  54. 1 second or less:
  55.  
  56. ping -c 1 -s -1 -q -w 1 somehost
  57.  
  58.  
  59.  
  60. For a full explanation of the parameters, see pingman.txt, a text version of
  61. the man page that came with the source. The man page, ping.man, is also
  62. included. The orginal program has many nice features, in particular route
  63. tracing.
  64.  
  65. I have added the -w parameter to adjust the wait-for-response time
  66. from the default of 10 seconds; this is useful on slow/congested links,
  67. such as a SLIP connection with other traffic active. I have also made
  68. verbose usage displayable by the -? option.
  69.  
  70. You will probably want to either rename the ping.exe that came with your
  71. IBM TCP/IP or rename this program to something like pingrc.exe.
  72.  
  73. The modified C source is in ping.c, the original source in ping.org. A
  74. makefile for GNU make is also included.
  75.  
  76. This program is distributed as ThankYouWare - if you find it useful, drop me
  77. an email. If you find any bugs, drop me a note as well; I did this as a
  78. quickie for my own use but might have time to fix a few things.
  79.  
  80.