share/man/man5/src.conf.5

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