]> CyberLeo.Net >> Repos - FreeBSD/FreeBSD.git/blob - share/man/man5/src.conf.5
Replace references to /dev/acd0 with /dev/cd0
[FreeBSD/FreeBSD.git] / share / man / man5 / src.conf.5
1 .\" DO NOT EDIT-- this file is automatically generated.
2 .\" from FreeBSD: head/tools/build/options/makeman 287942 2015-09-17 22:04:46Z bdrewery
3 .\" $FreeBSD$
4 .Dd September 18, 2015
5 .Dt SRC.CONF 5
6 .Os
7 .Sh NAME
8 .Nm src.conf
9 .Nd "source build options"
10 .Sh DESCRIPTION
11 The
12 .Nm
13 file contains settings that will apply to every build involving the
14 .Fx
15 source tree; see
16 .Xr build 7 .
17 .Pp
18 The
19 .Nm
20 file uses the standard makefile syntax.
21 However,
22 .Nm
23 should not specify any dependencies to
24 .Xr make 1 .
25 Instead,
26 .Nm
27 is to set
28 .Xr make 1
29 variables that control the aspects of how the system builds.
30 .Pp
31 The default location of
32 .Nm
33 is
34 .Pa /etc/src.conf ,
35 though an alternative location can be specified in the
36 .Xr make 1
37 variable
38 .Va SRCCONF .
39 Overriding the location of
40 .Nm
41 may be necessary if the system-wide settings are not suitable
42 for a particular build.
43 For instance, setting
44 .Va SRCCONF
45 to
46 .Pa /dev/null
47 effectively resets all build controls to their defaults.
48 .Pp
49 The only purpose of
50 .Nm
51 is to control the compilation of the
52 .Fx
53 source code, which is usually located in
54 .Pa /usr/src .
55 As a rule, the system administrator creates
56 .Nm
57 when the values of certain control variables need to be changed
58 from their defaults.
59 .Pp
60 In addition, control variables can be specified
61 for a particular build via the
62 .Fl D
63 option of
64 .Xr make 1
65 or in its environment; see
66 .Xr environ 7 .
67 .Pp
68 The environment of
69 .Xr make 1
70 for the build can be controlled via the
71 .Va SRC_ENV_CONF
72 variable, which defaults to
73 .Pa /etc/src-env.conf .
74 Some examples that may only be set in this file are
75 .Va MAKEOBJDIRPREFIX ,
76 and
77 .Va WITH_META_MODE
78 as they are environment-only variables.
79 .Pp
80 The values of variables are ignored regardless of their setting;
81 even if they would be set to
82 .Dq Li FALSE
83 or
84 .Dq Li NO .
85 Just the existence of an option will cause
86 it to be honoured by
87 .Xr make 1 .
88 .Pp
89 The following list provides a name and short description for variables
90 that can be used for source builds.
91 .Bl -tag -width indent
92 .It Va WITHOUT_ACCT
93 .\" from FreeBSD: head/tools/build/options/WITHOUT_ACCT 223201 2011-06-17 20:47:44Z ed
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 .\" from FreeBSD: head/tools/build/options/WITHOUT_ACPI 156932 2006-03-21 07:50:50Z ru
100 Set to not build
101 .Xr acpiconf 8 ,
102 .Xr acpidump 8
103 and related programs.
104 .It Va WITHOUT_AMD
105 .\" from FreeBSD: head/tools/build/options/WITHOUT_AMD 183242 2008-09-21 22:02:26Z sam
106 Set to not build
107 .Xr amd 8 ,
108 and related programs.
109 .It Va WITHOUT_APM
110 .\" from FreeBSD: head/tools/build/options/WITHOUT_APM 183242 2008-09-21 22:02:26Z sam
111 Set to not build
112 .Xr apm 8 ,
113 .Xr apmd 8
114 and related programs.
115 .It Va WITHOUT_ASSERT_DEBUG
116 .\" from FreeBSD: head/tools/build/options/WITHOUT_ASSERT_DEBUG 162215 2006-09-11 13:55:27Z ru
117 Set to compile programs and libraries without the
118 .Xr assert 3
119 checks.
120 .It Va WITHOUT_AT
121 .\" from FreeBSD: head/tools/build/options/WITHOUT_AT 183242 2008-09-21 22:02:26Z sam
122 Set to not build
123 .Xr at 1
124 and related utilities.
125 .It Va WITHOUT_ATM
126 .\" from FreeBSD: head/tools/build/options/WITHOUT_ATM 156932 2006-03-21 07:50:50Z ru
127 Set to not build
128 programs and libraries related to ATM networking.
129 .It Va WITHOUT_AUDIT
130 .\" from FreeBSD: head/tools/build/options/WITHOUT_AUDIT 156932 2006-03-21 07:50:50Z ru
131 Set to not build audit support into system programs.
132 .It Va WITHOUT_AUTHPF
133 .\" from FreeBSD: head/tools/build/options/WITHOUT_AUTHPF 156932 2006-03-21 07:50:50Z ru
134 Set to not build
135 .Xr authpf 8 .
136 .It Va WITHOUT_AUTOFS
137 .\" from FreeBSD: head/tools/build/options/WITHOUT_AUTOFS 277728 2015-01-26 07:15:49Z ngie
138 Set to not build
139 .Xr autofs 4
140 related programs, libraries, and kernel modules.
141 .It Va WITH_AUTO_OBJ
142 .\" from FreeBSD: head/tools/build/options/WITH_AUTO_OBJ 284708 2015-06-22 20:21:57Z sjg
143 Enable automatic creation of objdirs.
144 .Pp
145 This must be set in the environment, make command line, or
146 .Pa /etc/src-env.conf ,
147 not
148 .Pa /etc/src.conf .
149 .It Va WITHOUT_BHYVE
150 .\" from FreeBSD: head/tools/build/options/WITHOUT_BHYVE 277727 2015-01-26 06:44:48Z ngie
151 Set to not build or install
152 .Xr bhyve 8 ,
153 associated utilities, and examples.
154 .Pp
155 This option only affects amd64/amd64.
156 .It Va WITHOUT_BINUTILS
157 .\" from FreeBSD: head/tools/build/options/WITHOUT_BINUTILS 286332 2015-08-05 18:30:00Z emaste
158 Set to not build or install binutils (as, ld, objcopy, and objdump ) as part
159 of the normal system build.
160 The resulting system cannot build programs from source.
161 .Pp
162 It is a default setting on
163 arm64/aarch64.
164 .It Va WITHOUT_BINUTILS_BOOTSTRAP
165 .\" from FreeBSD: head/tools/build/options/WITHOUT_BINUTILS_BOOTSTRAP 264660 2014-04-18 17:03:58Z imp
166 Set to not build binutils (as, c++-filt, gconv,
167 ld, nm, objcopy, objdump, readelf, size and strip)
168 as part of the bootstrap process.
169 .Bf -symbolic
170 The option does not work for build targets unless some alternative
171 toolchain is provided.
172 .Ef
173 .Pp
174 It is a default setting on
175 arm64/aarch64.
176 .It Va WITHOUT_BLUETOOTH
177 .\" from FreeBSD: head/tools/build/options/WITHOUT_BLUETOOTH 156932 2006-03-21 07:50:50Z ru
178 Set to not build Bluetooth related kernel modules, programs and libraries.
179 .It Va WITHOUT_BOOT
180 .\" from FreeBSD: head/tools/build/options/WITHOUT_BOOT 156932 2006-03-21 07:50:50Z ru
181 Set to not build the boot blocks and loader.
182 .It Va WITHOUT_BOOTPARAMD
183 .\" from FreeBSD: head/tools/build/options/WITHOUT_BOOTPARAMD 278192 2015-02-04 10:19:32Z ngie
184 Set to not build or install
185 .Xr bootparamd 8 .
186 .It Va WITHOUT_BOOTPD
187 .\" from FreeBSD: head/tools/build/options/WITHOUT_BOOTPD 278192 2015-02-04 10:19:32Z ngie
188 Set to not build or install
189 .Xr bootpd 8 .
190 .It Va WITHOUT_BSDINSTALL
191 .\" from FreeBSD: head/tools/build/options/WITHOUT_BSDINSTALL 277677 2015-01-25 04:43:13Z ngie
192 Set to not build
193 .Xr bsdinstall 8 ,
194 .Xr sade 8 ,
195 and related programs.
196 .It Va WITHOUT_BSD_CPIO
197 .\" from FreeBSD: head/tools/build/options/WITHOUT_BSD_CPIO 179813 2008-06-16 05:48:15Z dougb
198 Set to not build the BSD licensed version of cpio based on
199 .Xr libarchive 3 .
200 .It Va WITH_BSD_GREP
201 .\" from FreeBSD: head/tools/build/options/WITH_BSD_GREP 222273 2011-05-25 01:04:12Z obrien
202 Install BSD-licensed grep as '[ef]grep' instead of GNU grep.
203 .It Va WITHOUT_BSNMP
204 .\" from FreeBSD: head/tools/build/options/WITHOUT_BSNMP 183306 2008-09-23 16:15:42Z sam
205 Set to not build or install
206 .Xr bsnmpd 1
207 and related libraries and data files.
208 .It Va WITHOUT_BZIP2
209 .\" from FreeBSD: head/tools/build/options/WITHOUT_BZIP2 174550 2007-12-12 16:43:17Z ru
210 Set to not build contributed bzip2 software as a part of the base system.
211 .Bf -symbolic
212 The option has no effect yet.
213 .Ef
214 When set, it also enforces the following options:
215 .Pp
216 .Bl -item -compact
217 .It
218 .Va WITHOUT_BZIP2_SUPPORT
219 .El
220 .It Va WITHOUT_BZIP2_SUPPORT
221 .\" from FreeBSD: head/tools/build/options/WITHOUT_BZIP2_SUPPORT 166255 2007-01-26 10:19:08Z delphij
222 Set to build some programs without optional bzip2 support.
223 .It Va WITHOUT_CALENDAR
224 .\" from FreeBSD: head/tools/build/options/WITHOUT_CALENDAR 156932 2006-03-21 07:50:50Z ru
225 Set to not build
226 .Xr calendar 1 .
227 .It Va WITHOUT_CAPSICUM
228 .\" from FreeBSD: head/tools/build/options/WITHOUT_CAPSICUM 229319 2012-01-02 21:57:58Z rwatson
229 Set to not build Capsicum support into system programs.
230 .It Va WITHOUT_CASPER
231 .\" from FreeBSD: head/tools/build/options/WITHOUT_CASPER 258838 2013-12-02 08:21:28Z pjd
232 Set to not build Casper program and related libraries.
233 .It Va WITHOUT_CCD
234 .\" from FreeBSD: head/tools/build/options/WITHOUT_CCD 277678 2015-01-25 04:52:48Z ngie
235 Set to not build
236 .Xr geom_ccd 4
237 and related utilities.
238 .It Va WITHOUT_CDDL
239 .\" from FreeBSD: head/tools/build/options/WITHOUT_CDDL 163861 2006-11-01 09:02:11Z jb
240 Set to not build code licensed under Sun's CDDL.
241 When set, it also enforces the following options:
242 .Pp
243 .Bl -item -compact
244 .It
245 .Va WITHOUT_CTF
246 .It
247 .Va WITHOUT_ZFS
248 .El
249 .It Va WITHOUT_CLANG
250 .\" from FreeBSD: head/tools/build/options/WITHOUT_CLANG 264660 2014-04-18 17:03:58Z imp
251 Set to not build the Clang C/C++ compiler during the regular phase of the build.
252 .Pp
253 It is a default setting on
254 mips/mipsel, mips/mips, mips/mips64el, mips/mips64, mips/mipsn32 and sparc64/sparc64.
255 When set, it also enforces the following options:
256 .Pp
257 .Bl -item -compact
258 .It
259 .Va WITHOUT_CLANG_EXTRAS
260 .It
261 .Va WITHOUT_CLANG_FULL
262 .El
263 .It Va WITH_CLANG
264 .\" from FreeBSD: head/tools/build/options/WITH_CLANG 264660 2014-04-18 17:03:58Z imp
265 Set to build the Clang C/C++ compiler during the normal phase of the build.
266 .Pp
267 It is a default setting on
268 amd64/amd64, arm/arm, arm/armeb, arm/armv6, arm/armv6hf, arm64/aarch64, i386/i386, pc98/i386, powerpc/powerpc and powerpc/powerpc64.
269 .It Va WITHOUT_CLANG_BOOTSTRAP
270 .\" from FreeBSD: head/tools/build/options/WITHOUT_CLANG_BOOTSTRAP 273177 2014-10-16 18:28:11Z skreuzer
271 Set to not build the Clang C/C++ compiler during the bootstrap phase of the build.
272 You must enable either gcc or clang bootstrap to be able to build the system,
273 unless an alternative compiler is provided via
274 XCC.
275 .Pp
276 It is a default setting on
277 mips/mipsel, mips/mips, mips/mips64el, mips/mips64, mips/mipsn32, powerpc/powerpc, powerpc/powerpc64 and sparc64/sparc64.
278 .It Va WITH_CLANG_BOOTSTRAP
279 .\" from FreeBSD: head/tools/build/options/WITH_CLANG_BOOTSTRAP 264660 2014-04-18 17:03:58Z imp
280 Set to build the Clang C/C++ compiler during the bootstrap phase of the build.
281 .Pp
282 It is a default setting on
283 amd64/amd64, arm/arm, arm/armeb, arm/armv6, arm/armv6hf, arm64/aarch64, i386/i386 and pc98/i386.
284 .It Va WITH_CLANG_EXTRAS
285 .\" from FreeBSD: head/tools/build/options/WITH_CLANG_EXTRAS 231057 2012-02-05 23:56:22Z dim
286 Set to build additional clang and llvm tools, such as bugpoint.
287 .It Va WITHOUT_CLANG_FULL
288 .\" from FreeBSD: head/tools/build/options/WITHOUT_CLANG_FULL 246259 2013-02-02 22:28:29Z dim
289 Set to avoid building the ARCMigrate, Rewriter and StaticAnalyzer components of
290 the Clang C/C++ compiler.
291 .Pp
292 It is a default setting on
293 mips/mipsel, mips/mips, mips/mips64el, mips/mips64, mips/mipsn32 and sparc64/sparc64.
294 .It Va WITH_CLANG_FULL
295 .\" from FreeBSD: head/tools/build/options/WITH_CLANG_FULL 246259 2013-02-02 22:28:29Z dim
296 Set to build the ARCMigrate, Rewriter and StaticAnalyzer components of the
297 Clang C/C++ compiler.
298 .Pp
299 It is a default setting on
300 amd64/amd64, arm/arm, arm/armeb, arm/armv6, arm/armv6hf, arm64/aarch64, i386/i386, pc98/i386, powerpc/powerpc and powerpc/powerpc64.
301 .It Va WITHOUT_CLANG_IS_CC
302 .\" from FreeBSD: head/tools/build/options/WITHOUT_CLANG_IS_CC 242629 2012-11-05 21:53:23Z brooks
303 Set to install the GCC compiler as
304 .Pa /usr/bin/cc ,
305 .Pa /usr/bin/c++
306 and
307 .Pa /usr/bin/cpp .
308 .Pp
309 It is a default setting on
310 mips/mipsel, mips/mips, mips/mips64el, mips/mips64, mips/mipsn32, powerpc/powerpc, powerpc/powerpc64 and sparc64/sparc64.
311 .It Va WITH_CLANG_IS_CC
312 .\" from FreeBSD: head/tools/build/options/WITH_CLANG_IS_CC 235342 2012-05-12 16:12:36Z gjb
313 Set to install the Clang C/C++ compiler as
314 .Pa /usr/bin/cc ,
315 .Pa /usr/bin/c++
316 and
317 .Pa /usr/bin/cpp .
318 .Pp
319 It is a default setting on
320 amd64/amd64, arm/arm, arm/armeb, arm/armv6, arm/armv6hf, arm64/aarch64, i386/i386 and pc98/i386.
321 .It Va WITHOUT_CPP
322 .\" from FreeBSD: head/tools/build/options/WITHOUT_CPP 156932 2006-03-21 07:50:50Z ru
323 Set to not build
324 .Xr cpp 1 .
325 .It Va WITHOUT_CROSS_COMPILER
326 .\" from FreeBSD: head/tools/build/options/WITHOUT_CROSS_COMPILER 275138 2014-11-26 20:43:09Z gjb
327 Set to not build any cross compiler in the cross-tools stage of buildworld.
328 If you are compiling a different version of
329 .Fx
330 than what is installed on the system, you will need to provide an alternate
331 compiler with XCC to ensure success.
332 If you are compiling with an identical version of
333 .Fx
334 to the host, this option may be safely used.
335 This option may also be safe when the host version of
336 .Fx
337 is close to the sources being built, but all bets are off if there have
338 been any changes to the toolchain between the versions.
339 When set, it also enforces the following options:
340 .Pp
341 .Bl -item -compact
342 .It
343 .Va WITHOUT_BINUTILS_BOOTSTRAP
344 .It
345 .Va WITHOUT_CLANG_BOOTSTRAP
346 .It
347 .Va WITHOUT_ELFTOOLCHAIN_BOOTSTRAP
348 .It
349 .Va WITHOUT_GCC_BOOTSTRAP
350 .El
351 .It Va WITHOUT_CRYPT
352 .\" from FreeBSD: head/tools/build/options/WITHOUT_CRYPT 156932 2006-03-21 07:50:50Z ru
353 Set to not build any crypto code.
354 When set, it also enforces the following options:
355 .Pp
356 .Bl -item -compact
357 .It
358 .Va WITHOUT_KERBEROS
359 .It
360 .Va WITHOUT_KERBEROS_SUPPORT
361 .It
362 .Va WITHOUT_OPENSSH
363 .It
364 .Va WITHOUT_OPENSSL
365 .El
366 .Pp
367 When set, the following options are also in effect:
368 .Pp
369 .Bl -inset -compact
370 .It Va WITHOUT_GSSAPI
371 (unless
372 .Va WITH_GSSAPI
373 is set explicitly)
374 .El
375 .It Va WITH_CTF
376 .\" from FreeBSD: head/tools/build/options/WITH_CTF 228159 2011-11-30 18:22:44Z fjoe
377 Set to compile with CTF (Compact C Type Format) data.
378 CTF data encapsulates a reduced form of debugging information
379 similar to DWARF and the venerable stabs and is required for DTrace.
380 .It Va WITHOUT_CTM
381 .\" from FreeBSD: head/tools/build/options/WITHOUT_CTM 183242 2008-09-21 22:02:26Z sam
382 Set to not build
383 .Xr ctm 1
384 and related utilities.
385 .It Va WITHOUT_CUSE
386 .\" from FreeBSD: head/tools/build/options/WITHOUT_CUSE 270171 2014-08-19 15:40:26Z hselasky
387 Set to not build CUSE-related programs and libraries.
388 .It Va WITHOUT_CXX
389 .\" from FreeBSD: head/tools/build/options/WITHOUT_CXX 281053 2015-04-03 23:55:04Z bdrewery
390 Set to not build
391 .Xr c++ 1
392 and related libraries.
393 It will also prevent building of
394 .Xr gperf 1
395 and
396 .Xr devd 8 .
397 When set, it also enforces the following options:
398 .Pp
399 .Bl -item -compact
400 .It
401 .Va WITHOUT_CLANG
402 .It
403 .Va WITHOUT_CLANG_EXTRAS
404 .It
405 .Va WITHOUT_CLANG_FULL
406 .It
407 .Va WITHOUT_GNUCXX
408 .It
409 .Va WITHOUT_GROFF
410 .El
411 .It Va WITH_DEBUG_FILES
412 .\" from FreeBSD: head/tools/build/options/WITH_DEBUG_FILES 251512 2013-06-07 21:40:02Z emaste
413 Set to strip debug info into a separate file for each executable binary
414 and shared library.
415 The debug files will be placed in a subdirectory of
416 .Pa /usr/lib/debug
417 and are located automatically by
418 .Xr gdb 1 .
419 .It Va WITHOUT_DICT
420 .\" from FreeBSD: head/tools/build/options/WITHOUT_DICT 156932 2006-03-21 07:50:50Z ru
421 Set to not build the Webster dictionary files.
422 .It Va WITH_DIRDEPS_CACHE
423 .\" from FreeBSD: head/tools/build/options/WITH_DIRDEPS_CACHE 284708 2015-06-22 20:21:57Z sjg
424 Cache result of dirdeps.mk which can save significant time
425 for subsequent builds.
426 Depends on
427 .Va WITH_META_MODE .
428 .Pp
429 This must be set in the environment, make command line, or
430 .Pa /etc/src-env.conf ,
431 not
432 .Pa /etc/src.conf .
433 .It Va WITHOUT_DMAGENT
434 .\" from FreeBSD: head/tools/build/options/WITHOUT_DMAGENT 262335 2014-02-22 13:05:23Z bapt
435 Set to not build dma Mail Transport Agent
436 .It Va WITHOUT_DOCCOMPRESS
437 .\" from FreeBSD: head/tools/build/options/WITHOUT_DOCCOMPRESS 266752 2014-05-27 15:52:27Z gjb
438 Set to not to install compressed system documentation.
439 Only the uncompressed version will be installed.
440 .It Va WITH_DTRACE_TESTS
441 .\" from FreeBSD: head/tools/build/options/WITH_DTRACE_TESTS 286174 2015-08-02 00:37:33Z markj
442 Set to build and install the DTrace test suite in
443 .Pa /usr/tests/cddl/usr.sbin/dtrace .
444 This test suite is considered experimental on architectures other than
445 amd64/amd64 and running it may cause system instability.
446 .It Va WITHOUT_DYNAMICROOT
447 .\" from FreeBSD: head/tools/build/options/WITHOUT_DYNAMICROOT 156932 2006-03-21 07:50:50Z ru
448 Set this if you do not want to link
449 .Pa /bin
450 and
451 .Pa /sbin
452 dynamically.
453 .It Va WITHOUT_ED_CRYPTO
454 .\" from FreeBSD: head/tools/build/options/WITHOUT_ED_CRYPTO 235660 2012-05-19 20:05:27Z marcel
455 Set to build
456 .Xr ed 1
457 without support for encryption/decryption.
458 .It Va WITHOUT_EE
459 .\" from FreeBSD: head/tools/build/options/WITHOUT_EE 277663 2015-01-25 00:03:44Z ngie
460 Set to not build and install
461 .Xr edit 1 ,
462 .Xr ee 1 ,
463 and related programs.
464 .It Va WITH_EISA
465 .\" from FreeBSD: head/tools/build/options/WITH_EISA 264654 2014-04-18 16:53:06Z imp
466 Set to build EISA kernel modules.
467 .It Va WITHOUT_ELFCOPY_AS_OBJCOPY
468 .\" from FreeBSD: head/tools/build/options/WITHOUT_ELFCOPY_AS_OBJCOPY 286030 2015-07-29 18:45:38Z emaste
469 Set to build and install
470 .Xr objcopy 1
471 from GNU Binutils, instead of the one from ELF Tool Chain.
472 .Pp
473 It is a default setting on
474 amd64/amd64, arm/arm, arm/armeb, arm/armv6, arm/armv6hf, i386/i386, mips/mipsel, mips/mips, mips/mips64el, mips/mips64, mips/mipsn32, pc98/i386, powerpc/powerpc, powerpc/powerpc64 and sparc64/sparc64.
475 .It Va WITH_ELFCOPY_AS_OBJCOPY
476 .\" from FreeBSD: head/tools/build/options/WITH_ELFCOPY_AS_OBJCOPY 286030 2015-07-29 18:45:38Z emaste
477 Set to build and install ELF Tool Chain's elfcopy as
478 .Xr objcopy 1 ,
479 instead of the one from GNU Binutils.
480 .Pp
481 It is a default setting on
482 arm64/aarch64.
483 .It Va WITHOUT_EXAMPLES
484 .\" from FreeBSD: head/tools/build/options/WITHOUT_EXAMPLES 156938 2006-03-21 09:06:24Z ru
485 Set to avoid installing examples to
486 .Pa /usr/share/examples/ .
487 .It Va WITHOUT_FDT
488 .\" from FreeBSD: head/tools/build/options/WITHOUT_FDT 221539 2011-05-06 19:10:27Z ru
489 Set to not build Flattened Device Tree support as part of the base system.
490 This includes the device tree compiler (dtc) and libfdt support library.
491 .It Va WITHOUT_FILE
492 .\" from FreeBSD: head/tools/build/options/WITHOUT_FILE 278193 2015-02-04 10:24:40Z ngie
493 Set to not build
494 .Xr file 1
495 and related programs.
496 .It Va WITHOUT_FINGER
497 .\" from FreeBSD: head/tools/build/options/WITHOUT_FINGER 278192 2015-02-04 10:19:32Z ngie
498 Set to not build or install
499 .Xr finger 1
500 and
501 .Xr fingerd 8 .
502 .It Va WITHOUT_FLOPPY
503 .\" from FreeBSD: head/tools/build/options/WITHOUT_FLOPPY 221540 2011-05-06 19:13:03Z ru
504 Set to not build or install programs
505 for operating floppy disk driver.
506 .It Va WITHOUT_FMTREE
507 .\" from FreeBSD: head/tools/build/options/WITHOUT_FMTREE 261299 2014-01-30 21:37:43Z brooks
508 Set to not build and install
509 .Pa /usr/sbin/fmtree .
510 .It Va WITHOUT_FORMAT_EXTENSIONS
511 .\" from FreeBSD: head/tools/build/options/WITHOUT_FORMAT_EXTENSIONS 250658 2013-05-15 13:04:10Z brooks
512 Set to not enable
513 .Fl fformat-extensions
514 when compiling the kernel.
515 Also disables all format checking.
516 .It Va WITHOUT_FORTH
517 .\" from FreeBSD: head/tools/build/options/WITHOUT_FORTH 156932 2006-03-21 07:50:50Z ru
518 Set to build bootloaders without Forth support.
519 .It Va WITHOUT_FP_LIBC
520 .\" from FreeBSD: head/tools/build/options/WITHOUT_FP_LIBC 156932 2006-03-21 07:50:50Z ru
521 Set to build
522 .Nm libc
523 without floating-point support.
524 .It Va WITHOUT_FREEBSD_UPDATE
525 .\" from FreeBSD: head/tools/build/options/WITHOUT_FREEBSD_UPDATE 183242 2008-09-21 22:02:26Z sam
526 Set to not build
527 .Xr freebsd-update 8 .
528 .It Va WITHOUT_FTP
529 .\" from FreeBSD: head/tools/build/options/WITHOUT_FTP 278192 2015-02-04 10:19:32Z ngie
530 Set to not build or install
531 .Xr ftp 1
532 and
533 .Xr ftpd 8 .
534 .It Va WITHOUT_GAMES
535 .\" from FreeBSD: head/tools/build/options/WITHOUT_GAMES 156932 2006-03-21 07:50:50Z ru
536 Set to not build games.
537 .It Va WITHOUT_GCC
538 .\" from FreeBSD: head/tools/build/options/WITHOUT_GCC 264660 2014-04-18 17:03:58Z imp
539 Set to not build and install gcc and g++ as part of the normal build process.
540 .Pp
541 It is a default setting on
542 amd64/amd64, arm/arm, arm/armeb, arm/armv6, arm/armv6hf, arm64/aarch64, i386/i386 and pc98/i386.
543 .It Va WITH_GCC
544 .\" from FreeBSD: head/tools/build/options/WITH_GCC 255326 2013-09-06 20:49:48Z zeising
545 Set to build and install gcc and g++.
546 .Pp
547 It is a default setting on
548 mips/mipsel, mips/mips, mips/mips64el, mips/mips64, mips/mipsn32, powerpc/powerpc, powerpc/powerpc64 and sparc64/sparc64.
549 .It Va WITHOUT_GCC_BOOTSTRAP
550 .\" from FreeBSD: head/tools/build/options/WITHOUT_GCC_BOOTSTRAP 273177 2014-10-16 18:28:11Z skreuzer
551 Set to not build gcc and g++ as part of the bootstrap process.
552 You must enable either gcc or clang bootstrap to be able to build the system,
553 unless an alternative compiler is provided via
554 XCC.
555 .Pp
556 It is a default setting on
557 amd64/amd64, arm/arm, arm/armeb, arm/armv6, arm/armv6hf, arm64/aarch64, i386/i386 and pc98/i386.
558 .It Va WITH_GCC_BOOTSTRAP
559 .\" from FreeBSD: head/tools/build/options/WITH_GCC_BOOTSTRAP 264660 2014-04-18 17:03:58Z imp
560 Set to build gcc and g++ as part of the bootstrap process.
561 .Pp
562 It is a default setting on
563 mips/mipsel, mips/mips, mips/mips64el, mips/mips64, mips/mipsn32, powerpc/powerpc, powerpc/powerpc64 and sparc64/sparc64.
564 .It Va WITHOUT_GCOV
565 .\" from FreeBSD: head/tools/build/options/WITHOUT_GCOV 156932 2006-03-21 07:50:50Z ru
566 Set to not build the
567 .Xr gcov 1
568 tool.
569 .It Va WITHOUT_GDB
570 .\" from FreeBSD: head/tools/build/options/WITHOUT_GDB 156932 2006-03-21 07:50:50Z ru
571 Set to not build
572 .Xr gdb 1 .
573 .Pp
574 It is a default setting on
575 arm64/aarch64.
576 .It Va WITHOUT_GNU
577 .\" from FreeBSD: head/tools/build/options/WITHOUT_GNU 174550 2007-12-12 16:43:17Z ru
578 Set to not build contributed GNU software as a part of the base system.
579 This option can be useful if the system built must not contain any code
580 covered by the GNU Public License due to legal reasons.
581 .Bf -symbolic
582 The option has no effect yet.
583 .Ef
584 When set, it also enforces the following options:
585 .Pp
586 .Bl -item -compact
587 .It
588 .Va WITHOUT_GNU_SUPPORT
589 .El
590 .It Va WITHOUT_GNUCXX
591 .\" from FreeBSD: head/tools/build/options/WITHOUT_GNUCXX 255321 2013-09-06 20:08:03Z theraven
592 Do not build the GNU C++ stack (g++, libstdc++).
593 This is the default on platforms where clang is the system compiler.
594 .Pp
595 It is a default setting on
596 amd64/amd64, arm/arm, arm/armeb, arm/armv6, arm/armv6hf, arm64/aarch64, i386/i386 and pc98/i386.
597 .It Va WITH_GNUCXX
598 .\" from FreeBSD: head/tools/build/options/WITH_GNUCXX 255321 2013-09-06 20:08:03Z theraven
599 Build the GNU C++ stack (g++, libstdc++).
600 This is the default on platforms where gcc is the system compiler.
601 .Pp
602 It is a default setting on
603 mips/mipsel, mips/mips, mips/mips64el, mips/mips64, mips/mipsn32, powerpc/powerpc, powerpc/powerpc64 and sparc64/sparc64.
604 .It Va WITHOUT_GNU_GREP_COMPAT
605 .\" from FreeBSD: head/tools/build/options/WITHOUT_GNU_GREP_COMPAT 273421 2014-10-21 20:44:33Z emaste
606 Set this option to omit the gnu extensions to grep from being included in
607 BSD grep.
608 .It Va WITHOUT_GNU_SUPPORT
609 .\" from FreeBSD: head/tools/build/options/WITHOUT_GNU_SUPPORT 156932 2006-03-21 07:50:50Z ru
610 Set to build some programs without optional GNU support.
611 .It Va WITHOUT_GPIO
612 .\" from FreeBSD: head/tools/build/options/WITHOUT_GPIO 228081 2011-11-28 17:54:34Z dim
613 Set to not build
614 .Xr gpioctl 8
615 as part of the base system.
616 .It Va WITHOUT_GPL_DTC
617 .\" from FreeBSD: head/tools/build/options/WITHOUT_GPL_DTC 264515 2014-04-15 20:41:55Z imp
618 Set to build the BSD licensed version of the device tree compiler, instead of the
619 GPL'd one from elinux.org.
620 .It Va WITHOUT_GROFF
621 .\" from FreeBSD: head/tools/build/options/WITHOUT_GROFF 218941 2011-02-22 08:13:49Z uqs
622 Set to not build
623 .Xr groff 1
624 and
625 .Xr vgrind 1 .
626 You should consider installing the textproc/groff port to not break
627 .Xr man 1 .
628 .It Va WITHOUT_GSSAPI
629 .\" from FreeBSD: head/tools/build/options/WITHOUT_GSSAPI 174548 2007-12-12 16:39:32Z ru
630 Set to not build libgssapi.
631 .It Va WITHOUT_HAST
632 .\" from FreeBSD: head/tools/build/options/WITHOUT_HAST 277725 2015-01-26 06:27:07Z ngie
633 Set to not build
634 .Xr hastd 8
635 and related utilities.
636 .It Va WITH_HESIOD
637 .\" from FreeBSD: head/tools/build/options/WITH_HESIOD 156932 2006-03-21 07:50:50Z ru
638 Set to build Hesiod support.
639 .It Va WITHOUT_HTML
640 .\" from FreeBSD: head/tools/build/options/WITHOUT_HTML 156932 2006-03-21 07:50:50Z ru
641 Set to not build HTML docs.
642 .It Va WITHOUT_HYPERV
643 .\" from FreeBSD: head/tools/build/options/WITHOUT_HYPERV 271493 2014-09-13 02:15:31Z delphij
644 Set to not build or install HyperV utilities.
645 .It Va WITHOUT_ICONV
646 .\" from FreeBSD: head/tools/build/options/WITHOUT_ICONV 254919 2013-08-26 17:15:56Z antoine
647 Set to not build iconv as part of libc.
648 .It Va WITHOUT_INCLUDES
649 .\" from FreeBSD: head/tools/build/options/WITHOUT_INCLUDES 275138 2014-11-26 20:43:09Z gjb
650 Set to not install header files.
651 This option used to be spelled
652 .Va NO_INCS .
653 .Bf -symbolic
654 The option does not work for build targets.
655 .Ef
656 .It Va WITHOUT_INET
657 .\" from FreeBSD: head/tools/build/options/WITHOUT_INET 221266 2011-04-30 17:58:28Z bz
658 Set to not build programs and libraries related to IPv4 networking.
659 When set, it also enforces the following options:
660 .Pp
661 .Bl -item -compact
662 .It
663 .Va WITHOUT_INET_SUPPORT
664 .El
665 .It Va WITHOUT_INET6
666 .\" from FreeBSD: head/tools/build/options/WITHOUT_INET6 156932 2006-03-21 07:50:50Z ru
667 Set to not build
668 programs and libraries related to IPv6 networking.
669 When set, it also enforces the following options:
670 .Pp
671 .Bl -item -compact
672 .It
673 .Va WITHOUT_INET6_SUPPORT
674 .El
675 .It Va WITHOUT_INET6_SUPPORT
676 .\" from FreeBSD: head/tools/build/options/WITHOUT_INET6_SUPPORT 156932 2006-03-21 07:50:50Z ru
677 Set to build libraries, programs, and kernel modules without IPv6 support.
678 .It Va WITHOUT_INETD
679 .\" from FreeBSD: head/tools/build/options/WITHOUT_INETD 278192 2015-02-04 10:19:32Z ngie
680 Set to not build
681 .Xr inetd 8 .
682 .It Va WITHOUT_INET_SUPPORT
683 .\" from FreeBSD: head/tools/build/options/WITHOUT_INET_SUPPORT 221266 2011-04-30 17:58:28Z bz
684 Set to build libraries, programs, and kernel modules without IPv4 support.
685 .It Va WITHOUT_INSTALLLIB
686 .\" from FreeBSD: head/tools/build/options/WITHOUT_INSTALLLIB 174497 2007-12-09 21:56:21Z dougb
687 Set this if you do not want to install optional libraries.
688 For example when creating a
689 .Xr nanobsd 8
690 image.
691 .It Va WITH_INSTALL_AS_USER
692 .\" from FreeBSD: head/tools/build/options/WITH_INSTALL_AS_USER 238021 2012-07-02 20:24:01Z marcel
693 Set to make install targets succeed for non-root users by installing
694 files with owner and group attributes set to that of the user running
695 the
696 .Xr make 1
697 command.
698 The user still has to set the
699 .Va DESTDIR
700 variable to point to a directory where the user has write permissions.
701 .It Va WITHOUT_IPFILTER
702 .\" from FreeBSD: head/tools/build/options/WITHOUT_IPFILTER 156932 2006-03-21 07:50:50Z ru
703 Set to not build IP Filter package.
704 .It Va WITHOUT_IPFW
705 .\" from FreeBSD: head/tools/build/options/WITHOUT_IPFW 183242 2008-09-21 22:02:26Z sam
706 Set to not build IPFW tools.
707 .It Va WITHOUT_ISCSI
708 .\" from FreeBSD: head/tools/build/options/WITHOUT_ISCSI 277675 2015-01-25 04:20:11Z ngie
709 Set to not build
710 .Xr iscid 8
711 and related utilities.
712 .It Va WITHOUT_JAIL
713 .\" from FreeBSD: head/tools/build/options/WITHOUT_JAIL 249966 2013-04-27 04:09:09Z eadler
714 Set to not build tools for the support of jails; e.g.,
715 .Xr jail 8 .
716 .It Va WITHOUT_KDUMP
717 .\" from FreeBSD: head/tools/build/options/WITHOUT_KDUMP 240690 2012-09-19 11:38:37Z zeising
718 Set to not build
719 .Xr kdump 1
720 and
721 .Xr truss 1 .
722 .It Va WITHOUT_KERBEROS
723 .\" from FreeBSD: head/tools/build/options/WITHOUT_KERBEROS 174549 2007-12-12 16:42:03Z ru
724 Set this if you do not want to build Kerberos 5 (KTH Heimdal).
725 When set, it also enforces the following options:
726 .Pp
727 .Bl -item -compact
728 .It
729 .Va WITHOUT_KERBEROS_SUPPORT
730 .El
731 .Pp
732 When set, the following options are also in effect:
733 .Pp
734 .Bl -inset -compact
735 .It Va WITHOUT_GSSAPI
736 (unless
737 .Va WITH_GSSAPI
738 is set explicitly)
739 .El
740 .It Va WITHOUT_KERBEROS_SUPPORT
741 .\" from FreeBSD: head/tools/build/options/WITHOUT_KERBEROS_SUPPORT 251794 2013-06-15 20:29:07Z eadler
742 Set to build some programs without Kerberos support, like
743 .Xr ssh 1 ,
744 .Xr telnet 1 ,
745 .Xr sshd 8 ,
746 and
747 .Xr telnetd 8 .
748 .It Va WITHOUT_KERNEL_SYMBOLS
749 .\" from FreeBSD: head/tools/build/options/WITHOUT_KERNEL_SYMBOLS 222189 2011-05-22 18:23:17Z imp
750 Set to not install kernel symbol files.
751 .Bf -symbolic
752 This option is recommended for those people who have small root partitions.
753 .Ef
754 .It Va WITHOUT_KVM
755 .\" from FreeBSD: head/tools/build/options/WITHOUT_KVM 174550 2007-12-12 16:43:17Z ru
756 Set to not build the
757 .Nm libkvm
758 library as a part of the base system.
759 .Bf -symbolic
760 The option has no effect yet.
761 .Ef
762 When set, it also enforces the following options:
763 .Pp
764 .Bl -item -compact
765 .It
766 .Va WITHOUT_KVM_SUPPORT
767 .El
768 .It Va WITHOUT_KVM_SUPPORT
769 .\" from FreeBSD: head/tools/build/options/WITHOUT_KVM_SUPPORT 170644 2007-06-13 02:08:04Z sepotvin
770 Set to build some programs without optional
771 .Nm libkvm
772 support.
773 .It Va WITHOUT_LDNS
774 .\" from FreeBSD: head/tools/build/options/WITHOUT_LDNS 255591 2013-09-15 13:11:13Z des
775 Setting this variable will prevent the LDNS library from being built.
776 When set, it also enforces the following options:
777 .Pp
778 .Bl -item -compact
779 .It
780 .Va WITHOUT_LDNS_UTILS
781 .It
782 .Va WITHOUT_UNBOUND
783 .El
784 .It Va WITHOUT_LDNS_UTILS
785 .\" from FreeBSD: head/tools/build/options/WITHOUT_LDNS_UTILS 255850 2013-09-24 14:33:31Z des
786 Setting this variable will prevent building the LDNS utilities
787 .Xr drill 1
788 and
789 .Xr host 1 .
790 .It Va WITHOUT_LEGACY_CONSOLE
791 .\" from FreeBSD: head/tools/build/options/WITHOUT_LEGACY_CONSOLE 249966 2013-04-27 04:09:09Z eadler
792 Set to not build programs that support a legacy PC console; e.g.,
793 .Xr kbdcontrol 8
794 and
795 .Xr vidcontrol 8 .
796 .It Va WITHOUT_LIB32
797 .\" from FreeBSD: head/tools/build/options/WITHOUT_LIB32 274664 2014-11-18 17:06:48Z imp
798 On 64-bit platforms, set to not build 32-bit library set and a
799 .Nm ld-elf32.so.1
800 runtime linker.
801 .It Va WITHOUT_LIBCPLUSPLUS
802 .\" from FreeBSD: head/tools/build/options/WITHOUT_LIBCPLUSPLUS 246262 2013-02-02 22:42:46Z dim
803 Set to avoid building libcxxrt and libc++.
804 .It Va WITHOUT_LIBPTHREAD
805 .\" from FreeBSD: head/tools/build/options/WITHOUT_LIBPTHREAD 188848 2009-02-20 11:09:55Z mtm
806 Set to not build the
807 .Nm libpthread
808 providing library,
809 .Nm libthr .
810 When set, it also enforces the following options:
811 .Pp
812 .Bl -item -compact
813 .It
814 .Va WITHOUT_LIBTHR
815 .El
816 .It Va WITHOUT_LIBTHR
817 .\" from FreeBSD: head/tools/build/options/WITHOUT_LIBTHR 156932 2006-03-21 07:50:50Z ru
818 Set to not build the
819 .Nm libthr
820 (1:1 threading)
821 library.
822 .It Va WITH_LLDB
823 .\" from FreeBSD: head/tools/build/options/WITH_LLDB 255722 2013-09-20 01:52:02Z emaste
824 Set to build the LLDB debugger.
825 .It Va WITHOUT_LOCALES
826 .\" from FreeBSD: head/tools/build/options/WITHOUT_LOCALES 156932 2006-03-21 07:50:50Z ru
827 Set to not build localization files; see
828 .Xr locale 1 .
829 .It Va WITHOUT_LOCATE
830 .\" from FreeBSD: head/tools/build/options/WITHOUT_LOCATE 183242 2008-09-21 22:02:26Z sam
831 Set to not build
832 .Xr locate 1
833 and related programs.
834 .It Va WITHOUT_LPR
835 .\" from FreeBSD: head/tools/build/options/WITHOUT_LPR 156932 2006-03-21 07:50:50Z ru
836 Set to not build
837 .Xr lpr 1
838 and related programs.
839 .It Va WITHOUT_LS_COLORS
840 .\" from FreeBSD: head/tools/build/options/WITHOUT_LS_COLORS 235660 2012-05-19 20:05:27Z marcel
841 Set to build
842 .Xr ls 1
843 without support for colors to distinguish file types.
844 .It Va WITHOUT_LZMA_SUPPORT
845 .\" from FreeBSD: head/tools/build/options/WITHOUT_LZMA_SUPPORT 245171 2013-01-08 18:37:12Z obrien
846 Set to build some programs without optional lzma compression support.
847 .It Va WITHOUT_MAIL
848 .\" from FreeBSD: head/tools/build/options/WITHOUT_MAIL 183242 2008-09-21 22:02:26Z sam
849 Set to not build any mail support (MUA or MTA).
850 When set, it also enforces the following options:
851 .Pp
852 .Bl -item -compact
853 .It
854 .Va WITHOUT_DMAGENT
855 .It
856 .Va WITHOUT_MAILWRAPPER
857 .It
858 .Va WITHOUT_SENDMAIL
859 .El
860 .It Va WITHOUT_MAILWRAPPER
861 .\" from FreeBSD: head/tools/build/options/WITHOUT_MAILWRAPPER 156932 2006-03-21 07:50:50Z ru
862 Set to not build the
863 .Xr mailwrapper 8
864 MTA selector.
865 .It Va WITHOUT_MAKE
866 .\" from FreeBSD: head/tools/build/options/WITHOUT_MAKE 183242 2008-09-21 22:02:26Z sam
867 Set to not install
868 .Xr make 1
869 and related support files.
870 .It Va WITHOUT_MAN
871 .\" from FreeBSD: head/tools/build/options/WITHOUT_MAN 156932 2006-03-21 07:50:50Z ru
872 Set to not build manual pages.
873 When set, the following options are also in effect:
874 .Pp
875 .Bl -inset -compact
876 .It Va WITHOUT_MAN_UTILS
877 (unless
878 .Va WITH_MAN_UTILS
879 is set explicitly)
880 .El
881 .It Va WITHOUT_MANCOMPRESS
882 .\" from FreeBSD: head/tools/build/options/WITHOUT_MANCOMPRESS 266752 2014-05-27 15:52:27Z gjb
883 Set to not to install compressed man pages.
884 Only the uncompressed versions will be installed.
885 .It Va WITHOUT_MANDOCDB
886 .\" from FreeBSD: head/tools/build/options/WITHOUT_MANDOCDB 283777 2015-05-30 17:41:37Z bapt
887 Use the
888 .Xr mandoc 1
889 version of
890 .Xr makewhatis 8
891 database and utilities.
892 .It Va WITHOUT_MAN_UTILS
893 .\" from FreeBSD: head/tools/build/options/WITHOUT_MAN_UTILS 208322 2010-05-20 00:07:21Z jkim
894 Set to not build utilities for manual pages,
895 .Xr apropos 1 ,
896 .Xr catman 1 ,
897 .Xr makewhatis 1 ,
898 .Xr man 1 ,
899 .Xr whatis 1 ,
900 .Xr manctl 8 ,
901 and related support files.
902 .It Va WITH_META_FILES
903 .\" from FreeBSD: head/tools/build/options/WITH_META_FILES 284708 2015-06-22 20:21:57Z sjg
904 Create meta files during non META_MODE build.
905 The meta files can be useful for debugging.
906 .Pp
907 This must be set in the environment, make command line, or
908 .Pa /etc/src-env.conf ,
909 not
910 .Pa /etc/src.conf .
911 .It Va WITH_META_MODE
912 .\" from FreeBSD: head/tools/build/options/WITH_META_MODE 287973 2015-09-18 22:22:32Z bdrewery
913 Enable building in meta mode.
914 This is an experimental build feature.
915 For details see
916 http://www.crufty.net/sjg/docs/freebsd-meta-mode.htm.
917 .Pp
918 The build is driven by dirdeps.mk using
919 .Va DIRDEPS
920 stored in
921 Makefile.depend files found in each directory.
922 .Pp
923 The build can be started from anywhere, and behaves the same.
924 The initial instance of
925 .Xr make 1 
926 recursively reads
927 .Va DIRDEPS
928 from Makefile.depend
929 computing a graph of tree dependencies from the current origin.
930 Setting
931 .Va NO_DIRDEPS
932 will skip checking dirdep dependencies and will only build in the current
933 directory.
934 .Pp
935 As each target is made
936 .Xr make 1
937 produces a meta file which is used to capture (and compare)
938 the command line,
939 as well as any command output.
940 If
941 .Xr filemon 4
942 is available the meta file will also capture a record of files
943 used to produce the target by tracking syscalls.
944 .Pp
945 The build will hide commands ran unless
946 .Va NO_SILENT
947 is defined.
948 .Pp
949 When set, it also enforces the following options:
950 .Pp
951 .Bl -item -compact
952 .It
953 .Va WITH_INSTALL_AS_USER
954 .El
955 .Pp
956 When set, the following options are also in effect:
957 .Pp
958 .Bl -inset -compact
959 .It Va WITH_AUTO_OBJ
960 (unless
961 .Va WITHOUT_AUTO_OBJ
962 is set explicitly)
963 .It Va WITH_STAGING
964 (unless
965 .Va WITHOUT_STAGING
966 is set explicitly)
967 .It Va WITH_STAGING_MAN
968 (unless
969 .Va WITHOUT_STAGING_MAN
970 is set explicitly)
971 .It Va WITH_STAGING_PROG
972 (unless
973 .Va WITHOUT_STAGING_PROG
974 is set explicitly)
975 .It Va WITH_SYSROOT
976 (unless
977 .Va WITHOUT_SYSROOT
978 is set explicitly)
979 .El
980 .Pp
981 This must be set in the environment, make command line, or
982 .Pa /etc/src-env.conf ,
983 not
984 .Pa /etc/src.conf .
985 .It Va WITH_NAND
986 .\" from FreeBSD: head/tools/build/options/WITH_NAND 235537 2012-05-17 10:11:18Z gber
987 Set to build the NAND Flash components.
988 .It Va WITHOUT_NDIS
989 .\" from FreeBSD: head/tools/build/options/WITHOUT_NDIS 183242 2008-09-21 22:02:26Z sam
990 Set to not build programs and libraries
991 related to NDIS emulation support.
992 .It Va WITHOUT_NETCAT
993 .\" from FreeBSD: head/tools/build/options/WITHOUT_NETCAT 156932 2006-03-21 07:50:50Z ru
994 Set to not build
995 .Xr nc 1
996 utility.
997 .It Va WITHOUT_NETGRAPH
998 .\" from FreeBSD: head/tools/build/options/WITHOUT_NETGRAPH 183242 2008-09-21 22:02:26Z sam
999 Set to not build applications to support
1000 .Xr netgraph 4 .
1001 When set, it also enforces the following options:
1002 .Pp
1003 .Bl -item -compact
1004 .It
1005 .Va WITHOUT_ATM
1006 .It
1007 .Va WITHOUT_BLUETOOTH
1008 .It
1009 .Va WITHOUT_NETGRAPH_SUPPORT
1010 .El
1011 .It Va WITHOUT_NETGRAPH_SUPPORT
1012 .\" from FreeBSD: head/tools/build/options/WITHOUT_NETGRAPH_SUPPORT 183305 2008-09-23 16:11:15Z sam
1013 Set to build libraries, programs, and kernel modules without netgraph support.
1014 .It Va WITHOUT_NIS
1015 .\" from FreeBSD: head/tools/build/options/WITHOUT_NIS 156932 2006-03-21 07:50:50Z ru
1016 Set to not build
1017 .Xr NIS 8
1018 support and related programs.
1019 If set, you might need to adopt your
1020 .Xr nsswitch.conf 5
1021 and remove
1022 .Sq nis
1023 entries.
1024 .It Va WITHOUT_NLS
1025 .\" from FreeBSD: head/tools/build/options/WITHOUT_NLS 156932 2006-03-21 07:50:50Z ru
1026 Set to not build NLS catalogs.
1027 .It Va WITHOUT_NLS_CATALOGS
1028 .\" from FreeBSD: head/tools/build/options/WITHOUT_NLS_CATALOGS 156932 2006-03-21 07:50:50Z ru
1029 Set to not build NLS catalog support for
1030 .Xr csh 1 .
1031 .It Va WITHOUT_NS_CACHING
1032 .\" from FreeBSD: head/tools/build/options/WITHOUT_NS_CACHING 172803 2007-10-19 14:01:25Z ru
1033 Set to disable name caching in the
1034 .Pa nsswitch
1035 subsystem.
1036 The generic caching daemon,
1037 .Xr nscd 8 ,
1038 will not be built either if this option is set.
1039 .It Va WITHOUT_NTP
1040 .\" from FreeBSD: head/tools/build/options/WITHOUT_NTP 183242 2008-09-21 22:02:26Z sam
1041 Set to not build
1042 .Xr ntpd 8
1043 and related programs.
1044 .It Va WITH_OFED
1045 .\" from FreeBSD: head/tools/build/options/WITH_OFED 228081 2011-11-28 17:54:34Z dim
1046 Set to build the
1047 .Dq "OpenFabrics Enterprise Distribution"
1048 Infiniband software stack.
1049 .It Va WITH_OPENLDAP
1050 .\" from FreeBSD: head/tools/build/options/WITH_OPENLDAP 264902 2014-04-24 23:17:31Z imp
1051 Enable building openldap support for kerberos.
1052 .It Va WITHOUT_OPENSSH
1053 .\" from FreeBSD: head/tools/build/options/WITHOUT_OPENSSH 156932 2006-03-21 07:50:50Z ru
1054 Set to not build OpenSSH.
1055 .It Va WITH_OPENSSH_NONE_CIPHER
1056 .\" from FreeBSD: head/tools/build/options/WITH_OPENSSH_NONE_CIPHER 245527 2013-01-17 01:51:04Z bz
1057 Set to include the "None" cipher support in OpenSSH and its libraries.
1058 Additional adjustments may need to be done to system configuration
1059 files, such as
1060 .Xr sshd_config 5 ,
1061 to enable this cipher.
1062 Please see
1063 .Pa /usr/src/crypto/openssh/README.hpn
1064 for full details.
1065 .It Va WITHOUT_OPENSSL
1066 .\" from FreeBSD: head/tools/build/options/WITHOUT_OPENSSL 156932 2006-03-21 07:50:50Z ru
1067 Set to not build OpenSSL.
1068 When set, it also enforces the following options:
1069 .Pp
1070 .Bl -item -compact
1071 .It
1072 .Va WITHOUT_KERBEROS
1073 .It
1074 .Va WITHOUT_KERBEROS_SUPPORT
1075 .It
1076 .Va WITHOUT_OPENSSH
1077 .El
1078 .Pp
1079 When set, the following options are also in effect:
1080 .Pp
1081 .Bl -inset -compact
1082 .It Va WITHOUT_GSSAPI
1083 (unless
1084 .Va WITH_GSSAPI
1085 is set explicitly)
1086 .El
1087 .It Va WITHOUT_PAM
1088 .\" from FreeBSD: head/tools/build/options/WITHOUT_PAM 174550 2007-12-12 16:43:17Z ru
1089 Set to not build PAM library and modules.
1090 .Bf -symbolic
1091 This option is deprecated and does nothing.
1092 .Ef
1093 When set, it also enforces the following options:
1094 .Pp
1095 .Bl -item -compact
1096 .It
1097 .Va WITHOUT_PAM_SUPPORT
1098 .El
1099 .It Va WITHOUT_PAM_SUPPORT
1100 .\" from FreeBSD: head/tools/build/options/WITHOUT_PAM_SUPPORT 156932 2006-03-21 07:50:50Z ru
1101 Set to build some programs without PAM support, particularly
1102 .Xr ftpd 8
1103 and
1104 .Xr ppp 8 .
1105 .It Va WITHOUT_PC_SYSINSTALL
1106 .\" from FreeBSD: head/tools/build/options/WITHOUT_PC_SYSINSTALL 245606 2013-01-18 15:57:09Z eadler
1107 Set to not build
1108 .Xr pc-sysinstall 8
1109 and related programs.
1110 .It Va WITHOUT_PF
1111 .\" from FreeBSD: head/tools/build/options/WITHOUT_PF 156932 2006-03-21 07:50:50Z ru
1112 Set to not build PF firewall package.
1113 When set, it also enforces the following options:
1114 .Pp
1115 .Bl -item -compact
1116 .It
1117 .Va WITHOUT_AUTHPF
1118 .El
1119 .It Va WITHOUT_PKGBOOTSTRAP
1120 .\" from FreeBSD: head/tools/build/options/WITHOUT_PKGBOOTSTRAP 258924 2013-12-04 15:58:42Z bdrewery
1121 Set to not build
1122 .Xr pkg 7
1123 bootstrap tool.
1124 .It Va WITHOUT_PMC
1125 .\" from FreeBSD: head/tools/build/options/WITHOUT_PMC 183242 2008-09-21 22:02:26Z sam
1126 Set to not build
1127 .Xr pmccontrol 8
1128 and related programs.
1129 .It Va WITHOUT_PORTSNAP
1130 .\" from FreeBSD: head/tools/build/options/WITHOUT_PORTSNAP 183242 2008-09-21 22:02:26Z sam
1131 Set to not build or install
1132 .Xr portsnap 8
1133 and related files.
1134 .It Va WITHOUT_PPP
1135 .\" from FreeBSD: head/tools/build/options/WITHOUT_PPP 183242 2008-09-21 22:02:26Z sam
1136 Set to not build
1137 .Xr ppp 8
1138 and related programs.
1139 .It Va WITHOUT_PROFILE
1140 .\" from FreeBSD: head/tools/build/options/WITHOUT_PROFILE 228196 2011-12-02 09:09:54Z fjoe
1141 Set to avoid compiling profiled libraries.
1142 .It Va WITHOUT_QUOTAS
1143 .\" from FreeBSD: head/tools/build/options/WITHOUT_QUOTAS 183242 2008-09-21 22:02:26Z sam
1144 Set to not build
1145 .Xr quota 8
1146 and related programs.
1147 .It Va WITHOUT_RADIUS_SUPPORT
1148 .\" from FreeBSD: head/tools/build/options/WITHOUT_RADIUS_SUPPORT 278182 2015-02-04 06:53:45Z ngie
1149 Set to not build radius support into various applications, like
1150 .Xr pam_radius 8
1151 and
1152 .Xr ppp 8 .
1153 .It Va WITHOUT_RBOOTD
1154 .\" from FreeBSD: head/tools/build/options/WITHOUT_RBOOTD 278192 2015-02-04 10:19:32Z ngie
1155 Set to not build or install
1156 .Xr rbootd 8 .
1157 .It Va WITHOUT_RCMDS
1158 .\" from FreeBSD: head/tools/build/options/WITHOUT_RCMDS 156932 2006-03-21 07:50:50Z ru
1159 Disable building of the
1160 .Bx
1161 r-commands.
1162 This includes
1163 .Xr rlogin 1 ,
1164 .Xr rsh 1 ,
1165 etc.
1166 .It Va WITHOUT_RCS
1167 .\" from FreeBSD: head/tools/build/options/WITHOUT_RCS 275138 2014-11-26 20:43:09Z gjb
1168 Set to not build
1169 .Xr rcs 1 ,
1170 .Xr etcupdate 8 ,
1171 and related utilities.
1172 .It Va WITHOUT_RESCUE
1173 .\" from FreeBSD: head/tools/build/options/WITHOUT_RESCUE 156932 2006-03-21 07:50:50Z ru
1174 Set to not build
1175 .Xr rescue 8 .
1176 .It Va WITHOUT_ROUTED
1177 .\" from FreeBSD: head/tools/build/options/WITHOUT_ROUTED 183242 2008-09-21 22:02:26Z sam
1178 Set to not build
1179 .Xr routed 8
1180 utility.
1181 .It Va WITHOUT_SENDMAIL
1182 .\" from FreeBSD: head/tools/build/options/WITHOUT_SENDMAIL 156932 2006-03-21 07:50:50Z ru
1183 Set to not build
1184 .Xr sendmail 8
1185 and related programs.
1186 .It Va WITHOUT_SETUID_LOGIN
1187 .\" from FreeBSD: head/tools/build/options/WITHOUT_SETUID_LOGIN 156932 2006-03-21 07:50:50Z ru
1188 Set this to disable the installation of
1189 .Xr login 1
1190 as a set-user-ID root program.
1191 .It Va WITHOUT_SHAREDOCS
1192 .\" from FreeBSD: head/tools/build/options/WITHOUT_SHAREDOCS 156932 2006-03-21 07:50:50Z ru
1193 Set to not build the
1194 .Bx 4.4
1195 legacy docs.
1196 .It Va WITH_SHARED_TOOLCHAIN
1197 .\" from FreeBSD: head/tools/build/options/WITH_SHARED_TOOLCHAIN 235342 2012-05-12 16:12:36Z gjb
1198 Set to build the toolchain binaries shared.
1199 The set includes
1200 .Xr cc 1 ,
1201 .Xr make 1
1202 and necessary utilities like assembler, linker and library archive manager.
1203 .It Va WITH_SORT_THREADS
1204 .\" from FreeBSD: head/tools/build/options/WITH_SORT_THREADS 264158 2014-04-05 18:00:45Z imp
1205 Set to enable threads in
1206 .Xr sort 1 .
1207 .It Va WITHOUT_SOURCELESS
1208 .\" from FreeBSD: head/tools/build/options/WITHOUT_SOURCELESS 230972 2012-02-04 00:54:43Z rmh
1209 Set to not build kernel modules that include sourceless code (either microcode or native code for host CPU).
1210 When set, it also enforces the following options:
1211 .Pp
1212 .Bl -item -compact
1213 .It
1214 .Va WITHOUT_SOURCELESS_HOST
1215 .It
1216 .Va WITHOUT_SOURCELESS_UCODE
1217 .El
1218 .It Va WITHOUT_SOURCELESS_HOST
1219 .\" from FreeBSD: head/tools/build/options/WITHOUT_SOURCELESS_HOST 230972 2012-02-04 00:54:43Z rmh
1220 Set to not build kernel modules that include sourceless native code for host CPU.
1221 .It Va WITHOUT_SOURCELESS_UCODE
1222 .\" from FreeBSD: head/tools/build/options/WITHOUT_SOURCELESS_UCODE 230972 2012-02-04 00:54:43Z rmh
1223 Set to not build kernel modules that include sourceless microcode.
1224 .It Va WITHOUT_SSP
1225 .\" from FreeBSD: head/tools/build/options/WITHOUT_SSP 180012 2008-06-25 21:33:28Z ru
1226 Set to not build world with propolice stack smashing protection.
1227 .It Va WITH_STAGING
1228 .\" from FreeBSD: head/tools/build/options/WITH_STAGING 284708 2015-06-22 20:21:57Z sjg
1229 Enable staging of files to a stage tree.
1230 This can be best thought of as auto-install to
1231 .Va DESTDIR
1232 with some extra meta data to ensure dependencies can be tracked.
1233 Depends on
1234 .Va WITH_META_MODE .
1235 When set, the following options are also in effect:
1236 .Pp
1237 .Bl -inset -compact
1238 .It Va WITH_STAGING_MAN
1239 (unless
1240 .Va WITHOUT_STAGING_MAN
1241 is set explicitly)
1242 .It Va WITH_STAGING_PROG
1243 (unless
1244 .Va WITHOUT_STAGING_PROG
1245 is set explicitly)
1246 .El
1247 .Pp
1248 This must be set in the environment, make command line, or
1249 .Pa /etc/src-env.conf ,
1250 not
1251 .Pa /etc/src.conf .
1252 .It Va WITH_STAGING_MAN
1253 .\" from FreeBSD: head/tools/build/options/WITH_STAGING_MAN 284708 2015-06-22 20:21:57Z sjg
1254 Enable staging of MAN pages to stage tree.
1255 .It Va WITH_STAGING_PROG
1256 .\" from FreeBSD: head/tools/build/options/WITH_STAGING_PROG 284708 2015-06-22 20:21:57Z sjg
1257 Enable staging of PROGs to stage tree.
1258 .It Va WITH_STALE_STAGED
1259 .\" from FreeBSD: head/tools/build/options/WITH_STALE_STAGED 284708 2015-06-22 20:21:57Z sjg
1260 Check staged files are not stale.
1261 .It Va WITH_SVN
1262 .\" from FreeBSD: head/tools/build/options/WITH_SVN 252561 2013-07-03 12:36:47Z zeising
1263 Set to install
1264 .Xr svnlite 1
1265 as
1266 .Xr svn 1 .
1267 .It Va WITHOUT_SVNLITE
1268 .\" from FreeBSD: head/tools/build/options/WITHOUT_SVNLITE 252561 2013-07-03 12:36:47Z zeising
1269 Set to not build
1270 .Xr svnlite 1
1271 and related programs.
1272 .It Va WITHOUT_SYMVER
1273 .\" from FreeBSD: head/tools/build/options/WITHOUT_SYMVER 169649 2007-05-17 05:03:24Z deischen
1274 Set to disable symbol versioning when building shared libraries.
1275 .It Va WITHOUT_SYSCONS
1276 .\" from FreeBSD: head/tools/build/options/WITHOUT_SYSCONS 156932 2006-03-21 07:50:50Z ru
1277 Set to not build
1278 .Xr syscons 4
1279 support files such as keyboard maps, fonts, and screen output maps.
1280 .It Va WITH_SYSROOT
1281 .\" from FreeBSD: head/tools/build/options/WITH_SYSROOT 284708 2015-06-22 20:21:57Z sjg
1282 Enable use of sysroot during build.
1283 Depends on
1284 .Va WITH_META_MODE .
1285 .Pp
1286 This must be set in the environment, make command line, or
1287 .Pa /etc/src-env.conf ,
1288 not
1289 .Pa /etc/src.conf .
1290 .It Va WITHOUT_TALK
1291 .\" from FreeBSD: head/tools/build/options/WITHOUT_TALK 277676 2015-01-25 04:37:44Z ngie
1292 Set to not build or install
1293 .Xr talk 1
1294 and
1295 .Xr talkd 8 .
1296 .It Va WITHOUT_TCP_WRAPPERS
1297 .\" from FreeBSD: head/tools/build/options/WITHOUT_TCP_WRAPPERS 278192 2015-02-04 10:19:32Z ngie
1298 Set to not build or install
1299 .Xr tcpd 8 ,
1300 and related utilities.
1301 .It Va WITHOUT_TCSH
1302 .\" from FreeBSD: head/tools/build/options/WITHOUT_TCSH 156932 2006-03-21 07:50:50Z ru
1303 Set to not build and install
1304 .Pa /bin/csh
1305 (which is
1306 .Xr tcsh 1 ) .
1307 .It Va WITHOUT_TELNET
1308 .\" from FreeBSD: head/tools/build/options/WITHOUT_TELNET 183242 2008-09-21 22:02:26Z sam
1309 Set to not build
1310 .Xr telnet 8
1311 and related programs.
1312 .It Va WITHOUT_TESTS
1313 .\" from FreeBSD: head/tools/build/options/WITHOUT_TESTS 268778 2014-07-16 21:40:11Z jmmv
1314 Set to not build nor install the
1315 .Fx
1316 Test Suite in
1317 .Pa /usr/tests/ .
1318 See
1319 .Xr tests 7
1320 for more details.
1321 This also disables the build of all test-related dependencies, including ATF.
1322 When set, it also enforces the following options:
1323 .Pp
1324 .Bl -item -compact
1325 .It
1326 .Va WITHOUT_DTRACE_TESTS
1327 .It
1328 .Va WITHOUT_TESTS_SUPPORT
1329 .El
1330 .It Va WITHOUT_TESTS_SUPPORT
1331 .\" from FreeBSD: head/tools/build/options/WITHOUT_TESTS_SUPPORT 274665 2014-11-18 17:06:50Z imp
1332 Set to disables the build of all test-related dependencies, including ATF.
1333 .It Va WITHOUT_TEXTPROC
1334 .\" from FreeBSD: head/tools/build/options/WITHOUT_TEXTPROC 183242 2008-09-21 22:02:26Z sam
1335 Set to not build
1336 programs used for text processing.
1337 When set, it also enforces the following options:
1338 .Pp
1339 .Bl -item -compact
1340 .It
1341 .Va WITHOUT_GROFF
1342 .El
1343 .It Va WITHOUT_TFTP
1344 .\" from FreeBSD: head/tools/build/options/WITHOUT_TFTP 278192 2015-02-04 10:19:32Z ngie
1345 Set to not build or install
1346 .Xr tftp 1
1347 and
1348 .Xr tftpd 8 .
1349 .It Va WITHOUT_TIMED
1350 .\" from FreeBSD: head/tools/build/options/WITHOUT_TIMED 278192 2015-02-04 10:19:32Z ngie
1351 Set to not build or install
1352 .Xr timed 8 .
1353 .It Va WITHOUT_TOOLCHAIN
1354 .\" from FreeBSD: head/tools/build/options/WITHOUT_TOOLCHAIN 273172 2014-10-16 15:55:13Z brooks
1355 Set to not install header or
1356 programs used for program development,
1357 compilers, debuggers etc.
1358 .Bf -symbolic
1359 The option does not work for build targets.
1360 .Ef
1361 When set, it also enforces the following options:
1362 .Pp
1363 .Bl -item -compact
1364 .It
1365 .Va WITHOUT_BINUTILS
1366 .It
1367 .Va WITHOUT_CLANG
1368 .It
1369 .Va WITHOUT_CLANG_EXTRAS
1370 .It
1371 .Va WITHOUT_CLANG_FULL
1372 .It
1373 .Va WITHOUT_GCC
1374 .It
1375 .Va WITHOUT_GDB
1376 .It
1377 .Va WITHOUT_INCLUDES
1378 .El
1379 .It Va WITHOUT_UNBOUND
1380 .\" from FreeBSD: head/tools/build/options/WITHOUT_UNBOUND 255597 2013-09-15 14:51:23Z des
1381 Set to not build
1382 .Xr unbound 8
1383 and related programs.
1384 .It Va WITHOUT_USB
1385 .\" from FreeBSD: head/tools/build/options/WITHOUT_USB 156932 2006-03-21 07:50:50Z ru
1386 Set to not build USB-related programs and libraries.
1387 .It Va WITHOUT_USB_GADGET_EXAMPLES
1388 .\" from FreeBSD: head/tools/build/options/WITHOUT_USB_GADGET_EXAMPLES 274665 2014-11-18 17:06:50Z imp
1389 Set to build USB gadget kernel modules.
1390 .It Va WITHOUT_UTMPX
1391 .\" from FreeBSD: head/tools/build/options/WITHOUT_UTMPX 231530 2012-02-11 20:28:42Z ed
1392 Set to not build user accounting tools such as
1393 .Xr last 1 ,
1394 .Xr users 1 ,
1395 .Xr who 1 ,
1396 .Xr ac 8 ,
1397 .Xr lastlogin 8
1398 and
1399 .Xr utx 8 .
1400 .It Va WITHOUT_VI
1401 .\" from FreeBSD: head/tools/build/options/WITHOUT_VI 264903 2014-04-24 23:17:40Z imp
1402 Set to not build and install vi, view, ex and related programs.
1403 .It Va WITHOUT_VT
1404 .\" from FreeBSD: head/tools/build/options/WITHOUT_VT 268022 2014-06-30 00:20:12Z emaste
1405 Set to not build
1406 .Xr vt 4
1407 support files (fonts and keymaps).
1408 .It Va WITHOUT_WARNS
1409 .\" from FreeBSD: head/tools/build/options/WITHOUT_WARNS 276559 2015-01-02 18:57:58Z bapt
1410 Set this to not add warning flags to the compiler invocations.
1411 Useful as a temporary workaround when code enters the tree
1412 which triggers warnings in environments that differ from the
1413 original developer.
1414 .It Va WITHOUT_WIRELESS
1415 .\" from FreeBSD: head/tools/build/options/WITHOUT_WIRELESS 183242 2008-09-21 22:02:26Z sam
1416 Set to not build programs used for 802.11 wireless networks; especially
1417 .Xr wpa_supplicant 8
1418 and
1419 .Xr hostapd 8 .
1420 When set, it also enforces the following options:
1421 .Pp
1422 .Bl -item -compact
1423 .It
1424 .Va WITHOUT_WIRELESS_SUPPORT
1425 .El
1426 .It Va WITHOUT_WIRELESS_SUPPORT
1427 .\" from FreeBSD: head/tools/build/options/WITHOUT_WIRELESS_SUPPORT 183305 2008-09-23 16:11:15Z sam
1428 Set to build libraries, programs, and kernel modules without
1429 802.11 wireless support.
1430 .It Va WITHOUT_WPA_SUPPLICANT_EAPOL
1431 .\" from FreeBSD: head/tools/build/options/WITHOUT_WPA_SUPPLICANT_EAPOL 156932 2006-03-21 07:50:50Z ru
1432 Build
1433 .Xr wpa_supplicant 8
1434 without support for the IEEE 802.1X protocol and without
1435 support for EAP-PEAP, EAP-TLS, EAP-LEAP, and EAP-TTLS
1436 protocols (usable only via 802.1X).
1437 .It Va WITHOUT_ZFS
1438 .\" from FreeBSD: head/tools/build/options/WITHOUT_ZFS 168409 2007-04-06 02:13:30Z pjd
1439 Set to not build ZFS file system.
1440 .It Va WITHOUT_ZONEINFO
1441 .\" from FreeBSD: head/tools/build/options/WITHOUT_ZONEINFO 235342 2012-05-12 16:12:36Z gjb
1442 Set to not build the timezone database.
1443 .El
1444 .Sh FILES
1445 .Bl -tag -compact -width Pa
1446 .It Pa /etc/src.conf
1447 .It Pa /etc/src-env.conf
1448 .It Pa /usr/share/mk/bsd.own.mk
1449 .El
1450 .Sh SEE ALSO
1451 .Xr make 1 ,
1452 .Xr make.conf 5 ,
1453 .Xr build 7 ,
1454 .Xr ports 7
1455 .Sh HISTORY
1456 The
1457 .Nm
1458 file appeared in
1459 .Fx 7.0 .
1460 .Sh AUTHORS
1461 This manual page was autogenerated.