Patch Name:  PHCO_10115

Patch Description: s700_800 10.01 top(1) cumulative patch

Creation Date: 97/02/13

Post Date:  97/02/19

Warning: 98/01/12 - This Non-Critical Warning has been issued by HP.
	- PHCO_10115 can cause top(1) to display wrong user
	  names in the USERNAME field.  The uid's displayed
	  with 'top -u' are correct, only the user names are
	  incorrect.
	- It is recommended that PHCO_10115 be removed from
	  any system that relies on the user name information
	  in the output of the top(1) command.  If the NIS
	  initialization enhancement provided in PHCO_10115
	  is required, then the 'top -u' command should be
	  used to avoid the incorrect reporting of user names.
	- PHCO_10115 has been included in the following
	  Extension Software General Release Patch Bundles:
	        May 1997: XSW700GR1001 B.10.01.33
	                  XSW800GR1001 B.10.01.33
	        Jul 1997: XSW700GR1001 B.10.01.34
	                  XSW800GR1001 B.10.01.34
	        Oct 1997: XSW700GR1001 B.10.01.35
	                  XSW800GR1001 B.10.01.35
	        Dec 1997: XSW700GR1001 B.10.01.35
	                  XSW800GR1001 B.10.01.35
	- Patch PHCO_7201 will be re-released until a
	  replacement patch is available.

Hardware Platforms - OS Releases:
        s700: 10.01
        s800: 10.01

Products: N/A

Filesets:
        OS-Core.CMDS-AUX

Automatic Reboot?: No

Status: General Superseded With Warnings

Critical: No

Path Name:  /hp-ux_patches/s700_800/10.X/PHCO_10115

Symptoms:
        PHCO_10115:
        top has a long initialization time on systems
        with NIS.

        PHCO_7201:
        top displays negative cpu usage if more than
        300 processes on system.

Defect Description:
        PHCO_10115:
        The problem occurred due to a linear search of
        the passwd file using getpwent(3C). A section
        of top was recoded to use getpwuid(3C) which
        has better performance under NIS.

        PHCO_7201:
        top displays invalid information if system
        has more than 300 tasks.  On a heavily loaded
        system, top will display negative values for
        cpu usage.

SR:
        5003349258 5003258186

Patch Files:
        /usr/bin/top

what(1) Output:
        /usr/bin/top:
                top.c  $Revision: 74.2.1.2 $ $Date: 97/02/13 11:19:4
                        1 $
                find_ttys.c  $Revision: 72.1 $ $Date: 94/05/09 16:31
                        :57 $

cksum(1) Output:
        432272927 86016 /usr/bin/top

Patch Conflicts: None

Patch Dependencies:  None

Hardware Dependencies:  None

Other Dependencies:  None

Supersedes:
        PHCO_7201

Equivalent Patches: None

Patch Package Size:  140 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 PHCO_10115

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

                swinstall -x autoreboot=true -x match_target=true \
                        -s /tmp/PHCO_10115.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/PHCO_10115.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/PHCO_10115.  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 PHCO_10115.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/PHCO_10115.depot of=/dev/rmt/0m bs=2k

Special Installation Instructions:  None