From owner-freebsd-sysinstall@FreeBSD.ORG Mon Mar 14 16:06:56 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 87C7E106564A; Mon, 14 Mar 2011 16:06:56 +0000 (UTC) (envelope-from gkeramidas@gmail.com) Received: from mail-gw0-f54.google.com (mail-gw0-f54.google.com [74.125.83.54]) by mx1.freebsd.org (Postfix) with ESMTP id 033528FC1B; Mon, 14 Mar 2011 16:06:55 +0000 (UTC) Received: by gwb15 with SMTP id 15so2142372gwb.13 for ; Mon, 14 Mar 2011 09:06:55 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=domainkey-signature:mime-version:sender:in-reply-to:references:date :x-google-sender-auth:message-id:subject:from:to:cc:content-type; bh=AjyZVvpTnzOoCjk5gMTbmfxlZR6dynwnPh9hese2XAQ=; b=HEWe/0ewyVtYeyk5GJU01hJHLXTI9k6ohs305TPG2qTi698ttEB9ZYomnXMJ4hXaDy Hhf8Yh61nzo9sAytFdSFeZuIHxWzWPO4a90qy0iFXjte5Qff6zb48EQLQfjrAulx7DfB JgPgJ/cb8C6jOL5ySk6DvqECHBchLSpHHh6Ws= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=mime-version:sender:in-reply-to:references:date :x-google-sender-auth:message-id:subject:from:to:cc:content-type; b=nqVjxvD0AUWqRTp4sPBvnIrLNUzQ6JYQ8VC98C1YENgR2F2eGg/YrubfZlPC3dIXFY uPVKE+DjaNWPD3trKqz1VwlLzh484MEOoRaTpy7XbR8rKu0yH35BOnxSbUetqiREVAoN DKmHV5lr/wZCEgfHdpdshU4HI2BAWPqAqvkaM= MIME-Version: 1.0 Received: by 10.147.58.20 with SMTP id l20mr9854196yak.26.1300117086639; Mon, 14 Mar 2011 08:38:06 -0700 (PDT) Sender: gkeramidas@gmail.com Received: by 10.147.181.12 with HTTP; Mon, 14 Mar 2011 08:38:05 -0700 (PDT) In-Reply-To: <4D7E228A.4090906@freebsd.org> References: <4D7E228A.4090906@freebsd.org> Date: Mon, 14 Mar 2011 16:38:05 +0100 X-Google-Sender-Auth: eS4jBgbfHjjgiz4Up3bKCeLHgMg Message-ID: From: Giorgos Keramidas To: Nathan Whitehorn Content-Type: text/plain; charset=UTF-8 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:06:56 -0000 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. 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? - 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 - 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.