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