Tue Oct 27 06:33:38 2020 UTC ()
Document MKKDEBUG. Thanks martin for letting me know.


(rin)
diff -r1.80 -r1.81 src/share/man/man5/mk.conf.5
cvs diff -r1.80 -r1.81 src/share/man/man5/mk.conf.5 (switch to unified diff)

--- src/share/man/man5/mk.conf.5 2020/07/15 17:46:06 1.80
+++ src/share/man/man5/mk.conf.5 2020/10/27 06:33:38 1.81
@@ -1,1084 +1,1095 @@ @@ -1,1084 +1,1095 @@
1.\" $NetBSD: mk.conf.5,v 1.80 2020/07/15 17:46:06 leot Exp $ 1.\" $NetBSD: mk.conf.5,v 1.81 2020/10/27 06:33:38 rin Exp $
2.\" 2.\"
3.\" Copyright (c) 1999-2003 The NetBSD Foundation, Inc. 3.\" Copyright (c) 1999-2003 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
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.\" 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 July 15, 2020 30.Dd October 27, 2020
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
41The 41The
42.Nm 42.Nm
43file overrides various parameters used during the build of the system. 43file overrides various parameters used during the build of the system.
44.Pp 44.Pp
45Listed below are the 45Listed below are the
46.Nm 46.Nm
47variables that may be set, the values to which each may be set, 47variables that may be set, the values to which each may be set,
48a brief description of what each variable does, and a reference to 48a brief description of what each variable does, and a reference to
49relevant manual pages. 49relevant manual pages.
50. 50.
51.Ss NetBSD System variables 51.Ss NetBSD System variables
52. 52.
53.de YorN 53.de YorN
54Can be set to 54Can be set to
55.Dq yes 55.Dq yes
56or 56or
57.Dq no . 57.Dq no .
58.. 58..
59.de DFLT 59.de DFLT
60.Pp 60.Pp
61.Em Default : 61.Em Default :
62.. 62..
63.de DFLTu 63.de DFLTu
64.DFLT 64.DFLT
65Unset. 65Unset.
66.. 66..
67.de DFLTy 67.de DFLTy
68.DFLT 68.DFLT
69.Dq yes 69.Dq yes
70.. 70..
71.de DFLTn 71.de DFLTn
72.DFLT 72.DFLT
73.Dq no 73.Dq no
74.. 74..
75.Bl -tag -width MKDYNAMICROOT 75.Bl -tag -width MKDYNAMICROOT
76. 76.
77.It Sy NETBSDSRCDIR 77.It Sy NETBSDSRCDIR
78The path to the top level of the 78The path to the top level of the
79.Nx 79.Nx
80sources. 80sources.
81If 81If
82.Xr make 1 82.Xr make 1
83is run from within the 83is run from within the
84.Nx 84.Nx
85source tree, the default is the top 85source tree, the default is the top
86level of that tree (as determined by the presence of 86level of that tree (as determined by the presence of
87.Pa build.sh 87.Pa build.sh
88and 88and
89.Pa tools/ ) , 89.Pa tools/ ) ,
90otherwise 90otherwise
91.Sy BSDSRCDIR 91.Sy BSDSRCDIR
92will be used. 92will be used.
93. 93.
94.It Sy BSDOBJDIR 94.It Sy BSDOBJDIR
95The real path to the 95The real path to the
96.Sq obj 96.Sq obj
97tree for the 97tree for the
98.Nx 98.Nx
99source tree. 99source tree.
100.DFLT 100.DFLT
101.Pa /usr/obj 101.Pa /usr/obj
102. 102.
103.It Sy BSDSRCDIR 103.It Sy BSDSRCDIR
104The real path to the 104The real path to the
105.Nx 105.Nx
106source tree. 106source tree.
107.DFLT 107.DFLT
108.Pa /usr/src 108.Pa /usr/src
109. 109.
110.It Sy BUILD 110.It Sy BUILD
111If defined, 111If defined,
112.Sq "make install" 112.Sq "make install"
113checks that the targets in the source directories are up-to-date and 113checks that the targets in the source directories are up-to-date and
114re-makes them if they are out of date, instead of blindly trying to install 114re-makes them if they are out of date, instead of blindly trying to install
115out of date or non-existent targets. 115out of date or non-existent targets.
116.DFLTu 116.DFLTu
117. 117.
118.It Sy BUILDID 118.It Sy BUILDID
119Identifier for the build. 119Identifier for the build.
120The identifier will be appended to 120The identifier will be appended to
121object directory names, and can be consulted in the 121object directory names, and can be consulted in the
122.Xr make 1 122.Xr make 1
123configuration file in order to set additional build parameters, 123configuration file in order to set additional build parameters,
124such as compiler flags. 124such as compiler flags.
125.DFLTu 125.DFLTu
126. 126.
127.It Sy COPTS 127.It Sy COPTS
128Extra options for the C compiler. 128Extra options for the C compiler.
129Should be appended to (e.g., 129Should be appended to (e.g.,
130.Sy COPTS+=-g ) , 130.Sy COPTS+=-g ) ,
131rather than explicitly set. 131rather than explicitly set.
132Note that 132Note that
133.Sy CPUFLAGS , 133.Sy CPUFLAGS ,
134not 134not
135.Sy COPTS , 135.Sy COPTS ,
136should be used for 136should be used for
137compiler flags that select CPU-related options. 137compiler flags that select CPU-related options.
138Also note that 138Also note that
139.Sy CFLAGS 139.Sy CFLAGS
140should never be set in 140should never be set in
141.Nm . 141.Nm .
142. 142.
143.It Sy CPUFLAGS 143.It Sy CPUFLAGS
144Additional flags passed to the compiler/assembler to select 144Additional flags passed to the compiler/assembler to select
145CPU instruction set options, CPU tuning options, etc. 145CPU instruction set options, CPU tuning options, etc.
146Such options should not be specified in 146Such options should not be specified in
147.Sy COPTS , 147.Sy COPTS ,
148because some parts of the build process need to override 148because some parts of the build process need to override
149CPU-related compiler options. 149CPU-related compiler options.
150. 150.
151.It Sy DESTDIR 151.It Sy DESTDIR
152Directory to contain the built 152Directory to contain the built
153.Nx 153.Nx
154system. 154system.
155If set, special options are passed to the compilation tools to 155If set, special options are passed to the compilation tools to
156prevent their default use of the host system's 156prevent their default use of the host system's
157.Sy /usr/include , /usr/lib , 157.Sy /usr/include , /usr/lib ,
158and so forth. 158and so forth.
159This pathname should 159This pathname should
160.Em not 160.Em not
161end with a slash 161end with a slash
162.Pq / 162.Pq /
163character (for installation into the system's root directory, set 163character (for installation into the system's root directory, set
164.Sy DESTDIR 164.Sy DESTDIR
165to an empty string). 165to an empty string).
166The directory must reside on a file system which supports long file 166The directory must reside on a file system which supports long file
167names and hard links. 167names and hard links.
168.DFLT 168.DFLT
169Empty string if 169Empty string if
170.Sy USETOOLS 170.Sy USETOOLS
171is 171is
172.Dq yes ; 172.Dq yes ;
173unset otherwise. 173unset otherwise.
174.Pp 174.Pp
175.Em Note : 175.Em Note :
176.Sy build.sh 176.Sy build.sh
177will provide a default of 177will provide a default of
178.Pa destdir. Ns Sy MACHINE 178.Pa destdir. Ns Sy MACHINE
179(in the top-level 179(in the top-level
180.Sy .OBJDIR ) 180.Sy .OBJDIR )
181unless run in 181unless run in
182.Sq expert 182.Sq expert
183mode 183mode
184. 184.
185.It Sy MAKEVERBOSE 185.It Sy MAKEVERBOSE
186Level of verbosity of status messages. 186Level of verbosity of status messages.
187Supported values: 187Supported values:
188.Bl -tag -width xxx 188.Bl -tag -width xxx
189.It 0 189.It 0
190No descriptive messages or commands executed by 190No descriptive messages or commands executed by
191.Xr make 1 191.Xr make 1
192are shown. 192are shown.
193.It 1 193.It 1
194Brief messages are shown describing what is being done, 194Brief messages are shown describing what is being done,
195but the actual commands executed by 195but the actual commands executed by
196.Xr make 1 196.Xr make 1
197are not displayed. 197are not displayed.
198.It 2 198.It 2
199Descriptive messages are shown as above (prefixed with a 199Descriptive messages are shown as above (prefixed with a
200.Sq # ) , 200.Sq # ) ,
201and ordinary commands performed by 201and ordinary commands performed by
202.Xr make 1 202.Xr make 1
203are displayed. 203are displayed.
204.It 3 204.It 3
205In addition to the above, all commands performed by 205In addition to the above, all commands performed by
206.Xr make 1 206.Xr make 1
207are displayed, even if they would ordinarily have been hidden 207are displayed, even if they would ordinarily have been hidden
208through use of the 208through use of the
209.Dq \&@ 209.Dq \&@
210prefix in the relevant makefile. 210prefix in the relevant makefile.
211.It 4 211.It 4
212In addition to the above, commands executed by 212In addition to the above, commands executed by
213.Xr make 1 213.Xr make 1
214are traced through use of the 214are traced through use of the
215.Xr sh 1 215.Xr sh 1
216.Dq Fl x 216.Dq Fl x
217flag. 217flag.
218.El 218.El
219.DFLT 219.DFLT
2202 2202
221. 221.
222.It Sy MKATF 222.It Sy MKATF
223.YorN 223.YorN
224Indicates whether the Automated Testing Framework is built and installed. 224Indicates whether the Automated Testing Framework is built and installed.
225This also controls whether the 225This also controls whether the
226.Nx 226.Nx
227test suite is built and installed, 227test suite is built and installed,
228as the tests rely on ATF and cannot be built without it. 228as the tests rely on ATF and cannot be built without it.
229.DFLTy 229.DFLTy
230. 230.
231.It Sy MKBINUTILS 231.It Sy MKBINUTILS
232.YorN 232.YorN
233Indicates whether any of the binutils tools or libraries should be built. 233Indicates whether any of the binutils tools or libraries should be built.
234That is, the libraries 234That is, the libraries
235.Sy libbfd , 235.Sy libbfd ,
236.Sy libiberty , 236.Sy libiberty ,
237or any of the things that depend upon them, e.g. 237or any of the things that depend upon them, e.g.
238.Xr as 1 , 238.Xr as 1 ,
239.Xr ld 1 , 239.Xr ld 1 ,
240.Xr dbsym 8 , 240.Xr dbsym 8 ,
241or 241or
242.Xr mdsetimage 8 . 242.Xr mdsetimage 8 .
243.DFLTy 243.DFLTy
244. 244.
245.It Sy MKBSDTAR 245.It Sy MKBSDTAR
246.YorN 246.YorN
247If 247If
248.Dq yes , 248.Dq yes ,
249.Sy libarchive Ns - Ns 249.Sy libarchive Ns - Ns
250based implementations of 250based implementations of
251.Xr cpio 1 251.Xr cpio 1
252and 252and
253.Xr tar 1 253.Xr tar 1
254are built and installed. 254are built and installed.
255If 255If
256.Dq no , 256.Dq no ,
257.Xr pax 1 257.Xr pax 1
258based frontends are used. 258based frontends are used.
259.DFLTy 259.DFLTy
260. 260.
261.It Sy MKCATPAGES 261.It Sy MKCATPAGES
262.YorN 262.YorN
263Indicates whether preformatted plaintext manual pages will be created 263Indicates whether preformatted plaintext manual pages will be created
264and installed. 264and installed.
265.DFLTn 265.DFLTn
266. 266.
267.It Sy MKCLEANSRC 267.It Sy MKCLEANSRC
268.YorN 268.YorN
269Indicates whether 269Indicates whether
270.Sq "make clean" 270.Sq "make clean"
271and 271and
272.Sq "make cleandir" 272.Sq "make cleandir"
273will delete file names in 273will delete file names in
274.Sy CLEANFILES 274.Sy CLEANFILES
275or 275or
276.Sy CLEANDIRFILES 276.Sy CLEANDIRFILES
277from both the object directory, 277from both the object directory,
278.Sy .OBJDIR , 278.Sy .OBJDIR ,
279and the source directory, 279and the source directory,
280.Sy .SRCDIR . 280.Sy .SRCDIR .
281.Pp 281.Pp
282If 282If
283.Dq yes , 283.Dq yes ,
284then these file names will be deleted relative to both 284then these file names will be deleted relative to both
285.Sy .OBJDIR 285.Sy .OBJDIR
286and 286and
287.Sy .CURDIR . 287.Sy .CURDIR .
288If 288If
289.Dq no , 289.Dq no ,
290then the deletion will be performed relative to 290then the deletion will be performed relative to
291.Sy .OBJDIR 291.Sy .OBJDIR
292only. 292only.
293.DFLTy 293.DFLTy
294. 294.
295.It Sy MKCLEANVERIFY 295.It Sy MKCLEANVERIFY
296.YorN 296.YorN
297Controls whether 297Controls whether
298.Sq "make clean" 298.Sq "make clean"
299and 299and
300.Sq "make cleandir" 300.Sq "make cleandir"
301will verify that files have been deleted. 301will verify that files have been deleted.
302If 302If
303.Dq yes , 303.Dq yes ,
304then file deletions will be verified using 304then file deletions will be verified using
305.Xr ls 1 . 305.Xr ls 1 .
306If 306If
307.Dq no , 307.Dq no ,
308then file deletions will not be verified. 308then file deletions will not be verified.
309.DFLTy 309.DFLTy
310. 310.
311.It Sy MKCOMPAT 311.It Sy MKCOMPAT
312.YorN 312.YorN
313Indicates whether support for multiple ABIs is to be built and 313Indicates whether support for multiple ABIs is to be built and
314installed. 314installed.
315.DFLTy 315.DFLTy
316on amd64, mips64 and sparc64, 316on amd64, mips64 and sparc64,
317.Dq no 317.Dq no
318on other architectures. 318on other architectures.
319. 319.
320.It Sy MKCOMPLEX 320.It Sy MKCOMPLEX
321.YorN 321.YorN
322Indicates whether the 322Indicates whether the
323.Lb libm 323.Lb libm
324is compiled with support for 324is compiled with support for
325.In complex.h . 325.In complex.h .
326.DFLTy 326.DFLTy
327. 327.
328.It Sy MKCTF 328.It Sy MKCTF
329.YorN 329.YorN
330Indicates whether CTF tools are to be built and installed. 330Indicates whether CTF tools are to be built and installed.
331If yes, the tools will be used to generate and manipulate 331If yes, the tools will be used to generate and manipulate
332CTF data of ELF binaries during build. 332CTF data of ELF binaries during build.
333.DFLTn 333.DFLTn
334. 334.
335.It Sy MKCVS 335.It Sy MKCVS
336.YorN 336.YorN
337Indicates whether 337Indicates whether
338.Xr cvs 1 338.Xr cvs 1
339is built. 339is built.
340.DFLTy 340.DFLTy
341. 341.
342.It Sy MKDEBUG 342.It Sy MKDEBUG
343.YorN 343.YorN
344Indicates whether separate debugging symbols should be installed into 344Indicates whether separate debugging symbols should be installed into
345.Sy DESTDIR Ns Pa /usr/libdata/debug . 345.Sy DESTDIR Ns Pa /usr/libdata/debug .
346.DFLTn 346.DFLTn
347. 347.
348.It Sy MKDEBUGLIB 348.It Sy MKDEBUGLIB
349.YorN 349.YorN
350Indicates whether debug libraries 350Indicates whether debug libraries
351.Sy ( lib*_g.a ) 351.Sy ( lib*_g.a )
352will be built and installed. 352will be built and installed.
353Debug libraries are compiled with 353Debug libraries are compiled with
354.Dq Li -g -DDEBUG . 354.Dq Li -g -DDEBUG .
355.DFLTn 355.DFLTn
356. 356.
357.It Sy MKDOC 357.It Sy MKDOC
358.YorN 358.YorN
359Indicates whether system documentation destined for 359Indicates whether system documentation destined for
360.Sy DESTDIR Ns Pa /usr/share/doc 360.Sy DESTDIR Ns Pa /usr/share/doc
361will be installed. 361will be installed.
362.DFLTy 362.DFLTy
363. 363.
364.It Sy MKDTRACE 364.It Sy MKDTRACE
365.YorN 365.YorN
366Indicates whether the kernel modules, utilities and libraries for 366Indicates whether the kernel modules, utilities and libraries for
367.Xr dtrace 1 367.Xr dtrace 1
368support are to be built and installed. 368support are to be built and installed.
369.DFLTn 369.DFLTn
370. 370.
371.It Sy MKDYNAMICROOT 371.It Sy MKDYNAMICROOT
372.YorN 372.YorN
373Indicates whether all programs should be dynamically linked, 373Indicates whether all programs should be dynamically linked,
374and to install shared libraries required by 374and to install shared libraries required by
375.Pa /bin 375.Pa /bin
376and 376and
377.Pa /sbin 377.Pa /sbin
378and the shared linker 378and the shared linker
379.Xr ld.elf_so 1 379.Xr ld.elf_so 1
380into 380into
381.Pa /lib . 381.Pa /lib .
382If 382If
383.Sq no , 383.Sq no ,
384link programs in 384link programs in
385.Pa /bin 385.Pa /bin
386and 386and
387.Pa /sbin 387.Pa /sbin
388statically. 388statically.
389.DFLTy 389.DFLTy
390. 390.
391.It Sy MKGCC 391.It Sy MKGCC
392.YorN 392.YorN
393Indicates whether 393Indicates whether
394.Xr gcc 1 394.Xr gcc 1
395or any related libraries 395or any related libraries
396.Pq Sy libg2c , libgcc , libobjc , libstdc++ 396.Pq Sy libg2c , libgcc , libobjc , libstdc++
397are built. 397are built.
398.DFLTy 398.DFLTy
399. 399.
400.It Sy MKGCCCMDS 400.It Sy MKGCCCMDS
401.YorN 401.YorN
402Indicates whether 402Indicates whether
403.Xr gcc 1 403.Xr gcc 1
404is built. 404is built.
405If 405If
406.Dq no , 406.Dq no ,
407then 407then
408.Sy MKGCC 408.Sy MKGCC
409controls if the 409controls if the
410GCC libraries are built. 410GCC libraries are built.
411.DFLTy 411.DFLTy
412. 412.
413.It Sy MKGDB 413.It Sy MKGDB
414.YorN 414.YorN
415Indicates whether 415Indicates whether
416.Xr gdb 1 416.Xr gdb 1
417is built. 417is built.
418.DFLTy 418.DFLTy
419. 419.
420.It Sy MKHESIOD 420.It Sy MKHESIOD
421.YorN 421.YorN
422Indicates whether the Hesiod infrastructure 422Indicates whether the Hesiod infrastructure
423(libraries and support programs) is built and installed. 423(libraries and support programs) is built and installed.
424.DFLTy 424.DFLTy
425. 425.
426.It Sy MKHOSTOBJ 426.It Sy MKHOSTOBJ
427.YorN 427.YorN
428If set to 428If set to
429.Dq yes , 429.Dq yes ,
430then for programs intended to be run on the compile host, 430then for programs intended to be run on the compile host,
431the name, release, and architecture of the host operating system 431the name, release, and architecture of the host operating system
432will be suffixed to the name of the object directory created by 432will be suffixed to the name of the object directory created by
433.Dq make obj . 433.Dq make obj .
434(This allows multiple host systems to compile 434(This allows multiple host systems to compile
435.Nx 435.Nx
436for a single target.) 436for a single target.)
437If set to 437If set to
438.Dq no , 438.Dq no ,
439then programs built to be run on the compile host will use the same 439then programs built to be run on the compile host will use the same
440object directory names as programs built to be run on the target. 440object directory names as programs built to be run on the target.
441.DFLTn 441.DFLTn
442. 442.
443.It Sy MKHTML 443.It Sy MKHTML
444.YorN 444.YorN
445Indicates whether the HTML manual pages are created and installed. 445Indicates whether the HTML manual pages are created and installed.
446.DFLTy 446.DFLTy
447. 447.
448.It Sy MKIEEEFP 448.It Sy MKIEEEFP
449.YorN 449.YorN
450Indicates whether code for IEEE754/IEC60559 conformance is built. 450Indicates whether code for IEEE754/IEC60559 conformance is built.
451Has no effect on most platforms. 451Has no effect on most platforms.
452.DFLTy 452.DFLTy
453. 453.
454.It Sy MKINET6 454.It Sy MKINET6
455Indicates whether INET6 (IPv6) infrastructure 455Indicates whether INET6 (IPv6) infrastructure
456(libraries and support programs) is built and installed. 456(libraries and support programs) is built and installed.
457.DFLTy 457.DFLTy
458. 458.
459.It Sy MKINFO 459.It Sy MKINFO
460.YorN 460.YorN
461Indicates whether GNU Info files, used for the documentation for 461Indicates whether GNU Info files, used for the documentation for
462most of the compilation tools, will be built and installed. 462most of the compilation tools, will be built and installed.
463.DFLTy 463.DFLTy
464. 464.
465.It Sy MKIPFILTER 465.It Sy MKIPFILTER
466.YorN 466.YorN
467Indicates whether the 467Indicates whether the
468.Xr ipf 4 468.Xr ipf 4
469programs, headers and other components will be built and installed. 469programs, headers and other components will be built and installed.
470.DFLTy 470.DFLTy
471. 471.
472.It Sy MKISCSI 472.It Sy MKISCSI
473.YorN 473.YorN
474Indicates whether the iSCSI library and applications are 474Indicates whether the iSCSI library and applications are
475built and installed. 475built and installed.
476.DFLTy 476.DFLTy
477. 477.
 478.It Sy MKKDEBUG
 479.YorN
 480Indicates whether debugging symbols will be built for kernels
 481by default; pretend as if
 482.Em makeoptions DEBUG="-g"
 483is specified in kernel configuration files.
 484See
 485.Xr options 4
 486for details.
 487.DFLTn
 488.
478.It Sy MKKERBEROS 489.It Sy MKKERBEROS
479.YorN 490.YorN
480Indicates whether the Kerberos v5 infrastructure 491Indicates whether the Kerberos v5 infrastructure
481(libraries and support programs) is built and installed. 492(libraries and support programs) is built and installed.
482Caution: the default 493Caution: the default
483.Xr pam 8 494.Xr pam 8
484configuration requires that Kerberos be present even if not used. 495configuration requires that Kerberos be present even if not used.
485Do not install a userland without Kerberos without also either 496Do not install a userland without Kerberos without also either
486updating the 497updating the
487.Xr pam.conf 5 498.Xr pam.conf 5
488files or disabling PAM via 499files or disabling PAM via
489.Sy MKPAM . 500.Sy MKPAM .
490Otherwise all logins will fail. 501Otherwise all logins will fail.
491.DFLTy 502.DFLTy
492. 503.
493.It Sy MKKMOD 504.It Sy MKKMOD
494.YorN 505.YorN
495Indicates whether kernel modules are built and installed. 506Indicates whether kernel modules are built and installed.
496.DFLTy 507.DFLTy
497. 508.
498.It Sy MKKYUA 509.It Sy MKKYUA
499.YorN 510.YorN
500Indicates whether Kyua (the testing infrastructure used by 511Indicates whether Kyua (the testing infrastructure used by
501.Nx ) 512.Nx )
502is built and installed. 513is built and installed.
503Note that 514Note that
504.Em this does not control the installation of the tests themselves . 515.Em this does not control the installation of the tests themselves .
505The tests rely on the ATF libraries and therefore their build is controlled 516The tests rely on the ATF libraries and therefore their build is controlled
506by the 517by the
507.Sy MKATF 518.Sy MKATF
508knob. 519knob.
509.DFLTn 520.DFLTn
510until the import of Kyua is done and validated. 521until the import of Kyua is done and validated.
511. 522.
512.It Sy MKLDAP 523.It Sy MKLDAP
513.YorN 524.YorN
514Indicates whether the Lightweight Directory Access Protocol (LDAP) 525Indicates whether the Lightweight Directory Access Protocol (LDAP)
515infrastructure 526infrastructure
516(libraries and support programs) is built and installed. 527(libraries and support programs) is built and installed.
517.DFLTy 528.DFLTy
518. 529.
519.It Sy MKLINKLIB 530.It Sy MKLINKLIB
520.YorN 531.YorN
521Indicates whether all of the shared library infrastructure is built. 532Indicates whether all of the shared library infrastructure is built.
522If 533If
523.Sq no , 534.Sq no ,
524prevents: 535prevents:
525installation of the 536installation of the
526.Sy *.a 537.Sy *.a
527libraries, 538libraries,
528installation of the 539installation of the
529.Sy *_pic.a 540.Sy *_pic.a
530libraries on PIC systems, 541libraries on PIC systems,
531building of 542building of
532.Sy *.a 543.Sy *.a
533libraries on PIC systems, 544libraries on PIC systems,
534or 545or
535installation of 546installation of
536.Sy .so 547.Sy .so
537symlinks on ELF systems. 548symlinks on ELF systems.
538.DFLTy 549.DFLTy
539.Pp 550.Pp
540If 551If
541.Dq no , 552.Dq no ,
542acts as 553acts as
543.Sy MKPICINSTALL=no MKPROFILE=no . 554.Sy MKPICINSTALL=no MKPROFILE=no .
544. 555.
545.It Sy MKLINT 556.It Sy MKLINT
546.YorN 557.YorN
547Indicates whether 558Indicates whether
548.Xr lint 1 559.Xr lint 1
549will be run against portions of the 560will be run against portions of the
550.Nx 561.Nx
551source code during the build, and whether lint libraries will be 562source code during the build, and whether lint libraries will be
552installed into 563installed into
553.Sy DESTDIR Ns Pa /usr/libdata/lint . 564.Sy DESTDIR Ns Pa /usr/libdata/lint .
554.DFLTy 565.DFLTy
555. 566.
556.It Sy MKLVM 567.It Sy MKLVM
557.YorN 568.YorN
558If not 569If not
559.Dq no , 570.Dq no ,
560build and install the logical volume manager. 571build and install the logical volume manager.
561.DFLTy 572.DFLTy
562. 573.
563.It Sy MKMAN 574.It Sy MKMAN
564.YorN 575.YorN
565Indicates whether manual pages will be installed. 576Indicates whether manual pages will be installed.
566.DFLTy 577.DFLTy
567.Pp 578.Pp
568If 579If
569.Dq no , 580.Dq no ,
570acts as 581acts as
571.Sy MKCATPAGES=no MKHTML=no . 582.Sy MKCATPAGES=no MKHTML=no .
572. 583.
573.It Sy MKMANZ 584.It Sy MKMANZ
574.YorN 585.YorN
575Indicates whether manual pages should be compressed with 586Indicates whether manual pages should be compressed with
576.Xr gzip 1 587.Xr gzip 1
577at installation time. 588at installation time.
578.DFLTn 589.DFLTn
579. 590.
580.It Sy MKMDNS 591.It Sy MKMDNS
581.YorN 592.YorN
582Indicates whether the mDNS (Multicast DNS) infrastructure 593Indicates whether the mDNS (Multicast DNS) infrastructure
583(libraries and support programs) is built and installed. 594(libraries and support programs) is built and installed.
584.DFLTy 595.DFLTy
585. 596.
586.It Sy MKNLS 597.It Sy MKNLS
587.YorN 598.YorN
588Indicates whether Native Language System (NLS) locale zone files will be 599Indicates whether Native Language System (NLS) locale zone files will be
589built and installed. 600built and installed.
590.DFLTy 601.DFLTy
591. 602.
592.It Sy MKNPF 603.It Sy MKNPF
593.YorN 604.YorN
594Indicates whether the NPF packet filter is to be built and installed. 605Indicates whether the NPF packet filter is to be built and installed.
595.DFLTy 606.DFLTy
596. 607.
597.It Sy MKOBJ 608.It Sy MKOBJ
598.YorN 609.YorN
599Indicates whether object directories will be created when running 610Indicates whether object directories will be created when running
600.Dq make obj . 611.Dq make obj .
601If set to 612If set to
602.Dq no , 613.Dq no ,
603then all built files will be located inside the regular source tree. 614then all built files will be located inside the regular source tree.
604.DFLTy 615.DFLTy
605.Pp 616.Pp
606If 617If
607.Dq no , 618.Dq no ,
608acts as 619acts as
609.Sy MKOBJDIRS=no . 620.Sy MKOBJDIRS=no .
610. 621.
611.It Sy MKOBJDIRS 622.It Sy MKOBJDIRS
612.YorN 623.YorN
613Indicates whether object directories will be created automatically 624Indicates whether object directories will be created automatically
614(via a 625(via a
615.Dq make obj 626.Dq make obj
616pass) at the start of a build. 627pass) at the start of a build.
617.DFLTn 628.DFLTn
618. 629.
619.It Sy MKPAM 630.It Sy MKPAM
620.YorN 631.YorN
621Indicates whether the 632Indicates whether the
622.Xr pam 8 633.Xr pam 8
623framework (libraries and support files) is built. 634framework (libraries and support files) is built.
624The pre-PAM code is not supported and may be removed in the future. 635The pre-PAM code is not supported and may be removed in the future.
625.DFLTy 636.DFLTy
626. 637.
627.It Sy MKPCC 638.It Sy MKPCC
628.YorN 639.YorN
629Indicates whether 640Indicates whether
630.Xr pcc 1 641.Xr pcc 1
631or any related libraries 642or any related libraries
632.Pq Sy libpcc , libpccsoftfloat 643.Pq Sy libpcc , libpccsoftfloat
633are built. 644are built.
634.DFLTn 645.DFLTn
635. 646.
636.It Sy MKPF 647.It Sy MKPF
637.YorN 648.YorN
638Indicates whether the 649Indicates whether the
639.Xr pf 4 650.Xr pf 4
640programs, headers and LKM will be built and installed. 651programs, headers and LKM will be built and installed.
641.DFLTy 652.DFLTy
642. 653.
643.It Sy MKPIC 654.It Sy MKPIC
644.YorN 655.YorN
645Indicates whether shared objects and libraries will be created and 656Indicates whether shared objects and libraries will be created and
646installed. 657installed.
647If set to 658If set to
648.Dq no , 659.Dq no ,
649the entire built system will be statically linked. 660the entire built system will be statically linked.
650.DFLT 661.DFLT
651Platform dependent. 662Platform dependent.
652As of this writing, all platforms except 663As of this writing, all platforms except
653.Sy m68000 664.Sy m68000
654default to 665default to
655.Dq yes . 666.Dq yes .
656.Pp 667.Pp
657If 668If
658.Dq no , 669.Dq no ,
659acts as 670acts as
660.Sy MKPICLIB=no . 671.Sy MKPICLIB=no .
661. 672.
662.It Sy MKPICINSTALL 673.It Sy MKPICINSTALL
663.YorN 674.YorN
664Indicates whether the 675Indicates whether the
665.Xr ar 1 676.Xr ar 1
666format libraries 677format libraries
667.Sy ( lib*_pic.a ) , 678.Sy ( lib*_pic.a ) ,
668used to generate shared libraries, are installed. 679used to generate shared libraries, are installed.
669.DFLTy 680.DFLTy
670. 681.
671.It Sy MKPICLIB 682.It Sy MKPICLIB
672.YorN 683.YorN
673Indicates whether the 684Indicates whether the
674.Xr ar 1 685.Xr ar 1
675format libraries 686format libraries
676.Sy ( lib*_pic.a ) , 687.Sy ( lib*_pic.a ) ,
677used to generate shared libraries. 688used to generate shared libraries.
678.DFLTy 689.DFLTy
679. 690.
680.It Sy MKPIE 691.It Sy MKPIE
681Indicates whether Position Independent Executables (PIE) 692Indicates whether Position Independent Executables (PIE)
682are built and installed. 693are built and installed.
683.DFLTn 694.DFLTn
684. 695.
685.It Sy MKPIGZGZIP 696.It Sy MKPIGZGZIP
686.YorN 697.YorN
687If 698If
688.Dq no , 699.Dq no ,
689the 700the
690.Xr pigz 1 701.Xr pigz 1
691utility is not installed as 702utility is not installed as
692.Xr gzip 1 . 703.Xr gzip 1 .
693.DFLTn 704.DFLTn
694. 705.
695.It Sy MKPOSTFIX 706.It Sy MKPOSTFIX
696.YorN 707.YorN
697Indicates whether Postfix is built. 708Indicates whether Postfix is built.
698.DFLTy 709.DFLTy
699. 710.
700.It Sy MKPROFILE 711.It Sy MKPROFILE
701.YorN 712.YorN
702Indicates whether profiled libraries 713Indicates whether profiled libraries
703.Sy ( lib*_p.a ) 714.Sy ( lib*_p.a )
704will be built and installed. 715will be built and installed.
705.DFLT 716.DFLT
706.Dq yes ; 717.Dq yes ;
707however, some platforms turn off 718however, some platforms turn off
708.Sy MKPROFILE 719.Sy MKPROFILE
709by default at times due to toolchain problems with profiled code. 720by default at times due to toolchain problems with profiled code.
710. 721.
711.It Sy MKREPRO 722.It Sy MKREPRO
712.YorN 723.YorN
713Indicates whether builds are to be reproducible. 724Indicates whether builds are to be reproducible.
714If 725If
715.Dq yes , 726.Dq yes ,
716two builds from the same source tree will produce the same build 727two builds from the same source tree will produce the same build
717results. 728results.
718.DFLTn 729.DFLTn
719. 730.
720.It Sy MKRUMP 731.It Sy MKRUMP
721.YorN 732.YorN
722Indicates whether the 733Indicates whether the
723.Xr rump 3 734.Xr rump 3
724headers, libraries and programs are to be installed. 735headers, libraries and programs are to be installed.
725.DFLTy 736.DFLTy
726. 737.
727.It Sy MKSHARE 738.It Sy MKSHARE
728.YorN 739.YorN
729Indicates whether files destined to reside in 740Indicates whether files destined to reside in
730.Sy DESTDIR Ns Pa /usr/share 741.Sy DESTDIR Ns Pa /usr/share
731will be built and installed. 742will be built and installed.
732.DFLTy 743.DFLTy
733.Pp 744.Pp
734If 745If
735.Dq no , 746.Dq no ,
736acts as 747acts as
737.Sy MKCATPAGES=no MKDOC=no MKINFO=no MKHTML=no MKMAN=no MKNLS=no . 748.Sy MKCATPAGES=no MKDOC=no MKINFO=no MKHTML=no MKMAN=no MKNLS=no .
738. 749.
739.It Sy MKSKEY 750.It Sy MKSKEY
740.YorN 751.YorN
741Indicates whether the S/key infrastructure 752Indicates whether the S/key infrastructure
742(libraries and support programs) is built. 753(libraries and support programs) is built.
743.DFLTy 754.DFLTy
744. 755.
745.It Sy MKSOFTFLOAT 756.It Sy MKSOFTFLOAT
746.YorN 757.YorN
747Indicates whether the compiler generates output containing 758Indicates whether the compiler generates output containing
748library calls for floating point and possibly soft-float library 759library calls for floating point and possibly soft-float library
749support. 760support.
750.DFLTn 761.DFLTn
751. 762.
752.It Sy MKSTATICLIB 763.It Sy MKSTATICLIB
753.YorN 764.YorN
754Indicates whether the normal static libraries 765Indicates whether the normal static libraries
755.Sy ( lib*_g.a ) 766.Sy ( lib*_g.a )
756will be built and installed. 767will be built and installed.
757.DFLTy 768.DFLTy
758. 769.
759.It Sy MKSTRIPIDENT 770.It Sy MKSTRIPIDENT
760.YorN 771.YorN
761Indicates whether RCS IDs, for use with 772Indicates whether RCS IDs, for use with
762.Xr ident 1 , 773.Xr ident 1 ,
763should be stripped from program binaries and shared libraries. 774should be stripped from program binaries and shared libraries.
764.DFLTn 775.DFLTn
765. 776.
766.It Sy MKSTRIPSYM 777.It Sy MKSTRIPSYM
767.YorN 778.YorN
768Indicates whether all local symbols should be stripped from shared libraries. 779Indicates whether all local symbols should be stripped from shared libraries.
769If 780If
770.Dq yes , 781.Dq yes ,
771strip all local symbols from shared libraries; 782strip all local symbols from shared libraries;
772the affect is equivalent to the 783the affect is equivalent to the
773.Fl x 784.Fl x
774option of 785option of
775.Xr ld 1 . 786.Xr ld 1 .
776If 787If
777.Dq no , 788.Dq no ,
778strip only temporary local symbols; the affect is equivalent 789strip only temporary local symbols; the affect is equivalent
779to the 790to the
780.Fl X 791.Fl X
781option of 792option of
782.Xr ld 1 . 793.Xr ld 1 .
783Keeping non-temporary local symbols 794Keeping non-temporary local symbols
784such as static function names is useful on using DTrace for 795such as static function names is useful on using DTrace for
785userland libraries and getting a backtrace from a rump kernel 796userland libraries and getting a backtrace from a rump kernel
786loading shared libraries. 797loading shared libraries.
787.DFLTy 798.DFLTy
788. 799.
789.It Sy MKUNPRIVED 800.It Sy MKUNPRIVED
790.YorN 801.YorN
791Indicates whether an unprivileged install will occur. 802Indicates whether an unprivileged install will occur.
792The user, group, permissions, and file flags, will not be set on 803The user, group, permissions, and file flags, will not be set on
793the installed item; instead the information will be appended to 804the installed item; instead the information will be appended to
794a file called 805a file called
795.Pa METALOG 806.Pa METALOG
796in 807in
797.Sy DESTDIR . 808.Sy DESTDIR .
798The contents of 809The contents of
799.Pa METALOG 810.Pa METALOG
800is used during the generation of the distribution tar files to ensure 811is used during the generation of the distribution tar files to ensure
801that the appropriate file ownership is stored. 812that the appropriate file ownership is stored.
802.DFLTn 813.DFLTn
803. 814.
804.It Sy MKUPDATE 815.It Sy MKUPDATE
805.YorN 816.YorN
806Indicates whether all install operations intended to write to 817Indicates whether all install operations intended to write to
807.Sy DESTDIR 818.Sy DESTDIR
808will compare file timestamps before installing, and skip the install 819will compare file timestamps before installing, and skip the install
809phase if the destination files are up-to-date. 820phase if the destination files are up-to-date.
810This also has implications on full builds (see next subsection). 821This also has implications on full builds (see next subsection).
811.DFLTn 822.DFLTn
812. 823.
813.It Sy MKX11 824.It Sy MKX11
814.YorN 825.YorN
815Indicates whether X11 is built and installed 826Indicates whether X11 is built and installed
816(by descending into 827(by descending into
817.Pa src/external/mit/xorg ) . 828.Pa src/external/mit/xorg ) .
818.DFLTn 829.DFLTn
819. 830.
820.It Sy MKX11FONTS 831.It Sy MKX11FONTS
821.YorN 832.YorN
822If 833If
823.Dq no , 834.Dq no ,
824do not build and install the X fonts. 835do not build and install the X fonts.
825.DFLTy 836.DFLTy
826. 837.
827.It Sy X11MOTIFPATH 838.It Sy X11MOTIFPATH
828Location of the Motif installation to use if setting 839Location of the Motif installation to use if setting
829.Sy MKX11MOTIF 840.Sy MKX11MOTIF
830to 841to
831.Dq yes . 842.Dq yes .
832.DFLT 843.DFLT
833.Pa /usr/pkg 844.Pa /usr/pkg
834. 845.
835.It Sy MKX11MOTIF 846.It Sy MKX11MOTIF
836.YorN 847.YorN
837If 848If
838.Dq yes , 849.Dq yes ,
839build the native Xorg libGLw with Motif stubs. 850build the native Xorg libGLw with Motif stubs.
840Requires that Motif can be found via 851Requires that Motif can be found via
841.Sy X11MOTIFPATH . 852.Sy X11MOTIFPATH .
842.DFLTn 853.DFLTn
843. 854.
844.It Sy MKYP 855.It Sy MKYP
845.YorN 856.YorN
846Indicates whether the YP (NIS) infrastructure 857Indicates whether the YP (NIS) infrastructure
847(libraries and support programs) is built. 858(libraries and support programs) is built.
848.DFLTy 859.DFLTy
849. 860.
850.It Sy MKZFS 861.It Sy MKZFS
851.YorN 862.YorN
852Indicates whether the ZFS kernel module and the utilities and 863Indicates whether the ZFS kernel module and the utilities and
853libraries used to manage the ZFS system are to be built. 864libraries used to manage the ZFS system are to be built.
854.DFLTy 865.DFLTy
855on amd64, 866on amd64,
856.Dq no 867.Dq no
857on other architectures. 868on other architectures.
858. 869.
859.It Sy OBJMACHINE 870.It Sy OBJMACHINE
860If defined, creates objdirs of the form 871If defined, creates objdirs of the form
861.Pa obj. Ns Sy MACHINE , 872.Pa obj. Ns Sy MACHINE ,
862where 873where
863.Sy MACHINE 874.Sy MACHINE
864is the current architecture (as per 875is the current architecture (as per
865.Sq "uname -m" ) . 876.Sq "uname -m" ) .
866. 877.
867.It Sy RELEASEDIR 878.It Sy RELEASEDIR
868If set, specifies the directory to which a 879If set, specifies the directory to which a
869.Xr release 7 880.Xr release 7
870layout will be written at the end of a 881layout will be written at the end of a
871.Dq make release . 882.Dq make release .
872.DFLTu 883.DFLTu
873.Pp 884.Pp
874.Em Note : 885.Em Note :
875.Sy build.sh 886.Sy build.sh
876will provide a default of 887will provide a default of
877.Pa releasedir 888.Pa releasedir
878(in the top-level 889(in the top-level
879.Sy .OBJDIR ) 890.Sy .OBJDIR )
880unless run in 891unless run in
881.Sq expert 892.Sq expert
882mode 893mode
883. 894.
884.It Sy TOOLDIR 895.It Sy TOOLDIR
885Directory to hold the host tools, once built. 896Directory to hold the host tools, once built.
886This directory should be unique to a given host system and 897This directory should be unique to a given host system and
887.Nx 898.Nx
888source tree. 899source tree.
889(However, multiple targets may share the same 900(However, multiple targets may share the same
890.Sy TOOLDIR ; 901.Sy TOOLDIR ;
891the target-dependent files have unique names.) 902the target-dependent files have unique names.)
892If unset, a default based 903If unset, a default based
893on the 904on the
894.Xr uname 1 905.Xr uname 1
895information of the host platform will be created in the 906information of the host platform will be created in the
896.Sy .OBJDIR 907.Sy .OBJDIR
897of 908of
898.Pa src . 909.Pa src .
899.DFLTu 910.DFLTu
900. 911.
901.It Sy USE_FORT 912.It Sy USE_FORT
902Indicates whether the so-called 913Indicates whether the so-called
903.Dq FORTIFY_SOURCE 914.Dq FORTIFY_SOURCE
904.Xr security 7 915.Xr security 7
905extensions are enabled; see 916extensions are enabled; see
906.Xr ssp 3 917.Xr ssp 3
907for details. 918for details.
908This imposes some performance penalty. 919This imposes some performance penalty.
909.DFLTn 920.DFLTn
910. 921.
911.It Sy USE_HESIOD 922.It Sy USE_HESIOD
912.YorN 923.YorN
913Indicates whether Hesiod support is 924Indicates whether Hesiod support is
914enabled in the various applications that support it. 925enabled in the various applications that support it.
915If 926If
916.Sy MKHESIOD=no , 927.Sy MKHESIOD=no ,
917.Sy USE_HESIOD 928.Sy USE_HESIOD
918will also be forced to 929will also be forced to
919.Dq no . 930.Dq no .
920.DFLTy 931.DFLTy
921. 932.
922.It Sy USE_INET6 933.It Sy USE_INET6
923.YorN 934.YorN
924Indicates whether INET6 (IPv6) support is 935Indicates whether INET6 (IPv6) support is
925enabled in the various applications that support it. 936enabled in the various applications that support it.
926If 937If
927.Sy MKINET6=no , 938.Sy MKINET6=no ,
928.Sy USE_INET6 939.Sy USE_INET6
929will also be forced to 940will also be forced to
930.Dq no . 941.Dq no .
931.DFLTy 942.DFLTy
932. 943.
933.It Sy USE_JEMALLOC 944.It Sy USE_JEMALLOC
934.YorN 945.YorN
935Indicates whether the 946Indicates whether the
936.Em jemalloc 947.Em jemalloc
937allocator 948allocator
938.Pq which is designed for improved performance with threaded applications 949.Pq which is designed for improved performance with threaded applications
939is used instead of the 950is used instead of the
940.Em phkmalloc 951.Em phkmalloc
941allocator 952allocator
942.Pq that was the default until Nx 5.0 . 953.Pq that was the default until Nx 5.0 .
943.DFLTy 954.DFLTy
944. 955.
945.It Sy USE_KERBEROS 956.It Sy USE_KERBEROS
946.YorN 957.YorN
947Indicates whether Kerberos v5 support is 958Indicates whether Kerberos v5 support is
948enabled in the various applications that support it. 959enabled in the various applications that support it.
949If 960If
950.Sy MKKERBEROS=no , 961.Sy MKKERBEROS=no ,
951.Sy USE_KERBEROS 962.Sy USE_KERBEROS
952will also be forced to 963will also be forced to
953.Dq no . 964.Dq no .
954.DFLTy 965.DFLTy
955. 966.
956.It Sy USE_LDAP 967.It Sy USE_LDAP
957.YorN 968.YorN
958Indicates whether LDAP support is 969Indicates whether LDAP support is
959enabled in the various applications that support it. 970enabled in the various applications that support it.
960If 971If
961.Sy MKLDAP=no , 972.Sy MKLDAP=no ,
962.Sy USE_LDAP 973.Sy USE_LDAP
963will also be forced to 974will also be forced to
964.Dq no . 975.Dq no .
965.DFLTy 976.DFLTy
966. 977.
967.It Sy USE_PAM 978.It Sy USE_PAM
968.YorN 979.YorN
969Indicates whether 980Indicates whether
970.Xr pam 8 981.Xr pam 8
971support is enabled in the various applications that support it. 982support is enabled in the various applications that support it.
972If 983If
973.Sy MKPAM=no , 984.Sy MKPAM=no ,
974.Sy USE_PAM 985.Sy USE_PAM
975will also be forced to 986will also be forced to
976.Dq no . 987.Dq no .
977.DFLTy 988.DFLTy
978. 989.
979.It Sy USE_SKEY 990.It Sy USE_SKEY
980.YorN 991.YorN
981Indicates whether S/key support is 992Indicates whether S/key support is
982enabled in the various applications that support it. 993enabled in the various applications that support it.
983If 994If
984.Sy MKSKEY=no , 995.Sy MKSKEY=no ,
985.Sy USE_SKEY 996.Sy USE_SKEY
986will also be forced to 997will also be forced to
987.Dq no . 998.Dq no .
988.DFLTy 999.DFLTy
989.Pp 1000.Pp
990This is mutually exclusive to 1001This is mutually exclusive to
991.Sy USE_PAM!=no . 1002.Sy USE_PAM!=no .
992. 1003.
993.It Sy USE_SSP 1004.It Sy USE_SSP
994.YorN 1005.YorN
995Indicates whether GCC stack-smashing protection (SSP) support, 1006Indicates whether GCC stack-smashing protection (SSP) support,
996which detects stack overflows and aborts the program, 1007which detects stack overflows and aborts the program,
997is enabled. 1008is enabled.
998This imposes some performance penalty. 1009This imposes some performance penalty.
999.DFLTn 1010.DFLTn
1000. 1011.
1001.It Sy USE_YP 1012.It Sy USE_YP
1002.YorN 1013.YorN
1003Indicates whether YP (NIS) support is 1014Indicates whether YP (NIS) support is
1004enabled in the various applications that support it. 1015enabled in the various applications that support it.
1005If 1016If
1006.Sy MKYP=no , 1017.Sy MKYP=no ,
1007.Sy USE_YP 1018.Sy USE_YP
1008will also be forced to 1019will also be forced to
1009.Dq no . 1020.Dq no .
1010.DFLTy 1021.DFLTy
1011. 1022.
1012.It Sy USETOOLS 1023.It Sy USETOOLS
1013Indicates whether the tools specified by 1024Indicates whether the tools specified by
1014.Sy TOOLDIR 1025.Sy TOOLDIR
1015should be used as part of a build in progress. 1026should be used as part of a build in progress.
1016Must be set to 1027Must be set to
1017.Dq yes 1028.Dq yes
1018if cross-compiling. 1029if cross-compiling.
1019.Bl -tag -width "never" 1030.Bl -tag -width "never"
1020.It Sy yes 1031.It Sy yes
1021Use the tools from 1032Use the tools from
1022.Sy TOOLDIR . 1033.Sy TOOLDIR .
1023.It Sy no 1034.It Sy no
1024Do not use the tools from 1035Do not use the tools from
1025.Sy TOOLDIR , 1036.Sy TOOLDIR ,
1026but refuse to build native compilation tool components that are 1037but refuse to build native compilation tool components that are
1027version-specific for that tool. 1038version-specific for that tool.
1028.It Sy never 1039.It Sy never
1029Do not use the tools from 1040Do not use the tools from
1030.Sy TOOLDIR , 1041.Sy TOOLDIR ,
1031even when building native tool components. 1042even when building native tool components.
1032This is similar to the traditional 1043This is similar to the traditional
1033.Nx 1044.Nx
1034build method, but does 1045build method, but does
1035.Em not 1046.Em not
1036verify that the compilation tools in use are up-to-date enough in order 1047verify that the compilation tools in use are up-to-date enough in order
1037to build the tree successfully. 1048to build the tree successfully.
1038This may cause build or runtime problems when building the whole 1049This may cause build or runtime problems when building the whole
1039.Nx 1050.Nx
1040source tree. 1051source tree.
1041.El 1052.El
1042.DFLT 1053.DFLT
1043.Dq yes 1054.Dq yes
1044if building all or part of a whole 1055if building all or part of a whole
1045.Nx 1056.Nx
1046source tree (detected automatically); 1057source tree (detected automatically);
1047.Dq no 1058.Dq no
1048otherwise (to preserve traditional semantics of the 1059otherwise (to preserve traditional semantics of the
1049.Aq bsd.*.mk 1060.Aq bsd.*.mk
1050.Xr make 1 1061.Xr make 1
1051include files). 1062include files).
1052. 1063.
1053.El 1064.El
1054. 1065.
1055.Ss pkgsrc system variables 1066.Ss pkgsrc system variables
1056. 1067.
1057Please see the pkgsrc guide at 1068Please see the pkgsrc guide at
1058.Lk http://www.netbsd.org/Documentation/pkgsrc/ 1069.Lk http://www.netbsd.org/Documentation/pkgsrc/
1059or 1070or
1060.Pa pkgsrc/doc/pkgsrc.txt 1071.Pa pkgsrc/doc/pkgsrc.txt
1061for more variables used internally by the package system and 1072for more variables used internally by the package system and
1062.Pa ${PKGSRCDIR}/mk/defaults/mk.conf 1073.Pa ${PKGSRCDIR}/mk/defaults/mk.conf
1063for package-specific examples. 1074for package-specific examples.
1064. 1075.
1065.Sh FILES 1076.Sh FILES
1066.Bl -tag -width /etc/mk.conf 1077.Bl -tag -width /etc/mk.conf
1067. 1078.
1068.It Pa /etc/mk.conf 1079.It Pa /etc/mk.conf
1069This file. 1080This file.
1070. 1081.
1071.It Pa ${PKGSRCDIR}/mk/defaults/mk.conf 1082.It Pa ${PKGSRCDIR}/mk/defaults/mk.conf
1072Examples for settings regarding the pkgsrc collection. 1083Examples for settings regarding the pkgsrc collection.
1073.El 1084.El
1074. 1085.
1075.Sh SEE ALSO 1086.Sh SEE ALSO
1076.Xr make 1 , 1087.Xr make 1 ,
1077.Pa /usr/share/mk/bsd.README , 1088.Pa /usr/share/mk/bsd.README ,
1078.Pa pkgsrc/doc/pkgsrc.txt , 1089.Pa pkgsrc/doc/pkgsrc.txt ,
1079.Lk http://www.netbsd.org/Documentation/pkgsrc/ 1090.Lk http://www.netbsd.org/Documentation/pkgsrc/
1080.Sh HISTORY 1091.Sh HISTORY
1081The 1092The
1082.Nm 1093.Nm
1083file appeared in 1094file appeared in
1084.Nx 1.2 . 1095.Nx 1.2 .