Commands Reference, Volume 4

rup Command

Purpose

Shows the status of a remote host on the local network.

Syntax

/usr/bin/rup [ -h | -l | -t ] [ Host ... ]

Description

The rup command displays the status of a remote host by broadcasting on the local network and then displaying the responses it receives. Specify a flag if you want to sort the output. If you do not specify a flag, the rup command displays responses in the order they are received. If you specify multiple hosts on the command line, the rup command ignores any flags and displays output in the order you specified the hosts. You must use the sort command to sort the output.

In addition, when you provide a value for the Host parameter, the rup command queries the hosts you specify, rather than broadcasting to all hosts. A remote host responds only if it is running the rstatd daemon, which is normally started from the inetd daemon.

Notes:

1. Broadcasting does not work through gateways. Therefore, if you do not specify a host, only hosts on your network can respond to the rup command.
2. Load-average statistics are not kept by the kernel. The load averages are always reported as 0 (zero) by this command.

Flags

Examples

1. To find out the status of all hosts on the network and to sort the list alphabetically by host name, enter:
   /usr/bin/rup -h
   
2. To display a list of all hosts on the network according to each machine's load average, enter:
   /usr/bin/rup -l
   
3. To display the status of a host, enter:

   /usr/bin/rup brutus 

   In this example, the rup command displays the status of the host named brutus.

4. To display the status of all hosts on the network sorted by each machine's length of runtime, enter:
   /usr/bin/rup -t
   

Files

Related Information

The sort command, the List of NFS Commands.

The inetd daemon, rstatd daemon.

Network File System (NFS) Overview for System Management in AIX 5L Version 5.2 System Management Guide: Communications and Networks.