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