rup(1)

rup1

Remote status display

Usage

rup [-dhlt] [host ...]

Overview

rup displays a summary of the current system status of a particular host or all hosts on the local network. The output shows the current time of day, how long the system has been up, and the load averages. The load average numbers give the number of jobs in the run queue averaged over 1, 5, and 15 minutes.

The options are as follows:

-d

For each host, report what its local time is. This is useful for checking time synchronization on a network.

-h

Sort the display alphabetically by host name.

-l

Sort the display by load average.

-t

Sort the display by up time.

The rpc.rstatd(8) daemon must be running on the remote host for this command to work. rup uses an RPC protocol defined in /usr/include/rpcsvc/rstat.x.

Examples

$ rup otherhost
otherhost      up 6 days, 16:45,  load average: 0.20, 0.23, 0.18

Diagnostics

rup: RPC: Program not registered

The rpc.rstatd(8) daemon has not been started on the remote host.

rup: RPC: Timed out

A communication error occurred. Either the network is excessively congested, or the rpc.rstatd(8) daemon has terminated on the remote host.

rup: RPC: Port mapper failure - RPC: Timed out

The remote host is not running the portmapper (see portmap(8)), and cannot accommodate any RPC-based services. The host may be down.

Releases

61 releases since OpenBSD 2.1; the text changed 10 times.

  1. 2.1–2.3
  2. 2.4–2.5
  3. 2.6
  4. 2.7–2.8
  5. 2.9–3.0
  6. 3.1–3.3
  7. 3.4–3.5
  8. 3.6–4.0
  9. 4.1
  10. 4.2–5.5
  11. 5.6–8.0

History

The rup command appeared in SunOS.

From man 8.0-current-20261101 in OpenBSD 8.0-current (2026-11-01). Parsed by carta from the page's mdoc source.