]> CyberLeo.Net >> Repos - FreeBSD/FreeBSD.git/blob - share/man/man5/src.conf.5
Update the Release Engineering article URL to the modern version.
[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 March 7, 2018
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_AMD
104 Set to not build
105 .Xr amd 8 ,
106 and related programs.
107 .It Va WITHOUT_APM
108 Set to not build
109 .Xr apm 8 ,
110 .Xr apmd 8
111 and related programs.
112 .It Va WITHOUT_ASSERT_DEBUG
113 Set to compile programs and libraries without the
114 .Xr assert 3
115 checks.
116 .It Va WITHOUT_AT
117 Set to not build
118 .Xr at 1
119 and related utilities.
120 .It Va WITHOUT_ATM
121 Set to not build
122 programs and libraries related to ATM networking.
123 .It Va WITHOUT_AUDIT
124 Set to not build audit support into system programs.
125 .It Va WITHOUT_AUTHPF
126 Set to not build
127 .Xr authpf 8 .
128 .It Va WITHOUT_AUTOFS
129 Set to not build
130 .Xr autofs 5
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.
135 .Pp
136 This must be set in the environment, make command line, or
137 .Pa /etc/src-env.conf ,
138 not
139 .Pa /etc/src.conf .
140 .It Va WITHOUT_BHYVE
141 Set to not build or install
142 .Xr bhyve 8 ,
143 associated utilities, and examples.
144 .Pp
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.
150 .Pp
151 This is a default setting on
152 arm64/aarch64, riscv/riscv64 and riscv/riscv64sf.
153 When set, it enforces these options:
154 .Pp
155 .Bl -item -compact
156 .It
157 .Va WITHOUT_GDB
158 .El
159 .It Va WITH_BINUTILS
160 Set to build and install binutils (as, ld, objcopy, and objdump) as part
161 of the normal system build.
162 .Pp
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.
168 .Bf -symbolic
169 The option does not work for build targets unless some alternative
170 toolchain is provided.
171 .Ef
172 .Pp
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.
178 .Pp
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
183 .Xr blacklistd 8
184 and
185 .Xr blacklistctl 8 .
186 When set, it enforces these options:
187 .Pp
188 .Bl -item -compact
189 .It
190 .Va WITHOUT_BLACKLIST_SUPPORT
191 .El
192 .It Va WITHOUT_BLACKLIST_SUPPORT
193 Set to build some programs without
194 .Xr libblacklist 3
195 support, like
196 .Xr fingerd 8 ,
197 .Xr ftpd 8 ,
198 .Xr rlogind 8 ,
199 .Xr rshd 8 ,
200 and
201 .Xr sshd 8 .
202 .It Va WITHOUT_BLUETOOTH
203 Set to not build Bluetooth related kernel modules, programs and libraries.
204 .It Va WITHOUT_BOOT
205 Set to not build the boot blocks and loader.
206 .It Va WITHOUT_BOOTPARAMD
207 Set to not build or install
208 .Xr bootparamd 8 .
209 .It Va WITHOUT_BOOTPD
210 Set to not build or install
211 .Xr bootpd 8 .
212 .It Va WITHOUT_BSDINSTALL
213 Set to not build
214 .Xr bsdinstall 8 ,
215 .Xr sade 8 ,
216 and related programs.
217 .It Va WITHOUT_BSD_CPIO
218 Set to not build the BSD licensed version of cpio based on
219 .Xr libarchive 3 .
220 .It Va WITH_BSD_GREP
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
224 .Xr bsdgrep 1 .
225 .It Va WITHOUT_BSNMP
226 Set to not build or install
227 .Xr bsnmpd 1
228 and related libraries and data files.
229 .It Va WITHOUT_BZIP2
230 Set to not build contributed bzip2 software as a part of the base system.
231 .Bf -symbolic
232 The option has no effect yet.
233 .Ef
234 When set, it enforces these options:
235 .Pp
236 .Bl -item -compact
237 .It
238 .Va WITHOUT_BZIP2_SUPPORT
239 .El
240 .It Va WITHOUT_BZIP2_SUPPORT
241 Set to build some programs without optional bzip2 support.
242 .It Va WITHOUT_CALENDAR
243 Set to not build
244 .Xr calendar 1 .
245 .It Va WITHOUT_CAPSICUM
246 Set to not build Capsicum support into system programs.
247 When set, it enforces these options:
248 .Pp
249 .Bl -item -compact
250 .It
251 .Va WITHOUT_CASPER
252 .El
253 .It Va WITHOUT_CASPER
254 Set to not build Casper program and related libraries.
255 .It Va WITH_CCACHE_BUILD
256 Set to use
257 .Xr ccache 1
258 for the build.
259 No configuration is required except to install the
260 .Sy devel/ccache
261 package.
262 When using with
263 .Xr distcc 1 ,
264 set
265 .Sy CCACHE_PREFIX=/usr/local/bin/distcc .
266 The default cache directory of
267 .Pa $HOME/.ccache
268 will be used, which can be overridden by setting
269 .Sy CCACHE_DIR .
270 The
271 .Sy CCACHE_COMPILERCHECK
272 option defaults to
273 .Sy content
274 when using the in-tree bootstrap compiler,
275 and
276 .Sy mtime
277 when using an external compiler.
278 The
279 .Sy CCACHE_CPP2
280 option is used for Clang but not GCC.
281 .Pp
282 Sharing a cache between multiple work directories requires using a layout
283 similar to
284 .Pa /some/prefix/src
285 .Pa /some/prefix/obj
286 and an environment such as:
287 .Bd -literal -offset indent
288 CCACHE_BASEDIR='${SRCTOP:H}' MAKEOBJDIRPREFIX='${SRCTOP:H}/obj'
289 .Ed
290 .Pp
291 See
292 .Xr ccache 1
293 for more configuration options.
294 .It Va WITHOUT_CCD
295 Set to not build
296 .Xr geom_ccd 4
297 and related utilities.
298 .It Va WITHOUT_CDDL
299 Set to not build code licensed under Sun's CDDL.
300 When set, it enforces these options:
301 .Pp
302 .Bl -item -compact
303 .It
304 .Va WITHOUT_CTF
305 .It
306 .Va WITHOUT_ZFS
307 .El
308 .It Va WITHOUT_CLANG
309 Set to not build the Clang C/C++ compiler during the regular phase of the build.
310 .Pp
311 This is a default setting on
312 riscv/riscv64, riscv/riscv64sf and sparc64/sparc64.
313 When set, it enforces these options:
314 .Pp
315 .Bl -item -compact
316 .It
317 .Va WITHOUT_CLANG_EXTRAS
318 .It
319 .Va WITHOUT_CLANG_FULL
320 .It
321 .Va WITHOUT_LLVM_COV
322 .El
323 .It Va WITH_CLANG
324 Set to build the Clang C/C++ compiler during the normal phase of the build.
325 .Pp
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
330 the build.
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.
333 .Pp
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.
338 .Pp
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.
346 .Pp
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.
352 .Pp
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
357 .Pa /usr/bin/cc ,
358 .Pa /usr/bin/c++
359 and
360 .Pa /usr/bin/cpp .
361 .Pp
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
366 .Pa /usr/bin/cc ,
367 .Pa /usr/bin/c++
368 and
369 .Pa /usr/bin/cpp .
370 .Pp
371 This is a default setting on
372 amd64/amd64, arm/arm, arm/armeb, arm/armv6, arm/armv7, arm64/aarch64 and i386/i386.
373 .It Va WITHOUT_CPP
374 Set to not build
375 .Xr cpp 1 .
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
379 .Fx
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
383 .Fx
384 to the host, this option may be safely used.
385 This option may also be safe when the host version of
386 .Fx
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:
390 .Pp
391 .Bl -item -compact
392 .It
393 .Va WITHOUT_BINUTILS_BOOTSTRAP
394 .It
395 .Va WITHOUT_CLANG_BOOTSTRAP
396 .It
397 .Va WITHOUT_ELFTOOLCHAIN_BOOTSTRAP
398 .It
399 .Va WITHOUT_GCC_BOOTSTRAP
400 .It
401 .Va WITHOUT_LLD_BOOTSTRAP
402 .El
403 .It Va WITHOUT_CRYPT
404 Set to not build any crypto code.
405 When set, it enforces these options:
406 .Pp
407 .Bl -item -compact
408 .It
409 .Va WITHOUT_KERBEROS
410 .It
411 .Va WITHOUT_KERBEROS_SUPPORT
412 .It
413 .Va WITHOUT_OPENSSH
414 .It
415 .Va WITHOUT_OPENSSL
416 .El
417 .Pp
418 When set, these options are also in effect:
419 .Pp
420 .Bl -inset -compact
421 .It Va WITHOUT_GSSAPI
422 (unless
423 .Va WITH_GSSAPI
424 is set explicitly)
425 .El
426 .It Va WITH_CTF
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.
430 .It Va WITHOUT_CTM
431 Set to not build
432 .Xr ctm 1
433 and related utilities.
434 .It Va WITHOUT_CUSE
435 Set to not build CUSE-related programs and libraries.
436 .It Va WITHOUT_CXGBETOOL
437 Set to not build
438 .Xr cxgbetool 8
439 .It Va WITHOUT_MLX5TOOL
440 Set to not build
441 .Xr mlx5tool 8
442 .Pp
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
446 Set to build
447 .Xr cxgbetool 8
448 .It Va WITH_MLX5TOOL
449 Set to build
450 .Xr mlx5tool 8
451 .Pp
452 This is a default setting on
453 amd64/amd64, arm64/aarch64, i386/i386, powerpc/powerpc64 and sparc64/sparc64.
454 .It Va WITHOUT_CXX
455 Set to not build
456 .Xr c++ 1
457 and related libraries.
458 It will also prevent building of
459 .Xr gperf 1
460 and
461 .Xr devd 8 .
462 .Pp
463 This is a default setting on
464 riscv/riscv64 and riscv/riscv64sf.
465 When set, it enforces these options:
466 .Pp
467 .Bl -item -compact
468 .It
469 .Va WITHOUT_CLANG
470 .It
471 .Va WITHOUT_CLANG_EXTRAS
472 .It
473 .Va WITHOUT_CLANG_FULL
474 .It
475 .Va WITHOUT_DTRACE_TESTS
476 .It
477 .Va WITHOUT_GNUCXX
478 .It
479 .Va WITHOUT_LLVM_COV
480 .It
481 .Va WITHOUT_TESTS
482 .It
483 .Va WITHOUT_TESTS_SUPPORT
484 .El
485 .It Va WITH_CXX
486 Set to build
487 .Xr c++ 1
488 and related libraries.
489 .Pp
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
496 Set to not build
497 .Xr dialog 1 ,
498 .Xr dialog 3 ,
499 .Xr dpv 1 ,
500 and
501 .Xr dpv 3 .
502 When set, it enforces these options:
503 .Pp
504 .Bl -item -compact
505 .It
506 .Va WITHOUT_BSDINSTALL
507 .El
508 .It Va WITHOUT_DICT
509 Set to not build the Webster dictionary files.
510 .It Va WITH_DIRDEPS_BUILD
511 This is an experimental build system.
512 For details see
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
517 .Va DIRDEPS
518 stored in
519 Makefile.depend files found in each directory.
520 .Pp
521 The build can be started from anywhere, and behaves the same.
522 The initial instance of
523 .Xr make 1
524 recursively reads
525 .Va DIRDEPS
526 from
527 .Pa Makefile.depend ,
528 computing a graph of tree dependencies from the current origin.
529 Setting
530 .Va NO_DIRDEPS
531 skips checking dirdep dependencies and will only build in the current
532 and child directories.
533 .Va NO_DIRDEPS_BELOW
534 skips building any dirdeps and only build the current directory.
535 .Pp
536 This also utilizes the
537 .Va WITH_META_MODE
538 logic for incremental builds.
539 .Pp
540 The build hides commands executed unless
541 .Va NO_SILENT
542 is defined.
543 .Pp
544 Note that there is currently no mass install feature for this.
545 .Pp
546 When set, it enforces these options:
547 .Pp
548 .Bl -item -compact
549 .It
550 .Va WITH_INSTALL_AS_USER
551 .El
552 .Pp
553 When set, these options are also in effect:
554 .Pp
555 .Bl -inset -compact
556 .It Va WITH_META_MODE
557 (unless
558 .Va WITHOUT_META_MODE
559 is set explicitly)
560 .It Va WITH_STAGING
561 (unless
562 .Va WITHOUT_STAGING
563 is set explicitly)
564 .It Va WITH_STAGING_MAN
565 (unless
566 .Va WITHOUT_STAGING_MAN
567 is set explicitly)
568 .It Va WITH_STAGING_PROG
569 (unless
570 .Va WITHOUT_STAGING_PROG
571 is set explicitly)
572 .It Va WITH_SYSROOT
573 (unless
574 .Va WITHOUT_SYSROOT
575 is set explicitly)
576 .El
577 .Pp
578 This must be set in the environment, make command line, or
579 .Pa /etc/src-env.conf ,
580 not
581 .Pa /etc/src.conf .
582 .It Va WITH_DIRDEPS_CACHE
583 Cache result of dirdeps.mk which can save significant time
584 for subsequent builds.
585 Depends on
586 .Va WITH_DIRDEPS_BUILD .
587 .Pp
588 This must be set in the environment, make command line, or
589 .Pa /etc/src-env.conf ,
590 not
591 .Pa /etc/src.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
604 .Pa /bin
605 and
606 .Pa /sbin
607 dynamically.
608 .It Va WITHOUT_ED_CRYPTO
609 Set to build
610 .Xr ed 1
611 without support for encryption/decryption.
612 .It Va WITHOUT_EE
613 Set to not build and install
614 .Xr edit 1 ,
615 .Xr ee 1 ,
616 and related programs.
617 .It Va WITHOUT_EFI
618 Set not to build
619 .Xr efivar 3
620 and
621 .Xr efivar 8 .
622 .Pp
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.
625 .It Va WITH_EFI
626 Set to build
627 .Xr efivar 3
628 and
629 .Xr efivar 8 .
630 .Pp
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.
637 .Bf -symbolic
638 An alternate bootstrap tool chain must be provided.
639 .Ef
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.
645 .It Va WITHOUT_FDT
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.
648 .It Va WITHOUT_FILE
649 Set to not build
650 .Xr file 1
651 and related programs.
652 .It Va WITHOUT_FINGER
653 Set to not build or install
654 .Xr finger 1
655 and
656 .Xr fingerd 8 .
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
664 Set to not enable
665 .Fl fformat-extensions
666 when compiling the kernel.
667 Also disables all format checking.
668 .It Va WITHOUT_FORTH
669 Set to build bootloaders without Forth support.
670 .It Va WITHOUT_FP_LIBC
671 Set to build
672 .Nm libc
673 without floating-point support.
674 .It Va WITHOUT_FREEBSD_UPDATE
675 Set to not build
676 .Xr freebsd-update 8 .
677 .It Va WITHOUT_FTP
678 Set to not build or install
679 .Xr ftp 1
680 and
681 .Xr ftpd 8 .
682 .It Va WITHOUT_GAMES
683 Set to not build games.
684 .It Va WITHOUT_GCC
685 Set to not build and install gcc and g++ as part of the normal build process.
686 .Pp
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.
689 .It Va WITH_GCC
690 Set to build and install gcc and g++.
691 .Pp
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
698 XCC.
699 .Pp
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.
704 .Pp
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.
707 .It Va WITHOUT_GCOV
708 Set to not build the
709 .Xr gcov 1
710 tool.
711 .It Va WITHOUT_GDB
712 Set to not build
713 .Xr gdb 1 .
714 .Pp
715 This is a default setting on
716 arm64/aarch64, riscv/riscv64 and riscv/riscv64sf.
717 .It Va WITH_GDB
718 Set to build
719 .Xr gdb 1 .
720 .Pp
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
724 Set to install
725 .Xr gdb 1
726 into
727 .Pa /usr/bin .
728 .Pp
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
732 Set to install
733 .Xr gdb 1
734 into
735 .Pa /usr/libexec .
736 This permits
737 .Xr gdb 1
738 to be used as a fallback for
739 .Xr crashinfo 8
740 if a newer version is not installed.
741 .Pp
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.
747 .Pp
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.
750 .It Va WITH_GNUCXX
751 Build the GNU C++ stack (g++, libstdc++).
752 This is the default on platforms where gcc is the system compiler.
753 .Pp
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
757 Set to not build GNU
758 .Xr diff 1
759 and
760 .Xr diff3 1 .
761 .It Va WITHOUT_GNU_GREP
762 Set to not build GNU
763 .Xr grep 1 .
764 .It Va WITH_GNU_GREP_COMPAT
765 Set this option to include GNU extensions in
766 .Xr bsdgrep 1
767 by linking against libgnuregex.
768 .It Va WITHOUT_GPIO
769 Set to not build
770 .Xr gpioctl 8
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.
775 .Pp
776 This is a default setting on
777 amd64/amd64, arm/arm, arm/armeb, arm/armv6, arm/armv7, arm64/aarch64 and i386/i386.
778 .It Va WITH_GPL_DTC
779 Set to build the GPL'd version of the device tree compiler from elinux.org,
780 instead of the BSD licensed one.
781 .Pp
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.
786 .It Va WITHOUT_HAST
787 Set to not build
788 .Xr hastd 8
789 and related utilities.
790 .It Va WITH_HESIOD
791 Set to build Hesiod support.
792 .It Va WITHOUT_HTML
793 Set to not build HTML docs.
794 .It Va WITHOUT_HYPERV
795 Set to not build or install HyperV utilities.
796 .It Va WITHOUT_ICONV
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
801 .Va NO_INCS .
802 .Bf -symbolic
803 The option does not work for build targets.
804 .Ef
805 .It Va WITHOUT_INET
806 Set to not build programs and libraries related to IPv4 networking.
807 When set, it enforces these options:
808 .Pp
809 .Bl -item -compact
810 .It
811 .Va WITHOUT_INET_SUPPORT
812 .El
813 .It Va WITHOUT_INET6
814 Set to not build
815 programs and libraries related to IPv6 networking.
816 When set, it enforces these options:
817 .Pp
818 .Bl -item -compact
819 .It
820 .Va WITHOUT_INET6_SUPPORT
821 .El
822 .It Va WITHOUT_INET6_SUPPORT
823 Set to build libraries, programs, and kernel modules without IPv6 support.
824 .It Va WITHOUT_INETD
825 Set to not build
826 .Xr inetd 8 .
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
832 .Xr nanobsd 8
833 image.
834 .Bf -symbolic
835 The option does not work for build targets.
836 .Ef
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
840 the
841 .Xr make 1
842 command.
843 The user still must set the
844 .Va DESTDIR
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.
848 .It Va WITHOUT_IPFW
849 Set to not build IPFW tools.
850 .It Va WITHOUT_IPSEC_SUPPORT
851 Set to not build the kernel with
852 .Xr ipsec 4
853 support.
854 This option is needed for
855 .Xr ipsec 4
856 and
857 .Xr tcpmd5 4 .
858 .It Va WITHOUT_ISCSI
859 Set to not build
860 .Xr iscid 8
861 and related utilities.
862 .It Va WITHOUT_JAIL
863 Set to not build tools for the support of jails; e.g.,
864 .Xr jail 8 .
865 .It Va WITHOUT_KDUMP
866 Set to not build
867 .Xr kdump 1
868 and
869 .Xr truss 1 .
870 .It Va WITHOUT_KERBEROS
871 Set this to not build Kerberos 5 (KTH Heimdal).
872 When set, it enforces these options:
873 .Pp
874 .Bl -item -compact
875 .It
876 .Va WITHOUT_KERBEROS_SUPPORT
877 .El
878 .Pp
879 When set, these options are also in effect:
880 .Pp
881 .Bl -inset -compact
882 .It Va WITHOUT_GSSAPI
883 (unless
884 .Va WITH_GSSAPI
885 is set explicitly)
886 .El
887 .It Va WITHOUT_KERBEROS_SUPPORT
888 Set to build some programs without Kerberos support, like
889 .Xr ssh 1 ,
890 .Xr telnet 1 ,
891 .Xr sshd 8 ,
892 and
893 .Xr telnetd 8 .
894 .It Va WITH_KERNEL_RETPOLINE
895 Set to enable the "retpoline" mitigation for CVE-2017-5715 in the kernel
896 build.
897 .It Va WITHOUT_KERNEL_SYMBOLS
898 Set to not install kernel symbol files.
899 .Bf -symbolic
900 This option is recommended for those people who have small root partitions.
901 .Ef
902 .It Va WITHOUT_KVM
903 Set to not build the
904 .Nm libkvm
905 library as a part of the base system.
906 .Bf -symbolic
907 The option has no effect yet.
908 .Ef
909 When set, it enforces these options:
910 .Pp
911 .Bl -item -compact
912 .It
913 .Va WITHOUT_KVM_SUPPORT
914 .El
915 .It Va WITHOUT_KVM_SUPPORT
916 Set to build some programs without optional
917 .Nm libkvm
918 support.
919 .It Va WITHOUT_LDNS
920 Setting this variable will prevent the LDNS library from being built.
921 When set, it enforces these options:
922 .Pp
923 .Bl -item -compact
924 .It
925 .Va WITHOUT_LDNS_UTILS
926 .It
927 .Va WITHOUT_UNBOUND
928 .El
929 .It Va WITHOUT_LDNS_UTILS
930 Setting this variable will prevent building the LDNS utilities
931 .Xr drill 1
932 and
933 .Xr host 1 .
934 .It Va WITHOUT_LEGACY_CONSOLE
935 Set to not build programs that support a legacy PC console; e.g.,
936 .Xr kbdcontrol 1
937 and
938 .Xr vidcontrol 1 .
939 .It Va WITHOUT_LIB32
940 On 64-bit platforms, set to not build 32-bit library set and a
941 .Nm ld-elf32.so.1
942 runtime linker.
943 .It Va WITHOUT_LIBCPLUSPLUS
944 Set to avoid building libcxxrt and libc++.
945 .It Va WITHOUT_LIBPTHREAD
946 Set to not build the
947 .Nm libpthread
948 providing library,
949 .Nm libthr .
950 When set, it enforces these options:
951 .Pp
952 .Bl -item -compact
953 .It
954 .Va WITHOUT_LIBTHR
955 .El
956 .It Va WITH_LIBSOFT
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
960 Set to not build the
961 .Nm libthr
962 (1:1 threading)
963 library.
964 .It Va WITHOUT_LLD
965 Set to not build LLVM's lld linker.
966 .Pp
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.
969 .It Va WITH_LLD
970 Set to build LLVM's lld linker.
971 .Pp
972 This is a default setting on
973 amd64/amd64, arm/arm, arm/armeb, arm/armv6, arm/armv7, arm64/aarch64 and i386/i386.
974 .It Va WITHOUT_LLDB
975 Set to not build the LLDB debugger.
976 .Pp
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.
979 .It Va WITH_LLDB
980 Set to build the LLDB debugger.
981 .Pp
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
986 the build.
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.
989 .Pp
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.
994 .Pp
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.
999 .Pp
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.
1004 .Pp
1005 This is a default setting on
1006 arm64/aarch64.
1007 .It Va WITHOUT_LLVM_COV
1008 Set to not build the
1009 .Xr llvm-cov 1
1010 tool.
1011 .Pp
1012 This is a default setting on
1013 riscv/riscv64, riscv/riscv64sf and sparc64/sparc64.
1014 .It Va WITH_LLVM_COV
1015 Set to build the
1016 .Xr llvm-cov 1
1017 tool.
1018 .Pp
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).
1023 .Pp
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).
1028 .Pp
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.
1036 .Pp
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.
1043 .Pp
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.
1048 .Pp
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.
1053 .Pp
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
1057 Set to build ubldr.
1058 .Pp
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
1063 .Xr locale 1 .
1064 .It Va WITHOUT_LOCATE
1065 Set to not build
1066 .Xr locate 1
1067 and related programs.
1068 .It Va WITHOUT_LPR
1069 Set to not build
1070 .Xr lpr 1
1071 and related programs.
1072 .It Va WITHOUT_LS_COLORS
1073 Set to build
1074 .Xr ls 1
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.
1078 .It Va WITHOUT_MAIL
1079 Set to not build any mail support (MUA or MTA).
1080 When set, it enforces these options:
1081 .Pp
1082 .Bl -item -compact
1083 .It
1084 .Va WITHOUT_DMAGENT
1085 .It
1086 .Va WITHOUT_MAILWRAPPER
1087 .It
1088 .Va WITHOUT_SENDMAIL
1089 .El
1090 .It Va WITHOUT_MAILWRAPPER
1091 Set to not build the
1092 .Xr mailwrapper 8
1093 MTA selector.
1094 .It Va WITHOUT_MAKE
1095 Set to not install
1096 .Xr make 1
1097 and related support files.
1098 .It Va WITHOUT_MAKE_CHECK_USE_SANDBOX
1099 Set to not execute
1100 .Dq Li "make check"
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.
1105 See
1106 .Xr tests 7
1107 for more details.
1108 .It Va WITHOUT_MAN
1109 Set to not build manual pages.
1110 When set, these options are also in effect:
1111 .Pp
1112 .Bl -inset -compact
1113 .It Va WITHOUT_MAN_UTILS
1114 (unless
1115 .Va WITH_MAN_UTILS
1116 is set explicitly)
1117 .El
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,
1123 .Xr apropos 1 ,
1124 .Xr makewhatis 1 ,
1125 .Xr man 1 ,
1126 .Xr whatis 1 ,
1127 .Xr manctl 8 ,
1128 and related support files.
1129 .It Va WITH_META_MODE
1130 Create
1131 .Xr make 1
1132 meta files when building, which can provide a reliable incremental build when
1133 using
1134 .Xr filemon 4 .
1135 The meta file is created in OBJDIR as
1136 .Pa target.meta .
1137 These meta files track the command that was executed, its output, and the
1138 current directory.
1139 The
1140 .Xr filemon 4
1141 module is required unless
1142 .Va NO_FILEMON
1143 is defined.
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
1149 .It
1150 The command to execute changes.
1151 .It
1152 The current working directory changes.
1153 .It
1154 The target's meta file is missing.
1155 .It
1156 The target's meta file is missing filemon data when filemon is loaded
1157 and a previous run did not have it loaded.
1158 .It
1159 [requires
1160 .Xr filemon 4 ]
1161 Files read, executed or linked to are newer than the target.
1162 .It
1163 [requires
1164 .Xr filemon 4 ]
1165 Files read, written, executed or linked are missing.
1166 .El
1167 The meta files can also be useful for debugging.
1168 .Pp
1169 The build hides commands that are executed unless
1170 .Va NO_SILENT
1171 is defined.
1172 Errors cause
1173 .Xr make 1
1174 to show some of its environment for further debugging.
1175 .Pp
1176 The build operates as it normally would otherwise.
1177 This option originally invoked a different build system but that was renamed
1178 to
1179 .Va WITH_DIRDEPS_BUILD .
1180 .Pp
1181 This must be set in the environment, make command line, or
1182 .Pa /etc/src-env.conf ,
1183 not
1184 .Pa /etc/src.conf .
1185 .It Va WITH_NAND
1186 Set to build the NAND Flash components.
1187 .It Va WITHOUT_NDIS
1188 Set to not build programs and libraries
1189 related to NDIS emulation support.
1190 .It Va WITHOUT_NETCAT
1191 Set to not build
1192 .Xr nc 1
1193 utility.
1194 .It Va WITHOUT_NETGRAPH
1195 Set to not build applications to support
1196 .Xr netgraph 4 .
1197 When set, it enforces these options:
1198 .Pp
1199 .Bl -item -compact
1200 .It
1201 .Va WITHOUT_ATM
1202 .It
1203 .Va WITHOUT_BLUETOOTH
1204 .It
1205 .Va WITHOUT_NETGRAPH_SUPPORT
1206 .El
1207 .It Va WITHOUT_NETGRAPH_SUPPORT
1208 Set to build libraries, programs, and kernel modules without netgraph support.
1209 .It Va WITHOUT_NIS
1210 Set to not build
1211 .Xr NIS 8
1212 support and related programs.
1213 If set, you might need to adopt your
1214 .Xr nsswitch.conf 5
1215 and remove
1216 .Sq nis
1217 entries.
1218 .It Va WITHOUT_NLS
1219 Set to not build NLS catalogs.
1220 When set, it enforces these options:
1221 .Pp
1222 .Bl -item -compact
1223 .It
1224 .Va WITHOUT_NLS_CATALOGS
1225 .El
1226 .It Va WITHOUT_NLS_CATALOGS
1227 Set to not build NLS catalog support for
1228 .Xr csh 1 .
1229 .It Va WITHOUT_NS_CACHING
1230 Set to disable name caching in the
1231 .Pa nsswitch
1232 subsystem.
1233 The generic caching daemon,
1234 .Xr nscd 8 ,
1235 will not be built either if this option is set.
1236 .It Va WITHOUT_NTP
1237 Set to not build
1238 .Xr ntpd 8
1239 and related programs.
1240 .It Va WITH_OFED
1241 Set to build the
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:
1251 .Pp
1252 .Bl -item -compact
1253 .It
1254 .Va WITHOUT_KERBEROS
1255 .It
1256 .Va WITHOUT_KERBEROS_SUPPORT
1257 .It
1258 .Va WITHOUT_OPENSSH
1259 .El
1260 .Pp
1261 When set, these options are also in effect:
1262 .Pp
1263 .Bl -inset -compact
1264 .It Va WITHOUT_GSSAPI
1265 (unless
1266 .Va WITH_GSSAPI
1267 is set explicitly)
1268 .El
1269 .It Va WITHOUT_PAM
1270 Set to not build PAM library and modules.
1271 .Bf -symbolic
1272 This option is deprecated and does nothing.
1273 .Ef
1274 When set, it enforces these options:
1275 .Pp
1276 .Bl -item -compact
1277 .It
1278 .Va WITHOUT_PAM_SUPPORT
1279 .El
1280 .It Va WITHOUT_PAM_SUPPORT
1281 Set to build some programs without PAM support, particularly
1282 .Xr ftpd 8
1283 and
1284 .Xr ppp 8 .
1285 .It Va WITHOUT_PC_SYSINSTALL
1286 Set to not build
1287 .Xr pc-sysinstall 8
1288 and related programs.
1289 .It Va WITHOUT_PF
1290 Set to not build PF firewall package.
1291 When set, it enforces these options:
1292 .Pp
1293 .Bl -item -compact
1294 .It
1295 .Va WITHOUT_AUTHPF
1296 .El
1297 .It Va WITHOUT_PKGBOOTSTRAP
1298 Set to not build
1299 .Xr pkg 7
1300 bootstrap tool.
1301 .It Va WITHOUT_PMC
1302 Set to not build
1303 .Xr pmccontrol 8
1304 and related programs.
1305 .It Va WITHOUT_PORTSNAP
1306 Set to not build or install
1307 .Xr portsnap 8
1308 and related files.
1309 .It Va WITHOUT_PPP
1310 Set to not build
1311 .Xr ppp 8
1312 and related programs.
1313 .It Va WITHOUT_PROFILE
1314 Set to not build profiled libraries for use with
1315 .Xr gprof 8 .
1316 .Pp
1317 This is a default setting on
1318 mips/mips64el, mips/mips64, mips/mips64elhf, mips/mips64hf, riscv/riscv64 and riscv/riscv64sf.
1319 .It Va WITH_PROFILE
1320 Set to build profiled libraries for use with
1321 .Xr gprof 8 .
1322 .Pp
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
1326 Set to not build
1327 .Xr quota 1
1328 and related programs.
1329 .It Va WITHOUT_RADIUS_SUPPORT
1330 Set to not build radius support into various applications, like
1331 .Xr pam_radius 8
1332 and
1333 .Xr ppp 8 .
1334 .It Va WITH_RATELIMIT
1335 Set to build the system with rate limit support.
1336 .Pp
1337 This makes
1338 .Dv SO_MAX_PACING_RATE
1339 effective in
1340 .Xr getsockopt 2 ,
1341 and
1342 .Ar txrlimit
1343 support in
1344 .Xr ifconfig 8 ,
1345 by proxy.
1346 .It Va WITHOUT_RBOOTD
1347 Set to not build or install
1348 .Xr rbootd 8 .
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
1354 Set to not build
1355 .Xr rescue 8 .
1356 .It Va WITHOUT_ROUTED
1357 Set to not build
1358 .Xr routed 8
1359 utility.
1360 .It Va WITH_RPCBIND_WARMSTART_SUPPORT
1361 Set to build
1362 .Xr rpcbind 8
1363 with warmstart support.
1364 .It Va WITHOUT_SENDMAIL
1365 Set to not build
1366 .Xr sendmail 8
1367 and related programs.
1368 .It Va WITHOUT_SETUID_LOGIN
1369 Set this to disable the installation of
1370 .Xr login 1
1371 as a set-user-ID root program.
1372 .It Va WITHOUT_SHAREDOCS
1373 Set to not build the
1374 .Bx 4.4
1375 legacy docs.
1376 .It Va WITH_SHARED_TOOLCHAIN
1377 Set to build the toolchain binaries shared.
1378 The set includes
1379 .Xr cc 1 ,
1380 .Xr make 1
1381 and necessary utilities like assembler, linker and library archive manager.
1382 .It Va WITH_SORT_THREADS
1383 Set to enable threads in
1384 .Xr sort 1 .
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:
1388 .Pp
1389 .Bl -item -compact
1390 .It
1391 .Va WITHOUT_SOURCELESS_HOST
1392 .It
1393 .Va WITHOUT_SOURCELESS_UCODE
1394 .El
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.
1399 .It Va WITHOUT_SSP
1400 Set to not build world with propolice stack smashing protection.
1401 .Pp
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.
1404 .It Va WITH_SSP
1405 Set to build world with propolice stack smashing protection.
1406 .Pp
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.
1409 .It Va WITH_STAGING
1410 Enable staging of files to a stage tree.
1411 This can be best thought of as auto-install to
1412 .Va DESTDIR
1413 with some extra meta data to ensure dependencies can be tracked.
1414 Depends on
1415 .Va WITH_DIRDEPS_BUILD .
1416 When set, these options are also in effect:
1417 .Pp
1418 .Bl -inset -compact
1419 .It Va WITH_STAGING_MAN
1420 (unless
1421 .Va WITHOUT_STAGING_MAN
1422 is set explicitly)
1423 .It Va WITH_STAGING_PROG
1424 (unless
1425 .Va WITHOUT_STAGING_PROG
1426 is set explicitly)
1427 .El
1428 .Pp
1429 This must be set in the environment, make command line, or
1430 .Pa /etc/src-env.conf ,
1431 not
1432 .Pa /etc/src.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.
1439 .It Va WITH_SVN
1440 Set to install
1441 .Xr svnlite 1
1442 as
1443 .Xr svn 1 .
1444 .It Va WITHOUT_SVNLITE
1445 Set to not build
1446 .Xr svnlite 1
1447 and related programs.
1448 .It Va WITHOUT_SYMVER
1449 Set to disable symbol versioning when building shared libraries.
1450 .It Va WITHOUT_SYSCONS
1451 Set to not build
1452 .Xr syscons 4
1453 support files such as keyboard maps, fonts, and screen output maps.
1454 .It Va WITH_SYSROOT
1455 Enable use of sysroot during build.
1456 Depends on
1457 .Va WITH_DIRDEPS_BUILD .
1458 .Pp
1459 This must be set in the environment, make command line, or
1460 .Pa /etc/src-env.conf ,
1461 not
1462 .Pa /etc/src.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.
1470 The
1471 .Va WITHOUT_CLANG
1472 and
1473 .Va WITHOUT_GCC
1474 options control those.
1475 .It Va WITHOUT_TALK
1476 Set to not build or install
1477 .Xr talk 1
1478 and
1479 .Xr talkd 8 .
1480 .It Va WITHOUT_TCP_WRAPPERS
1481 Set to not build or install
1482 .Xr tcpd 8 ,
1483 and related utilities.
1484 .It Va WITHOUT_TCSH
1485 Set to not build and install
1486 .Pa /bin/csh
1487 (which is
1488 .Xr tcsh 1 ) .
1489 .It Va WITHOUT_TELNET
1490 Set to not build
1491 .Xr telnet 1
1492 and related programs.
1493 .It Va WITHOUT_TESTS
1494 Set to not build nor install the
1495 .Fx
1496 Test Suite in
1497 .Pa /usr/tests/ .
1498 See
1499 .Xr tests 7
1500 for more details.
1501 This also disables the build of all test-related dependencies, including ATF.
1502 .Pp
1503 This is a default setting on
1504 riscv/riscv64 and riscv/riscv64sf.
1505 When set, it enforces these options:
1506 .Pp
1507 .Bl -item -compact
1508 .It
1509 .Va WITHOUT_DTRACE_TESTS
1510 .It
1511 .Va WITHOUT_TESTS_SUPPORT
1512 .El
1513 .It Va WITHOUT_TESTS_SUPPORT
1514 Set to disables the build of all test-related dependencies, including ATF.
1515 .Pp
1516 This is a default setting on
1517 riscv/riscv64 and riscv/riscv64sf.
1518 .It Va WITHOUT_TEXTPROC
1519 Set to not build
1520 programs used for text processing.
1521 .It Va WITHOUT_TFTP
1522 Set to not build or install
1523 .Xr tftp 1
1524 and
1525 .Xr tftpd 8 .
1526 .It Va WITHOUT_TIMED
1527 Set to not build or install
1528 .Xr timed 8 .
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:
1534 .Pp
1535 .Bl -item -compact
1536 .It
1537 .Va WITHOUT_BINUTILS
1538 .It
1539 .Va WITHOUT_CLANG
1540 .It
1541 .Va WITHOUT_CLANG_EXTRAS
1542 .It
1543 .Va WITHOUT_CLANG_FULL
1544 .It
1545 .Va WITHOUT_GCC
1546 .It
1547 .Va WITHOUT_GDB
1548 .It
1549 .Va WITHOUT_INCLUDES
1550 .It
1551 .Va WITHOUT_LLD
1552 .It
1553 .Va WITHOUT_LLDB
1554 .It
1555 .Va WITHOUT_LLVM_COV
1556 .El
1557 .It Va WITHOUT_UNBOUND
1558 Set to not build
1559 .Xr unbound 8
1560 and related programs.
1561 .It Va WITHOUT_UNIFIED_OBJDIR
1562 Set to use the historical object directory format for
1563 .Xr build 7
1564 targets.
1565 For native-builds and builds done directly in sub-directories the format of
1566 .Pa ${MAKEOBJDIRPREFIX}/${.CURDIR}
1567 is used,
1568 while for cross-builds
1569 .Pa ${MAKEOBJDIRPREFIX}/${TARGET}.${TARGET_ARCH}/${.CURDIR}
1570 is used.
1571 .Pp
1572 This option is transitional and will be removed before the 12.0 release,
1573 at which time
1574 .va WITH_UNIFIED_OBJDIR
1575 will be enabled permanently.
1576 .Pp
1577 This must be set in the environment, make command line, or
1578 .Pa /etc/src-env.conf ,
1579 not
1580 .Pa /etc/src.conf .
1581 .It Va WITHOUT_USB
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
1587 .Xr last 1 ,
1588 .Xr users 1 ,
1589 .Xr who 1 ,
1590 .Xr ac 8 ,
1591 .Xr lastlogin 8
1592 and
1593 .Xr utx 8 .
1594 .It Va WITHOUT_VI
1595 Set to not build and install vi, view, ex and related programs.
1596 .It Va WITHOUT_VT
1597 Set to not build
1598 .Xr vt 4
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
1604 original developer.
1605 .It Va WITHOUT_WIRELESS
1606 Set to not build programs used for 802.11 wireless networks; especially
1607 .Xr wpa_supplicant 8
1608 and
1609 .Xr hostapd 8 .
1610 When set, it enforces these options:
1611 .Pp
1612 .Bl -item -compact
1613 .It
1614 .Va WITHOUT_WIRELESS_SUPPORT
1615 .El
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
1620 Build
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).
1625 .It Va WITHOUT_ZFS
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:
1630 .Pp
1631 .Bl -item -compact
1632 .It
1633 .Va WITHOUT_ZONEINFO_LEAPSECONDS_SUPPORT
1634 .It
1635 .Va WITHOUT_ZONEINFO_OLD_TIMEZONES_SUPPORT
1636 .El
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
1641 database.
1642 .El
1643 .Sh FILES
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
1648 .El
1649 .Sh SEE ALSO
1650 .Xr make 1 ,
1651 .Xr make.conf 5 ,
1652 .Xr build 7 ,
1653 .Xr ports 7
1654 .Sh HISTORY
1655 The
1656 .Nm
1657 file appeared in
1658 .Fx 7.0 .
1659 .Sh AUTHORS
1660 This manual page was autogenerated by
1661 .An tools/build/options/makeman .