]> CyberLeo.Net >> Repos - FreeBSD/FreeBSD.git/blob - share/man/man5/src.conf.5
Update nvi to 2.2.0
[FreeBSD/FreeBSD.git] / share / man / man5 / src.conf.5
1 .\" DO NOT EDIT-- this file is @generated by tools/build/options/makeman.
2 .\" $FreeBSD$
3 .Dd September 8, 2020
4 .Dt SRC.CONF 5
5 .Os
6 .Sh NAME
7 .Nm src.conf
8 .Nd "source build options"
9 .Sh DESCRIPTION
10 The
11 .Nm
12 file contains settings that will apply to every build involving the
13 .Fx
14 source tree; see
15 .Xr build 7 .
16 .Pp
17 The
18 .Nm
19 file uses the standard makefile syntax.
20 However,
21 .Nm
22 should not specify any dependencies to
23 .Xr make 1 .
24 Instead,
25 .Nm
26 is to set
27 .Xr make 1
28 variables that control the aspects of how the system builds.
29 .Pp
30 The default location of
31 .Nm
32 is
33 .Pa /etc/src.conf ,
34 though an alternative location can be specified in the
35 .Xr make 1
36 variable
37 .Va SRCCONF .
38 Overriding the location of
39 .Nm
40 may be necessary if the system-wide settings are not suitable
41 for a particular build.
42 For instance, setting
43 .Va SRCCONF
44 to
45 .Pa /dev/null
46 effectively resets all build controls to their defaults.
47 .Pp
48 The only purpose of
49 .Nm
50 is to control the compilation of the
51 .Fx
52 source code, which is usually located in
53 .Pa /usr/src .
54 As a rule, the system administrator creates
55 .Nm
56 when the values of certain control variables need to be changed
57 from their defaults.
58 .Pp
59 In addition, control variables can be specified
60 for a particular build via the
61 .Fl D
62 option of
63 .Xr make 1
64 or in its environment; see
65 .Xr environ 7 .
66 .Pp
67 The environment of
68 .Xr make 1
69 for the build can be controlled via the
70 .Va SRC_ENV_CONF
71 variable, which defaults to
72 .Pa /etc/src-env.conf .
73 Some examples that may only be set in this file are
74 .Va WITH_DIRDEPS_BUILD ,
75 and
76 .Va WITH_META_MODE ,
77 and
78 .Va MAKEOBJDIRPREFIX
79 as they are environment-only variables.
80 .Pp
81 The values of variables are ignored regardless of their setting;
82 even if they would be set to
83 .Dq Li FALSE
84 or
85 .Dq Li NO .
86 The presence of an option causes
87 it to be honored by
88 .Xr make 1 .
89 .Pp
90 This list provides a name and short description for variables
91 that can be used for source builds.
92 .Bl -tag -width indent
93 .It Va WITHOUT_ACCT
94 Set to not build process accounting tools such as
95 .Xr accton 8
96 and
97 .Xr sa 8 .
98 .It Va WITHOUT_ACPI
99 Set to not build
100 .Xr acpiconf 8 ,
101 .Xr acpidump 8
102 and related programs.
103 .It Va WITHOUT_APM
104 Set to not build
105 .Xr apm 8 ,
106 .Xr apmd 8
107 and related programs.
108 .It Va WITHOUT_ASSERT_DEBUG
109 Set to compile programs and libraries without the
110 .Xr assert 3
111 checks.
112 .It Va WITHOUT_AT
113 Set to not build
114 .Xr at 1
115 and related utilities.
116 .It Va WITHOUT_ATM
117 Set to not build
118 programs and libraries related to ATM networking.
119 .It Va WITHOUT_AUDIT
120 Set to not build audit support into system programs.
121 .It Va WITHOUT_AUTHPF
122 Set to not build
123 .Xr authpf 8 .
124 .It Va WITHOUT_AUTOFS
125 Set to not build
126 .Xr autofs 5
127 related programs, libraries, and kernel modules.
128 .It Va WITHOUT_AUTO_OBJ
129 Disable automatic creation of objdirs.
130 This is enabled by default if the wanted OBJDIR is writable by the current user.
131 .Pp
132 This must be set in the environment, make command line, or
133 .Pa /etc/src-env.conf ,
134 not
135 .Pa /etc/src.conf .
136 .It Va WITH_BEARSSL
137 Build the BearSSL library.
138 .Pp
139 BearSSL is a tiny SSL library suitable for embedded environments.
140 For details see
141 .Lk http://www.BearSSL.org/
142 .Pp
143 This library is currently only used to perform
144 signature verification and related operations
145 for Verified Exec and
146 .Xr loader 8 .
147 When set, these options are also in effect:
148 .Pp
149 .Bl -inset -compact
150 .It Va WITH_LOADER_EFI_SECUREBOOT
151 (unless
152 .Va WITHOUT_LOADER_EFI_SECUREBOOT
153 is set explicitly)
154 .It Va WITH_LOADER_VERIEXEC
155 (unless
156 .Va WITHOUT_LOADER_VERIEXEC
157 is set explicitly)
158 .It Va WITH_LOADER_VERIEXEC_VECTX
159 (unless
160 .Va WITHOUT_LOADER_VERIEXEC_VECTX
161 is set explicitly)
162 .It Va WITH_VERIEXEC
163 (unless
164 .Va WITHOUT_VERIEXEC
165 is set explicitly)
166 .El
167 .It Va WITHOUT_BHYVE
168 Set to not build or install
169 .Xr bhyve 8 ,
170 associated utilities, and examples.
171 .Pp
172 This option only affects amd64/amd64.
173 .It Va WITH_BHYVE_SNAPSHOT
174 Set to include support for save and restore (snapshots) in
175 .Xr bhyve 8
176 and
177 .Xr bhyvectl 8 .
178 .Pp
179 This option only affects amd64/amd64.
180 .It Va WITH_BIND_NOW
181 Build all binaries with the
182 .Dv DF_BIND_NOW
183 flag set to indicate that the run-time loader should perform all relocation
184 processing at process startup rather than on demand.
185 .It Va WITHOUT_BLACKLIST
186 Set this if you do not want to build
187 .Xr blacklistd 8
188 and
189 .Xr blacklistctl 8 .
190 When set, these options are also in effect:
191 .Pp
192 .Bl -inset -compact
193 .It Va WITHOUT_BLACKLIST_SUPPORT
194 (unless
195 .Va WITH_BLACKLIST_SUPPORT
196 is set explicitly)
197 .El
198 .It Va WITHOUT_BLACKLIST_SUPPORT
199 Set to build some programs without
200 .Xr libblacklist 3
201 support, like
202 .Xr fingerd 8 ,
203 .Xr ftpd 8 ,
204 and
205 .Xr sshd 8 .
206 .It Va WITHOUT_BLUETOOTH
207 Set to not build Bluetooth related kernel modules, programs and libraries.
208 .It Va WITHOUT_BOOT
209 Set to not build the boot blocks and loader.
210 .It Va WITHOUT_BOOTPARAMD
211 Set to not build or install
212 .Xr bootparamd 8 .
213 .It Va WITHOUT_BOOTPD
214 Set to not build or install
215 .Xr bootpd 8 .
216 .It Va WITHOUT_BSDINSTALL
217 Set to not build
218 .Xr bsdinstall 8 ,
219 .Xr sade 8 ,
220 and related programs.
221 .It Va WITHOUT_BSD_CPIO
222 Set to not build the BSD licensed version of cpio based on
223 .Xr libarchive 3 .
224 .It Va WITH_BSD_GREP
225 Install BSD-licensed grep as '[ef]grep' instead of GNU grep.
226 .It Va WITHOUT_BSNMP
227 Set to not build or install
228 .Xr bsnmpd 1
229 and related libraries and data files.
230 .It Va WITHOUT_BZIP2
231 Set to not build contributed bzip2 software as a part of the base system.
232 .Bf -symbolic
233 The option has no effect yet.
234 .Ef
235 When set, these options are also in effect:
236 .Pp
237 .Bl -inset -compact
238 .It Va WITHOUT_BZIP2_SUPPORT
239 (unless
240 .Va WITH_BZIP2_SUPPORT
241 is set explicitly)
242 .El
243 .It Va WITHOUT_BZIP2_SUPPORT
244 Set to build some programs without optional bzip2 support.
245 .It Va WITHOUT_CALENDAR
246 Set to not build
247 .Xr calendar 1 .
248 .It Va WITHOUT_CAPSICUM
249 Set to not build Capsicum support into system programs.
250 When set, it enforces these options:
251 .Pp
252 .Bl -item -compact
253 .It
254 .Va WITHOUT_CASPER
255 .El
256 .It Va WITHOUT_CAROOT
257 Set to not add the trusted certificates from the Mozilla NSS bundle to
258 base.
259 .It Va WITHOUT_CASPER
260 Set to not build Casper program and related libraries.
261 .It Va WITH_CCACHE_BUILD
262 Set to use
263 .Xr ccache 1
264 for the build.
265 No configuration is required except to install the
266 .Sy devel/ccache
267 package.
268 When using with
269 .Xr distcc 1 ,
270 set
271 .Sy CCACHE_PREFIX=/usr/local/bin/distcc .
272 The default cache directory of
273 .Pa $HOME/.ccache
274 will be used, which can be overridden by setting
275 .Sy CCACHE_DIR .
276 The
277 .Sy CCACHE_COMPILERCHECK
278 option defaults to
279 .Sy content
280 when using the in-tree bootstrap compiler,
281 and
282 .Sy mtime
283 when using an external compiler.
284 The
285 .Sy CCACHE_CPP2
286 option is used for Clang but not GCC.
287 .Pp
288 Sharing a cache between multiple work directories requires using a layout
289 similar to
290 .Pa /some/prefix/src
291 .Pa /some/prefix/obj
292 and an environment such as:
293 .Bd -literal -offset indent
294 CCACHE_BASEDIR='${SRCTOP:H}' MAKEOBJDIRPREFIX='${SRCTOP:H}/obj'
295 .Ed
296 .Pp
297 See
298 .Xr ccache 1
299 for more configuration options.
300 .It Va WITHOUT_CCD
301 Set to not build
302 .Xr geom_ccd 4
303 and related utilities.
304 .It Va WITHOUT_CDDL
305 Set to not build code licensed under Sun's CDDL.
306 When set, it enforces these options:
307 .Pp
308 .Bl -item -compact
309 .It
310 .Va WITHOUT_CTF
311 .It
312 .Va WITHOUT_LOADER_ZFS
313 .It
314 .Va WITHOUT_ZFS
315 .El
316 .It Va WITHOUT_CLANG
317 Set to not build the Clang C/C++ compiler during the regular phase of the build.
318 When set, it enforces these options:
319 .Pp
320 .Bl -item -compact
321 .It
322 .Va WITHOUT_CLANG_EXTRAS
323 .It
324 .Va WITHOUT_CLANG_FORMAT
325 .It
326 .Va WITHOUT_CLANG_FULL
327 .It
328 .Va WITHOUT_LLVM_COV
329 .El
330 .It Va WITHOUT_CLANG_BOOTSTRAP
331 Set to not build the Clang C/C++ compiler during the bootstrap phase of
332 the build.
333 To be able to build the system, either gcc or clang bootstrap must be
334 enabled unless an alternate compiler is provided via XCC.
335 .It Va WITH_CLANG_EXTRAS
336 Set to build additional clang and llvm tools, such as bugpoint and
337 clang-format.
338 .It Va WITH_CLANG_FORMAT
339 Set to build clang-format.
340 .It Va WITHOUT_CLANG_FULL
341 Set to avoid building the ARCMigrate, Rewriter and StaticAnalyzer components of
342 the Clang C/C++ compiler.
343 .It Va WITHOUT_CLANG_IS_CC
344 Do not install links to the Clang C/C++ compiler as
345 .Pa /usr/bin/cc ,
346 .Pa /usr/bin/c++
347 and
348 .Pa /usr/bin/cpp .
349 .It Va WITHOUT_CLEAN
350 Do not clean before building world and/or kernel.
351 .It Va WITHOUT_CPP
352 Set to not build
353 .Xr cpp 1 .
354 .It Va WITHOUT_CROSS_COMPILER
355 Set to not build any cross compiler in the cross-tools stage of buildworld.
356 When compiling a different version of
357 .Fx
358 than what is installed on the system, provide an alternate
359 compiler with XCC to ensure success.
360 When compiling with an identical version of
361 .Fx
362 to the host, this option may be safely used.
363 This option may also be safe when the host version of
364 .Fx
365 is close to the sources being built, but all bets are off if there have
366 been any changes to the toolchain between the versions.
367 When set, it enforces these options:
368 .Pp
369 .Bl -item -compact
370 .It
371 .Va WITHOUT_CLANG_BOOTSTRAP
372 .It
373 .Va WITHOUT_ELFTOOLCHAIN_BOOTSTRAP
374 .It
375 .Va WITHOUT_LLD_BOOTSTRAP
376 .El
377 .It Va WITHOUT_CRYPT
378 Set to not build any crypto code.
379 When set, it enforces these options:
380 .Pp
381 .Bl -item -compact
382 .It
383 .Va WITHOUT_DMAGENT
384 .It
385 .Va WITHOUT_KERBEROS
386 .It
387 .Va WITHOUT_KERBEROS_SUPPORT
388 .It
389 .Va WITHOUT_LDNS
390 .It
391 .Va WITHOUT_LDNS_UTILS
392 .It
393 .Va WITHOUT_OPENSSH
394 .It
395 .Va WITHOUT_OPENSSL
396 .It
397 .Va WITHOUT_PKGBOOTSTRAP
398 .It
399 .Va WITHOUT_SVN
400 .It
401 .Va WITHOUT_SVNLITE
402 .It
403 .Va WITHOUT_UNBOUND
404 .It
405 .Va WITHOUT_WIRELESS
406 .El
407 .Pp
408 When set, these options are also in effect:
409 .Pp
410 .Bl -inset -compact
411 .It Va WITHOUT_GSSAPI
412 (unless
413 .Va WITH_GSSAPI
414 is set explicitly)
415 .El
416 .It Va WITH_CTF
417 Set to compile with CTF (Compact C Type Format) data.
418 CTF data encapsulates a reduced form of debugging information
419 similar to DWARF and the venerable stabs and is required for DTrace.
420 .It Va WITHOUT_CUSE
421 Set to not build CUSE-related programs and libraries.
422 .It Va WITHOUT_CXGBETOOL
423 Set to not build
424 .Xr cxgbetool 8
425 .Pp
426 This is a default setting on
427 arm/armv6, arm/armv7, mips/mips, mips/mips64, powerpc/powerpc, riscv/riscv64 and riscv/riscv64sf.
428 .It Va WITH_CXGBETOOL
429 Set to build
430 .Xr cxgbetool 8
431 .Pp
432 This is a default setting on
433 amd64/amd64, arm64/aarch64, i386/i386 and powerpc/powerpc64.
434 .It Va WITHOUT_CXX
435 Set to not build
436 .Xr c++ 1
437 and related libraries.
438 It will also prevent building of
439 .Xr gperf 1
440 and
441 .Xr devd 8 .
442 When set, it enforces these options:
443 .Pp
444 .Bl -item -compact
445 .It
446 .Va WITHOUT_CLANG
447 .It
448 .Va WITHOUT_CLANG_EXTRAS
449 .It
450 .Va WITHOUT_CLANG_FORMAT
451 .It
452 .Va WITHOUT_CLANG_FULL
453 .It
454 .Va WITHOUT_DTRACE_TESTS
455 .It
456 .Va WITHOUT_GOOGLETEST
457 .It
458 .Va WITHOUT_LLVM_COV
459 .It
460 .Va WITHOUT_TESTS
461 .El
462 .It Va WITHOUT_DEBUG_FILES
463 Set to avoid building or installing standalone debug files for each
464 executable binary and shared library.
465 .It Va WITHOUT_DIALOG
466 Set to not build
467 .Xr dialog 1 ,
468 .Xr dialog 3 ,
469 .Xr dpv 1 ,
470 and
471 .Xr dpv 3 .
472 When set, it enforces these options:
473 .Pp
474 .Bl -item -compact
475 .It
476 .Va WITHOUT_BSDINSTALL
477 .El
478 .It Va WITHOUT_DICT
479 Set to not build the Webster dictionary files.
480 .It Va WITH_DIRDEPS_BUILD
481 This is an experimental build system.
482 For details see
483 http://www.crufty.net/sjg/docs/freebsd-meta-mode.htm.
484 Build commands can be seen from the top-level with:
485 .Dl make show-valid-targets
486 The build is driven by dirdeps.mk using
487 .Va DIRDEPS
488 stored in
489 Makefile.depend files found in each directory.
490 .Pp
491 The build can be started from anywhere, and behaves the same.
492 The initial instance of
493 .Xr make 1
494 recursively reads
495 .Va DIRDEPS
496 from
497 .Pa Makefile.depend ,
498 computing a graph of tree dependencies from the current origin.
499 Setting
500 .Va NO_DIRDEPS
501 skips checking dirdep dependencies and will only build in the current
502 and child directories.
503 .Va NO_DIRDEPS_BELOW
504 skips building any dirdeps and only build the current directory.
505 .Pp
506 This also utilizes the
507 .Va WITH_META_MODE
508 logic for incremental builds.
509 .Pp
510 The build hides commands executed unless
511 .Va NO_SILENT
512 is defined.
513 .Pp
514 Note that there is currently no mass install feature for this.
515 .Pp
516 When set, it enforces these options:
517 .Pp
518 .Bl -item -compact
519 .It
520 .Va WITH_INSTALL_AS_USER
521 .El
522 .Pp
523 When set, these options are also in effect:
524 .Pp
525 .Bl -inset -compact
526 .It Va WITH_META_MODE
527 (unless
528 .Va WITHOUT_META_MODE
529 is set explicitly)
530 .It Va WITH_STAGING
531 (unless
532 .Va WITHOUT_STAGING
533 is set explicitly)
534 .It Va WITH_STAGING_MAN
535 (unless
536 .Va WITHOUT_STAGING_MAN
537 is set explicitly)
538 .It Va WITH_STAGING_PROG
539 (unless
540 .Va WITHOUT_STAGING_PROG
541 is set explicitly)
542 .It Va WITH_SYSROOT
543 (unless
544 .Va WITHOUT_SYSROOT
545 is set explicitly)
546 .El
547 .Pp
548 This must be set in the environment, make command line, or
549 .Pa /etc/src-env.conf ,
550 not
551 .Pa /etc/src.conf .
552 .It Va WITH_DIRDEPS_CACHE
553 Cache result of dirdeps.mk which can save significant time
554 for subsequent builds.
555 Depends on
556 .Va WITH_DIRDEPS_BUILD .
557 .Pp
558 This must be set in the environment, make command line, or
559 .Pa /etc/src-env.conf ,
560 not
561 .Pa /etc/src.conf .
562 .It Va WITHOUT_DMAGENT
563 Set to not build dma Mail Transport Agent.
564 .It Va WITHOUT_DOCCOMPRESS
565 Set to not install compressed system documentation.
566 Only the uncompressed version will be installed.
567 .It Va WITH_DTRACE_TESTS
568 Set to build and install the DTrace test suite in
569 .Pa /usr/tests/cddl/usr.sbin/dtrace .
570 This test suite is considered experimental on architectures other than
571 amd64/amd64 and running it may cause system instability.
572 .It Va WITHOUT_DYNAMICROOT
573 Set this if you do not want to link
574 .Pa /bin
575 and
576 .Pa /sbin
577 dynamically.
578 .It Va WITHOUT_EE
579 Set to not build and install
580 .Xr edit 1 ,
581 .Xr ee 1 ,
582 and related programs.
583 .It Va WITHOUT_EFI
584 Set not to build
585 .Xr efivar 3
586 and
587 .Xr efivar 8 .
588 .Pp
589 This is a default setting on
590 mips/mips, mips/mips64, powerpc/powerpc and powerpc/powerpc64.
591 .It Va WITH_EFI
592 Set to build
593 .Xr efivar 3
594 and
595 .Xr efivar 8 .
596 .Pp
597 This is a default setting on
598 amd64/amd64, arm/armv6, arm/armv7, arm64/aarch64, i386/i386, riscv/riscv64 and riscv/riscv64sf.
599 .It Va WITHOUT_ELFTOOLCHAIN_BOOTSTRAP
600 Set to not build ELF Tool Chain tools
601 (addr2line, nm, size, strings and strip)
602 as part of the bootstrap process.
603 .Bf -symbolic
604 An alternate bootstrap tool chain must be provided.
605 .Ef
606 .It Va WITHOUT_EXAMPLES
607 Set to avoid installing examples to
608 .Pa /usr/share/examples/ .
609 .It Va WITH_EXPERIMENTAL
610 Set to include experimental features in the build.
611 .It Va WITH_EXTRA_TCP_STACKS
612 Set to build extra TCP stack modules.
613 .It Va WITHOUT_FDT
614 Set to not build Flattened Device Tree support as part of the base system.
615 This includes the device tree compiler (dtc) and libfdt support library.
616 .It Va WITHOUT_FILE
617 Set to not build
618 .Xr file 1
619 and related programs.
620 When set, it enforces these options:
621 .Pp
622 .Bl -item -compact
623 .It
624 .Va WITHOUT_SVNLITE
625 .El
626 .It Va WITHOUT_FINGER
627 Set to not build or install
628 .Xr finger 1
629 and
630 .Xr fingerd 8 .
631 .It Va WITHOUT_FLOPPY
632 Set to not build or install programs
633 for operating floppy disk driver.
634 .It Va WITHOUT_FMTREE
635 Set to not build and install
636 .Pa /usr/sbin/fmtree .
637 .It Va WITHOUT_FORMAT_EXTENSIONS
638 Set to not enable
639 .Fl fformat-extensions
640 when compiling the kernel.
641 Also disables all format checking.
642 .It Va WITHOUT_FORTH
643 Set to build bootloaders without Forth support.
644 .It Va WITHOUT_FP_LIBC
645 Set to build
646 .Nm libc
647 without floating-point support.
648 .It Va WITHOUT_FREEBSD_UPDATE
649 Set to not build
650 .Xr freebsd-update 8 .
651 .It Va WITHOUT_FTP
652 Set to not build or install
653 .Xr ftp 1
654 and
655 .Xr ftpd 8 .
656 .It Va WITHOUT_GAMES
657 Set to not build games.
658 .It Va WITHOUT_GDB
659 Set to not build
660 .Xr gdb 1 .
661 .Pp
662 This is a default setting on
663 arm64/aarch64, riscv/riscv64 and riscv/riscv64sf.
664 .It Va WITH_GDB
665 Set to build
666 .Xr gdb 1 .
667 .Pp
668 This is a default setting on
669 amd64/amd64, arm/armv6, arm/armv7, i386/i386, mips/mips, mips/mips64, powerpc/powerpc and powerpc/powerpc64.
670 .It Va WITHOUT_GNU_DIFF
671 Set to not build GNU
672 .Xr diff3 1 .
673 .It Va WITHOUT_GNU_GREP
674 Set to not build GNU
675 .Xr grep 1 .
676 .It Va WITH_GNU_GREP_COMPAT
677 Set this option to include GNU extensions in
678 .Xr bsdgrep 1
679 by linking against libgnuregex.
680 .It Va WITHOUT_GOOGLETEST
681 Set to neither build nor install
682 .Lb libgmock ,
683 .Lb libgtest ,
684 and dependent tests.
685 .Pp
686 This is a default setting on
687 mips/mips and mips/mips64.
688 .It Va WITH_GOOGLETEST
689 Set to build and install
690 .Lb libgmock ,
691 .Lb libgtest ,
692 and dependent tests.
693 .Pp
694 This is a default setting on
695 amd64/amd64, arm/armv6, arm/armv7, arm64/aarch64, i386/i386, powerpc/powerpc, powerpc/powerpc64, riscv/riscv64 and riscv/riscv64sf.
696 .It Va WITHOUT_GPIO
697 Set to not build
698 .Xr gpioctl 8
699 as part of the base system.
700 .It Va WITHOUT_GSSAPI
701 Set to not build libgssapi.
702 .It Va WITHOUT_HAST
703 Set to not build
704 .Xr hastd 8
705 and related utilities.
706 .It Va WITH_HESIOD
707 Set to build Hesiod support.
708 .It Va WITHOUT_HTML
709 Set to not build HTML docs.
710 .It Va WITHOUT_HYPERV
711 Set to not build or install HyperV utilities.
712 .Pp
713 This is a default setting on
714 arm/armv6, arm/armv7, arm64/aarch64, mips/mips, mips/mips64, powerpc/powerpc, powerpc/powerpc64, riscv/riscv64 and riscv/riscv64sf.
715 .It Va WITH_HYPERV
716 Set to build or install HyperV utilities.
717 .Pp
718 This is a default setting on
719 amd64/amd64 and i386/i386.
720 .It Va WITHOUT_ICONV
721 Set to not build iconv as part of libc.
722 .It Va WITHOUT_INCLUDES
723 Set to not install header files.
724 This option used to be spelled
725 .Va NO_INCS .
726 .Bf -symbolic
727 The option does not work for build targets.
728 .Ef
729 .It Va WITHOUT_INET
730 Set to not build programs and libraries related to IPv4 networking.
731 When set, it enforces these options:
732 .Pp
733 .Bl -item -compact
734 .It
735 .Va WITHOUT_INET_SUPPORT
736 .El
737 .It Va WITHOUT_INET6
738 Set to not build
739 programs and libraries related to IPv6 networking.
740 When set, it enforces these options:
741 .Pp
742 .Bl -item -compact
743 .It
744 .Va WITHOUT_INET6_SUPPORT
745 .El
746 .It Va WITHOUT_INET6_SUPPORT
747 Set to build libraries, programs, and kernel modules without IPv6 support.
748 .It Va WITHOUT_INETD
749 Set to not build
750 .Xr inetd 8 .
751 .It Va WITHOUT_INET_SUPPORT
752 Set to build libraries, programs, and kernel modules without IPv4 support.
753 .It Va WITHOUT_INSTALLLIB
754 Set this to not install optional libraries.
755 For example, when creating a
756 .Xr nanobsd 8
757 image.
758 .Bf -symbolic
759 The option does not work for build targets.
760 .Ef
761 .It Va WITH_INSTALL_AS_USER
762 Set to make install targets succeed for non-root users by installing
763 files with owner and group attributes set to that of the user running
764 the
765 .Xr make 1
766 command.
767 The user still must set the
768 .Va DESTDIR
769 variable to point to a directory where the user has write permissions.
770 .It Va WITHOUT_IPFILTER
771 Set to not build IP Filter package.
772 .It Va WITHOUT_IPFW
773 Set to not build IPFW tools.
774 .It Va WITHOUT_IPSEC_SUPPORT
775 Set to not build the kernel with
776 .Xr ipsec 4
777 support.
778 This option is needed for
779 .Xr ipsec 4
780 and
781 .Xr tcpmd5 4 .
782 .It Va WITHOUT_ISCSI
783 Set to not build
784 .Xr iscsid 8
785 and related utilities.
786 .It Va WITHOUT_JAIL
787 Set to not build tools for the support of jails; e.g.,
788 .Xr jail 8 .
789 .It Va WITHOUT_KDUMP
790 Set to not build
791 .Xr kdump 1
792 and
793 .Xr truss 1 .
794 .It Va WITHOUT_KERBEROS
795 Set this to not build Kerberos 5 (KTH Heimdal).
796 When set, these options are also in effect:
797 .Pp
798 .Bl -inset -compact
799 .It Va WITHOUT_GSSAPI
800 (unless
801 .Va WITH_GSSAPI
802 is set explicitly)
803 .It Va WITHOUT_KERBEROS_SUPPORT
804 (unless
805 .Va WITH_KERBEROS_SUPPORT
806 is set explicitly)
807 .El
808 .It Va WITHOUT_KERBEROS_SUPPORT
809 Set to build some programs without Kerberos support, like
810 .Xr ssh 1 ,
811 .Xr telnet 1 ,
812 .Xr sshd 8 ,
813 and
814 .Xr telnetd 8 .
815 .It Va WITH_KERNEL_RETPOLINE
816 Set to enable the "retpoline" mitigation for CVE-2017-5715 in the kernel
817 build.
818 .It Va WITHOUT_KERNEL_SYMBOLS
819 Set to not install kernel symbol files.
820 .Bf -symbolic
821 This option is recommended for those people who have small root partitions.
822 .Ef
823 .It Va WITHOUT_KVM
824 Set to not build the
825 .Nm libkvm
826 library as a part of the base system.
827 .Bf -symbolic
828 The option has no effect yet.
829 .Ef
830 When set, these options are also in effect:
831 .Pp
832 .Bl -inset -compact
833 .It Va WITHOUT_KVM_SUPPORT
834 (unless
835 .Va WITH_KVM_SUPPORT
836 is set explicitly)
837 .El
838 .It Va WITHOUT_KVM_SUPPORT
839 Set to build some programs without optional
840 .Nm libkvm
841 support.
842 .It Va WITHOUT_LDNS
843 Setting this variable will prevent the LDNS library from being built.
844 When set, it enforces these options:
845 .Pp
846 .Bl -item -compact
847 .It
848 .Va WITHOUT_LDNS_UTILS
849 .It
850 .Va WITHOUT_UNBOUND
851 .El
852 .It Va WITHOUT_LDNS_UTILS
853 Setting this variable will prevent building the LDNS utilities
854 .Xr drill 1
855 and
856 .Xr host 1 .
857 .It Va WITHOUT_LEGACY_CONSOLE
858 Set to not build programs that support a legacy PC console; e.g.,
859 .Xr kbdcontrol 1
860 and
861 .Xr vidcontrol 1 .
862 .It Va WITHOUT_LIB32
863 On 64-bit platforms, set to not build 32-bit library set and a
864 .Nm ld-elf32.so.1
865 runtime linker.
866 .Pp
867 This is a default setting on
868 arm/armv6, arm/armv7, arm64/aarch64, i386/i386, mips/mips, powerpc/powerpc, riscv/riscv64 and riscv/riscv64sf.
869 .It Va WITHOUT_LIBCPLUSPLUS
870 Set to avoid building libcxxrt and libc++.
871 .It Va WITHOUT_LIBPTHREAD
872 Set to not build the
873 .Nm libpthread
874 providing library,
875 .Nm libthr .
876 When set, it enforces these options:
877 .Pp
878 .Bl -item -compact
879 .It
880 .Va WITHOUT_LIBTHR
881 .El
882 .It Va WITH_LIBSOFT
883 On armv6 only, set to enable soft float ABI compatibility libraries.
884 This option is for transitioning to the new hard float ABI.
885 .It Va WITHOUT_LIBTHR
886 Set to not build the
887 .Nm libthr
888 (1:1 threading)
889 library.
890 .It Va WITHOUT_LLD
891 Set to not build LLVM's lld linker.
892 .It Va WITHOUT_LLDB
893 Set to not build the LLDB debugger.
894 .Pp
895 This is a default setting on
896 arm/armv6, arm/armv7, mips/mips, mips/mips64, powerpc/powerpc, powerpc/powerpc64, riscv/riscv64 and riscv/riscv64sf.
897 .It Va WITH_LLDB
898 Set to build the LLDB debugger.
899 .Pp
900 This is a default setting on
901 amd64/amd64, arm64/aarch64 and i386/i386.
902 .It Va WITHOUT_LLD_BOOTSTRAP
903 Set to not build the LLD linker during the bootstrap phase of
904 the build.
905 To be able to build the system, either Binutils or LLD bootstrap must be
906 enabled unless an alternate linker is provided via XLD.
907 .It Va WITHOUT_LLD_IS_LD
908 Set to use GNU binutils ld as the system linker, instead of LLVM's LLD.
909 .It Va WITHOUT_LLVM_ASSERTIONS
910 Set to disable debugging assertions in LLVM.
911 .It Va WITHOUT_LLVM_COV
912 Set to not build the
913 .Xr llvm-cov 1
914 tool.
915 .It Va WITHOUT_LLVM_TARGET_AARCH64
916 Set to not build LLVM target support for AArch64.
917 The
918 .Va LLVM_TARGET_ALL
919 option should be used rather than this in most cases.
920 .It Va WITHOUT_LLVM_TARGET_ALL
921 Set to only build the required LLVM target support.
922 This option is preferred to specific target support options.
923 When set, these options are also in effect:
924 .Pp
925 .Bl -inset -compact
926 .It Va WITHOUT_LLVM_TARGET_AARCH64
927 (unless
928 .Va WITH_LLVM_TARGET_AARCH64
929 is set explicitly)
930 .It Va WITHOUT_LLVM_TARGET_ARM
931 (unless
932 .Va WITH_LLVM_TARGET_ARM
933 is set explicitly)
934 .It Va WITHOUT_LLVM_TARGET_MIPS
935 (unless
936 .Va WITH_LLVM_TARGET_MIPS
937 is set explicitly)
938 .It Va WITHOUT_LLVM_TARGET_POWERPC
939 (unless
940 .Va WITH_LLVM_TARGET_POWERPC
941 is set explicitly)
942 .It Va WITHOUT_LLVM_TARGET_RISCV
943 (unless
944 .Va WITH_LLVM_TARGET_RISCV
945 is set explicitly)
946 .El
947 .It Va WITHOUT_LLVM_TARGET_ARM
948 Set to not build LLVM target support for ARM.
949 The
950 .Va LLVM_TARGET_ALL
951 option should be used rather than this in most cases.
952 .It Va WITH_LLVM_TARGET_BPF
953 Set to build LLVM target support for BPF.
954 The
955 .Va LLVM_TARGET_ALL
956 option should be used rather than this in most cases.
957 .It Va WITHOUT_LLVM_TARGET_MIPS
958 Set to not build LLVM target support for MIPS.
959 The
960 .Va LLVM_TARGET_ALL
961 option should be used rather than this in most cases.
962 .It Va WITHOUT_LLVM_TARGET_POWERPC
963 Set to not build LLVM target support for PowerPC.
964 The
965 .Va LLVM_TARGET_ALL
966 option should be used rather than this in most cases.
967 .It Va WITHOUT_LLVM_TARGET_RISCV
968 Set to not build LLVM target support for RISC-V.
969 The
970 .Va LLVM_TARGET_ALL
971 option should be used rather than this in most cases.
972 .It Va WITHOUT_LLVM_TARGET_X86
973 Set to not build LLVM target support for X86.
974 The
975 .Va LLVM_TARGET_ALL
976 option should be used rather than this in most cases.
977 .It Va WITH_LOADER_EFI_SECUREBOOT
978 Enable building
979 .Xr loader 8
980 with support for verification based on certificates obtained from UEFI.
981 .Pp
982 .It Va WITH_LOADER_FIREWIRE
983 Enable firewire support in /boot/loader on x86. This option is a nop
984 on all other platforms.
985 .It Va WITH_LOADER_FORCE_LE
986 Set to force the powerpc boot loader to launch the kernel in little
987 endian mode.
988 .It Va WITHOUT_LOADER_GELI
989 Disable inclusion of GELI crypto support in the boot chain binaries.
990 .Pp
991 This is a default setting on
992 powerpc/powerpc and powerpc/powerpc64.
993 .It Va WITH_LOADER_GELI
994 Set to build GELI bootloader support.
995 .Pp
996 This is a default setting on
997 amd64/amd64, arm/armv6, arm/armv7, arm64/aarch64, i386/i386, mips/mips, mips/mips64, riscv/riscv64 and riscv/riscv64sf.
998 .It Va WITHOUT_LOADER_LUA
999 Set to not build LUA bindings for the boot loader.
1000 .Pp
1001 This is a default setting on
1002 powerpc/powerpc and powerpc/powerpc64.
1003 .It Va WITH_LOADER_LUA
1004 Set to build LUA bindings for the boot loader.
1005 .Pp
1006 This is a default setting on
1007 amd64/amd64, arm/armv6, arm/armv7, arm64/aarch64, i386/i386, mips/mips, mips/mips64, riscv/riscv64 and riscv/riscv64sf.
1008 .It Va WITHOUT_LOADER_OFW
1009 Disable building of openfirmware bootloader components.
1010 .Pp
1011 This is a default setting on
1012 amd64/amd64, arm/armv6, arm/armv7, arm64/aarch64, i386/i386, mips/mips, mips/mips64, riscv/riscv64 and riscv/riscv64sf.
1013 .It Va WITH_LOADER_OFW
1014 Set to build openfirmware bootloader components.
1015 .Pp
1016 This is a default setting on
1017 powerpc/powerpc and powerpc/powerpc64.
1018 .It Va WITHOUT_LOADER_UBOOT
1019 Disable building of ubldr.
1020 .Pp
1021 This is a default setting on
1022 amd64/amd64, arm64/aarch64, i386/i386, riscv/riscv64 and riscv/riscv64sf.
1023 .It Va WITH_LOADER_UBOOT
1024 Set to build ubldr.
1025 .Pp
1026 This is a default setting on
1027 arm/armv6, arm/armv7, mips/mips, mips/mips64, powerpc/powerpc and powerpc/powerpc64.
1028 .It Va WITH_LOADER_VERBOSE
1029 Set to build with extra verbose debugging in the loader.
1030 May explode already nearly too large loader over the limit.
1031 Use with care.
1032
1033 .It Va WITH_LOADER_VERIEXEC
1034 Enable building
1035 .Xr loader 8
1036 with support for verification similar to Verified Exec.
1037 .Pp
1038 Depends on
1039 .Va WITH_BEARSSL .
1040 When set, these options are also in effect:
1041 .Pp
1042 .Bl -inset -compact
1043 .It Va WITH_LOADER_EFI_SECUREBOOT
1044 (unless
1045 .Va WITHOUT_LOADER_EFI_SECUREBOOT
1046 is set explicitly)
1047 .It Va WITH_LOADER_VERIEXEC_VECTX
1048 (unless
1049 .Va WITHOUT_LOADER_VERIEXEC_VECTX
1050 is set explicitly)
1051 .El
1052 .It Va WITH_LOADER_VERIEXEC_PASS_MANIFEST
1053 Enable building
1054 .Xr loader 8
1055 with support to pass a verified manifest to the kernel.
1056 The kernel has to be built with a module to parse the manifest.
1057 .Pp
1058 Depends on
1059 .Va WITH_LOADER_VERIEXEC .
1060 .It Va WITHOUT_LOADER_ZFS
1061 Set to not build ZFS file system boot loader support.
1062 .It Va WITHOUT_LOCALES
1063 Set to not build localization files; see
1064 .Xr locale 1 .
1065 .It Va WITHOUT_LOCATE
1066 Set to not build
1067 .Xr locate 1
1068 and related programs.
1069 .It Va WITHOUT_LPR
1070 Set to not build
1071 .Xr lpr 1
1072 and related programs.
1073 .It Va WITHOUT_LS_COLORS
1074 Set to build
1075 .Xr ls 1
1076 without support for colors to distinguish file types.
1077 .It Va WITHOUT_LZMA_SUPPORT
1078 Set to build some programs without optional lzma compression support.
1079 .It Va WITHOUT_MAIL
1080 Set to not build any mail support (MUA or MTA).
1081 When set, it enforces these options:
1082 .Pp
1083 .Bl -item -compact
1084 .It
1085 .Va WITHOUT_DMAGENT
1086 .It
1087 .Va WITHOUT_MAILWRAPPER
1088 .It
1089 .Va WITHOUT_SENDMAIL
1090 .El
1091 .It Va WITHOUT_MAILWRAPPER
1092 Set to not build the
1093 .Xr mailwrapper 8
1094 MTA selector.
1095 .It Va WITHOUT_MAKE
1096 Set to not install
1097 .Xr make 1
1098 and related support files.
1099 .It Va WITHOUT_MAKE_CHECK_USE_SANDBOX
1100 Set to not execute
1101 .Dq Li "make check"
1102 in limited sandbox mode.
1103 This option should be paired with
1104 .Va WITH_INSTALL_AS_USER
1105 if executed as an unprivileged user.
1106 See
1107 .Xr tests 7
1108 for more details.
1109 .It Va WITH_MALLOC_PRODUCTION
1110 Set to disable assertions and statistics gathering in
1111 .Xr malloc 3 .
1112 It also defaults the A and J runtime options to off.
1113 .It Va WITHOUT_MAN
1114 Set to not build manual pages.
1115 When set, these options are also in effect:
1116 .Pp
1117 .Bl -inset -compact
1118 .It Va WITHOUT_MAN_UTILS
1119 (unless
1120 .Va WITH_MAN_UTILS
1121 is set explicitly)
1122 .El
1123 .It Va WITHOUT_MANCOMPRESS
1124 Set to not to install compressed man pages.
1125 Only the uncompressed versions will be installed.
1126 .It Va WITHOUT_MAN_UTILS
1127 Set to not build utilities for manual pages,
1128 .Xr apropos 1 ,
1129 .Xr makewhatis 1 ,
1130 .Xr man 1 ,
1131 .Xr whatis 1 ,
1132 .Xr manctl 8 ,
1133 and related support files.
1134 .It Va WITH_META_MODE
1135 Create
1136 .Xr make 1
1137 meta files when building, which can provide a reliable incremental build when
1138 using
1139 .Xr filemon 4 .
1140 The meta file is created in OBJDIR as
1141 .Pa target.meta .
1142 These meta files track the command that was executed, its output, and the
1143 current directory.
1144 The
1145 .Xr filemon 4
1146 module is required unless
1147 .Va NO_FILEMON
1148 is defined.
1149 When the module is loaded, any files used by the commands executed are
1150 tracked as dependencies for the target in its meta file.
1151 The target is considered out-of-date and rebuilt if any of these
1152 conditions are true compared to the last build:
1153 .Bl -bullet -compact
1154 .It
1155 The command to execute changes.
1156 .It
1157 The current working directory changes.
1158 .It
1159 The target's meta file is missing.
1160 .It
1161 The target's meta file is missing filemon data when filemon is loaded
1162 and a previous run did not have it loaded.
1163 .It
1164 [requires
1165 .Xr filemon 4 ]
1166 Files read, executed or linked to are newer than the target.
1167 .It
1168 [requires
1169 .Xr filemon 4 ]
1170 Files read, written, executed or linked are missing.
1171 .El
1172 The meta files can also be useful for debugging.
1173 .Pp
1174 The build hides commands that are executed unless
1175 .Va NO_SILENT
1176 is defined.
1177 Errors cause
1178 .Xr make 1
1179 to show some of its environment for further debugging.
1180 .Pp
1181 The build operates as it normally would otherwise.
1182 This option originally invoked a different build system but that was renamed
1183 to
1184 .Va WITH_DIRDEPS_BUILD .
1185 .Pp
1186 This must be set in the environment, make command line, or
1187 .Pa /etc/src-env.conf ,
1188 not
1189 .Pa /etc/src.conf .
1190 .It Va WITHOUT_MLX5TOOL
1191 Set to not build
1192 .Xr mlx5tool 8
1193 .Pp
1194 This is a default setting on
1195 arm/armv6, arm/armv7, mips/mips, mips/mips64, powerpc/powerpc, riscv/riscv64 and riscv/riscv64sf.
1196 .It Va WITH_MLX5TOOL
1197 Set to build
1198 .Xr mlx5tool 8
1199 .Pp
1200 This is a default setting on
1201 amd64/amd64, arm64/aarch64, i386/i386 and powerpc/powerpc64.
1202 .It Va WITHOUT_NDIS
1203 Set to not build programs and libraries
1204 related to NDIS emulation support.
1205 .It Va WITHOUT_NETCAT
1206 Set to not build
1207 .Xr nc 1
1208 utility.
1209 .It Va WITHOUT_NETGRAPH
1210 Set to not build applications to support
1211 .Xr netgraph 4 .
1212 When set, it enforces these options:
1213 .Pp
1214 .Bl -item -compact
1215 .It
1216 .Va WITHOUT_ATM
1217 .It
1218 .Va WITHOUT_BLUETOOTH
1219 .El
1220 .Pp
1221 When set, these options are also in effect:
1222 .Pp
1223 .Bl -inset -compact
1224 .It Va WITHOUT_NETGRAPH_SUPPORT
1225 (unless
1226 .Va WITH_NETGRAPH_SUPPORT
1227 is set explicitly)
1228 .El
1229 .It Va WITHOUT_NETGRAPH_SUPPORT
1230 Set to build libraries, programs, and kernel modules without netgraph support.
1231 .It Va WITHOUT_NIS
1232 Set to not build
1233 .Xr NIS 8
1234 support and related programs.
1235 If set, you might need to adopt your
1236 .Xr nsswitch.conf 5
1237 and remove
1238 .Sq nis
1239 entries.
1240 .It Va WITHOUT_NLS
1241 Set to not build NLS catalogs.
1242 When set, it enforces these options:
1243 .Pp
1244 .Bl -item -compact
1245 .It
1246 .Va WITHOUT_NLS_CATALOGS
1247 .El
1248 .It Va WITHOUT_NLS_CATALOGS
1249 Set to not build NLS catalog support for
1250 .Xr csh 1 .
1251 .It Va WITHOUT_NS_CACHING
1252 Set to disable name caching in the
1253 .Pa nsswitch
1254 subsystem.
1255 The generic caching daemon,
1256 .Xr nscd 8 ,
1257 will not be built either if this option is set.
1258 .It Va WITHOUT_NTP
1259 Set to not build
1260 .Xr ntpd 8
1261 and related programs.
1262 .It Va WITHOUT_NVME
1263 Set to not build nvme related tools and kernel modules.
1264 .Pp
1265 This is a default setting on
1266 arm/armv6, arm/armv7, mips/mips, mips/mips64, powerpc/powerpc, riscv/riscv64 and riscv/riscv64sf.
1267 .It Va WITH_NVME
1268 Set to build nvme related tools and kernel modules.
1269
1270 .Pp
1271 This is a default setting on
1272 amd64/amd64, arm64/aarch64, i386/i386 and powerpc/powerpc64.
1273 .It Va WITH_OFED
1274 Set to build the
1275 .Dq "OpenFabrics Enterprise Distribution"
1276 Infiniband software stack.
1277 .It Va WITH_OFED_EXTRA
1278 Set to build the non-essential components of the
1279 .Dq "OpenFabrics Enterprise Distribution"
1280 Infiniband software stack, mostly examples.
1281 .It Va WITH_OPENLDAP
1282 Enable building openldap support for kerberos.
1283 .It Va WITHOUT_OPENMP
1284 Set to not build LLVM's OpenMP runtime.
1285 .Pp
1286 This is a default setting on
1287 arm/armv6, arm/armv7, mips/mips, mips/mips64, powerpc/powerpc, riscv/riscv64 and riscv/riscv64sf.
1288 .It Va WITH_OPENMP
1289 Set to build LLVM's OpenMP runtime.
1290 .Pp
1291 This is a default setting on
1292 amd64/amd64, arm64/aarch64, i386/i386 and powerpc/powerpc64.
1293 .It Va WITHOUT_OPENSSH
1294 Set to not build OpenSSH.
1295 .It Va WITHOUT_OPENSSL
1296 Set to not build OpenSSL.
1297 When set, it enforces these options:
1298 .Pp
1299 .Bl -item -compact
1300 .It
1301 .Va WITHOUT_DMAGENT
1302 .It
1303 .Va WITHOUT_KERBEROS
1304 .It
1305 .Va WITHOUT_KERBEROS_SUPPORT
1306 .It
1307 .Va WITHOUT_LDNS
1308 .It
1309 .Va WITHOUT_LDNS_UTILS
1310 .It
1311 .Va WITHOUT_OPENSSH
1312 .It
1313 .Va WITHOUT_PKGBOOTSTRAP
1314 .It
1315 .Va WITHOUT_SVN
1316 .It
1317 .Va WITHOUT_SVNLITE
1318 .It
1319 .Va WITHOUT_UNBOUND
1320 .It
1321 .Va WITHOUT_WIRELESS
1322 .El
1323 .Pp
1324 When set, these options are also in effect:
1325 .Pp
1326 .Bl -inset -compact
1327 .It Va WITHOUT_GSSAPI
1328 (unless
1329 .Va WITH_GSSAPI
1330 is set explicitly)
1331 .El
1332 .It Va WITHOUT_PAM
1333 Set to not build PAM library and modules.
1334 .Bf -symbolic
1335 This option is deprecated and does nothing.
1336 .Ef
1337 When set, these options are also in effect:
1338 .Pp
1339 .Bl -inset -compact
1340 .It Va WITHOUT_PAM_SUPPORT
1341 (unless
1342 .Va WITH_PAM_SUPPORT
1343 is set explicitly)
1344 .El
1345 .It Va WITHOUT_PAM_SUPPORT
1346 Set to build some programs without PAM support, particularly
1347 .Xr ftpd 8
1348 and
1349 .Xr ppp 8 .
1350 .It Va WITHOUT_PF
1351 Set to not build PF firewall package.
1352 When set, it enforces these options:
1353 .Pp
1354 .Bl -item -compact
1355 .It
1356 .Va WITHOUT_AUTHPF
1357 .El
1358 .It Va WITH_PIE
1359 Build dynamically linked binaries as
1360 Position-Independent Executable (PIE).
1361 .It Va WITHOUT_PKGBOOTSTRAP
1362 Set to not build
1363 .Xr pkg 7
1364 bootstrap tool.
1365 .It Va WITHOUT_PMC
1366 Set to not build
1367 .Xr pmccontrol 8
1368 and related programs.
1369 .It Va WITHOUT_PORTSNAP
1370 Set to not build or install
1371 .Xr portsnap 8
1372 and related files.
1373 .It Va WITHOUT_PPP
1374 Set to not build
1375 .Xr ppp 8
1376 and related programs.
1377 .It Va WITHOUT_PROFILE
1378 Set to not build profiled libraries for use with
1379 .Xr gprof 8 .
1380 .Pp
1381 This is a default setting on
1382 mips/mips64.
1383 .It Va WITH_PROFILE
1384 Set to build profiled libraries for use with
1385 .Xr gprof 8 .
1386 .Pp
1387 This is a default setting on
1388 amd64/amd64, arm/armv6, arm/armv7, arm64/aarch64, i386/i386, mips/mips, powerpc/powerpc, powerpc/powerpc64, riscv/riscv64 and riscv/riscv64sf.
1389 .It Va WITHOUT_QUOTAS
1390 Set to not build
1391 .Xr quota 1
1392 and related programs.
1393 .It Va WITHOUT_RADIUS_SUPPORT
1394 Set to not build radius support into various applications, like
1395 .Xr pam_radius 8
1396 and
1397 .Xr ppp 8 .
1398 .It Va WITH_RATELIMIT
1399 Set to build the system with rate limit support.
1400 .Pp
1401 This makes
1402 .Dv SO_MAX_PACING_RATE
1403 effective in
1404 .Xr getsockopt 2 ,
1405 and
1406 .Ar txrlimit
1407 support in
1408 .Xr ifconfig 8 ,
1409 by proxy.
1410 .It Va WITHOUT_RBOOTD
1411 Set to not build or install
1412 .Xr rbootd 8 .
1413 .It Va WITH_REPRODUCIBLE_BUILD
1414 Set to exclude build metadata (such as the build time, user, or host)
1415 from the kernel, boot loaders, and uname output, so that builds produce
1416 bit-for-bit identical output.
1417 .It Va WITHOUT_RESCUE
1418 Set to not build
1419 .Xr rescue 8 .
1420 .It Va WITH_RETPOLINE
1421 Set to build the base system with the retpoline speculative execution
1422 vulnerability mitigation for CVE-2017-5715.
1423 .It Va WITHOUT_ROUTED
1424 Set to not build
1425 .Xr routed 8
1426 utility.
1427 .It Va WITH_RPCBIND_WARMSTART_SUPPORT
1428 Set to build
1429 .Xr rpcbind 8
1430 with warmstart support.
1431 .It Va WITHOUT_SENDMAIL
1432 Set to not build
1433 .Xr sendmail 8
1434 and related programs.
1435 .It Va WITHOUT_SERVICESDB
1436 Set to not install
1437 .Pa /var/db/services.db .
1438 .It Va WITHOUT_SETUID_LOGIN
1439 Set this to disable the installation of
1440 .Xr login 1
1441 as a set-user-ID root program.
1442 .It Va WITHOUT_SHAREDOCS
1443 Set to not build the
1444 .Bx 4.4
1445 legacy docs.
1446 .It Va WITHOUT_SHARED_TOOLCHAIN
1447 Set to build the toolchain binaries as statically linked executables.
1448 The set includes
1449 .Xr cc 1 ,
1450 .Xr make 1
1451 and necessary utilities like assembler, linker and library archive manager.
1452 .It Va WITH_SORT_THREADS
1453 Set to enable threads in
1454 .Xr sort 1 .
1455 .It Va WITHOUT_SOURCELESS
1456 Set to not build kernel modules that include sourceless code (either microcode or native code for host CPU).
1457 When set, it enforces these options:
1458 .Pp
1459 .Bl -item -compact
1460 .It
1461 .Va WITHOUT_SOURCELESS_HOST
1462 .It
1463 .Va WITHOUT_SOURCELESS_UCODE
1464 .El
1465 .It Va WITHOUT_SOURCELESS_HOST
1466 Set to not build kernel modules that include sourceless native code for host CPU.
1467 .It Va WITHOUT_SOURCELESS_UCODE
1468 Set to not build kernel modules that include sourceless microcode.
1469 .It Va WITHOUT_SSP
1470 Set to not build world with propolice stack smashing protection.
1471 .Pp
1472 This is a default setting on
1473 mips/mips and mips/mips64.
1474 .It Va WITH_SSP
1475 Set to build world with propolice stack smashing protection.
1476 .Pp
1477 This is a default setting on
1478 amd64/amd64, arm/armv6, arm/armv7, arm64/aarch64, i386/i386, powerpc/powerpc, powerpc/powerpc64, riscv/riscv64 and riscv/riscv64sf.
1479 .It Va WITH_STAGING
1480 Enable staging of files to a stage tree.
1481 This can be best thought of as auto-install to
1482 .Va DESTDIR
1483 with some extra meta data to ensure dependencies can be tracked.
1484 Depends on
1485 .Va WITH_DIRDEPS_BUILD .
1486 When set, these options are also in effect:
1487 .Pp
1488 .Bl -inset -compact
1489 .It Va WITH_STAGING_MAN
1490 (unless
1491 .Va WITHOUT_STAGING_MAN
1492 is set explicitly)
1493 .It Va WITH_STAGING_PROG
1494 (unless
1495 .Va WITHOUT_STAGING_PROG
1496 is set explicitly)
1497 .El
1498 .Pp
1499 This must be set in the environment, make command line, or
1500 .Pa /etc/src-env.conf ,
1501 not
1502 .Pa /etc/src.conf .
1503 .It Va WITH_STAGING_MAN
1504 Enable staging of man pages to stage tree.
1505 .It Va WITH_STAGING_PROG
1506 Enable staging of PROGs to stage tree.
1507 .It Va WITH_STALE_STAGED
1508 Check staged files are not stale.
1509 .It Va WITHOUT_STATS
1510 Set to neither build nor install
1511 .Lb libstats
1512 and dependent binaries.
1513 .It Va WITH_SVN
1514 Set to install
1515 .Xr svnlite 1
1516 as
1517 .Xr svn 1 .
1518 .It Va WITHOUT_SVNLITE
1519 Set to not build
1520 .Xr svnlite 1
1521 and related programs.
1522 .It Va WITHOUT_SYSCONS
1523 Set to not build
1524 .Xr syscons 4
1525 support files such as keyboard maps, fonts, and screen output maps.
1526 .It Va WITH_SYSROOT
1527 Enable use of sysroot during build.
1528 Depends on
1529 .Va WITH_DIRDEPS_BUILD .
1530 .Pp
1531 This must be set in the environment, make command line, or
1532 .Pa /etc/src-env.conf ,
1533 not
1534 .Pa /etc/src.conf .
1535 .It Va WITHOUT_SYSTEM_COMPILER
1536 Set to not opportunistically skip building a cross-compiler during the
1537 bootstrap phase of the build.
1538 Normally, if the currently installed compiler matches the planned bootstrap
1539 compiler type and revision, then it will not be built.
1540 This does not prevent a compiler from being built for installation though,
1541 only for building one for the build itself.
1542 The
1543 .Va WITHOUT_CLANG
1544 option controls that.
1545 .It Va WITHOUT_SYSTEM_LINKER
1546 Set to not opportunistically skip building a cross-linker during the
1547 bootstrap phase of the build.
1548 Normally, if the currently installed linker matches the planned bootstrap
1549 linker type and revision, then it will not be built.
1550 This does not prevent a linker from being built for installation though,
1551 only for building one for the build itself.
1552 The
1553 .Va WITHOUT_LLD
1554 option controls that.
1555 .Pp
1556 This option is only relevant when
1557 .Va WITH_LLD_BOOTSTRAP
1558 is set.
1559 .It Va WITHOUT_TALK
1560 Set to not build or install
1561 .Xr talk 1
1562 and
1563 .Xr talkd 8 .
1564 .It Va WITHOUT_TCP_WRAPPERS
1565 Set to not build or install
1566 .Xr tcpd 8 ,
1567 and related utilities.
1568 .It Va WITHOUT_TCSH
1569 Set to not build and install
1570 .Pa /bin/csh
1571 (which is
1572 .Xr tcsh 1 ) .
1573 .It Va WITHOUT_TELNET
1574 Set to not build
1575 .Xr telnet 1
1576 and related programs.
1577 .It Va WITHOUT_TESTS
1578 Set to not build nor install the
1579 .Fx
1580 Test Suite in
1581 .Pa /usr/tests/ .
1582 See
1583 .Xr tests 7
1584 for more details.
1585 This also disables the build of all test-related dependencies, including ATF.
1586 When set, it enforces these options:
1587 .Pp
1588 .Bl -item -compact
1589 .It
1590 .Va WITHOUT_DTRACE_TESTS
1591 .El
1592 .Pp
1593 When set, these options are also in effect:
1594 .Pp
1595 .Bl -inset -compact
1596 .It Va WITHOUT_GOOGLETEST
1597 (unless
1598 .Va WITH_GOOGLETEST
1599 is set explicitly)
1600 .It Va WITHOUT_TESTS_SUPPORT
1601 (unless
1602 .Va WITH_TESTS_SUPPORT
1603 is set explicitly)
1604 .El
1605 .It Va WITHOUT_TESTS_SUPPORT
1606 Set to disables the build of all test-related dependencies, including ATF.
1607 When set, it enforces these options:
1608 .Pp
1609 .Bl -item -compact
1610 .It
1611 .Va WITHOUT_GOOGLETEST
1612 .El
1613 .It Va WITHOUT_TEXTPROC
1614 Set to not build
1615 programs used for text processing.
1616 .It Va WITHOUT_TFTP
1617 Set to not build or install
1618 .Xr tftp 1
1619 and
1620 .Xr tftpd 8 .
1621 .It Va WITHOUT_TOOLCHAIN
1622 Set to not install header or
1623 programs used for program development,
1624 compilers, debuggers etc.
1625 When set, it enforces these options:
1626 .Pp
1627 .Bl -item -compact
1628 .It
1629 .Va WITHOUT_CLANG
1630 .It
1631 .Va WITHOUT_CLANG_EXTRAS
1632 .It
1633 .Va WITHOUT_CLANG_FORMAT
1634 .It
1635 .Va WITHOUT_CLANG_FULL
1636 .It
1637 .Va WITHOUT_GDB
1638 .It
1639 .Va WITHOUT_INCLUDES
1640 .It
1641 .Va WITHOUT_LLD
1642 .It
1643 .Va WITHOUT_LLDB
1644 .It
1645 .Va WITHOUT_LLVM_COV
1646 .El
1647 .It Va WITHOUT_UNBOUND
1648 Set to not build
1649 .Xr unbound 8
1650 and related programs.
1651 .It Va WITHOUT_UNIFIED_OBJDIR
1652 Set to use the historical object directory format for
1653 .Xr build 7
1654 targets.
1655 For native-builds and builds done directly in sub-directories the format of
1656 .Pa ${MAKEOBJDIRPREFIX}/${.CURDIR}
1657 is used,
1658 while for cross-builds
1659 .Pa ${MAKEOBJDIRPREFIX}/${TARGET}.${TARGET_ARCH}/${.CURDIR}
1660 is used.
1661 .Pp
1662 This option is transitional and will be removed before the 12.0 release,
1663 at which time
1664 .va WITH_UNIFIED_OBJDIR
1665 will be enabled permanently.
1666 .Pp
1667 This must be set in the environment, make command line, or
1668 .Pa /etc/src-env.conf ,
1669 not
1670 .Pa /etc/src.conf .
1671 .It Va WITHOUT_USB
1672 Set to not build USB-related programs and libraries.
1673 .It Va WITHOUT_USB_GADGET_EXAMPLES
1674 Set to not build USB gadget kernel modules.
1675 .It Va WITHOUT_UTMPX
1676 Set to not build user accounting tools such as
1677 .Xr last 1 ,
1678 .Xr users 1 ,
1679 .Xr who 1 ,
1680 .Xr ac 8 ,
1681 .Xr lastlogin 8
1682 and
1683 .Xr utx 8 .
1684 .It Va WITH_VERIEXEC
1685 Enable building
1686 .Xr veriexec 8
1687 which loads the contents of verified manifests into the kernel
1688 for use by
1689 .Xr mac_veriexec 4
1690 .Pp
1691 Depends on
1692 .Va WITH_BEARSSL .
1693 .It Va WITHOUT_VI
1694 Set to not build and install vi, view, ex and related programs.
1695 .It Va WITHOUT_VT
1696 Set to not build
1697 .Xr vt 4
1698 support files (fonts and keymaps).
1699 .It Va WITHOUT_WARNS
1700 Set this to not add warning flags to the compiler invocations.
1701 Useful as a temporary workaround when code enters the tree
1702 which triggers warnings in environments that differ from the
1703 original developer.
1704 .It Va WITHOUT_WIRELESS
1705 Set to not build programs used for 802.11 wireless networks; especially
1706 .Xr wpa_supplicant 8
1707 and
1708 .Xr hostapd 8 .
1709 When set, these options are also in effect:
1710 .Pp
1711 .Bl -inset -compact
1712 .It Va WITHOUT_WIRELESS_SUPPORT
1713 (unless
1714 .Va WITH_WIRELESS_SUPPORT
1715 is set explicitly)
1716 .El
1717 .It Va WITHOUT_WIRELESS_SUPPORT
1718 Set to build libraries, programs, and kernel modules without
1719 802.11 wireless support.
1720 .It Va WITHOUT_WPA_SUPPLICANT_EAPOL
1721 Build
1722 .Xr wpa_supplicant 8
1723 without support for the IEEE 802.1X protocol and without
1724 support for EAP-PEAP, EAP-TLS, EAP-LEAP, and EAP-TTLS
1725 protocols (usable only via 802.1X).
1726 .It Va WITHOUT_ZFS
1727 Set to not build ZFS file system kernel module, libraries, and user commands.
1728 .It Va WITHOUT_ZONEINFO
1729 Set to not build the timezone database.
1730 When set, it enforces these options:
1731 .Pp
1732 .Bl -item -compact
1733 .It
1734 .Va WITHOUT_ZONEINFO_LEAPSECONDS_SUPPORT
1735 .El
1736 .It Va WITH_ZONEINFO_LEAPSECONDS_SUPPORT
1737 Set to build leapsecond information in to the timezone database.
1738 .El
1739 .Sh FILES
1740 .Bl -tag -compact -width Pa
1741 .It Pa /etc/src.conf
1742 .It Pa /etc/src-env.conf
1743 .It Pa /usr/share/mk/bsd.own.mk
1744 .El
1745 .Sh SEE ALSO
1746 .Xr make 1 ,
1747 .Xr make.conf 5 ,
1748 .Xr build 7 ,
1749 .Xr ports 7
1750 .Sh HISTORY
1751 The
1752 .Nm
1753 file appeared in
1754 .Fx 7.0 .
1755 .Sh AUTHORS
1756 This manual page was autogenerated by
1757 .An tools/build/options/makeman .