PKGINFO(1M-SysV)    RISC/os Reference Manual     PKGINFO(1M-SysV)



NAME
     pkginfo - packaging information interrogation program

SYNOPSIS
     pkginfo request

DESCRIPTION
     pkginfo returns package-dependent information, found in the
     pkginfo file for a package. It is used by the packaging and
     installation tools as a means of encapsulating information
     which varies from package to package, or from release to
     release of a given package.

     pkginfo takes arguments requesting a particular piece of
     information about a package. It reads the pkginfo file for
     the package and then outputs the requested information.  For
     example, to set the environment variable $Pkgid to a
     package's id string, a script might include the command

          Pkgid=`pkginfo pkgid`

     For boolean information (such as whether a subpackage has
     the minirootonly attribute), pkginfo simply returns a
     ``true'' or ``false'' exit status.

     pkginfo always looks at the environment variable $Pkg to
     determine the location of the pkginfo file, $Pkg/pkginfo.
     In general, it is invoked in the form

          pkginfo request

     The requests recognized are:

     bomname subpkgname
          outputs the bom file name for the subpackage with name
          subpkgname.

     optional subpkgname
          pkginfo exits with a ``true'' exit status if the sub-
          package with name subpkgname has the ``optional''
          attribute, otherwise exits with a ``false'' exit
          status.

     os   exits with a ``true'' exit status if the package has
          the ``os'' attribute.

     minirootonly subpkgname
          exits with a ``true'' exit status if the subpackage
          with name subpkgname has the ``minirootonly'' attri-
          bute.

     pkgid



                         Printed 1/15/91                   Page 1

PKGINFO(1M-SysV)    RISC/os Reference Manual     PKGINFO(1M-SysV)



          outputs the package id string.

     pkgname
          outputs the package name.

     position medianame subpkgname
          outputs the tape volume number and archive position for
          the subpackage named subpkgname when using the media
          type medianame.  Volume and position numbers start with
          1.  Note that an archive position of 1 does not mean
          the the archive will be the first file on a tape. The
          actual position of the archive file on the tape depends
          on whether the tape is the first tape in a multitape
          set, and on whether the package is an operating system
          release. See pkgtape(4) for more details on the layout
          of the tapes.

     splitboms subpkgname
          outputs the value of the ``splitboms'' attribute for
          the subpackage named subpkgname.

     subpkgid subpkgname
          outputs the id string for the subpackage named
          subpkgname.

     subpkgnames
          outputs all subpackage names for the package.

     timestamp
          outputs the release timestamp for the package.

     version [sub]pkgname
          outputs the version number associated with the package
          or subpackage named [sub]pkgname.  (If the name given
          matches the package name, the version number associated
          with the top-level package is printed, else the name is
          considered to be a subpackage name.)

     volume medianame volnumber
          outputs the names of all subpackages whose archives
          reside on volume volnumber for media type medianame.

FILES
     .../pkg/lib/pkgname/pkginfo

SEE ALSO
     pkginst(1M).
     pkginfo(4), pkgtape(4) in the Programmer's Reference Manual.







 Page 2                  Printed 1/15/91