From owner-freebsd-doc@FreeBSD.ORG Sat Jun 6 16:00:14 2009 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 9DAF41065670 for ; Sat, 6 Jun 2009 16:00:14 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 74A9F8FC1A for ; Sat, 6 Jun 2009 16:00:14 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.14.3/8.14.3) with ESMTP id n56G0E71082115 for ; Sat, 6 Jun 2009 16:00:14 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.3/8.14.3/Submit) id n56G0Eg1082114; Sat, 6 Jun 2009 16:00:14 GMT (envelope-from gnats) Resent-Date: Sat, 6 Jun 2009 16:00:14 GMT Resent-Message-Id: <200906061600.n56G0Eg1082114@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Glen Barber Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 49C791065670 for ; Sat, 6 Jun 2009 15:55:12 +0000 (UTC) (envelope-from nobody@FreeBSD.org) Received: from www.freebsd.org (www.freebsd.org [IPv6:2001:4f8:fff6::21]) by mx1.freebsd.org (Postfix) with ESMTP id 1C9D28FC1E for ; Sat, 6 Jun 2009 15:55:12 +0000 (UTC) (envelope-from nobody@FreeBSD.org) Received: from www.freebsd.org (localhost [127.0.0.1]) by www.freebsd.org (8.14.3/8.14.3) with ESMTP id n56FtBLZ055091 for ; Sat, 6 Jun 2009 15:55:11 GMT (envelope-from nobody@www.freebsd.org) Received: (from nobody@localhost) by www.freebsd.org (8.14.3/8.14.3/Submit) id n56FtBFu055090; Sat, 6 Jun 2009 15:55:11 GMT (envelope-from nobody) Message-Id: <200906061555.n56FtBFu055090@www.freebsd.org> Date: Sat, 6 Jun 2009 15:55:11 GMT From: Glen Barber To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-3.1 Cc: Subject: docs/135316: [patch][doc] Add 'make installworld' section to jails-build.html X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 06 Jun 2009 16:00:14 -0000 >Number: 135316 >Category: docs >Synopsis: [patch][doc] Add 'make installworld' section to jails-build.html >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: change-request >Submitter-Id: current-users >Arrival-Date: Sat Jun 06 16:00:14 UTC 2009 >Closed-Date: >Last-Modified: >Originator: Glen Barber >Release: 7.2-STABLE >Organization: >Environment: FreeBSD phoenix 7.2-STABLE FreeBSD 7.2-STABLE #0 r192129M: Thu May 14 22:53:56 UTC 2009 root@phoenix:/usr/obj/usr/src/sys/GENERIC i386 >Description: Section 15.4 of the jail(8) documentation specifies to 'make world' when creating a jail. Assuming subsequent jail creation will use the same userland / kernel, and are in sync with the host userland / kernel, the need to 'make world' may be unclear to new users after the userland is already built. >How-To-Repeat: >Fix: The attached patch adds a section for subsequent jails, replacing 'make world' with 'make installworld'. Patch attached with submission follows: --- /usr/share/doc/en_US.ISO8859-1/books/handbook/jails-build.html.original 2009-06-06 11:34:02.000000000 -0400 +++ /usr/share/doc/en_US.ISO8859-1/books/handbook/jails-build.html 2009-06-06 11:41:42.000000000 -0400 @@ -66,6 +66,30 @@ vspace="0" border="0" alt="(4)" /> +

If you already have done make world and are adding +more jails to your system, you can exclude make buildworld +and, instead, use the following: +

+# setenv D /here/is/the/jail
+# mkdir -p $D 
+# cd /usr/src
+# make installworld DESTDIR=$D (2)
+# cd etc/ [1]
+# make distribution DESTDIR=$D 
+# mount -t devfs devfs $D/dev (4)
+
+
Release-Note: >Audit-Trail: >Unformatted: