xref: /freebsd/usr.bin/rup/rup.1 (revision fa9896e082a1046ff4fbc75fcba4d18d1f2efc19)
1a82f86e1SGeoff Rehmet.\" -*- nroff -*-
2a82f86e1SGeoff Rehmet.\"
3a82f86e1SGeoff Rehmet.\" Copyright (c) 1985, 1991 The Regents of the University of California.
4a82f86e1SGeoff Rehmet.\" All rights reserved.
5a82f86e1SGeoff Rehmet.\"
6a82f86e1SGeoff Rehmet.\" Redistribution and use in source and binary forms, with or without
7a82f86e1SGeoff Rehmet.\" modification, are permitted provided that the following conditions
8a82f86e1SGeoff Rehmet.\" are met:
9a82f86e1SGeoff Rehmet.\" 1. Redistributions of source code must retain the above copyright
10a82f86e1SGeoff Rehmet.\"    notice, this list of conditions and the following disclaimer.
11a82f86e1SGeoff Rehmet.\" 2. Redistributions in binary form must reproduce the above copyright
12a82f86e1SGeoff Rehmet.\"    notice, this list of conditions and the following disclaimer in the
13a82f86e1SGeoff Rehmet.\"    documentation and/or other materials provided with the distribution.
14*fbbd9655SWarner Losh.\" 3. Neither the name of the University nor the names of its contributors
15a82f86e1SGeoff Rehmet.\"    may be used to endorse or promote products derived from this software
16a82f86e1SGeoff Rehmet.\"    without specific prior written permission.
17a82f86e1SGeoff Rehmet.\"
18a82f86e1SGeoff Rehmet.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
19a82f86e1SGeoff Rehmet.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
20a82f86e1SGeoff Rehmet.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
21a82f86e1SGeoff Rehmet.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
22a82f86e1SGeoff Rehmet.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
23a82f86e1SGeoff Rehmet.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
24a82f86e1SGeoff Rehmet.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
25a82f86e1SGeoff Rehmet.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
26a82f86e1SGeoff Rehmet.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
27a82f86e1SGeoff Rehmet.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
28a82f86e1SGeoff Rehmet.\" SUCH DAMAGE.
29a82f86e1SGeoff Rehmet.\"
30a82f86e1SGeoff Rehmet.Dd June 7, 1993
31a82f86e1SGeoff Rehmet.Dt RUP 1
3262500372SRuslan Ermilov.Os
33a82f86e1SGeoff Rehmet.Sh NAME
34a82f86e1SGeoff Rehmet.Nm rup
35a82f86e1SGeoff Rehmet.Nd remote status display
36a82f86e1SGeoff Rehmet.Sh SYNOPSIS
37692bc4fdSPhilippe Charnier.Nm
38a82f86e1SGeoff Rehmet.Op Ar host ...
39a82f86e1SGeoff Rehmet.Sh DESCRIPTION
40e8937ba0SPhilippe CharnierThe
41e8937ba0SPhilippe Charnier.Nm
42e8937ba0SPhilippe Charnierutility displays a summary of the current system status of a particular
43742c75f3SPhilippe Charnier.Ar host
44a82f86e1SGeoff Rehmetor all hosts on the local network.
45a82f86e1SGeoff RehmetThe output shows the current time of day, how long the system has
46a82f86e1SGeoff Rehmetbeen up,
47a82f86e1SGeoff Rehmetand the load averages.
48a82f86e1SGeoff RehmetThe load average numbers give the number of jobs in the run queue
49a82f86e1SGeoff Rehmetaveraged over 1, 5 and 15 minutes.
50a82f86e1SGeoff Rehmet.Pp
51a82f86e1SGeoff RehmetThe
52a82f86e1SGeoff Rehmet.Xr rpc.rstatd 8
53a82f86e1SGeoff Rehmetdaemon must be running on the remote host for this command to
54a82f86e1SGeoff Rehmetwork.
55e8937ba0SPhilippe CharnierThe
56e8937ba0SPhilippe Charnier.Nm
57e8937ba0SPhilippe Charnierutility uses an RPC protocol defined in
58ac4c858bSRuslan Ermilov.In rpcsvc/rstat.x .
59251c176fSRuslan Ermilov.Sh EXAMPLES
603cfb58ecSRuslan Ermilov.Bd -literal
61a82f86e1SGeoff Rehmetexample% rup otherhost
62a82f86e1SGeoff Rehmetotherhost   7:36am  up 6 days, 16:45,  load average: 0.20, 0.23, 0.18
63a82f86e1SGeoff Rehmetexample%
64a82f86e1SGeoff Rehmet.Ed
65a82f86e1SGeoff Rehmet.Sh DIAGNOSTICS
6619ab52cbSDima Dorfman.Bl -diag
67a82f86e1SGeoff Rehmet.It rup: RPC: Program not registered
68a82f86e1SGeoff RehmetThe
69a82f86e1SGeoff Rehmet.Xr rpc.rstatd 8
70a82f86e1SGeoff Rehmetdaemon has not been started on the remote host.
71a82f86e1SGeoff Rehmet.It rup: RPC: Timed out
726a3e8b0aSRuslan ErmilovA communication error occurred.
736a3e8b0aSRuslan ErmilovEither the network is
74a82f86e1SGeoff Rehmetexcessively congested, or the
75a82f86e1SGeoff Rehmet.Xr rpc.rstatd 8
76a82f86e1SGeoff Rehmetdaemon has terminated on the remote host.
77a82f86e1SGeoff Rehmet.It rup: RPC: Port mapper failure - RPC: Timed out
78a82f86e1SGeoff RehmetThe remote host is not running the portmapper (see
798657581bSMaxim Sobolev.Xr rpcbind 8 ) ,
806a3e8b0aSRuslan Ermilovand cannot accommodate any RPC-based services.
816a3e8b0aSRuslan ErmilovThe host may be down.
82a82f86e1SGeoff Rehmet.El
83a82f86e1SGeoff Rehmet.Sh SEE ALSO
84914f6e62SJoel Dahl.Xr rpc.rstatd 8 ,
85914f6e62SJoel Dahl.Xr rpcbind 8
86a82f86e1SGeoff Rehmet.Sh HISTORY
87a82f86e1SGeoff RehmetThe
88692bc4fdSPhilippe Charnier.Nm
89a82f86e1SGeoff Rehmetcommand
90a82f86e1SGeoff Rehmetappeared in
91ac4c858bSRuslan Ermilov.Tn Sun-OS .
92a82f86e1SGeoff Rehmet.Sh BUGS
93a82f86e1SGeoff RehmetThe sorting options are not implemented.
94