From nobody@FreeBSD.org  Thu Jun 25 14:32:48 2009
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 784681065687
	for <freebsd-gnats-submit@FreeBSD.org>; Thu, 25 Jun 2009 14:32:48 +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 6607A8FC17
	for <freebsd-gnats-submit@FreeBSD.org>; Thu, 25 Jun 2009 14:32:48 +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 n5PEWlfm009654
	for <freebsd-gnats-submit@FreeBSD.org>; Thu, 25 Jun 2009 14:32:47 GMT
	(envelope-from nobody@www.freebsd.org)
Received: (from nobody@localhost)
	by www.freebsd.org (8.14.3/8.14.3/Submit) id n5PEWlvg009653;
	Thu, 25 Jun 2009 14:32:47 GMT
	(envelope-from nobody)
Message-Id: <200906251432.n5PEWlvg009653@www.freebsd.org>
Date: Thu, 25 Jun 2009 14:32:47 GMT
From: Ben Grimm <freebsd@bengrimm.net>
To: freebsd-gnats-submit@FreeBSD.org
Subject: ftpchroot(5) omits an important option
X-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>Number:         136035
>Category:       docs
>Synopsis:       ftpchroot(5) omits an important option
>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:   Thu Jun 25 14:40:00 UTC 2009
>Closed-Date:    
>Last-Modified:  Thu Jun 25 14:50:01 UTC 2009
>Originator:     Ben Grimm
>Release:        7.2 / 8.0
>Organization:
>Environment:
several 7 and 8 installations
>Description:
The man file for ftpchroot contains a lot of very confusing options, but it omits to mention that /etc/ftpchroot can contain a second field which basically chroot's the user in the first field to the directory in the second field.

This option is mentioned in DargonFly's ftpchroot manual:

http://leaf.dragonflybsd.org/cgi/web-man?command=ftpchroot&section=5

------------------------------------------------------------
EXAMPLES
[...]
     And this line will tell ftpd(8) to lock up the user ``joe'' in
     /var/spool/ftp and then to change the current directory to /joe, which is
     relative to the session's new root:

	   joe	/var/spool/ftp/./joe
[...]
------------------------------------------------------------

It looks like ftpchroot(5), ftpd(8) and ftpd.con(5) need a thorough rewrite.

See http://forums.freebsd.org/showthread.php?t=3889 for a recent discussion, leading to the 'DargonFly' solution.
>How-To-Repeat:

>Fix:


>Release-Note:
>Audit-Trail:

From: DutchDaemon <freebsd@bengrimm.net>
To: bug-followup@FreeBSD.org, freebsd@bengrimm.net
Cc:  
Subject: Re: docs/136035: ftpchroot(5) omits an important option
Date: Thu, 25 Jun 2009 16:47:05 +0200

 Addendum:
 
 The 'proper' manual appears to be in /usr/src/libexec/ftpd/ftpchroot.5 
 (and there's /usr/src/libexec/ftpd/ftpd.8 as well).
 
 See an old PR for this exact same problem:
 http://www.freebsd.org/cgi/query-pr.cgi?pr=docs/93785
 
 I think the entire ftpd sub-system needs a complete 'man overhaul' ...
>Unformatted:
