4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh# CDDL HEADER START
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh# The contents of this file are subject to the terms of the
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh# Common Development and Distribution License (the "License").
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh# You may not use this file except in compliance with the License.
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh# You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh# See the License for the specific language governing permissions
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh# and limitations under the License.
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh# When distributing Covered Code, include this CDDL HEADER in each
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh# file and include the License file at usr/src/OPENSOLARIS.LICENSE.
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh# If applicable, add the following below this CDDL HEADER, with the
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh# fields enclosed by brackets "[]" replaced with your own identifying
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh# information: Portions Copyright [yyyy] [name of copyright owner]
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh# CDDL HEADER END
9719310a57482091af0a7f0ee31b5e2eec35f154David Hollister# Copyright 2010 Sun Microsystems, Inc. All rights reserved.
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh# Use is subject to license terms.
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh# As a pHCI driver, pmcs must specify the vHCI class it belongs to (scsi_vhci).
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh# By default, MPxIO will be enabled on all pmcs controllers. To disable MPxIO
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh# for all pmcs controllers, set:
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh#mpxio-disable="yes";
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh# You can disable MPxIO on a per-HBA basis. Per port settings override the
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh# global setting for the specified ports. To disable MPxIO for the controller
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh# whose unit-address is 0 and whose parent is /pci@0/pci10de,5d@e, set:
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh#name="pmcs" parent="/pci@0/pci10de,5d@e" unit-address="0" mpxio-disable="yes";
9719310a57482091af0a7f0ee31b5e2eec35f154David Hollister# If pmcs-fwlogfile is not defined, firmware event logs will only be resident
9719310a57482091af0a7f0ee31b5e2eec35f154David Hollister# in memory. If defined, the driver can write up to 10 event logs per HBA to
9719310a57482091af0a7f0ee31b5e2eec35f154David Hollister# the specified location. An absolute path must be specified, and all
9719310a57482091af0a7f0ee31b5e2eec35f154David Hollister# directories in the path must already exist. The basename will be the prefix
9719310a57482091af0a7f0ee31b5e2eec35f154David Hollister# of the output files.
9719310a57482091af0a7f0ee31b5e2eec35f154David Hollister# For example, if pmcs-fwlogfile is defined as "/var/tmp/fwlog", the driver
9719310a57482091af0a7f0ee31b5e2eec35f154David Hollister# will write the following files as needed:
9719310a57482091af0a7f0ee31b5e2eec35f154David Hollister# where "X" corresponds to the instance number of the HBA.
9719310a57482091af0a7f0ee31b5e2eec35f154David Hollister# Each file will be 1MB in size and will only be written when the in-memory
9719310a57482091af0a7f0ee31b5e2eec35f154David Hollister# copy of the event log reaches a threshold. If all five files have already
9719310a57482091af0a7f0ee31b5e2eec35f154David Hollister# been written, the driver will simply cycle from 4 back to 0 and start over.
9719310a57482091af0a7f0ee31b5e2eec35f154David Hollister# Thus, the .# suffix doesn't necessarily indicate the ordering. Check the
9719310a57482091af0a7f0ee31b5e2eec35f154David Hollister# files' timestamps to determine which is the oldest or newest.
9719310a57482091af0a7f0ee31b5e2eec35f154David Hollister#pmcs-fwlogfile="/var/tmp/fwlog";
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh# Global debug settings may be set using the 'pmcs-debug-mask' property.
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh# Any combination of values may be set according to the following:
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh# 0x0001 - Basic info; shouldn't print anything during normal operation
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh# 0x0002 - Small amount of I/O information during normal operation
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh# 0x0004 - Much more info during I/O; will impact performance
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh# 0x0008 - Very verbose at all times; definitely a performance impact
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh# 0x0010 - Debug information with regard to discovery/configuration
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh# 0x0020 - Debug information with regard to iport
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh# 0x0040 - Debug information with regard to map
4b4564630e2553df86b078f1fce1624dade2b2cbDavid Hollister# 0x0080 - Report on SCSI underruns and residuals
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh# 0x0100 - Report SCSI status for every command
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh# 0x0200 - PHY lock/unlock debug (very noisy)
4c06356b0f0fffb4fc1b6eccc8e5d8e2254a84d6dh# 0x0400 - Debug information with regard to device state