| @@ -1,347 +1,347 @@ | | | @@ -1,347 +1,347 @@ |
1 | .\" $NetBSD: pkg_admin.1,v 1.1.1.6.2.2 2009/06/05 17:01:58 snj Exp $ | | 1 | .\" $NetBSD: pkg_admin.1,v 1.1.1.6.2.3 2009/06/21 11:42:52 bouyer Exp $ |
2 | .\" | | 2 | .\" |
3 | .\" Copyright (c) 1999-2009 The NetBSD Foundation, Inc. | | 3 | .\" Copyright (c) 1999-2009 The NetBSD Foundation, Inc. |
4 | .\" All rights reserved. | | 4 | .\" All rights reserved. |
5 | .\" | | 5 | .\" |
6 | .\" This code is derived from software contributed to The NetBSD Foundation | | 6 | .\" This code is derived from software contributed to The NetBSD Foundation |
7 | .\" by Hubert Feyrer <hubert@feyrer.de>. | | 7 | .\" by Hubert Feyrer <hubert@feyrer.de>. |
8 | .\" | | 8 | .\" |
9 | .\" Redistribution and use in source and binary forms, with or without | | 9 | .\" Redistribution and use in source and binary forms, with or without |
10 | .\" modification, are permitted provided that the following conditions | | 10 | .\" modification, are permitted provided that the following conditions |
11 | .\" are met: | | 11 | .\" are met: |
12 | .\" 1. Redistributions of source code must retain the above copyright | | 12 | .\" 1. Redistributions of source code must retain the above copyright |
13 | .\" notice, this list of conditions and the following disclaimer. | | 13 | .\" notice, this list of conditions and the following disclaimer. |
14 | .\" 2. Redistributions in binary form must reproduce the above copyright | | 14 | .\" 2. Redistributions in binary form must reproduce the above copyright |
15 | .\" notice, this list of conditions and the following disclaimer in the | | 15 | .\" notice, this list of conditions and the following disclaimer in the |
16 | .\" documentation and/or other materials provided with the distribution. | | 16 | .\" documentation and/or other materials provided with the distribution. |
17 | .\" 3. All advertising materials mentioning features or use of this software | | 17 | .\" 3. All advertising materials mentioning features or use of this software |
18 | .\" must display the following acknowledgement: | | 18 | .\" must display the following acknowledgement: |
19 | .\" This product includes software developed by the NetBSD | | 19 | .\" This product includes software developed by the NetBSD |
20 | .\" Foundation, Inc. and its contributors. | | 20 | .\" Foundation, Inc. and its contributors. |
21 | .\" 4. Neither the name of The NetBSD Foundation nor the names of its | | 21 | .\" 4. Neither the name of The NetBSD Foundation nor the names of its |
22 | .\" contributors may be used to endorse or promote products derived | | 22 | .\" contributors may be used to endorse or promote products derived |
23 | .\" from this software without specific prior written permission. | | 23 | .\" from this software without specific prior written permission. |
24 | .\" | | 24 | .\" |
25 | .\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS | | 25 | .\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS |
26 | .\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED | | 26 | .\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED |
27 | .\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR | | 27 | .\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR |
28 | .\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS | | 28 | .\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS |
29 | .\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR | | 29 | .\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR |
30 | .\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF | | 30 | .\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF |
31 | .\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS | | 31 | .\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS |
32 | .\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN | | 32 | .\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN |
33 | .\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) | | 33 | .\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) |
34 | .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE | | 34 | .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE |
35 | .\" POSSIBILITY OF SUCH DAMAGE. | | 35 | .\" POSSIBILITY OF SUCH DAMAGE. |
36 | .\" | | 36 | .\" |
37 | .Dd April 25, 2009 | | 37 | .Dd April 25, 2009 |
38 | .Dt PKG_ADMIN 1 | | 38 | .Dt PKG_ADMIN 1 |
39 | .Os | | 39 | .Os |
40 | .Sh NAME | | 40 | .Sh NAME |
41 | .Nm pkg_admin | | 41 | .Nm pkg_admin |
42 | .Nd perform various administrative tasks to the pkg system | | 42 | .Nd perform various administrative tasks to the pkg system |
43 | .Sh SYNOPSIS | | 43 | .Sh SYNOPSIS |
44 | .Nm | | 44 | .Nm |
45 | .Op Fl bqSVv | | 45 | .Op Fl bqSVv |
46 | .Op Fl C Ar config | | 46 | .Op Fl C Ar config |
47 | .Op Fl d Ar lsdir | | 47 | .Op Fl d Ar lsdir |
48 | .Op Fl K Ar pkg_dbdir | | 48 | .Op Fl K Ar pkg_dbdir |
49 | .Op Fl s Ar sfx_pattern | | 49 | .Op Fl s Ar sfx_pattern |
50 | .Ar command Op args ... | | 50 | .Ar command Op args ... |
51 | .Sh DESCRIPTION | | 51 | .Sh DESCRIPTION |
52 | This command performs various administrative tasks around the | | 52 | This command performs various administrative tasks around the |
53 | .Nx | | 53 | .Nx |
54 | Packages System. | | 54 | Packages System. |
55 | .Sh OPTIONS | | 55 | .Sh OPTIONS |
56 | The following command-line options are supported: | | 56 | The following command-line options are supported: |
57 | .Bl -tag -width indent | | 57 | .Bl -tag -width indent |
58 | .It Fl b | | 58 | .It Fl b |
59 | Print only the base names when matching package names for | | 59 | Print only the base names when matching package names for |
60 | .Cm lsall | | 60 | .Cm lsall |
61 | and | | 61 | and |
62 | .Cm lsbest . | | 62 | .Cm lsbest . |
63 | .It Fl C Ar config | | 63 | .It Fl C Ar config |
64 | Read the configuration file from | | 64 | Read the configuration file from |
65 | .Ar config | | 65 | .Ar config |
66 | instead of the system default. | | 66 | instead of the system default. |
67 | .It Fl d Ar lsdir | | 67 | .It Fl d Ar lsdir |
68 | Set | | 68 | Set |
69 | .Ar lsdir | | 69 | .Ar lsdir |
70 | as the path to the directory in which to find matching package names for | | 70 | as the path to the directory in which to find matching package names for |
71 | .Cm lsall | | 71 | .Cm lsall |
72 | and | | 72 | and |
73 | .Cm lsbest . | | 73 | .Cm lsbest . |
74 | .It Fl K Ar pkg_dbdir | | 74 | .It Fl K Ar pkg_dbdir |
75 | Set | | 75 | Set |
76 | .Ar pkg_dbdir | | 76 | .Ar pkg_dbdir |
77 | as the package database directory. | | 77 | as the package database directory. |
78 | If this option isn't specified, then the package database directory is | | 78 | If this option isn't specified, then the package database directory is |
79 | taken from the value of the environment variable | | 79 | taken from the value of the environment variable |
80 | .Ev PKG_DBDIR | | 80 | .Ev PKG_DBDIR |
81 | if it's set, otherwise it defaults to | | 81 | if it's set, otherwise it defaults to |
82 | .Pa /var/db/pkg . | | 82 | .Pa /var/db/pkg . |
83 | .It Fl q | | 83 | .It Fl q |
84 | Perform checks in a quiet manner. | | 84 | Perform checks in a quiet manner. |
85 | In normal operation, | | 85 | In normal operation, |
86 | .Nm | | 86 | .Nm |
87 | prints a | | 87 | prints a |
88 | .Sq \&. | | 88 | .Sq \&. |
89 | to standard output to indicate progress. | | 89 | to standard output to indicate progress. |
90 | This option suppresses this progress indicator. | | 90 | This option suppresses this progress indicator. |
91 | .It Fl S | | 91 | .It Fl S |
92 | Set the shell glob pattern for package suffixes when matching package | | 92 | Set the shell glob pattern for package suffixes when matching package |
93 | names for | | 93 | names for |
94 | .Cm lsall | | 94 | .Cm lsall |
95 | and | | 95 | and |
96 | .Cm lsbest | | 96 | .Cm lsbest |
97 | to be the null suffix. | | 97 | to be the null suffix. |
98 | .It Fl s Ar sfx_pattern | | 98 | .It Fl s Ar sfx_pattern |
99 | Set the shell glob pattern for package suffixes when matching package | | 99 | Set the shell glob pattern for package suffixes when matching package |
100 | names for | | 100 | names for |
101 | .Cm lsall | | 101 | .Cm lsall |
102 | and | | 102 | and |
103 | .Cm lsbest . | | 103 | .Cm lsbest . |
104 | The default pattern is ".t[bg]z". | | 104 | The default pattern is ".t[bg]z". |
105 | .It Fl V | | 105 | .It Fl V |
106 | Print version number and exit. | | 106 | Print version number and exit. |
107 | .It Fl v | | 107 | .It Fl v |
108 | Be more verbose. | | 108 | Be more verbose. |
109 | .El | | 109 | .El |
110 | .Pp | | 110 | .Pp |
111 | The following commands are supported: | | 111 | The following commands are supported: |
112 | .Bl -tag -width indent | | 112 | .Bl -tag -width indent |
113 | .It Cm add Ar pkg ... | | 113 | .It Cm add Ar pkg ... |
114 | For each listed package, write the absolute pathnames of the files listed in | | 114 | For each listed package, write the absolute pathnames of the files listed in |
115 | its | | 115 | its |
116 | .Pa +CONTENTS | | 116 | .Pa +CONTENTS |
117 | file together with the package they belong to into the package database. | | 117 | file together with the package they belong to into the package database. |
118 | This should be used only by | | 118 | This should be used only by |
119 | .Xr pkg_view 1 . | | 119 | .Xr pkg_view 1 . |
120 | .It Cm audit Oo Fl es Oc Oo Fl t Ar type Oc Oo Ar pkg Oc ... | | 120 | .It Cm audit Oo Fl es Oc Oo Fl t Ar type Oc Oo Ar pkg Oc ... |
121 | Check the listed installed packages for vulnerabilities. | | 121 | Check the listed installed packages for vulnerabilities. |
122 | If no package is given, check all installed packages. | | 122 | If no package is given, check all installed packages. |
123 | If | | 123 | If |
124 | .Fl e | | 124 | .Fl e |
125 | is given, also include end-of-life information. | | 125 | is given, also include end-of-life information. |
126 | If | | 126 | If |
127 | .Fl s | | 127 | .Fl s |
128 | is given, check the signature of the pkg-vulnerabilities file before using it. | | 128 | is given, check the signature of the pkg-vulnerabilities file before using it. |
129 | .Fl t | | 129 | .Fl t |
130 | restricts the reported vulnerabilities to type | | 130 | restricts the reported vulnerabilities to type |
131 | .Ar type . | | 131 | .Ar type . |
132 | .It Cm audit-pkg Oo Fl es Oc Oo Fl t Ar type Oc Oo Ar pkg Oc ... | | 132 | .It Cm audit-pkg Oo Fl es Oc Oo Fl t Ar type Oc Oo Ar pkg Oc ... |
133 | Like | | 133 | Like |
134 | .Cm audit , | | 134 | .Cm audit , |
135 | but check only the given package names or patterns. | | 135 | but check only the given package names or patterns. |
136 | .It Cm audit-batch Oo Fl es Oc Oo Fl t Ar type Oc Oo Ar pkg-list Oc ... | | 136 | .It Cm audit-batch Oo Fl es Oc Oo Fl t Ar type Oc Oo Ar pkg-list Oc ... |
137 | Like | | 137 | Like |
138 | .Cm audit-pkg , | | 138 | .Cm audit-pkg , |
139 | but read the package names or patterns one per line from the given files. | | 139 | but read the package names or patterns one per line from the given files. |
140 | .It Cm audit-history Oo Fl s Oc Oo Fl t Ar type Oc Oo Ar pkgbase Oc ... | | 140 | .It Cm audit-history Oo Fl s Oc Oo Fl t Ar type Oc Oo Ar pkgbase Oc ... |
141 | Print all vulnerabilities for the given base package names. | | 141 | Print all vulnerabilities for the given base package names. |
142 | .It Cm check Op Ar pkg ... | | 142 | .It Cm check Op Ar pkg ... |
143 | Use this command to check the files belonging to some or all of the | | 143 | Use this command to check the files belonging to some or all of the |
144 | packages installed on the local machine against the checksum | | 144 | packages installed on the local machine against the checksum |
145 | which was recorded in the | | 145 | which was recorded in the |
146 | .Pa +CONTENTS | | 146 | .Pa +CONTENTS |
147 | files at package installation time. | | 147 | files at package installation time. |
148 | Symbolic links also have their integrity checked against the recorded | | 148 | Symbolic links also have their integrity checked against the recorded |
149 | value at package installation time. | | 149 | value at package installation time. |
150 | If no additional argument is given, the files of all installed packages | | 150 | If no additional argument is given, the files of all installed packages |
151 | are checked, else only the named packages will be checked (wildcards can | | 151 | are checked, else only the named packages will be checked (wildcards can |
152 | be used here, see | | 152 | be used here, see |
153 | .Xr pkg_info 1 ) . | | 153 | .Xr pkg_info 1 ) . |
154 | .Pp | | 154 | .Pp |
155 | The packages' | | 155 | The packages' |
156 | .Pa +CONTENTS | | 156 | .Pa +CONTENTS |
157 | files will be parsed and the | | 157 | files will be parsed and the |
158 | checksum will be checked for every file found. | | 158 | checksum will be checked for every file found. |
159 | A warning message is printed if the expected checksum differs from the | | 159 | A warning message is printed if the expected checksum differs from the |
160 | checksum of the file on disk. | | 160 | checksum of the file on disk. |
161 | Symbolic links are also checked, ensuring that the targets on disk are | | 161 | Symbolic links are also checked, ensuring that the targets on disk are |
162 | the same as the contents recorded at package installation time. | | 162 | the same as the contents recorded at package installation time. |
163 | .It Cm check-license Ar condition | | 163 | .It Cm check-license Ar condition |
164 | Check if | | 164 | Check if |
165 | .Ar condition | | 165 | .Ar condition |
166 | can be fulfilled with the currently set of accepted licenses. | | 166 | can be fulfilled with the currently set of accepted licenses. |
167 | Prints either yes or no to stdout if the condition can be parsed, | | 167 | Prints either yes or no to stdout if the condition can be parsed, |
168 | otherwise it exits with error. | | 168 | otherwise it exits with error. |
169 | .It Cm check-pkg-vulnerabilities Oo Fl s Oc Ar file | | 169 | .It Cm check-pkg-vulnerabilities Oo Fl s Oc Ar file |
170 | Check format and hashes in the pkg-vulnerabilities file | | 170 | Check format and hashes in the pkg-vulnerabilities file |
171 | .Ar file . | | 171 | .Ar file . |
172 | If | | 172 | If |
173 | .Fl s | | 173 | .Fl s |
174 | is given, also check the embedded signature. | | 174 | is given, also check the embedded signature. |
175 | .It Cm check-signature Ar file ... | | 175 | .It Cm check-signature Ar file ... |
176 | Reports if | | 176 | Reports if |
177 | .Ar file | | 177 | .Ar file |
178 | is a correctly signed package. | | 178 | is a correctly signed package. |
179 | .It Cm check-single-license Ar liccense | | 179 | .It Cm check-single-license Ar license |
180 | Check if | | 180 | Check if |
181 | .Ar license | | 181 | .Ar license |
182 | is a valid license name and if it is in the set of acceptable licenses. | | 182 | is a valid license name and if it is in the set of acceptable licenses. |
183 | Prints either yes or no to stdout if the condition can be parsed, | | 183 | Prints either yes or no to stdout if the condition can be parsed, |
184 | otherwise it exits with error. | | 184 | otherwise it exits with error. |
185 | .It Cm config-var Ar variable | | 185 | .It Cm config-var Ar variable |
186 | Print the current value of | | 186 | Print the current value of |
187 | .Ar variable | | 187 | .Ar variable |
188 | as used after parsing the configuration file. | | 188 | as used after parsing the configuration file. |
189 | .It Cm delete Ar pkg ... | | 189 | .It Cm delete Ar pkg ... |
190 | For each listed package, remove all file entries in the package database that | | 190 | For each listed package, remove all file entries in the package database that |
191 | belong to the package. | | 191 | belong to the package. |
192 | This should be used only by | | 192 | This should be used only by |
193 | .Xr pkg_view 1 . | | 193 | .Xr pkg_view 1 . |
194 | .It Cm dump | | 194 | .It Cm dump |
195 | Dump the contents of the package database, similar to | | 195 | Dump the contents of the package database, similar to |
196 | .Cm pkg_info -F . | | 196 | .Cm pkg_info -F . |
197 | Columns are printed for the key field used in the pkgdb - the filename -, | | 197 | Columns are printed for the key field used in the pkgdb - the filename -, |
198 | and the data field - the package the file belongs to. | | 198 | and the data field - the package the file belongs to. |
199 | .It Cm fetch-pkg-vulnerabilities Oo Fl su Oc | | 199 | .It Cm fetch-pkg-vulnerabilities Oo Fl su Oc |
200 | Fetch a new pkg-vulnerabilities file, check the format and if | | 200 | Fetch a new pkg-vulnerabilities file, check the format and if |
201 | .Fl s | | 201 | .Fl s |
202 | is given the signature. | | 202 | is given the signature. |
203 | If all checks are passed, write it to pkgdb. | | 203 | If all checks are passed, write it to pkgdb. |
204 | If | | 204 | If |
205 | .Fl u | | 205 | .Fl u |
206 | is given, the fetch is conditional and the file transfer is only done if | | 206 | is given, the fetch is conditional and the file transfer is only done if |
207 | the remote version is newer than the one in pkgdb. | | 207 | the remote version is newer than the one in pkgdb. |
208 | .It Cm lsall Ar /dir/pkgpattern | | 208 | .It Cm lsall Ar /dir/pkgpattern |
209 | .It Cm lsbest Ar /dir/pkgpattern | | 209 | .It Cm lsbest Ar /dir/pkgpattern |
210 | List all/best package matching pattern in the given directory | | 210 | List all/best package matching pattern in the given directory |
211 | .Pa /dir . | | 211 | .Pa /dir . |
212 | If the | | 212 | If the |
213 | .Fl d | | 213 | .Fl d |
214 | flag is given, then that directory path overrides | | 214 | flag is given, then that directory path overrides |
215 | .Pa /dir . | | 215 | .Pa /dir . |
216 | Can be used to work around limitations of /bin/sh and other | | 216 | Can be used to work around limitations of /bin/sh and other |
217 | filename globbing mechanisms. | | 217 | filename globbing mechanisms. |
218 | This option implements matching of | | 218 | This option implements matching of |
219 | pkg-wildcards against arbitrary files and directories, useful mainly in | | 219 | pkg-wildcards against arbitrary files and directories, useful mainly in |
220 | the build system itself. | | 220 | the build system itself. |
221 | See | | 221 | See |
222 | .Xr pkg_info 1 | | 222 | .Xr pkg_info 1 |
223 | for a description of the pattern. | | 223 | for a description of the pattern. |
224 | .Pp | | 224 | .Pp |
225 | Example: | | 225 | Example: |
226 | .Bd -literal | | 226 | .Bd -literal |
227 | yui# cd /usr/pkgsrc/packages/i386ELF/All/ | | 227 | yui# cd /usr/pkgsrc/packages/i386ELF/All/ |
228 | yui# ls unzip* | | 228 | yui# ls unzip* |
229 | unzip-5.40.tgz unzip-5.41.tgz | | 229 | unzip-5.40.tgz unzip-5.41.tgz |
230 | yui# pkg_admin lsall 'unzip*' | | 230 | yui# pkg_admin lsall 'unzip*' |
231 | /usr/pkgsrc/packages/i386ELF/All/unzip-5.40.tgz | | 231 | /usr/pkgsrc/packages/i386ELF/All/unzip-5.40.tgz |
232 | /usr/pkgsrc/packages/i386ELF/All/unzip-5.41.tgz | | 232 | /usr/pkgsrc/packages/i386ELF/All/unzip-5.41.tgz |
233 | yui# pkg_admin lsall 'unzip\*[Ge]5.40' | | 233 | yui# pkg_admin lsall 'unzip\*[Ge]5.40' |
234 | /usr/pkgsrc/packages/i386ELF/All/unzip-5.40.tgz | | 234 | /usr/pkgsrc/packages/i386ELF/All/unzip-5.40.tgz |
235 | /usr/pkgsrc/packages/i386ELF/All/unzip-5.41.tgz | | 235 | /usr/pkgsrc/packages/i386ELF/All/unzip-5.41.tgz |
236 | yui# pkg_admin lsall 'unzip\*[Ge]5.41' | | 236 | yui# pkg_admin lsall 'unzip\*[Ge]5.41' |
237 | /usr/pkgsrc/packages/i386ELF/All/unzip-5.41.tgz | | 237 | /usr/pkgsrc/packages/i386ELF/All/unzip-5.41.tgz |
238 | yui# pkg_admin lsbest 'unzip\*[Ge]5.40' | | 238 | yui# pkg_admin lsbest 'unzip\*[Ge]5.40' |
239 | /usr/pkgsrc/packages/i386ELF/All/unzip-5.41.tgz | | 239 | /usr/pkgsrc/packages/i386ELF/All/unzip-5.41.tgz |
240 | yui# pkg_admin lsall /usr/pkgsrc/packages/i386ELF/All/'{mit,unproven}-pthread*' | | 240 | yui# pkg_admin lsall /usr/pkgsrc/packages/i386ELF/All/'{mit,unproven}-pthread*' |
241 | /usr/pkgsrc/packages/i386ELF/All/mit-pthreads-1.60b6.tgz | | 241 | /usr/pkgsrc/packages/i386ELF/All/mit-pthreads-1.60b6.tgz |
242 | /usr/pkgsrc/packages/i386ELF/All/unproven-pthreads-0.15.tgz | | 242 | /usr/pkgsrc/packages/i386ELF/All/unproven-pthreads-0.15.tgz |
243 | .Ed | | 243 | .Ed |
244 | .It Cm pmatch Ar pattern Ar pkg | | 244 | .It Cm pmatch Ar pattern Ar pkg |
245 | Returns true if | | 245 | Returns true if |
246 | .Ar pkg | | 246 | .Ar pkg |
247 | matches | | 247 | matches |
248 | .Ar pattern , | | 248 | .Ar pattern , |
249 | otherwise returns false. | | 249 | otherwise returns false. |
250 | .It Cm rebuild | | 250 | .It Cm rebuild |
251 | Rebuild the package database mapping from scratch, scanning | | 251 | Rebuild the package database mapping from scratch, scanning |
252 | subdirectories in | | 252 | subdirectories in |
253 | .Pa /var/db/pkg | | 253 | .Pa /var/db/pkg |
254 | for | | 254 | for |
255 | .Pa +CONTENTS | | 255 | .Pa +CONTENTS |
256 | files, parsing them and writing the resulting absolute pathnames | | 256 | files, parsing them and writing the resulting absolute pathnames |
257 | together with the package they belong to into the package database. | | 257 | together with the package they belong to into the package database. |
258 | .Pp | | 258 | .Pp |
259 | This option is intended to be used for upgrading from non-pkgdb-pkg_* | | 259 | This option is intended to be used for upgrading from non-pkgdb-pkg_* |
260 | tools to pkgdb-pkg_* tools, further manipulation of the pkgdb will be | | 260 | tools to pkgdb-pkg_* tools, further manipulation of the pkgdb will be |
261 | done by | | 261 | done by |
262 | .Xr pkg_add 1 , | | 262 | .Xr pkg_add 1 , |
263 | .Xr pkg_delete 1 , | | 263 | .Xr pkg_delete 1 , |
264 | and | | 264 | and |
265 | .Xr pkg_create 1 . | | 265 | .Xr pkg_create 1 . |
266 | .Pp | | 266 | .Pp |
267 | Needs to be run as root. | | 267 | Needs to be run as root. |
268 | .It Cm rebuild-tree | | 268 | .It Cm rebuild-tree |
269 | Rebuild the +REQUIRED_BY files from scratch by reresolving all dependencies. | | 269 | Rebuild the +REQUIRED_BY files from scratch by reresolving all dependencies. |
270 | .Pp | | 270 | .Pp |
271 | This option is intended to be used for fixing inconsistencies between | | 271 | This option is intended to be used for fixing inconsistencies between |
272 | the records of depending and depended-on packages, such as can arise | | 272 | the records of depending and depended-on packages, such as can arise |
273 | by the use of | | 273 | by the use of |
274 | .Cm pkg_delete -f . | | 274 | .Cm pkg_delete -f . |
275 | .It Cm set Ar variable=value pkg ... | | 275 | .It Cm set Ar variable=value pkg ... |
276 | Set variable with information about the installed package. | | 276 | Set variable with information about the installed package. |
277 | Use | | 277 | Use |
278 | .Cm unset | | 278 | .Cm unset |
279 | to remove a variable. | | 279 | to remove a variable. |
280 | .Pp | | 280 | .Pp |
281 | Packages that are not installed directly by the user but pulled in as | | 281 | Packages that are not installed directly by the user but pulled in as |
282 | dependencies are marked by setting | | 282 | dependencies are marked by setting |
283 | .Dq automatic=YES . | | 283 | .Dq automatic=YES . |
284 | .It Cm gpg-sign-package pkg | | 284 | .It Cm gpg-sign-package pkg |
285 | Sign the binary package | | 285 | Sign the binary package |
286 | .Ar pkg | | 286 | .Ar pkg |
287 | using GPG. | | 287 | using GPG. |
288 | .It Cm x509-sign-package pkg spkg key cert | | 288 | .It Cm x509-sign-package pkg spkg key cert |
289 | Sign the binary package | | 289 | Sign the binary package |
290 | .Ar pkg | | 290 | .Ar pkg |
291 | using the key | | 291 | using the key |
292 | .Ar key | | 292 | .Ar key |
293 | and the certificate | | 293 | and the certificate |
294 | .Ar cert , | | 294 | .Ar cert , |
295 | using | | 295 | using |
296 | .Ar spkg | | 296 | .Ar spkg |
297 | as output file. | | 297 | as output file. |
298 | .It Cm unset Ar variable pkg ... | | 298 | .It Cm unset Ar variable pkg ... |
299 | Remove an installation variable. | | 299 | Remove an installation variable. |
300 | .El | | 300 | .El |
301 | .Sh ENVIRONMENT | | 301 | .Sh ENVIRONMENT |
302 | .Bl -tag -width indent -compact | | 302 | .Bl -tag -width indent -compact |
303 | .It Ev PKG_DBDIR | | 303 | .It Ev PKG_DBDIR |
304 | If the | | 304 | If the |
305 | .Fl K | | 305 | .Fl K |
306 | flag isn't given, then | | 306 | flag isn't given, then |
307 | .Ev PKG_DBDIR | | 307 | .Ev PKG_DBDIR |
308 | is the location of the package database directory. | | 308 | is the location of the package database directory. |
309 | The default package database directory is | | 309 | The default package database directory is |
310 | .Pa /var/db/pkg . | | 310 | .Pa /var/db/pkg . |
311 | .El | | 311 | .El |
312 | .Sh CONFIGURATION VARIABLES | | 312 | .Sh CONFIGURATION VARIABLES |
313 | The following variables change the behavior of | | 313 | The following variables change the behavior of |
314 | .Nm | | 314 | .Nm |
315 | and are described in | | 315 | and are described in |
316 | .Xr pkg_install.conf 5 : | | 316 | .Xr pkg_install.conf 5 : |
317 | .Bl -tag -width CERTIFICATE_ANCHOR_PKGS | | 317 | .Bl -tag -width CERTIFICATE_ANCHOR_PKGS |
318 | .It Ev CERTIFICATE_ANCHOR_PKGS | | 318 | .It Ev CERTIFICATE_ANCHOR_PKGS |
319 | .It Ev CERTIFICATE_ANCHOR_PKGVULN | | 319 | .It Ev CERTIFICATE_ANCHOR_PKGVULN |
320 | .It Ev CERTIFICATE_CHAIN | | 320 | .It Ev CERTIFICATE_CHAIN |
321 | .It Ev GPG | | 321 | .It Ev GPG |
322 | .It Ev PKGVULNDIR | | 322 | .It Ev PKGVULNDIR |
323 | .It Ev PKGVULNURL | | 323 | .It Ev PKGVULNURL |
324 | .It Ev IGNORE_URL | | 324 | .It Ev IGNORE_URL |
325 | .El | | 325 | .El |
326 | .Sh FILES | | 326 | .Sh FILES |
327 | .Bl -tag -width /var/db/pkg/pkgdb.byfile.db -compact | | 327 | .Bl -tag -width /var/db/pkg/pkgdb.byfile.db -compact |
328 | .It Pa /var/db/pkg/pkgdb.byfile.db | | 328 | .It Pa /var/db/pkg/pkgdb.byfile.db |
329 | .It Pa /var/db/pkg/\*[Lt]pkg\*[Gt]/+CONTENTS | | 329 | .It Pa /var/db/pkg/\*[Lt]pkg\*[Gt]/+CONTENTS |
330 | .El | | 330 | .El |
331 | .Sh SEE ALSO | | 331 | .Sh SEE ALSO |
332 | .Xr pkg_add 1 , | | 332 | .Xr pkg_add 1 , |
333 | .Xr pkg_create 1 , | | 333 | .Xr pkg_create 1 , |
334 | .Xr pkg_delete 1 , | | 334 | .Xr pkg_delete 1 , |
335 | .Xr pkg_info 1 , | | 335 | .Xr pkg_info 1 , |
336 | .Xr pkg_view 1 , | | 336 | .Xr pkg_view 1 , |
337 | .Xr pkg_install.conf 5 , | | 337 | .Xr pkg_install.conf 5 , |
338 | .Xr pkgsrc 7 | | 338 | .Xr pkgsrc 7 |
339 | .Sh HISTORY | | 339 | .Sh HISTORY |
340 | The | | 340 | The |
341 | .Nm | | 341 | .Nm |
342 | command first appeared in | | 342 | command first appeared in |
343 | .Nx 1.4 . | | 343 | .Nx 1.4 . |
344 | .Sh AUTHORS | | 344 | .Sh AUTHORS |
345 | The | | 345 | The |
346 | .Nm | | 346 | .Nm |
347 | command was written by Hubert Feyrer. | | 347 | command was written by Hubert Feyrer. |