1 .\" DO NOT EDIT-- this file is generated by tools/build/options/makeman.
8 .Nd "source build options"
12 file contains settings that will apply to every build involving the
19 file uses the standard makefile syntax.
22 should not specify any dependencies to
28 variables that control the aspects of how the system builds.
30 The default location of
34 though an alternative location can be specified in the
38 Overriding the location of
40 may be necessary if the system-wide settings are not suitable
41 for a particular build.
46 effectively resets all build controls to their defaults.
50 is to control the compilation of the
52 source code, which is usually located in
54 As a rule, the system administrator creates
56 when the values of certain control variables need to be changed
59 In addition, control variables can be specified
60 for a particular build via the
64 or in its environment; see
69 for the build can be controlled via the
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 ,
79 as they are environment-only variables.
81 The values of variables are ignored regardless of their setting;
82 even if they would be set to
86 The presence of an option causes
90 This list provides a name and short description for variables
91 that can be used for source builds.
92 .Bl -tag -width indent
94 Set to not build process accounting tools such as
102 and related programs.
106 and related programs.
111 and related programs.
112 .It Va WITHOUT_ASSERT_DEBUG
113 Set to compile programs and libraries without the
119 and related utilities.
122 programs and libraries related to ATM networking.
124 Set to not build audit support into system programs.
125 .It Va WITHOUT_AUTHPF
128 .It Va WITHOUT_AUTOFS
131 related programs, libraries, and kernel modules.
132 .It Va WITHOUT_AUTO_OBJ
133 Disable automatic creation of objdirs.
134 This is enabled by default if the wanted OBJDIR is writable by the current user.
136 This must be set in the environment, make command line, or
137 .Pa /etc/src-env.conf ,
141 Set to not build or install
143 associated utilities, and examples.
145 This option only affects amd64/amd64.
146 .It Va WITHOUT_BINUTILS
147 Set to not build or install binutils (as, ld, objcopy, and objdump ) as part
148 of the normal system build.
149 The resulting system cannot build programs from source.
151 This is a default setting on
152 arm64/aarch64, riscv/riscv64 and riscv/riscv64sf.
153 When set, it enforces these options:
160 Set to build and install binutils (as, ld, objcopy, and objdump) as part
161 of the normal system build.
163 This is a default setting on
164 amd64/amd64, arm/arm, arm/armeb, arm/armv6, arm/armv7, i386/i386, mips/mipsel, mips/mips, mips/mips64el, mips/mips64, mips/mipsn32, mips/mipselhf, mips/mipshf, mips/mips64elhf, mips/mips64hf, powerpc/powerpc, powerpc/powerpc64, powerpc/powerpcspe and sparc64/sparc64.
165 .It Va WITHOUT_BINUTILS_BOOTSTRAP
166 Set to not build binutils (as, ld, objcopy and objdump)
167 as part of the bootstrap process.
169 The option does not work for build targets unless some alternative
170 toolchain is provided.
173 This is a default setting on
174 arm64/aarch64, riscv/riscv64 and riscv/riscv64sf.
175 .It Va WITH_BINUTILS_BOOTSTRAP
176 Set build binutils (as, ld, objcopy and objdump)
177 as part of the bootstrap process.
179 This is a default setting on
180 amd64/amd64, arm/arm, arm/armeb, arm/armv6, arm/armv7, i386/i386, mips/mipsel, mips/mips, mips/mips64el, mips/mips64, mips/mipsn32, mips/mipselhf, mips/mipshf, mips/mips64elhf, mips/mips64hf, powerpc/powerpc, powerpc/powerpc64, powerpc/powerpcspe and sparc64/sparc64.
181 .It Va WITHOUT_BLACKLIST
182 Set this if you do not want to build
186 When set, it enforces these options:
190 .Va WITHOUT_BLACKLIST_SUPPORT
192 .It Va WITHOUT_BLACKLIST_SUPPORT
193 Set to build some programs without
202 .It Va WITHOUT_BLUETOOTH
203 Set to not build Bluetooth related kernel modules, programs and libraries.
205 Set to not build the boot blocks and loader.
206 .It Va WITHOUT_BOOTPARAMD
207 Set to not build or install
209 .It Va WITHOUT_BOOTPD
210 Set to not build or install
212 .It Va WITHOUT_BSDINSTALL
216 and related programs.
217 .It Va WITHOUT_BSD_CPIO
218 Set to not build the BSD licensed version of cpio based on
221 Install BSD-licensed grep as '[ef]grep' instead of GNU grep.
222 .It Va WITH_BSD_GREP_FASTMATCH
223 Set this option to use the fastmatch implementation in
226 Set to not build or install
228 and related libraries and data files.
230 Set to not build contributed bzip2 software as a part of the base system.
232 The option has no effect yet.
234 When set, it enforces these options:
238 .Va WITHOUT_BZIP2_SUPPORT
240 .It Va WITHOUT_BZIP2_SUPPORT
241 Set to build some programs without optional bzip2 support.
242 .It Va WITHOUT_CALENDAR
245 .It Va WITHOUT_CAPSICUM
246 Set to not build Capsicum support into system programs.
247 When set, it enforces these options:
253 .It Va WITHOUT_CASPER
254 Set to not build Casper program and related libraries.
255 .It Va WITH_CCACHE_BUILD
259 No configuration is required except to install the
265 .Sy CCACHE_PREFIX=/usr/local/bin/distcc .
266 The default cache directory of
268 will be used, which can be overridden by setting
271 .Sy CCACHE_COMPILERCHECK
274 when using the in-tree bootstrap compiler,
277 when using an external compiler.
280 option is used for Clang but not GCC.
282 Sharing a cache between multiple work directories requires using a layout
286 and an environment such as:
287 .Bd -literal -offset indent
288 CCACHE_BASEDIR='${SRCTOP:H}' MAKEOBJDIRPREFIX='${SRCTOP:H}/obj'
293 for more configuration options.
297 and related utilities.
299 Set to not build code licensed under Sun's CDDL.
300 When set, it enforces these options:
309 Set to not build the Clang C/C++ compiler during the regular phase of the build.
311 This is a default setting on
312 riscv/riscv64, riscv/riscv64sf and sparc64/sparc64.
313 When set, it enforces these options:
317 .Va WITHOUT_CLANG_EXTRAS
319 .Va WITHOUT_CLANG_FULL
324 Set to build the Clang C/C++ compiler during the normal phase of the build.
326 This is a default setting on
327 amd64/amd64, arm/arm, arm/armeb, arm/armv6, arm/armv7, arm64/aarch64, i386/i386, mips/mipsel, mips/mips, mips/mips64el, mips/mips64, mips/mipsn32, mips/mipselhf, mips/mipshf, mips/mips64elhf, mips/mips64hf, powerpc/powerpc, powerpc/powerpc64 and powerpc/powerpcspe.
328 .It Va WITHOUT_CLANG_BOOTSTRAP
329 Set to not build the Clang C/C++ compiler during the bootstrap phase of
331 To be able to build the system, either gcc or clang bootstrap must be
332 enabled unless an alternate compiler is provided via XCC.
334 This is a default setting on
335 mips/mipsel, mips/mips, mips/mips64el, mips/mips64, mips/mipsn32, mips/mipselhf, mips/mipshf, mips/mips64elhf, mips/mips64hf, powerpc/powerpc, powerpc/powerpc64, powerpc/powerpcspe, riscv/riscv64, riscv/riscv64sf and sparc64/sparc64.
336 .It Va WITH_CLANG_BOOTSTRAP
337 Set to build the Clang C/C++ compiler during the bootstrap phase of the build.
339 This is a default setting on
340 amd64/amd64, arm/arm, arm/armeb, arm/armv6, arm/armv7, arm64/aarch64 and i386/i386.
341 .It Va WITH_CLANG_EXTRAS
342 Set to build additional clang and llvm tools, such as bugpoint.
343 .It Va WITHOUT_CLANG_FULL
344 Set to avoid building the ARCMigrate, Rewriter and StaticAnalyzer components of
345 the Clang C/C++ compiler.
347 This is a default setting on
348 riscv/riscv64, riscv/riscv64sf and sparc64/sparc64.
349 .It Va WITH_CLANG_FULL
350 Set to build the ARCMigrate, Rewriter and StaticAnalyzer components of the
351 Clang C/C++ compiler.
353 This is a default setting on
354 amd64/amd64, arm/arm, arm/armeb, arm/armv6, arm/armv7, arm64/aarch64, i386/i386, mips/mipsel, mips/mips, mips/mips64el, mips/mips64, mips/mipsn32, mips/mipselhf, mips/mipshf, mips/mips64elhf, mips/mips64hf, powerpc/powerpc, powerpc/powerpc64 and powerpc/powerpcspe.
355 .It Va WITHOUT_CLANG_IS_CC
356 Set to install the GCC compiler as
362 This is a default setting on
363 mips/mipsel, mips/mips, mips/mips64el, mips/mips64, mips/mipsn32, mips/mipselhf, mips/mipshf, mips/mips64elhf, mips/mips64hf, powerpc/powerpc, powerpc/powerpc64, powerpc/powerpcspe, riscv/riscv64, riscv/riscv64sf and sparc64/sparc64.
364 .It Va WITH_CLANG_IS_CC
365 Set to install the Clang C/C++ compiler as
371 This is a default setting on
372 amd64/amd64, arm/arm, arm/armeb, arm/armv6, arm/armv7, arm64/aarch64 and i386/i386.
376 .It Va WITHOUT_CROSS_COMPILER
377 Set to not build any cross compiler in the cross-tools stage of buildworld.
378 When compiling a different version of
380 than what is installed on the system, provide an alternate
381 compiler with XCC to ensure success.
382 When compiling with an identical version of
384 to the host, this option may be safely used.
385 This option may also be safe when the host version of
387 is close to the sources being built, but all bets are off if there have
388 been any changes to the toolchain between the versions.
389 When set, it enforces these options:
393 .Va WITHOUT_BINUTILS_BOOTSTRAP
395 .Va WITHOUT_CLANG_BOOTSTRAP
397 .Va WITHOUT_ELFTOOLCHAIN_BOOTSTRAP
399 .Va WITHOUT_GCC_BOOTSTRAP
401 .Va WITHOUT_LLD_BOOTSTRAP
404 Set to not build any crypto code.
405 When set, it enforces these options:
411 .Va WITHOUT_KERBEROS_SUPPORT
418 When set, these options are also in effect:
421 .It Va WITHOUT_GSSAPI
427 Set to compile with CTF (Compact C Type Format) data.
428 CTF data encapsulates a reduced form of debugging information
429 similar to DWARF and the venerable stabs and is required for DTrace.
433 and related utilities.
435 Set to not build CUSE-related programs and libraries.
436 .It Va WITHOUT_CXGBETOOL
439 .It Va WITHOUT_MLX5TOOL
443 This is a default setting on
444 arm/arm, arm/armeb, arm/armv6, arm/armv7, mips/mipsel, mips/mips, mips/mips64el, mips/mips64, mips/mipsn32, mips/mipselhf, mips/mipshf, mips/mips64elhf, mips/mips64hf, powerpc/powerpc, powerpc/powerpcspe, riscv/riscv64 and riscv/riscv64sf.
445 .It Va WITH_CXGBETOOL
452 This is a default setting on
453 amd64/amd64, arm64/aarch64, i386/i386, powerpc/powerpc64 and sparc64/sparc64.
457 and related libraries.
458 It will also prevent building of
463 This is a default setting on
464 riscv/riscv64 and riscv/riscv64sf.
465 When set, it enforces these options:
471 .Va WITHOUT_CLANG_EXTRAS
473 .Va WITHOUT_CLANG_FULL
475 .Va WITHOUT_DTRACE_TESTS
483 .Va WITHOUT_TESTS_SUPPORT
488 and related libraries.
490 This is a default setting on
491 amd64/amd64, arm/arm, arm/armeb, arm/armv6, arm/armv7, arm64/aarch64, i386/i386, mips/mipsel, mips/mips, mips/mips64el, mips/mips64, mips/mipsn32, mips/mipselhf, mips/mipshf, mips/mips64elhf, mips/mips64hf, powerpc/powerpc, powerpc/powerpc64, powerpc/powerpcspe and sparc64/sparc64.
492 .It Va WITHOUT_DEBUG_FILES
493 Set to avoid building or installing standalone debug files for each
494 executable binary and shared library.
495 .It Va WITHOUT_DIALOG
502 When set, it enforces these options:
506 .Va WITHOUT_BSDINSTALL
509 Set to not build the Webster dictionary files.
510 .It Va WITH_DIRDEPS_BUILD
511 This is an experimental build system.
513 http://www.crufty.net/sjg/docs/freebsd-meta-mode.htm.
514 Build commands can be seen from the top-level with:
515 .Dl make show-valid-targets
516 The build is driven by dirdeps.mk using
519 Makefile.depend files found in each directory.
521 The build can be started from anywhere, and behaves the same.
522 The initial instance of
527 .Pa Makefile.depend ,
528 computing a graph of tree dependencies from the current origin.
531 skips checking dirdep dependencies and will only build in the current
532 and child directories.
534 skips building any dirdeps and only build the current directory.
536 This also utilizes the
538 logic for incremental builds.
540 The build hides commands executed unless
544 Note that there is currently no mass install feature for this.
546 When set, it enforces these options:
550 .Va WITH_INSTALL_AS_USER
553 When set, these options are also in effect:
556 .It Va WITH_META_MODE
558 .Va WITHOUT_META_MODE
564 .It Va WITH_STAGING_MAN
566 .Va WITHOUT_STAGING_MAN
568 .It Va WITH_STAGING_PROG
570 .Va WITHOUT_STAGING_PROG
578 This must be set in the environment, make command line, or
579 .Pa /etc/src-env.conf ,
582 .It Va WITH_DIRDEPS_CACHE
583 Cache result of dirdeps.mk which can save significant time
584 for subsequent builds.
586 .Va WITH_DIRDEPS_BUILD .
588 This must be set in the environment, make command line, or
589 .Pa /etc/src-env.conf ,
592 .It Va WITHOUT_DMAGENT
593 Set to not build dma Mail Transport Agent.
594 .It Va WITHOUT_DOCCOMPRESS
595 Set to not install compressed system documentation.
596 Only the uncompressed version will be installed.
597 .It Va WITH_DTRACE_TESTS
598 Set to build and install the DTrace test suite in
599 .Pa /usr/tests/cddl/usr.sbin/dtrace .
600 This test suite is considered experimental on architectures other than
601 amd64/amd64 and running it may cause system instability.
602 .It Va WITHOUT_DYNAMICROOT
603 Set this if you do not want to link
608 .It Va WITHOUT_ED_CRYPTO
611 without support for encryption/decryption.
613 Set to not build and install
616 and related programs.
623 This is a default setting on
624 mips/mipsel, mips/mips, mips/mips64el, mips/mips64, mips/mipsn32, mips/mipselhf, mips/mipshf, mips/mips64elhf, mips/mips64hf, powerpc/powerpc, powerpc/powerpc64, powerpc/powerpcspe, riscv/riscv64, riscv/riscv64sf and sparc64/sparc64.
631 This is a default setting on
632 amd64/amd64, arm/arm, arm/armeb, arm/armv6, arm/armv7, arm64/aarch64 and i386/i386.
633 .It Va WITHOUT_ELFTOOLCHAIN_BOOTSTRAP
634 Set to not build ELF Tool Chain tools
635 (addr2line, nm, size, strings and strip)
636 as part of the bootstrap process.
638 An alternate bootstrap tool chain must be provided.
640 .It Va WITHOUT_EXAMPLES
641 Set to avoid installing examples to
642 .Pa /usr/share/examples/ .
643 .It Va WITH_EXTRA_TCP_STACKS
644 Set to build extra TCP stack modules.
646 Set to not build Flattened Device Tree support as part of the base system.
647 This includes the device tree compiler (dtc) and libfdt support library.
651 and related programs.
652 .It Va WITHOUT_FINGER
653 Set to not build or install
657 .It Va WITHOUT_FLOPPY
658 Set to not build or install programs
659 for operating floppy disk driver.
660 .It Va WITHOUT_FMTREE
661 Set to not build and install
662 .Pa /usr/sbin/fmtree .
663 .It Va WITHOUT_FORMAT_EXTENSIONS
665 .Fl fformat-extensions
666 when compiling the kernel.
667 Also disables all format checking.
669 Set to build bootloaders without Forth support.
670 .It Va WITHOUT_FP_LIBC
673 without floating-point support.
674 .It Va WITHOUT_FREEBSD_UPDATE
676 .Xr freebsd-update 8 .
678 Set to not build or install
683 Set to not build games.
685 Set to not build and install gcc and g++ as part of the normal build process.
687 This is a default setting on
688 amd64/amd64, arm/arm, arm/armeb, arm/armv6, arm/armv7, arm64/aarch64, i386/i386, riscv/riscv64 and riscv/riscv64sf.
690 Set to build and install gcc and g++.
692 This is a default setting on
693 mips/mipsel, mips/mips, mips/mips64el, mips/mips64, mips/mipsn32, mips/mipselhf, mips/mipshf, mips/mips64elhf, mips/mips64hf, powerpc/powerpc, powerpc/powerpc64, powerpc/powerpcspe and sparc64/sparc64.
694 .It Va WITHOUT_GCC_BOOTSTRAP
695 Set to not build gcc and g++ as part of the bootstrap process.
696 You must enable either gcc or clang bootstrap to be able to build the system,
697 unless an alternative compiler is provided via
700 This is a default setting on
701 amd64/amd64, arm/arm, arm/armeb, arm/armv6, arm/armv7, arm64/aarch64, i386/i386, riscv/riscv64 and riscv/riscv64sf.
702 .It Va WITH_GCC_BOOTSTRAP
703 Set to build gcc and g++ as part of the bootstrap process.
705 This is a default setting on
706 mips/mipsel, mips/mips, mips/mips64el, mips/mips64, mips/mipsn32, mips/mipselhf, mips/mipshf, mips/mips64elhf, mips/mips64hf, powerpc/powerpc, powerpc/powerpc64, powerpc/powerpcspe and sparc64/sparc64.
715 This is a default setting on
716 arm64/aarch64, riscv/riscv64 and riscv/riscv64sf.
721 This is a default setting on
722 amd64/amd64, arm/arm, arm/armeb, arm/armv6, arm/armv7, i386/i386, mips/mipsel, mips/mips, mips/mips64el, mips/mips64, mips/mipsn32, mips/mipselhf, mips/mipshf, mips/mips64elhf, mips/mips64hf, powerpc/powerpc, powerpc/powerpc64, powerpc/powerpcspe and sparc64/sparc64.
723 .It Va WITHOUT_GDB_LIBEXEC
729 This is a default setting on
730 arm/arm, arm/armeb, arm/armv6, arm/armv7 and sparc64/sparc64.
731 .It Va WITH_GDB_LIBEXEC
738 to be used as a fallback for
740 if a newer version is not installed.
742 This is a default setting on
743 amd64/amd64, arm64/aarch64, i386/i386, mips/mipsel, mips/mips, mips/mips64el, mips/mips64, mips/mipsn32, mips/mipselhf, mips/mipshf, mips/mips64elhf, mips/mips64hf, powerpc/powerpc, powerpc/powerpc64, powerpc/powerpcspe, riscv/riscv64 and riscv/riscv64sf.
744 .It Va WITHOUT_GNUCXX
745 Do not build the GNU C++ stack (g++, libstdc++).
746 This is the default on platforms where clang is the system compiler.
748 This is a default setting on
749 amd64/amd64, arm/arm, arm/armeb, arm/armv6, arm/armv7, arm64/aarch64, i386/i386, riscv/riscv64 and riscv/riscv64sf.
751 Build the GNU C++ stack (g++, libstdc++).
752 This is the default on platforms where gcc is the system compiler.
754 This is a default setting on
755 mips/mipsel, mips/mips, mips/mips64el, mips/mips64, mips/mipsn32, mips/mipselhf, mips/mipshf, mips/mips64elhf, mips/mips64hf, powerpc/powerpc, powerpc/powerpc64, powerpc/powerpcspe and sparc64/sparc64.
756 .It Va WITHOUT_GNU_DIFF
761 .It Va WITHOUT_GNU_GREP
764 .It Va WITH_GNU_GREP_COMPAT
765 Set this option to include GNU extensions in
767 by linking against libgnuregex.
771 as part of the base system.
772 .It Va WITHOUT_GPL_DTC
773 Set to build the BSD licensed version of the device tree compiler rather
774 than the GPLed one from elinux.org.
776 This is a default setting on
777 amd64/amd64, arm/arm, arm/armeb, arm/armv6, arm/armv7, arm64/aarch64 and i386/i386.
779 Set to build the GPL'd version of the device tree compiler from elinux.org,
780 instead of the BSD licensed one.
782 This is a default setting on
783 mips/mipsel, mips/mips, mips/mips64el, mips/mips64, mips/mipsn32, mips/mipselhf, mips/mipshf, mips/mips64elhf, mips/mips64hf, powerpc/powerpc, powerpc/powerpc64, powerpc/powerpcspe, riscv/riscv64, riscv/riscv64sf and sparc64/sparc64.
784 .It Va WITHOUT_GSSAPI
785 Set to not build libgssapi.
789 and related utilities.
791 Set to build Hesiod support.
793 Set to not build HTML docs.
794 .It Va WITHOUT_HYPERV
795 Set to not build or install HyperV utilities.
797 Set to not build iconv as part of libc.
798 .It Va WITHOUT_INCLUDES
799 Set to not install header files.
800 This option used to be spelled
803 The option does not work for build targets.
806 Set to not build programs and libraries related to IPv4 networking.
807 When set, it enforces these options:
811 .Va WITHOUT_INET_SUPPORT
815 programs and libraries related to IPv6 networking.
816 When set, it enforces these options:
820 .Va WITHOUT_INET6_SUPPORT
822 .It Va WITHOUT_INET6_SUPPORT
823 Set to build libraries, programs, and kernel modules without IPv6 support.
827 .It Va WITHOUT_INET_SUPPORT
828 Set to build libraries, programs, and kernel modules without IPv4 support.
829 .It Va WITHOUT_INSTALLLIB
830 Set this to not install optional libraries.
831 For example, when creating a
835 The option does not work for build targets.
837 .It Va WITH_INSTALL_AS_USER
838 Set to make install targets succeed for non-root users by installing
839 files with owner and group attributes set to that of the user running
843 The user still must set the
845 variable to point to a directory where the user has write permissions.
846 .It Va WITHOUT_IPFILTER
847 Set to not build IP Filter package.
849 Set to not build IPFW tools.
850 .It Va WITHOUT_IPSEC_SUPPORT
851 Set to not build the kernel with
854 This option is needed for
861 and related utilities.
863 Set to not build tools for the support of jails; e.g.,
870 .It Va WITHOUT_KERBEROS
871 Set this to not build Kerberos 5 (KTH Heimdal).
872 When set, it enforces these options:
876 .Va WITHOUT_KERBEROS_SUPPORT
879 When set, these options are also in effect:
882 .It Va WITHOUT_GSSAPI
887 .It Va WITHOUT_KERBEROS_SUPPORT
888 Set to build some programs without Kerberos support, like
894 .It Va WITH_KERNEL_RETPOLINE
895 Set to enable the "retpoline" mitigation for CVE-2017-5715 in the kernel
897 .It Va WITHOUT_KERNEL_SYMBOLS
898 Set to not install kernel symbol files.
900 This option is recommended for those people who have small root partitions.
905 library as a part of the base system.
907 The option has no effect yet.
909 When set, it enforces these options:
913 .Va WITHOUT_KVM_SUPPORT
915 .It Va WITHOUT_KVM_SUPPORT
916 Set to build some programs without optional
920 Setting this variable will prevent the LDNS library from being built.
921 When set, it enforces these options:
925 .Va WITHOUT_LDNS_UTILS
929 .It Va WITHOUT_LDNS_UTILS
930 Setting this variable will prevent building the LDNS utilities
934 .It Va WITHOUT_LEGACY_CONSOLE
935 Set to not build programs that support a legacy PC console; e.g.,
940 On 64-bit platforms, set to not build 32-bit library set and a
943 .It Va WITHOUT_LIBCPLUSPLUS
944 Set to avoid building libcxxrt and libc++.
945 .It Va WITHOUT_LIBPTHREAD
950 When set, it enforces these options:
957 On armv6 only, set to enable soft float ABI compatibility libraries.
958 This option is for transitioning to the new hard float ABI.
959 .It Va WITHOUT_LIBTHR
965 Set to not build LLVM's lld linker.
967 This is a default setting on
968 mips/mipsel, mips/mips, mips/mips64el, mips/mips64, mips/mipsn32, mips/mipselhf, mips/mipshf, mips/mips64elhf, mips/mips64hf, powerpc/powerpc, powerpc/powerpc64, powerpc/powerpcspe, riscv/riscv64, riscv/riscv64sf and sparc64/sparc64.
970 Set to build LLVM's lld linker.
972 This is a default setting on
973 amd64/amd64, arm/arm, arm/armeb, arm/armv6, arm/armv7, arm64/aarch64 and i386/i386.
975 Set to not build the LLDB debugger.
977 This is a default setting on
978 arm/arm, arm/armeb, arm/armv6, arm/armv7, mips/mipsel, mips/mips, mips/mips64el, mips/mips64, mips/mipsn32, mips/mipselhf, mips/mipshf, mips/mips64elhf, mips/mips64hf, powerpc/powerpc, powerpc/powerpc64, powerpc/powerpcspe, riscv/riscv64, riscv/riscv64sf and sparc64/sparc64.
980 Set to build the LLDB debugger.
982 This is a default setting on
983 amd64/amd64, arm64/aarch64 and i386/i386.
984 .It Va WITHOUT_LLD_BOOTSTRAP
985 Set to not build the LLD linker during the bootstrap phase of
987 To be able to build the system, either Binutils or LLD bootstrap must be
988 enabled unless an alternate linker is provided via XLD.
990 This is a default setting on
991 arm/arm, arm/armeb, arm/armv6, arm/armv7, i386/i386, mips/mipsel, mips/mips, mips/mips64el, mips/mips64, mips/mipsn32, mips/mipselhf, mips/mipshf, mips/mips64elhf, mips/mips64hf, powerpc/powerpc, powerpc/powerpc64, powerpc/powerpcspe, riscv/riscv64, riscv/riscv64sf and sparc64/sparc64.
992 .It Va WITH_LLD_BOOTSTRAP
993 Set to build the LLD linker during the bootstrap phase of the build.
995 This is a default setting on
996 amd64/amd64 and arm64/aarch64.
997 .It Va WITHOUT_LLD_IS_LD
998 Set to use GNU binutils ld as the system linker, instead of LLVM's LLD.
1000 This is a default setting on
1001 amd64/amd64, arm/arm, arm/armeb, arm/armv6, arm/armv7, i386/i386, mips/mipsel, mips/mips, mips/mips64el, mips/mips64, mips/mipsn32, mips/mipselhf, mips/mipshf, mips/mips64elhf, mips/mips64hf, powerpc/powerpc, powerpc/powerpc64, powerpc/powerpcspe, riscv/riscv64, riscv/riscv64sf and sparc64/sparc64.
1002 .It Va WITH_LLD_IS_LD
1003 Set to use LLVM's LLD as the system linker, instead of GNU binutils ld.
1005 This is a default setting on
1007 .It Va WITHOUT_LLVM_COV
1008 Set to not build the
1012 This is a default setting on
1013 riscv/riscv64, riscv/riscv64sf and sparc64/sparc64.
1014 .It Va WITH_LLVM_COV
1019 This is a default setting on
1020 amd64/amd64, arm/arm, arm/armeb, arm/armv6, arm/armv7, arm64/aarch64, i386/i386, mips/mipsel, mips/mips, mips/mips64el, mips/mips64, mips/mipsn32, mips/mipselhf, mips/mipshf, mips/mips64elhf, mips/mips64hf, powerpc/powerpc, powerpc/powerpc64 and powerpc/powerpcspe.
1021 .It Va WITHOUT_LLVM_LIBUNWIND
1022 Set to use GCC's stack unwinder (instead of LLVM's libunwind).
1024 This is a default setting on
1025 arm/arm, arm/armeb, arm/armv6, arm/armv7, mips/mipsel, mips/mips, mips/mips64el, mips/mips64, mips/mipsn32, mips/mipselhf, mips/mipshf, mips/mips64elhf, mips/mips64hf, powerpc/powerpc, powerpc/powerpc64, powerpc/powerpcspe and sparc64/sparc64.
1026 .It Va WITH_LLVM_LIBUNWIND
1027 Set to use LLVM's libunwind stack unwinder (instead of GCC's unwinder).
1029 This is a default setting on
1030 amd64/amd64, arm64/aarch64, i386/i386, riscv/riscv64 and riscv/riscv64sf.
1031 .It Va WITH_LOADER_FIREWIRE
1032 Enable firewire support in /boot/loader and /boot/zfsloader on x86.
1033 This option is a nop on all other platforms.
1034 .It Va WITHOUT_LOADER_GELI
1035 Disable inclusion of GELI crypto support in the boot chain binaries.
1037 This is a default setting on
1038 arm/arm, arm/armeb, arm/armv6, arm/armv7, arm64/aarch64, mips/mipsel, mips/mips, mips/mips64el, mips/mips64, mips/mipsn32, mips/mipselhf, mips/mipshf, mips/mips64elhf, mips/mips64hf, powerpc/powerpc, powerpc/powerpc64, powerpc/powerpcspe, riscv/riscv64, riscv/riscv64sf and sparc64/sparc64.
1039 .It Va WITH_LOADER_LUA
1040 Set to build LUA bindings for the boot loader.
1041 .It Va WITHOUT_LOADER_OFW
1042 Disable building of openfirmware bootloader components.
1044 This is a default setting on
1045 amd64/amd64, arm/arm, arm/armeb, arm/armv6, arm/armv7, arm64/aarch64, i386/i386, mips/mipsel, mips/mips, mips/mips64el, mips/mips64, mips/mipsn32, mips/mipselhf, mips/mipshf, mips/mips64elhf, mips/mips64hf, riscv/riscv64 and riscv/riscv64sf.
1046 .It Va WITH_LOADER_OFW
1047 Set to build openfirmware bootloader components.
1049 This is a default setting on
1050 powerpc/powerpc, powerpc/powerpc64, powerpc/powerpcspe and sparc64/sparc64.
1051 .It Va WITHOUT_LOADER_UBOOT
1052 Disable building of ubldr.
1054 This is a default setting on
1055 amd64/amd64, arm64/aarch64, i386/i386, riscv/riscv64, riscv/riscv64sf and sparc64/sparc64.
1056 .It Va WITH_LOADER_UBOOT
1059 This is a default setting on
1060 arm/arm, arm/armeb, arm/armv6, arm/armv7, mips/mipsel, mips/mips, mips/mips64el, mips/mips64, mips/mipsn32, mips/mipselhf, mips/mipshf, mips/mips64elhf, mips/mips64hf, powerpc/powerpc, powerpc/powerpc64 and powerpc/powerpcspe.
1061 .It Va WITHOUT_LOCALES
1062 Set to not build localization files; see
1064 .It Va WITHOUT_LOCATE
1067 and related programs.
1071 and related programs.
1072 .It Va WITHOUT_LS_COLORS
1075 without support for colors to distinguish file types.
1076 .It Va WITHOUT_LZMA_SUPPORT
1077 Set to build some programs without optional lzma compression support.
1079 Set to not build any mail support (MUA or MTA).
1080 When set, it enforces these options:
1086 .Va WITHOUT_MAILWRAPPER
1088 .Va WITHOUT_SENDMAIL
1090 .It Va WITHOUT_MAILWRAPPER
1091 Set to not build the
1097 and related support files.
1098 .It Va WITHOUT_MAKE_CHECK_USE_SANDBOX
1101 in limited sandbox mode.
1102 This option should be paired with
1103 .Va WITH_INSTALL_AS_USER
1104 if executed as an unprivileged user.
1109 Set to not build manual pages.
1110 When set, these options are also in effect:
1113 .It Va WITHOUT_MAN_UTILS
1118 .It Va WITHOUT_MANCOMPRESS
1119 Set to not to install compressed man pages.
1120 Only the uncompressed versions will be installed.
1121 .It Va WITHOUT_MAN_UTILS
1122 Set to not build utilities for manual pages,
1128 and related support files.
1129 .It Va WITH_META_MODE
1132 meta files when building, which can provide a reliable incremental build when
1135 The meta file is created in OBJDIR as
1137 These meta files track the command that was executed, its output, and the
1141 module is required unless
1144 When the module is loaded, any files used by the commands executed are
1145 tracked as dependencies for the target in its meta file.
1146 The target is considered out-of-date and rebuilt if any of these
1147 conditions are true compared to the last build:
1148 .Bl -bullet -compact
1150 The command to execute changes.
1152 The current working directory changes.
1154 The target's meta file is missing.
1156 The target's meta file is missing filemon data when filemon is loaded
1157 and a previous run did not have it loaded.
1161 Files read, executed or linked to are newer than the target.
1165 Files read, written, executed or linked are missing.
1167 The meta files can also be useful for debugging.
1169 The build hides commands that are executed unless
1174 to show some of its environment for further debugging.
1176 The build operates as it normally would otherwise.
1177 This option originally invoked a different build system but that was renamed
1179 .Va WITH_DIRDEPS_BUILD .
1181 This must be set in the environment, make command line, or
1182 .Pa /etc/src-env.conf ,
1186 Set to build the NAND Flash components.
1188 Set to not build programs and libraries
1189 related to NDIS emulation support.
1190 .It Va WITHOUT_NETCAT
1194 .It Va WITHOUT_NETGRAPH
1195 Set to not build applications to support
1197 When set, it enforces these options:
1203 .Va WITHOUT_BLUETOOTH
1205 .Va WITHOUT_NETGRAPH_SUPPORT
1207 .It Va WITHOUT_NETGRAPH_SUPPORT
1208 Set to build libraries, programs, and kernel modules without netgraph support.
1212 support and related programs.
1213 If set, you might need to adopt your
1219 Set to not build NLS catalogs.
1220 When set, it enforces these options:
1224 .Va WITHOUT_NLS_CATALOGS
1226 .It Va WITHOUT_NLS_CATALOGS
1227 Set to not build NLS catalog support for
1229 .It Va WITHOUT_NS_CACHING
1230 Set to disable name caching in the
1233 The generic caching daemon,
1235 will not be built either if this option is set.
1239 and related programs.
1242 .Dq "OpenFabrics Enterprise Distribution"
1243 Infiniband software stack.
1244 .It Va WITH_OPENLDAP
1245 Enable building openldap support for kerberos.
1246 .It Va WITHOUT_OPENSSH
1247 Set to not build OpenSSH.
1248 .It Va WITHOUT_OPENSSL
1249 Set to not build OpenSSL.
1250 When set, it enforces these options:
1254 .Va WITHOUT_KERBEROS
1256 .Va WITHOUT_KERBEROS_SUPPORT
1261 When set, these options are also in effect:
1264 .It Va WITHOUT_GSSAPI
1270 Set to not build PAM library and modules.
1272 This option is deprecated and does nothing.
1274 When set, it enforces these options:
1278 .Va WITHOUT_PAM_SUPPORT
1280 .It Va WITHOUT_PAM_SUPPORT
1281 Set to build some programs without PAM support, particularly
1285 .It Va WITHOUT_PC_SYSINSTALL
1288 and related programs.
1290 Set to not build PF firewall package.
1291 When set, it enforces these options:
1297 .It Va WITHOUT_PKGBOOTSTRAP
1304 and related programs.
1305 .It Va WITHOUT_PORTSNAP
1306 Set to not build or install
1312 and related programs.
1313 .It Va WITHOUT_PROFILE
1314 Set to not build profiled libraries for use with
1317 This is a default setting on
1318 mips/mips64el, mips/mips64, mips/mips64elhf, mips/mips64hf, riscv/riscv64 and riscv/riscv64sf.
1320 Set to build profiled libraries for use with
1323 This is a default setting on
1324 amd64/amd64, arm/arm, arm/armeb, arm/armv6, arm/armv7, arm64/aarch64, i386/i386, mips/mipsel, mips/mips, mips/mipsn32, mips/mipselhf, mips/mipshf, powerpc/powerpc, powerpc/powerpc64, powerpc/powerpcspe and sparc64/sparc64.
1325 .It Va WITHOUT_QUOTAS
1328 and related programs.
1329 .It Va WITHOUT_RADIUS_SUPPORT
1330 Set to not build radius support into various applications, like
1334 .It Va WITH_RATELIMIT
1335 Set to build the system with rate limit support.
1338 .Dv SO_MAX_PACING_RATE
1346 .It Va WITHOUT_RBOOTD
1347 Set to not build or install
1349 .It Va WITH_REPRODUCIBLE_BUILD
1350 Set to exclude build metadata (such as the build time, user, or host)
1351 from the kernel, boot loaders, and uname output, so that builds produce
1352 bit-for-bit identical output.
1353 .It Va WITHOUT_RESCUE
1356 .It Va WITHOUT_ROUTED
1360 .It Va WITH_RPCBIND_WARMSTART_SUPPORT
1363 with warmstart support.
1364 .It Va WITHOUT_SENDMAIL
1367 and related programs.
1368 .It Va WITHOUT_SETUID_LOGIN
1369 Set this to disable the installation of
1371 as a set-user-ID root program.
1372 .It Va WITHOUT_SHAREDOCS
1373 Set to not build the
1376 .It Va WITH_SHARED_TOOLCHAIN
1377 Set to build the toolchain binaries shared.
1381 and necessary utilities like assembler, linker and library archive manager.
1382 .It Va WITH_SORT_THREADS
1383 Set to enable threads in
1385 .It Va WITHOUT_SOURCELESS
1386 Set to not build kernel modules that include sourceless code (either microcode or native code for host CPU).
1387 When set, it enforces these options:
1391 .Va WITHOUT_SOURCELESS_HOST
1393 .Va WITHOUT_SOURCELESS_UCODE
1395 .It Va WITHOUT_SOURCELESS_HOST
1396 Set to not build kernel modules that include sourceless native code for host CPU.
1397 .It Va WITHOUT_SOURCELESS_UCODE
1398 Set to not build kernel modules that include sourceless microcode.
1400 Set to not build world with propolice stack smashing protection.
1402 This is a default setting on
1403 mips/mipsel, mips/mips, mips/mips64el, mips/mips64, mips/mipsn32, mips/mipselhf, mips/mipshf, mips/mips64elhf and mips/mips64hf.
1405 Set to build world with propolice stack smashing protection.
1407 This is a default setting on
1408 amd64/amd64, arm/arm, arm/armeb, arm/armv6, arm/armv7, arm64/aarch64, i386/i386, powerpc/powerpc, powerpc/powerpc64, powerpc/powerpcspe, riscv/riscv64, riscv/riscv64sf and sparc64/sparc64.
1410 Enable staging of files to a stage tree.
1411 This can be best thought of as auto-install to
1413 with some extra meta data to ensure dependencies can be tracked.
1415 .Va WITH_DIRDEPS_BUILD .
1416 When set, these options are also in effect:
1419 .It Va WITH_STAGING_MAN
1421 .Va WITHOUT_STAGING_MAN
1423 .It Va WITH_STAGING_PROG
1425 .Va WITHOUT_STAGING_PROG
1429 This must be set in the environment, make command line, or
1430 .Pa /etc/src-env.conf ,
1433 .It Va WITH_STAGING_MAN
1434 Enable staging of man pages to stage tree.
1435 .It Va WITH_STAGING_PROG
1436 Enable staging of PROGs to stage tree.
1437 .It Va WITH_STALE_STAGED
1438 Check staged files are not stale.
1444 .It Va WITHOUT_SVNLITE
1447 and related programs.
1448 .It Va WITHOUT_SYMVER
1449 Set to disable symbol versioning when building shared libraries.
1450 .It Va WITHOUT_SYSCONS
1453 support files such as keyboard maps, fonts, and screen output maps.
1455 Enable use of sysroot during build.
1457 .Va WITH_DIRDEPS_BUILD .
1459 This must be set in the environment, make command line, or
1460 .Pa /etc/src-env.conf ,
1463 .It Va WITHOUT_SYSTEM_COMPILER
1464 Set to not opportunistically skip building a cross-compiler during the
1465 bootstrap phase of the build.
1466 Normally, if the currently installed compiler matches the planned bootstrap
1467 compiler type and revision, then it will not be built.
1468 This does not prevent a compiler from being built for installation though,
1469 only for building one for the build itself.
1474 options control those.
1476 Set to not build or install
1480 .It Va WITHOUT_TCP_WRAPPERS
1481 Set to not build or install
1483 and related utilities.
1485 Set to not build and install
1489 .It Va WITHOUT_TELNET
1492 and related programs.
1493 .It Va WITHOUT_TESTS
1494 Set to not build nor install the
1501 This also disables the build of all test-related dependencies, including ATF.
1503 This is a default setting on
1504 riscv/riscv64 and riscv/riscv64sf.
1505 When set, it enforces these options:
1509 .Va WITHOUT_DTRACE_TESTS
1511 .Va WITHOUT_TESTS_SUPPORT
1513 .It Va WITHOUT_TESTS_SUPPORT
1514 Set to disables the build of all test-related dependencies, including ATF.
1516 This is a default setting on
1517 riscv/riscv64 and riscv/riscv64sf.
1518 .It Va WITHOUT_TEXTPROC
1520 programs used for text processing.
1522 Set to not build or install
1526 .It Va WITHOUT_TIMED
1527 Set to not build or install
1529 .It Va WITHOUT_TOOLCHAIN
1530 Set to not install header or
1531 programs used for program development,
1532 compilers, debuggers etc.
1533 When set, it enforces these options:
1537 .Va WITHOUT_BINUTILS
1541 .Va WITHOUT_CLANG_EXTRAS
1543 .Va WITHOUT_CLANG_FULL
1549 .Va WITHOUT_INCLUDES
1555 .Va WITHOUT_LLVM_COV
1557 .It Va WITHOUT_UNBOUND
1560 and related programs.
1561 .It Va WITHOUT_UNIFIED_OBJDIR
1562 Set to use the historical object directory format for
1565 For native-builds and builds done directly in sub-directories the format of
1566 .Pa ${MAKEOBJDIRPREFIX}/${.CURDIR}
1568 while for cross-builds
1569 .Pa ${MAKEOBJDIRPREFIX}/${TARGET}.${TARGET_ARCH}/${.CURDIR}
1572 This option is transitional and will be removed before the 12.0 release,
1574 .va WITH_UNIFIED_OBJDIR
1575 will be enabled permanently.
1577 This must be set in the environment, make command line, or
1578 .Pa /etc/src-env.conf ,
1582 Set to not build USB-related programs and libraries.
1583 .It Va WITHOUT_USB_GADGET_EXAMPLES
1584 Set to not build USB gadget kernel modules.
1585 .It Va WITHOUT_UTMPX
1586 Set to not build user accounting tools such as
1595 Set to not build and install vi, view, ex and related programs.
1599 support files (fonts and keymaps).
1600 .It Va WITHOUT_WARNS
1601 Set this to not add warning flags to the compiler invocations.
1602 Useful as a temporary workaround when code enters the tree
1603 which triggers warnings in environments that differ from the
1605 .It Va WITHOUT_WIRELESS
1606 Set to not build programs used for 802.11 wireless networks; especially
1607 .Xr wpa_supplicant 8
1610 When set, it enforces these options:
1614 .Va WITHOUT_WIRELESS_SUPPORT
1616 .It Va WITHOUT_WIRELESS_SUPPORT
1617 Set to build libraries, programs, and kernel modules without
1618 802.11 wireless support.
1619 .It Va WITHOUT_WPA_SUPPLICANT_EAPOL
1621 .Xr wpa_supplicant 8
1622 without support for the IEEE 802.1X protocol and without
1623 support for EAP-PEAP, EAP-TLS, EAP-LEAP, and EAP-TTLS
1624 protocols (usable only via 802.1X).
1626 Set to not build ZFS file system.
1627 .It Va WITHOUT_ZONEINFO
1628 Set to not build the timezone database.
1629 When set, it enforces these options:
1633 .Va WITHOUT_ZONEINFO_LEAPSECONDS_SUPPORT
1635 .Va WITHOUT_ZONEINFO_OLD_TIMEZONES_SUPPORT
1637 .It Va WITH_ZONEINFO_LEAPSECONDS_SUPPORT
1638 Set to build leapsecond information in to the timezone database.
1639 .It Va WITH_ZONEINFO_OLD_TIMEZONES_SUPPORT
1640 Set to build backward compatibility timezone aliases in to the timezone
1644 .Bl -tag -compact -width Pa
1645 .It Pa /etc/src.conf
1646 .It Pa /etc/src-env.conf
1647 .It Pa /usr/share/mk/bsd.own.mk
1660 This manual page was autogenerated by
1661 .An tools/build/options/makeman .