wrsm(7d) [sunos man page]
wrsm(7D) Devices wrsm(7D) NAME
wrsm - WCI Remote Shared Memory (WRSM) device driver SYNOPSIS
wci@<slot>,0:wrsm wrsm@<instance>:ctrl wrsm@ffff,0:admin DESCRIPTION
The wrsm driver is a nexus driver that manages Sun Fire Link devices and wrsm controllers. A WCI device on a Sun Fire Link board is attached directly to the host system bus and provides clustering communication between Solaris instances that are memory transaction-based. The WCI acts as a memory controller on the system backplane. The wrsm driver programs regis- ters on the WCI to accept network read/write requests on certain exported cluster addresses from incoming links. The registers translate the requests into local read/write bus transactions that use local physical memory ranges that you specify. The driver programs additional WCI registers to forward local system backplane read/write transactions within a particular physical address range to a remote WCI. A WCI device in the format wci@slot,0:wrsm appears in the device tree. A wrsm controller is a pseudo device that manages a set of WCIs. A device entry in the format wrsm@<instance>:ctrl appears in the device tree. A wrsm controller presents a Sun proprietary protocol to clients, enabling them to set up the network and to communicate through the WCIs. To configure a wrsm controller, you download a configuration into the driver using the wrsmconf(1M) command or through other external WCI network management software. Status information on each WCI and wrsm controller is available by using the wrsmstat(1M) command. The wrsm admin device is used internally by the driver to manage the I/O addresses associated with remote memory. A device entry in the format wrsm@ffff,0:admin appears in the device tree FILES
/platform/sun4u/kernel/drv/sparcv9/wrsm ELF kernel module SEE ALSO
wrsmconf(1M), wrsmstat(1M) Writing Device Drivers DIAGNOSTICS
The messages described below may appear on the system console as well as being logged. These messages generally include the string wrsm%d, where %d is the instance number of the wrsm device. The message context indicates whether the device is a WCI or a wrsm controller. Some messages include the string wci %a, where %a is the bus slot of the WCI device. wrsm%d: unable to map register set %d Driver was unable to map device registers; check for bad hardware. Driver did not attach device, device will be inaccessible. wrsm_detach:cf_remove_controller failed for wrsm%d Driver did not detach device; device is inaccessible. wrsm_detach:cf_remove_wci failed for wrsm%d Driver did not detach device. This WCI is the last WCI in wrsm controller. register_controller of wrsm%d failed with error %d The wrsm controller could not register with the Sun proprietary protocol framework. Communication is not possible through this con- troller. wrsm%d, wci %a, SRAM CE ERROR, at address: 0x%x, syndrome:0x%x There was a correctable error in the WCI's SRAM. This indicates that the memory on this WCI module should be replaced. wrsm%d, wci %a, SRAM UE ERROR, at address: 0x%x, syndrome:0x%x There was an uncorrectable error in the WCI's SRAM. This indicates that the memory on this WCI module should be replaced. In addition, attempts to access local memory from remote nodes may fail. SunOS 5.10 17 Nov 2002 wrsm(7D)
Check Out this Related Man Page
wrsmstat(1M) System Administration Commands 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 interfaces managed by the WCI RSM driver (wrsm). It also provides an interface for setting extended performance counter control registers that constrain the wrsm coun- ters 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 segments: 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 following 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 transactions 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 attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Availability |SUNWwrsm | +-----------------------------+-----------------------------+ SEE ALSO
busstat(1M), kstat(1M), wrsmconf(1M), attributes(5) SunOS 5.10 25 Jun 2003 wrsmstat(1M)