1*df930be7Sderaadt.\" -*- nroff -*- 2*df930be7Sderaadt.\" 3*df930be7Sderaadt.\" Copyright (c) 1985, 1991 The Regents of the University of California. 4*df930be7Sderaadt.\" All rights reserved. 5*df930be7Sderaadt.\" 6*df930be7Sderaadt.\" Redistribution and use in source and binary forms, with or without 7*df930be7Sderaadt.\" modification, are permitted provided that the following conditions 8*df930be7Sderaadt.\" are met: 9*df930be7Sderaadt.\" 1. Redistributions of source code must retain the above copyright 10*df930be7Sderaadt.\" notice, this list of conditions and the following disclaimer. 11*df930be7Sderaadt.\" 2. Redistributions in binary form must reproduce the above copyright 12*df930be7Sderaadt.\" notice, this list of conditions and the following disclaimer in the 13*df930be7Sderaadt.\" documentation and/or other materials provided with the distribution. 14*df930be7Sderaadt.\" 3. All advertising materials mentioning features or use of this software 15*df930be7Sderaadt.\" must display the following acknowledgement: 16*df930be7Sderaadt.\" This product includes software developed by the University of 17*df930be7Sderaadt.\" California, Berkeley and its contributors. 18*df930be7Sderaadt.\" 4. Neither the name of the University nor the names of its contributors 19*df930be7Sderaadt.\" may be used to endorse or promote products derived from this software 20*df930be7Sderaadt.\" without specific prior written permission. 21*df930be7Sderaadt.\" 22*df930be7Sderaadt.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND 23*df930be7Sderaadt.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 24*df930be7Sderaadt.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 25*df930be7Sderaadt.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE 26*df930be7Sderaadt.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 27*df930be7Sderaadt.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 28*df930be7Sderaadt.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 29*df930be7Sderaadt.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 30*df930be7Sderaadt.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 31*df930be7Sderaadt.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 32*df930be7Sderaadt.\" SUCH DAMAGE. 33*df930be7Sderaadt.\" 34*df930be7Sderaadt.\" $Id: rup.1,v 1.1.1.1 1995/10/18 08:46:03 deraadt Exp $ 35*df930be7Sderaadt.\" 36*df930be7Sderaadt.Dd June 7, 1993 37*df930be7Sderaadt.Dt RUP 1 38*df930be7Sderaadt.Os BSD 4.3 39*df930be7Sderaadt.Sh NAME 40*df930be7Sderaadt.Nm rup 41*df930be7Sderaadt.Nd remote status display 42*df930be7Sderaadt.Sh SYNOPSIS 43*df930be7Sderaadt.Nm rup 44*df930be7Sderaadt.Op Fl dhlt 45*df930be7Sderaadt.Op Ar host ... 46*df930be7Sderaadt.Sh DESCRIPTION 47*df930be7Sderaadt.Nm rup 48*df930be7Sderaadtdisplays a summary of the current system status of a particular 49*df930be7Sderaadt.Em host 50*df930be7Sderaadtor all hosts on the local network. 51*df930be7SderaadtThe output shows the current time of day, how long the system has 52*df930be7Sderaadtbeen up, 53*df930be7Sderaadtand the load averages. 54*df930be7SderaadtThe load average numbers give the number of jobs in the run queue 55*df930be7Sderaadtaveraged over 1, 5 and 15 minutes. 56*df930be7Sderaadt.Pp 57*df930be7SderaadtThe following options are available: 58*df930be7Sderaadt.Bl -tag -width indent 59*df930be7Sderaadt.It Fl d 60*df930be7SderaadtFor each host, report what it's local time is. 61*df930be7SderaadtThis is useful for checking time synchronization on a network. 62*df930be7Sderaadt.It Fl h 63*df930be7SderaadtSort the display alphabetically by host name. 64*df930be7Sderaadt.It Fl l 65*df930be7SderaadtSort the display by load average. 66*df930be7Sderaadt.It Fl t 67*df930be7SderaadtSort the display by up time. 68*df930be7Sderaadt.El 69*df930be7Sderaadt.Pp 70*df930be7SderaadtThe 71*df930be7Sderaadt.Xr rpc.rstatd 8 72*df930be7Sderaadtdaemon must be running on the remote host for this command to 73*df930be7Sderaadtwork. 74*df930be7Sderaadt.Nm rup 75*df930be7Sderaadtuses an RPC protocol defined in /usr/include/rpcsvc/rstat.x. 76*df930be7Sderaadt.Sh EXAMPLE 77*df930be7Sderaadt.Bd -unfilled -offset indent -compact 78*df930be7Sderaadtexample% rup otherhost 79*df930be7Sderaadtotherhost up 6 days, 16:45, load average: 0.20, 0.23, 0.18 80*df930be7Sderaadtexample% 81*df930be7Sderaadt.Ed 82*df930be7Sderaadt.Sh DIAGNOSTICS 83*df930be7Sderaadt.Bl -tag -width indent 84*df930be7Sderaadt.It rup: RPC: Program not registered 85*df930be7SderaadtThe 86*df930be7Sderaadt.Xr rpc.rstatd 8 87*df930be7Sderaadtdaemon has not been started on the remote host. 88*df930be7Sderaadt.It rup: RPC: Timed out 89*df930be7SderaadtA communication error occurred. Either the network is 90*df930be7Sderaadtexcessively congested, or the 91*df930be7Sderaadt.Xr rpc.rstatd 8 92*df930be7Sderaadtdaemon has terminated on the remote host. 93*df930be7Sderaadt.It rup: RPC: Port mapper failure - RPC: Timed out 94*df930be7SderaadtThe remote host is not running the portmapper (see 95*df930be7Sderaadt.Xr portmap 8 ), 96*df930be7Sderaadtand cannot accommodate any RPC-based services. The host may be down. 97*df930be7Sderaadt.El 98*df930be7Sderaadt.Sh SEE ALSO 99*df930be7Sderaadt.Xr ruptime 1 , 100*df930be7Sderaadt.Xr portmap 8 , 101*df930be7Sderaadt.Xr rpc.rstatd 8 102*df930be7Sderaadt.Sh HISTORY 103*df930be7SderaadtThe 104*df930be7Sderaadt.Nm rup 105*df930be7Sderaadtcommand 106*df930be7Sderaadtappeared in 107*df930be7Sderaadt.Tn SunOS . 108