rup(1)

rup1

Remote status display

Usage

rup [host ...]

Overview

The rup utility 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 rpc.rstatd(8) daemon must be running on the remote host for this command to work. The rup utility uses an RPC protocol defined in ⟨rpcsvc/rstat.x⟩.

Examples

example% rup otherhost
otherhost   7:36am  up 6 days, 16:45,  load average: 0.20, 0.23, 0.18
example%

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 rpcbind(8)), and cannot accommodate any RPC-based services. The host may be down.

Releases

87 releases since FreeBSD 2.0.5-RELEASE; the text changed 45 times.

  1. 2.0.5
  2. 2.1.5–2.1.7.1
  3. 2.2.2
  4. 2.2.5–2.2.8
  5. 2.2.9
  6. 3.0–3.2
  7. 3.3–3.5.1
  8. 4.0
  9. 4.1–4.2
  10. 4.3
  11. 4.4–4.6.2
  12. 4.7–4.11
  13. 5.0–5.2.1
  14. 5.3–6.3
  15. 6.4
  16. 7.0
  17. 7.1
  18. 7.2
  19. 7.3
  20. 7.4
  21. 8.0
  22. 8.1
  23. 8.2
  24. 8.3
  25. 8.4
  26. 9.0
  27. 9.1
  28. 9.2
  29. 9.3
  30. 10.0
  31. 10.1
  32. 10.2
  33. 10.3
  34. 10.4
  35. 11.0
  36. 11.1
  37. 11.2
  38. 11.3
  39. 11.4
  40. 12.0
  41. 12.1
  42. 12.2
  43. 12.3
  44. 12.4
  45. 13.0–13.2
  46. 13.3–16.0

History

The rup command appeared in Sun-OS.

Bugs

The sorting options are not implemented.

From base 16.0-CURRENT-20261027-61c70dc16a79 in FreeBSD 16.0-CURRENT (2026-10-27). Parsed by carta from the page's mdoc source.