Attachment #26665 for bug #45470




.Bd -literal -offset indent
CFLAGS+=${BDECFLAGS}
.Ed
.It Va CPUTYPE
.Pq Vt str
Controls which processor should be targeted for generated
code.  This controls processor-specific optimizations in
certain code (currently only OpenSSL) as well as modifying
the value of
.Va CFLAGS
and
.Va COPTFLAGS
to contain the appropriate optimization directive to gcc.
The automatic setting of
.Va CFLAGS
and
.Va COPTFLAGS
may be overridden using the
.Va NO_CPU_CFLAGS
and
.Va NO_CPU_COPTFLAGS
variables, respectively.  Refer to
.Pa /usr/share/examples/make.conf
for a list of recognized
.Va CPUTYPE
options.
.It Va CVS_UPDATE
.Pq Vt bool
Set this to use

make's in
.Pa /usr/src
in this variable.
.It Va MAKE_SHELL
.Pq Vt str
Controls the shell used internally by
.Xr make 1
to process the command scripts in makefiles.  Three shells
are supported, sh, ksh, and csh.  Using sh is most common,
and advised.  Using ksh *may* work, but is not guaranteed
to.  Using csh is absurd.  The default is to use sh.
.Bd -literal -offset indent
MAKE_SHELL?=sh
.Ed
.It Va MTREE_FOLLOWS_SYMLINKS
.Pq Vt str
Set this to

.Ar supfile
to use when doing a
.Dq Li "make update" .
This defaults to
.Pa /usr/share/examples/cvsup/standard\-supfile .
.It Va SUPFILE1
.Pq Vt str
The second
.Ar supfile
to use when doing a
.Dq Li "make update" .
This defaults to
.Pa /usr/share/examples/cvsup/secure\-supfile .
.It Va SUPFILE2
.Pq Vt str
The third
.Ar supfile
to use when doing a
.Dq Li "make update" .
This defaults to
.Pa /usr/share/examples/cvsup/secure\-supfile .
.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 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 .
.El
.Pp
The following list provides a name and short description for variables

.Pa MINE .
It defaults to
.Pa GENERIC .
.It Va LOADER_TFTP_SUPPORT
.Pq Vt bool
While not a buildkernel-affected option, there is no better place for this.
By default the ``pxeboot'' loader retrieves the kernel via NFS.  Defining
this and recompiling
.Pa /usr/src/sys/boot
will cause it to retrieve the kernel via TFTP.  This allows pxeboot to
load a custom BOOTP diskless kernel yet still mount the server's `/'
(i.e., 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 NO_KERNELCONFIG
.Pq Vt bool
Set this to skip running

.It Va NO_MODULES
.Pq Vt bool
Set to not build modules with the kernel.
.It Va MODULES_OVERRIDE
.Pq Vt str
Set to a list of modules to build instead of all of them.
.El
.Pp
The following list provides a name and short description for variables

Command to use to fetch files.
Normally
.Xr fetch 1 .
.It Va KRB5_HOME
.Pq Vt str
If you want to install the MIT Kerberos5 port somewhere other than
.Pa /usr/local ,
define this.  This is also used to tell ssh1 that kerberos is needed).
.It Va MAKE_IDEA
.Pq Vt bool
Set to build the IDEA encryption code.

Otherwise,
.Xr newgrp 1
will not be able to change users' groups.
.It Va ENABLE_SUID_SSH
.Pq Vt bool
Set this to insall
.Xr ssh 1
with the setuid bit turned on.
.It Va MODULES_WITH_WORLD
.Pq Vt bool
Set to build modules with the system instead of the kernel.
.It Va NO_CVS
.Pq Vt bool
Set to not build CVS.
.It Va NO_CXX
.Pq Vt bool
Set to not build
.Xr g++ 1
and related libraries.
.It Va NO_BIND
.Pq Vt bool
Set to not build BIND.

Set to not build
.Xr g77 1
and related libraries.
.It Va NO_GDB
.Pq Vt bool
Set to not build
.Xr gdb 1
.It Va NO_I4B
.Pq Vt bool
Set to not build isdn4bsd package.

Mode to use when generating alias and map database files using
.Pa /etc/mail/Makefile .
The default value is 0640.
.It Va TOP_TABLE_SIZE
.Pq Vt int
.Xr top 1
uses a hash table for the user names.  The size of this hash can be tuned
to match the number of local users.  The table size should be a prime number
approximately twice as large as the number of lines in
.Pa /etc/passwd .
The default number is 20011.
.It Va WANT_FORCE_OPTIMIZATION_DOWNGRADE
.Pq Vt int
Causes the system compiler to be built such that it forces high optimization

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 WANT_OPENSSL_MANPAGES
.Pq Vt bool
Set this to build the OpenSSL manual pages.  These are not built by
default because they clobber a number of system manual pages with
manual pages describing parts of the OpenSSL toolkit, including
.Xr passwd 1 ,
.Xr err 3 ,
.Xr md5 3 ,
and others.
.El
.Pp
The following list provides a name and short description for variables

Return to bug 45470

Lines 111-116 Link Here

(-)share/man/man5/make.conf.5 (-13 / +82 lines)
111	.Bd -literal -offset indent	111	.Bd -literal -offset indent
112	CFLAGS+=${BDECFLAGS}	112	CFLAGS+=${BDECFLAGS}
113	.Ed	113	.Ed
		114	.It Va CPUTYPE
		115	.Pq Vt str
		116	Controls which processor should be targeted for generated
		117	code. This controls processor-specific optimizations in
		118	certain code (currently only OpenSSL) as well as modifying
		119	the value of
		120	.Va CFLAGS
		121	and
		122	.Va COPTFLAGS
		123	to contain the appropriate optimization directive to gcc.
		124	The automatic setting of
		125	.Va CFLAGS
		126	and
		127	.Va COPTFLAGS
		128	may be overridden using the
		129	.Va NO_CPU_CFLAGS
		130	and
		131	.Va NO_CPU_COPTFLAGS
		132	variables, respectively. Refer to
		133	.Pa /usr/share/examples/make.conf
		134	for a list of recognized
		135	.Va CPUTYPE
		136	options.
114	.It Va CVS_UPDATE	137	.It Va CVS_UPDATE
115	.Pq Vt bool	138	.Pq Vt bool
116	Set this to use	139	Set this to use
Lines 144-149 Link Here
144	make's in	167	make's in
145	.Pa /usr/src	168	.Pa /usr/src
146	in this variable.	169	in this variable.
		170	.It Va MAKE_SHELL
		171	.Pq Vt str
		172	Controls the shell used internally by
		173	.Xr make 1
		174	to process the command scripts in makefiles. Three shells
		175	are supported, sh, ksh, and csh. Using sh is most common,
		176	and advised. Using ksh may work, but is not guaranteed
		177	to. Using csh is absurd. The default is to use sh.
		178	.Bd -literal -offset indent
		179	MAKE_SHELL?=sh
		180	.Ed
147	.It Va MTREE_FOLLOWS_SYMLINKS	181	.It Va MTREE_FOLLOWS_SYMLINKS
148	.Pq Vt str	182	.Pq Vt str
149	Set this to	183	Set this to
Lines 189-228 Link Here
189	.Ar supfile	223	.Ar supfile
190	to use when doing a	224	to use when doing a
191	.Dq Li "make update" .	225	.Dq Li "make update" .
192	This defaults to
193	.Pa /usr/share/examples/cvsup/standard\-supfile .
194	.It Va SUPFILE1	226	.It Va SUPFILE1
195	.Pq Vt str	227	.Pq Vt str
196	The second	228	The second
197	.Ar supfile	229	.Ar supfile
198	to use when doing a	230	to use when doing a
199	.Dq Li "make update" .	231	.Dq Li "make update" .
200	This defaults to
201	.Pa /usr/share/examples/cvsup/secure\-supfile .
202	.It Va SUPFILE2	232	.It Va SUPFILE2
203	.Pq Vt str	233	.Pq Vt str
204	The third	234	The third
205	.Ar supfile	235	.Ar supfile
206	to use when doing a	236	to use when doing a
207	.Dq Li "make update" .	237	.Dq Li "make update" .
208	This defaults to
209	.Pa /usr/share/examples/cvsup/secure\-supfile .
210	.It Va PORTSSUPFILE	238	.It Va PORTSSUPFILE
211	.Pq Vt str	239	.Pq Vt str
212	The ports	240	The ports
213	.Ar supfile	241	.Ar supfile
214	to use when doing a	242	to use when doing a
215	.Dq Li "make update" .	243	.Dq Li "make update" .
216	This defaults to
217	.Pa /usr/share/examples/cvsup/ports\-supfile .
218	.It Va DOCSUPFILE	244	.It Va DOCSUPFILE
219	.Pq Vt str	245	.Pq Vt str
220	The documentation	246	The documentation
221	.Ar supfile	247	.Ar supfile
222	to use when doing a	248	to use when doing a
223	.Dq Li "make update" .	249	.Dq Li "make update" .
224	This defaults to
225	.Pa /usr/share/examples/cvsup/doc\-supfile .
226	.El	250	.El
227	.Pp	251	.Pp
228	The following list provides a name and short description for variables	252	The following list provides a name and short description for variables
Lines 271-276 Link Here
271	.Pa MINE .	295	.Pa MINE .
272	It defaults to	296	It defaults to
273	.Pa GENERIC .	297	.Pa GENERIC .
		298	.It Va LOADER_TFTP_SUPPORT
		299	.Pq Vt bool
		300	While not a buildkernel-affected option, there is no better place for this.
		301	By default the ``pxeboot'' loader retrieves the kernel via NFS. Defining
		302	this and recompiling
		303	.Pa /usr/src/sys/boot
		304	will cause it to retrieve the kernel via TFTP. This allows pxeboot to
		305	load a custom BOOTP diskless kernel yet still mount the server's `/'
		306	(i.e., rather than load the server's kernel).
		307	.It Va MODULES_OVERRIDE
		308	.Pq Vt str
		309	Set to a list of modules to build instead of all of them.
274	.It Va NO_KERNELCONFIG	310	.It Va NO_KERNELCONFIG
275	.Pq Vt bool	311	.Pq Vt bool
276	Set this to skip running	312	Set this to skip running
Lines 286-294 Link Here
286	.It Va NO_MODULES	322	.It Va NO_MODULES
287	.Pq Vt bool	323	.Pq Vt bool
288	Set to not build modules with the kernel.	324	Set to not build modules with the kernel.
289	.It Va MODULES_OVERRIDE
290	.Pq Vt str
291	Set to a list of modules to build instead of all of them.
292	.El	325	.El
293	.Pp	326	.Pp
294	The following list provides a name and short description for variables	327	The following list provides a name and short description for variables
Lines 331-336 Link Here
331	Command to use to fetch files.	364	Command to use to fetch files.
332	Normally	365	Normally
333	.Xr fetch 1 .	366	.Xr fetch 1 .
		367	.It Va KRB5_HOME
		368	.Pq Vt str
		369	If you want to install the MIT Kerberos5 port somewhere other than
		370	.Pa /usr/local ,
		371	define this. This is also used to tell ssh1 that kerberos is needed).
334	.It Va MAKE_IDEA	372	.It Va MAKE_IDEA
335	.Pq Vt bool	373	.Pq Vt bool
336	Set to build the IDEA encryption code.	374	Set to build the IDEA encryption code.
Lines 361-372 Link Here
361	Otherwise,	399	Otherwise,
362	.Xr newgrp 1	400	.Xr newgrp 1
363	will not be able to change users' groups.	401	will not be able to change users' groups.
		402	.It Va ENABLE_SUID_SSH
		403	.Pq Vt bool
		404	Set this to insall
		405	.Xr ssh 1
		406	with the setuid bit turned on.
364	.It Va MODULES_WITH_WORLD	407	.It Va MODULES_WITH_WORLD
365	.Pq Vt bool	408	.Pq Vt bool
366	Set to build modules with the system instead of the kernel.	409	Set to build modules with the system instead of the kernel.
367	.It Va NO_CVS	410	.It Va NO_CVS
368	.Pq Vt bool	411	.Pq Vt bool
369	Set to not build CVS.	412	Set to not build CVS.
		413	.It Va NO_CXX
		414	.Pq Vt bool
		415	Set to not build
		416	.Xr g++ 1
		417	and related libraries.
370	.It Va NO_BIND	418	.It Va NO_BIND
371	.Pq Vt bool	419	.Pq Vt bool
372	Set to not build BIND.	420	Set to not build BIND.
Lines 375-380 Link Here
375	Set to not build	423	Set to not build
376	.Xr g77 1	424	.Xr g77 1
377	and related libraries.	425	and related libraries.
		426	.It Va NO_GDB
		427	.Pq Vt bool
		428	Set to not build
		429	.Xr gdb 1
378	.It Va NO_I4B	430	.It Va NO_I4B
379	.Pq Vt bool	431	.Pq Vt bool
380	Set to not build isdn4bsd package.	432	Set to not build isdn4bsd package.
Lines 596-601 Link Here
596	Mode to use when generating alias and map database files using	648	Mode to use when generating alias and map database files using
597	.Pa /etc/mail/Makefile .	649	.Pa /etc/mail/Makefile .
598	The default value is 0640.	650	The default value is 0640.
		651	.It Va TOP_TABLE_SIZE
		652	.Pq Vt int
		653	.Xr top 1
		654	uses a hash table for the user names. The size of this hash can be tuned
		655	to match the number of local users. The table size should be a prime number
		656	approximately twice as large as the number of lines in
		657	.Pa /etc/passwd .
		658	The default number is 20011.
599	.It Va WANT_FORCE_OPTIMIZATION_DOWNGRADE	659	.It Va WANT_FORCE_OPTIMIZATION_DOWNGRADE
600	.Pq Vt int	660	.Pq Vt int
601	Causes the system compiler to be built such that it forces high optimization	661	Causes the system compiler to be built such that it forces high optimization
Lines 605-610 Link Here
605	and above is known to trigger known optimizer bugs at various	665	and above is known to trigger known optimizer bugs at various
606	times \(em this is worse on the Alpha platform.	666	times \(em this is worse on the Alpha platform.
607	The value assigned is the highest optimization value used.	667	The value assigned is the highest optimization value used.
		668	.It Va WANT_OPENSSL_MANPAGES
		669	.Pq Vt bool
		670	Set this to build the OpenSSL manual pages. These are not built by
		671	default because they clobber a number of system manual pages with
		672	manual pages describing parts of the OpenSSL toolkit, including
		673	.Xr passwd 1 ,
		674	.Xr err 3 ,
		675	.Xr md5 3 ,
		676	and others.
608	.El	677	.El
609	.Pp	678	.Pp
610	The following list provides a name and short description for variables	679	The following list provides a name and short description for variables