*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->Tru64 Unix man pages -> stl_key (4)              



NAME    [Toc]    [Back]

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

DESCRIPTION    [Toc]    [Back]

       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
       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    [Toc]    [Back]
       The key file's global data section specifies the  productlevel
  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 specified
       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.  Mandatory.  Specifies the
       pathname of the master inventory  file  for  the  product.
       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    [Toc]    [Back]
       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    [Toc]    [Back]
       The subset descriptor section contains one subset descriptor
 for each subset 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:  A  character  string  up  to 15 characters in
       length, composed of the 3-letter product code  (for  example,
 OAT), a mnemonic identifying the subset (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'

RESTRICTIONS    [Toc]    [Back]

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

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

EXAMPLES    [Toc]    [Back]

       The following example illustrates the key file for a hypothetical
 product kit:

       #       Key file for the Orpheus Document  Building  Tools
       kit  #  #       Product-level attributes.  # NAME='Orpheus
       Authoring Tools' CODE=OAT VERS=100 MI=OAT00.mi ROOT=0 COMPRESS=1
   #  #        Subset  definitions  follow.   #  %%
       OATODB100       .       0       'Document Building  Tools'
       OATODBDOC100     .        2       'Document Building Tools

SEE ALSO    [Toc]    [Back]

       Commands: kits(1), setld(8)

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

       Guide to Preparing Product Kits

[ Back ]
 Similar pages
Name OS Title
stl_comp Tru64 setld compression option files (*.comp)
stl_ctrl Tru64 setld software subset control files (*.ctrl)
usync Tru64 synchronize two setld inventory files to reflect current system status
stl_image Tru64 setld software subset image data files (*.image)
stl_inv Tru64 setld inventory file format (*.inv)
stl_sts Tru64 setld subset status file
kits Tru64 Generates setld format distribution kits
stl_scp Tru64 Subset control program conventions for the setld utility (*.scp)
pax HP-UX Extracts, writes, and lists archive files; copies files and directory hierarchies
dcl2inc Linux postprocess ftnchek .dcl files to create separate INCLUDE files
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service