From owner-svn-doc-all@FreeBSD.ORG Sun Nov 18 14:58:03 2012 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id 49EEB966; Sun, 18 Nov 2012 14:58:03 +0000 (UTC) (envelope-from linimon@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id 244A18FC08; Sun, 18 Nov 2012 14:58:03 +0000 (UTC) Received: from svn.freebsd.org (localhost [127.0.0.1]) by svn.freebsd.org (8.14.5/8.14.5) with ESMTP id qAIEw2rk048179; Sun, 18 Nov 2012 14:58:02 GMT (envelope-from linimon@svn.freebsd.org) Received: (from linimon@localhost) by svn.freebsd.org (8.14.5/8.14.5/Submit) id qAIEw2h2048178; Sun, 18 Nov 2012 14:58:02 GMT (envelope-from linimon@svn.freebsd.org) Message-Id: <201211181458.qAIEw2h2048178@svn.freebsd.org> From: Mark Linimon Date: Sun, 18 Nov 2012 14:58:02 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r40065 - head/en_US.ISO8859-1/articles/portbuild X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees \(except for " user" , " projects" , and " translations" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 18 Nov 2012 14:58:03 -0000 Author: linimon Date: Sun Nov 18 14:58:02 2012 New Revision: 40065 URL: http://svnweb.freebsd.org/changeset/doc/40065 Log: We switched away from building in chroots to building in jails some time ago. Make the document reflect this. Modified: head/en_US.ISO8859-1/articles/portbuild/article.xml Modified: head/en_US.ISO8859-1/articles/portbuild/article.xml ============================================================================== --- head/en_US.ISO8859-1/articles/portbuild/article.xml Sun Nov 18 14:39:46 2012 (r40064) +++ head/en_US.ISO8859-1/articles/portbuild/article.xml Sun Nov 18 14:58:02 2012 (r40065) @@ -167,7 +167,7 @@ interesting data (ports and src trees, bindist tarballs, scripts, etc.) to disconnected nodes during the node-setup phase. Then, the disconnected portbuild directory is - nullfs-mounted for chroot builds. + nullfs-mounted for jail builds. The ports-${arch} @@ -191,27 +191,27 @@ - Chroot Build Environment Setup + Jail Build Environment Setup Package builds are performed in a - chroot populated by the + jail populated by the portbuild script using the ${arch}/${branch}/builds/${buildid}/bindist.tar file. - The following command builds a world from the + The makeworld command builds a world from the ${arch}/${branch}/builds/${buildid}/src/ tree and installs it into - ${worlddir}. The tree will + ${arch}/${branch}/builds/${buildid}/bindist.tar. + The tree will be updated first unless -nocvs is - specified. + specified. It should be run as root: /var/portbuild&prompt.root; scripts/makeworld ${arch} ${branch} ${buildid} [-nocvs] The bindist.tar tarball is created from the previously installed world by the mkbindist - script. It should be run as root with the following - command: + script. It should be also be run as root: /var/portbuild&prompt.root; scripts/mkbindist ${arch} ${branch} ${buildid} @@ -915,7 +915,7 @@ PKG_BIN=/usr/local/sbin/pkg &prompt.user; /var/portbuild/scripts/build cleanup i386 8-exp 20080714120411 -full If you forget to do this, then the old build - chroots will not be cleaned up for 24 hours, and no + jails will not be cleaned up for 24 hours, and no new jobs will be dispatched in their place since pointyhat thinks the job slot is still occupied. @@ -1564,9 +1564,13 @@ umount: Cleanup of /x/tmp/8-exp/chroot/5 Pick a directory to hold ports configuration and - chroot subdirectories. It may be + chroot subdirectories. It may be best to put it this on its own partition. (Example: /usr2/.) + + The filename chroot is a + a historical remnant. + @@ -2011,7 +2015,7 @@ touch /tmp/.boot_finished between boots then they must either preserve their /tmp, or revalidate their available builds at boot time (see the script on the amd64 - machines). They must also clean up stale chroots from previous + machines). They must also clean up stale jails from previous builds before creating /tmp/.boot_finished.