Patch Name:  PHKL_5935

Patch Description: s700 10.01 io_map doesn't allow I/O space to be shared

Creation Date: 95/08/29

Post Date:  95/10/11

Hardware Platforms - OS Releases:
        s700: 10.01

Products: N/A

Filesets:
        OS-Core.CORE-KRN

Automatic Reboot?: Yes

Status: General Release

Critical:
        Yes
        PHKL_5935: OTHER PANIC
                With the introduction of 10.0, the map_mem_to_host()
                driver service may return a NULL pointer under
                certain instances.  For example, if a user process
                has already mapped in the I/O space, then any
                driver attempting to map it in with
                map_mem_to_host() (or directly with io_map())
                will receive a NULL pointer.

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

Symptoms:
        PHKL_5935:
        Starting with release 10.0, the map_mem_to_host() driver
        service no longer maps I/O space to *both* the kernel and
        user processes.  It now only maps the space privately to
        the kernel, thus preventing user processes from also
        mapping in the same space and accessing it.  Note that this
        behaviour also applies to the underlying io_map() driver
        service.

Defect Description:
        PHKL_5935:
        Any driver issuing the map_mem_to_host() request (starting
        with 10.0) will no longer be able to map the I/O space to
        a user process.  The map_mem_to_host() request now maps the
        space with kernel read/write access rights (prior to this
        in 9.X based systems the space was mapped with user
        read/write access rights), thus preventing user processes
        from mapping/accessing the same space.  In addition, the
        underlying io_map() service will now (starting with 10.0)
        assign a non-zero protection ID to any space mapped with
        PROT_URW (user read/write) access rights.  This will allow
        user processes to map/access the space but prevent drivers
        from mapping/accessing the I/O space.  In short, either
        a driver OR a process can map in an I/O space range-- BUT
        NOT BOTH SIMULTANEOUSLY.

SR:
        5003275644

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

what(1) Output:
        /usr/conf/lib/libhp-ux.a(io_map.o):
                io_map.c      $Date: 95/08/29 10:59:34 $ $Revision:
                        1.1.72.9 $ PATCH_10.01 (PHKL_5935)
        /usr/conf/lib/libhp-ux.a(iomap.o):
                iomap.c       $Date: 95/08/29 10:51:30 $ $Revision:
                        1.2.72.10 $ PATCH_10.01 (PHKL_5935)

cksum(1) Output:
        1260303492 4252 /usr/conf/lib/libhp-ux.a(io_map.o)
        1732206688 4560 /usr/conf/lib/libhp-ux.a(iomap.o)

Patch Conflicts: None

Patch Dependencies:  None

Hardware Dependencies:  None

Other Dependencies:  None

Supersedes:  None

Equivalent Patches: None

Patch Package Size:  60 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_5935

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

                swinstall -x autoreboot=true -x match_target=true \
                        -s /tmp/PHKL_5935.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_5935.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.  The cluster clients
                  must be shut down as described in step 5b.

        By default swinstall will archive the original software in
        /var/adm/sw/patch/PHKL_5935.  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_5935.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_5935.depot of=/dev/rmt/0m bs=2k

Special Installation Instructions:  None