Date: Mon, 8 Oct 2007 12:28:07 -0400 (EDT) From: Wesley Shields <wxs@atarininja.org> To: FreeBSD-gnats-submit@FreeBSD.org Subject: docs/117024: [patch]: Fix handbook chapter 15.6.1.3 Message-ID: <20071008162807.BA8E45C34@syn.atarininja.org> Resent-Message-ID: <200710081630.l98GU2AD003370@freefall.freebsd.org>
next in thread | raw e-mail | index | archive | help
>Number: 117024 >Category: docs >Synopsis: [patch]: Fix handbook chapter 15.6.1.3 >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Mon Oct 08 16:30:02 GMT 2007 >Closed-Date: >Last-Modified: >Originator: Wesley Shields >Release: FreeBSD 6.2-RELEASE-p5 amd64 >Organization: >Environment: System: FreeBSD syn.csh.rit.edu 6.2-RELEASE-p5 FreeBSD 6.2-RELEASE-p5 #7: Thu May 24 09:18:59 EDT 2007 root@syn.csh.rit.edu:/usr/obj/usr/src/sys/SMP amd64 >Description: The jail rc script now complains when trying to mount filesystems inside the jail if any of the parent directories of the mountpoint are a symlink. The handbook (chapter 15.6.1.3) contains the following text: jail_enable="YES" jail_set_hostname_allow="NO" jail_list="ns mail www" jail_ns_hostname="ns.example.org" jail_ns_ip="192.168.3.17" jail_ns_rootdir="/home/j/ns" jail_ns_devfs_enable="YES" jail_mail_hostname="mail.example.org" jail_mail_ip="192.168.3.18" jail_mail_rootdir="/home/j/mail" jail_mail_devfs_enable="YES" jail_www_hostname="www.example.org" jail_www_ip="62.123.43.14" jail_www_rootdir="/home/j/www" jail_www_devfs_enable="YES" By default /home is a symlink to /usr/home and therefor devfs will not be mounted in the jails. In fact, they refuse to start. I've attached a patch which changes the rootdir to not contain a symlink. This is my first patch to any of the documentation so please let me know if I did anything wrong, I'll be glad to do what I can to fix it up. A brief discussion about this can be found at: http://lists.freebsd.org/pipermail/freebsd-doc/2007-June/012671.html I still maintain that the text quoted in that thread is not sufficient given the examples and the behavior displayed. >How-To-Repeat: wxs@ack ~ % grep ^jail /etc/rc.conf jail_enable="YES" jail_interface="bge0" jail_list="test" jail_test_hostname="test" jail_test_ip="192.168.1.222" jail_test_rootdir="/home/wxs/test" jail_test_devfs_enable="YES" wxs@ack ~ % sudo /etc/rc.d/jail start Configuring jails:. Starting jails:/etc/rc.d/jail: WARNING: /home/wxs/test/dev has symlink as parent - not starting jail test . wxs@ack ~ % >Fix: Index: chapter.sgml =================================================================== RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/handbook/jails/chapter.sgml,v retrieving revision 1.13 diff -u -r1.13 chapter.sgml --- chapter.sgml 29 May 2007 12:10:12 -0000 1.13 +++ chapter.sgml 8 Oct 2007 14:45:59 -0000 @@ -775,15 +775,15 @@ jail_list="ns mail www" jail_ns_hostname="ns.example.org" jail_ns_ip="192.168.3.17" -jail_ns_rootdir="/home/j/ns" +jail_ns_rootdir="/usr/home/j/ns" jail_ns_devfs_enable="YES" jail_mail_hostname="mail.example.org" jail_mail_ip="192.168.3.18" -jail_mail_rootdir="/home/j/mail" +jail_mail_rootdir="/usr/home/j/mail" jail_mail_devfs_enable="YES" jail_www_hostname="www.example.org" jail_www_ip="62.123.43.14" -jail_www_rootdir="/home/j/www" +jail_www_rootdir="/usr/home/j/www" jail_www_devfs_enable="YES"</programlisting> </step> <step> >Release-Note: >Audit-Trail: >Unformatted:
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20071008162807.BA8E45C34>