Patch-ID# 111095-26

NOTE:
***********************************************************************
READ THE TERMS OF THE AGREEMENT ("AGREEMENT") IN THE LEGAL_LICENSE.TXT
FILE CAREFULLY BEFORE USING THIS SOFTWARE. BY USING THE SOFTWARE, YOU
AGREE TO THE TERMS OF THIS AGREEMENT. IF YOU DO NOT AGREE TO ALL OF THE
TERMS, PROMPTLY DESTROY THE UNUSED SOFTWARE.
***********************************************************************

Keywords: fctl fp fcp
Synopsis: SAN 4.4.x: fctl/fp/fcp/usoc driver patch
Date: Mar/23/2006


Install Requirements: See Special Install Instructions                      
                      Reboot after installation, an alternative may be in Special Install Instructions                      
                      
Solaris Release: 8

SunOS Release: 5.8

Unbundled Product: SAN

Unbundled Release: 4.4.x

Xref: 

Topic: SAN 4.4.x: fctl/fp/fcp/usoc driver patch
        NOTE:   Refer to Special Install Instructions section for
                IMPORTANT specific information on this patch.

Relevant Architectures: sparc

BugId's fixed with this patch: 4358973 4374868 4397078 4401529 4405574 4407405 4414946 4414960 4415297 4415501 4416837 4416838 4416839 4417145 4418335 4418840 4421432 4422730 4431109 4432597 4433414 4438431 4438443 4438556 4449836 4458568 4459280 4459701 4459736 4460055 4460668 4462307 4465158 4467738 4471298 4471795 4472230 4476440 4479865 4485009 4487050 4502274 4504663 4510923 4519677 4520718 4529255 4545906 4548899 4621144 4626079 4628058 4644297 4647520 4648206 4651774 4653098 4658433 4661573 4662369 4662998 4663093 4663724 4665254 4675712 4676841 4677879 4678075 4678623 4684774 4697281 4716634 4722971 4723080 4727209 4728016 4737849 4738976 4739888 4740240 4742400 4743778 4746497 4752477 4754642 4761148 4762633 4762768 4768672 4768741 4773673 4774466 4774692 4776534 4777463 4779856 4787242 4792071 4793131 4793134 4797951 4804256 4807495 4810612 4811576 4812452 4814916 4815131 4818350 4818820 4820760 4821382 4822119 4823069 4825717 4826497 4826599 4841913 4842383 4849510 4849556 4853685 4858485 4859852 4870583 4870727 4872376 4875501 4890629 4916065 4920876 4921310 4925685 4928397 4932194 4939576 4955518 4970195 4978235 4981473 4985656 4989693 4994710 4996637 5027047 5029733 5035249 5047692 5062821 5083239 5090186 5099478 6196289 6227562 6260549 6283597 6288908 6290618 6341027 6361031

Changes incorporated in this version: 6341027 6361031

Patches accumulated and obsoleted by this patch: 109440-01 110189-01

Patches which conflict with this patch: 108982-10

Patches required with this patch: 108982-09 111412-15 (or greater)

Obsoleted by: 

Files included with this patch: 

/kernel/drv/fcp
/kernel/drv/fp
/kernel/drv/fp.conf
/kernel/drv/sparcv9/fcp
/kernel/drv/sparcv9/fp
/kernel/drv/sparcv9/usoc
/kernel/drv/usoc
/kernel/misc/fctl
/kernel/misc/sparcv9/fctl
/usr/include/sys/fibre-channel/fc_types.h
/usr/include/sys/fibre-channel/fca/usocio.h
/usr/include/sys/fibre-channel/fca/usocvar.h
/usr/include/sys/fibre-channel/fcio.h
/usr/include/sys/fibre-channel/impl/fc_error.h
/usr/include/sys/fibre-channel/impl/fc_fcaif.h
/usr/include/sys/fibre-channel/impl/fc_portif.h
/usr/include/sys/fibre-channel/impl/fc_ulpif.h
/usr/include/sys/fibre-channel/impl/fcgs2.h
/usr/include/sys/fibre-channel/impl/fcph.h
/usr/include/sys/fibre-channel/impl/fctl.h
/usr/include/sys/fibre-channel/impl/fctl_private.h
/usr/include/sys/fibre-channel/impl/fp.h
/usr/include/sys/fibre-channel/ulp/fcp.h
/usr/include/sys/fibre-channel/ulp/fcp_util.h
/usr/include/sys/fibre-channel/ulp/fcpvar.h
/usr/lib/adb/fc_packet
/usr/lib/adb/fc_port
/usr/lib/adb/fc_port_clist
/usr/lib/adb/fca_tran
/usr/lib/adb/fcp_cmd
/usr/lib/adb/fp_cmd
/usr/lib/adb/port_device
/usr/lib/adb/port_id
/usr/lib/adb/sparcv9/fc_packet
/usr/lib/adb/sparcv9/fc_port
/usr/lib/adb/sparcv9/fc_port_clist
/usr/lib/adb/sparcv9/fca_tran
/usr/lib/adb/sparcv9/fcp_cmd
/usr/lib/adb/sparcv9/fp_cmd
/usr/lib/adb/sparcv9/port_device
/usr/lib/adb/sparcv9/port_id
/usr/lib/adb/sparcv9/ssfcp_ipkt
/usr/lib/adb/sparcv9/ssfcp_lun
/usr/lib/adb/sparcv9/ssfcp_pkt
/usr/lib/adb/sparcv9/ssfcp_port
/usr/lib/adb/sparcv9/ssfcp_tgt
/usr/lib/adb/sparcv9/ulp_port_info
/usr/lib/adb/sparcv9/unsolicited_buffer
/usr/lib/adb/sparcv9/usoc_pkt_priv
/usr/lib/adb/ssfcp_ipkt
/usr/lib/adb/ssfcp_lun
/usr/lib/adb/ssfcp_pkt
/usr/lib/adb/ssfcp_port
/usr/lib/adb/ssfcp_tgt
/usr/lib/adb/ulp_port_info
/usr/lib/adb/unsolicited_buffer
/usr/lib/adb/usoc_pkt_priv

Problem Description:

6341027 SAN 4.4.6+ fcp driver returns TRAN_FATAL_ERROR without honouring
	timers ...
6361031 Leadville behaviour, when duplicate entries are there in RSCN payload
 
(from 111095-25)
 
5047692 HBA_SendRNID against boot drive locks up my system 
 
(from 111095-24)
 
6283597 Transport does not handle 4GBit & 10GBit speed codes
6288908 Transport should handle 8GBit speed code
 
(from 111095-23)
 
6227562 bad mutex panic on a switch reset with IOs
6290618 fcp should never call fc_ulp_uninit_packet without having called
	fc_ulp_init_packet
 
(from 111095-22)
 
6260549 Failure / removal of device hangs I/O
 
(from 111095-21)
 
4792071 fc transport doesn't properly keep track of references to pd structures
 
(from 111095-20)
 
6196289 /kernel/drv/sparcv9/fp: undefined symbol 'fctl_add_orphan_held' errors 
 
(from 111095-19)
 
5062821 ssfcp_send_els->fc_ulp_login bad mutex panic seen with SFS 4.4.1
5099478 "fp_adisc_intr: Perform LOGO" warning msgs with SAN 4.4.2
 
(from 111095-18)
 
5083239 b7: cfgadm lists 6130 vols as unavailable when created while Ap_Id unconfigured
 
(from 111095-17)
 
4981473 SAN 4.3 drivers no longer reliably report fabric disappear/reappear
	messages
5035249 Page83 GUID field filled with spaces/zeros must be handled for all
	arrays
5090186 Change preinstall scripts for SAN patches
 
(from 111095-16)
 
4890629 Add new IOCTLs to improve FC-HBA standards compliance
4921310 MPxIO should support variable GUID length
4985656 Bind SCSI target drivers by compatibility features
4989693 Solaris 8 fcp panics with target device binding change
4994710 panic in fcp error path - ssfcp_online_child
4996637 sfs6.5.1 - panic - fcp:ssfcp_create_dip
5027047 fcp is again giving null guids to disks that fail page 83
5029733 Page83 GUID field filled with spaces need to be handled appropriately
 
(from 111095-15)
 
4787242 MPxIO: validate identifier length in VPD page83 identifier
	descriptor data
4872376 BAD TRAP, type=31 panic in module "scsi" due to NULL ptr deref
4916065 sfkpit6.3.6: Topology doesn't get reset when fabric connection went away
4925685 debug fp messages display in none debug Leadville driver
4928397 host hung and IOs ceased after 3 hours of IOs and ISL cable pulls
4932194 fp_free_pkt panic while doing DR
4939576 Add page83 support for EMC Symmetrix device
4955518 WARNING: fcp: page83 validation failed-IEEE E/R length
4970195 Tape drive does power reset when LIP is inserted during backup
4978235 jni connected to system1, unknown device type, 0X1f, unable to see luns
 
(from 111095-14)
 
4471795 Provide logging/tracing support in transport and fcp modules to
	diagnose failure
4651774 Enhance FCIO_GET_HOST_PARAMS ioctl to retrieve HBA port state
4722971 fcp, qlc: add support for lun reset.
4768672 qlc+fcp: leadville should validate the corrupted residual length.
4777463 fctl reports Mismatch in NWWN even though there is no Mismatch
4793131 fcp should handle unsol PRLIs
4811576 panic in fctl_get_port_device_by_did
4812452 daktari internal photon ses device not enumerated under mpxio.
4814916 PLOGI failure with Link Service Reject and Logical Error
4815131 fcp: handle_port_attach() failures should be handled properly
4823069 DR hang in ssfcp_hp_daemon
4825717 panic during snia ioctl with LIPs
4841913 "luxadm remove" failed
4842383 host takes long time to boot if non-mpxio devices are attached.
4849510 Remove SFK internal build numbers from drivers modulde name
4849556 fctl_delist_did_table: assertion failed: MUTEX_HELD(&port->fp_mutex),
	fctl.c, 31
4853685 PIT6.3.1: Panic seen while running HBA_SendReadCapacity command test
4858485 fix the NWWN Mismatch issue in fctl.c
4859852 luxadm -e rdls command takes devices offline if RLS ELS is not supported
4870583 panic in fcp when target reset is issued to tape device
4870727 Kernel heap corruption kmem_error panic on V880 with SFK 6.3.3
4875501 fp: Merge properties of fp.conf entries
4920876 fcp is passing a device to mdi_pi_online with NULL GUID
 
(from 111095-13)
 
4529255 assertion failed in condvar.c during disconnecting pci card/buses.
4644297 Add support for RNID ELS
4647520 Mpxio: upon cable pull, i/o can be seamlessly xfered on other online
	paths.
4648206 fp: [ID 328307 kern.warning] WARNING: fp(4): Can't shutdown port
	Failing detach
4662369 fcp panic: ssfcp_watch race condition with ssfcp_handle_port_detach
4678623 fcp: add ioctl to get change count
4684774 Workload, and utilities hang while running failovers .....
4716634 when fcp is unloaded, ssfcp_watch() may continue to be invoked to
	spite the user
4723080 fcp hotplug events during MPxIO DR can cause system panic
4727209 Hitachi 9960/Brocade3800: DR attach Ivory SBUS system board results
	in I/O error
4738976 fcp: Leadville should not enumerate devices with nonzero peripheral
	qualifier
4739888 Handle maximum rsp buffer size as defined in FC-FS for the
	fc_rnid_acc_t struct
4740240 fp:fp_gan_handler panic, NULL ptr deref
4742400 TGT inquiry on a local hba port fails when the hba port is
	not connected.
4746497 luxadm probe and luxadm display <T3_WWN> fail when StorADE runs cron job
4752477 cfgadm does not manage medium changer devices properly
4754642 unable to configure FC controller number following DR
4761148 Remove flags from RNID set IOCTL
4762633 Panic in fp_job_handler
4762768 fp:fp_plogi_group panic, mutex_enter: bad mutex
4768741 leadville: enhance leadville driver stack to support fabric boot
4773673 sema_v panic while running SNIA lib
4774466 BAD TRAP: in module "unix" due to a NULL pointer dereference
4774692 Panic in mpxio due to NULL pointer dereferencing.
4776534 BAD TRAP: type 34, panic while doing DR, configure slot
4779856 Transport should handle bogus pd passed by ulp.
4793134 Leadville should be able to receive errored RLS responses
4797951 fcp: ssfcp_watch panic, Deadlock: cycle	in blocking chain
4804256 Tape tests fail upon isuing a LIP
4807495 Leadville should be able to receive errored RNID responses
4810612 path did not recover to standby after POC of switch
4818350 panic in fp_iodone
4818820 mpxio autofailback is not working
4820760 Failed to send PRLI to D_ID=10f00 error=Command transport Busy
4821382 Device goes offline on issuing a LIP
4822119 fcp: fcp's handling of large number of  luns can cause open failure
4826497 missing devices when booting with LV 6.2.5
4826599 "UNKNOWN, INIT" state in luxadm display command
 
(from 111095-12)
 
4460668 Leadville does not support untagged devices correctly
4467738 FCIO_GET_TOPOLOGY should not require Exclusive mode open
4628058 fcp: fcp should not hold packet with FLAG_NO_QUEUE set for long time.
4661573 Zero or negative response buffer size causes function call to hang
4662998 cfgadm configure reports "Invalid argument" but completes configuration.
4663724 fcp:ioctl FCP_TGT_SEND_SCSI 64-bit version always returns ENOMEM
	or hangs
4676841 fp:fp_plogi_intr panic
4697281 mutex_panic - leadville 6.0.3
4728016 Lost ABTS takes target offline
4737849 FCP driver hangs on calls thru snia_disco or Topology Reporter
4743778 cfgadm hangs after new qpatches added....
 
(from 111095-11)
 
4678075 fcp:ssfcp_send_scsi_ioctl panic
 
(from 111095-10)
 
4677879 fcp: Inquiry-83 doesn't work in 6.0.1 causing ses devices to disappear
 
(from 111095-09)
 
4653098 mutex panic in fp:fp_register_login
4663093 fp+qlc: add support for type 3 RSCN
4665254 fcp: PLOGI from fcp is failing with reason ELS is in progress
4675712 fcp: fcp should retry icmds which return with FC_PKT_LOCAL_RJT
 
(from 111095-08)
 
4548899 TM: Name Server Registration should be done properly for LVL.
	ULPs: fcp and fcip
4621144 FCP_TGT_SEND_SCSI ioctl returning incorrect lun info when multiple
	luns present
4626079 fc: fabric devices are instantiated upon discovery
4658433 deadlock in leadville stack causing system hang
 
(from 111095-07)
 
4415297 Incorrect use of CALLB_CPR_SAFE_END() macro.
4545906 Simultaneous lips and luxadm commands cause system to panic
 
(from 111095-06)
 
4407405 Not writing enough data
4472230 mpxio: Devices behind Crossroads 4250 are not enumerated
4502274 HDS: fcp timeout after LIPs sent to storage array
4504663 fabric device configure fails on boot time with Vicom config.
4510923 fcp needs to support scsi_abort entry point for aborting ALL
	cmds to target
4519677 fcp: handling purple side cable pulls with multiple paths
4520718 LUNS disappears after removing and adding new volumes
 
(from 111095-05)
 
4487050 scsi_inquiry hangs when a defective GBIC is installed in E port
	of local switch
 
(from 111095-04)
 
4465158 T3B:When T3 configured host port as FL/TL, many unexpected
	behaviours occur
4479865 fcp: resume handler code is incomplete for fabric devices
4476440 mpxio enabled and reboot causes long boot hang and then A3500FC
	contr. failure
4471298 "Invalid flag: device changed for a non existing target" after
	adding A5200
4485009 panic, using cfgadm, in module "scsi_vhci" due to a NULL pointer
	dereference
 
(from 111095-03)
 
4358973 fp needs to provde support for dynamic node creation through cfgadm
	framework.
4438556 FC: Avoid confusion through better versioning
4458568 Failed paths do not recover to STANDBY when the failure is corrected
4405574 Need leadville (fp) to pass correct device order from LILP phase
4422730 fp: Needs to guard against D_ID changes in Fabric topology
4462307 Sending a LIP to a fp port causes I/O failure
4460055 panic: mutex_enter: bad mutex
4438431 qlc: Large initiator support problems
4459736 panic[cpu19]/thread=2a100311d40: BAD TRAP: ...n module "fp" due
4459701 "Lun=1 for target=10c8e8 reappeared" error messages while executing
	cfgadm
4421432 Tapestry: long delay on list and configure operations
4459280 memory leak in ssfcp_find_existing_node()
4432597 panic in ssfcp_online_child() when booting
4431109 mpxio: open failure causes mount failure of points referenced in vfstab
 
4438443 fcp: failback failures using MPxIO
4401529 Timeout failures on STK 9840FC drives
4449836 system panics when issuing cfgadm -al.
 
(from 111095-02)
 
4374868 leadville loses sense code, failed tape commands, scsi test suite
	failure
4397078 fcp: FC-Tape: not to do PLOGI for FC-Tape on lip recovery
 
(from 111095-01)
 
4433414 lun 0 resize of A3500FC causes controllers to be marked dead
4416839 FCP: panic in assertion failed: pptr->ssfcp_tmp_cnt > 0; line: 9642
4414946 System Panics, during heavy I/O, without any error injection.
4418840 fp: LINIT handling needs to be fixed
4416837 fp: strengthen error handling for zero WWN and bad NS response cases
4417145 fp: GET ALL NEXT request/response buffers need to be updated
4416838 fp: Bad LIP 3rd and 4th bytes for LINIT; and send LINIT only to loops
4414960 fcp : devices disappears when a port is reset using switch
4415501 fcp: intenal cmd pkt not freed causes boottime hang/commands stuck
4418335 fctl: mutex_enter: bad mutex, lp=757397c0 owner=4038be40 thread=4036fe40

Patch Installation Instructions:
--------------------------------
 
For Solaris 2.0-2.6 releases, refer to the Install.info file and/or
the README within the patch for instructions on using the generic
'installpatch' and 'backoutpatch' scripts provided with each patch.
 
For Solaris 7-9 releases, refer to the man pages for instructions
on using 'patchadd' and 'patchrm' scripts provided with Solaris.
Any other special or non-generic installation instructions should be
described below as special instructions.  The following example
installs a patch to a standalone machine:
 
       example# patchadd /var/spool/patch/104945-02
 
The following example removes a patch from a standalone system:
 
       example# patchrm 104945-02
 
For additional examples please see the appropriate man pages.

Special Install Instructions:
----------------------------- 
NOTE 1:	Minimum requirement : Solaris 8 Update 4
 
NOTE 2:	Due to versioning introduced in the drivers, the latest revision
  	of the following patches *MUST* also be installed prior to rebooting
   	the system. Failure to install *ALL* the required patches will
   	cause the drivers to not load.
 
	111096-09 (or newer)	fcip driver and adb macros patch
	111097-15 (or newer)	qlc driver and adb macros patch
	111412-15 (or newer)	mpxio driver patch
 
NOTE 3: This patch requires the package SUNWsan (San Foundation Kit).
 
	The SUNWsan package is available via the Sun Download Center 
	at http://www.sun.com/storage/san/
 
 
NOTE 4: Reboot the system after installing all the patches.
 
!!!!!!!!!!!!!!!!!! WARNING !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
 
This patch, 111095, is not compatible with jfca driver patches
earlier than 114877-08.
 
It is strongly recommended that all systems with patch
114877-07 (or earlier) be upgraded to 114877-08 (or later).
 
!!!!!!!!!!!!!!!!!! WARNING !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

README -- Last modified date:  Thursday, March 23, 2006

