From owner-freebsd-sysinstall@FreeBSD.ORG Mon Mar 14 16:38:58 2011 Return-Path: Delivered-To: freebsd-sysinstall@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id A506B106566B; Mon, 14 Mar 2011 16:38:58 +0000 (UTC) (envelope-from nwhitehorn@freebsd.org) Received: from argol.doit.wisc.edu (argol.doit.wisc.edu [144.92.197.212]) by mx1.freebsd.org (Postfix) with ESMTP id 70EBE8FC12; Mon, 14 Mar 2011 16:38:58 +0000 (UTC) MIME-version: 1.0 Content-transfer-encoding: 7BIT Content-type: text/plain; CHARSET=US-ASCII; format=flowed Received: from avs-daemon.smtpauth3.wiscmail.wisc.edu by smtpauth3.wiscmail.wisc.edu (Sun Java(tm) System Messaging Server 7u2-7.05 32bit (built Jul 30 2009)) id <0LI2002083KXTL00@smtpauth3.wiscmail.wisc.edu>; Mon, 14 Mar 2011 11:38:57 -0500 (CDT) Received: from anacreon.physics.wisc.edu (anacreon.physics.wisc.edu [128.104.160.176]) by smtpauth3.wiscmail.wisc.edu (Sun Java(tm) System Messaging Server 7u2-7.05 32bit (built Jul 30 2009)) with ESMTPSA id <0LI2000OQ3KR2O10@smtpauth3.wiscmail.wisc.edu>; Mon, 14 Mar 2011 11:38:51 -0500 (CDT) Date: Mon, 14 Mar 2011 11:38:51 -0500 From: Nathan Whitehorn In-reply-to: To: Giorgos Keramidas Message-id: <4D7E449B.5020209@freebsd.org> X-Spam-Report: AuthenticatedSender=yes, SenderIP=128.104.160.176 X-Spam-PmxInfo: Server=avs-10, Version=5.6.0.2009776, Antispam-Engine: 2.7.2.376379, Antispam-Data: 2011.3.14.161528, SenderIP=128.104.160.176 References: <4D7E228A.4090906@freebsd.org> User-Agent: Mozilla/5.0 (X11; U; FreeBSD powerpc; en-US; rv:1.9.2.15) Gecko/20110305 Thunderbird/3.1.9 Cc: freebsd-current Current , freebsd-sysinstall@freebsd.org, FreeBSD Arch Subject: Re: HEADS UP: sysinstall is no longer the default installer X-BeenThere: freebsd-sysinstall@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Sysinstall Work List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 14 Mar 2011 16:38:58 -0000 On 03/14/11 10:38, Giorgos Keramidas wrote: > On Mon, Mar 14, 2011 at 3:13 PM, Nathan Whitehorn > wrote: >> Changes to release(7) >> ----------------------------- >> >> Release builds work and look slightly different now, so everyone who >> snapshot tinderboxes will likely find them breaking shortly. The nearest >> analog to the old make release (with version-control checkouts and a chroot) >> is src/release/generate-release.sh, which can be run as generate-release.sh >> head /path/to/chroot/dir. If you want to include ports and documentation on >> the release media, CVSUP_HOST must be defined in the environment to point to >> a cvsup mirror. The output is placed in /R in the chroot directory, as >> before. >> >> If the chroot is unimportant (it ensures a total clean-room build, but may >> not be necessary in most cases), you can get a release build using the >> regular makefile, like so: >> cd /usr/src >> make buildworld buildkernel >> cd /usr/src/release >> make obj release >> >> By default, this will include ports and documentation if you have them >> checked out to /usr/ports and /usr/doc, though this behavior can be modified >> (see the top of the makefile). In addition, some architectures (i386, amd64, >> powerpc, powerpc64, and maybe ia64) have release media that can be >> cross-built, so you can set TARGET/TARGET_ARCH appropriately for those. >> Output goes to .OBJDIR, which is /usr/obj/usr/src/release in the case of the >> above commands. The equivalent to disc1 is called release.iso, the memstick >> image (i386, amd64 only) is called memstick, and a directory of distfiles >> for FTP mirrors is generated named ftp. > Any "user interface" changes that affect the release.7 manpage and may > catch people building their own release images should be updated in the > manpage itself too. Yes. I was hoping to update the manpage in the next couple days. > Some of the stuff I'd like to see fixed in the release.7 manpage are: > > - The requirement for CVSUP_HOST should be explicitly mentioned in > release.7 for releases that have NODOC. > > Note: I haven't run a release with the new Makefile yet, but is it > still possible to use a local CVS mirror, e.g. /home/ncvs for these > files instead of a cvsup host that is only accessible over the > (potentially much slower) network? It isn't possible right now. If you have a pre-existing checkout (from whatever source), make release will use that. John Baldwin mentioned the cvs changes to generate-release.sh and I'll try to get those in soon. > - The make variable ${DATE} is automatically set to the build date. We > should probably mention this in the default BUILDNAME description > (since it's such a generic variable name). > > - BUILDNAME is automatically set to a default that may have to be > documented to the manpage, so that people know what to expect when > they type just "make release" and sit back. > > - There's a ${BASE} variable set to 9.0 that release engineers may > have to manually update when they roll-out release and stable > branches. This should be documented in the "shortly before the > release" checklist we have in > http://www.freebsd.org/doc/en_US.ISO8859-1/articles/releng/release-proc.html Some (most) of these variables don't exist anymore. The CD is just always named 'release.iso' at the moment, for instance. That can easily be changed, however. > - The directories that "make release" creates, and the names of the > ISO image files should be mentioned in release.7 now that we have a > chance to make a batch of useful updates to the text. > > Naturally, I volunteer to *make* the mdoc changes. As long as someone > (e.g. you Nathan?) who is acquainted with the new release building > Makefile can hepl me by reviewing the updates and making sure they look > reasonably close to the new state of everything. Sure. I have the feeling that there are going to be a lot of feature and change requests today with regard to release infrastructure, so I'll let the dust clear for a day or two and we can start hashing out the documentation. -Nathan