Repairing SCO Openserver Link Kit Corruption 
============================================

This document describes the repairs necessary to the SCO Openserver link kit
due to corruption resulting from a tape drive misconfiguration.

Problem

	After adding and removing tape devices via the "mkdev tape" command,
	the devices removed still show up when viewing the tape drive
	configuration.
	
	Any attempt to remove the devices again results in a message informing
	me that there are no tape drives configured

	This is a known issue with the mkdev scripts for configuring tapes.
	Misconfigured tape drives may not be successfully removed from the
	link kit, resulting in an inability to relink the kernel or 
	succesfully add a new tape drive.
	
Solution

	1. Open /etc/conf/cf.d/mscsi and remove all lines that contain
	   "Stp" in the second field.
	   
	2. Open /etc/conf/sdevice.d/Stp  
		
	   If there is more than one line in this file, delete all lines
	   but the first, and then change the second field in the file from
	   "Y" to "N".
	   
	   After you are finished, it should looke like this:
	   
	   	Stp     N     1     0     0     0     0     0     0     0

	3. Open /etc/conf/pack.d/Stp/device.dat and remove all lines except
	
		FILE_FORMAT:
			version=1
			
	4. Open /etc/conf/pack.d/Stp/space.h and remove everything between the
	   BEGIN and END comment pairs for EXTERNS, ROUTERS and ENHANCEMENTS.
	   
	   The text beneath the commented text at the beginning of the file
	   should look like this:
	   	
	   	/* BEGIN SCO_STP EXTERNS */
		/* END SCO_STP EXTERNS */

	   	int (*Stp_route_tbl[])() = {
		/* BEGIN SCO_STP ROUTERS */
		/* END SCO_STP ROUTERS */
		};
		
		int     Stp_nroute_els = sizeof( Stp_route_tbl ) 
		/ sizeof( int * );

		Stp_tape_config_t       Stp_tape_cfg[STP_NDRIVES] = {
		/* BEGIN SCO_STP ENHANCEMENTS */
		/* END SCO_STP ENHANCEMENTS */
		};

	5. Open /etc/conf/pack.d/Stp/space.c and edit the code between the the 
	   START and STOP comment blocks.
	   
	   You will need to delete any lines that define Stp devices. They 
	   will look like this:
	   
	   	#define Stp0	0
	   	
	   You will also need to remove and references to "Stp" between the 
	   curly braces on the line beginning "int StpProbe".
	   
	   After you are finished, it should look like this:
	   
	   	/*_PROBE_START_*/
		int StpProbe[] = {0};
		/*_PROBE_STOP_*/

	6. At this point your link kit should be free of any references to
	   the phantom tape drive(s).  Run "mkdev tape" again and install
	   your tape drive again.