share/man/man5/src.conf.5

   1 .\" DO NOT EDIT-- this file is generated by tools/build/options/makeman.
   2 .\" $FreeBSD$
   3 .Dd May 3, 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 WITHOUT_BSNMP
 223 Set to not build or install
 224 .Xr bsnmpd 1
 225 and related libraries and data files.
 226 .It Va WITHOUT_BZIP2
 227 Set to not build contributed bzip2 software as a part of the base system.
 228 .Bf -symbolic
 229 The option has no effect yet.
 230 .Ef
 231 When set, it enforces these options:
 232 .Pp
 233 .Bl -item -compact
 234 .It
 235 .Va WITHOUT_BZIP2_SUPPORT
 236 .El
 237 .It Va WITHOUT_BZIP2_SUPPORT
 238 Set to build some programs without optional bzip2 support.
 239 .It Va WITHOUT_CALENDAR
 240 Set to not build
 241 .Xr calendar 1 .
 242 .It Va WITHOUT_CAPSICUM
 243 Set to not build Capsicum support into system programs.
 244 When set, it enforces these options:
 245 .Pp
 246 .Bl -item -compact
 247 .It
 248 .Va WITHOUT_CASPER
 249 .El
 250 .It Va WITHOUT_CASPER
 251 Set to not build Casper program and related libraries.
 252 .It Va WITH_CCACHE_BUILD
 253 Set to use
 254 .Xr ccache 1
 255 for the build.
 256 No configuration is required except to install the
 257 .Sy devel/ccache
 258 package.
 259 When using with
 260 .Xr distcc 1 ,
 261 set
 262 .Sy CCACHE_PREFIX=/usr/local/bin/distcc .
 263 The default cache directory of
 264 .Pa $HOME/.ccache
 265 will be used, which can be overridden by setting
 266 .Sy CCACHE_DIR .
 267 The
 268 .Sy CCACHE_COMPILERCHECK
 269 option defaults to
 270 .Sy content
 271 when using the in-tree bootstrap compiler,
 272 and
 273 .Sy mtime
 274 when using an external compiler.
 275 The
 276 .Sy CCACHE_CPP2
 277 option is used for Clang but not GCC.
 278 .Pp
 279 Sharing a cache between multiple work directories requires using a layout
 280 similar to
 281 .Pa /some/prefix/src
 282 .Pa /some/prefix/obj
 283 and an environment such as:
 284 .Bd -literal -offset indent
 285 CCACHE_BASEDIR='${SRCTOP:H}' MAKEOBJDIRPREFIX='${SRCTOP:H}/obj'
 286 .Ed
 287 .Pp
 288 See
 289 .Xr ccache 1
 290 for more configuration options.
 291 .It Va WITHOUT_CCD
 292 Set to not build
 293 .Xr geom_ccd 4
 294 and related utilities.
 295 .It Va WITHOUT_CDDL
 296 Set to not build code licensed under Sun's CDDL.
 297 When set, it enforces these options:
 298 .Pp
 299 .Bl -item -compact
 300 .It
 301 .Va WITHOUT_CTF
 302 .It
 303 .Va WITHOUT_ZFS
 304 .El
 305 .It Va WITHOUT_CLANG
 306 Set to not build the Clang C/C++ compiler during the regular phase of the build.
 307 .Pp
 308 This is a default setting on
 309 riscv/riscv64, riscv/riscv64sf and sparc64/sparc64.
 310 When set, it enforces these options:
 311 .Pp
 312 .Bl -item -compact
 313 .It
 314 .Va WITHOUT_CLANG_EXTRAS
 315 .It
 316 .Va WITHOUT_CLANG_FULL
 317 .It
 318 .Va WITHOUT_LLVM_COV
 319 .El
 320 .It Va WITH_CLANG
 321 Set to build the Clang C/C++ compiler during the normal phase of the build.
 322 .Pp
 323 This is a default setting on
 324 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.
 325 .It Va WITHOUT_CLANG_BOOTSTRAP
 326 Set to not build the Clang C/C++ compiler during the bootstrap phase of
 327 the build.
 328 To be able to build the system, either gcc or clang bootstrap must be
 329 enabled unless an alternate compiler is provided via XCC.
 330 .Pp
 331 This is a default setting on
 332 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.
 333 .It Va WITH_CLANG_BOOTSTRAP
 334 Set to build the Clang C/C++ compiler during the bootstrap phase of the build.
 335 .Pp
 336 This is a default setting on
 337 amd64/amd64, arm/arm, arm/armeb, arm/armv6, arm/armv7, arm64/aarch64 and i386/i386.
 338 .It Va WITH_CLANG_EXTRAS
 339 Set to build additional clang and llvm tools, such as bugpoint.
 340 .It Va WITHOUT_CLANG_FULL
 341 Set to avoid building the ARCMigrate, Rewriter and StaticAnalyzer components of
 342 the Clang C/C++ compiler.
 343 .Pp
 344 This is a default setting on
 345 riscv/riscv64, riscv/riscv64sf and sparc64/sparc64.
 346 .It Va WITH_CLANG_FULL
 347 Set to build the ARCMigrate, Rewriter and StaticAnalyzer components of the
 348 Clang C/C++ compiler.
 349 .Pp
 350 This is a default setting on
 351 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.
 352 .It Va WITHOUT_CLANG_IS_CC
 353 Set to install the GCC compiler as
 354 .Pa /usr/bin/cc ,
 355 .Pa /usr/bin/c++
 356 and
 357 .Pa /usr/bin/cpp .
 358 .Pp
 359 This is a default setting on
 360 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.
 361 .It Va WITH_CLANG_IS_CC
 362 Set to install the Clang C/C++ compiler as
 363 .Pa /usr/bin/cc ,
 364 .Pa /usr/bin/c++
 365 and
 366 .Pa /usr/bin/cpp .
 367 .Pp
 368 This is a default setting on
 369 amd64/amd64, arm/arm, arm/armeb, arm/armv6, arm/armv7, arm64/aarch64 and i386/i386.
 370 .It Va WITHOUT_CPP
 371 Set to not build
 372 .Xr cpp 1 .
 373 .It Va WITHOUT_CROSS_COMPILER
 374 Set to not build any cross compiler in the cross-tools stage of buildworld.
 375 When compiling a different version of
 376 .Fx
 377 than what is installed on the system, provide an alternate
 378 compiler with XCC to ensure success.
 379 When compiling with an identical version of
 380 .Fx
 381 to the host, this option may be safely used.
 382 This option may also be safe when the host version of
 383 .Fx
 384 is close to the sources being built, but all bets are off if there have
 385 been any changes to the toolchain between the versions.
 386 When set, it enforces these options:
 387 .Pp
 388 .Bl -item -compact
 389 .It
 390 .Va WITHOUT_BINUTILS_BOOTSTRAP
 391 .It
 392 .Va WITHOUT_CLANG_BOOTSTRAP
 393 .It
 394 .Va WITHOUT_ELFTOOLCHAIN_BOOTSTRAP
 395 .It
 396 .Va WITHOUT_GCC_BOOTSTRAP
 397 .It
 398 .Va WITHOUT_LLD_BOOTSTRAP
 399 .El
 400 .It Va WITHOUT_CRYPT
 401 Set to not build any crypto code.
 402 When set, it enforces these options:
 403 .Pp
 404 .Bl -item -compact
 405 .It
 406 .Va WITHOUT_KERBEROS
 407 .It
 408 .Va WITHOUT_KERBEROS_SUPPORT
 409 .It
 410 .Va WITHOUT_OPENSSH
 411 .It
 412 .Va WITHOUT_OPENSSL
 413 .El
 414 .Pp
 415 When set, these options are also in effect:
 416 .Pp
 417 .Bl -inset -compact
 418 .It Va WITHOUT_GSSAPI
 419 (unless
 420 .Va WITH_GSSAPI
 421 is set explicitly)
 422 .El
 423 .It Va WITH_CTF
 424 Set to compile with CTF (Compact C Type Format) data.
 425 CTF data encapsulates a reduced form of debugging information
 426 similar to DWARF and the venerable stabs and is required for DTrace.
 427 .It Va WITHOUT_CTM
 428 Set to not build
 429 .Xr ctm 1
 430 and related utilities.
 431 .It Va WITHOUT_CUSE
 432 Set to not build CUSE-related programs and libraries.
 433 .It Va WITHOUT_CXGBETOOL
 434 Set to not build
 435 .Xr cxgbetool 8
 436 .Pp
 437 This is a default setting on
 438 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.
 439 .It Va WITH_CXGBETOOL
 440 Set to build
 441 .Xr cxgbetool 8
 442 .Pp
 443 This is a default setting on
 444 amd64/amd64, arm64/aarch64, i386/i386, powerpc/powerpc64 and sparc64/sparc64.
 445 .It Va WITHOUT_CXX
 446 Set to not build
 447 .Xr c++ 1
 448 and related libraries.
 449 It will also prevent building of
 450 .Xr gperf 1
 451 and
 452 .Xr devd 8 .
 453 .Pp
 454 This is a default setting on
 455 riscv/riscv64 and riscv/riscv64sf.
 456 When set, it enforces these options:
 457 .Pp
 458 .Bl -item -compact
 459 .It
 460 .Va WITHOUT_CLANG
 461 .It
 462 .Va WITHOUT_CLANG_EXTRAS
 463 .It
 464 .Va WITHOUT_CLANG_FULL
 465 .It
 466 .Va WITHOUT_DTRACE_TESTS
 467 .It
 468 .Va WITHOUT_GNUCXX
 469 .It
 470 .Va WITHOUT_LLVM_COV
 471 .It
 472 .Va WITHOUT_TESTS
 473 .It
 474 .Va WITHOUT_TESTS_SUPPORT
 475 .El
 476 .It Va WITH_CXX
 477 Set to build
 478 .Xr c++ 1
 479 and related libraries.
 480 .Pp
 481 This is a default setting on
 482 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.
 483 .It Va WITHOUT_DEBUG_FILES
 484 Set to avoid building or installing standalone debug files for each
 485 executable binary and shared library.
 486 .It Va WITHOUT_DIALOG
 487 Set to not build
 488 .Xr dialog 1 ,
 489 .Xr dialog 3 ,
 490 .Xr dpv 1 ,
 491 and
 492 .Xr dpv 3 .
 493 When set, it enforces these options:
 494 .Pp
 495 .Bl -item -compact
 496 .It
 497 .Va WITHOUT_BSDINSTALL
 498 .El
 499 .It Va WITHOUT_DICT
 500 Set to not build the Webster dictionary files.
 501 .It Va WITH_DIRDEPS_BUILD
 502 This is an experimental build system.
 503 For details see
 504 http://www.crufty.net/sjg/docs/freebsd-meta-mode.htm.
 505 Build commands can be seen from the top-level with:
 506 .Dl make show-valid-targets
 507 The build is driven by dirdeps.mk using
 508 .Va DIRDEPS
 509 stored in
 510 Makefile.depend files found in each directory.
 511 .Pp
 512 The build can be started from anywhere, and behaves the same.
 513 The initial instance of
 514 .Xr make 1
 515 recursively reads
 516 .Va DIRDEPS
 517 from
 518 .Pa Makefile.depend ,
 519 computing a graph of tree dependencies from the current origin.
 520 Setting
 521 .Va NO_DIRDEPS
 522 skips checking dirdep dependencies and will only build in the current
 523 and child directories.
 524 .Va NO_DIRDEPS_BELOW
 525 skips building any dirdeps and only build the current directory.
 526 .Pp
 527 This also utilizes the
 528 .Va WITH_META_MODE
 529 logic for incremental builds.
 530 .Pp
 531 The build hides commands executed unless
 532 .Va NO_SILENT
 533 is defined.
 534 .Pp
 535 Note that there is currently no mass install feature for this.
 536 .Pp
 537 When set, it enforces these options:
 538 .Pp
 539 .Bl -item -compact
 540 .It
 541 .Va WITH_INSTALL_AS_USER
 542 .El
 543 .Pp
 544 When set, these options are also in effect:
 545 .Pp
 546 .Bl -inset -compact
 547 .It Va WITH_META_MODE
 548 (unless
 549 .Va WITHOUT_META_MODE
 550 is set explicitly)
 551 .It Va WITH_STAGING
 552 (unless
 553 .Va WITHOUT_STAGING
 554 is set explicitly)
 555 .It Va WITH_STAGING_MAN
 556 (unless
 557 .Va WITHOUT_STAGING_MAN
 558 is set explicitly)
 559 .It Va WITH_STAGING_PROG
 560 (unless
 561 .Va WITHOUT_STAGING_PROG
 562 is set explicitly)
 563 .It Va WITH_SYSROOT
 564 (unless
 565 .Va WITHOUT_SYSROOT
 566 is set explicitly)
 567 .El
 568 .Pp
 569 This must be set in the environment, make command line, or
 570 .Pa /etc/src-env.conf ,
 571 not
 572 .Pa /etc/src.conf .
 573 .It Va WITH_DIRDEPS_CACHE
 574 Cache result of dirdeps.mk which can save significant time
 575 for subsequent builds.
 576 Depends on
 577 .Va WITH_DIRDEPS_BUILD .
 578 .Pp
 579 This must be set in the environment, make command line, or
 580 .Pa /etc/src-env.conf ,
 581 not
 582 .Pa /etc/src.conf .
 583 .It Va WITHOUT_DMAGENT
 584 Set to not build dma Mail Transport Agent.
 585 .It Va WITHOUT_DOCCOMPRESS
 586 Set to not install compressed system documentation.
 587 Only the uncompressed version will be installed.
 588 .It Va WITH_DTRACE_TESTS
 589 Set to build and install the DTrace test suite in
 590 .Pa /usr/tests/cddl/usr.sbin/dtrace .
 591 This test suite is considered experimental on architectures other than
 592 amd64/amd64 and running it may cause system instability.
 593 .It Va WITHOUT_DYNAMICROOT
 594 Set this if you do not want to link
 595 .Pa /bin
 596 and
 597 .Pa /sbin
 598 dynamically.
 599 .It Va WITHOUT_ED_CRYPTO
 600 Set to build
 601 .Xr ed 1
 602 without support for encryption/decryption.
 603 .It Va WITHOUT_EE
 604 Set to not build and install
 605 .Xr edit 1 ,
 606 .Xr ee 1 ,
 607 and related programs.
 608 .It Va WITHOUT_EFI
 609 Set not to build
 610 .Xr efivar 3
 611 and
 612 .Xr efivar 8 .
 613 .Pp
 614 This is a default setting on
 615 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.
 616 .It Va WITH_EFI
 617 Set to build
 618 .Xr efivar 3
 619 and
 620 .Xr efivar 8 .
 621 .Pp
 622 This is a default setting on
 623 amd64/amd64, arm/arm, arm/armeb, arm/armv6, arm/armv7, arm64/aarch64 and i386/i386.
 624 .It Va WITHOUT_ELFTOOLCHAIN_BOOTSTRAP
 625 Set to not build ELF Tool Chain tools
 626 (addr2line, nm, size, strings and strip)
 627 as part of the bootstrap process.
 628 .Bf -symbolic
 629 An alternate bootstrap tool chain must be provided.
 630 .Ef
 631 .It Va WITHOUT_EXAMPLES
 632 Set to avoid installing examples to
 633 .Pa /usr/share/examples/ .
 634 .It Va WITH_EXTRA_TCP_STACKS
 635 Set to build extra TCP stack modules.
 636 .It Va WITHOUT_FDT
 637 Set to not build Flattened Device Tree support as part of the base system.
 638 This includes the device tree compiler (dtc) and libfdt support library.
 639 .It Va WITHOUT_FILE
 640 Set to not build
 641 .Xr file 1
 642 and related programs.
 643 .It Va WITHOUT_FINGER
 644 Set to not build or install
 645 .Xr finger 1
 646 and
 647 .Xr fingerd 8 .
 648 .It Va WITHOUT_FLOPPY
 649 Set to not build or install programs
 650 for operating floppy disk driver.
 651 .It Va WITHOUT_FMTREE
 652 Set to not build and install
 653 .Pa /usr/sbin/fmtree .
 654 .It Va WITHOUT_FORMAT_EXTENSIONS
 655 Set to not enable
 656 .Fl fformat-extensions
 657 when compiling the kernel.
 658 Also disables all format checking.
 659 .It Va WITHOUT_FORTH
 660 Set to build bootloaders without Forth support.
 661 .It Va WITHOUT_FP_LIBC
 662 Set to build
 663 .Nm libc
 664 without floating-point support.
 665 .It Va WITHOUT_FREEBSD_UPDATE
 666 Set to not build
 667 .Xr freebsd-update 8 .
 668 .It Va WITHOUT_FTP
 669 Set to not build or install
 670 .Xr ftp 1
 671 and
 672 .Xr ftpd 8 .
 673 .It Va WITHOUT_GAMES
 674 Set to not build games.
 675 .It Va WITHOUT_GCC
 676 Set to not build and install gcc and g++ as part of the normal build process.
 677 .Pp
 678 This is a default setting on
 679 amd64/amd64, arm/arm, arm/armeb, arm/armv6, arm/armv7, arm64/aarch64, i386/i386, riscv/riscv64 and riscv/riscv64sf.
 680 .It Va WITH_GCC
 681 Set to build and install gcc and g++.
 682 .Pp
 683 This is a default setting on
 684 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.
 685 .It Va WITHOUT_GCC_BOOTSTRAP
 686 Set to not build gcc and g++ as part of the bootstrap process.
 687 You must enable either gcc or clang bootstrap to be able to build the system,
 688 unless an alternative compiler is provided via
 689 XCC.
 690 .Pp
 691 This is a default setting on
 692 amd64/amd64, arm/arm, arm/armeb, arm/armv6, arm/armv7, arm64/aarch64, i386/i386, riscv/riscv64 and riscv/riscv64sf.
 693 .It Va WITH_GCC_BOOTSTRAP
 694 Set to build gcc and g++ as part of the bootstrap process.
 695 .Pp
 696 This is a default setting on
 697 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.
 698 .It Va WITHOUT_GCOV
 699 Set to not build the
 700 .Xr gcov 1
 701 tool.
 702 .It Va WITHOUT_GDB
 703 Set to not build
 704 .Xr gdb 1 .
 705 .Pp
 706 This is a default setting on
 707 arm64/aarch64, riscv/riscv64 and riscv/riscv64sf.
 708 .It Va WITH_GDB
 709 Set to build
 710 .Xr gdb 1 .
 711 .Pp
 712 This is a default setting on
 713 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.
 714 .It Va WITHOUT_GDB_LIBEXEC
 715 Set to install
 716 .Xr gdb 1
 717 into
 718 .Pa /usr/bin .
 719 .Pp
 720 This is a default setting on
 721 arm/arm, arm/armeb, arm/armv6, arm/armv7 and sparc64/sparc64.
 722 .It Va WITH_GDB_LIBEXEC
 723 Set to install
 724 .Xr gdb 1
 725 into
 726 .Pa /usr/libexec .
 727 This permits
 728 .Xr gdb 1
 729 to be used as a fallback for
 730 .Xr crashinfo 8
 731 if a newer version is not installed.
 732 .Pp
 733 This is a default setting on
 734 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.
 735 .It Va WITHOUT_GNUCXX
 736 Do not build the GNU C++ stack (g++, libstdc++).
 737 This is the default on platforms where clang is the system compiler.
 738 .Pp
 739 This is a default setting on
 740 amd64/amd64, arm/arm, arm/armeb, arm/armv6, arm/armv7, arm64/aarch64, i386/i386, riscv/riscv64 and riscv/riscv64sf.
 741 .It Va WITH_GNUCXX
 742 Build the GNU C++ stack (g++, libstdc++).
 743 This is the default on platforms where gcc is the system compiler.
 744 .Pp
 745 This is a default setting on
 746 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.
 747 .It Va WITHOUT_GNU_DIFF
 748 Set to not build GNU
 749 .Xr diff 1
 750 and
 751 .Xr diff3 1 .
 752 .It Va WITHOUT_GNU_GREP
 753 Set to not build GNU
 754 .Xr grep 1 .
 755 .It Va WITH_GNU_GREP_COMPAT
 756 Set this option to include GNU extensions in
 757 .Xr bsdgrep 1
 758 by linking against libgnuregex.
 759 .It Va WITHOUT_GPIO
 760 Set to not build
 761 .Xr gpioctl 8
 762 as part of the base system.
 763 .It Va WITHOUT_GPL_DTC
 764 Set to build the BSD licensed version of the device tree compiler rather
 765 than the GPLed one from elinux.org.
 766 .Pp
 767 This is a default setting on
 768 amd64/amd64, arm/arm, arm/armeb, arm/armv6, arm/armv7, arm64/aarch64 and i386/i386.
 769 .It Va WITH_GPL_DTC
 770 Set to build the GPL'd version of the device tree compiler from elinux.org,
 771 instead of the BSD licensed one.
 772 .Pp
 773 This is a default setting on
 774 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.
 775 .It Va WITHOUT_GSSAPI
 776 Set to not build libgssapi.
 777 .It Va WITHOUT_HAST
 778 Set to not build
 779 .Xr hastd 8
 780 and related utilities.
 781 .It Va WITH_HESIOD
 782 Set to build Hesiod support.
 783 .It Va WITHOUT_HTML
 784 Set to not build HTML docs.
 785 .It Va WITHOUT_HYPERV
 786 Set to not build or install HyperV utilities.
 787 .It Va WITHOUT_ICONV
 788 Set to not build iconv as part of libc.
 789 .It Va WITHOUT_INCLUDES
 790 Set to not install header files.
 791 This option used to be spelled
 792 .Va NO_INCS .
 793 .Bf -symbolic
 794 The option does not work for build targets.
 795 .Ef
 796 .It Va WITHOUT_INET
 797 Set to not build programs and libraries related to IPv4 networking.
 798 When set, it enforces these options:
 799 .Pp
 800 .Bl -item -compact
 801 .It
 802 .Va WITHOUT_INET_SUPPORT
 803 .El
 804 .It Va WITHOUT_INET6
 805 Set to not build
 806 programs and libraries related to IPv6 networking.
 807 When set, it enforces these options:
 808 .Pp
 809 .Bl -item -compact
 810 .It
 811 .Va WITHOUT_INET6_SUPPORT
 812 .El
 813 .It Va WITHOUT_INET6_SUPPORT
 814 Set to build libraries, programs, and kernel modules without IPv6 support.
 815 .It Va WITHOUT_INETD
 816 Set to not build
 817 .Xr inetd 8 .
 818 .It Va WITHOUT_INET_SUPPORT
 819 Set to build libraries, programs, and kernel modules without IPv4 support.
 820 .It Va WITHOUT_INSTALLLIB
 821 Set this to not install optional libraries.
 822 For example, when creating a
 823 .Xr nanobsd 8
 824 image.
 825 .Bf -symbolic
 826 The option does not work for build targets.
 827 .Ef
 828 .It Va WITH_INSTALL_AS_USER
 829 Set to make install targets succeed for non-root users by installing
 830 files with owner and group attributes set to that of the user running
 831 the
 832 .Xr make 1
 833 command.
 834 The user still must set the
 835 .Va DESTDIR
 836 variable to point to a directory where the user has write permissions.
 837 .It Va WITHOUT_IPFILTER
 838 Set to not build IP Filter package.
 839 .It Va WITHOUT_IPFW
 840 Set to not build IPFW tools.
 841 .It Va WITHOUT_IPSEC_SUPPORT
 842 Set to not build the kernel with
 843 .Xr ipsec 4
 844 support.
 845 This option is needed for
 846 .Xr ipsec 4
 847 and
 848 .Xr tcpmd5 4 .
 849 .It Va WITHOUT_ISCSI
 850 Set to not build
 851 .Xr iscid 8
 852 and related utilities.
 853 .It Va WITHOUT_JAIL
 854 Set to not build tools for the support of jails; e.g.,
 855 .Xr jail 8 .
 856 .It Va WITHOUT_KDUMP
 857 Set to not build
 858 .Xr kdump 1
 859 and
 860 .Xr truss 1 .
 861 .It Va WITHOUT_KERBEROS
 862 Set this to not build Kerberos 5 (KTH Heimdal).
 863 When set, it enforces these options:
 864 .Pp
 865 .Bl -item -compact
 866 .It
 867 .Va WITHOUT_KERBEROS_SUPPORT
 868 .El
 869 .Pp
 870 When set, these options are also in effect:
 871 .Pp
 872 .Bl -inset -compact
 873 .It Va WITHOUT_GSSAPI
 874 (unless
 875 .Va WITH_GSSAPI
 876 is set explicitly)
 877 .El
 878 .It Va WITHOUT_KERBEROS_SUPPORT
 879 Set to build some programs without Kerberos support, like
 880 .Xr ssh 1 ,
 881 .Xr telnet 1 ,
 882 .Xr sshd 8 ,
 883 and
 884 .Xr telnetd 8 .
 885 .It Va WITH_KERNEL_RETPOLINE
 886 Set to enable the "retpoline" mitigation for CVE-2017-5715 in the kernel
 887 build.
 888 .It Va WITHOUT_KERNEL_SYMBOLS
 889 Set to not install kernel symbol files.
 890 .Bf -symbolic
 891 This option is recommended for those people who have small root partitions.
 892 .Ef
 893 .It Va WITHOUT_KVM
 894 Set to not build the
 895 .Nm libkvm
 896 library as a part of the base system.
 897 .Bf -symbolic
 898 The option has no effect yet.
 899 .Ef
 900 When set, it enforces these options:
 901 .Pp
 902 .Bl -item -compact
 903 .It
 904 .Va WITHOUT_KVM_SUPPORT
 905 .El
 906 .It Va WITHOUT_KVM_SUPPORT
 907 Set to build some programs without optional
 908 .Nm libkvm
 909 support.
 910 .It Va WITHOUT_LDNS
 911 Setting this variable will prevent the LDNS library from being built.
 912 When set, it enforces these options:
 913 .Pp
 914 .Bl -item -compact
 915 .It
 916 .Va WITHOUT_LDNS_UTILS
 917 .It
 918 .Va WITHOUT_UNBOUND
 919 .El
 920 .It Va WITHOUT_LDNS_UTILS
 921 Setting this variable will prevent building the LDNS utilities
 922 .Xr drill 1
 923 and
 924 .Xr host 1 .
 925 .It Va WITHOUT_LEGACY_CONSOLE
 926 Set to not build programs that support a legacy PC console; e.g.,
 927 .Xr kbdcontrol 1
 928 and
 929 .Xr vidcontrol 1 .
 930 .It Va WITHOUT_LIB32
 931 On 64-bit platforms, set to not build 32-bit library set and a
 932 .Nm ld-elf32.so.1
 933 runtime linker.
 934 .It Va WITHOUT_LIBCPLUSPLUS
 935 Set to avoid building libcxxrt and libc++.
 936 .It Va WITHOUT_LIBPTHREAD
 937 Set to not build the
 938 .Nm libpthread
 939 providing library,
 940 .Nm libthr .
 941 When set, it enforces these options:
 942 .Pp
 943 .Bl -item -compact
 944 .It
 945 .Va WITHOUT_LIBTHR
 946 .El
 947 .It Va WITH_LIBSOFT
 948 On armv6 only, set to enable soft float ABI compatibility libraries.
 949 This option is for transitioning to the new hard float ABI.
 950 .It Va WITHOUT_LIBTHR
 951 Set to not build the
 952 .Nm libthr
 953 (1:1 threading)
 954 library.
 955 .It Va WITHOUT_LLD
 956 Set to not build LLVM's lld linker.
 957 .Pp
 958 This is a default setting on
 959 riscv/riscv64, riscv/riscv64sf and sparc64/sparc64.
 960 .It Va WITH_LLD
 961 Set to build LLVM's lld linker.
 962 .Pp
 963 This is a default setting on
 964 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.
 965 .It Va WITHOUT_LLDB
 966 Set to not build the LLDB debugger.
 967 .Pp
 968 This is a default setting on
 969 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.
 970 .It Va WITH_LLDB
 971 Set to build the LLDB debugger.
 972 .Pp
 973 This is a default setting on
 974 amd64/amd64, arm64/aarch64 and i386/i386.
 975 .It Va WITHOUT_LLD_BOOTSTRAP
 976 Set to not build the LLD linker during the bootstrap phase of
 977 the build.
 978 To be able to build the system, either Binutils or LLD bootstrap must be
 979 enabled unless an alternate linker is provided via XLD.
 980 .Pp
 981 This is a default setting on
 982 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.
 983 .It Va WITH_LLD_BOOTSTRAP
 984 Set to build the LLD linker during the bootstrap phase of the build.
 985 .Pp
 986 This is a default setting on
 987 amd64/amd64 and arm64/aarch64.
 988 .It Va WITHOUT_LLD_IS_LD
 989 Set to use GNU binutils ld as the system linker, instead of LLVM's LLD.
 990 .Pp
 991 This is a default setting on
 992 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.
 993 .It Va WITH_LLD_IS_LD
 994 Set to use LLVM's LLD as the system linker, instead of GNU binutils ld.
 995 .Pp
 996 This is a default setting on
 997 arm64/aarch64.
 998 .It Va WITHOUT_LLVM_COV
 999 Set to not build the
1000 .Xr llvm-cov 1
1001 tool.
1002 .Pp
1003 This is a default setting on
1004 riscv/riscv64, riscv/riscv64sf and sparc64/sparc64.
1005 .It Va WITH_LLVM_COV
1006 Set to build the
1007 .Xr llvm-cov 1
1008 tool.
1009 .Pp
1010 This is a default setting on
1011 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.
1012 .It Va WITHOUT_LLVM_LIBUNWIND
1013 Set to use GCC's stack unwinder (instead of LLVM's libunwind).
1014 .Pp
1015 This is a default setting on
1016 arm/arm, arm/armeb, arm/armv6, arm/armv7, powerpc/powerpc, powerpc/powerpc64, powerpc/powerpcspe and sparc64/sparc64.
1017 .It Va WITH_LLVM_LIBUNWIND
1018 Set to use LLVM's libunwind stack unwinder (instead of GCC's unwinder).
1019 .Pp
1020 This is a default setting on
1021 amd64/amd64, 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.
1022 .It Va WITH_LOADER_FIREWIRE
1023 Enable firewire support in /boot/loader and /boot/zfsloader on x86.
1024 This option is a nop on all other platforms.
1025 .It Va WITHOUT_LOADER_GELI
1026 Disable inclusion of GELI crypto support in the boot chain binaries.
1027 .Pp
1028 This is a default setting on
1029 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.
1030 .It Va WITH_LOADER_LUA
1031 Set to build LUA bindings for the boot loader.
1032 .It Va WITHOUT_LOADER_OFW
1033 Disable building of openfirmware bootloader components.
1034 .Pp
1035 This is a default setting on
1036 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.
1037 .It Va WITH_LOADER_OFW
1038 Set to build openfirmware bootloader components.
1039 .Pp
1040 This is a default setting on
1041 powerpc/powerpc, powerpc/powerpc64, powerpc/powerpcspe and sparc64/sparc64.
1042 .It Va WITHOUT_LOADER_UBOOT
1043 Disable building of ubldr.
1044 .Pp
1045 This is a default setting on
1046 amd64/amd64, arm64/aarch64, i386/i386, riscv/riscv64, riscv/riscv64sf and sparc64/sparc64.
1047 .It Va WITH_LOADER_UBOOT
1048 Set to build ubldr.
1049 .Pp
1050 This is a default setting on
1051 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.
1052 .It Va WITHOUT_LOCALES
1053 Set to not build localization files; see
1054 .Xr locale 1 .
1055 .It Va WITHOUT_LOCATE
1056 Set to not build
1057 .Xr locate 1
1058 and related programs.
1059 .It Va WITHOUT_LPR
1060 Set to not build
1061 .Xr lpr 1
1062 and related programs.
1063 .It Va WITHOUT_LS_COLORS
1064 Set to build
1065 .Xr ls 1
1066 without support for colors to distinguish file types.
1067 .It Va WITHOUT_LZMA_SUPPORT
1068 Set to build some programs without optional lzma compression support.
1069 .It Va WITHOUT_MAIL
1070 Set to not build any mail support (MUA or MTA).
1071 When set, it enforces these options:
1072 .Pp
1073 .Bl -item -compact
1074 .It
1075 .Va WITHOUT_DMAGENT
1076 .It
1077 .Va WITHOUT_MAILWRAPPER
1078 .It
1079 .Va WITHOUT_SENDMAIL
1080 .El
1081 .It Va WITHOUT_MAILWRAPPER
1082 Set to not build the
1083 .Xr mailwrapper 8
1084 MTA selector.
1085 .It Va WITHOUT_MAKE
1086 Set to not install
1087 .Xr make 1
1088 and related support files.
1089 .It Va WITHOUT_MAKE_CHECK_USE_SANDBOX
1090 Set to not execute
1091 .Dq Li "make check"
1092 in limited sandbox mode.
1093 This option should be paired with
1094 .Va WITH_INSTALL_AS_USER
1095 if executed as an unprivileged user.
1096 See
1097 .Xr tests 7
1098 for more details.
1099 .It Va WITHOUT_MAN
1100 Set to not build manual pages.
1101 When set, these options are also in effect:
1102 .Pp
1103 .Bl -inset -compact
1104 .It Va WITHOUT_MAN_UTILS
1105 (unless
1106 .Va WITH_MAN_UTILS
1107 is set explicitly)
1108 .El
1109 .It Va WITHOUT_MANCOMPRESS
1110 Set to not to install compressed man pages.
1111 Only the uncompressed versions will be installed.
1112 .It Va WITHOUT_MAN_UTILS
1113 Set to not build utilities for manual pages,
1114 .Xr apropos 1 ,
1115 .Xr makewhatis 1 ,
1116 .Xr man 1 ,
1117 .Xr whatis 1 ,
1118 .Xr manctl 8 ,
1119 and related support files.
1120 .It Va WITH_META_MODE
1121 Create
1122 .Xr make 1
1123 meta files when building, which can provide a reliable incremental build when
1124 using
1125 .Xr filemon 4 .
1126 The meta file is created in OBJDIR as
1127 .Pa target.meta .
1128 These meta files track the command that was executed, its output, and the
1129 current directory.
1130 The
1131 .Xr filemon 4
1132 module is required unless
1133 .Va NO_FILEMON
1134 is defined.
1135 When the module is loaded, any files used by the commands executed are
1136 tracked as dependencies for the target in its meta file.
1137 The target is considered out-of-date and rebuilt if any of these
1138 conditions are true compared to the last build:
1139 .Bl -bullet -compact
1140 .It
1141 The command to execute changes.
1142 .It
1143 The current working directory changes.
1144 .It
1145 The target's meta file is missing.
1146 .It
1147 The target's meta file is missing filemon data when filemon is loaded
1148 and a previous run did not have it loaded.
1149 .It
1150 [requires
1151 .Xr filemon 4 ]
1152 Files read, executed or linked to are newer than the target.
1153 .It
1154 [requires
1155 .Xr filemon 4 ]
1156 Files read, written, executed or linked are missing.
1157 .El
1158 The meta files can also be useful for debugging.
1159 .Pp
1160 The build hides commands that are executed unless
1161 .Va NO_SILENT
1162 is defined.
1163 Errors cause
1164 .Xr make 1
1165 to show some of its environment for further debugging.
1166 .Pp
1167 The build operates as it normally would otherwise.
1168 This option originally invoked a different build system but that was renamed
1169 to
1170 .Va WITH_DIRDEPS_BUILD .
1171 .Pp
1172 This must be set in the environment, make command line, or
1173 .Pa /etc/src-env.conf ,
1174 not
1175 .Pa /etc/src.conf .
1176 .It Va WITHOUT_MLX5TOOL
1177 Set to not build
1178 .Xr mlx5tool 8
1179 .Pp
1180 This is a default setting on
1181 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.
1182 .It Va WITH_MLX5TOOL
1183 Set to build
1184 .Xr mlx5tool 8
1185 .Pp
1186 This is a default setting on
1187 amd64/amd64, arm64/aarch64, i386/i386, powerpc/powerpc64 and sparc64/sparc64.
1188 .It Va WITH_NAND
1189 Set to build the NAND Flash components.
1190 .It Va WITHOUT_NDIS
1191 Set to not build programs and libraries
1192 related to NDIS emulation support.
1193 .It Va WITHOUT_NETCAT
1194 Set to not build
1195 .Xr nc 1
1196 utility.
1197 .It Va WITHOUT_NETGRAPH
1198 Set to not build applications to support
1199 .Xr netgraph 4 .
1200 When set, it enforces these options:
1201 .Pp
1202 .Bl -item -compact
1203 .It
1204 .Va WITHOUT_ATM
1205 .It
1206 .Va WITHOUT_BLUETOOTH
1207 .It
1208 .Va WITHOUT_NETGRAPH_SUPPORT
1209 .El
1210 .It Va WITHOUT_NETGRAPH_SUPPORT
1211 Set to build libraries, programs, and kernel modules without netgraph support.
1212 .It Va WITHOUT_NIS
1213 Set to not build
1214 .Xr NIS 8
1215 support and related programs.
1216 If set, you might need to adopt your
1217 .Xr nsswitch.conf 5
1218 and remove
1219 .Sq nis
1220 entries.
1221 .It Va WITHOUT_NLS
1222 Set to not build NLS catalogs.
1223 When set, it enforces these options:
1224 .Pp
1225 .Bl -item -compact
1226 .It
1227 .Va WITHOUT_NLS_CATALOGS
1228 .El
1229 .It Va WITHOUT_NLS_CATALOGS
1230 Set to not build NLS catalog support for
1231 .Xr csh 1 .
1232 .It Va WITHOUT_NS_CACHING
1233 Set to disable name caching in the
1234 .Pa nsswitch
1235 subsystem.
1236 The generic caching daemon,
1237 .Xr nscd 8 ,
1238 will not be built either if this option is set.
1239 .It Va WITHOUT_NTP
1240 Set to not build
1241 .Xr ntpd 8
1242 and related programs.
1243 .It Va WITH_OFED
1244 Set to build the
1245 .Dq "OpenFabrics Enterprise Distribution"
1246 Infiniband software stack.
1247 .It Va WITH_OPENLDAP
1248 Enable building openldap support for kerberos.
1249 .It Va WITHOUT_OPENSSH
1250 Set to not build OpenSSH.
1251 .It Va WITHOUT_OPENSSL
1252 Set to not build OpenSSL.
1253 When set, it enforces these options:
1254 .Pp
1255 .Bl -item -compact
1256 .It
1257 .Va WITHOUT_KERBEROS
1258 .It
1259 .Va WITHOUT_KERBEROS_SUPPORT
1260 .It
1261 .Va WITHOUT_OPENSSH
1262 .El
1263 .Pp
1264 When set, these options are also in effect:
1265 .Pp
1266 .Bl -inset -compact
1267 .It Va WITHOUT_GSSAPI
1268 (unless
1269 .Va WITH_GSSAPI
1270 is set explicitly)
1271 .El
1272 .It Va WITHOUT_PAM
1273 Set to not build PAM library and modules.
1274 .Bf -symbolic
1275 This option is deprecated and does nothing.
1276 .Ef
1277 When set, it enforces these options:
1278 .Pp
1279 .Bl -item -compact
1280 .It
1281 .Va WITHOUT_PAM_SUPPORT
1282 .El
1283 .It Va WITHOUT_PAM_SUPPORT
1284 Set to build some programs without PAM support, particularly
1285 .Xr ftpd 8
1286 and
1287 .Xr ppp 8 .
1288 .It Va WITHOUT_PC_SYSINSTALL
1289 Set to not build
1290 .Xr pc-sysinstall 8
1291 and related programs.
1292 .It Va WITHOUT_PF
1293 Set to not build PF firewall package.
1294 When set, it enforces these options:
1295 .Pp
1296 .Bl -item -compact
1297 .It
1298 .Va WITHOUT_AUTHPF
1299 .El
1300 .It Va WITHOUT_PKGBOOTSTRAP
1301 Set to not build
1302 .Xr pkg 7
1303 bootstrap tool.
1304 .It Va WITHOUT_PMC
1305 Set to not build
1306 .Xr pmccontrol 8
1307 and related programs.
1308 .It Va WITHOUT_PORTSNAP
1309 Set to not build or install
1310 .Xr portsnap 8
1311 and related files.
1312 .It Va WITHOUT_PPP
1313 Set to not build
1314 .Xr ppp 8
1315 and related programs.
1316 .It Va WITHOUT_PROFILE
1317 Set to not build profiled libraries for use with
1318 .Xr gprof 8 .
1319 .Pp
1320 This is a default setting on
1321 mips/mips64el, mips/mips64, mips/mips64elhf, mips/mips64hf, riscv/riscv64 and riscv/riscv64sf.
1322 .It Va WITH_PROFILE
1323 Set to build profiled libraries for use with
1324 .Xr gprof 8 .
1325 .Pp
1326 This is a default setting on
1327 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.
1328 .It Va WITHOUT_QUOTAS
1329 Set to not build
1330 .Xr quota 1
1331 and related programs.
1332 .It Va WITHOUT_RADIUS_SUPPORT
1333 Set to not build radius support into various applications, like
1334 .Xr pam_radius 8
1335 and
1336 .Xr ppp 8 .
1337 .It Va WITH_RATELIMIT
1338 Set to build the system with rate limit support.
1339 .Pp
1340 This makes
1341 .Dv SO_MAX_PACING_RATE
1342 effective in
1343 .Xr getsockopt 2 ,
1344 and
1345 .Ar txrlimit
1346 support in
1347 .Xr ifconfig 8 ,
1348 by proxy.
1349 .It Va WITHOUT_RBOOTD
1350 Set to not build or install
1351 .Xr rbootd 8 .
1352 .It Va WITH_REPRODUCIBLE_BUILD
1353 Set to exclude build metadata (such as the build time, user, or host)
1354 from the kernel, boot loaders, and uname output, so that builds produce
1355 bit-for-bit identical output.
1356 .It Va WITHOUT_RESCUE
1357 Set to not build
1358 .Xr rescue 8 .
1359 .It Va WITHOUT_ROUTED
1360 Set to not build
1361 .Xr routed 8
1362 utility.
1363 .It Va WITH_RPCBIND_WARMSTART_SUPPORT
1364 Set to build
1365 .Xr rpcbind 8
1366 with warmstart support.
1367 .It Va WITHOUT_SENDMAIL
1368 Set to not build
1369 .Xr sendmail 8
1370 and related programs.
1371 .It Va WITHOUT_SETUID_LOGIN
1372 Set this to disable the installation of
1373 .Xr login 1
1374 as a set-user-ID root program.
1375 .It Va WITHOUT_SHAREDOCS
1376 Set to not build the
1377 .Bx 4.4
1378 legacy docs.
1379 .It Va WITH_SHARED_TOOLCHAIN
1380 Set to build the toolchain binaries shared.
1381 The set includes
1382 .Xr cc 1 ,
1383 .Xr make 1
1384 and necessary utilities like assembler, linker and library archive manager.
1385 .It Va WITH_SORT_THREADS
1386 Set to enable threads in
1387 .Xr sort 1 .
1388 .It Va WITHOUT_SOURCELESS
1389 Set to not build kernel modules that include sourceless code (either microcode or native code for host CPU).
1390 When set, it enforces these options:
1391 .Pp
1392 .Bl -item -compact
1393 .It
1394 .Va WITHOUT_SOURCELESS_HOST
1395 .It
1396 .Va WITHOUT_SOURCELESS_UCODE
1397 .El
1398 .It Va WITHOUT_SOURCELESS_HOST
1399 Set to not build kernel modules that include sourceless native code for host CPU.
1400 .It Va WITHOUT_SOURCELESS_UCODE
1401 Set to not build kernel modules that include sourceless microcode.
1402 .It Va WITHOUT_SSP
1403 Set to not build world with propolice stack smashing protection.
1404 .Pp
1405 This is a default setting on
1406 mips/mipsel, mips/mips, mips/mips64el, mips/mips64, mips/mipsn32, mips/mipselhf, mips/mipshf, mips/mips64elhf and mips/mips64hf.
1407 .It Va WITH_SSP
1408 Set to build world with propolice stack smashing protection.
1409 .Pp
1410 This is a default setting on
1411 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.
1412 .It Va WITH_STAGING
1413 Enable staging of files to a stage tree.
1414 This can be best thought of as auto-install to
1415 .Va DESTDIR
1416 with some extra meta data to ensure dependencies can be tracked.
1417 Depends on
1418 .Va WITH_DIRDEPS_BUILD .
1419 When set, these options are also in effect:
1420 .Pp
1421 .Bl -inset -compact
1422 .It Va WITH_STAGING_MAN
1423 (unless
1424 .Va WITHOUT_STAGING_MAN
1425 is set explicitly)
1426 .It Va WITH_STAGING_PROG
1427 (unless
1428 .Va WITHOUT_STAGING_PROG
1429 is set explicitly)
1430 .El
1431 .Pp
1432 This must be set in the environment, make command line, or
1433 .Pa /etc/src-env.conf ,
1434 not
1435 .Pa /etc/src.conf .
1436 .It Va WITH_STAGING_MAN
1437 Enable staging of man pages to stage tree.
1438 .It Va WITH_STAGING_PROG
1439 Enable staging of PROGs to stage tree.
1440 .It Va WITH_STALE_STAGED
1441 Check staged files are not stale.
1442 .It Va WITH_SVN
1443 Set to install
1444 .Xr svnlite 1
1445 as
1446 .Xr svn 1 .
1447 .It Va WITHOUT_SVNLITE
1448 Set to not build
1449 .Xr svnlite 1
1450 and related programs.
1451 .It Va WITHOUT_SYMVER
1452 Set to disable symbol versioning when building shared libraries.
1453 .It Va WITHOUT_SYSCONS
1454 Set to not build
1455 .Xr syscons 4
1456 support files such as keyboard maps, fonts, and screen output maps.
1457 .It Va WITH_SYSROOT
1458 Enable use of sysroot during build.
1459 Depends on
1460 .Va WITH_DIRDEPS_BUILD .
1461 .Pp
1462 This must be set in the environment, make command line, or
1463 .Pa /etc/src-env.conf ,
1464 not
1465 .Pa /etc/src.conf .
1466 .It Va WITHOUT_SYSTEM_COMPILER
1467 Set to not opportunistically skip building a cross-compiler during the
1468 bootstrap phase of the build.
1469 Normally, if the currently installed compiler matches the planned bootstrap
1470 compiler type and revision, then it will not be built.
1471 This does not prevent a compiler from being built for installation though,
1472 only for building one for the build itself.
1473 The
1474 .Va WITHOUT_CLANG
1475 and
1476 .Va WITHOUT_GCC
1477 options control those.
1478 .It Va WITHOUT_TALK
1479 Set to not build or install
1480 .Xr talk 1
1481 and
1482 .Xr talkd 8 .
1483 .It Va WITHOUT_TCP_WRAPPERS
1484 Set to not build or install
1485 .Xr tcpd 8 ,
1486 and related utilities.
1487 .It Va WITHOUT_TCSH
1488 Set to not build and install
1489 .Pa /bin/csh
1490 (which is
1491 .Xr tcsh 1 ) .
1492 .It Va WITHOUT_TELNET
1493 Set to not build
1494 .Xr telnet 1
1495 and related programs.
1496 .It Va WITHOUT_TESTS
1497 Set to not build nor install the
1498 .Fx
1499 Test Suite in
1500 .Pa /usr/tests/ .
1501 See
1502 .Xr tests 7
1503 for more details.
1504 This also disables the build of all test-related dependencies, including ATF.
1505 .Pp
1506 This is a default setting on
1507 riscv/riscv64 and riscv/riscv64sf.
1508 When set, it enforces these options:
1509 .Pp
1510 .Bl -item -compact
1511 .It
1512 .Va WITHOUT_DTRACE_TESTS
1513 .It
1514 .Va WITHOUT_TESTS_SUPPORT
1515 .El
1516 .It Va WITHOUT_TESTS_SUPPORT
1517 Set to disables the build of all test-related dependencies, including ATF.
1518 .Pp
1519 This is a default setting on
1520 riscv/riscv64 and riscv/riscv64sf.
1521 .It Va WITHOUT_TEXTPROC
1522 Set to not build
1523 programs used for text processing.
1524 .It Va WITHOUT_TFTP
1525 Set to not build or install
1526 .Xr tftp 1
1527 and
1528 .Xr tftpd 8 .
1529 .It Va WITHOUT_TIMED
1530 Set to not build or install
1531 .Xr timed 8 .
1532 .It Va WITHOUT_TOOLCHAIN
1533 Set to not install header or
1534 programs used for program development,
1535 compilers, debuggers etc.
1536 When set, it enforces these options:
1537 .Pp
1538 .Bl -item -compact
1539 .It
1540 .Va WITHOUT_BINUTILS
1541 .It
1542 .Va WITHOUT_CLANG
1543 .It
1544 .Va WITHOUT_CLANG_EXTRAS
1545 .It
1546 .Va WITHOUT_CLANG_FULL
1547 .It
1548 .Va WITHOUT_GCC
1549 .It
1550 .Va WITHOUT_GDB
1551 .It
1552 .Va WITHOUT_INCLUDES
1553 .It
1554 .Va WITHOUT_LLD
1555 .It
1556 .Va WITHOUT_LLDB
1557 .It
1558 .Va WITHOUT_LLVM_COV
1559 .El
1560 .It Va WITHOUT_UNBOUND
1561 Set to not build
1562 .Xr unbound 8
1563 and related programs.
1564 .It Va WITHOUT_UNIFIED_OBJDIR
1565 Set to use the historical object directory format for
1566 .Xr build 7
1567 targets.
1568 For native-builds and builds done directly in sub-directories the format of
1569 .Pa ${MAKEOBJDIRPREFIX}/${.CURDIR}
1570 is used,
1571 while for cross-builds
1572 .Pa ${MAKEOBJDIRPREFIX}/${TARGET}.${TARGET_ARCH}/${.CURDIR}
1573 is used.
1574 .Pp
1575 This option is transitional and will be removed before the 12.0 release,
1576 at which time
1577 .va WITH_UNIFIED_OBJDIR
1578 will be enabled permanently.
1579 .Pp
1580 This must be set in the environment, make command line, or
1581 .Pa /etc/src-env.conf ,
1582 not
1583 .Pa /etc/src.conf .
1584 .It Va WITHOUT_USB
1585 Set to not build USB-related programs and libraries.
1586 .It Va WITHOUT_USB_GADGET_EXAMPLES
1587 Set to not build USB gadget kernel modules.
1588 .It Va WITHOUT_UTMPX
1589 Set to not build user accounting tools such as
1590 .Xr last 1 ,
1591 .Xr users 1 ,
1592 .Xr who 1 ,
1593 .Xr ac 8 ,
1594 .Xr lastlogin 8
1595 and
1596 .Xr utx 8 .
1597 .It Va WITHOUT_VI
1598 Set to not build and install vi, view, ex and related programs.
1599 .It Va WITHOUT_VT
1600 Set to not build
1601 .Xr vt 4
1602 support files (fonts and keymaps).
1603 .It Va WITHOUT_WARNS
1604 Set this to not add warning flags to the compiler invocations.
1605 Useful as a temporary workaround when code enters the tree
1606 which triggers warnings in environments that differ from the
1607 original developer.
1608 .It Va WITHOUT_WIRELESS
1609 Set to not build programs used for 802.11 wireless networks; especially
1610 .Xr wpa_supplicant 8
1611 and
1612 .Xr hostapd 8 .
1613 When set, it enforces these options:
1614 .Pp
1615 .Bl -item -compact
1616 .It
1617 .Va WITHOUT_WIRELESS_SUPPORT
1618 .El
1619 .It Va WITHOUT_WIRELESS_SUPPORT
1620 Set to build libraries, programs, and kernel modules without
1621 802.11 wireless support.
1622 .It Va WITHOUT_WPA_SUPPLICANT_EAPOL
1623 Build
1624 .Xr wpa_supplicant 8
1625 without support for the IEEE 802.1X protocol and without
1626 support for EAP-PEAP, EAP-TLS, EAP-LEAP, and EAP-TTLS
1627 protocols (usable only via 802.1X).
1628 .It Va WITHOUT_ZFS
1629 Set to not build ZFS file system.
1630 .It Va WITHOUT_ZONEINFO
1631 Set to not build the timezone database.
1632 When set, it enforces these options:
1633 .Pp
1634 .Bl -item -compact
1635 .It
1636 .Va WITHOUT_ZONEINFO_LEAPSECONDS_SUPPORT
1637 .It
1638 .Va WITHOUT_ZONEINFO_OLD_TIMEZONES_SUPPORT
1639 .El
1640 .It Va WITH_ZONEINFO_LEAPSECONDS_SUPPORT
1641 Set to build leapsecond information in to the timezone database.
1642 .It Va WITH_ZONEINFO_OLD_TIMEZONES_SUPPORT
1643 Set to build backward compatibility timezone aliases in to the timezone
1644 database.
1645 .El
1646 .Sh FILES
1647 .Bl -tag -compact -width Pa
1648 .It Pa /etc/src.conf
1649 .It Pa /etc/src-env.conf
1650 .It Pa /usr/share/mk/bsd.own.mk
1651 .El
1652 .Sh SEE ALSO
1653 .Xr make 1 ,
1654 .Xr make.conf 5 ,
1655 .Xr build 7 ,
1656 .Xr ports 7
1657 .Sh HISTORY
1658 The
1659 .Nm
1660 file appeared in
1661 .Fx 7.0 .
1662 .Sh AUTHORS
1663 This manual page was autogenerated by
1664 .An tools/build/options/makeman .