Short: netecho checks if a host is available.
Type: comm/tcp
Uploader: cosinus@deepthought.north.de (Christian Stelter)
Author: atte@crash.north.de (Andreas Gelhausen)

System requirements:   Kickstart 2.04+ and AmiTCP 4.0+


Copyright
=========

   netecho 37.1 - Copyright © 1994 by Andreas Gelhausen, all rights
reserved.

   netecho is freely distributable. No part of this archive is allowed
to be distributed with commercial software without written permission
of the author.


Disclaimer
==========

   No warranties are made for this program. All use is at your own
risk. No liability or responsibility is assumed for any damages
occured during the usage of netecho. You have been warned.


Usage
=====

   netecho is based on the TCP/IP service 'echo' and it's useful to
check the availability of a certain host within scripts. If the given
host is available, the string 'NETECHO' will be printed and the return
value is set to 0 (RETURN_OK). Otherwise an error message is printed
and the return value is set to 20 (RETURN_FAIL).

Usage:
         netecho <hostname>

Example:
         netecho crash.north.de

Example script 1:

         failat 21
         netecho >nil: crash.north.de
         if warn
            echo "crash.north.de is not available!"
         else
            echo "crash is alive! =¦^)"
         endif

Example script 2:

         failat 21
         if "`netecho crash.north.de`" eq "NETECHO"
            echo "crash is alive! =¦^)"
         else
            echo "crash.north.de is not available!"
         endif


How to reach the author
=======================

   If you have questions, suggestions, bug reports or anything else,
you can send electronic mails to:

              atte@crash.north.de (Andreas Gelhausen)

   If it is not possible for you to use this way, you can also send 
letters to:

                       Andreas Gelhausen
                       Graf Spee Str. 23b
                       26123 Oldenburg
                          - Germany -