Subject: misc/5545: Sup and supfilesrv manuals are insufficent
To: None <>
From: Charlie Root <>
List: netbsd-bugs
Date: 06/05/1998 10:28:11
>Number:         5545
>Category:       misc
>Synopsis:       Alot of data is missing from sup and supfilesrv man pages
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    misc-bug-people (Misc Bug People)
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Fri Jun  5 10:20:00 1998
>Originator:     Charlie Root
Tim Rightnour    -
>Release:        1.3<NetBSD-current source date>
System: NetBSD polaris 1.3 NetBSD 1.3 (POLARIS) #0: Thu Mar 26 13:17:18 MST 1998 root@polaris:/usr/src/sys/arch/i386/compile/POLARIS i386


A ton of information is missing from the supfilesrv and sup man pages.  
For example, if you are trying to set up a sup server, you would look at 
the EXAMPLE section which plainly states:


or if you try to run it, you get:

Jun  5 10:12:48 polaris supfile[16600]: Improper login
SUP: Reason:  Unknown user anon
SUP: Improper login to default accountSUP: Upgrade of current-allsrc 
aborted at Jun  5 10:05:11 1998
SUP: Aborted

(btw, the above is a screen paste, it really does show up like that)

wondering what this means, you dig through the sup manual again, and come 

              Files on the file server may be protected, and net-
              work transmissions may be encrypted.  This prevents
              unauthorized access to files via sup.   When  files
              are  not  accessible  to  the default account (e.g.
              the anon anonymous account),  you  can  specify  an
              alternative  accountid  and  password  for the file
              server to use  on  the  repository  host.   Network
              transmission  of  the  password  will  be always be

Which seems to indicate an "anon" account is nessecary to set up 
anonymous supping from the server end.  No other mention of the account 
"anon" is mentioned anywhere in the manual.

additionally, under FILES in supfilesrv(1):

              directory list file for file server

              host list file for system sups.

while in sup(1):

              base directory list for system collections

so which is it?

man sup
man supfilesrv

Update the manpages with correct, and relevant information..  Include an 
example fileset in /usr/share/examples for people wanting to use sup.

perhaps have an account in /etc/passwd by default for anon, or at least a 
line in the manual that describes what the account should do.  Does it 
need to own the directories?  Does it need a shell, or special group access?

The current manpages lead you on a trial-and-error learning experience, 
it really shouldn't be this hard to set things up.