README for "rup"
README for "rstatd for ultrix"

Copyright (C) Kazuro Furukawa, 1988-1993
Kazuro Furukawa, KEK, Japan,  Mar.6.1992., Nov.24.1995.  furukawa@kek.jp

[ Introduction ]

This directory contains sun's "rup" command and rstat server (rstatd)
for ultrix.  I wrote rup/rusers to test sun-rpc broadcast capability.

Although "rup" is almost compatible with one on sun, I modified the
display format slightly.  It can be built also on unix other than 
ultrix, if they have tsearch.  I tested Ultrix, Sun-OS, HP-UX.  If
your unix does not have tsearch, you may copy tsearch library from
the same archive.  For example, in order to build it on NeXT you
need tsearch library.  I also added "-r" reverse sort option.  
Please see manual page.

"rstatd" was a part of Sun-RPC 4.0.  And it was modified by someone 
on the internet (I think he is mjr@decuac.dec.com - mjr@tis.com). 
I modified rstat_proc.c slightly.  Then recently, Paul Whittaker 
<paw@si1.dod.gov.au> provided his patch for rstat_proc.c so that 
it can execute on the recent ultrix (4.2 - 4.4) and provide 
information for Sun's perfmeter.

"rstatd" should be started from /etc/rc.local.  It cannot be invoked
from inetd on Ultrix.  It's ultrix specific.

[ Compile/Link ]

For those who don't have rpcgen command, I included the files which 
rpcgen generates on my machine.  "make" command will generate "rup"
and "rstatd".  (You can build rpcgen command on Ultrix from source 
files archived on ftp.cs.widener.edu or decuac.dec.com if you like.)

If you have rpcgen, please do "make clean ; make".

Test:

Being a superuser, please type "rstatd &" and "rup".  The status
of hosts on your LAN will be displayed including your current host,
ultrix.  If your host is not ultrix, don't try rstatd.

As I don't provide an install script, please copy "rup", "rstatd"
"rup.1" to appropriate places and modify /etc/rc.local to start
"rstatd" at boot time.

Usage:

See the manual page rup.1 or try "rup -help".

Files:

README		this file
rup.1		manual page for "rup" command
Makefile	makefile for "rup" and "rstatd"
rup.c		C source for "rup"
rstat_proc.c	C source for "rstatd" from ftp.cs.widener.edu
rstat.x		RPC interface description for "rup" and "rstatd"
rstat.h		generated from rstat.x with rpcgen command
rstat_clnt.c	generated from rstat.x with rpcgen command
rstat_svc.c	generated from rstat.x with rpcgen command
rstat_xdr.c	generated from rstat.x with rpcgen command

These files are available on the anonymous ftp server at olive.kek.jp.

Thanks:

Everyone is permitted to copy and redistribute this software.
This software is provied "AS IS" without any warranties.
Please tell me, if you find any bugs.  Please tell me, if you like it.

-----
Kazuro Furukawa
National Laboratory for High Energy Physics (KEK), Japan
furukawa@kek.jp   furukawa@jpnkekvx.bitnet   kekvax::furukawa (hepnet)
