Bug 94587

Summary: Error in ftpusers(5) manpage
Product: Documentation Reporter: Martin Nilsson <martin>
Component: Books & ArticlesAssignee: freebsd-doc (Nobody) <doc>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   
Attachments:
Description Flags
ftpusers.diff none

Description Martin Nilsson 2006-03-17 06:10:13 UTC
---
FILES
     /etc/ftpchroot                     List of normal users who should have
                                        their ftp session's root directory
                                        changed by using chroot(2).
     /etc/ftpusers                      This file.
     /usr/share/examples/ftpd/ftpusers  A sample ftpusers file.
---

The sample ftpusers file is really in:
/usr/share/examples/etc/ftpusers
Comment 1 Daniel Gerzo 2006-03-17 09:12:06 UTC
Hello,

   The diff is included, thank you for your report!

-- 
Sincerely,
   Daniel Gerzo
Comment 2 Martin Nilsson 2006-03-17 09:23:49 UTC
Daniel Gerzo skrev:
 > Hello,
 >
 >    The diff is included, thank you for your report!

There is another one in: man 5 ftpd.conf

FILES
      /etc/ftpd.conf                      This file.
      /usr/share/examples/ftpd/ftpd.conf  A sample ftpd.conf file.

The sample file is completely missing, it's not even present in the source.

/Martin

 >
 >
 >
 > ------------------------------------------------------------------------
 >
 > --- ftpusers.5~	Fri Mar 17 10:06:11 2006
 > +++ ftpusers.5	Fri Mar 17 10:08:57 2006
 > @@ -174,7 +174,7 @@
 >  .Xr chroot 2 .
 >  .It Pa /etc/ftpusers
 >  This file.
 > -.It Pa /usr/share/examples/ftpd/ftpusers
 > +.It Pa /usr/share/examples/etc/ftpusers
 >  A sample
 >  .Nm
 >  file.
Comment 3 Daniel Gerzo 2006-03-17 10:13:31 UTC
Hello Martin,

Friday, March 17, 2006, 10:30:27 AM, you wrote:

> The following reply was made to PR docs/94587; it has been noted by GNATS.


>   > Hello,
>   >
>   >    The diff is included, thank you for your report!
>  
>  There is another one in: man 5 ftpd.conf
>  
>  FILES
>        /etc/ftpd.conf                      This file.
>        /usr/share/examples/ftpd/ftpd.conf  A sample ftpd.conf file.
>  
>  The sample file is completely missing, it's not even present in the source.

I would say, it's because the ftpd.conf is not part of our native
ftpd(8) implementation and is part of lukemftpd from NetBSD which is
contributed software. That software doesn't include the sample config
file and that's why it isn't there. Also, we don't update manual pages
from contrib/ directory. You should probably go to NetBSD maintainers
and ask them to fix it, so it will be fixed in our tree on next
import.

>  
>  /Martin

-- 
Best regards,
 Daniel Gerzo                          mailto:danger@rulez.sk
Comment 4 Ceri Davies 2006-03-19 18:29:17 UTC
On 17/3/06 09:20, "Daniel Gerzo" <danger@rulez.sk> wrote:

> The following reply was made to PR docs/94587; it has been noted by GNATS.
> 
> From: Daniel Gerzo <danger@rulez.sk>
> To: bug-followup@FreeBSD.org, martin@gneto.com
> Cc:  
> Subject: Re: docs/94587: Error in ftpusers(5) manpage
> Date: Fri, 17 Mar 2006 10:12:06 +0100
> 
>  --mYCpIKhGyMATD0i+
>  Content-Type: text/plain; charset=us-ascii
>  Content-Disposition: inline
>  
>  Hello,
>  
>     The diff is included, thank you for your report!

>  --- ftpusers.5~ Fri Mar 17 10:06:11 2006
>  +++ ftpusers.5 Fri Mar 17 10:08:57 2006
>  @@ -174,7 +174,7 @@
>   .Xr chroot 2 .
>   .It Pa /etc/ftpusers
>   This file.
>  -.It Pa /usr/share/examples/ftpd/ftpusers
>  +.It Pa /usr/share/examples/etc/ftpusers
>   A sample
>   .Nm
>   file.

No.  /usr/share/examples/etc/ftpusers contains a list of users who should
not be allowed to log in.  The ftpusers referred to above (and indeed
ftp.conf.5 and this man page) contains a list of users who should be allowed
to log in.  There is a very important difference.

All of the man pages belonging to NetBSD's FTP daemon should be renamed so
that they don't conflict, because this is too confusing.  I recommend that
this PR get assigned to whoever does the import of the lukemftpd stuff.

Ceri
-- 
That must be wonderful!  I don't understand it at all.
                                      -- Moliere



_______________________________________________
freebsd-doc@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/freebsd-doc
To unsubscribe, send any mail to "freebsd-doc-unsubscribe@freebsd.org"
Comment 5 Ceri Davies 2006-03-19 19:43:32 UTC
On 19/3/06 18:40, "Ceri Davies" <ceri@submonkey.net> wrote:

>  All of the man pages belonging to NetBSD's FTP daemon should be renamed so
>  that they don't conflict, because this is too confusing.  I recommend that
>  this PR get assigned to whoever does the import of the lukemftpd stuff.

Turns out I raised a PR for this 3.5 years ago: docs/44519.

Ceri
-- 
That must be wonderful!  I don't understand it at all.
                                      -- Moliere



_______________________________________________
freebsd-questions@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/freebsd-questions
To unsubscribe, send any mail to "freebsd-questions-unsubscribe@freebsd.org"
Comment 6 Maxim Konovalov freebsd_committer freebsd_triage 2006-04-15 11:36:16 UTC
State Changed
From-To: open->closed

We have tree practically identical doc PRs (44519, 93785 and this one) 
about ftpd(8) vs likemftpd(8) man pages.  Close this one.