$  Copyright(c) 1996 Sun Microsystems, Inc.
$  All rights reserved.

$ #ident  "@(#)ifptest.msg  1.8  99/02/04  SMI"


$ --------------------------------------------------
$ DEBUG:	0
$ --------------------------------------------------

$ --------------------------------------------------
$ VERBOSE:	1-1999
$ --------------------------------------------------

$ USAGE
1 "ifptest [-o option=value]\n\n \
\tdev=<device name> \t\t (no default)\n \
\tmbox=<Enable|Disable>\t(default=Enable)\n \
\tfwrevcheck=<Enable|Disable>\t(default=Enable)\n \
\tchecksum=<Enable|Disable>\t(default=Enable)\n \
\tmodrevcheck=<Enable|Disable>\t(default=Enable)\n\n" 
 
$ IFP_REVISIONS
2 "Product ID is \"%s\", Card revision = %d, RISC revision level = %d, FB revision = %d, FBM revision = %d, RISC ROM revision = %d."

$ IFP_FOUND
3 "IFP device found at %s:devctl."

$ MAILBOX_START
4 "Starting Mailbox Loopback Test"

$ MAILBOX_LOOP_NUM
5 "Running mailbox loopback set number %d"

$ V_OPTIONS_LIST
6 "ifptest:  called with options: %s"

$ ASSIGN_DEVICE
7 "Testing ifp%d device at %s."

$ MAILBOX_END
8 "Done running mailbox loopback test"

$ FW_CHKSM_LOAD
9 "Queueing Firmware Checksum Command"

$ FW_CHKSM_CHECK
10 "Checking Firmware Checksum command results"

$ FW_REV_LOAD
11 "Queueing Firmware Revision command"

$ FW_REV_CHECK
12 "Checking Firmware Revision against expected value"

$ HW_REV_LOAD
13 "Queueing command for hardware revision check"

$ HW_REV_CHECK
14 "Checking hardware revision results"

$ RUNNING_CMDS
15 "Running queued commands"


$ --------------------------------------------------
$ INFO:		2000 - 3999
$ --------------------------------------------------


$ --------------------------------------------------
$ WARNING:	4000 - 5999
$ --------------------------------------------------

$ MBOX_FW_REV_MISCOMPARE
4000 "Wrong IFP firmware detected.  Obs:  %d.%d, Exp: %d,%d."


$ --------------------------------------------------
$ ERROR/FATAL:	6000 - 7999
$ --------------------------------------------------

$ MBOX_COMPARE_FAIL
6000 "Mailbox loopback failed:\nmbox#\tExp.\tObs.\n%d\t%4X\t%4X\n%d\t%4X\t%4X\n%d\t%4X\t%4X\n%d\t%4X\t%4X\n%d\t%4X\t%4X\n%d\t%4X\t%4X\n%d\t%4X\t%4X" \
Probable_Cause(s): <FC_AL board bad> <system software> \
Recommended_Actions: <Replace FC_AL board> \
<if the problem persists, contact authorized Sun service provider>

$ BAD_ARGS
6001 "Error parsing command line options.  Check command line and re-enter."

$ SYSTEM_CHANGED
6002 "Can not associate physical device with %s." \
Probable_Cause(s): <Hardware changed since VTS probe> \
<Wrong cmnd line arguments> <system software> \
Recommended_Actions: <Stop all testing and re-probe> \
<Check and re-enter command line> \
<if the problem persists, contact authorized Sun service provider>

$ ERR_STOP_RTNCODE
6003 "FW Stop command returned 0x%X, expected 0x4000." \
Probable_Cause(s): <IFP Firmware> <system software> \
Recommended_Actions: <Reload IFP firmware> \
<if the problem persists, contact authorized Sun service provider>

$ CMD_NOT_COMPLETE
6004 "Command #%d (cmd=%X) did not successfully complete, status: Obs 0x%X, Exp 0x%X" \
Probable_Cause(s): <Firmware error> <system software> \
Recommended_Actions: <reload IFP firmware and retry> \
<if the problem persists, contact authorized Sun service provider>

$ CHAINED_CMD_FAILED
6005 "Chained command number %d failed to complete." \
Probable_Cause(s): <Firmware error> <system software> \
Recommended_Actions: <reload IFP firmware and retry> \
<if the problem persists, contact authorized Sun service provider>

$ ERRORS_OBSERVED
6006 "%d errors were observed during this cycle."

$ COMMANDS_ABORTED
6007 "Command chain aborted: %d commands queued, %d commands run"

$ ABORT_DUMP1
6008 "Command Issued: mbox[0]=0x%X, mbox[1]=0x%X, mbox[2]=0x%X, mbox[3]=0x%X, mbox[4]=0x%X, mbox[5]=0x%X, mbox[6]=0x%X, mbox[7]=0x%X"

$ ABORT_DUMP2
6009 "Result Mboxes: mbox[0]=0x%X, mbox[1]=0x%X, mbox[2]=0x%X, mbox[3]=0x%X, mbox[4]=0x%X, mbox[5]=0x%X, mbox[6]=0x%X, mbox[7]=0x%X"

$ ABORT_DUMP3
6010 "HCCR=0x%X, BUS_SEMA=0x%X, ISR=0x%X, ICR=0x%X, CDMA_COUNT=0x%X, CDMA_ADDR=0x%x"

$ ABORT_DUMP4
6011 "CDMA_STATUS=0x%X, CDMA_CONTROL=0x%X, RDMA_COUNT=0x%X, RDMA_ADDR=0x%X, RDMA_STATUS=0x%X, RDMA_CONTROL=0x%X"

$ ABORT_DUMP5
6012 "TDMA_COUNT=0x%X, TDMA_ADDR=0x%X, TDMA_STATUS=0x%X, TDMA_CONTROL=0x%X, RISC_PSR=0x%X, RISC_IVR=0x%X"

$ ABORT_DUMP6
6013 "RISC_REGS:  RR0=0x%X, RR1=0x%X, RR2=0x%X, RR3=0x%X, RR4=0x%X, RR5=0x%X, RR6=0x%X, RR7=0x%X"

$ ABORT_DUMP7
6014 "RISC_REGS:  RR8=0x%X, RR9=0x%X, RR10=0x%X, RR11=0x%X, RR12=0x%X, RR13=0x%X, RR14=0x%X, RR15=0x%X"

$ ABORT_DUMP8
6015 "RISC_PCR=0x%X, RISC_RAR0=0x%X, RISC_RAR1=0x%X, RISC_LCR=0x%X, RISC_PC=0x%X, RISC_SP=0x%X"

$ ABORT_DUMP9
6016 "REQUEST_IN=0x%X, REQUEST_OUT=0x%X, RESPONSE_IN=0x%X, RESPONSE_OUT=0x%X"

$ ABORT_DUMP10
6017 "CURRENT_REQ_PTR=0x%X, BASE_REQ_PTR=0x%X, CURRENT_RESP_PTR=0x%X, BASE_RESP_PTR=0x%X"

$ NOT_TESTABLE
6018 "Interface at %s is currently not testable, there may be devices attached"

$ ER_BAD_OPTIONS
6019 "Bad option passed to test: %s"

$ DEV_OUT_OF_RANGE
6020 "No device detected for ifp%d."

$ NO_ASSOCIATION
6021 "Cannot associate an IFP device with %s."

$ NO_DEVICES_FOUND
6022 "No IFP devices detected on this system."


$ --------------------------------------------------
$ FATAL:	8000 - 9998
$ --------------------------------------------------
 
$ INVALID_FD
8000 "Invalid file descripter %d passed in." \
Probable_Cause(s): <system software> \
Recommended_Actions: \
<if the problem persists, contact authorized Sun service provider>

$ MBOX_IOCTL_FAIL
8001 "IOCTL call failed: %s." \
Probable_Cause(s): <wrong/missing IFP driver> <system software> \
Recommended_Actions: <Reload correct revision driver> \
<if the problem persists, contact authorized Sun service provider>

$ FW_CHECKSUM_FAIL
8002 "Firmware checksum failed, Rec: %x, Exp: 0x0" \
Probable_Cause(s): <unsupported/bad firmware loaded> <ifp controller bad> \
Recommended_Actions: <reload correct ifp driver> \
<if the problem persists, contact authorized Sun service provider>

$ GET_REVISION_FAIL
8003 "Get Revision mailbox command failed, return code Obs: 0x%X  Exp: 0x%X" \
Probable_Cause(s): <wrong ifp firmware loaded> <system software> \
Recommended_Actions: <reload correct ifp driver> \
<if the problem persists, contact authorized Sun service provider>

$ BAD_DEVICE_NAME
8004 "Bad device name passed to test: %s" \
Probable_Cause(s): <Wrong entry on command line> \
Recommended_Actions: <Check and retype command line>

$ MBOX_REV_MISMATCH
8005 "Driver interface revision mismatch; Prog = %d, Passed = %d, Driver = %d" \
Probable_Cause(s): <Wrong driver or Test loaded> \
Recommended_Actions: <Reload correct driver or test and retry>

$ IFP_OPEN_FAILED
8006 "Open of IFP device %s failed; %s" \
Probable_Cause(s): <system software> \
Recommended_Actions: <Contact your system admin for assistance> \
<if the problem persists, contact authorized Sun service provider>

$ DI_INIT_FAILED
8007 "DI_INIT call Failed; %s." \
Probable_Cause(s): <system software> \
Recommended_Actions: <Check for correct version of Solaris> \
<Contact your system admin for assistance> \
<if the problem persists, contact authorized Sun service provider>

$ GET_REV_IOCTL_FAIL
8008 "Get firmware revision IOCTL failed: %s." \
Probable_Cause(s): <system software> \
Recommended_Actions: <Contact your system admin for assistance> \
<if the problem persists, contact authorized Sun service provider>

$ DEVICES_ATTACHED
8009 "Device %s untestable, devices attached to loop" \
Probable_Cause(s): <Devices attached to controller> <System Software> \
Recommended_Actions: <Remove interface connections and try again> \
<if the problem persists, contact authorized Sun service provider>

$ CTRLR_OPEN_FAILED
8010 "Open of ctrlr %s as RDWR failed, Reason: %s" \
Probable_Cause(s): <Device name incorrect (cmd line only)> \
<System Software> \
Recommended_Actions: <Check/Re-enter cmnd line command> \
<if the problem persists, contact authorized Sun service provider>

$ UNKNOWN_ERROR
8011 "Device %s untestable, reason: %s" \
Probable_Cause(s): <Device name incorrect (cmd line only)> \
<Wrong/incorrect driver installed> <System Software> \
Recommended_Actions: <Check/Re-enter cmnd line command> \
<Verify correct driver installed and retry> \
<if the problem persists, contact authorized Sun service provider>

$ Probe

10001	"ifpprobe: WARNING: Open Failed; %s.\n"
10002	"ERROR: Failed to open device."
10003	"ERROR: Controller not testable due to devices present on loop or incorrect driver installed"
10004   "ERROR: Devices detected on loop.  Remove devices and reselect"
10005   "ERROR: Unknown error encountered.  Check for installation of correct driver"
