Patch Name:  PHKL_8506

Patch Description: s700 10.20 GSC SCSI tape driver cumulative patch

Creation Date: 96/10/10

Post Date:  96/10/23

Hardware Platforms - OS Releases:
        s700: 10.20

Products: N/A

Filesets:
        OS-Core.CORE-KRN

Automatic Reboot?: Yes

Status: General Superseded

Critical: No

Path Name:  /hp-ux_patches/s700/10.X/PHKL_8506

Symptoms:
        PHKL_8506:
        This patch changes the behavior of the open() call with
        a write protected tape.  The open() will now fail with EIO
        if the mode is not O_RDONLY.

        PHKL_8128:
        Device files other than those that use the BEST density
        do not work.  Opening such a device file returns EINVAL.
        This happens only on DLT tape drives.

        PHKL_8028:
        Without immediate reporting enabled a DLT tape drive will
        take several seconds for each filemark written.  If a user
        application is writing many filemarks to a tape the
        performance will be poor.  This patch enables immediate
        reporting of filemarks, which should improve performance
        for an application that writes many filemarks to a tape.

Defect Description:
        PHKL_8506:
        Before this patch the open() call did not look at media
        write protection.  A write() to a write protected tape
        would fail, but an open() with FWRITE mode would succeed.
        This change was made to make the GSC driver behave the same
        as the NIO driver.

        PHKL_8128:
        A 'break' statement was missing from the end of a switch,
        causing the code to fall through to an error return.
        Device files which specify 'BEST' density work, but a DLT
        device with a density other than BEST will not open.

        PHKL_8028:
        A flag in the driver indicates, for each device type,
        whether or not immediate reporting should be enabled for
        filemarks.  That flag was not being set for DLT drives.
        To reproduce, write a short C program that
        writes 20 blocks of 1K bytes, each separated by a filemark.
        Performance will be substantially better with this patch
        applied.

SR:
        4701329417 5003329078

Patch Files:
        /usr/conf/lib/libhp-ux.a(scsi_tape.o)

what(1) Output:
        /usr/conf/lib/libhp-ux.a(scsi_tape.o):
                scsi_tape.c $Date: 96/10/10 13:38:45 $ $Revision: 1.
                        8.98.13 $ PATCH_10.20 (PHKL_8506)

cksum(1) Output:
        1047443031 59228 /usr/conf/lib/libhp-ux.a(scsi_tape.o)

Patch Conflicts: None

Patch Dependencies:  None

Hardware Dependencies:  None

Other Dependencies:  None

Supersedes:
        PHKL_8028 PHKL_8128

Equivalent Patches:
        PHKL_8502:
        s700: 10.01

        PHKL_8503:
        s800: 10.01

        PHKL_8504:
        s700: 10.10

        PHKL_8505:
        s800: 10.10

        PHKL_8507:
        s800: 10.20

Patch Package Size:  120 Kbytes

Installation Instructions:
        Please review all instructions and the Hewlett-Packard
        SupportLine User Guide or your Hewlett-Packard support terms
        and conditions for precautions, scope of license,
        restrictions, and, limitation of liability and warranties,
        before installing this patch.
        ------------------------------------------------------------
        1. Back up your system before installing a patch.

        2. Login as root.

        3. Copy the patch to the /tmp directory.

        4. Move to the /tmp directory and unshar the patch:

                cd /tmp
                sh PHKL_8506

        5a. For a standalone system, run swinstall to install the
            patch:

                swinstall -x autoreboot=true -x match_target=true \
                        -s /tmp/PHKL_8506.depot

        5b. For a homogeneous NFS Diskless cluster run swcluster on the
            server to install the patch on the server and the clients:

                swcluster -i -b

            This will invoke swcluster in the interactive mode and
            force all clients to be shut down.

            WARNING: All cluster clients must be shut down prior to the
                     patch installation.  Installing the patch while the
                     clients are booted is unsupported and can lead to
                     serious problems.

            The swcluster command will invoke an swinstall session in which
            you must specify:

                alternate root path  -  default is /export/shared_root/OS_700
                source depot path    -  /tmp/PHKL_8506.depot

            To complete the installation, select the patch by choosing
            "Actions -> Match What Target Has" and then "Actions -> Install"
            from the Menubar.

        5c. For a heterogeneous NFS Diskless cluster:

                - run swinstall on the server as in step 5a to install
                  the patch on the cluster server.

                - run swcluster on the server as in step 5b to install
                  the patch on the cluster clients.

        By default swinstall will archive the original software in
        /var/adm/sw/patch/PHKL_8506.  If you do not wish to retain a
        copy of the original software, you can create an empty file
        named /var/adm/sw/patch/PATCH_NOSAVE.

        Warning: If this file exists when a patch is installed, the
                 patch cannot be deinstalled.  Please be careful
                 when using this feature.

        It is recommended that you move the PHKL_8506.text file to
        /var/adm/sw/patch for future reference.

        To put this patch on a magnetic tape and install from the
        tape drive, use the command:

                dd if=/tmp/PHKL_8506.depot of=/dev/rmt/0m bs=2k

Special Installation Instructions:  None