1 '\" t
   2 .\"
   3 .\" CDDL HEADER START
   4 .\"
   5 .\" The contents of this file are subject to the terms of the
   6 .\" Common Development and Distribution License, Version 1.0 only
   7 .\" (the "License").  You may not use this file except in compliance
   8 .\" with the License.
   9 .\"
  10 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
  11 .\" or http://www.opensolaris.org/os/licensing.
  12 .\" See the License for the specific language governing permissions
  13 .\" and limitations under the License.
  14 .\"
  15 .\" When distributing Covered Code, include this CDDL HEADER in each
  16 .\" file and include the License file at usr/src/OPENSOLARIS.LICENSE.
  17 .\" If applicable, add the following below this CDDL HEADER, with the
  18 .\" fields enclosed by brackets "[]" replaced with your own identifying
  19 .\" information: Portions Copyright [yyyy] [name of copyright owner]
  20 .\"
  21 .\" CDDL HEADER END
  22 .\"
  23 .\"
  24 .\" Copyright (c) 2005 Sun Microsystems, Inc. All rights reserved.
  25 .\" Use is subject to license terms.
  26 .\"
  27 .TH MAKE_PKG_DB 1ONBLD "Nov 2, 2000"
  28 .SH "NAME"
  29 make_pkg_db \- create a Perl DBM database of installed software
  30 .SH "SYNOPSIS"
  31 .PP
  32 .nf
  33 \fBmake_pkg_db\fR \-\fBdbdir\fR \fIdbm_database_pathname\fR\ [-\fBh\fR]
  34             [-\fBifiles\fR \fIfilename\fR\&...]
  35             [-\fBpkgdef\fR \fIpackage_pool_pathname\fR]
  36 .fi
  37 .SH "DESCRIPTION"
  38 .PP
  39 The \fBmake_pkg_db\fR command (a Perl script) generates a Perl DBM database of
  40 software installed on a system based on \fB/var/sadm/install/contents\fR or the
  41 contents of a package pool directory\&. The Perl DBM database files are used by
  42 \fBget_depend_info\fR(1ONBLD)\&.
  43 .PP
  44 The Perl DBM database files contain information keyed on a file name\&. Some
  45 files, for example, list the package in which a file is included and the
  46 permissions of the file\&.
  47 .PP
  48 If you run \fBmake_pkg_db\ -dbdir\ \fIdbm_database_pathname\fR\fR, an error
  49 message such as:
  50 .PP
  51 \fB***CANNOT RESOLVE ABSOLUTE PATH /usr/java/bin/appletviewer\fR
  52 .PP
  53 is generated because the script cannot resolve symbolic links based on the
  54 information in \fB/var/sadm/install/contents\fR\&. In
  55 \fB/var/sadm/install/contents\fR, for example, \fBappletviewer\fR is specified
  56 as a symbolic link:
  57 .sp
  58 .nf
  59 \f(CW/usr/bin/appletviewer=\&.\&./java/bin/appletviewer s none SUNWj2dev\fR
  60 .fi
  61 .sp
  62 .PP
  63 Unfortunately, \fB/usr/java\fR is a symbolic link to \fB/usr/java1\&.2\fR\&.
  64 The correct file entry in \fB/var/sadm/install/contents\fR is therefore
  65 \fB/usr/java1\&.2/bin/appletviewer\fR\&. It is impossible for this script to
  66 resolve this link based on the information in
  67 \fB/var/sadm/install/contents\fR\&.
  68 .PP
  69 To correct this problem, create a file named \fBMyLinkResolution\fR and add
  70 this entry:
  71 .sp
  72 .nf
  73 \f(CW/usr/bin/appletviewer=\&.\&./java1\&.2/bin/appletviewer s none SUNWj2dev\fR
  74 .fi
  75 .sp
  76 .PP
  77 Then enter this command:
  78 .PP
  79 .sp
  80 .nf
  81 \f(CWmake_pkg_db -dbdir \fIdbm_database_pathname\fR -ifiles MyLinkResolution\fR
  82 .fi
  83 .sp
  84 When you execute this command, the following message is displayed:
  85 .sp
  86 .nf
  87 \f(CW\&.\&.\&.OVERRIDDEN: /usr/bin/appletviewer=
  88 \&.\&./java/bin/appletviewer s none SUNWj2dev\fR
  89 .fi
  90 .sp
  91 .PP
  92 This message indicates that the original entry in
  93 \fB/var/sadm/install/contents\fR is ignored and your new entry in
  94 \fBMyLinkResolution\fR is used instead\&.
  95 .PP
  96 \fBSampleLinks\fR is a file you can use to resolve links in
  97 \fB/var/sadm/install/contents\fR for Solaris (Intel Platform Edition)\&.
  98 \fBSamplePkgLinks\fR is a file you can use to resolve some of the links used on
  99 the Solaris 8 Software 1 of 2 Intel Platform Edition CD\&. You might want to
 100 modify these two preceding files for SPARC or for your particular environment\&.
 101 .PP
 102 The \fBmake_pkg_db\fR script verifies the files it finds against the software
 103 that is actually installed on the system\&. The more complete the information,
 104 the more accurate the output of the script\&.
 105 .SH "OPTIONS"
 106 .PP
 107 The following options are supported:
 108 .sp
 109 .ne 2
 110 \fB-\fBdbdir\fR\fR
 111 .in +16n
 112 Specifies the directory in which you want to place the output Perl DBM
 113 databases\&.
 114 .sp
 115 .sp 1
 116 .in -16n
 117 .sp
 118 .ne 2
 119 \fB-\fBh\fR\fR
 120 .in +16n
 121 Displays help\&.
 122 .sp
 123 .sp 1
 124 .in -16n
 125 .sp
 126 .ne 2
 127 \fB-\fBifiles\fR\fR
 128 .in +16n
 129 Specifies the name of an input file you want to use to help in resolving
 130 symbolic links\&.
 131 .sp
 132 .sp 1
 133 .in -16n
 134 .sp
 135 .ne 2
 136 \fB-\fBpkgdef\fR\fR
 137 .in +16n
 138 Specifies the path name of the package pool you want to use instead of
 139 \fB/var/sadm/install/contents\fR\&.
 140 .sp
 141 .sp 1
 142 .in -16n
 143 .SH "OPERANDS"
 144 .PP
 145 The following operands are supported:
 146 .sp
 147 .ne 2
 148 \fB\fIdbm_database_pathname\fR\fR
 149 .in +24n
 150 Specifies the directory in which you want to place the output Perl DBM
 151 databases\&.
 152 .sp
 153 .sp 1
 154 .in -24n
 155 .sp
 156 .ne 2
 157 \fB\fIfilename\fR\fR
 158 .in +24n
 159 Specifies the name of a file or files that contain data in the format used in
 160 \fB/var/sadm/install/contents\fR\&.
 161 .sp
 162 .sp 1
 163 .in -24n
 164 .sp
 165 .ne 2
 166 \fB\fIpackage_pool_pathname\fR\fR
 167 .in +24n
 168 Specifies the path name of the package pool you want to use instead of
 169 \fB/var/sadm/install/contents\fR\&.
 170 .sp
 171 .sp 1
 172 .in -24n
 173 .SH "ATTRIBUTES"
 174 .PP
 175 See \fBattributes\fR(5) for descriptions of the following attributes:
 176 .sp
 177 .TS
 178 box;
 179 cw | cw
 180 lw | lw .
 181 ATTRIBUTE TYPE  ATTRIBUTE VALUE
 182 Availability    SUNWonbld
 183 CSI     Enabled
 184 Interface Stability     Evolving
 185 MT-Level        Unsafe
 186 .TE
 187 .sp
 188 .SH "SEE ALSO"
 189 .PP
 190 \fBget_depend_info\fR(1ONBLD), \fBattributes\fR(5)
 191 .SH "NOTES"
 192 .PP
 193 DBM database files are platform dependent\&. DBM database files you generate on
 194 a SPARC machine, for example, do not work on an IA machine (and vice-versa)\&.
 195 .PP
 196 This script might not resolve all symbolic links\&.