1 MAKE_PKG_DB(1ONBLD)           illumos Build Tools          MAKE_PKG_DB(1ONBLD)
   2 
   3 
   4 
   5 NAME
   6        make_pkg_db - create a Perl DBM database of installed software
   7 
   8 SYNOPSIS
   9        make_pkg_db -dbdir dbm_database_pathname [-h]
  10                    [-ifiles filename...]
  11                    [-pkgdef package_pool_pathname]
  12 
  13 DESCRIPTION
  14        The make_pkg_db command (a Perl script) generates a Perl DBM database
  15        of software installed on a system based on /var/sadm/install/contents
  16        or the contents of a package pool directory. The Perl DBM database
  17        files are used by get_depend_info(1ONBLD).
  18 
  19        The Perl DBM database files contain information keyed on a file name.
  20        Some files, for example, list the package in which a file is included
  21        and the permissions of the file.
  22 
  23        If you run make_pkg_db -dbdir dbm_database_pathname, an error message
  24        such as:
  25 
  26        ***CANNOT RESOLVE ABSOLUTE PATH /usr/java/bin/appletviewer
  27 
  28        is generated because the script cannot resolve symbolic links based on
  29        the information in /var/sadm/install/contents. In
  30        /var/sadm/install/contents, for example, appletviewer is specified as a
  31        symbolic link:
  32 
  33        /usr/bin/appletviewer=../java/bin/appletviewer s none SUNWj2dev
  34 
  35 
  36        Unfortunately, /usr/java is a symbolic link to /usr/java1.2.  The
  37        correct file entry in /var/sadm/install/contents is therefore
  38        /usr/java1.2/bin/appletviewer. It is impossible for this script to
  39        resolve this link based on the information in
  40        /var/sadm/install/contents.
  41 
  42        To correct this problem, create a file named MyLinkResolution and add
  43        this entry:
  44 
  45        /usr/bin/appletviewer=../java1.2/bin/appletviewer s none SUNWj2dev
  46 
  47 
  48        Then enter this command:
  49 
  50        make_pkg_db -dbdir dbm_database_pathname -ifiles MyLinkResolution
  51 
  52        When you execute this command, the following message is displayed:
  53 
  54        ...OVERRIDDEN: /usr/bin/appletviewer=
  55        ../java/bin/appletviewer s none SUNWj2dev
  56 
  57 
  58        This message indicates that the original entry in
  59        /var/sadm/install/contents is ignored and your new entry in
  60        MyLinkResolution is used instead.
  61 
  62        SampleLinks is a file you can use to resolve links in
  63        /var/sadm/install/contents for Solaris (Intel Platform Edition).
  64        SamplePkgLinks is a file you can use to resolve some of the links used
  65        on the Solaris 8 Software 1 of 2 Intel Platform Edition CD. You might
  66        want to modify these two preceding files for SPARC or for your
  67        particular environment.
  68 
  69        The make_pkg_db script verifies the files it finds against the software
  70        that is actually installed on the system. The more complete the
  71        information, the more accurate the output of the script.
  72 
  73 OPTIONS
  74        The following options are supported:
  75 
  76        -dbdir
  77                        Specifies the directory in which you want to place the
  78                        output Perl DBM databases.
  79 
  80 
  81        -h
  82                        Displays help.
  83 
  84 
  85        -ifiles
  86                        Specifies the name of an input file you want to use to
  87                        help in resolving symbolic links.
  88 
  89 
  90        -pkgdef
  91                        Specifies the path name of the package pool you want to
  92                        use instead of /var/sadm/install/contents.
  93 
  94 
  95 OPERANDS
  96        The following operands are supported:
  97 
  98        dbm_database_pathname
  99                                Specifies the directory in which you want to
 100                                place the output Perl DBM databases.
 101 
 102 
 103        filename
 104                                Specifies the name of a file or files that
 105                                contain data in the format used in
 106                                /var/sadm/install/contents.
 107 
 108 
 109        package_pool_pathname
 110                                Specifies the path name of the package pool you
 111                                want to use instead of
 112                                /var/sadm/install/contents.
 113 
 114 
 115 ATTRIBUTES
 116        See attributes(5) for descriptions of the following attributes:
 117 
 118 
 119        +--------------------+-----------------+
 120        |  ATTRIBUTE TYPE    | ATTRIBUTE VALUE |
 121        |Availability        | SUNWonbld       |
 122        |CSI                 | Enabled         |
 123        |Interface Stability | Evolving        |
 124        |MT-Level            | Unsafe          |
 125        +--------------------+-----------------+
 126 
 127 SEE ALSO
 128        get_depend_info(1ONBLD), attributes(5)
 129 
 130 NOTES
 131        DBM database files are platform dependent. DBM database files you
 132        generate on a SPARC machine, for example, do not work on an IA machine
 133        (and vice-versa).
 134 
 135        This script might not resolve all symbolic links.
 136 
 137 
 138 
 139                                November 2, 2000            MAKE_PKG_DB(1ONBLD)