Index for Section 4

Alphabetical listing for S

Bottom of page

stl_scp(4)
NAME
  stl_scp - Subset control program conventions for the setld utility

DESCRIPTION
  Each software subset that is distributed for the setld(8) command can have
  an associated subset control program.	 These programs perform the
  application-specific management operations that configure the subset into
  the system.  Because subset control programs must be executed during
  installation to non-native file hierarchies, they must be written in an
  architecture-neutral language.  Because these programs may also be required
  to run while the system is in the single-user run state, the interpreter
  must not use shared libraries.  The use of /sbin/sh is strongly
  recommended.

  As subsets are installed and deleted, they pass through several system
  management states.

  Software is in the NEW state immediately after being extracted from the
  distribution media and verified.  Software in this state is exactly as it
  was prepared for distribution by the software vendor.

  The subset control program is responsible for placing the software in the
  PROTOTYPE state at the request of setld.  Software in this state is
  configured for use at a particular site.  All of the software remains
  sharable but has undergone some level of customization.

  Software becomes runnable on a particular system and ceases to be sharable
  after it has been placed in the CONFIGURED state by the subset control
  program, again at the request of setld.

  Subset control programs are executed by setld to perform specific requested
  operations.  Before executing a subset control program, setld sets the
  environment variable ACT to an action value.	The subset control program is
  expected to inspect this variable and any command-line arguments to
  determine which actions to perform.  The action values, the command-line
  arguments, and the behavior that setld expects are as follows:

  C   Configure subset

      The first command-line argument is a configuration message for the
      subset.  The subset control program can interpret this message as it
      chooses.	There are two reserved subset messages:

      INSTALL
	  Perform any management operations required to change the subset
	  from the PROTOTYPE state to the CONFIGURED state.  Subset control
	  programs called to perform this action must assume that the /usr
	  file system is write locked and that the currently visible
	  execution context (contents of /dev/kmem and so forth) is the same
	  as that in which the application will execute.

      DELETE
	  Perform any management operations required to change the subset
	  from the CONFIGURED state to the PROTOTYPE state.  The execution
	  environment is identical to that for C, INSTALL.

  M   Menu Request

      The first argument is one of -l or -x and specifies whether the user is
      installing or extracting software from the media.

      Determine if the subset is suitable for presentation to the user in the
      subset selection menu.  If the subset is to be presented, the subset
      control program should return exit status 0.  If the subset is not to
      be presented, the subset control program should return a nonzero
      status.

  PRE_D
      Prepare for Deletion

      The subset is about to be deleted from the system.  Perform any
      management operations required to change the subset from the PROTOTYPE
      state to the NEW state.  A nonzero return status can be returned to
      indicate that the subset should not be deleted.

  PRE_L
      Prepare for Load

      The subset is about to be loaded onto the system.	 Verify that the
      system is ready for the subset to loaded from the installation media.
      A nonzero exit status can be returned to indicate that the subset
      should not be installed.

  POST_D
      Post Deletion Cleanup

      The subset control program should perform any management operations
      required to return the system to the state that it was in prior to
      installation of the subset.

  POST_L
      Post Load Configuration

      The subset has been loaded from the media and is on the system in the
      NEW state.  The subset control program must change the subset from the
      NEW state to  the PROTOTYPE state.

  V   Verify Subset

      The setld utility checks for the existence of the installed subset.  If
      the subset exists, the setld utility verifies the size and checksum
      information for each file in the subset.	If the subset control program
      includes any V phase processing, it is executed at this time.

      The setld utility does not execute subset control processing during the
      installation process.

RELATED INFORMATION
  Commands:
      setld(8)

  Documents:
      Guide to Preparing Product Kits

Index for Section 4

Alphabetical listing for S

Top of page