src.conf.5 (290528) | src.conf.5 (290817) |
---|---|
1.\" DO NOT EDIT-- this file is automatically generated. 2.\" from FreeBSD: head/tools/build/options/makeman 290435 2015-11-06 05:28:08Z bdrewery | 1.\" DO NOT EDIT-- this file is automatically generated. 2.\" from FreeBSD: head/tools/build/options/makeman 290435 2015-11-06 05:28:08Z bdrewery |
3.\" $FreeBSD: head/share/man/man5/src.conf.5 290528 2015-11-08 00:54:41Z bdrewery $ 4.Dd November 7, 2015 | 3.\" $FreeBSD: head/share/man/man5/src.conf.5 290817 2015-11-14 04:50:28Z sjg $ 4.Dd November 13, 2015 |
5.Dt SRC.CONF 5 6.Os 7.Sh NAME 8.Nm src.conf 9.Nd "source build options" 10.Sh DESCRIPTION 11The 12.Nm --- 55 unchanged lines hidden (view full) --- 68The environment of 69.Xr make 1 70for the build can be controlled via the 71.Va SRC_ENV_CONF 72variable, which defaults to 73.Pa /etc/src-env.conf . 74Some examples that may only be set in this file are 75.Va MAKEOBJDIRPREFIX , | 5.Dt SRC.CONF 5 6.Os 7.Sh NAME 8.Nm src.conf 9.Nd "source build options" 10.Sh DESCRIPTION 11The 12.Nm --- 55 unchanged lines hidden (view full) --- 68The environment of 69.Xr make 1 70for the build can be controlled via the 71.Va SRC_ENV_CONF 72variable, which defaults to 73.Pa /etc/src-env.conf . 74Some examples that may only be set in this file are 75.Va MAKEOBJDIRPREFIX , |
76.Va WITH_DIRDEPS_BUILD , |
|
76and 77.Va WITH_META_MODE 78as they are environment-only variables. 79.Pp 80The values of variables are ignored regardless of their setting; 81even if they would be set to 82.Dq Li FALSE 83or --- 373 unchanged lines hidden (view full) --- 457and shared library. 458The debug files will be placed in a subdirectory of 459.Pa /usr/lib/debug 460and are located automatically by 461.Xr gdb 1 . 462.It Va WITHOUT_DICT 463.\" from FreeBSD: head/tools/build/options/WITHOUT_DICT 156932 2006-03-21 07:50:50Z ru 464Set to not build the Webster dictionary files. | 77and 78.Va WITH_META_MODE 79as they are environment-only variables. 80.Pp 81The values of variables are ignored regardless of their setting; 82even if they would be set to 83.Dq Li FALSE 84or --- 373 unchanged lines hidden (view full) --- 458and shared library. 459The debug files will be placed in a subdirectory of 460.Pa /usr/lib/debug 461and are located automatically by 462.Xr gdb 1 . 463.It Va WITHOUT_DICT 464.\" from FreeBSD: head/tools/build/options/WITHOUT_DICT 156932 2006-03-21 07:50:50Z ru 465Set to not build the Webster dictionary files. |
466.It Va WITH_DIRDEPS_BUILD 467.\" from FreeBSD: head/tools/build/options/WITH_DIRDEPS_BUILD 290816 2015-11-14 03:24:48Z sjg 468Enable building in meta mode. 469This is an experimental build feature. 470For details see 471http://www.crufty.net/sjg/docs/freebsd-meta-mode.htm. 472.Pp 473The build is driven by dirdeps.mk using 474.Va DIRDEPS 475stored in 476Makefile.depend files found in each directory. 477.Pp 478The build can be started from anywhere, and behaves the same. 479The initial instance of 480.Xr make 1 481recursively reads 482.Va DIRDEPS 483from Makefile.depend 484computing a graph of tree dependencies from the current origin. 485Setting 486.Va NO_DIRDEPS 487will skip checking dirdep dependencies and will only build in the current 488directory. 489.Pp 490As each target is made 491.Xr make 1 492produces a meta file which is used to capture (and compare) 493the command line, 494as well as any command output. 495If 496.Xr filemon 4 497is available the meta file will also capture a record of files 498used to produce the target by tracking syscalls. 499.Pp 500The build will hide commands ran unless 501.Va NO_SILENT 502is defined. 503.Pp 504When set, it also enforces the following options: 505.Pp 506.Bl -item -compact 507.It 508.Va WITH_INSTALL_AS_USER 509.El 510.Pp 511When set, the following options are also in effect: 512.Pp 513.Bl -inset -compact 514.It Va WITH_AUTO_OBJ 515(unless 516.Va WITHOUT_AUTO_OBJ 517is set explicitly) 518.It Va WITH_STAGING 519(unless 520.Va WITHOUT_STAGING 521is set explicitly) 522.It Va WITH_STAGING_MAN 523(unless 524.Va WITHOUT_STAGING_MAN 525is set explicitly) 526.It Va WITH_STAGING_PROG 527(unless 528.Va WITHOUT_STAGING_PROG 529is set explicitly) 530.It Va WITH_SYSROOT 531(unless 532.Va WITHOUT_SYSROOT 533is set explicitly) 534.El 535.Pp 536This must be set in the environment, make command line, or 537.Pa /etc/src-env.conf , 538not 539.Pa /etc/src.conf . |
|
465.It Va WITH_DIRDEPS_CACHE | 540.It Va WITH_DIRDEPS_CACHE |
466.\" from FreeBSD: head/tools/build/options/WITH_DIRDEPS_CACHE 284708 2015-06-22 20:21:57Z sjg | 541.\" from FreeBSD: head/tools/build/options/WITH_DIRDEPS_CACHE 290816 2015-11-14 03:24:48Z sjg |
467Cache result of dirdeps.mk which can save significant time 468for subsequent builds. 469Depends on | 542Cache result of dirdeps.mk which can save significant time 543for subsequent builds. 544Depends on |
470.Va WITH_META_MODE . | 545.Va WITH_DIRDEPS_BUILD . |
471.Pp 472This must be set in the environment, make command line, or 473.Pa /etc/src-env.conf , 474not 475.Pa /etc/src.conf . 476.It Va WITHOUT_DMAGENT 477.\" from FreeBSD: head/tools/build/options/WITHOUT_DMAGENT 262335 2014-02-22 13:05:23Z bapt 478Set to not build dma Mail Transport Agent --- 466 unchanged lines hidden (view full) --- 945Set to not build utilities for manual pages, 946.Xr apropos 1 , 947.Xr catman 1 , 948.Xr makewhatis 1 , 949.Xr man 1 , 950.Xr whatis 1 , 951.Xr manctl 8 , 952and related support files. | 546.Pp 547This must be set in the environment, make command line, or 548.Pa /etc/src-env.conf , 549not 550.Pa /etc/src.conf . 551.It Va WITHOUT_DMAGENT 552.\" from FreeBSD: head/tools/build/options/WITHOUT_DMAGENT 262335 2014-02-22 13:05:23Z bapt 553Set to not build dma Mail Transport Agent --- 466 unchanged lines hidden (view full) --- 1020Set to not build utilities for manual pages, 1021.Xr apropos 1 , 1022.Xr catman 1 , 1023.Xr makewhatis 1 , 1024.Xr man 1 , 1025.Xr whatis 1 , 1026.Xr manctl 8 , 1027and related support files. |
953.It Va WITH_META_FILES 954.\" from FreeBSD: head/tools/build/options/WITH_META_FILES 284708 2015-06-22 20:21:57Z sjg 955Create meta files during non META_MODE build. | 1028.It Va WITH_META_MODE 1029.\" from FreeBSD: head/tools/build/options/WITH_META_MODE 290816 2015-11-14 03:24:48Z sjg 1030Create meta files when not doing DIRDEPS_BUILD. |
956The meta files can be useful for debugging. 957.Pp 958This must be set in the environment, make command line, or 959.Pa /etc/src-env.conf , 960not 961.Pa /etc/src.conf . | 1031The meta files can be useful for debugging. 1032.Pp 1033This must be set in the environment, make command line, or 1034.Pa /etc/src-env.conf , 1035not 1036.Pa /etc/src.conf . |
962.It Va WITH_META_MODE 963.\" from FreeBSD: head/tools/build/options/WITH_META_MODE 287973 2015-09-18 22:22:32Z bdrewery 964Enable building in meta mode. 965This is an experimental build feature. 966For details see 967http://www.crufty.net/sjg/docs/freebsd-meta-mode.htm. 968.Pp 969The build is driven by dirdeps.mk using 970.Va DIRDEPS 971stored in 972Makefile.depend files found in each directory. 973.Pp 974The build can be started from anywhere, and behaves the same. 975The initial instance of 976.Xr make 1 977recursively reads 978.Va DIRDEPS 979from Makefile.depend 980computing a graph of tree dependencies from the current origin. 981Setting 982.Va NO_DIRDEPS 983will skip checking dirdep dependencies and will only build in the current 984directory. 985.Pp 986As each target is made 987.Xr make 1 988produces a meta file which is used to capture (and compare) 989the command line, 990as well as any command output. 991If 992.Xr filemon 4 993is available the meta file will also capture a record of files 994used to produce the target by tracking syscalls. 995.Pp 996The build will hide commands ran unless 997.Va NO_SILENT 998is defined. 999.Pp 1000When set, it also enforces the following options: 1001.Pp 1002.Bl -item -compact 1003.It 1004.Va WITH_INSTALL_AS_USER 1005.El 1006.Pp 1007When set, the following options are also in effect: 1008.Pp 1009.Bl -inset -compact 1010.It Va WITH_AUTO_OBJ 1011(unless 1012.Va WITHOUT_AUTO_OBJ 1013is set explicitly) 1014.It Va WITH_STAGING 1015(unless 1016.Va WITHOUT_STAGING 1017is set explicitly) 1018.It Va WITH_STAGING_MAN 1019(unless 1020.Va WITHOUT_STAGING_MAN 1021is set explicitly) 1022.It Va WITH_STAGING_PROG 1023(unless 1024.Va WITHOUT_STAGING_PROG 1025is set explicitly) 1026.It Va WITH_SYSROOT 1027(unless 1028.Va WITHOUT_SYSROOT 1029is set explicitly) 1030.El 1031.Pp 1032This must be set in the environment, make command line, or 1033.Pa /etc/src-env.conf , 1034not 1035.Pa /etc/src.conf . | |
1036.It Va WITH_NAND 1037.\" from FreeBSD: head/tools/build/options/WITH_NAND 235537 2012-05-17 10:11:18Z gber 1038Set to build the NAND Flash components. 1039.It Va WITHOUT_NDIS 1040.\" from FreeBSD: head/tools/build/options/WITHOUT_NDIS 183242 2008-09-21 22:02:26Z sam 1041Set to not build programs and libraries 1042related to NDIS emulation support. 1043.It Va WITHOUT_NETCAT --- 227 unchanged lines hidden (view full) --- 1271Set to not build kernel modules that include sourceless native code for host CPU. 1272.It Va WITHOUT_SOURCELESS_UCODE 1273.\" from FreeBSD: head/tools/build/options/WITHOUT_SOURCELESS_UCODE 230972 2012-02-04 00:54:43Z rmh 1274Set to not build kernel modules that include sourceless microcode. 1275.It Va WITHOUT_SSP 1276.\" from FreeBSD: head/tools/build/options/WITHOUT_SSP 180012 2008-06-25 21:33:28Z ru 1277Set to not build world with propolice stack smashing protection. 1278.It Va WITH_STAGING | 1037.It Va WITH_NAND 1038.\" from FreeBSD: head/tools/build/options/WITH_NAND 235537 2012-05-17 10:11:18Z gber 1039Set to build the NAND Flash components. 1040.It Va WITHOUT_NDIS 1041.\" from FreeBSD: head/tools/build/options/WITHOUT_NDIS 183242 2008-09-21 22:02:26Z sam 1042Set to not build programs and libraries 1043related to NDIS emulation support. 1044.It Va WITHOUT_NETCAT --- 227 unchanged lines hidden (view full) --- 1272Set to not build kernel modules that include sourceless native code for host CPU. 1273.It Va WITHOUT_SOURCELESS_UCODE 1274.\" from FreeBSD: head/tools/build/options/WITHOUT_SOURCELESS_UCODE 230972 2012-02-04 00:54:43Z rmh 1275Set to not build kernel modules that include sourceless microcode. 1276.It Va WITHOUT_SSP 1277.\" from FreeBSD: head/tools/build/options/WITHOUT_SSP 180012 2008-06-25 21:33:28Z ru 1278Set to not build world with propolice stack smashing protection. 1279.It Va WITH_STAGING |
1279.\" from FreeBSD: head/tools/build/options/WITH_STAGING 284708 2015-06-22 20:21:57Z sjg | 1280.\" from FreeBSD: head/tools/build/options/WITH_STAGING 290816 2015-11-14 03:24:48Z sjg |
1280Enable staging of files to a stage tree. 1281This can be best thought of as auto-install to 1282.Va DESTDIR 1283with some extra meta data to ensure dependencies can be tracked. 1284Depends on | 1281Enable staging of files to a stage tree. 1282This can be best thought of as auto-install to 1283.Va DESTDIR 1284with some extra meta data to ensure dependencies can be tracked. 1285Depends on |
1285.Va WITH_META_MODE . | 1286.Va WITH_DIRDEPS_BUILD . |
1286When set, the following options are also in effect: 1287.Pp 1288.Bl -inset -compact 1289.It Va WITH_STAGING_MAN 1290(unless 1291.Va WITHOUT_STAGING_MAN 1292is set explicitly) 1293.It Va WITH_STAGING_PROG --- 30 unchanged lines hidden (view full) --- 1324.\" from FreeBSD: head/tools/build/options/WITHOUT_SYMVER 169649 2007-05-17 05:03:24Z deischen 1325Set to disable symbol versioning when building shared libraries. 1326.It Va WITHOUT_SYSCONS 1327.\" from FreeBSD: head/tools/build/options/WITHOUT_SYSCONS 156932 2006-03-21 07:50:50Z ru 1328Set to not build 1329.Xr syscons 4 1330support files such as keyboard maps, fonts, and screen output maps. 1331.It Va WITH_SYSROOT | 1287When set, the following options are also in effect: 1288.Pp 1289.Bl -inset -compact 1290.It Va WITH_STAGING_MAN 1291(unless 1292.Va WITHOUT_STAGING_MAN 1293is set explicitly) 1294.It Va WITH_STAGING_PROG --- 30 unchanged lines hidden (view full) --- 1325.\" from FreeBSD: head/tools/build/options/WITHOUT_SYMVER 169649 2007-05-17 05:03:24Z deischen 1326Set to disable symbol versioning when building shared libraries. 1327.It Va WITHOUT_SYSCONS 1328.\" from FreeBSD: head/tools/build/options/WITHOUT_SYSCONS 156932 2006-03-21 07:50:50Z ru 1329Set to not build 1330.Xr syscons 4 1331support files such as keyboard maps, fonts, and screen output maps. 1332.It Va WITH_SYSROOT |
1332.\" from FreeBSD: head/tools/build/options/WITH_SYSROOT 284708 2015-06-22 20:21:57Z sjg | 1333.\" from FreeBSD: head/tools/build/options/WITH_SYSROOT 290816 2015-11-14 03:24:48Z sjg |
1333Enable use of sysroot during build. 1334Depends on | 1334Enable use of sysroot during build. 1335Depends on |
1335.Va WITH_META_MODE . | 1336.Va WITH_DIRDEPS_BUILD . |
1336.Pp 1337This must be set in the environment, make command line, or 1338.Pa /etc/src-env.conf , 1339not 1340.Pa /etc/src.conf . 1341.It Va WITHOUT_TALK 1342.\" from FreeBSD: head/tools/build/options/WITHOUT_TALK 277676 2015-01-25 04:37:44Z ngie 1343Set to not build or install --- 169 unchanged lines hidden --- | 1337.Pp 1338This must be set in the environment, make command line, or 1339.Pa /etc/src-env.conf , 1340not 1341.Pa /etc/src.conf . 1342.It Va WITHOUT_TALK 1343.\" from FreeBSD: head/tools/build/options/WITHOUT_TALK 277676 2015-01-25 04:37:44Z ngie 1344Set to not build or install --- 169 unchanged lines hidden --- |