wrsmstat(1M)
NAME
wrsmstat - report WCI RSM driver statistics
SYNOPSIS
/usr/platform/sun4u/sbin/wrsmstat controller [ -c
controller_id]
wrsmstat wrsm [ -i wrsm_instance_num] [-v]
wrsmstat route [ -c controller_id] [ -h node_hostname]
wrsmstat set [ -i wrsm_instance_num] -c cmmu -s start -e end
DESCRIPTION
The wrsmstat command provides statistics on remote shared
memory (RSM) controllers, routes to nodes, and WCI inter-
faces managed by the WCI RSM driver (wrsm). It also provides
an interface for setting extended performance counter con-
trol registers that constrain the wrsm counters available
through busstat(1M).
OPTIONS
The following options are supported:
controller [ -c controller_id ]
Displays information describing the state of the
specified controller, or of all controllers if none is
specified. The following is sample output:
$ wrsmstat controller -c 5 Controller 5 ---
--------- Controller state: up Local RSM Hardware
address: 0x4 Exported segments: 0 # published: 0 #
connections: 0 total bound memory: 0 Imported seg-
ments: 0 Send Queues: 0 Registered Handlers: 0
Assigned WCIs: 4 Available WCIs: 2
wrsm [ -i wrsm_instance_num ] [ -v ]
Displays information describing the state of the
specified RSM WCI, or of all RSM WCIs if none is
specified. The following is sample output:
$ wrsmstat wrsm -i 2
WCI instance 2
--------------
Portid: 5
Controller ID: 0
Config Version: 5
Link Error Shutdown Trigger: 40000
Link #0 is not present.
Link #1
Link Enabled: yes
Link State: up
Remote RSM HW addr: 1
Remote wnode ID: 1
Remote link num: 1
Remote WCI port ID: 3
Error takedowns: 0
Bad Config takedowns: 0
Failed bringups: 0
Total link errors: 0
Maximum link errors: 0
Average link errors: 0
Auto shutdown enabled: yes
Link #2 is not present.
If you specify the -v option, the following additional
information is displayed:
Cluster Error Count: 0
Uncorrectable SRAM ECC error: no
Maximum SRAM ECC errors: 0
Average SRAM ECC errors: 0
route [ -c controller_id ] [ -h nodename ]
Displays the route to the specified node through the
specified controller. If no node is specified,
displays the routes to all nodes. If no controller is
specified, displays the specified node's route through
all controllers. If neither is specified, displays the
routes to all nodes through all controllers. The fol-
lowing is sample output:
$ wrsmstat -c 3 -h fred
Controller 3 - Route to fred
----------------------------
Config Version: 1
FM node id: 0x345543
RSM hardware address: 0x9
Route Changes: 3
Route Type: Passthrough
Number of WCIs: 2
Stripes: 4
WCI #0
Port ID: 3
Instance: 0
Num of hops: 2
Num of links: 2
link# 1, first hop RSM HW addr: 0x4
link# 2, first hop RSM HW addr: 0x2
WCI #1
Port ID: 13
Instance: 1
Num of hops: 2
Num of links: 2
link# 0, first hop RSM HW addr: 0x4
link# 2, first hop RSM HW addr: 0x2
set [ -i wrsm_instance_num ] -c cmmu -s <start> -e <end>
For the specified WCI (or for each RSM WCI if none
specified), configure the specified range of CMMU
entries so that transactions through them are counted
by wrsm busstat kstats. Each call will cause transac-
tions to be counted through the new ranges of cmmu
entries in addition to the previously specified
ranges. To count transactions through all CMMUs,
specify a start value of 0 and end value of 0. To
clear all ranges (and not count transactions through
any cmmu entries), specify a start value of 0 and end
value of -1.
EXIT STATUS
This command returns 0 on successful completion, and a non-
zero value if an error occurred.
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| Availability | SUNWwrsm |
|_____________________________|_____________________________|
SEE ALSO
busstat(1M), kstat(1M), wrsmconf(1M), attributes(5)
Man(1) output converted with
man2html