From owner-svn-doc-all@FreeBSD.ORG Fri May 29 20:02:36 2015 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 11B79648; Fri, 29 May 2015 20:02:36 +0000 (UTC) (envelope-from allanjude@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id E8D5C11CD; Fri, 29 May 2015 20:02:35 +0000 (UTC) (envelope-from allanjude@FreeBSD.org) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.9/8.14.9) with ESMTP id t4TK2Zwk064883; Fri, 29 May 2015 20:02:35 GMT (envelope-from allanjude@FreeBSD.org) Received: (from allanjude@localhost) by svn.freebsd.org (8.14.9/8.14.9/Submit) id t4TK2Z2A064882; Fri, 29 May 2015 20:02:35 GMT (envelope-from allanjude@FreeBSD.org) Message-Id: <201505292002.t4TK2Z2A064882@svn.freebsd.org> X-Authentication-Warning: svn.freebsd.org: allanjude set sender to allanjude@FreeBSD.org using -f From: Allan Jude Date: Fri, 29 May 2015 20:02:35 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r46732 - head/en_US.ISO8859-1/books/handbook/jails 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.20 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: Fri, 29 May 2015 20:02:36 -0000 Author: allanjude Date: Fri May 29 20:02:35 2015 New Revision: 46732 URL: https://svnweb.freebsd.org/changeset/doc/46732 Log: Update instructions for manually creating a jail Remove unneeded subshell Remove csh examples, and explicitly use sh everywhere Remove the GAMES set which on longer exists Remove the DOCS set that may be removed in the future, it is not needed inside a jail PR: 194993 Differential Revision: https://reviews.freebsd.org/D2116 Submitted by: alex@kaworu.ch (original) Reviewed by: wblock Approved by: bcr (mentor) Sponsored by: ScaleEngine Inc. Modified: head/en_US.ISO8859-1/books/handbook/jails/chapter.xml Modified: head/en_US.ISO8859-1/books/handbook/jails/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/handbook/jails/chapter.xml Fri May 29 17:15:55 2015 (r46731) +++ head/en_US.ISO8859-1/books/handbook/jails/chapter.xml Fri May 29 20:02:35 2015 (r46732) @@ -205,17 +205,12 @@ To install the userland from installation media, first create the root directory for the jail. This can be done by setting the DESTDIR variable to the proper - location. The command to use depends on which shell is being - used. + location. - When using &man.sh.1;: + Start a shell and define DESTDIR: - &prompt.root; export DESTDIR=/here/is/the/jail - - If csh/tcsh is used, - execute this instead: - - &prompt.root; setenv DESTDIR /here/is/the/jail + &prompt.root; sh +&prompt.root; export DESTDIR=/here/is/the/jail Mount the install media as covered in &man.mdconfig.8; when using the install ISO: @@ -236,31 +231,17 @@ &prompt.root; /mnt/8.4-RELEASE/base/install.sh - To install everything but the kernel, issue this - command: + To install everything except the kernel, issue one of these + commands: - When using &man.sh.1; on &os; 9.x and newer, issue this - command: + When using &os; 9.x and newer: - &prompt.root; for sets in BASE DOC GAMES PORTS; do (tar -xf /mnt/FREEBSD_INSTALL/USR/FREEBSD_DIST/$sets.TXZ -C $DESTDIR) ; done + &prompt.root; for sets in BASE PORTS; do tar -xf /mnt/FREEBSD_INSTALL/USR/FREEBSD_DIST/$sets.TXZ -C $DESTDIR ; done - When using &os; 8.x, run this: + When using &os; 8.x: &prompt.root; cd /mnt/8.4-RELEASE; for dir in base catpages dict doc games info manpages ports; do (cd $dir; ./install.sh) ; done - If csh/tcsh is used on - &os; 9.x and newer, execute this command: - - &prompt.root; foreach sets ( BASE DOC GAMES PORTS ) -tar -xf /mnt/FREEBSD_INSTALL/USR/FREEBSD_DIST/$sets.TXZ -C $DESTDIR -done - - On &os; 8.x, run this command: - - &prompt.root; foreach dir ( base catpages dict doc games info manpages ports ) - cd /mnt/8.4-RELEASE/$dir; ./install.sh -done - The &man.jail.8; manual page explains the procedure for building a jail: @@ -390,14 +371,14 @@ jail_www_devf &prompt.root; service jail start www &prompt.root; service jail stop www - A clean way to shut down a &man.jail.8; is not available at - the moment. This is because commands normally used to - accomplish a clean system shutdown cannot be used inside a jail. - The best way to shut down a jail is to run the following command - from within the jail itself or using the &man.jexec.8; utility - from outside the jail: + Jails can be shut down with &man.jexec.8;. Use &man.jls.8; + to identify the jail's JID, then use + &man.jexec.8; to run the shutdown script in that jail. - &prompt.root; sh /etc/rc.shutdown + &prompt.root; jls + JID IP Address Hostname Path + 3 192.168.0.10 www /usr/jail/www +&prompt.root; jexec 3 /etc/rc.shutdown More information about this can be found in the &man.jail.8; manual page.