| @@ -1,14 +1,14 @@ | | | @@ -1,14 +1,14 @@ |
1 | .\" $NetBSD: mk.conf.5,v 1.101 2023/06/05 22:35:20 lukem Exp $ | | 1 | .\" $NetBSD: mk.conf.5,v 1.102 2023/06/11 10:44:33 lukem Exp $ |
2 | .\" | | 2 | .\" |
3 | .\" Copyright (c) 1999-2023 The NetBSD Foundation, Inc. | | 3 | .\" Copyright (c) 1999-2023 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 Luke Mewburn. | | 7 | .\" by Luke Mewburn. |
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 |
| @@ -17,48 +17,54 @@ | | | @@ -17,48 +17,54 @@ |
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 June 5, 2023 | | 30 | .Dd June 11, 2023 |
31 | .Dt MK.CONF 5 | | 31 | .Dt MK.CONF 5 |
32 | .Os | | 32 | .Os |
33 | .\" turn off hyphenation | | 33 | .\" turn off hyphenation |
34 | .hym 999 | | 34 | .hym 999 |
35 | . | | 35 | . |
36 | .Sh NAME | | 36 | .Sh NAME |
37 | .Nm mk.conf | | 37 | .Nm mk.conf |
38 | .Nd make configuration file | | 38 | .Nd make configuration file |
39 | . | | 39 | . |
40 | .Sh DESCRIPTION | | 40 | .Sh DESCRIPTION |
41 | The | | 41 | The |
42 | .Nm | | 42 | .Nm |
43 | file overrides various parameters used during the build of the system. | | 43 | file overrides various parameters used during the build of the system. |
44 | .Pp | | 44 | . |
| | | 45 | .Sh NETBSD SYSTEM VARIABLES |
| | | 46 | . |
45 | Listed below are the | | 47 | Listed below are the |
46 | .Nm | | 48 | .Nm |
47 | variables that may be set, the values to which each may be set, | | 49 | variables that may be set that affect the |
48 | a brief description of what each variable does, and a reference to | | 50 | .Nx NetBSD |
49 | relevant manual pages. | | 51 | system build, |
50 | . | | 52 | the values to which each may be set, |
51 | .Ss NetBSD System variables | | 53 | a brief description of what each variable does, |
| | | 54 | references to relevant manual pages, |
| | | 55 | notes (including any interaction with |
| | | 56 | .Sy build.sh ) , |
| | | 57 | and the default value of each variable. |
52 | . | | 58 | . |
53 | .de DFLT | | 59 | .de DFLT |
54 | .Pp | | 60 | .Pp |
55 | .Em Default : | | 61 | .Em Default : |
56 | .. | | 62 | .. |
57 | .de DFLTn | | 63 | .de DFLTn |
58 | .DFLT | | 64 | .DFLT |
59 | .Dq no | | 65 | .Dq no |
60 | .. | | 66 | .. |
61 | .de DFLTu | | 67 | .de DFLTu |
62 | .DFLT | | 68 | .DFLT |
63 | Unset. | | 69 | Unset. |
64 | .. | | 70 | .. |
| @@ -180,60 +186,65 @@ rather than explicitly set. | | | @@ -180,60 +186,65 @@ rather than explicitly set. |
180 | .Em Note : | | 186 | .Em Note : |
181 | .Sy CPUFLAGS , | | 187 | .Sy CPUFLAGS , |
182 | not | | 188 | not |
183 | .Sy COPTS , | | 189 | .Sy COPTS , |
184 | should be used for | | 190 | should be used for |
185 | compiler flags that select CPU-related options. | | 191 | compiler flags that select CPU-related options. |
186 | .Pp | | 192 | .Pp |
187 | .Em Note : | | 193 | .Em Note : |
188 | .Sy CFLAGS | | 194 | .Sy CFLAGS |
189 | should never be set in | | 195 | should never be set in |
190 | .Nm . | | 196 | .Nm . |
191 | . | | 197 | . |
192 | .It Sy CPUFLAGS | | 198 | .It Sy CPUFLAGS |
193 | Additional flags passed to the compiler/assembler to select | | 199 | Additional options passed to the compiler/assembler to select |
194 | CPU instruction set options, CPU tuning options, etc. | | 200 | CPU instruction set options, CPU tuning options, etc. |
| | | 201 | .Pp |
| | | 202 | .Em Note : |
195 | Such options should not be specified in | | 203 | Such options should not be specified in |
196 | .Sy COPTS , | | 204 | .Sy COPTS , |
197 | because some parts of the build process need to override | | 205 | because some parts of the build process need to override |
198 | CPU-related compiler options. | | 206 | CPU-related compiler options. |
| | | 207 | .DFLTu |
199 | . | | 208 | . |
200 | .It Sy DESTDIR | | 209 | .It Sy DESTDIR |
201 | Directory to contain the built | | 210 | Directory to contain the built |
202 | .Nx | | 211 | .Nx |
203 | system. | | 212 | system. |
204 | If set, special options are passed to the compilation tools to | | 213 | If set, special options are passed to the compilation tools to |
205 | prevent their default use of the host system's | | 214 | prevent their default use of the host system's |
206 | .Sy /usr/include , /usr/lib , | | 215 | .Sy /usr/include , /usr/lib , |
207 | and so forth. | | 216 | and so forth. |
208 | This pathname should | | 217 | This pathname must be an absolute path, and should |
209 | .Em not | | 218 | .Em not |
210 | end with a slash | | 219 | end with a slash |
211 | .Pq / | | 220 | .Pq / |
212 | character (for installation into the system's root directory, set | | 221 | character. |
| | | 222 | (For installation into the system's root directory, set |
213 | .Sy DESTDIR | | 223 | .Sy DESTDIR |
214 | to an empty string). | | 224 | to an empty string, not to |
| | | 225 | .Dq / ) . |
215 | The directory must reside on a file system which supports long file | | 226 | The directory must reside on a file system which supports long file |
216 | names and hard links. | | 227 | names and hard links. |
217 | .Pp | | 228 | .Pp |
218 | .Em Note : | | 229 | .Em Note : |
219 | .Sy build.sh | | 230 | .Sy build.sh |
220 | will provide a default of | | 231 | will provide a default of |
221 | .Dq Pa destdir . Ns Sy MACHINE | | 232 | .Dq Pa destdir . Ns Sy MACHINE |
222 | (in the top-level | | 233 | (in the top-level |
223 | .Sy .OBJDIR ) | | 234 | .Sy .OBJDIR ) |
224 | unless run in | | 235 | unless run in |
225 | .Sq expert | | 236 | .Sq expert |
226 | mode | | 237 | mode. |
227 | .DFLT | | 238 | .DFLT |
228 | Empty string if | | 239 | Empty string if |
229 | .Sy USETOOLS=yes ; | | 240 | .Sy USETOOLS=yes ; |
230 | unset otherwise. | | 241 | unset otherwise. |
231 | . | | 242 | . |
232 | .It Sy EXTERNAL_TOOLCHAIN | | 243 | .It Sy EXTERNAL_TOOLCHAIN |
233 | If defined, this variable indicates the root directory of | | 244 | If defined, this variable indicates the root directory of |
234 | an external toolchain which will be used to build the tree. | | 245 | an external toolchain which will be used to build the tree. |
235 | For example, if a platform is a | | 246 | For example, if a platform is a |
236 | .Sy TOOLCHAIN_MISSING | | 247 | .Sy TOOLCHAIN_MISSING |
237 | platform, | | 248 | platform, |
238 | .Sy EXTERNAL_TOOLCHAIN | | 249 | .Sy EXTERNAL_TOOLCHAIN |
239 | can be used to re-enable the cross-compile framework. | | 250 | can be used to re-enable the cross-compile framework. |
| @@ -247,28 +258,47 @@ able to build the library components of | | | @@ -247,28 +258,47 @@ able to build the library components of |
247 | .Pp | | 258 | .Pp |
248 | This variable should be used in conjunction with an appropriate | | 259 | This variable should be used in conjunction with an appropriate |
249 | .Sy HAVE_GCC | | 260 | .Sy HAVE_GCC |
250 | or | | 261 | or |
251 | .Sy HAVE_LLVM | | 262 | .Sy HAVE_LLVM |
252 | setting to control the compiler flags. | | 263 | setting to control the compiler flags. |
253 | .Pp | | 264 | .Pp |
254 | .Em Note : | | 265 | .Em Note : |
255 | This variable is not yet used in as many places as it should be. | | 266 | This variable is not yet used in as many places as it should be. |
256 | Expect the exact semantics of this variable to change in the short | | 267 | Expect the exact semantics of this variable to change in the short |
257 | term as parts of the cross-compile framework continue to be cleaned up. | | 268 | term as parts of the cross-compile framework continue to be cleaned up. |
258 | .DFLTu | | 269 | .DFLTu |
259 | . | | 270 | . |
260 | .It Sy EXTSRCSRCDIR | | 271 | .It Sy INSTALLBOOT_BOARDS |
261 | Obsolete. | | 272 | A list of |
| | | 273 | .Sy evbarm |
| | | 274 | boards to create bootable images for. |
| | | 275 | If corresponding U-Boot packages are installed, |
| | | 276 | bootable images are created as part of a release. |
| | | 277 | See the |
| | | 278 | .Bk -words |
| | | 279 | .Fl o Sy board= Ns Ar name |
| | | 280 | .Ek |
| | | 281 | option of |
| | | 282 | .Xr installboot 8 . |
| | | 283 | .DFLTu |
| | | 284 | . |
| | | 285 | .It Sy INSTALLWORLDDIR |
| | | 286 | Location for the top-level |
| | | 287 | .Dq make installworld |
| | | 288 | target to install to. |
| | | 289 | If specified, must be an absolute path. |
| | | 290 | .DFLT |
| | | 291 | .Dq / |
262 | . | | 292 | . |
263 | .It Sy KERNEL_DIR Pq No experimental | | 293 | .It Sy KERNEL_DIR Pq No experimental |
264 | .YorN | | 294 | .YorN |
265 | Indicates if a top-level directory | | 295 | Indicates if a top-level directory |
266 | .Sy /netbsd/ | | 296 | .Sy /netbsd/ |
267 | is created. | | 297 | is created. |
268 | If | | 298 | If |
269 | .Dq yes , | | 299 | .Dq yes , |
270 | the directory will contain a kernel file | | 300 | the directory will contain a kernel file |
271 | .Pa /netbsd/kernel | | 301 | .Pa /netbsd/kernel |
272 | and a corresponding modules directory | | 302 | and a corresponding modules directory |
273 | .Pa /netbsd/modules/ . | | 303 | .Pa /netbsd/modules/ . |
274 | System bootstrap procedures will be modified to search for the kernel | | 304 | System bootstrap procedures will be modified to search for the kernel |
| @@ -293,37 +323,37 @@ It is also subject to change without not | | | @@ -293,37 +323,37 @@ It is also subject to change without not |
293 | .DFLTn | | 323 | .DFLTn |
294 | .It Sy MAKEVERBOSE | | 324 | .It Sy MAKEVERBOSE |
295 | Level of verbosity of status messages. | | 325 | Level of verbosity of status messages. |
296 | Supported values: | | 326 | Supported values: |
297 | .Bl -tag -width 2n | | 327 | .Bl -tag -width 2n |
298 | .It 0 | | 328 | .It 0 |
299 | No descriptive messages or commands executed by | | 329 | No descriptive messages or commands executed by |
300 | .Xr make 1 | | 330 | .Xr make 1 |
301 | are shown. | | 331 | are shown. |
302 | .It 1 | | 332 | .It 1 |
303 | Brief messages are shown describing what is being done, | | 333 | Brief messages are shown describing what is being done, |
304 | but the actual commands executed by | | 334 | but the actual commands executed by |
305 | .Xr make 1 | | 335 | .Xr make 1 |
306 | are not displayed. | | 336 | are not shown. |
307 | .It 2 | | 337 | .It 2 |
308 | Descriptive messages are shown as above (prefixed with a | | 338 | Descriptive messages are shown as above (prefixed with a |
309 | .Sq # ) , | | 339 | .Sq # ) , |
310 | and ordinary commands performed by | | 340 | and ordinary commands performed by |
311 | .Xr make 1 | | 341 | .Xr make 1 |
312 | are displayed. | | 342 | are shown. |
313 | .It 3 | | 343 | .It 3 |
314 | In addition to the above, all commands performed by | | 344 | In addition to the above, all commands performed by |
315 | .Xr make 1 | | 345 | .Xr make 1 |
316 | are displayed, even if they would ordinarily have been hidden | | 346 | are shown, even if they would ordinarily have been hidden |
317 | through use of the | | 347 | through use of the |
318 | .Dq \&@ | | 348 | .Dq \&@ |
319 | prefix in the relevant makefile. | | 349 | prefix in the relevant makefile. |
320 | .It 4 | | 350 | .It 4 |
321 | In addition to the above, commands executed by | | 351 | In addition to the above, commands executed by |
322 | .Xr make 1 | | 352 | .Xr make 1 |
323 | are traced through use of the | | 353 | are traced through use of the |
324 | .Xr sh 1 | | 354 | .Xr sh 1 |
325 | .Dq Fl x | | 355 | .Dq Fl x |
326 | flag. | | 356 | flag. |
327 | .El | | 357 | .El |
328 | .DFLT | | 358 | .DFLT |
329 | 2 | | 359 | 2 |
| @@ -361,30 +391,26 @@ The value of | | | @@ -361,30 +391,26 @@ The value of |
361 | .Dq no . | | 391 | .Dq no . |
362 | . | | 392 | . |
363 | .It Sy MKATF | | 393 | .It Sy MKATF |
364 | .YorN | | 394 | .YorN |
365 | Indicates whether the Automated Testing Framework (ATF) | | 395 | Indicates whether the Automated Testing Framework (ATF) |
366 | will be built and installed. | | 396 | will be built and installed. |
367 | This also controls whether the | | 397 | This also controls whether the |
368 | .Nx | | 398 | .Nx |
369 | test suite will be built and installed, | | 399 | test suite will be built and installed, |
370 | as the tests rely on ATF and cannot be built without it. | | 400 | as the tests rely on ATF and cannot be built without it. |
371 | .NOVAR MKCXX=no | | 401 | .NOVAR MKCXX=no |
372 | .DFLTy | | 402 | .DFLTy |
373 | . | | 403 | . |
374 | .It Sy MKBFD | | | |
375 | Obsolete, use | | | |
376 | .Sy MKBINUTILS . | | | |
377 | . | | | |
378 | .It Sy MKBINUTILS | | 404 | .It Sy MKBINUTILS |
379 | .YorN | | 405 | .YorN |
380 | Indicates whether any of the binutils tools or libraries | | 406 | Indicates whether any of the binutils tools or libraries |
381 | will be built and installed. | | 407 | will be built and installed. |
382 | That is, the libraries | | 408 | That is, the libraries |
383 | .Sy libbfd , | | 409 | .Sy libbfd , |
384 | .Sy libiberty , | | 410 | .Sy libiberty , |
385 | or any of the things that depend upon them, e.g. | | 411 | or any of the things that depend upon them, e.g. |
386 | .Xr as 1 , | | 412 | .Xr as 1 , |
387 | .Xr ld 1 , | | 413 | .Xr ld 1 , |
388 | .Xr dbsym 8 , | | 414 | .Xr dbsym 8 , |
389 | or | | 415 | or |
390 | .Xr mdsetimage 8 . | | 416 | .Xr mdsetimage 8 . |
| @@ -523,29 +549,26 @@ Indicates whether the X11 libraries will | | | @@ -523,29 +549,26 @@ Indicates whether the X11 libraries will |
523 | .It Sy MKCOMPLEX | | 549 | .It Sy MKCOMPLEX |
524 | .YorN | | 550 | .YorN |
525 | Indicates whether the | | 551 | Indicates whether the |
526 | .Lb libm | | 552 | .Lb libm |
527 | is compiled with support for | | 553 | is compiled with support for |
528 | .In complex.h . | | 554 | .In complex.h . |
529 | .DFLTy | | 555 | .DFLTy |
530 | . | | 556 | . |
531 | .It Sy MKCROSSGDB | | 557 | .It Sy MKCROSSGDB |
532 | .YorN | | 558 | .YorN |
533 | Create a cross-gdb as a host tool. | | 559 | Create a cross-gdb as a host tool. |
534 | .DFLTn | | 560 | .DFLTn |
535 | . | | 561 | . |
536 | .It Sy MKCRYPTO | | | |
537 | Obsolete. | | | |
538 | . | | | |
539 | .It Sy MKCTF | | 562 | .It Sy MKCTF |
540 | .YorN | | 563 | .YorN |
541 | Indicates whether CTF tools are to be built and installed. | | 564 | Indicates whether CTF tools are to be built and installed. |
542 | If | | 565 | If |
543 | .Dq yes , | | 566 | .Dq yes , |
544 | the tools will be used to generate and manipulate | | 567 | the tools will be used to generate and manipulate |
545 | CTF data of ELF binaries during build. | | 568 | CTF data of ELF binaries during build. |
546 | .NODEF NOCTF | | 569 | .NODEF NOCTF |
547 | .Pp | | 570 | .Pp |
548 | This is disabled internally for standalone programs in | | 571 | This is disabled internally for standalone programs in |
549 | .Pa /usr/mdec . | | 572 | .Pa /usr/mdec . |
550 | .DFLTy | | 573 | .DFLTy |
551 | on | | 574 | on |
| @@ -690,29 +713,26 @@ into | | | @@ -690,29 +713,26 @@ into |
690 | If | | 713 | If |
691 | .Dq no , | | 714 | .Dq no , |
692 | link programs in | | 715 | link programs in |
693 | .Pa /bin | | 716 | .Pa /bin |
694 | and | | 717 | and |
695 | .Pa /sbin | | 718 | .Pa /sbin |
696 | statically. | | 719 | statically. |
697 | .DFLTn | | 720 | .DFLTn |
698 | on | | 721 | on |
699 | .Sy ia64 ; | | 722 | .Sy ia64 ; |
700 | .Dq yes | | 723 | .Dq yes |
701 | on other platforms. | | 724 | on other platforms. |
702 | . | | 725 | . |
703 | .It Sy MKEXTSRC | | | |
704 | Obsolete. | | | |
705 | . | | | |
706 | .It Sy MKFIRMWARE | | 726 | .It Sy MKFIRMWARE |
707 | .YorN | | 727 | .YorN |
708 | Indicates whether to install the | | 728 | Indicates whether to install the |
709 | .Pa /libdata/firmware | | 729 | .Pa /libdata/firmware |
710 | directory, which is necessary for various drivers, including: | | 730 | directory, which is necessary for various drivers, including: |
711 | .Xr athn 4 , | | 731 | .Xr athn 4 , |
712 | .Xr bcm43xx 4 , | | 732 | .Xr bcm43xx 4 , |
713 | .Xr bwfm 4 , | | 733 | .Xr bwfm 4 , |
714 | .Xr ipw 4 , | | 734 | .Xr ipw 4 , |
715 | .Xr iwi 4 , | | 735 | .Xr iwi 4 , |
716 | .Xr iwm 4 , | | 736 | .Xr iwm 4 , |
717 | .Xr iwn 4 , | | 737 | .Xr iwn 4 , |
718 | .Xr otus 4 , | | 738 | .Xr otus 4 , |
| @@ -809,31 +829,32 @@ Indicates whether the Hesiod infrastruct | | | @@ -809,31 +829,32 @@ Indicates whether the Hesiod infrastruct |
809 | (libraries and support programs) will be built and installed. | | 829 | (libraries and support programs) will be built and installed. |
810 | .DFLTy | | 830 | .DFLTy |
811 | . | | 831 | . |
812 | .It Sy MKHOSTOBJ | | 832 | .It Sy MKHOSTOBJ |
813 | .YorN | | 833 | .YorN |
814 | If | | 834 | If |
815 | .Dq yes , | | 835 | .Dq yes , |
816 | then for programs intended to be run on the compile host, | | 836 | then for programs intended to be run on the compile host, |
817 | the name, release, and architecture of the host operating system | | 837 | the name, release, and architecture of the host operating system |
818 | will be suffixed to the name of the object directory created by | | 838 | will be suffixed to the name of the object directory created by |
819 | .Dq make obj . | | 839 | .Dq make obj . |
820 | (This allows multiple host systems to compile | | 840 | (This allows multiple host systems to compile |
821 | .Nx | | 841 | .Nx |
822 | for a single target.) | | 842 | for a single target architecture.) |
823 | If | | 843 | If |
824 | .Dq no , | | 844 | .Dq no , |
825 | then programs built to be run on the compile host will use the same | | 845 | then programs built to be run on the compile host will use the same |
826 | object directory names as programs built to be run on the target. | | 846 | object directory names as programs built to be run on the target |
| | | 847 | architecture. |
827 | .DFLTn | | 848 | .DFLTn |
828 | . | | 849 | . |
829 | .It Sy MKHTML | | 850 | .It Sy MKHTML |
830 | .YorN | | 851 | .YorN |
831 | Indicates whether the HTML manual pages are created and installed. | | 852 | Indicates whether the HTML manual pages are created and installed. |
832 | .NODEF NOHTML | | 853 | .NODEF NOHTML |
833 | .NOVAR MKMAN=no No or Sy MKSHARE=no | | 854 | .NOVAR MKMAN=no No or Sy MKSHARE=no |
834 | .DFLTy | | 855 | .DFLTy |
835 | . | | 856 | . |
836 | .It Sy MKIEEEFP | | 857 | .It Sy MKIEEEFP |
837 | .YorN | | 858 | .YorN |
838 | Indicates whether code for IEEE754/IEC60559 conformance | | 859 | Indicates whether code for IEEE754/IEC60559 conformance |
839 | will be built and installed. | | 860 | will be built and installed. |
| @@ -868,48 +889,41 @@ Indicates whether the | | | @@ -868,48 +889,41 @@ Indicates whether the |
868 | programs, headers, and other components will be built and installed. | | 889 | programs, headers, and other components will be built and installed. |
869 | .DFLTy | | 890 | .DFLTy |
870 | . | | 891 | . |
871 | .It Sy MKISCSI | | 892 | .It Sy MKISCSI |
872 | .YorN | | 893 | .YorN |
873 | Indicates whether the iSCSI library and applications are | | 894 | Indicates whether the iSCSI library and applications are |
874 | built and installed. | | 895 | built and installed. |
875 | .DFLTn | | 896 | .DFLTn |
876 | on | | 897 | on |
877 | .Sy m68000 ; | | 898 | .Sy m68000 ; |
878 | .Dq yes | | 899 | .Dq yes |
879 | on other platforms. | | 900 | on other platforms. |
880 | . | | 901 | . |
881 | .It Sy MKKDEBUG | | | |
882 | Deprecated, use | | | |
883 | .Sy MKDEBUGKERNEL . | | | |
884 | . | | | |
885 | .It Sy MKKERBEROS | | 902 | .It Sy MKKERBEROS |
886 | .YorN | | 903 | .YorN |
887 | Indicates whether the Kerberos v5 infrastructure | | 904 | Indicates whether the Kerberos v5 infrastructure |
888 | (libraries and support programs) will be built and installed. | | 905 | (libraries and support programs) will be built and installed. |
889 | Caution: the default | | 906 | Caution: the default |
890 | .Xr pam 8 | | 907 | .Xr pam 8 |
891 | configuration requires that Kerberos be present even if not used. | | 908 | configuration requires that Kerberos be present even if not used. |
892 | Do not install a userland without Kerberos without also either | | 909 | Do not install a userland without Kerberos without also either |
893 | updating the | | 910 | updating the |
894 | .Xr pam.conf 5 | | 911 | .Xr pam.conf 5 |
895 | files or disabling PAM via | | 912 | files or disabling PAM via |
896 | .Sy MKPAM . | | 913 | .Sy MKPAM . |
897 | Otherwise all logins will fail. | | 914 | Otherwise all logins will fail. |
898 | .DFLTy | | 915 | .DFLTy |
899 | . | | 916 | . |
900 | .It Sy MKKERBEROS4 | | | |
901 | Obsolete. | | | |
902 | . | | | |
903 | .It Sy MKKMOD | | 917 | .It Sy MKKMOD |
904 | .YorN | | 918 | .YorN |
905 | Indicates whether kernel modules will be built and installed. | | 919 | Indicates whether kernel modules will be built and installed. |
906 | .DFLTn | | 920 | .DFLTn |
907 | on | | 921 | on |
908 | .Sy or1k ; | | 922 | .Sy or1k ; |
909 | .Dq yes | | 923 | .Dq yes |
910 | on other platforms. | | 924 | on other platforms. |
911 | . | | 925 | . |
912 | .It Sy MKKYUA | | 926 | .It Sy MKKYUA |
913 | .YorN | | 927 | .YorN |
914 | Indicates whether Kyua (the testing infrastructure used by | | 928 | Indicates whether Kyua (the testing infrastructure used by |
915 | .Nx ) | | 929 | .Nx ) |
| @@ -999,32 +1013,26 @@ acts as | | | @@ -999,32 +1013,26 @@ acts as |
999 | .It Sy MKLINT | | 1013 | .It Sy MKLINT |
1000 | .YorN | | 1014 | .YorN |
1001 | Indicates whether | | 1015 | Indicates whether |
1002 | .Xr lint 1 | | 1016 | .Xr lint 1 |
1003 | will be run against portions of the | | 1017 | will be run against portions of the |
1004 | .Nx | | 1018 | .Nx |
1005 | source code during the build, and whether lint libraries will be | | 1019 | source code during the build, and whether lint libraries will be |
1006 | installed into | | 1020 | installed into |
1007 | .Sy DESTDIR Ns Pa /usr/libdata/lint . | | 1021 | .Sy DESTDIR Ns Pa /usr/libdata/lint . |
1008 | .NODEF NOLINT | | 1022 | .NODEF NOLINT |
1009 | .NOVAR MKLINKLIB=no | | 1023 | .NOVAR MKLINKLIB=no |
1010 | .DFLTn | | 1024 | .DFLTn |
1011 | . | | 1025 | . |
1012 | .It Sy MKLLD | | | |
1013 | Obsolete. | | | |
1014 | . | | | |
1015 | .It Sy MKLLDB | | | |
1016 | Obsolete. | | | |
1017 | . | | | |
1018 | .It Sy MKLLVM | | 1026 | .It Sy MKLLVM |
1019 | .YorN | | 1027 | .YorN |
1020 | Indicates whether | | 1028 | Indicates whether |
1021 | .Xr clang 1 | | 1029 | .Xr clang 1 |
1022 | is installed as a host tool and target compiler. | | 1030 | is installed as a host tool and target compiler. |
1023 | .Pp | | 1031 | .Pp |
1024 | If | | 1032 | If |
1025 | .Dq yes , | | 1033 | .Dq yes , |
1026 | acts as | | 1034 | acts as |
1027 | .Sy MKLIBCXX=yes . | | 1035 | .Sy MKLIBCXX=yes . |
1028 | .Pp | | 1036 | .Pp |
1029 | .Em Note : | | 1037 | .Em Note : |
1030 | Use of | | 1038 | Use of |
| @@ -1105,29 +1113,26 @@ Only used if | | | @@ -1105,29 +1113,26 @@ Only used if |
1105 | .Sy MKMAN=yes . | | 1113 | .Sy MKMAN=yes . |
1106 | .DFLTy | | 1114 | .DFLTy |
1107 | . | | 1115 | . |
1108 | .It Sy MKMANZ | | 1116 | .It Sy MKMANZ |
1109 | .YorN | | 1117 | .YorN |
1110 | Indicates whether manual pages should be compressed with | | 1118 | Indicates whether manual pages should be compressed with |
1111 | .Xr gzip 1 | | 1119 | .Xr gzip 1 |
1112 | at installation time. | | 1120 | at installation time. |
1113 | .Pp | | 1121 | .Pp |
1114 | Only used if | | 1122 | Only used if |
1115 | .Sy MKMAN=yes . | | 1123 | .Sy MKMAN=yes . |
1116 | .DFLTn | | 1124 | .DFLTn |
1117 | . | | 1125 | . |
1118 | .It Sy MKMCLINKER | | | |
1119 | Obsolete. | | | |
1120 | . | | | |
1121 | .It Sy MKMDNS | | 1126 | .It Sy MKMDNS |
1122 | .YorN | | 1127 | .YorN |
1123 | Indicates whether the mDNS (Multicast DNS) infrastructure | | 1128 | Indicates whether the mDNS (Multicast DNS) infrastructure |
1124 | (libraries and support programs) will be built and installed. | | 1129 | (libraries and support programs) will be built and installed. |
1125 | .DFLTy | | 1130 | .DFLTy |
1126 | . | | 1131 | . |
1127 | .It Sy MKNLS | | 1132 | .It Sy MKNLS |
1128 | .YorN | | 1133 | .YorN |
1129 | Indicates whether Native Language System (NLS) locale zone files will be | | 1134 | Indicates whether Native Language System (NLS) locale zone files will be |
1130 | built and installed. | | 1135 | built and installed. |
1131 | .NODEF NONLS | | 1136 | .NODEF NONLS |
1132 | .NOVAR MKSHARE=no | | 1137 | .NOVAR MKSHARE=no |
1133 | .DFLTy | | 1138 | .DFLTy |
| @@ -1178,48 +1183,58 @@ Setting | | | @@ -1178,48 +1183,58 @@ Setting |
1178 | to | | 1183 | to |
1179 | .Dq no | | 1184 | .Dq no |
1180 | is not recommended and may cause problems when updating the tree with | | 1185 | is not recommended and may cause problems when updating the tree with |
1181 | .Xr cvs 1 . | | 1186 | .Xr cvs 1 . |
1182 | .DFLTy | | 1187 | .DFLTy |
1183 | . | | 1188 | . |
1184 | .It Sy MKOBJDIRS | | 1189 | .It Sy MKOBJDIRS |
1185 | .YorN | | 1190 | .YorN |
1186 | Indicates whether object directories will be created automatically | | 1191 | Indicates whether object directories will be created automatically |
1187 | (via a | | 1192 | (via a |
1188 | .Dq make obj | | 1193 | .Dq make obj |
1189 | pass) at the start of a build. | | 1194 | pass) at the start of a build. |
1190 | .NOVAR MKOBJ=no | | 1195 | .NOVAR MKOBJ=no |
| | | 1196 | .Pp |
| | | 1197 | .Em Note : |
| | | 1198 | If using |
| | | 1199 | .Sy build.sh , |
| | | 1200 | the default is |
| | | 1201 | .Dq yes . |
| | | 1202 | This may be set back to |
| | | 1203 | .Dq no |
| | | 1204 | by giving |
| | | 1205 | .Sy build.sh |
| | | 1206 | the |
| | | 1207 | .Fl o |
| | | 1208 | option. |
1191 | .DFLTn | | 1209 | .DFLTn |
1192 | . | | 1210 | . |
1193 | .It Sy MKPAM | | 1211 | .It Sy MKPAM |
1194 | .YorN | | 1212 | .YorN |
1195 | Indicates whether the | | 1213 | Indicates whether the |
1196 | .Xr pam 8 | | 1214 | .Xr pam 8 |
1197 | framework (libraries and support files) will be built and installed. | | 1215 | framework (libraries and support files) will be built and installed. |
1198 | The pre-PAM code is not supported and may be removed in the future. | | 1216 | The pre-PAM code is not supported and may be removed in the future. |
1199 | .DFLTy | | 1217 | .DFLTy |
1200 | . | | 1218 | . |
1201 | .It Sy MKPCC | | 1219 | .It Sy MKPCC |
1202 | .YorN | | 1220 | .YorN |
1203 | Indicates whether | | 1221 | Indicates whether |
1204 | .Xr pcc 1 | | 1222 | .Xr pcc 1 |
1205 | or any related libraries | | 1223 | or any related libraries |
1206 | .Pq Sy libpcc , libpccsoftfloat | | 1224 | .Pq Sy libpcc , libpccsoftfloat |
1207 | will be built and installed. | | 1225 | will be built and installed. |
1208 | .DFLTn | | 1226 | .DFLTn |
1209 | . | | 1227 | . |
1210 | .It Sy MKPERFUSE | | | |
1211 | Obsolete. | | | |
1212 | . | | | |
1213 | .It Sy MKPF | | 1228 | .It Sy MKPF |
1214 | .YorN | | 1229 | .YorN |
1215 | Indicates whether the | | 1230 | Indicates whether the |
1216 | .Xr pf 4 | | 1231 | .Xr pf 4 |
1217 | programs, headers, and LKM will be built and installed. | | 1232 | programs, headers, and LKM will be built and installed. |
1218 | .DFLTy | | 1233 | .DFLTy |
1219 | . | | 1234 | . |
1220 | .It Sy MKPIC | | 1235 | .It Sy MKPIC |
1221 | .YorN | | 1236 | .YorN |
1222 | Indicates whether shared objects and libraries will be created and | | 1237 | Indicates whether shared objects and libraries will be created and |
1223 | installed. | | 1238 | installed. |
1224 | If | | 1239 | If |
1225 | .Dq no , | | 1240 | .Dq no , |
| @@ -1363,34 +1378,53 @@ and | | | @@ -1363,34 +1378,53 @@ and |
1363 | .Dq no | | 1378 | .Dq no |
1364 | on other platforms. | | 1379 | on other platforms. |
1365 | . | | 1380 | . |
1366 | .It Sy MKREPRO | | 1381 | .It Sy MKREPRO |
1367 | .YorN | | 1382 | .YorN |
1368 | Indicates whether builds are to be reproducible. | | 1383 | Indicates whether builds are to be reproducible. |
1369 | If | | 1384 | If |
1370 | .Dq yes , | | 1385 | .Dq yes , |
1371 | two builds from the same source tree will produce the same build | | 1386 | two builds from the same source tree will produce the same build |
1372 | results. | | 1387 | results. |
1373 | .Pp | | 1388 | .Pp |
1374 | Used as the default for | | 1389 | Used as the default for |
1375 | .Sy MKARZERO . | | 1390 | .Sy MKARZERO . |
| | | 1391 | .Pp |
| | | 1392 | .Em Note : |
| | | 1393 | This may be set to |
| | | 1394 | .Dq yes |
| | | 1395 | by giving |
| | | 1396 | .Sy build.sh |
| | | 1397 | the |
| | | 1398 | .Fl P |
| | | 1399 | option. |
1376 | .DFLTn | | 1400 | .DFLTn |
1377 | . | | 1401 | . |
1378 | .It Sy MKREPRO_TIMESTAMP | | 1402 | .It Sy MKREPRO_TIMESTAMP |
1379 | Unix timestamp. | | 1403 | Unix timestamp. |
1380 | When | | 1404 | When |
1381 | .Sy MKREPRO | | 1405 | .Sy MKREPRO |
1382 | is set, the timestamp of all files in the sets will be set | | 1406 | is set, the timestamp of all files in the sets will be set |
1383 | to this value. | | 1407 | to this value. |
| | | 1408 | .Pp |
| | | 1409 | .Em Note : |
| | | 1410 | This may be set automatically to the latest source tree timestamp |
| | | 1411 | using |
| | | 1412 | .Xr cvslatest 1 |
| | | 1413 | by giving |
| | | 1414 | .Sy build.sh |
| | | 1415 | the |
| | | 1416 | .Fl P |
| | | 1417 | option. |
1384 | .DFLTu | | 1418 | .DFLTu |
1385 | . | | 1419 | . |
1386 | .It Sy MKRUMP | | 1420 | .It Sy MKRUMP |
1387 | .YorN | | 1421 | .YorN |
1388 | Indicates whether the | | 1422 | Indicates whether the |
1389 | .Xr rump 3 | | 1423 | .Xr rump 3 |
1390 | headers, libraries, and programs are to be installed. | | 1424 | headers, libraries, and programs are to be installed. |
1391 | .NOVAR COVERITY_TOP_CONFIG No is defined | | 1425 | .NOVAR COVERITY_TOP_CONFIG No is defined |
1392 | .DFLTy | | 1426 | .DFLTy |
1393 | . | | 1427 | . |
1394 | .It Sy MKSANITIZER | | 1428 | .It Sy MKSANITIZER |
1395 | .YorN | | 1429 | .YorN |
1396 | Indicates whether to use the sanitizer to compile userland programs, | | 1430 | Indicates whether to use the sanitizer to compile userland programs, |
| @@ -1509,66 +1543,75 @@ loading shared libraries. | | | @@ -1509,66 +1543,75 @@ loading shared libraries. |
1509 | . | | 1543 | . |
1510 | .It Sy MKTEGRAFIRMWARE | | 1544 | .It Sy MKTEGRAFIRMWARE |
1511 | .YorN | | 1545 | .YorN |
1512 | Indicates whether to install the | | 1546 | Indicates whether to install the |
1513 | .Pa /libdata/firmware/nvidia | | 1547 | .Pa /libdata/firmware/nvidia |
1514 | directory, which is necessary for the | | 1548 | directory, which is necessary for the |
1515 | NVIDIA Tegra XHCI driver. | | 1549 | NVIDIA Tegra XHCI driver. |
1516 | .DFLTy | | 1550 | .DFLTy |
1517 | on | | 1551 | on |
1518 | .Sy evbarm ; | | 1552 | .Sy evbarm ; |
1519 | .Dq no | | 1553 | .Dq no |
1520 | on other platforms. | | 1554 | on other platforms. |
1521 | . | | 1555 | . |
1522 | .It Sy MKTOOLSDEBUG | | | |
1523 | Deprecated, use | | | |
1524 | .Sy MKDEBUGTOOLS . | | | |
1525 | . | | | |
1526 | .It Sy MKTPM | | 1556 | .It Sy MKTPM |
1527 | .YorN | | 1557 | .YorN |
1528 | Indicates whether to install the Trusted Platform Module (TPM) | | 1558 | Indicates whether to install the Trusted Platform Module (TPM) |
1529 | infrastructure. | | 1559 | infrastructure. |
1530 | .DFLTn | | 1560 | .DFLTn |
1531 | . | | 1561 | . |
1532 | .It Sy MKUNBOUND | | 1562 | .It Sy MKUNBOUND |
1533 | .YorN | | 1563 | .YorN |
1534 | Indicates whether the | | 1564 | Indicates whether the |
1535 | .Xr unbound 8 | | 1565 | .Xr unbound 8 |
1536 | DNS resolver will be built and installed. | | 1566 | DNS resolver will be built and installed. |
1537 | .DFLTy | | 1567 | .DFLTy |
1538 | . | | 1568 | . |
1539 | .It Sy MKUNPRIVED | | 1569 | .It Sy MKUNPRIVED |
1540 | .YorN | | 1570 | .YorN |
1541 | Indicates whether an unprivileged install will occur. | | 1571 | Indicates whether an unprivileged install will occur. |
1542 | The user, group, permissions, and file flags, will not be set on | | 1572 | The user, group, permissions, and file flags, will not be set on |
1543 | the installed items; instead the information will be appended to | | 1573 | the installed items; instead the information will be appended to |
1544 | a file called | | 1574 | a file called |
1545 | .Pa METALOG | | 1575 | .Pa METALOG |
1546 | in | | 1576 | in |
1547 | .Sy DESTDIR . | | 1577 | .Sy DESTDIR . |
1548 | The contents of | | 1578 | The |
1549 | .Pa METALOG | | 1579 | .Pa METALOG |
1550 | is used during the generation of the distribution tar files to ensure | | 1580 | contents are used during the generation of the distribution |
1551 | that the appropriate file ownership is stored. | | 1581 | tar files to ensure that the appropriate file ownership is stored. |
1552 | This allows a non-root | | 1582 | This allows a non-root |
1553 | .Sq "make install" . | | 1583 | .Sq "make install" . |
1554 | .DFLTn | | 1584 | .DFLTn |
1555 | . | | 1585 | . |
1556 | .It Sy MKUPDATE | | 1586 | .It Sy MKUPDATE |
1557 | .YorN | | 1587 | .YorN |
1558 | Indicates whether all install operations intended to write to | | 1588 | Indicates whether all install operations intended to write to |
1559 | .Sy DESTDIR | | 1589 | .Sy DESTDIR |
1560 | will compare file timestamps before installing, and skip the install | | 1590 | will compare file timestamps before installing, and skip the install |
1561 | phase if the destination files are up-to-date. | | 1591 | phase if the destination files are up-to-date. |
| | | 1592 | .Pp |
| | | 1593 | For top-level builds this this implies the effects of |
| | | 1594 | .Sy NOCLEANDIR |
| | | 1595 | (i.e., |
| | | 1596 | .Dq make cleandir |
| | | 1597 | is avoided). |
| | | 1598 | .Pp |
| | | 1599 | .Em Note : |
| | | 1600 | If using |
| | | 1601 | .Sy build.sh , |
| | | 1602 | this may be set by giving the |
| | | 1603 | .Fl u |
| | | 1604 | option. |
1562 | .DFLTn | | 1605 | .DFLTn |
1563 | . | | 1606 | . |
1564 | .It Sy MKX11 | | 1607 | .It Sy MKX11 |
1565 | .YorN | | 1608 | .YorN |
1566 | Indicates whether X11 will be built and installed from | | 1609 | Indicates whether X11 will be built and installed from |
1567 | .Sy X11SRCDIR , | | 1610 | .Sy X11SRCDIR , |
1568 | and whether the X sets will be created. | | 1611 | and whether the X sets will be created. |
1569 | .Pp | | 1612 | .Pp |
1570 | .Em Note : | | 1613 | .Em Note : |
1571 | If | | 1614 | If |
1572 | .Dq yes , | | 1615 | .Dq yes , |
1573 | requires | | 1616 | requires |
1574 | .Sy MKINET6=yes . | | 1617 | .Sy MKINET6=yes . |
| @@ -1684,77 +1727,117 @@ Indicates whether the build creates an o | | | @@ -1684,77 +1727,117 @@ Indicates whether the build creates an o |
1684 | release which is going to be available from | | 1727 | release which is going to be available from |
1685 | .Lk ftp.NetBSD.org | | 1728 | .Lk ftp.NetBSD.org |
1686 | and/or | | 1729 | and/or |
1687 | .Lk cdn.NetBSD.org | | 1730 | .Lk cdn.NetBSD.org |
1688 | locations. | | 1731 | locations. |
1689 | This variable modifies a few default paths in the installer | | 1732 | This variable modifies a few default paths in the installer |
1690 | and also creates different links in the install documentation. | | 1733 | and also creates different links in the install documentation. |
1691 | The auto-build cluster uses this variable to distinguish | | 1734 | The auto-build cluster uses this variable to distinguish |
1692 | .Sq daily | | 1735 | .Sq daily |
1693 | builds from real releases. | | 1736 | builds from real releases. |
1694 | .DFLTu | | 1737 | .DFLTu |
1695 | .Pq Dq no . | | 1738 | .Pq Dq no . |
1696 | . | | 1739 | . |
| | | 1740 | .It Sy NOCLEANDIR |
| | | 1741 | If set, avoids the |
| | | 1742 | .Dq make cleandir |
| | | 1743 | phase of a full build. |
| | | 1744 | This has the effect of allowing only changed |
| | | 1745 | files in a source tree to be recompiled. |
| | | 1746 | This can speed up builds when updating only a few files in the tree. |
| | | 1747 | .Pp |
| | | 1748 | See also |
| | | 1749 | .Sy MKUPDATE . |
| | | 1750 | .DFLTu |
| | | 1751 | . |
| | | 1752 | .It Sy NODISTRIBDIRS |
| | | 1753 | If set, avoids the |
| | | 1754 | .Dq make distrib-dirs |
| | | 1755 | phase of a full build. |
| | | 1756 | This skips running |
| | | 1757 | .Xr mtree 8 |
| | | 1758 | on |
| | | 1759 | .Sy DESTDIR , |
| | | 1760 | useful on systems where building as an unprivileged user, or where it is |
| | | 1761 | known that the system-wide |
| | | 1762 | .Xr mtree 8 |
| | | 1763 | files have not changed. |
| | | 1764 | .DFLTu |
| | | 1765 | . |
| | | 1766 | .It Sy NOINCLUDES |
| | | 1767 | If set, avoids the |
| | | 1768 | .Dq make includes |
| | | 1769 | phase of a full build. |
| | | 1770 | This has the effect of preventing |
| | | 1771 | .Xr make 1 |
| | | 1772 | from thinking that some programs are out-of-date simply because the |
| | | 1773 | system include files have changed. |
| | | 1774 | However, this option should not be used when updating the entire |
| | | 1775 | .Nx |
| | | 1776 | source tree arbitrarily; it is suggested to use |
| | | 1777 | .Sy MKUPDATE=yes |
| | | 1778 | instead in that case. |
| | | 1779 | .DFLTu |
| | | 1780 | . |
1697 | .It Sy OBJMACHINE | | 1781 | .It Sy OBJMACHINE |
1698 | If defined, creates objdirs of the form | | 1782 | If defined, creates objdirs of the form |
1699 | .Pa obj . Ns Sy MACHINE , | | 1783 | .Pa obj . Ns Sy MACHINE , |
1700 | where | | 1784 | where |
1701 | .Sy MACHINE | | 1785 | .Sy MACHINE |
1702 | is the current architecture (as per | | 1786 | is the current architecture (as per |
1703 | .Sq "uname -m" ) . | | 1787 | .Sq "uname -m" ) . |
1704 | . | | 1788 | . |
1705 | .It Sy RELEASEDIR | | 1789 | .It Sy RELEASEDIR |
1706 | If set, specifies the directory to which a | | 1790 | If set, specifies the directory to which a |
1707 | .Xr release 7 | | 1791 | .Xr release 7 |
1708 | layout will be written at the end of a | | 1792 | layout will be written at the end of a |
1709 | .Dq make release . | | 1793 | .Dq make release . |
| | | 1794 | If specified, must be an absolute path. |
1710 | .Pp | | 1795 | .Pp |
1711 | .Em Note : | | 1796 | .Em Note : |
1712 | .Sy build.sh | | 1797 | .Sy build.sh |
1713 | will provide a default of | | 1798 | will provide a default of |
1714 | .Dq Pa releasedir | | 1799 | .Dq Pa releasedir |
1715 | (in the top-level | | 1800 | (in the top-level |
1716 | .Sy .OBJDIR ) | | 1801 | .Sy .OBJDIR ) |
1717 | unless run in | | 1802 | unless run in |
1718 | .Sq expert | | 1803 | .Sq expert |
1719 | mode. | | 1804 | mode. |
1720 | .DFLTu | | 1805 | .DFLTu |
1721 | . | | 1806 | . |
1722 | .It Sy SHAREDSTRINGS | | | |
1723 | Obsolete. | | | |
1724 | . | | | |
1725 | .It Sy TOOLCHAIN_MISSING | | 1807 | .It Sy TOOLCHAIN_MISSING |
1726 | .YorN | | 1808 | .YorN |
1727 | If not | | 1809 | If not |
1728 | .Dq no , | | 1810 | .Dq no , |
1729 | this indicates that the platform | | 1811 | this indicates that the platform |
1730 | .Dq Sy MACHINE_ARCH | | 1812 | .Dq Sy MACHINE_ARCH |
1731 | being built does not have a working in-tree toolchain. | | 1813 | being built does not have a working in-tree toolchain. |
1732 | .Pp | | 1814 | .Pp |
1733 | If not | | 1815 | If not |
1734 | .Dq no , | | 1816 | .Dq no , |
1735 | acts as | | 1817 | acts as |
1736 | .Sy MKBINUTILS=no MKGCC=no MKGDB=no . | | 1818 | .Sy MKBINUTILS=no MKGCC=no MKGDB=no . |
1737 | .\" See MKGCCCMDS for example text if a platform defaults to yes. | | 1819 | .\" See MKGCCCMDS for example text if a platform defaults to yes. |
1738 | .DFLTn | | 1820 | .DFLTn |
1739 | . | | 1821 | . |
1740 | .It Sy TOOLDIR | | 1822 | .It Sy TOOLDIR |
1741 | Directory to hold the host tools, once built. | | 1823 | Directory to hold the host tools, once built. |
| | | 1824 | If specified, must be an absolute path. |
1742 | This directory should be unique to a given host system and | | 1825 | This directory should be unique to a given host system and |
1743 | .Nx | | 1826 | .Nx |
1744 | source tree. | | 1827 | source tree. |
1745 | (However, multiple targets may share the same | | 1828 | (However, multiple target architectures may share the same |
1746 | .Sy TOOLDIR ; | | 1829 | .Sy TOOLDIR ; |
1747 | the target-dependent files have unique names.) | | 1830 | the target-architecture-dependent files have unique names.) |
1748 | If unset, a default based | | 1831 | If unset, a default based |
1749 | on the | | 1832 | on the |
1750 | .Xr uname 1 | | 1833 | .Xr uname 1 |
1751 | information of the host platform will be created in the | | 1834 | information of the host platform will be created in the |
1752 | .Sy .OBJDIR | | 1835 | .Sy .OBJDIR |
1753 | of | | 1836 | of |
1754 | .Pa src . | | 1837 | .Pa src . |
1755 | .DFLTu | | 1838 | .DFLTu |
1756 | . | | 1839 | . |
1757 | .It Sy USETOOLS | | 1840 | .It Sy USETOOLS |
1758 | .YorN | | 1841 | .YorN |
1759 | Indicates whether the tools specified by | | 1842 | Indicates whether the tools specified by |
1760 | .Sy TOOLDIR | | 1843 | .Sy TOOLDIR |
| @@ -1786,29 +1869,26 @@ This may cause build or runtime problems | | | @@ -1786,29 +1869,26 @@ This may cause build or runtime problems |
1786 | .Nx | | 1869 | .Nx |
1787 | source tree. | | 1870 | source tree. |
1788 | .El | | 1871 | .El |
1789 | .DFLTn | | 1872 | .DFLTn |
1790 | when using | | 1873 | when using |
1791 | .Aq bsd.*.mk | | 1874 | .Aq bsd.*.mk |
1792 | outside the | | 1875 | outside the |
1793 | .Nx | | 1876 | .Nx |
1794 | source tree (detected automatically) or if | | 1877 | source tree (detected automatically) or if |
1795 | .Sy TOOLCHAIN_MISSING=yes ; | | 1878 | .Sy TOOLCHAIN_MISSING=yes ; |
1796 | .Dq yes | | 1879 | .Dq yes |
1797 | otherwise. | | 1880 | otherwise. |
1798 | . | | 1881 | . |
1799 | .It Sy USE_COMBINE | | | |
1800 | Obsolete. | | | |
1801 | . | | | |
1802 | .It Sy USE_FORT | | 1882 | .It Sy USE_FORT |
1803 | .YorN | | 1883 | .YorN |
1804 | Indicates whether the so-called | | 1884 | Indicates whether the so-called |
1805 | .Dq FORTIFY_SOURCE | | 1885 | .Dq FORTIFY_SOURCE |
1806 | .Xr security 7 | | 1886 | .Xr security 7 |
1807 | extensions are enabled; see | | 1887 | extensions are enabled; see |
1808 | .Xr ssp 3 | | 1888 | .Xr ssp 3 |
1809 | for details. | | 1889 | for details. |
1810 | This imposes some performance penalty. | | 1890 | This imposes some performance penalty. |
1811 | .NODEF NOFORT | | 1891 | .NODEF NOFORT |
1812 | .DFLTn | | 1892 | .DFLTn |
1813 | . | | 1893 | . |
1814 | .It Sy USE_HESIOD | | 1894 | .It Sy USE_HESIOD |
| @@ -2008,54 +2088,124 @@ Path of the Motif installation to use if | | | @@ -2008,54 +2088,124 @@ Path of the Motif installation to use if |
2008 | . | | 2088 | . |
2009 | .It Sy X11SRCDIR | | 2089 | .It Sy X11SRCDIR |
2010 | Directory containing the modular Xorg source. | | 2090 | Directory containing the modular Xorg source. |
2011 | If specified, must be an absolute path. | | 2091 | If specified, must be an absolute path. |
2012 | The main modular Xorg source is found in | | 2092 | The main modular Xorg source is found in |
2013 | .Sy X11SRCDIR Ns Pa /external/mit . | | 2093 | .Sy X11SRCDIR Ns Pa /external/mit . |
2014 | .DFLT | | 2094 | .DFLT |
2015 | .Sy NETBSDSRCDIR Ns Pa /../xsrc , | | 2095 | .Sy NETBSDSRCDIR Ns Pa /../xsrc , |
2016 | if that exists; otherwise | | 2096 | if that exists; otherwise |
2017 | .Pa /usr/xsrc . | | 2097 | .Pa /usr/xsrc . |
2018 | . | | 2098 | . |
2019 | .El | | 2099 | .El |
2020 | . | | 2100 | . |
2021 | .Ss pkgsrc system variables | | 2101 | .Sh PKGSRC SYSTEM VARIABLES |
2022 | . | | 2102 | . |
2023 | Please see the pkgsrc guide at | | 2103 | Please see the pkgsrc guide at |
2024 | .Lk http://www.netbsd.org/Documentation/pkgsrc/ | | 2104 | .Lk http://www.netbsd.org/Documentation/pkgsrc/ |
2025 | or | | 2105 | or |
2026 | .Pa pkgsrc/doc/pkgsrc.txt | | 2106 | .Pa pkgsrc/doc/pkgsrc.txt |
2027 | for more variables used internally by the package system and | | 2107 | for more variables used internally by the package system and |
2028 | .Pa ${PKGSRCDIR}/mk/defaults/mk.conf | | 2108 | .Pa ${PKGSRCDIR}/mk/defaults/mk.conf |
2029 | for package-specific examples. | | 2109 | for package-specific examples. |
2030 | . | | 2110 | . |
| | | 2111 | .Sh OBSOLETE VARIABLES |
| | | 2112 | . |
| | | 2113 | These variables are obsolete. |
| | | 2114 | . |
| | | 2115 | .Bl -tag -width 14n |
| | | 2116 | . |
| | | 2117 | .\" These entries are sorted alphabetically. |
| | | 2118 | . |
| | | 2119 | .It Sy EXTSRCSRCDIR |
| | | 2120 | Obsolete. |
| | | 2121 | . |
| | | 2122 | .It Sy MKBFD |
| | | 2123 | Use |
| | | 2124 | .Sy MKBINUTILS . |
| | | 2125 | . |
| | | 2126 | .It Sy MKCRYPTO |
| | | 2127 | Obsolete. |
| | | 2128 | . |
| | | 2129 | .It Sy MKEXTSRC |
| | | 2130 | Obsolete. |
| | | 2131 | . |
| | | 2132 | .It Sy MKKERBEROS4 |
| | | 2133 | Obsolete. |
| | | 2134 | . |
| | | 2135 | .It Sy MKKDEBUG |
| | | 2136 | Use |
| | | 2137 | .Sy MKDEBUGKERNEL . |
| | | 2138 | . |
| | | 2139 | .It Sy MKLLD |
| | | 2140 | Obsolete. |
| | | 2141 | . |
| | | 2142 | .It Sy MKLLDB |
| | | 2143 | Obsolete. |
| | | 2144 | . |
| | | 2145 | .It Sy MKMCLINKER |
| | | 2146 | Obsolete. |
| | | 2147 | . |
| | | 2148 | .It Sy MKPERFUSE |
| | | 2149 | Obsolete. |
| | | 2150 | . |
| | | 2151 | .It Sy MKTOOLSDEBUG |
| | | 2152 | Use |
| | | 2153 | .Sy MKDEBUGTOOLS . |
| | | 2154 | . |
| | | 2155 | .It Sy NBUILDJOBS |
| | | 2156 | Use the |
| | | 2157 | .Nm build.sh |
| | | 2158 | and |
| | | 2159 | .Xr make 1 |
| | | 2160 | option |
| | | 2161 | .Fl j |
| | | 2162 | instead. |
| | | 2163 | . |
| | | 2164 | .It Sy SHAREDSTRINGS |
| | | 2165 | Obsolete. |
| | | 2166 | . |
| | | 2167 | .It Sy USE_COMBINE |
| | | 2168 | Obsolete. |
| | | 2169 | . |
| | | 2170 | .It Sy USE_NEW_TOOLCHAIN |
| | | 2171 | The new toolchain is now the default. |
| | | 2172 | To disable, use |
| | | 2173 | .Sy TOOLCHAIN_MISSING=yes . |
| | | 2174 | . |
| | | 2175 | .El |
| | | 2176 | . |
2031 | .Sh FILES | | 2177 | .Sh FILES |
2032 | .Bl -tag -width /etc/mk.conf | | 2178 | .Bl -tag -width /etc/mk.conf |
2033 | . | | 2179 | . |
2034 | .It Pa /etc/mk.conf | | 2180 | .It Pa /etc/mk.conf |
2035 | This file. | | 2181 | The |
| | | 2182 | .Nm |
| | | 2183 | file resides in |
| | | 2184 | .Pa /etc . |
2036 | . | | 2185 | . |
2037 | .It Pa ${PKGSRCDIR}/mk/defaults/mk.conf | | 2186 | .It Pa ${PKGSRCDIR}/mk/defaults/mk.conf |
2038 | Examples for settings regarding the pkgsrc collection. | | 2187 | Examples for settings regarding the pkgsrc collection. |
2039 | .El | | 2188 | .El |
2040 | . | | 2189 | . |
2041 | .Sh SEE ALSO | | 2190 | .Sh SEE ALSO |
2042 | .Xr apropos 1 , | | 2191 | .Xr apropos 1 , |
2043 | .Xr ar 1 , | | 2192 | .Xr ar 1 , |
2044 | .Xr as 1 , | | 2193 | .Xr as 1 , |
2045 | .Xr clang 1 , | | 2194 | .Xr clang 1 , |
2046 | .Xr clang++ 1 , | | 2195 | .Xr clang++ 1 , |
2047 | .Xr cpio 1 , | | 2196 | .Xr cpio 1 , |
2048 | .Xr cvs 1 , | | 2197 | .Xr cvs 1 , |
| | | 2198 | .Xr cvslatest 1 , |
2049 | .Xr dtrace 1 , | | 2199 | .Xr dtrace 1 , |
2050 | .Xr g++ 1 , | | 2200 | .Xr g++ 1 , |
2051 | .Xr gcc 1 , | | 2201 | .Xr gcc 1 , |
2052 | .Xr gdb 1 , | | 2202 | .Xr gdb 1 , |
2053 | .Xr groff 1 , | | 2203 | .Xr groff 1 , |
2054 | .Xr gzip 1 , | | 2204 | .Xr gzip 1 , |
2055 | .Xr ident 1 , | | 2205 | .Xr ident 1 , |
2056 | .Xr ld 1 , | | 2206 | .Xr ld 1 , |
2057 | .Xr ld.elf_so 1 , | | 2207 | .Xr ld.elf_so 1 , |
2058 | .Xr lint 1 , | | 2208 | .Xr lint 1 , |
2059 | .Xr ls 1 , | | 2209 | .Xr ls 1 , |
2060 | .Xr make 1 , | | 2210 | .Xr make 1 , |
2061 | .Xr mandoc 1 , | | 2211 | .Xr mandoc 1 , |
| @@ -2086,26 +2236,29 @@ Examples for settings regarding the pkgs | | | @@ -2086,26 +2236,29 @@ Examples for settings regarding the pkgs |
2086 | .Xr ral 4 , | | 2236 | .Xr ral 4 , |
2087 | .Xr rtwn 4 , | | 2237 | .Xr rtwn 4 , |
2088 | .Xr rum 4 , | | 2238 | .Xr rum 4 , |
2089 | .Xr run 4 , | | 2239 | .Xr run 4 , |
2090 | .Xr urtwn 4 , | | 2240 | .Xr urtwn 4 , |
2091 | .Xr wpi 4 , | | 2241 | .Xr wpi 4 , |
2092 | .Xr zyd 4 , | | 2242 | .Xr zyd 4 , |
2093 | .Xr pam.conf 5 , | | 2243 | .Xr pam.conf 5 , |
2094 | .Xr release 7 , | | 2244 | .Xr release 7 , |
2095 | .Xr security 7 , | | 2245 | .Xr security 7 , |
2096 | .Xr Xorg 7 , | | 2246 | .Xr Xorg 7 , |
2097 | .Xr dbsym 8 , | | 2247 | .Xr dbsym 8 , |
2098 | .Xr getNAME 8 , | | 2248 | .Xr getNAME 8 , |
| | | 2249 | .Xr installboot 8 , |
2099 | .Xr makemandb 8 , | | 2250 | .Xr makemandb 8 , |
2100 | .Xr makewhatis 8 , | | 2251 | .Xr makewhatis 8 , |
2101 | .Xr mdsetimage 8 , | | 2252 | .Xr mdsetimage 8 , |
| | | 2253 | .Xr mtree 8 , |
2102 | .Xr pam 8 , | | 2254 | .Xr pam 8 , |
2103 | .Xr unbound 8 , | | 2255 | .Xr unbound 8 , |
2104 | .Pa /usr/share/mk/bsd.README , | | 2256 | .Pa /usr/share/mk/bsd.README , |
| | | 2257 | .Pa src/BUILDING , |
2105 | .Pa pkgsrc/doc/pkgsrc.txt , | | 2258 | .Pa pkgsrc/doc/pkgsrc.txt , |
2106 | .Lk http://www.netbsd.org/Documentation/pkgsrc/ | | 2259 | .Lk http://www.netbsd.org/Documentation/pkgsrc/ |
2107 | .Sh HISTORY | | 2260 | .Sh HISTORY |
2108 | The | | 2261 | The |
2109 | .Nm | | 2262 | .Nm |
2110 | file appeared in | | 2263 | file appeared in |
2111 | .Nx 1.2 . | | 2264 | .Nx 1.2 . |