unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (SunOS-5.9)
Page:
Section:
Apropos / Subsearch:
optional field



File Formats                                           pkginfo(4)



NAME
     pkginfo - package characteristics file

DESCRIPTION
     pkginfo is an ASCII file that describes the  characteristics
     of the package along with information that helps control the
     flow of installation. It is created by the software  package
     developer.

     Each entry in the pkginfo file is a  line  that  establishes
     the value of a parameter in the following form:

     PARAM="value"

     There is no required order in which the parameters  must  be
     specified  within the file. The PKG, NAME, ARCH, VERSION and
     CATEGORY parameters  are  mandatory.  Other  parameters  are
     optional.

     The following paramaters are mandatory:

     ARCH  A comma-separated list  of  alphanumeric  tokens  that
           indicate the architecture associated with the package.
           The pkgmk(1) tool may be used to create or modify this
           value  when actually building the package. The maximum
           length of a token  is  16  characters  and  it  cannot
           include a comma.

           Solaris's installation software meaningfully uses only
           one architecture token of the form:


     <instruction_set_architecture>[.<platform_group>]

          where platform_group is intended only for Solaris  ins-
          tallation  packages.  Third  party application software
          should restrict itself to ARCH values from the  follow-
          ing  Solaris-supported  instruction  set  architectures
          (uname -p): sparc, i386, and ppc. Examples of  Solaris'
          platform  groups (uname -m) are sun4u and sun4m for the
          SPARC instruction set and i86pc for the  i386  instruc-
          tion set. See uname(1) and isalist(1) for more details.

     CATEGORY
           A comma-separated list of  categories  under  which  a
           package  may  be  displayed.  A  package must at least
           belong  to  the  system   or   application   category.
           Categories  are  case-insensitive and may contain only
           alphanumerics. Each category is limited in  length  to
           16 characters.

     NAME  Text that specifies the package name  (maximum  length



SunOS 5.9           Last change: 19 Feb 2003                    1






File Formats                                           pkginfo(4)



           of  256  ASCII  characters). Use the NAME parameter as
           the foundation for describing  the  functionality  and
           purpose  of  the  package;  spell out any acronyms and
           avoid internal product/project code  names.  The  DESC
           parameter  can  then be used to expand the descriptive
           information.  Use  the  NAME  parameter  to  state  as
           specifically as possible the use of the package, why a
           user would need to load it, and so on.

     PKG   Abbreviation for  the  package  being  installed.  All
           characters  in  the abbreviation must be alphanumeric.
           You can also use the - and + characters in the  abbre-
           viation.   The  first character cannot be numeric, a +
           or a -.

           The abbreviation is limited to a maximum length of  32
           characters.  install, new, and all are reserved abbre-
           viations. It is  customary  to  make  the  first  four
           letters  unique to your company, such as the company's
           stock symbol.

     VERSION
           Text that specifies  the  current  version  associated
           with  the  software package. The maximum length is 256
           ASCII characters and the first character cannot  be  a
           left  parenthesis.   The  pkgmk(1) tool may be used to
           create or modify this value when actually building the
           package.  Current  Solaris  software  practice  is  to
           assign this parameter monotonically  increasing  Dewey
           decimal values of the form:


     <major_revision>.<minor_revision>[.<micro_revision>]

          where all the revision fields are  integers.  The  ver-
          sioning  fields  can be extended to an arbitrary string
          of numbers in Dewey-decimal format, if necessary.

     The following parameters are optional:

     BASEDIR
           The pathname to a default  directory  where  "relocat-
           able" files may be installed. If blank, the package is
           not relocatable and any files that have relative path-
           names  will  not  be  installed.  An administrator can
           override the default directory.

     CLASSES
           A space-separated list of classes defined for a  pack-
           age.  The  order  of  the list determines the order in
           which the classes are installed. Classes listed  first
           will  be  installed first (on a media by media basis).



SunOS 5.9           Last change: 19 Feb 2003                    2






File Formats                                           pkginfo(4)



           This parameter may be modified by the request script.

     DESC  Text that describes the package (maximum length of 256
           ASCII  characters).  This  parameter  value is used to
           provide the installer with a description of  what  the
           package  contains  and should build on the description
           provided in the NAME parameter. Try to  make  the  two
           parameters  work  together  so  that a pkginfo -l will
           provide a fairly comprehensive textual description  of
           the package.

     EMAIL An electronic address  where  further  information  is
           available  or  bugs may be reported (maximum length of
           256 ASCII characters).

     HOTLINE
           Phone number  and/or  mailing  address  where  further
           information  may  be  received or bugs may be reported
           (maximum length of 256 ASCII characters).

     INTONLY
           Indicates that the package should  only  be  installed
           interactively when set to any non-null value.

     ISTATES
           A list of allowable run states for  package  installa-
           tion  (for  example, "S s 1" allows run states of S, s
           or 1). The Solaris operating environment supports  the
           run  levels s, S, 0, 1, 2, 3, 5, and 6. Applicable run
           levels for this parameter are s, S, 1, 2, and  3.  See
           init(1M) for details.

     MAXINST
           The maximum number of package instances that should be
           allowed  on  a  machine  at the same time. By default,
           only one instance of a package is allowed. This param-
           eter  must  be set in order to have multiple instances
           of a package. In order to support  multiple  instances
           of  packages  (for  example,  packages  that differ in
           their ARCH or VERSION parameter value), the  value  of
           this  parameter  must  be high enough to allow for all
           instances of a given package, including multiple  ver-
           sions coexisting on a software server.

     ORDER A list of classes defining the  order  in  which  they
           should  be  put  on  the  medium.  Used by pkgmk(1) in
           creating the package.  Classes  not  defined  in  this
           field are placed on the medium using the standard ord-
           ering procedures.

     PSTAMP
           Production stamp used to mark the  pkgmap(4)  file  on



SunOS 5.9           Last change: 19 Feb 2003                    3






File Formats                                           pkginfo(4)



           the  output volumes. Provides a means for distinguish-
           ing between production copies of  a  version  if  more
           than  one  is  in  use  at  a  time.  If PSTAMP is not
           defined, the default is used. The default consists  of
           the  UNIX  system  machine name followed by the string
           "YYYYMMDDHHMMSS" (year, month,  date,  hour,  minutes,
           seconds).

     RSTATES
           A list of allowable run  states  for  package  removal
           (for example, "S s 1" allows run states of S, s or 1).
           The Solaris operating  environment  supports  the  run
           levels s, S, 0, 1, 2, 3, 5, and 6. Applicable run lev-
           els for this parameter are s,  S,  1,  2,  and  3  See
           init(1M) for details.

     SUNW_ISA
           Solaris-only  optional  parameter  that  indicates   a
           software  package contains 64-bit objects if it is set
           to sparcv9. If this parameter is not set, the  default
           ISA (instruction set architecture) is set to the value
           of the ARCH parameter.

     SUNW_LOC
           Solaris-only optional parameter  used  to  indicate  a
           software  package  containing localization files for a
           given product or application. The parameter value is a
           comma-separated  list  of locales supported by a pack-
           age. It is only used for packages containing localiza-
           tion  files,  typically  the  message  catalogues. The
           allowable values for this string field are those found
           in  the  table of Standard Locale Names located in the
           International Language Environments Guide.


     SUNW_LOC="<locale_name>,<locale_name>,..,<locale_name>"

     where


     <locale_name>::= <language>[_<territory>][.<codeset>]
     <language>::= the set of names from ISO 639
     <territory>::= the set of territories specified
     in ISO 3166
     <codeset>::= is a string corresponding to the coded
     character set

          Since a value of C specifies the traditional UNIX  sys-
          tem   behavior   (American  English,  en_US),  packages
          belonging to the C locale are viewed  as  non-localized
          packages,   and   thus   must  not  have  SUNW_LOC  and
          SUNW_PKGLIST included in their pkginfo file.  See  also



SunOS 5.9           Last change: 19 Feb 2003                    4






File Formats                                           pkginfo(4)



          the    SUNW_LOC    parameter   in   packagetoc(4)   and
          setlocale(3C) for more information. This keyword is not
          recognized  by  the  add-on  software  utility Software
          Manager.

     SUNW_PKG_DIR
            A value set by pkgadd that contains the  location  of
           the  installing package. This value is provided to any
           install time package procedure scripts that  may  need
           to know where the installing package is located.  This
           parameter should never be set manually from  within  a
           pkginfo file.

     SUNW_PKGLIST
           Solaris-only optional parameter used  to  associate  a
           localization  package  to the package(s) from which it
           is derived.  It  is  required  whenever  the  SUNW_LOC
           parameter  is  defined.  This  parameter  value  is an
           comma-separated list of package abbreviations  of  the
           form:


     SUNW_PKGLIST="pkg1[:version],pkg2[:version],..."

          where version (if specified) should match  the  version
          string  in  the  base  package  specified  (see VERSION
          parameter  in  this  manual   page).   When   in   use,
          SUNW_PKGLIST  helps determine the order of package ins-
          tallation. The packages listed in the parameter will be
          installed  before  the localization package in question
          is installed. When  left  blank,  SUNW_PKGLIST="",  the
          package  is  assumed  to  be required for the locale to
          function correctly. See the SUNW_PKGLIST  parameter  in
          packagetoc(4) for more information. This keyword is not
          recognized by  the  add-on  software  utility  Software
          Manager.

     SUNW_PKGTYPE
           Solaris-only parameter  for  Sun  internal  use  only.
           Required  for packages part of the The Solaris operat-
           ing environment releases which  install  into  the  /,
           /usr, /usr/kvm, and /usr/openwin file systems. The The
           Solaris operating  environment  installation  software
           must know which packages are part of which file system
           to properly install a server/client configuration. The
           currently  allowable  values  for  this  parameter are
           root, usr, kvm, and ow. If no  SUNW_PKGTYPE  parameter
           is  present,  the package is assumed to be of BASEDIR=
           /opt. SUNW_PKGTYPE is optional only for packages which
           install  into  the  /opt name space as is the case for
           the majority  of  Solaris  add-on  software.  See  the
           SUNW_PKGTYPE  parameter  in  packagetoc(4) for further



SunOS 5.9           Last change: 19 Feb 2003                    5






File Formats                                           pkginfo(4)



           information.

     SUNW_PKGVERS
           Solaris-only parameter indicating of  version  of  the
           Solaris operating environment package interface.


     SUNW_PKGVERS="<sunw_package_version>"

          where <unw_package_version> has the form x.y[.z] and x,
          y,  and  z  are  integers.  For packages built for this
          release and previous releases, use SUNW_PKGVERS="1.0".

     SUNW_PRODNAME
           Solaris-only parameter indicating the name of the pro-
           duct  this  package is a part of or comprises (maximum
           length of 256 ASCII characters).  A  few  examples  of
           currently  used  SUNW_PRODNAME  values  are:  "SunOS",
           "OpenWindows", and "Common Desktop Environment".

     SUNW_PRODVERS
           Solaris-only  parameter  indicating  the  version   or
           release  of  the  product  described  in SUNW_PRODNAME
           (maximum length of 256 ASCII characters). For example,
           where  SUNW_PRODNAME="SunOS", and the Solaris 2.x Beta
           release, this string could be "5.x  BETA",  while  for
           the  Solaris  2.x  FCS  release,  the  string would be
           "5.x".  For Solaris 8, the string  is  "5.8".  If  the
           SUNW_PRODNAME  parameter  is  NULL,  so  should be the
           SUNW_PRODVERS parameter.

     ULIMIT
           If set, this parameter is passed as an argument to the
           ulimit(1)  command  (see  limit(1)), which establishes
           the maximum size of a file during installation.

     VENDOR
           Used to identify the vendor that  holds  the  software
           copyright (maximum length of 256 ASCII characters).

     VSTOCK
           The vendor stock number, if any, that identifies  this
           product (maximum length of 256 ASCII characters).

EXAMPLES
     Example 1: A Sample pkginfo File

     Here is a sample pkginfo file:

     SUNW_PRODNAME="SunOS"
     SUNW_PRODVERS="5.5"
     SUNW_PKGTYPE="usr"



SunOS 5.9           Last change: 19 Feb 2003                    6






File Formats                                           pkginfo(4)



     PKG="SUNWesu"
     NAME="Extended System Utilities"
     VERSION="11.5.1"
     ARCH="sparc"
     VENDOR="Sun Microsystems, Inc."
     HOTLINE="Please contact your local service provider"
     EMAIL=""
     VSTOCK="0122c3f5566"
     CATEGORY="system"
     ISTATES="S 2"
     RSTATES="S 2"

ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:








































SunOS 5.9           Last change: 19 Feb 2003                    7






File Formats                                           pkginfo(4)



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWcsu                     |
    |_____________________________|_____________________________|
    | Interface Stability         | See entries below           |
    |_____________________________|_____________________________|
    | PKG value                   | Evolving                    |
    |_____________________________|_____________________________|
    | VERSION value               | Evolving                    |
    |_____________________________|_____________________________|
    | NAME value                  | Evolving                    |
    |_____________________________|_____________________________|
    | DESC value                  | Evolving                    |
    |_____________________________|_____________________________|
    | ARCH value                  | Evolving                    |
    |_____________________________|_____________________________|
    | CATEGORY value              | Evolving                    |
    |_____________________________|_____________________________|
    | BASEDIR value               | Evolving                    |
    |_____________________________|_____________________________|
    | ISTATES value               | Evolving                    |
    |_____________________________|_____________________________|
    | RSTATES value               | Evolving                    |
    |_____________________________|_____________________________|
    | MAXINST value               | Evolving                    |
    |_____________________________|_____________________________|
    | SUNW_PRODNAME               | Evolving                    |
    |_____________________________|_____________________________|
    | SUNW_PRODVERS               | Evolving                    |
    |_____________________________|_____________________________|
    | SUNW_PKGVERS                | Evolving                    |
    |_____________________________|_____________________________|
    | SUNW_PKGTYPE                | Unstable                    |
    |_____________________________|_____________________________|
    | SUNW_LOC                    | Evolving                    |
    |_____________________________|_____________________________|
    | SUNW_PKGLIST                | Evolving                    |
    |_____________________________|_____________________________|
    | SUNW_PKG_DIR                | Evolving                    |
    |_____________________________|_____________________________|


SEE ALSO
     isalist(1),   limit(1),   pkgmk(1),   uname(1),    init(1M),
     setlocale(3C),   clustertoc(4),   order(4),   packagetoc(4),
     pkgmap(4), attributes(5)

     Application Packaging Developer's Guide

     International Language Environments Guide




SunOS 5.9           Last change: 19 Feb 2003                    8






File Formats                                           pkginfo(4)



NOTES
     Developers may define their own installation  parameters  by
     adding a definition to this file. A developer-defined param-
     eter must begin with a capital letter.

     Trailing white space after any parameter value  is  ignored.
     For  example, VENDOR="Sun Microsystems, Inc." is the same as
     VENDOR="Sun Microsystems, Inc. ".















































SunOS 5.9           Last change: 19 Feb 2003                    9