Patch Name: PHCO_29055

Patch Description: s700_800 11.00 ftio(1) cumulative patch

Creation Date: 03/06/02

Post Date: 03/06/26

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

Products: N/A

Filesets:
	OS-Core.SYS-ADMIN,fr=B.11.00,fa=HP-UX_B.11.00_32/64,v=HP

Automatic Reboot?: No

Status: General Release

Critical:
	Yes
	PHCO_29055: HANG

Category Tags:
	defect_repair general_release critical halts_system

Path Name: /hp-ux_patches/s700_800/11.X/PHCO_29055

Symptoms:
	PHCO_29055:
	( CR: JAGad80536 SR: 8606211348 )
	ftio(1) intermittently fails when restoring files in
	an archive. The following errors are reported:

	#ftio -icM -Z 64 -B 60k /dev/rmt/0m /tmp/YYY.depot
	ftio: /tmp/YYY.depot exists and is newer - not restored
	ftio: semaphore request failed : Interrupted system call

	( CR: JAGae03291 SR: 8606234071 )
	ftio(1) hangs at end of first tape in multiple DLT tape
	restore.

	( CR: JAGad54929 SR: 8606185727 )
	ftio(1) fails during file restoration when using a no
	rewind device file. The following errors are reported:

	# ftio -iadmuvx /dev/rmt/1mn
	ftio: error reading tape header : magic number is invalid
	ftio: please mount tape 1, then hit return

Defect Description:
	PHCO_29055:
	( CR: JAGad80536 SR: 8606211348 )
	ftio(1) uses semaphores to synchronize reading and
	writing between processes. In the failing case, the child
	releases the semaphore and completes normally before
	the parent has an opportunity to continue. As a result
	the parent receives the SIGCLD signal before the
	semop(2) can complete. The existing design identifies
	this as an error and exits.

	Resolution:
	ftio(1) now retries the semop(2) system call when
	interrupted.

	( CR: JAGae03291 SR: 8606234071 )
	ftio(1) will successfully backup data to multiple DLT
	tapes, correctly prompting to mount the next tape when
	each tape is full. However, when attempting to restore
	files from the backup, ftio(1) will hang having reached
	the end of the first tape but not before displaying the
	number of blocks currently restored. It does not prompt
	to mount the next tape, nor is it possible to continue
	with the restore operation.

	Resolution:
	ftio(1) now prompts to mount the next tape when the end
	of tape (EOT) is reached and the restore operation
	involves multiple DLT cartridges.

	( CR: JAGad54929 SR: 8606185727 )
	ftio(1) is not aware of no-rewind device files.

	Resolution:
	ftio(1) is corrected to be no-rewind device files
	aware.

Enhancement:
	No

SR:
	8606211348 8606234071 8606185727

Patch Files:
	
	OS-Core.SYS-ADMIN,fr=B.11.00,fa=HP-UX_B.11.00_32/64,v=HP:
	/usr/bin/ftio

what(1) Output:
	
	OS-Core.SYS-ADMIN,fr=B.11.00,fa=HP-UX_B.11.00_32/64,v=HP:
	/usr/bin/ftio:
		$Revision: 82.2.1.1 $

cksum(1) Output:
	
	OS-Core.SYS-ADMIN,fr=B.11.00,fa=HP-UX_B.11.00_32/64,v=HP:
	1372348355 65536 /usr/bin/ftio

Patch Conflicts: None

Patch Dependencies: None

Hardware Dependencies: None

Other Dependencies: None

Supersedes: None

Equivalent Patches: None

Patch Package Size: 50 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_29055

	5. Run swinstall to install the patch:

		swinstall -x autoreboot=true -x patch_match_target=true \
			  -s /tmp/PHCO_29055.depot

	By default swinstall will archive the original software in 
	/var/adm/sw/save/PHCO_29055.  If you do not wish to retain a
	copy of the original software, include the patch_save_files
	option in the swinstall command above:

		-x patch_save_files=false

	WARNING: If patch_save_files is false when a patch is installed,
		 the patch cannot be deinstalled.  Please be careful
		 when using this feature.

	For future reference, the contents of the PHCO_29055.text file is 
	available in the product readme:

		swlist -l product -a readme -d @ /tmp/PHCO_29055.depot

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

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

Special Installation Instructions: None