Date: Mon, 10 Jan 2005 18:10:47 GMT From: Gavin Atkinson <gavin.atkinson@ury.york.ac.uk> To: FreeBSD-gnats-submit@FreeBSD.org Subject: docs/76064: Add more information to build(7) Message-ID: <200501101810.j0AIAlcL002962@buffy.york.ac.uk> Resent-Message-ID: <200501101820.j0AIKKqS053044@freefall.freebsd.org>
next in thread | raw e-mail | index | archive | help
>Number: 76064 >Category: docs >Synopsis: Add more information to build(7) >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Mon Jan 10 18:20:19 GMT 2005 >Closed-Date: >Last-Modified: >Originator: Gavin Atkinson >Release: FreeBSD 5.3-STABLE i386 >Organization: >Environment: System: FreeBSD buffy.york.ac.uk 5.3-STABLE FreeBSD 5.3-STABLE #6: Tue Dec 7 22:37:07 GMT 2004 root@buffy.york.ac.uk:/usr/obj/usr/src/sys/BUFFY i386 >Description: build(7) lacks documentation on some of the more useful build flags and targets. >How-To-Repeat: n/a >Fix: --- build.7.diff begins here --- Index: src/share/man/man7/build.7 =================================================================== RCS file: /usr/cvs/src/share/man/man7/build.7,v retrieving revision 1.27 diff -u -r1.27 build.7 --- src/share/man/man7/build.7 13 Aug 2004 12:59:46 -0000 1.27 +++ src/share/man/man7/build.7 10 Jan 2005 18:09:59 -0000 @@ -24,7 +24,7 @@ .\" .\" $FreeBSD: src/share/man/man7/build.7,v 1.27 2004/08/13 12:59:46 ru Exp $ .\" -.Dd August 13, 2004 +.Dd January 10, 2005 .Dt BUILD 7 .Os .Sh NAME @@ -90,6 +90,11 @@ Install the kernel and the kernel modules. .It Cm reinstallkernel Reinstall the kernel and the kernel modules. +.It Cm kernel +Equivalent to +.Cm buildkernel +followed by +.Cm installkernel .El .Pp For more information about the ports build process, see @@ -119,6 +124,39 @@ The directory hierarchy where the resulting binaries will be installed. .El +.Sh FLAGS +.Bl -tag -width ".Va NO_KERNELDEPEND" +.It Va -DNO_MAN +Do not build man pages. +.It Va -DNO_GAMES +Do not build games. +.It Va -DNO_DYNAMICROOT +Build +.Pa /bin +and +.Pa /sbin +statically. +.El +.Pp +Note that there are many other flags which can be used. +.Pa /usr/src/Makefile.inc1 +lists more. +.Pp +The following flags can dramatically speed up a build, +but should be used with care and never after the source +has been updated since the last build. +They are mainly useful for testing changes to individual +files, where dependencies are known to have not changed. +.Bl -tag -width ".Va NO_KERNELDEPEND" +.It Va -DNO_CLEAN +Do not clean before building. +.It Va -DNO_KERNELDEPEND +Do not recreate dependency information. +.It Va -DNO_KERNELCONFIG +Do not run +.Xr config 8 +to reconfigure the kernel before building. +.El .Sh FILES .Bl -tag -width ".Pa /usr/share/examples/etc/make.conf" -compact .It Pa /etc/make.conf @@ -148,6 +186,7 @@ .Ed .Sh SEE ALSO .Xr cc 1 , +.Xr config 8 , .Xr install 1 , .Xr make 1 , .Xr make.conf 5 , --- build.7.diff ends here --- >Release-Note: >Audit-Trail: >Unformatted:
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200501101810.j0AIAlcL002962>