Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Apropos / Subsearch:
optional field

stl_key(4)							   stl_key(4)


  stl_key - setld kit manufacturing key	files (*.k)


  Each software	product	that is	distributed for	installation by	the setld
  utility has an associated key	file.  The key file's name consists of the
  unique three-letter product code and a three-digit version number with the
  suffix .k, for example: OAT100.k.  The key file is used by the kits utility
  to produce software distribution packages, and consists of a global data
  section and a	subset descriptor section separated by a delimiter line.

  Global Data Section

  The key file's global	data section specifies the product-level attributes
  of the product.  In this section, lines that begin with number signs (#)
  are comments and are ignored by the kits(1) utility.	Attributes are speci-
  fied as NAME=value pairs separated by	equals sign, with no white space.
  There	are four mandatory attributes and two optional attributes; all must
  have non-null	values.	 The attributes	are:

      Mandatory.  Specifies the	name of	the product.  The value	for NAME is a
      text string of up	to 40 characters.  If the string contains blank
      spaces, it must be enclosed in apostrophes ('').

      Mandatory.  Specifies the	3-character product code for the product, for
      example, OAT.

      Mandatory.  Specifies the	3-digit	version	code for the product, for
      example, 100.

  MI  Mandatory.  Specifies the	pathname of the	master inventory file for the

      Optional.	 A single-digit	integer	that is	set to 1 if the	product	is
      the base operating system.  In all other cases, this option must be a
      zero (0).	 If missing, this attribute defaults to	zero.

      Optional.	 A single-digit	integer	that is	set to 1 to create compressed
      subset files using the compress(1) utility, thereby saving space on the
      distribution media.  To suppress compression, set	this attribute is a
      zero (0).	 If missing, this attribute defaults to	zero.

  Section Delimiter Line

  The delimiter	between	the key	file's global data section and subset
  descriptor section is	a single line containing only two percent signs	(%%).

  Subset Descriptor Section

  The subset descriptor	section	contains one subset descriptor for each	sub-
  set in the product. The subset descriptors must be listed in the order that
  the subsets are to be	installed by setld. Comments are not permitted in
  this section.	A subset descriptor contains subset-specific attributes	in
  the following	four fields separated by [TAB] characters:

  Subset name
      A	character string up to 15 characters in	length,	composed of the	3-
      letter product code (for example,	OAT), a	mnemonic identifying the sub-
      set (for example,	DCB), and the 3-digit version code (for	example,
      100).  All letters in the	subset name must be uppercase.

      This field must be a single period.

      A	16-bit unsigned	integer

      Bit 0 indicates whether the subset can be	removed

      Bit 1 indicates whether the subset is optional

      Bits 2 to	7 are reserved

      Bits 8 to	15 are undefined

      A	short description of the subset	within single quotation	marks, for
      example, 'Document Building Tools'


  Do not place comments	in the subset descriptor section. They will cause
  serious problems when	you run	the kits utility.

  [TAB]	formatting in the subset descriptors is	tightly	enforced by the	kits


  The following	example	illustrates the	key file for a hypothetical product

       #       Key file	for the	Orpheus	Document Building Tools	kit
       #       Product-level attributes.
       NAME='Orpheus Authoring Tools'
       #       Subset definitions follow.
       OATODB100       .       0       'Document Building Tools'
       OATODBDOC100    .       2       'Document Building Tools	Documentation'


  Commands: kits(1), setld(8)

  Files: stl_comp(4), stl_ctrl(4), stl_image(4), stl_mi(4)

  Guide	to Preparing Product Kits