hpsloop(1M) RISC/os Reference Manual hpsloop(1M)
NAME
hps_dloop, hps_rloop - HPS in-service diagnostic loopback
programs
SYNOPSIS
hpsdloop [cdlnrstq] [device] [limit] [bcount] [bsize]
[time]
hpsrloop a[cdlnrstq] addr [device] [limit] [bcount] [bsize]
[time]
DESCRIPTION
Hpsdloop and hpsrloop are programs to interface to the
downloaded HPS Diagnostic Application to perform DMA loop-
back and remote cluster controller loopback tests, respec-
tively. The basic function of the tests are identical: they
wend a block to the board, then read it back in, verifying
that its contents are unchanged. The DMA loopback test sim-
ply moves the block (via DMA operations) to the board and
back. The remote loopback moves the block to the board,
then transmits it to the specified cluster controller and
back again to the host.
OPTIONS
One or more of the following options must be selected:
a Set cluster controller address. With the hpsrloop
program, this option selects which cluster controller
address to run the diagnostic loopback through. The
cluster controller address is specified in the addr
parameter on the command line. This option must be
used with the hpsrloop program, but it may not be used
with the hpsdloop program. The default address is 0.
c Disable checking results. This option tells the pro-
gram not to check the results of the DMA or remote
loopback to verify if the block read back in matches
the block sent out. The default is to check blocks.
d Set HPS raw device file name. This option allows the
user to override the default HPS device name of
/dev/rhp0. If this option is selected, the overriding
device name must be specified in the device parameter
on the command line.
l Set throughput limit. This option allows a throttling
of the test to prevent too much of the board interface
bandwidth to be consumed. If this option is selected,
the maximum throughput rate (in characters per second)
must be specified in the limit parameter on the command
line. The default throughput limit is 40000.
Printed 11/19/92 Page 1
hpsloop(1M) RISC/os Reference Manual hpsloop(1M)
n Set block count. This option tells the program how
many loopback blocks to send before terminating. The
default is to send an unlimited number of blocks. If
this option is selected, the number of blocks to send
must be specified in the bcount parameter on the com-
mand line. Setting this option disables the t
option, if entered before the t option.
r Use random sized blocks. This option specifies that
the program randomly varies the size of the blocks used
for the test. The block sizes will range from 1 to 512
for hpsdloop, and 1 to 490 for hpsrloop. The default
is to not use random sized blocks. Setting this option
disables the s option, if entered before the s
option.
s Set fixed block size. This option specifies that fixed
size blocks be used for the test. Note that this
option overrides the random option. If this option is
selected, fixed block size must be specified in the
bsize parameter on the command line. The maximum block
size is 512 for hpsdloop, and 490 for hpsrloop. Set
ting this option disables the r option, if entered
before the r option.
t Set running time. This option tells the program how
long to run before terminating. The default is to run
for 30 seconds. If this option is selected, the number
of seconds to run must be specified in the time parame-
ter on the command line. Setting this option disables
the n option, if entered before the n option.
q Quiet operation. Normally the program reports the test
results to standard output. If this option is speci-
fied, the program will run silently unless any errors
occur.
EXAMPLES
Run the DMA loopback to the default device (/dev/rhp0) for 3
minutes, using random block sizes, and display the results
on standard output:
hpsdloop rt 180
Run the remote loopback through the second host adapter to
the cluster controller at address 3 for 100 fixed size (256
byte) blocks, and display the results on standard output:
hpsrloop adns 3 /dev/rhp1 100 256
It should be noted that for the program to function properly
the following format must be adhered to: program name
Page 2 Printed 11/19/92
hpsloop(1M) RISC/os Reference Manual hpsloop(1M)
[keys(see options above)] [arguments to keys]
The arguments must be in the same order as their respective
key positions and after all the keys have been specified in
argv[1].
FILES
Both hpsrloop and hpsdloop are linked to the executable
file hpsloop. The program distinquishes the function
requested by the name of the invoked file.
SEE ALSO
The include file hps.diag.h.
WARNING
You are only allowed to kill the process with a kill
[process_id] command or with an interrupt if the job is run-
ning in the foreground. Do not use a kill -9 command to
kill this program because that will cause the program to
die, but will not close the channel properly.
Compile under UNIX System V with either:
cc -O -I../include -o hpsloop hpsloop.c rhpslib.o
ln hpsloop hpsrloop
ln hpsloop hpsdloop
If compilation is done on a system that requires IOCB struc-
ture alignment on 32-bit boundaries:
cc -O -I../include -DHPSALIGN -o hpsloop hpsloop.c rhpslib.o
ln hpsloop hpsrloop
ln hpsloop hpsdloop
Use the BSD switch for Berkeley 4.2 UNIX systems.
Printed 11/19/92 Page 3