| @@ -1,14 +1,14 @@ | | | @@ -1,14 +1,14 @@ |
1 | .\" $NetBSD: pkg_chk.8,v 1.26 2008/05/02 19:10:26 apb Exp $ | | 1 | .\" $NetBSD: pkg_chk.8,v 1.27 2009/05/04 20:45:41 wiz Exp $ |
2 | .\" | | 2 | .\" |
3 | .\" Copyright (c) 2001 by David Brownlee (abs@NetBSD.org) | | 3 | .\" Copyright (c) 2001 by David Brownlee (abs@NetBSD.org) |
4 | .\" Absolutely no warranty. | | 4 | .\" Absolutely no warranty. |
5 | .\" | | 5 | .\" |
6 | .Dd May 2, 2008 | | 6 | .Dd May 2, 2008 |
7 | .Dt PKG_CHK 8 | | 7 | .Dt PKG_CHK 8 |
8 | .Sh NAME | | 8 | .Sh NAME |
9 | .Nm pkg_chk | | 9 | .Nm pkg_chk |
10 | .Nd check, and optionally update, installed packages | | 10 | .Nd check, and optionally update, installed packages |
11 | .Sh SYNOPSIS | | 11 | .Sh SYNOPSIS |
12 | .Nm | | 12 | .Nm |
13 | .Op Fl aBbcfhiklNnpqrsuv | | 13 | .Op Fl aBbcfhiklNnpqrsuv |
14 | .Op Fl C Ar conf | | 14 | .Op Fl C Ar conf |
| @@ -17,27 +17,26 @@ | | | @@ -17,27 +17,26 @@ |
17 | .Op Fl P Ar path | | 17 | .Op Fl P Ar path |
18 | .Op Fl U Ar tags | | 18 | .Op Fl U Ar tags |
19 | .Sh DESCRIPTION | | 19 | .Sh DESCRIPTION |
20 | .Nm | | 20 | .Nm |
21 | verifies that the versions of installed packages matches those in | | 21 | verifies that the versions of installed packages matches those in |
22 | pkgsrc, optionally adding missing or updating mismatched packages. | | 22 | pkgsrc, optionally adding missing or updating mismatched packages. |
23 | .Pp | | 23 | .Pp |
24 | It can verify all installed packages, or check against a set of packages | | 24 | It can verify all installed packages, or check against a set of packages |
25 | based on the hostname, architecture, and other characteristics. | | 25 | based on the hostname, architecture, and other characteristics. |
26 | .Pp | | 26 | .Pp |
27 | When updating packages that depend on each other | | 27 | When updating packages that depend on each other |
28 | .Nm | | 28 | .Nm |
29 | will skip dependent packages to reduce unnecessary rebuilding. | | 29 | will skip dependent packages to reduce unnecessary rebuilding. |
30 | .Pp | | | |
31 | .Ss Options | | 30 | .Ss Options |
32 | .Bl -tag -width xxxxxxxx | | 31 | .Bl -tag -width xxxxxxxx |
33 | .It Fl a | | 32 | .It Fl a |
34 | Automatically add any missing packages. | | 33 | Automatically add any missing packages. |
35 | If a binary package exists in | | 34 | If a binary package exists in |
36 | .Pa ${PACKAGES} | | 35 | .Pa ${PACKAGES} |
37 | it will be used in preference to building from source, unless the | | 36 | it will be used in preference to building from source, unless the |
38 | .Fl b | | 37 | .Fl b |
39 | or | | 38 | or |
40 | .Fl s | | 39 | .Fl s |
41 | options are given. | | 40 | options are given. |
42 | .It Fl B | | 41 | .It Fl B |
43 | Include the "Build version" (see option | | 42 | Include the "Build version" (see option |
| @@ -158,45 +157,45 @@ options are given. | | | @@ -158,45 +157,45 @@ options are given. |
158 | Note: If the update fails (particularly when building from source), the system | | 157 | Note: If the update fails (particularly when building from source), the system |
159 | will be left with missing packages. | | 158 | will be left with missing packages. |
160 | Once the error has been fixed, a second run will resume the update. | | 159 | Once the error has been fixed, a second run will resume the update. |
161 | .It Fl v | | 160 | .It Fl v |
162 | Verbose - list the tags set when checking | | 161 | Verbose - list the tags set when checking |
163 | .Pa pkgchk.conf , | | 162 | .Pa pkgchk.conf , |
164 | and all packages checked. | | 163 | and all packages checked. |
165 | .El | | 164 | .El |
166 | .Ss Deprecated Options | | 165 | .Ss Deprecated Options |
167 | .Bl -tag -width xxxxxxxx | | 166 | .Bl -tag -width xxxxxxxx |
168 | .It Fl c | | 167 | .It Fl c |
169 | Check versions of packages specified in | | 168 | Check versions of packages specified in |
170 | .Pa pkgchk.conf . | | 169 | .Pa pkgchk.conf . |
171 | This is a synomyn for | | 170 | This is a synonym for |
172 | .Nm | | 171 | .Nm |
173 | .Fl a q , | | 172 | .Fl a q , |
174 | and will be removed in a future version. | | 173 | and will be removed in a future version. |
175 | .It Fl i | | 174 | .It Fl i |
176 | Check versions of installed packages, ignoring | | 175 | Check versions of installed packages, ignoring |
177 | .Pa pkgchk.conf. | | 176 | .Pa pkgchk.conf . |
178 | This is a synomyn for | | 177 | This is a synonym for |
179 | .Fl u q , | | 178 | .Fl u q , |
180 | and will be removed in a future version. | | 179 | and will be removed in a future version. |
181 | .El | | 180 | .El |
182 | .Sh FILE FORMAT | | 181 | .Sh FILE FORMAT |
183 | Anything after a | | 182 | Anything after a |
184 | .Sq # | | 183 | .Sq # |
185 | on a line is considered a comment. | | 184 | on a line is considered a comment. |
186 | .Pp | | 185 | .Pp |
187 | Each line in | | 186 | Each line in |
188 | .Pa pkgchk.conf | | 187 | .Pa pkgchk.conf |
189 | can either define a new tag or a package directory | | 188 | can either define a new tag or a package directory |
190 | (such as sysutils/skill), in each case followed by a list of tags. | | 189 | (such as sysutils/skill), in each case followed by a list of tags. |
191 | .Ss New tag groups | | 190 | .Ss New tag groups |
192 | Lines that define a new tag can be used to group tags to avoid | | 191 | Lines that define a new tag can be used to group tags to avoid |
193 | repeating the same set of tags for multiple packages. | | 192 | repeating the same set of tags for multiple packages. |
194 | For example: | | 193 | For example: |
195 | .Dl mailserver \= tll gta tycoon jeeves iris | | 194 | .Dl mailserver \= tll gta tycoon jeeves iris |
196 | would cause the mailserver tag to be set for any of the listed hosts. | | 195 | would cause the mailserver tag to be set for any of the listed hosts. |
197 | Note that the tags after the | | 196 | Note that the tags after the |
198 | .Sq = | | 197 | .Sq = |
199 | are parsed with the same set of tag | | 198 | are parsed with the same set of tag |
200 | evaluation rules as those after package definitions (see later). | | 199 | evaluation rules as those after package definitions (see later). |
201 | .Ss Package definition lines | | 200 | .Ss Package definition lines |
202 | Package directory lines are used to determine which packages are to be | | 201 | Package directory lines are used to determine which packages are to be |