diff options
author | jkoshy <jkoshy@FreeBSD.org> | 2005-11-25 14:31:34 +0000 |
---|---|---|
committer | jkoshy <jkoshy@FreeBSD.org> | 2005-11-25 14:31:34 +0000 |
commit | 71d7616dda3a0adf4dd42b976f89332f3f5cb090 (patch) | |
tree | 8a8f02c16d665fea33dd21e31889833f68840e66 /share/man | |
parent | 2f1243974b570861bdd383d3e2dbcee8716f39e1 (diff) | |
download | FreeBSD-src-71d7616dda3a0adf4dd42b976f89332f3f5cb090.zip FreeBSD-src-71d7616dda3a0adf4dd42b976f89332f3f5cb090.tar.gz |
Reorder the variable lists on this page alphabetically by make variable
name.
Discussed with: ru
Diffstat (limited to 'share/man')
-rw-r--r-- | share/man/man5/make.conf.5 | 566 |
1 files changed, 283 insertions, 283 deletions
diff --git a/share/man/man5/make.conf.5 b/share/man/man5/make.conf.5 index 0bcf9d3..9180d53 100644 --- a/share/man/man5/make.conf.5 +++ b/share/man/man5/make.conf.5 @@ -178,18 +178,6 @@ Refer to for a list of recognized .Va CPUTYPE options. -.It Va NO_CPU_CFLAGS -.Pq Vt str -Setting this variable will prevent CPU specific compiler flags -from being automatically added to -.Va CFLAGS -during compile time. -.It Va NO_CPU_COPTFLAGS -.Pq Vt str -Setting this variable will prevent CPU specific compiler flags -from being automatically added to -.Va COPTFLAGS -during compile time. .It Va CVS_UPDATE .Pq Vt bool Set this to use @@ -209,6 +197,14 @@ value, use .Dq Li += instead of .Dq Li = . +.It Va DOCSUPFILE +.Pq Vt str +The documentation +.Ar supfile +to use when doing a +.Dq Li "make update" . +This defaults to +.Pa /usr/share/examples/cvsup/doc\-supfile . .It Va INSTALL .Pq Vt str the default install command. @@ -244,6 +240,18 @@ Set this to to cause .Xr mtree 8 to follow symlinks. +.It Va NO_CPU_CFLAGS +.Pq Vt str +Setting this variable will prevent CPU specific compiler flags +from being automatically added to +.Va CFLAGS +during compile time. +.It Va NO_CPU_COPTFLAGS +.Pq Vt str +Setting this variable will prevent CPU specific compiler flags +from being automatically added to +.Va COPTFLAGS +during compile time. .It Va NO_DOCUPDATE .Pq Vt bool Set this to not update the doc tree during @@ -252,30 +260,20 @@ Set this to not update the doc tree during .Pq Vt bool Set this to not update the ports tree during .Dq Li "make update" . -.It Va SUP_UPDATE -.Pq Vt bool -Set this to use -.Xr cvsup 1 -to update your ports with +.It Va PORTSSUPFILE +.Pq Vt str +The ports +.Ar supfile +to use when doing a .Dq Li "make update" . +This defaults to +.Pa /usr/share/examples/cvsup/ports\-supfile . .It Va SUP .Pq Vt str The location of the .Xr cvsup 1 command for .Dq Li "make update" . -.It Va SUPFLAGS -.Pq Vt str -The flag for the -.Xr sup 1 -command when doing -.Dq Li "make update" . -This defaults to -.Op Fl g L Ar 2 . -.It Va SUPHOST -.Pq Vt str -The hostname of the sup server to use when doing -.Dq Li "make update" . .It Va SUPFILE .Pq Vt str The first @@ -300,36 +298,30 @@ to use when doing a .Dq Li "make update" . This defaults to .Pa /usr/share/examples/cvsup/secure\-supfile . -.It Va PORTSSUPFILE +.It Va SUPFLAGS .Pq Vt str -The ports -.Ar supfile -to use when doing a +The flag for the +.Xr sup 1 +command when doing .Dq Li "make update" . This defaults to -.Pa /usr/share/examples/cvsup/ports\-supfile . -.It Va DOCSUPFILE +.Op Fl g L Ar 2 . +.It Va SUPHOST .Pq Vt str -The documentation -.Ar supfile -to use when doing a +The hostname of the sup server to use when doing +.Dq Li "make update" . +.It Va SUP_UPDATE +.Pq Vt bool +Set this to use +.Xr cvsup 1 +to update your ports with .Dq Li "make update" . -This defaults to -.Pa /usr/share/examples/cvsup/doc\-supfile . .El .Ss "BUILDING THE KERNEL" .Pp The following list provides a name and short description for variables that are only used doing a kernel build: .Bl -tag -width Ar -.It Va BOOT_COMCONSOLE_PORT -.Pq Vt str -The port address to use for the console if the boot blocks have -been configured to use a serial console instead of the keyboard/video card. -.It Va BOOT_COMCONSOLE_SPEED -.Pq Vt int -The baud rate to use for the console if the boot blocks have -been configured to use a serial console instead of the keyboard/video card. .It Va BOOTWAIT .Pq Vt int Controls the amount of time the kernel waits for a console keypress @@ -338,6 +330,14 @@ The value is approximately milliseconds. Keypresses are accepted by the BIOS before booting from disk, making it possible to give custom boot parameters even when this is set to 0. +.It Va BOOT_COMCONSOLE_PORT +.Pq Vt str +The port address to use for the console if the boot blocks have +been configured to use a serial console instead of the keyboard/video card. +.It Va BOOT_COMCONSOLE_SPEED +.Pq Vt int +The baud rate to use for the console if the boot blocks have +been configured to use a serial console instead of the keyboard/video card. .It Va COPTFLAGS .Pq Vt str Controls the compiler settings when building the @@ -383,19 +383,6 @@ rather than load the server's kernel. .It Va MODULES_OVERRIDE .Pq Vt str Set to a list of modules to build instead of all of them. -.It Va WITHOUT_MODULES -.Pq Vt str -Set to a list of modules to exclude from the build. -This provides a -somewhat easier way to exclude modules you are certain you will never -need than specifying -.Va MODULES_OVERRIDE . -This is applied -.Em after -.Va MODULES_OVERRIDE . -.It Va PORTS_MODULES -Set this to the list of ports you wish to rebuild every time the kernel -is built. .It Va NO_KERNELCONFIG .Pq Vt bool Set this to skip running @@ -411,29 +398,25 @@ during .It Va NO_MODULES .Pq Vt bool Set to not build modules with the kernel. +.It Va PORTS_MODULES +Set this to the list of ports you wish to rebuild every time the kernel +is built. +.It Va WITHOUT_MODULES +.Pq Vt str +Set to a list of modules to exclude from the build. +This provides a +somewhat easier way to exclude modules you are certain you will never +need than specifying +.Va MODULES_OVERRIDE . +This is applied +.Em after +.Va MODULES_OVERRIDE . .El .Ss "BUILDING THE WORLD" .Pp The following list provides a name and short description for variables that are used during the world build: .Bl -tag -width Ar -.It Va MAKE_IDEA -.Pq Vt bool -Set to build the IDEA encryption code. -This code is patented in the USA and many European countries. -It is -.Em "YOUR RESPONSIBILITY" -to determine if you can legally use IDEA. -.It Va NO_DYNAMICROOT -.Pq Vt bool -Set this if you do not want to link -.Pa /bin -and -.Pa /sbin -dynamically. -.It Va NO_KERBEROS -.Pq Vt bool -Set this if you do not want to build Kerberos 5 (KTH Heimdal). .It Va ENABLE_SUID_K5SU .Pq Vt bool Set this if you wish to use the ksu utility. @@ -452,15 +435,110 @@ will not be able to change users' groups. Set this to install .Xr ssh 1 with the set-user-ID bit turned on. +.It Va ENABLE_WPA_SUPPLICANT_EAPOL +.Pq Vt str +Build +.Xr wpa_supplicant 8 +with support for the IEEE 802.1X protocol and with +support for EAP-PEAP, EAP-TLS, EAP-LEAP, and EAP-TTLS +protocols (usable only via 802.1X). +This option is ignored if +.Va NO_CRYPT +or +.Va NO_OPENSSL +are set. +.It Va MAKE_IDEA +.Pq Vt bool +Set to build the IDEA encryption code. +This code is patented in the USA and many European countries. +It is +.Em "YOUR RESPONSIBILITY" +to determine if you can legally use IDEA. .It Va MODULES_WITH_WORLD .Pq Vt bool Set to build modules with the system instead of the kernel. +.It Va NO_ACPI +.Pq Vt bool +Set to not build +.Xr acpiconf 8 , +.Xr acpidump 8 +and related programs. +.It Va NO_ATM +.Pq Vt bool +Set to not build +programs and libraries related to ATM networking. +.It Va NO_AUTHPF +.Pq Vt bool +Set to not build +.Xr authpf 8 . +.It Va NO_BIND +.Pq Vt bool +Setting this variable will prevent any part of BIND from being built, +regardless of the presence of any of the other *_BIND_* variables below. +.It Va NO_BIND_DNSSEC +.Pq Vt bool +Set to avoid building or installing the DNSSEC related binaries, +.Xr dnssec-keygen 8 +and +.Xr dnssec-signzone 8 . +.It Va NO_BIND_ETC +.Pq Vt bool +Set to avoid installing the default files to +.Pa /var/named/etc/namedb . +.It Va NO_BIND_LIBS_LWRES +.Pq Vt bool +Set to avoid installing the lightweight resolver library in +.Pa /usr/lib . +The library that is private to the build system may still be built as needed. +.It Va NO_BIND_MTREE +.Pq Vt bool +Set to avoid running +.Xr mtree 8 +to create the chroot directory structure under +.Pa /var/named , +and avoid creating an +.Pa /etc/namedb +symlink to the chroot directory. +This option should typically be used together with +.Vt NO_BIND_ETC . +.It Va NO_BIND_NAMED +.Pq Vt bool +Set to avoid building or installing +.Xr named 8 , +.Xr named.reload 8 , +.Xr named-checkconf 8 , +.Xr named-checkzone 8 , +.Xr rndc 8 , +and +.Xr rndc-confgen 8 . +.It Va NO_BIND_UTILS +.Pq Vt bool +Set to avoid building or installing the BIND userland utilities, +.Xr dig 1 , +.Xr host 1 , +.Xr nslookup 1 , +and +.Xr nsupdate 8 . .It Va NO_BLUETOOTH .Pq Vt bool Set to not build Bluetooth related kernel modules, programs and libraries. .It Va NO_BOOT .Pq Vt bool Set to not build the boot blocks and loader. +.It Va NO_CLEAN +.Pq Vt bool +Set this to disable cleaning during +.Dq Li "make buildworld" . +This should not be set unless you know what you are doing. +.It Va NO_CLEANDIR +.Pq Vt bool +Set this to run +.Dq Li "${MAKE} clean" +instead of +.Dq Li "${MAKE} cleandir" . +.It Va NO_CRYPT +.Pq Vt bool +Set to not build any crypto code. .It Va NO_CVS .Pq Vt bool Set to not build CVS. @@ -472,11 +550,21 @@ and related libraries. .It Va NO_DICT .Pq Vt bool Set to not build the Webster dictionary files. +.It Va NO_DYNAMICROOT +.Pq Vt bool +Set this if you do not want to link +.Pa /bin +and +.Pa /sbin +dynamically. .It Va NO_FORTRAN .Pq Vt bool Set to not build .Xr g77 1 and related libraries. +.It Va NO_GAMES +.Pq Vt bool +Set to not build games. .It Va NO_GDB .Pq Vt bool Set to not build @@ -487,45 +575,44 @@ Set to not build GPIB bus support. .It Va NO_I4B .Pq Vt bool Set to not build isdn4bsd package. -.It Va NO_IPFILTER +.It Va NO_INET6 .Pq Vt bool -Set to not build IP Filter package. -.It Va NO_PF +Set to not build +programs and libraries related to IPv6 networking. +.It Va NO_INFO .Pq Vt bool -Set to not build PF firewall package. -.It Va NO_AUTHPF +Set to not make or install +.Xr info 5 +files. +.It Va NO_IPFILTER .Pq Vt bool -Set to not build -.Xr authpf 8 . -.It Va NO_TOOLCHAIN +Set to not build IP Filter package. +.It Va NO_KERBEROS .Pq Vt bool -Set to not build -programs used for program development, -compilers, debuggers etc. -.It Va NO_INET6 +Set this if you do not want to build Kerberos 5 (KTH Heimdal). +.It Va NO_LIBC_R .Pq Vt bool Set to not build -programs and libraries related to IPv6 networking. -.It Va NO_ATM +.Nm libc_r +(reentrant version of +.Nm libc ) . +.It Va NO_LIBPTHREAD .Pq Vt bool -Set to not build -programs and libraries related to ATM networking. -.It Va NO_USB +Set to not build the +.Nm libpthread +(M:N threading) +library. +.It Va NO_LIBTHR .Pq Vt bool -Set to not build -.Xr usbd 8 -and related programs. +Set to not build the +.Nm libthr +(1:1 threading) +library. .It Va NO_LPR .Pq Vt bool Set to not build .Xr lpr 1 and related programs. -.It Va NO_ACPI -.Pq Vt bool -Set to not build -.Xr acpiconf 8 , -.Xr acpidump 8 -and related programs. .It Va NO_MAILWRAPPER .Pq Vt bool Set to not build the @@ -534,6 +621,9 @@ MTA selector. .It Va NO_MAN .Pq Vt bool Set to not build manual pages. +.It Va NO_MANCOMPRESS +.Pq Vt bool +Set to install manual pages uncompressed. .It Va NO_NETCAT .Pq Vt bool Set to not build @@ -561,68 +651,26 @@ Set to not build OpenSSL (implies .Va NO_KERBEROS and .Va NO_OPENSSH ) . -.It Va NO_SENDMAIL -.Pq Vt bool -Set to not build -.Xr sendmail 8 -and related programs. -.It Va NO_SHAREDOCS -.Pq Vt bool -Set to not build the -.Bx 4.4 -legacy docs. -.It Va NO_TCSH -.Pq Vt bool -Set to not build and install -.Pa /bin/csh -(which is -.Xr tcsh 1 ) . -.It Va NO_CLEAN -.Pq Vt bool -Set this to disable cleaning during -.Dq Li "make buildworld" . -This should not be set unless you know what you are doing. -.It Va NO_CLEANDIR -.Pq Vt bool -Set this to run -.Dq Li "${MAKE} clean" -instead of -.Dq Li "${MAKE} cleandir" . -.It Va NO_CRYPT +.It Va NO_PF .Pq Vt bool -Set to not build any crypto code. -.It Va NO_GAMES +Set to not build PF firewall package. +.It Va NO_PROFILE .Pq Vt bool -Set to not build games. -.It Va NO_INFO +Set to avoid compiling profiled libraries. +.It Va NO_RCMDS .Pq Vt bool -Set to not make or install -.Xr info 5 -files. -.It Va NO_LIBC_R +Disable building of the +.Tn BSD +r-commands. +This includes +.Xr rlogin 1 , +.Xr rsh 1 , +etc. +.It Va NO_SENDMAIL .Pq Vt bool Set to not build -.Nm libc_r -(reentrant version of -.Nm libc ) . -.It Va NO_LIBPTHREAD -.Pq Vt bool -Set to not build the -.Nm libpthread -(M:N threading) -library. -.It Va NO_LIBTHR -.Pq Vt bool -Set to not build the -.Nm libthr -(1:1 threading) -library. -.It Va NO_MANCOMPRESS -.Pq Vt bool -Set to install manual pages uncompressed. -.It Va NO_PROFILE -.Pq Vt bool -Set to avoid compiling profiled libraries. +.Xr sendmail 8 +and related programs. .It Va NO_SHARE .Pq Vt bool Set to not build in the @@ -638,57 +686,27 @@ statically linked, this can be bad. If set, every utility that uses .Pa bsd.prog.mk will be linked statically. -.It Va NO_BIND -.Pq Vt bool -Setting this variable will prevent any part of BIND from being built, -regardless of the presence of any of the other *_BIND_* variables below. -.It Va NO_BIND_DNSSEC -.Pq Vt bool -Set to avoid building or installing the DNSSEC related binaries, -.Xr dnssec-keygen 8 -and -.Xr dnssec-signzone 8 . -.It Va NO_BIND_ETC -.Pq Vt bool -Set to avoid installing the default files to -.Pa /var/named/etc/namedb . -.It Va NO_BIND_LIBS_LWRES -.Pq Vt bool -Set to avoid installing the lightweight resolver library in -.Pa /usr/lib . -The library that is private to the build system may still be built as needed. -.It Va NO_BIND_MTREE +.It Va NO_SHAREDOCS .Pq Vt bool -Set to avoid running -.Xr mtree 8 -to create the chroot directory structure under -.Pa /var/named , -and avoid creating an -.Pa /etc/namedb -symlink to the chroot directory. -This option should typically be used together with -.Vt NO_BIND_ETC . -.It Va NO_BIND_NAMED +Set to not build the +.Bx 4.4 +legacy docs. +.It Va NO_TCSH .Pq Vt bool -Set to avoid building or installing -.Xr named 8 , -.Xr named.reload 8 , -.Xr named-checkconf 8 , -.Xr named-checkzone 8 , -.Xr rndc 8 , -and -.Xr rndc-confgen 8 . -.It Va NO_BIND_UTILS +Set to not build and install +.Pa /bin/csh +(which is +.Xr tcsh 1 ) . +.It Va NO_TOOLCHAIN .Pq Vt bool -Set to avoid building or installing the BIND userland utilities, -.Xr dig 1 , -.Xr host 1 , -.Xr nslookup 1 , -and -.Xr nsupdate 8 . -.It Va WITH_BIND_LIBS +Set to not build +programs used for program development, +compilers, debuggers etc. +.It Va NO_USB .Pq Vt bool -Set to install BIND libraries and include files. +Set to not build +.Xr usbd 8 +and related programs. .It Va PPP_NO_NAT .Pq Vt bool Build @@ -709,41 +727,6 @@ without support for RADIUS. Set to disable the installation of .Xr ppp 8 as a set-user-ID root program. -.It Va NO_RCMDS -.Pq Vt bool -Disable building of the -.Tn BSD -r-commands. -This includes -.Xr rlogin 1 , -.Xr rsh 1 , -etc. -.It Va SENDMAIL_MC -.Pq Vt str -The default -.Xr m4 1 -configuration file to use at install time. -The value should include the full path to the -.Pa .mc -file, e.g., -.Pa /etc/mail/myconfig.mc . -Use with caution as a make install will overwrite any existing -.Pa /etc/mail/sendmail.cf . -Note that -.Va SENDMAIL_CF -is now deprecated. -.It Va SENDMAIL_SUBMIT_MC -.Pq Vt str -The default -.Xr m4 1 -configuration file for mail submission -to use at install time. -The value should include the full path to the -.Pa .mc -file, e.g., -.Pa /etc/mail/mysubmit.mc . -Use with caution as a make install will overwrite any existing -.Pa /etc/mail/submit.cf . .It Va SENDMAIL_ADDITIONAL_MC .Pq Vt str Additional @@ -756,24 +739,6 @@ The value should include the full path to the file(s), e.g., .Pa /etc/mail/foo.mc .Pa /etc/mail/bar.mc . -.It Va SENDMAIL_CF_DIR -.Pq Vt str -Override the default location for the -.Xr m4 1 -configuration files used to build a -.Pa .cf -file from a -.Pa .mc -file. -.It Va SENDMAIL_M4_FLAGS -.Pq Vt str -Flags passed to -.Xr m4 1 -when building a -.Pa .cf -file from a -.Pa .mc -file. .It Va SENDMAIL_CFLAGS .Pq Vt str Flags to pass to the compile command when building @@ -786,11 +751,18 @@ SENDMAIL_CFLAGS=-I/usr/local/include -DSASL SENDMAIL_LDFLAGS=-L/usr/local/lib SENDMAIL_LDADD=-lsasl .Ed -.It Va SENDMAIL_LDFLAGS +.It Va SENDMAIL_CF_DIR .Pq Vt str -Flags to pass to the -.Xr ld 1 -command when building +Override the default location for the +.Xr m4 1 +configuration files used to build a +.Pa .cf +file from a +.Pa .mc +file. +.It Va SENDMAIL_DPADD +.Pq Vt str +Extra dependencies to add when building .Xr sendmail 8 . .It Va SENDMAIL_LDADD .Pq Vt str @@ -798,10 +770,40 @@ Flags to add to the end of the .Xr ld 1 command when building .Xr sendmail 8 . -.It Va SENDMAIL_DPADD +.It Va SENDMAIL_LDFLAGS .Pq Vt str -Extra dependencies to add when building +Flags to pass to the +.Xr ld 1 +command when building .Xr sendmail 8 . +.It Va SENDMAIL_M4_FLAGS +.Pq Vt str +Flags passed to +.Xr m4 1 +when building a +.Pa .cf +file from a +.Pa .mc +file. +.It Va SENDMAIL_MAP_PERMS +.Pq Vt str +Mode to use when generating alias and map database files using +.Pa /etc/mail/Makefile . +The default value is 0640. +.It Va SENDMAIL_MC +.Pq Vt str +The default +.Xr m4 1 +configuration file to use at install time. +The value should include the full path to the +.Pa .mc +file, e.g., +.Pa /etc/mail/myconfig.mc . +Use with caution as a make install will overwrite any existing +.Pa /etc/mail/sendmail.cf . +Note that +.Va SENDMAIL_CF +is now deprecated. .It Va SENDMAIL_SET_USER_ID .Pq Vt bool If set, install @@ -812,11 +814,18 @@ and do not install Use of this flag is not recommended and the alternative advice in .Pa /etc/mail/README should be followed instead if at all possible. -.It Va SENDMAIL_MAP_PERMS +.It Va SENDMAIL_SUBMIT_MC .Pq Vt str -Mode to use when generating alias and map database files using -.Pa /etc/mail/Makefile . -The default value is 0640. +The default +.Xr m4 1 +configuration file for mail submission +to use at install time. +The value should include the full path to the +.Pa .mc +file, e.g., +.Pa /etc/mail/mysubmit.mc . +Use with caution as a make install will overwrite any existing +.Pa /etc/mail/submit.cf . .It Va TOP_TABLE_SIZE .Pq Vt int .Xr top 1 @@ -835,18 +844,9 @@ levels to a lower one. and above is known to trigger known optimizer bugs at various times \(em this is worse on the Alpha platform. The value assigned is the highest optimization value used. -.It Va ENABLE_WPA_SUPPLICANT_EAPOL -.Pq Vt str -Build -.Xr wpa_supplicant 8 -with support for the IEEE 802.1X protocol and with -support for EAP-PEAP, EAP-TLS, EAP-LEAP, and EAP-TTLS -protocols (usable only via 802.1X). -This option is ignored if -.Va NO_CRYPT -or -.Va NO_OPENSSL -are set. +.It Va WITH_BIND_LIBS +.Pq Vt bool +Set to install BIND libraries and include files. .El .Ss "BUILDING DOCUMENTATION" .Pp |