Digital

NAME

stl_mi − software distribution master inventory files

DESCRIPTION

Each software product that is distributed as subsets for the setld(8) command has an associated master inventory file. The maeter inventory file’s name consists of the product’s unique 3-letter name and a 3-digit version number with the string .mi for a suffix. The master inventory file is used by the software kitting program kits(1) in producing software distribution packages. 

A master inventory file contains one ASCII record, describing vendor-specified attribute information, for each file in the product kit. Each record is composed of three fields which must be separated by TAB characters. The fields are:

Flags A 16-bit unsigned integer.  ##ifdef REL_TIN Bit 0 is reserved.  #else The lower 2 bits are used by Digital to convey information to setld. 

Bit 0 is the p (precedence) bit; when it is set, an existing copy of the named file takes precedence over a copy in the kit. It is usually set for log files required by applications.  #endif Bit 1 is the v (volatility) bit; when it is set, changes to the existing copy of the file can occur during kit installation. It is usually set for log files required by applications. The remaining bits are reserved; possible values for this field are therefore 0 or 2.  #ifndef REL_TIN

Note

These bit settings are applicable only during subset updating; for a normal kit installation, they are ignored. #endif

Pathname The dot-relative (./) pathname of the file described by this record.  Each pathname must appear only once in the master inventory file.  Pathnames must begin with a period (.). Records must be sorted in ascending ASCII sequence on this field. 

Subset The name of the subset containing the file. Standard system directories are not included in subsets; they are represented by the keyword RESERVED in place of a subset name. Files that exist in the product hierarchy but are not distributed as part of any subset have a minus sign (−) in this field. Files that share a gnode (links) must all be included in the same subset. 

EXAMPLES

This example shows a section of the master inventory for a hypothetical layered product kit:

0    .    RESERVED
0    ./opt/usr    RESERVED
0    ./opt/usr/OATDCB100   OATDCB100
0    ./opt/usr/OATDCB100/bin OATDCB100
0    ./opt/usr/OATDCB100/bin/attr   OATDCB100
0    ./opt/usr/OATDCB100/bin/dcb.spr OATDCB100
0    ./opt/usr/OATDCB100/bin/dcb_defaults   OATDCB100
0    ./opt/usr/OATDCB100/bin/dcb_diag.sed   OATDCB100
0    ./opt/usr/OATDCB100/bin/docbld  OATDCB100
0    ./opt/usr/OATDCB100/bin/unstamp OATDCB100
0    ./opt/usr/OATDCB100/lib OATDCB100
0    ./opt/usr/OATDCB100/lib/br    OATDCB100
0    ./opt/usr/OATDCB100/lib/br/README.dcb  OATDCB100
0    ./opt/usr/OATDCB100/lib/br/attr.1    OATDCBDOC100
0    ./opt/usr/OATDCB100/lib/br/dcb.ps    OATDCBDOC100
0    ./opt/usr/OATDCB100/lib/br/docbld.1   OATDCBDOC100
0    ./opt/usr/OATDCB100/lib/br/docbld.5   OATDCBDOC100
0    ./opt/usr/OATDCB100/lib/br/unstamp.1   OATDCBDOC100
0    ./opt/usr/OATDCB100/lib/doclib  OATDCB100
0    ./opt/usr/OATDCB100/lib/doclib/templates OATDCB100
0    ./opt/usr/OATDCB100/lib/doclib/templates/conv.braces   OATDCB100
0    ./opt/usr/OATDCB100/lib/doclib/templates/conv.command  OATDCB100
 .
 .
 .

RELATED INFORMATION

Commands: invcutter(1), kits(1), setld(8)

Guide to Programming Support Tools