From owner-freebsd-doc Wed Jul 26 7:10:11 2000 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.ORG [204.216.27.21]) by hub.freebsd.org (Postfix) with ESMTP id 74D3837B600 for ; Wed, 26 Jul 2000 07:10:04 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id HAA22830; Wed, 26 Jul 2000 07:10:04 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Date: Wed, 26 Jul 2000 07:10:04 -0700 (PDT) Message-Id: <200007261410.HAA22830@freefall.freebsd.org> To: freebsd-doc@freebsd.org Cc: From: Eric Ogren Subject: Re: docs/20191: you don't ALWAYS have to make world before building a kernel Reply-To: Eric Ogren Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org The following reply was made to PR docs/20191; it has been noted by GNATS. From: Eric Ogren To: dan@freebsddiary.org Cc: freebsd-gnats-submit@FreeBSD.ORG Subject: Re: docs/20191: you don't ALWAYS have to make world before building a kernel Date: Wed, 26 Jul 2000 10:01:37 -0400 Make [build|install]kernel requires a populated /usr/obj. The only way to get that is to make world, so the entry is correct. However, it is pretty unreasonable for everyone who downloads 4.1 and has no intentions of tracking -STABLE to have to a) download the entire src tree and b) build it just to get a custom kernel, and for these people, the config, make sequence should work fine, since there aren't going to be any toolchain issues. So, having said that, how's the below patch look? My warnings might be a little too dire, but I figured it would reduce the 10.2 million questions on -stable about kernel builds dying if I made the point several times. Eric Index: chapter.sgml =================================================================== RCS file: /usr/local/doctree/doc/en_US.ISO_8859-1/books/handbook/kernelconfig/chapter.sgml,v retrieving revision 1.30 diff -u -r1.30 chapter.sgml --- chapter.sgml 2000/07/25 09:34:10 1.30 +++ chapter.sgml 2000/07/26 13:59:57 @@ -160,14 +160,34 @@ &prompt.root; make &prompt.root; make install - For FreeBSD 4.x or later (or upgrading from FreeBSD 3.x to - FreeBSD 4.x or higher), use the following commands (be sure you - have built world before!): + If you have just upgraded to a newer version of 4.X or + higher (ie from 3.X to 4.0-STABLE, or even from 4.0-STABLE to a + later version of 4.0-STABLE), make sure you have built world, and then run the + following commands: &prompt.root; cd /usr/src &prompt.root; make buildkernel KERNEL=MYKERNEL &prompt.root; make installkernel KERNEL=MYKERNEL + If you have not upgraded your source + tree in any way (you have not run CVSUp, + CTM, or used + anoncvs, then you should use the + config, make depend, + make, make install sequence. + + + If you have upgraded your sources since your last kernel + build, you must use the make + buildkernel method to build your kernel. Otherwise, + old utilities will be used to build the kernel, which will + probably fail. Do not use the + config/make sequence to + build your kernel if you have updated the + sources! + + The new kernel will be copied to the root directory as /kernel and the old kernel will be moved to /kernel.old. Now, shutdown the system and On Wed, Jul 26, 2000 at 03:42:06AM -0700, dan@freebsddiary.org wrote: > >Description: > The handbook implies that when building a custom kernel, you need to > do a build world first. That's not correct. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message