xref: /freebsd/usr.bin/rup/rup.1 (revision fbbd9655e5107c68e4e0146ff22b73d7350475bc)
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.\"
30c3aac50fSPeter Wemm.\" $FreeBSD$
31a82f86e1SGeoff Rehmet.\"
32a82f86e1SGeoff Rehmet.Dd June 7, 1993
33a82f86e1SGeoff Rehmet.Dt RUP 1
3462500372SRuslan Ermilov.Os
35a82f86e1SGeoff Rehmet.Sh NAME
36a82f86e1SGeoff Rehmet.Nm rup
37a82f86e1SGeoff Rehmet.Nd remote status display
38a82f86e1SGeoff Rehmet.Sh SYNOPSIS
39692bc4fdSPhilippe Charnier.Nm
40a82f86e1SGeoff Rehmet.Op Ar host ...
41a82f86e1SGeoff Rehmet.Sh DESCRIPTION
42e8937ba0SPhilippe CharnierThe
43e8937ba0SPhilippe Charnier.Nm
44e8937ba0SPhilippe Charnierutility displays a summary of the current system status of a particular
45742c75f3SPhilippe Charnier.Ar host
46a82f86e1SGeoff Rehmetor all hosts on the local network.
47a82f86e1SGeoff RehmetThe output shows the current time of day, how long the system has
48a82f86e1SGeoff Rehmetbeen up,
49a82f86e1SGeoff Rehmetand the load averages.
50a82f86e1SGeoff RehmetThe load average numbers give the number of jobs in the run queue
51a82f86e1SGeoff Rehmetaveraged over 1, 5 and 15 minutes.
52a82f86e1SGeoff Rehmet.Pp
53a82f86e1SGeoff RehmetThe
54a82f86e1SGeoff Rehmet.Xr rpc.rstatd 8
55a82f86e1SGeoff Rehmetdaemon must be running on the remote host for this command to
56a82f86e1SGeoff Rehmetwork.
57e8937ba0SPhilippe CharnierThe
58e8937ba0SPhilippe Charnier.Nm
59e8937ba0SPhilippe Charnierutility uses an RPC protocol defined in
60ac4c858bSRuslan Ermilov.In rpcsvc/rstat.x .
61251c176fSRuslan Ermilov.Sh EXAMPLES
623cfb58ecSRuslan Ermilov.Bd -literal
63a82f86e1SGeoff Rehmetexample% rup otherhost
64a82f86e1SGeoff Rehmetotherhost   7:36am  up 6 days, 16:45,  load average: 0.20, 0.23, 0.18
65a82f86e1SGeoff Rehmetexample%
66a82f86e1SGeoff Rehmet.Ed
67a82f86e1SGeoff Rehmet.Sh DIAGNOSTICS
6819ab52cbSDima Dorfman.Bl -diag
69a82f86e1SGeoff Rehmet.It rup: RPC: Program not registered
70a82f86e1SGeoff RehmetThe
71a82f86e1SGeoff Rehmet.Xr rpc.rstatd 8
72a82f86e1SGeoff Rehmetdaemon has not been started on the remote host.
73a82f86e1SGeoff Rehmet.It rup: RPC: Timed out
746a3e8b0aSRuslan ErmilovA communication error occurred.
756a3e8b0aSRuslan ErmilovEither the network is
76a82f86e1SGeoff Rehmetexcessively congested, or the
77a82f86e1SGeoff Rehmet.Xr rpc.rstatd 8
78a82f86e1SGeoff Rehmetdaemon has terminated on the remote host.
79a82f86e1SGeoff Rehmet.It rup: RPC: Port mapper failure - RPC: Timed out
80a82f86e1SGeoff RehmetThe remote host is not running the portmapper (see
818657581bSMaxim Sobolev.Xr rpcbind 8 ) ,
826a3e8b0aSRuslan Ermilovand cannot accommodate any RPC-based services.
836a3e8b0aSRuslan ErmilovThe host may be down.
84a82f86e1SGeoff Rehmet.El
85a82f86e1SGeoff Rehmet.Sh SEE ALSO
86914f6e62SJoel Dahl.Xr rpc.rstatd 8 ,
87914f6e62SJoel Dahl.Xr rpcbind 8
88a82f86e1SGeoff Rehmet.Sh HISTORY
89a82f86e1SGeoff RehmetThe
90692bc4fdSPhilippe Charnier.Nm
91a82f86e1SGeoff Rehmetcommand
92a82f86e1SGeoff Rehmetappeared in
93ac4c858bSRuslan Ermilov.Tn Sun-OS .
94a82f86e1SGeoff Rehmet.Sh BUGS
95a82f86e1SGeoff RehmetThe sorting options are not implemented.
96