Patch-ID# 100349-04
Keywords: microcode, hawk, gt, qum, quick, update, batching, polylines, crashes
Synopsis: 4.1.1gfx rev2: GT crashes in QUM. GT hangs during SunPHIGS
Date: 18-Oct-91  
 
SunOS release: 4.1.1gfx rev. 2
 
Unbundled Product: GT (HAWK) Graphics Accelerator.
 
Unbundled Release: 
 
Topic: GT microcode
 
BugId's fixed with this patch: 1066677,1066773,1068119,1068153,1066772,1064295,
			       1065071,1063738,1063743, 1070466, 1071121
	[NOTE: 1068119 is closed as a duplicate of 1068153]

Architectures for which this patch is available: sun4c

Patches which may conflict with this patch:

Obsoleted by: Sun OS 4.1.2

Problem Description: The GT microcode released with SunOS
        4.1.1-GFX-Rev2 has a couple of related bugs which cause
        problems when running SunPHIGS applications that use Quick
        Update Methods (QUM).  The most serious problem arises with
        programs that draw batched polylines in QUM.  In certain cases,
        the GT will crash forcing a reboot.  Another bug that can occur
        with programs which use QUMs is a failure to render all updated
        portions of the display list.  A third problem that can arise
        with programs which use QUM occurs when editing or deleting a
        structures in a display list which contains leaf structures
        (i.e. structures which call no other structures) that set no
        attributes.  Such programs will sometimes hang and sometimes
        exit abnormally.
 
        There are also a few bugs which cause visual anomalies that
        are present in the GFX-rev2 GT microcode.  There are as follows:
 
        o  Constant-colored, wide, patterned lines are sometimes shaded
           when they shouldn't be.  This bug will show up in either
           SunPHIGS or XGL.
 
        o  A problem occurs, in XGL only, when drawing polygonal arcs
           using hollow interior style.  Depending on the version of
           XGL, the bug may or may not show up.
 
        o  Silhouette edges will sometimes turn on too many pixels.
 
        o  There are a couple of minor lighting anomalies that are possible
           when using positional lights and either ambient or diffuse
           lighting degree.

        Below are still 2 more bugs that are fixed by Rev 9.47

        o  Another bug that occurs in SunPHIGS only is that GT crashes when picking
           PHIGS solids with front face culling enabled.

        o The very last bug is only a performance problem which affects both SunPHIGS
          and XGL.

        NOTE: to see whether this patch is needed, users should run:

                what /usr/lib/gt.ucode | grep RELEASE

        one of the following three messages will be printed:

        GT Front End Microcode: RELEASE Built 07/01/91_21:59:55, Revision 9.43
        GT Front End Microcode: RELEASE Built 08/09/91_14:24:40, Revision 9.431
        GT Front End Microcode: RELEASE Built 08/27/91_19:29:07, Revision 9.45
        GT Front End Microcode: RELEASE Built 10/05/91_14:00:15, Revision 9.47

        Revision 9.43 corresponds to GFX-Rev2 FCS microcode.  Revision
        9.431 corresponds to microcode obtained by the first revision
        (100349-02) of this patch.  Revision 9.45 corresponds to
        microcode obtained by the revision (100349-03) of this
        patch.  If users have either 9.43 or 9.431 microcode, then
        they should obtain and install this patch.  Revision 9.43
        exhibits all of the above mentioned bugs, while revision 9.431
        exhibits all except bug 1066677 (GT crashes with SunPHIGS Quick
        Update of batched polylines).  Revision 9.45 fixes all of the
        bugs listed above.
        Revision 9.47 contains both of the versions above (9.431 and 9.45)
        plus fixing other bugs.

        After installation, the user should verify that the microcode
        was installed properly, by checking the revision number, as
        described above, to ensure that 9.45 microcode is installed.

INSTALL: 
To install, replace the exiting /usr/lib/gt.ucode file with this one:
  
  mv /usr/lib/gt.ucode  /usr/lib/gt.ucode.FCS
  mv gt.ucode  /usr/lib/gt.ucode

Reboot the system to cause the new GT microcode to be downloaded.

 IMPORTANT NOTE: Patches that depend on this patch:
 
                       IF YOU ARE CURRENTLY RUNNING SunPHIGS 1.4.1
                       YOU SHOULD REQUEST AND INSTALL PATCHID 
		       100395 ALONG WITH THIS PATCH.