Content-type: text/html Manpage of ISUP

ISUP

Section: CSLib Utilities (1)
Updated: August 2003
Index Return to Main Contents

NAME

isup - Find out if a machine is up by trying a TCP/IP connection

SYNOPSIS

isup [ -v ] [ -a ] [ -t SECONDS ] host [ port ]

DESCRIPTION

isup tries to create a TCP/IP connection to host (optionally on port port, default is TCP 7, i.e. echo). If the machine is up (i.e. the connection is accepted, or refused), then zero (success) is returned. A non-zero error code is returned if the connection fails.

-v, --verbose: Also print out an explanatory line of whether the machine is available or not, and if not, what the error was.
-a, --available: Will only return success if a connection can actually be made on the specified port - connection refused will return a non-zero error code.
-t, --timeout=SECONDS: This will set a custom timeout for testing, given in seconds. If not specified, the timeout will be down to the timeout in the system's connect(2) call.
-h, --help: Display usage information.

AUTHOR

isup was written by Alan Ford.