Bug 136035

Summary: ftpchroot(5) omits an important option
Product: Documentation Reporter: freebsd
Component: Manual PagesAssignee: freebsd-bugs (Nobody) <bugs>
Status: Closed Overcome By Events    
Severity: Affects Only Me CC: doc, gonzo
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   

Description freebsd 2009-06-25 15:40:00 UTC 
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.
Comment 1 freebsd 2009-06-25 15:47:05 UTC 
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' ...
Comment 2 Eitan Adler freebsd_committer freebsd_triage 2017-12-31 07:59:29 UTC 
For bugs matching the following criteria:

Status: In Progress Changed: (is less than) 2014-06-01

Reset to default assignee and clear in-progress tags.

Mail being skipped
Comment 3 Oleksandr Tymoshenko freebsd_committer freebsd_triage 2018-04-24 22:20:19 UTC 
Old man page was removed along with lukemftpd in base r263160. Resolving as OBE