Handbook chapter 15.6 problem

[Wesley Shields]

On Sat, Jun 23, 2007 at 12:29:24PM -0500, illoai at gmail.com wrote:
>  On 22/06/07, Wesley Shields <wxs at atarininja.org> wrote:
> > Someone on IRC just pointed out that following the directions in chapter
> > 15.6 of the handbook doesn't work.  It appears that these instructions
> > were written before SA-07:01 was done.  Setting a rootdir to /home
> > doesn't work since /home is a symlink by default.
> >
> > Am I correct in thinking this?  If so I will gladly write up a patch to
> > fix the handbook.
> 
>  /home by default is only a symlink to /usr/home if
>  you do not set up /home on its own filesystem and
>  even then the instructions say:
>   : Note: This assumes that the jails are based under
>   : the /home partition. This can, of course, be changed
>   : to anything else, but this change will have to be
>   : reflected in each of the examples below.
> 
>  I can hardly see how qualifying it further will clarify
>  anything.

The above message says nothing about the example being broken under
default circumstances; that is, letting sysinstall create the partitions
automatically results in /home being a symlink to /usr/home.  Based upon
the text you quoted above a user knows that putting jails anywhere is
acceptable but they don't know that putting them anywhere with a symlink
in the path is not.

All I'm suggesting is that /home be changed to /usr/home in the
examples.

-- WXS