]> CyberLeo.Net >> Repos - FreeBSD/FreeBSD.git/blob - share/man/man5/src.conf.5
MFV: r362513
[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 July 6, 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_CPP
350 Set to not build
351 .Xr cpp 1 .
352 .It Va WITHOUT_CROSS_COMPILER
353 Set to not build any cross compiler in the cross-tools stage of buildworld.
354 When compiling a different version of
355 .Fx
356 than what is installed on the system, provide an alternate
357 compiler with XCC to ensure success.
358 When compiling with an identical version of
359 .Fx
360 to the host, this option may be safely used.
361 This option may also be safe when the host version of
362 .Fx
363 is close to the sources being built, but all bets are off if there have
364 been any changes to the toolchain between the versions.
365 When set, it enforces these options:
366 .Pp
367 .Bl -item -compact
368 .It
369 .Va WITHOUT_CLANG_BOOTSTRAP
370 .It
371 .Va WITHOUT_ELFTOOLCHAIN_BOOTSTRAP
372 .It
373 .Va WITHOUT_LLD_BOOTSTRAP
374 .El
375 .It Va WITHOUT_CRYPT
376 Set to not build any crypto code.
377 When set, it enforces these options:
378 .Pp
379 .Bl -item -compact
380 .It
381 .Va WITHOUT_DMAGENT
382 .It
383 .Va WITHOUT_KERBEROS
384 .It
385 .Va WITHOUT_KERBEROS_SUPPORT
386 .It
387 .Va WITHOUT_LDNS
388 .It
389 .Va WITHOUT_LDNS_UTILS
390 .It
391 .Va WITHOUT_OPENSSH
392 .It
393 .Va WITHOUT_OPENSSL
394 .It
395 .Va WITHOUT_PKGBOOTSTRAP
396 .It
397 .Va WITHOUT_SVN
398 .It
399 .Va WITHOUT_SVNLITE
400 .It
401 .Va WITHOUT_UNBOUND
402 .It
403 .Va WITHOUT_WIRELESS
404 .El
405 .Pp
406 When set, these options are also in effect:
407 .Pp
408 .Bl -inset -compact
409 .It Va WITHOUT_GSSAPI
410 (unless
411 .Va WITH_GSSAPI
412 is set explicitly)
413 .El
414 .It Va WITH_CTF
415 Set to compile with CTF (Compact C Type Format) data.
416 CTF data encapsulates a reduced form of debugging information
417 similar to DWARF and the venerable stabs and is required for DTrace.
418 .It Va WITHOUT_CUSE
419 Set to not build CUSE-related programs and libraries.
420 .It Va WITHOUT_CXGBETOOL
421 Set to not build
422 .Xr cxgbetool 8
423 .Pp
424 This is a default setting on
425 arm/armv6, arm/armv7, mips/mips, mips/mips64, powerpc/powerpc, riscv/riscv64 and riscv/riscv64sf.
426 .It Va WITH_CXGBETOOL
427 Set to build
428 .Xr cxgbetool 8
429 .Pp
430 This is a default setting on
431 amd64/amd64, arm64/aarch64, i386/i386 and powerpc/powerpc64.
432 .It Va WITHOUT_CXX
433 Set to not build
434 .Xr c++ 1
435 and related libraries.
436 It will also prevent building of
437 .Xr gperf 1
438 and
439 .Xr devd 8 .
440 When set, it enforces these options:
441 .Pp
442 .Bl -item -compact
443 .It
444 .Va WITHOUT_CLANG
445 .It
446 .Va WITHOUT_CLANG_EXTRAS
447 .It
448 .Va WITHOUT_CLANG_FORMAT
449 .It
450 .Va WITHOUT_CLANG_FULL
451 .It
452 .Va WITHOUT_DTRACE_TESTS
453 .It
454 .Va WITHOUT_GOOGLETEST
455 .It
456 .Va WITHOUT_LLVM_COV
457 .It
458 .Va WITHOUT_TESTS
459 .El
460 .It Va WITHOUT_DEBUG_FILES
461 Set to avoid building or installing standalone debug files for each
462 executable binary and shared library.
463 .It Va WITHOUT_DIALOG
464 Set to not build
465 .Xr dialog 1 ,
466 .Xr dialog 3 ,
467 .Xr dpv 1 ,
468 and
469 .Xr dpv 3 .
470 When set, it enforces these options:
471 .Pp
472 .Bl -item -compact
473 .It
474 .Va WITHOUT_BSDINSTALL
475 .El
476 .It Va WITHOUT_DICT
477 Set to not build the Webster dictionary files.
478 .It Va WITH_DIRDEPS_BUILD
479 This is an experimental build system.
480 For details see
481 http://www.crufty.net/sjg/docs/freebsd-meta-mode.htm.
482 Build commands can be seen from the top-level with:
483 .Dl make show-valid-targets
484 The build is driven by dirdeps.mk using
485 .Va DIRDEPS
486 stored in
487 Makefile.depend files found in each directory.
488 .Pp
489 The build can be started from anywhere, and behaves the same.
490 The initial instance of
491 .Xr make 1
492 recursively reads
493 .Va DIRDEPS
494 from
495 .Pa Makefile.depend ,
496 computing a graph of tree dependencies from the current origin.
497 Setting
498 .Va NO_DIRDEPS
499 skips checking dirdep dependencies and will only build in the current
500 and child directories.
501 .Va NO_DIRDEPS_BELOW
502 skips building any dirdeps and only build the current directory.
503 .Pp
504 This also utilizes the
505 .Va WITH_META_MODE
506 logic for incremental builds.
507 .Pp
508 The build hides commands executed unless
509 .Va NO_SILENT
510 is defined.
511 .Pp
512 Note that there is currently no mass install feature for this.
513 .Pp
514 When set, it enforces these options:
515 .Pp
516 .Bl -item -compact
517 .It
518 .Va WITH_INSTALL_AS_USER
519 .El
520 .Pp
521 When set, these options are also in effect:
522 .Pp
523 .Bl -inset -compact
524 .It Va WITH_META_MODE
525 (unless
526 .Va WITHOUT_META_MODE
527 is set explicitly)
528 .It Va WITH_STAGING
529 (unless
530 .Va WITHOUT_STAGING
531 is set explicitly)
532 .It Va WITH_STAGING_MAN
533 (unless
534 .Va WITHOUT_STAGING_MAN
535 is set explicitly)
536 .It Va WITH_STAGING_PROG
537 (unless
538 .Va WITHOUT_STAGING_PROG
539 is set explicitly)
540 .It Va WITH_SYSROOT
541 (unless
542 .Va WITHOUT_SYSROOT
543 is set explicitly)
544 .El
545 .Pp
546 This must be set in the environment, make command line, or
547 .Pa /etc/src-env.conf ,
548 not
549 .Pa /etc/src.conf .
550 .It Va WITH_DIRDEPS_CACHE
551 Cache result of dirdeps.mk which can save significant time
552 for subsequent builds.
553 Depends on
554 .Va WITH_DIRDEPS_BUILD .
555 .Pp
556 This must be set in the environment, make command line, or
557 .Pa /etc/src-env.conf ,
558 not
559 .Pa /etc/src.conf .
560 .It Va WITHOUT_DMAGENT
561 Set to not build dma Mail Transport Agent.
562 .It Va WITHOUT_DOCCOMPRESS
563 Set to not install compressed system documentation.
564 Only the uncompressed version will be installed.
565 .It Va WITH_DTRACE_TESTS
566 Set to build and install the DTrace test suite in
567 .Pa /usr/tests/cddl/usr.sbin/dtrace .
568 This test suite is considered experimental on architectures other than
569 amd64/amd64 and running it may cause system instability.
570 .It Va WITHOUT_DYNAMICROOT
571 Set this if you do not want to link
572 .Pa /bin
573 and
574 .Pa /sbin
575 dynamically.
576 .It Va WITHOUT_EE
577 Set to not build and install
578 .Xr edit 1 ,
579 .Xr ee 1 ,
580 and related programs.
581 .It Va WITHOUT_EFI
582 Set not to build
583 .Xr efivar 3
584 and
585 .Xr efivar 8 .
586 .Pp
587 This is a default setting on
588 mips/mips, mips/mips64, powerpc/powerpc and powerpc/powerpc64.
589 .It Va WITH_EFI
590 Set to build
591 .Xr efivar 3
592 and
593 .Xr efivar 8 .
594 .Pp
595 This is a default setting on
596 amd64/amd64, arm/armv6, arm/armv7, arm64/aarch64, i386/i386, riscv/riscv64 and riscv/riscv64sf.
597 .It Va WITHOUT_ELFTOOLCHAIN_BOOTSTRAP
598 Set to not build ELF Tool Chain tools
599 (addr2line, nm, size, strings and strip)
600 as part of the bootstrap process.
601 .Bf -symbolic
602 An alternate bootstrap tool chain must be provided.
603 .Ef
604 .It Va WITHOUT_EXAMPLES
605 Set to avoid installing examples to
606 .Pa /usr/share/examples/ .
607 .It Va WITH_EXPERIMENTAL
608 Set to include experimental features in the build.
609 .It Va WITH_EXTRA_TCP_STACKS
610 Set to build extra TCP stack modules.
611 .It Va WITHOUT_FDT
612 Set to not build Flattened Device Tree support as part of the base system.
613 This includes the device tree compiler (dtc) and libfdt support library.
614 .It Va WITHOUT_FILE
615 Set to not build
616 .Xr file 1
617 and related programs.
618 When set, it enforces these options:
619 .Pp
620 .Bl -item -compact
621 .It
622 .Va WITHOUT_SVNLITE
623 .El
624 .It Va WITHOUT_FINGER
625 Set to not build or install
626 .Xr finger 1
627 and
628 .Xr fingerd 8 .
629 .It Va WITHOUT_FLOPPY
630 Set to not build or install programs
631 for operating floppy disk driver.
632 .It Va WITHOUT_FMTREE
633 Set to not build and install
634 .Pa /usr/sbin/fmtree .
635 .It Va WITHOUT_FORMAT_EXTENSIONS
636 Set to not enable
637 .Fl fformat-extensions
638 when compiling the kernel.
639 Also disables all format checking.
640 .It Va WITHOUT_FORTH
641 Set to build bootloaders without Forth support.
642 .It Va WITHOUT_FP_LIBC
643 Set to build
644 .Nm libc
645 without floating-point support.
646 .It Va WITHOUT_FREEBSD_UPDATE
647 Set to not build
648 .Xr freebsd-update 8 .
649 .It Va WITHOUT_FTP
650 Set to not build or install
651 .Xr ftp 1
652 and
653 .Xr ftpd 8 .
654 .It Va WITHOUT_GAMES
655 Set to not build games.
656 .It Va WITHOUT_GDB
657 Set to not build
658 .Xr gdb 1 .
659 .Pp
660 This is a default setting on
661 arm64/aarch64, riscv/riscv64 and riscv/riscv64sf.
662 .It Va WITH_GDB
663 Set to build
664 .Xr gdb 1 .
665 .Pp
666 This is a default setting on
667 amd64/amd64, arm/armv6, arm/armv7, i386/i386, mips/mips, mips/mips64, powerpc/powerpc and powerpc/powerpc64.
668 .It Va WITHOUT_GNU_DIFF
669 Set to not build GNU
670 .Xr diff3 1 .
671 .It Va WITHOUT_GNU_GREP
672 Set to not build GNU
673 .Xr grep 1 .
674 .It Va WITH_GNU_GREP_COMPAT
675 Set this option to include GNU extensions in
676 .Xr bsdgrep 1
677 by linking against libgnuregex.
678 .It Va WITHOUT_GOOGLETEST
679 Set to neither build nor install
680 .Lb libgmock ,
681 .Lb libgtest ,
682 and dependent tests.
683 .Pp
684 This is a default setting on
685 mips/mips and mips/mips64.
686 .It Va WITH_GOOGLETEST
687 Set to build and install
688 .Lb libgmock ,
689 .Lb libgtest ,
690 and dependent tests.
691 .Pp
692 This is a default setting on
693 amd64/amd64, arm/armv6, arm/armv7, arm64/aarch64, i386/i386, powerpc/powerpc, powerpc/powerpc64, riscv/riscv64 and riscv/riscv64sf.
694 .It Va WITHOUT_GPIO
695 Set to not build
696 .Xr gpioctl 8
697 as part of the base system.
698 .It Va WITHOUT_GSSAPI
699 Set to not build libgssapi.
700 .It Va WITHOUT_HAST
701 Set to not build
702 .Xr hastd 8
703 and related utilities.
704 .It Va WITH_HESIOD
705 Set to build Hesiod support.
706 .It Va WITHOUT_HTML
707 Set to not build HTML docs.
708 .It Va WITHOUT_HYPERV
709 Set to not build or install HyperV utilities.
710 .Pp
711 This is a default setting on
712 arm/armv6, arm/armv7, arm64/aarch64, mips/mips, mips/mips64, powerpc/powerpc, powerpc/powerpc64, riscv/riscv64 and riscv/riscv64sf.
713 .It Va WITH_HYPERV
714 Set to build or install HyperV utilities.
715 .Pp
716 This is a default setting on
717 amd64/amd64 and i386/i386.
718 .It Va WITHOUT_ICONV
719 Set to not build iconv as part of libc.
720 .It Va WITHOUT_INCLUDES
721 Set to not install header files.
722 This option used to be spelled
723 .Va NO_INCS .
724 .Bf -symbolic
725 The option does not work for build targets.
726 .Ef
727 .It Va WITHOUT_INET
728 Set to not build programs and libraries related to IPv4 networking.
729 When set, it enforces these options:
730 .Pp
731 .Bl -item -compact
732 .It
733 .Va WITHOUT_INET_SUPPORT
734 .El
735 .It Va WITHOUT_INET6
736 Set to not build
737 programs and libraries related to IPv6 networking.
738 When set, it enforces these options:
739 .Pp
740 .Bl -item -compact
741 .It
742 .Va WITHOUT_INET6_SUPPORT
743 .El
744 .It Va WITHOUT_INET6_SUPPORT
745 Set to build libraries, programs, and kernel modules without IPv6 support.
746 .It Va WITHOUT_INETD
747 Set to not build
748 .Xr inetd 8 .
749 .It Va WITHOUT_INET_SUPPORT
750 Set to build libraries, programs, and kernel modules without IPv4 support.
751 .It Va WITHOUT_INSTALLLIB
752 Set this to not install optional libraries.
753 For example, when creating a
754 .Xr nanobsd 8
755 image.
756 .Bf -symbolic
757 The option does not work for build targets.
758 .Ef
759 .It Va WITH_INSTALL_AS_USER
760 Set to make install targets succeed for non-root users by installing
761 files with owner and group attributes set to that of the user running
762 the
763 .Xr make 1
764 command.
765 The user still must set the
766 .Va DESTDIR
767 variable to point to a directory where the user has write permissions.
768 .It Va WITHOUT_IPFILTER
769 Set to not build IP Filter package.
770 .It Va WITHOUT_IPFW
771 Set to not build IPFW tools.
772 .It Va WITHOUT_IPSEC_SUPPORT
773 Set to not build the kernel with
774 .Xr ipsec 4
775 support.
776 This option is needed for
777 .Xr ipsec 4
778 and
779 .Xr tcpmd5 4 .
780 .It Va WITHOUT_ISCSI
781 Set to not build
782 .Xr iscsid 8
783 and related utilities.
784 .It Va WITHOUT_JAIL
785 Set to not build tools for the support of jails; e.g.,
786 .Xr jail 8 .
787 .It Va WITHOUT_KDUMP
788 Set to not build
789 .Xr kdump 1
790 and
791 .Xr truss 1 .
792 .It Va WITHOUT_KERBEROS
793 Set this to not build Kerberos 5 (KTH Heimdal).
794 When set, these options are also in effect:
795 .Pp
796 .Bl -inset -compact
797 .It Va WITHOUT_GSSAPI
798 (unless
799 .Va WITH_GSSAPI
800 is set explicitly)
801 .It Va WITHOUT_KERBEROS_SUPPORT
802 (unless
803 .Va WITH_KERBEROS_SUPPORT
804 is set explicitly)
805 .El
806 .It Va WITHOUT_KERBEROS_SUPPORT
807 Set to build some programs without Kerberos support, like
808 .Xr ssh 1 ,
809 .Xr telnet 1 ,
810 .Xr sshd 8 ,
811 and
812 .Xr telnetd 8 .
813 .It Va WITH_KERNEL_RETPOLINE
814 Set to enable the "retpoline" mitigation for CVE-2017-5715 in the kernel
815 build.
816 .It Va WITHOUT_KERNEL_SYMBOLS
817 Set to not install kernel symbol files.
818 .Bf -symbolic
819 This option is recommended for those people who have small root partitions.
820 .Ef
821 .It Va WITHOUT_KVM
822 Set to not build the
823 .Nm libkvm
824 library as a part of the base system.
825 .Bf -symbolic
826 The option has no effect yet.
827 .Ef
828 When set, these options are also in effect:
829 .Pp
830 .Bl -inset -compact
831 .It Va WITHOUT_KVM_SUPPORT
832 (unless
833 .Va WITH_KVM_SUPPORT
834 is set explicitly)
835 .El
836 .It Va WITHOUT_KVM_SUPPORT
837 Set to build some programs without optional
838 .Nm libkvm
839 support.
840 .It Va WITHOUT_LDNS
841 Setting this variable will prevent the LDNS library from being built.
842 When set, it enforces these options:
843 .Pp
844 .Bl -item -compact
845 .It
846 .Va WITHOUT_LDNS_UTILS
847 .It
848 .Va WITHOUT_UNBOUND
849 .El
850 .It Va WITHOUT_LDNS_UTILS
851 Setting this variable will prevent building the LDNS utilities
852 .Xr drill 1
853 and
854 .Xr host 1 .
855 .It Va WITHOUT_LEGACY_CONSOLE
856 Set to not build programs that support a legacy PC console; e.g.,
857 .Xr kbdcontrol 1
858 and
859 .Xr vidcontrol 1 .
860 .It Va WITHOUT_LIB32
861 On 64-bit platforms, set to not build 32-bit library set and a
862 .Nm ld-elf32.so.1
863 runtime linker.
864 .Pp
865 This is a default setting on
866 arm/armv6, arm/armv7, arm64/aarch64, i386/i386, mips/mips, powerpc/powerpc, riscv/riscv64 and riscv/riscv64sf.
867 .It Va WITHOUT_LIBCPLUSPLUS
868 Set to avoid building libcxxrt and libc++.
869 .It Va WITHOUT_LIBPTHREAD
870 Set to not build the
871 .Nm libpthread
872 providing library,
873 .Nm libthr .
874 When set, it enforces these options:
875 .Pp
876 .Bl -item -compact
877 .It
878 .Va WITHOUT_LIBTHR
879 .El
880 .It Va WITH_LIBSOFT
881 On armv6 only, set to enable soft float ABI compatibility libraries.
882 This option is for transitioning to the new hard float ABI.
883 .It Va WITHOUT_LIBTHR
884 Set to not build the
885 .Nm libthr
886 (1:1 threading)
887 library.
888 .It Va WITHOUT_LLD
889 Set to not build LLVM's lld linker.
890 .It Va WITHOUT_LLDB
891 Set to not build the LLDB debugger.
892 .Pp
893 This is a default setting on
894 arm/armv6, arm/armv7, mips/mips, mips/mips64, powerpc/powerpc, powerpc/powerpc64, riscv/riscv64 and riscv/riscv64sf.
895 .It Va WITH_LLDB
896 Set to build the LLDB debugger.
897 .Pp
898 This is a default setting on
899 amd64/amd64, arm64/aarch64 and i386/i386.
900 .It Va WITHOUT_LLD_BOOTSTRAP
901 Set to not build the LLD linker during the bootstrap phase of
902 the build.
903 To be able to build the system, either Binutils or LLD bootstrap must be
904 enabled unless an alternate linker is provided via XLD.
905 .It Va WITHOUT_LLD_IS_LD
906 Set to use GNU binutils ld as the system linker, instead of LLVM's LLD.
907 .It Va WITHOUT_LLVM_ASSERTIONS
908 Set to disable debugging assertions in LLVM.
909 .It Va WITHOUT_LLVM_COV
910 Set to not build the
911 .Xr llvm-cov 1
912 tool.
913 .It Va WITHOUT_LLVM_TARGET_AARCH64
914 Set to not build LLVM target support for AArch64.
915 The
916 .Va LLVM_TARGET_ALL
917 option should be used rather than this in most cases.
918 .It Va WITHOUT_LLVM_TARGET_ALL
919 Set to only build the required LLVM target support.
920 This option is preferred to specific target support options.
921 When set, these options are also in effect:
922 .Pp
923 .Bl -inset -compact
924 .It Va WITHOUT_LLVM_TARGET_AARCH64
925 (unless
926 .Va WITH_LLVM_TARGET_AARCH64
927 is set explicitly)
928 .It Va WITHOUT_LLVM_TARGET_ARM
929 (unless
930 .Va WITH_LLVM_TARGET_ARM
931 is set explicitly)
932 .It Va WITHOUT_LLVM_TARGET_MIPS
933 (unless
934 .Va WITH_LLVM_TARGET_MIPS
935 is set explicitly)
936 .It Va WITHOUT_LLVM_TARGET_POWERPC
937 (unless
938 .Va WITH_LLVM_TARGET_POWERPC
939 is set explicitly)
940 .It Va WITHOUT_LLVM_TARGET_RISCV
941 (unless
942 .Va WITH_LLVM_TARGET_RISCV
943 is set explicitly)
944 .El
945 .It Va WITHOUT_LLVM_TARGET_ARM
946 Set to not build LLVM target support for ARM.
947 The
948 .Va LLVM_TARGET_ALL
949 option should be used rather than this in most cases.
950 .It Va WITH_LLVM_TARGET_BPF
951 Set to build LLVM target support for BPF.
952 The
953 .Va LLVM_TARGET_ALL
954 option should be used rather than this in most cases.
955 .It Va WITHOUT_LLVM_TARGET_MIPS
956 Set to not build LLVM target support for MIPS.
957 The
958 .Va LLVM_TARGET_ALL
959 option should be used rather than this in most cases.
960 .It Va WITHOUT_LLVM_TARGET_POWERPC
961 Set to not build LLVM target support for PowerPC.
962 The
963 .Va LLVM_TARGET_ALL
964 option should be used rather than this in most cases.
965 .It Va WITHOUT_LLVM_TARGET_RISCV
966 Set to not build LLVM target support for RISC-V.
967 The
968 .Va LLVM_TARGET_ALL
969 option should be used rather than this in most cases.
970 .It Va WITHOUT_LLVM_TARGET_X86
971 Set to not build LLVM target support for X86.
972 The
973 .Va LLVM_TARGET_ALL
974 option should be used rather than this in most cases.
975 .It Va WITH_LOADER_EFI_SECUREBOOT
976 Enable building
977 .Xr loader 8
978 with support for verification based on certificates obtained from UEFI.
979 .Pp
980 .It Va WITH_LOADER_FIREWIRE
981 Enable firewire support in /boot/loader on x86. This option is a nop
982 on all other platforms.
983 .It Va WITH_LOADER_FORCE_LE
984 Set to force the powerpc boot loader to launch the kernel in little
985 endian mode.
986 .It Va WITHOUT_LOADER_GELI
987 Disable inclusion of GELI crypto support in the boot chain binaries.
988 .Pp
989 This is a default setting on
990 powerpc/powerpc and powerpc/powerpc64.
991 .It Va WITH_LOADER_GELI
992 Set to build GELI bootloader support.
993 .Pp
994 This is a default setting on
995 amd64/amd64, arm/armv6, arm/armv7, arm64/aarch64, i386/i386, mips/mips, mips/mips64, riscv/riscv64 and riscv/riscv64sf.
996 .It Va WITHOUT_LOADER_LUA
997 Set to not build LUA bindings for the boot loader.
998 .Pp
999 This is a default setting on
1000 powerpc/powerpc and powerpc/powerpc64.
1001 .It Va WITH_LOADER_LUA
1002 Set to build LUA bindings for the boot loader.
1003 .Pp
1004 This is a default setting on
1005 amd64/amd64, arm/armv6, arm/armv7, arm64/aarch64, i386/i386, mips/mips, mips/mips64, riscv/riscv64 and riscv/riscv64sf.
1006 .It Va WITHOUT_LOADER_OFW
1007 Disable building of openfirmware bootloader components.
1008 .Pp
1009 This is a default setting on
1010 amd64/amd64, arm/armv6, arm/armv7, arm64/aarch64, i386/i386, mips/mips, mips/mips64, riscv/riscv64 and riscv/riscv64sf.
1011 .It Va WITH_LOADER_OFW
1012 Set to build openfirmware bootloader components.
1013 .Pp
1014 This is a default setting on
1015 powerpc/powerpc and powerpc/powerpc64.
1016 .It Va WITHOUT_LOADER_UBOOT
1017 Disable building of ubldr.
1018 .Pp
1019 This is a default setting on
1020 amd64/amd64, arm64/aarch64, i386/i386, riscv/riscv64 and riscv/riscv64sf.
1021 .It Va WITH_LOADER_UBOOT
1022 Set to build ubldr.
1023 .Pp
1024 This is a default setting on
1025 arm/armv6, arm/armv7, mips/mips, mips/mips64, powerpc/powerpc and powerpc/powerpc64.
1026 .It Va WITH_LOADER_VERBOSE
1027 Set to build with extra verbose debugging in the loader.
1028 May explode already nearly too large loader over the limit.
1029 Use with care.
1030
1031 .It Va WITH_LOADER_VERIEXEC
1032 Enable building
1033 .Xr loader 8
1034 with support for verification similar to Verified Exec.
1035 .Pp
1036 Depends on
1037 .Va WITH_BEARSSL .
1038 When set, these options are also in effect:
1039 .Pp
1040 .Bl -inset -compact
1041 .It Va WITH_LOADER_EFI_SECUREBOOT
1042 (unless
1043 .Va WITHOUT_LOADER_EFI_SECUREBOOT
1044 is set explicitly)
1045 .It Va WITH_LOADER_VERIEXEC_VECTX
1046 (unless
1047 .Va WITHOUT_LOADER_VERIEXEC_VECTX
1048 is set explicitly)
1049 .El
1050 .It Va WITH_LOADER_VERIEXEC_PASS_MANIFEST
1051 Enable building
1052 .Xr loader 8
1053 with support to pass a verified manifest to the kernel.
1054 The kernel has to be built with a module to parse the manifest.
1055 .Pp
1056 Depends on
1057 .Va WITH_LOADER_VERIEXEC .
1058 .It Va WITHOUT_LOADER_ZFS
1059 Set to not build ZFS file system boot loader support.
1060 .It Va WITHOUT_LOCALES
1061 Set to not build localization files; see
1062 .Xr locale 1 .
1063 .It Va WITHOUT_LOCATE
1064 Set to not build
1065 .Xr locate 1
1066 and related programs.
1067 .It Va WITHOUT_LPR
1068 Set to not build
1069 .Xr lpr 1
1070 and related programs.
1071 .It Va WITHOUT_LS_COLORS
1072 Set to build
1073 .Xr ls 1
1074 without support for colors to distinguish file types.
1075 .It Va WITHOUT_LZMA_SUPPORT
1076 Set to build some programs without optional lzma compression support.
1077 .It Va WITHOUT_MAIL
1078 Set to not build any mail support (MUA or MTA).
1079 When set, it enforces these options:
1080 .Pp
1081 .Bl -item -compact
1082 .It
1083 .Va WITHOUT_DMAGENT
1084 .It
1085 .Va WITHOUT_MAILWRAPPER
1086 .It
1087 .Va WITHOUT_SENDMAIL
1088 .El
1089 .It Va WITHOUT_MAILWRAPPER
1090 Set to not build the
1091 .Xr mailwrapper 8
1092 MTA selector.
1093 .It Va WITHOUT_MAKE
1094 Set to not install
1095 .Xr make 1
1096 and related support files.
1097 .It Va WITHOUT_MAKE_CHECK_USE_SANDBOX
1098 Set to not execute
1099 .Dq Li "make check"
1100 in limited sandbox mode.
1101 This option should be paired with
1102 .Va WITH_INSTALL_AS_USER
1103 if executed as an unprivileged user.
1104 See
1105 .Xr tests 7
1106 for more details.
1107 .It Va WITHOUT_MAN
1108 Set to not build manual pages.
1109 When set, these options are also in effect:
1110 .Pp
1111 .Bl -inset -compact
1112 .It Va WITHOUT_MAN_UTILS
1113 (unless
1114 .Va WITH_MAN_UTILS
1115 is set explicitly)
1116 .El
1117 .It Va WITHOUT_MANCOMPRESS
1118 Set to not to install compressed man pages.
1119 Only the uncompressed versions will be installed.
1120 .It Va WITHOUT_MAN_UTILS
1121 Set to not build utilities for manual pages,
1122 .Xr apropos 1 ,
1123 .Xr makewhatis 1 ,
1124 .Xr man 1 ,
1125 .Xr whatis 1 ,
1126 .Xr manctl 8 ,
1127 and related support files.
1128 .It Va WITH_META_MODE
1129 Create
1130 .Xr make 1
1131 meta files when building, which can provide a reliable incremental build when
1132 using
1133 .Xr filemon 4 .
1134 The meta file is created in OBJDIR as
1135 .Pa target.meta .
1136 These meta files track the command that was executed, its output, and the
1137 current directory.
1138 The
1139 .Xr filemon 4
1140 module is required unless
1141 .Va NO_FILEMON
1142 is defined.
1143 When the module is loaded, any files used by the commands executed are
1144 tracked as dependencies for the target in its meta file.
1145 The target is considered out-of-date and rebuilt if any of these
1146 conditions are true compared to the last build:
1147 .Bl -bullet -compact
1148 .It
1149 The command to execute changes.
1150 .It
1151 The current working directory changes.
1152 .It
1153 The target's meta file is missing.
1154 .It
1155 The target's meta file is missing filemon data when filemon is loaded
1156 and a previous run did not have it loaded.
1157 .It
1158 [requires
1159 .Xr filemon 4 ]
1160 Files read, executed or linked to are newer than the target.
1161 .It
1162 [requires
1163 .Xr filemon 4 ]
1164 Files read, written, executed or linked are missing.
1165 .El
1166 The meta files can also be useful for debugging.
1167 .Pp
1168 The build hides commands that are executed unless
1169 .Va NO_SILENT
1170 is defined.
1171 Errors cause
1172 .Xr make 1
1173 to show some of its environment for further debugging.
1174 .Pp
1175 The build operates as it normally would otherwise.
1176 This option originally invoked a different build system but that was renamed
1177 to
1178 .Va WITH_DIRDEPS_BUILD .
1179 .Pp
1180 This must be set in the environment, make command line, or
1181 .Pa /etc/src-env.conf ,
1182 not
1183 .Pa /etc/src.conf .
1184 .It Va WITHOUT_MLX5TOOL
1185 Set to not build
1186 .Xr mlx5tool 8
1187 .Pp
1188 This is a default setting on
1189 arm/armv6, arm/armv7, mips/mips, mips/mips64, powerpc/powerpc, riscv/riscv64 and riscv/riscv64sf.
1190 .It Va WITH_MLX5TOOL
1191 Set to build
1192 .Xr mlx5tool 8
1193 .Pp
1194 This is a default setting on
1195 amd64/amd64, arm64/aarch64, i386/i386 and powerpc/powerpc64.
1196 .It Va WITHOUT_NDIS
1197 Set to not build programs and libraries
1198 related to NDIS emulation support.
1199 .It Va WITHOUT_NETCAT
1200 Set to not build
1201 .Xr nc 1
1202 utility.
1203 .It Va WITHOUT_NETGRAPH
1204 Set to not build applications to support
1205 .Xr netgraph 4 .
1206 When set, it enforces these options:
1207 .Pp
1208 .Bl -item -compact
1209 .It
1210 .Va WITHOUT_ATM
1211 .It
1212 .Va WITHOUT_BLUETOOTH
1213 .El
1214 .Pp
1215 When set, these options are also in effect:
1216 .Pp
1217 .Bl -inset -compact
1218 .It Va WITHOUT_NETGRAPH_SUPPORT
1219 (unless
1220 .Va WITH_NETGRAPH_SUPPORT
1221 is set explicitly)
1222 .El
1223 .It Va WITHOUT_NETGRAPH_SUPPORT
1224 Set to build libraries, programs, and kernel modules without netgraph support.
1225 .It Va WITHOUT_NIS
1226 Set to not build
1227 .Xr NIS 8
1228 support and related programs.
1229 If set, you might need to adopt your
1230 .Xr nsswitch.conf 5
1231 and remove
1232 .Sq nis
1233 entries.
1234 .It Va WITHOUT_NLS
1235 Set to not build NLS catalogs.
1236 When set, it enforces these options:
1237 .Pp
1238 .Bl -item -compact
1239 .It
1240 .Va WITHOUT_NLS_CATALOGS
1241 .El
1242 .It Va WITHOUT_NLS_CATALOGS
1243 Set to not build NLS catalog support for
1244 .Xr csh 1 .
1245 .It Va WITHOUT_NS_CACHING
1246 Set to disable name caching in the
1247 .Pa nsswitch
1248 subsystem.
1249 The generic caching daemon,
1250 .Xr nscd 8 ,
1251 will not be built either if this option is set.
1252 .It Va WITHOUT_NTP
1253 Set to not build
1254 .Xr ntpd 8
1255 and related programs.
1256 .It Va WITHOUT_NVME
1257 Set to not build nvme related tools and kernel modules.
1258 .Pp
1259 This is a default setting on
1260 arm/armv6, arm/armv7, mips/mips, mips/mips64, powerpc/powerpc, riscv/riscv64 and riscv/riscv64sf.
1261 .It Va WITH_NVME
1262 Set to build nvme related tools and kernel modules.
1263
1264 .Pp
1265 This is a default setting on
1266 amd64/amd64, arm64/aarch64, i386/i386 and powerpc/powerpc64.
1267 .It Va WITH_OFED
1268 Set to build the
1269 .Dq "OpenFabrics Enterprise Distribution"
1270 Infiniband software stack.
1271 .It Va WITH_OFED_EXTRA
1272 Set to build the non-essential components of the
1273 .Dq "OpenFabrics Enterprise Distribution"
1274 Infiniband software stack, mostly examples.
1275 .It Va WITH_OPENLDAP
1276 Enable building openldap support for kerberos.
1277 .It Va WITHOUT_OPENMP
1278 Set to not build LLVM's OpenMP runtime.
1279 .Pp
1280 This is a default setting on
1281 arm/armv6, arm/armv7, arm64/aarch64, mips/mips, mips/mips64, powerpc/powerpc, riscv/riscv64 and riscv/riscv64sf.
1282 .It Va WITH_OPENMP
1283 Set to build LLVM's OpenMP runtime.
1284 .Pp
1285 This is a default setting on
1286 amd64/amd64, i386/i386 and powerpc/powerpc64.
1287 .It Va WITHOUT_OPENSSH
1288 Set to not build OpenSSH.
1289 .It Va WITHOUT_OPENSSL
1290 Set to not build OpenSSL.
1291 When set, it enforces these options:
1292 .Pp
1293 .Bl -item -compact
1294 .It
1295 .Va WITHOUT_DMAGENT
1296 .It
1297 .Va WITHOUT_KERBEROS
1298 .It
1299 .Va WITHOUT_KERBEROS_SUPPORT
1300 .It
1301 .Va WITHOUT_LDNS
1302 .It
1303 .Va WITHOUT_LDNS_UTILS
1304 .It
1305 .Va WITHOUT_OPENSSH
1306 .It
1307 .Va WITHOUT_PKGBOOTSTRAP
1308 .It
1309 .Va WITHOUT_SVN
1310 .It
1311 .Va WITHOUT_SVNLITE
1312 .It
1313 .Va WITHOUT_UNBOUND
1314 .It
1315 .Va WITHOUT_WIRELESS
1316 .El
1317 .Pp
1318 When set, these options are also in effect:
1319 .Pp
1320 .Bl -inset -compact
1321 .It Va WITHOUT_GSSAPI
1322 (unless
1323 .Va WITH_GSSAPI
1324 is set explicitly)
1325 .El
1326 .It Va WITHOUT_PAM
1327 Set to not build PAM library and modules.
1328 .Bf -symbolic
1329 This option is deprecated and does nothing.
1330 .Ef
1331 When set, these options are also in effect:
1332 .Pp
1333 .Bl -inset -compact
1334 .It Va WITHOUT_PAM_SUPPORT
1335 (unless
1336 .Va WITH_PAM_SUPPORT
1337 is set explicitly)
1338 .El
1339 .It Va WITHOUT_PAM_SUPPORT
1340 Set to build some programs without PAM support, particularly
1341 .Xr ftpd 8
1342 and
1343 .Xr ppp 8 .
1344 .It Va WITHOUT_PF
1345 Set to not build PF firewall package.
1346 When set, it enforces these options:
1347 .Pp
1348 .Bl -item -compact
1349 .It
1350 .Va WITHOUT_AUTHPF
1351 .El
1352 .It Va WITH_PIE
1353 Build dynamically linked binaries as
1354 Position-Independent Executable (PIE).
1355 .It Va WITHOUT_PKGBOOTSTRAP
1356 Set to not build
1357 .Xr pkg 7
1358 bootstrap tool.
1359 .It Va WITHOUT_PMC
1360 Set to not build
1361 .Xr pmccontrol 8
1362 and related programs.
1363 .It Va WITHOUT_PORTSNAP
1364 Set to not build or install
1365 .Xr portsnap 8
1366 and related files.
1367 When set, it enforces these options:
1368 .Pp
1369 .Bl -item -compact
1370 .It
1371 .Va WITHOUT_FREEBSD_UPDATE
1372 .El
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 .