Patch Name: PHCO_24691

Patch Description: s700_800 10.20 /usr/lbin/getNAME patch

Creation Date: 01/10/11

Post Date:  01/10/24

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

Products: N/A

Filesets:
	TextFormatters.TEXT-FMT

Automatic Reboot?: No

Status: General Release

Critical: No

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

Symptoms:
	PHCO_24691:
	1. man -k is not reportng one-line description for some
	   of the key words given at the command line because of
	   a problem in /usr/lbin/getNAME.

Defect Description:
	PHCO_24691:
	1. man -k reads the one-line description for the
	   key words given at the command line, from the
	   /usr/share/lib/whatis database. This data base is
	   created by catman(1) by reading the man pages with
	   the help of getNAME. But getNAME is not recognizing
	   the one-line description of the patterns, if
	   NAME is present in the quotes after .SH in the
	   corresponding man page source.
	   Eg. In the mk_kernel(1M) man page source, NAME is
	   present in the quotes after .SH.
	   "man -k mk_kernel" gives the error message
	   "mk_kernel: nothing appropriate" though
	   "man mk_kernel" shows the man page.

	Resolution:
	   getNAME code is changed to search for NAME
	   within quotes after the .SH in the manpage source
	   and put the one line description of the pattern into
	   the /usr/share/lib/whatis database.

SR:
	5003459073

Patch Files:
	/usr/lbin/getNAME

what(1) Output:
	/usr/lbin/getNAME:
		$Revision: 66.1.3.4 $
		PATCH_10_20: getNAME.o 01/10/11

cksum(1) Output:
	1598789754 12288 /usr/lbin/getNAME

Patch Conflicts: None

Patch Dependencies: None

Hardware Dependencies: None

Other Dependencies: None

Supersedes: None

Equivalent Patches:
	PHCO_24692:
	s700: 11.00
	s800: 11.00

Patch Package Size: 70 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_24691

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

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

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

Special Installation Instructions:
	After installing the patch, the command "catman -w"
	should be run to get the updated /usr/share/lib/whatis
	data base [Please refer to the manpage of catman(1M)].
	This command may take upto one hour to complete.