Bug 136035 - ftpchroot(5) omits an important option
Summary: ftpchroot(5) omits an important option
Status: Closed Overcome By Events
Alias: None
Product: Documentation
Classification: Unclassified
Component: Manual Pages (show other bugs)
Version: Latest
Hardware: Any Any
: Normal Affects Only Me
Assignee: freebsd-bugs (Nobody)
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2009-06-25 15:40 UTC by freebsd
Modified: 2018-04-24 22:20 UTC (History)
2 users (show)

See Also:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
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