| @@ -1,14 +1,14 @@ | | | @@ -1,14 +1,14 @@ |
1 | .\" $NetBSD: pkg_comp.8,v 1.35 2010/04/15 09:42:45 jmmv Exp $ | | 1 | .\" $NetBSD: pkg_comp.8,v 1.36 2012/02/27 22:42:27 jmmv Exp $ |
2 | .\" | | 2 | .\" |
3 | .\" pkg_comp - Build packages inside a clean chroot environment | | 3 | .\" pkg_comp - Build packages inside a clean chroot environment |
4 | .\" Copyright (c) 2002, 2003, 2004, 2005 Julio M. Merino Vidal <jmmv@NetBSD.org> | | 4 | .\" Copyright (c) 2002, 2003, 2004, 2005 Julio M. Merino Vidal <jmmv@NetBSD.org> |
5 | .\" | | 5 | .\" |
6 | .\" Redistribution and use in source and binary forms, with or without | | 6 | .\" Redistribution and use in source and binary forms, with or without |
7 | .\" modification, are permitted provided that the following conditions | | 7 | .\" modification, are permitted provided that the following conditions |
8 | .\" are met: | | 8 | .\" are met: |
9 | .\" 1. Redistributions of source code must retain the above copyright | | 9 | .\" 1. Redistributions of source code must retain the above copyright |
10 | .\" notice, this list of conditions and the following disclaimer. | | 10 | .\" notice, this list of conditions and the following disclaimer. |
11 | .\" 2. Neither the name of The NetBSD Foundation nor the names of its | | 11 | .\" 2. Neither the name of The NetBSD Foundation nor the names of its |
12 | .\" contributors may be used to endorse or promote products derived | | 12 | .\" contributors may be used to endorse or promote products derived |
13 | .\" from this software without specific prior written permission. | | 13 | .\" from this software without specific prior written permission. |
14 | .\" 3. Neither the name of author nor the names of its contributors may | | 14 | .\" 3. Neither the name of author nor the names of its contributors may |
| @@ -17,27 +17,27 @@ | | | @@ -17,27 +17,27 @@ |
17 | .\" | | 17 | .\" |
18 | .\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS | | 18 | .\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS |
19 | .\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED | | 19 | .\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED |
20 | .\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR | | 20 | .\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR |
21 | .\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS | | 21 | .\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS |
22 | .\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR | | 22 | .\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR |
23 | .\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF | | 23 | .\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF |
24 | .\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS | | 24 | .\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS |
25 | .\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN | | 25 | .\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN |
26 | .\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) | | 26 | .\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) |
27 | .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE | | 27 | .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE |
28 | .\" POSSIBILITY OF SUCH DAMAGE. | | 28 | .\" POSSIBILITY OF SUCH DAMAGE. |
29 | .\" | | 29 | .\" |
30 | .Dd April 15, 2010 | | 30 | .Dd February 27, 2012 |
31 | .Dt PKG_COMP 8 | | 31 | .Dt PKG_COMP 8 |
32 | .Os | | 32 | .Os |
33 | .Sh NAME | | 33 | .Sh NAME |
34 | .Nm pkg_comp | | 34 | .Nm pkg_comp |
35 | .Nd build packages inside a sandbox | | 35 | .Nd build packages inside a sandbox |
36 | .Sh SYNOPSIS | | 36 | .Sh SYNOPSIS |
37 | .Nm | | 37 | .Nm |
38 | .Oo Fl Po | | 38 | .Oo Fl Po |
39 | .Cm c Ns \&| Ns Cm C | | 39 | .Cm c Ns \&| Ns Cm C |
40 | .Pc | | 40 | .Pc |
41 | .Ar conf_file | | 41 | .Ar conf_file |
42 | .Oc | | 42 | .Oc |
43 | .Op Fl Nn | | 43 | .Op Fl Nn |
| @@ -145,45 +145,55 @@ Alternatively you can specify any pathna | | | @@ -145,45 +145,55 @@ Alternatively you can specify any pathna |
145 | with the argument of the | | 145 | with the argument of the |
146 | .Fl C | | 146 | .Fl C |
147 | option. | | 147 | option. |
148 | .Pp | | 148 | .Pp |
149 | Configuration files are simple shell scripts that define | | 149 | Configuration files are simple shell scripts that define |
150 | variables. | | 150 | variables. |
151 | The default values shown here are those written in the template when | | 151 | The default values shown here are those written in the template when |
152 | issuing a maketemplate. | | 152 | issuing a maketemplate. |
153 | .Bl -tag -width indent | | 153 | .Bl -tag -width indent |
154 | .It AUTO_PACKAGES | | 154 | .It AUTO_PACKAGES |
155 | A list of packages to automatically build during the | | 155 | A list of packages to automatically build during the |
156 | .Sy auto | | 156 | .Sy auto |
157 | target. | | 157 | target. |
158 | A package is in the form section/name, like misc/colorls. | | 158 | A package is in the form |
| | | 159 | .Sq section/name , |
| | | 160 | like |
| | | 161 | .Sq misc/colorls , |
| | | 162 | or a plain name like |
| | | 163 | .Sq colorls . |
159 | Defaults to nothing. | | 164 | Defaults to nothing. |
160 | .It AUTO_TARGET | | 165 | .It AUTO_TARGET |
161 | The pkgsrc target to use when building packages in an automated fashion | | 166 | The pkgsrc target to use when building packages in an automated fashion |
162 | (using the | | 167 | (using the |
163 | .Ql auto | | 168 | .Ql auto |
164 | target). | | 169 | target). |
165 | Should be set to | | 170 | Should be set to |
166 | .Ql package | | 171 | .Ql package |
167 | or | | 172 | or |
168 | .Ql bin-install , | | 173 | .Ql bin-install , |
169 | as other values are useless. | | 174 | as other values are useless. |
170 | Defaults to | | 175 | Defaults to |
171 | .Ql package . | | 176 | .Ql package . |
172 | .It BUILD_PACKAGES | | 177 | .It BUILD_PACKAGES |
173 | A list of packages to automatically build after the | | 178 | A list of packages to automatically build after the |
174 | .Sy makeroot | | 179 | .Sy makeroot |
175 | target. | | 180 | target. |
176 | A package is in the form section/name, like misc/colorls. | | 181 | A package is in the form |
| | | 182 | .Sq section/name , |
| | | 183 | like |
| | | 184 | .Sq misc/colorls , |
| | | 185 | or a plain name like |
| | | 186 | .Sq colorls . |
177 | Defaults to nothing. | | 187 | Defaults to nothing. |
178 | .It BUILD_TARGET | | 188 | .It BUILD_TARGET |
179 | The pkgsrc target to use when building packages. | | 189 | The pkgsrc target to use when building packages. |
180 | It can contain any target supported by the pkgsrc system, but | | 190 | It can contain any target supported by the pkgsrc system, but |
181 | reasonable values are: | | 191 | reasonable values are: |
182 | .Ql install , | | 192 | .Ql install , |
183 | .Ql package | | 193 | .Ql package |
184 | and | | 194 | and |
185 | .Ql bin-install . | | 195 | .Ql bin-install . |
186 | Defaults to | | 196 | Defaults to |
187 | .Ql package . | | 197 | .Ql package . |
188 | .It COPYROOTCFG | | 198 | .It COPYROOTCFG |
189 | If set to | | 199 | If set to |
| @@ -465,28 +475,28 @@ should do (as in make). | | | @@ -465,28 +475,28 @@ should do (as in make). |
465 | The following list describes all supported targets, | | 475 | The following list describes all supported targets, |
466 | in the logical order you should call them. | | 476 | in the logical order you should call them. |
467 | .Bl -tag -width indent | | 477 | .Bl -tag -width indent |
468 | .It maketemplate | | 478 | .It maketemplate |
469 | Create a sample | | 479 | Create a sample |
470 | .Ar conf_file . | | 480 | .Ar conf_file . |
471 | You should edit it after the creation as you will probably want to change | | 481 | You should edit it after the creation as you will probably want to change |
472 | the default configuration, specially paths. | | 482 | the default configuration, specially paths. |
473 | .It makeroot | | 483 | .It makeroot |
474 | Create the chroot environment, based on the specs of the configuration file. | | 484 | Create the chroot environment, based on the specs of the configuration file. |
475 | This step is required before trying any other, except maketemplate. | | 485 | This step is required before trying any other, except maketemplate. |
476 | .It build | | 486 | .It build |
477 | Builds the specified packages inside the chroot. | | 487 | Builds the specified packages inside the chroot. |
478 | You need to pass their names as relative paths inside pkgsrc, like | | 488 | You can pass the package names as a relative path within pkgsrc or as the |
479 | .Pa pkgtools/pkg_comp . | | 489 | basename of the package directory (i.e. omitting the directory name). |
480 | .It install | | 490 | .It install |
481 | Install the specified binary packages into the chroot. | | 491 | Install the specified binary packages into the chroot. |
482 | Package names can contain globs. | | 492 | Package names can contain globs. |
483 | The package files will be taken from within | | 493 | The package files will be taken from within |
484 | .Sy REAL_PACKAGES . | | 494 | .Sy REAL_PACKAGES . |
485 | .It chroot | | 495 | .It chroot |
486 | Enters the chroot environment. | | 496 | Enters the chroot environment. |
487 | If no arguments are given, | | 497 | If no arguments are given, |
488 | .Va ROOTSHELL | | 498 | .Va ROOTSHELL |
489 | is executed, otherwise whatever you typed. | | 499 | is executed, otherwise whatever you typed. |
490 | If the first argument begins with a word prefixed by | | 500 | If the first argument begins with a word prefixed by |
491 | .Li pkg_ , | | 501 | .Li pkg_ , |
492 | then the | | 502 | then the |