Subject: misc/5545: Sup and supfilesrv manuals are insufficent
To: None <firstname.lastname@example.org>
From: Charlie Root <email@example.com>
Date: 06/05/1998 10:28:11
>Synopsis: Alot of data is missing from sup and supfilesrv man pages
>Responsible: misc-bug-people (Misc Bug People)
>Arrival-Date: Fri Jun 5 10:20:00 1998
>Originator: Charlie Root
Tim Rightnour - firstname.lastname@example.org
>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: 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
(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?
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.