XSPASSWD(1)

NAME
xspasswd - Manager for WWW authentication passwords using the XS-HTTPD

SYNOPSIS
xspasswd

DESCRIPTION OF XSPASSWD
XSPASSWD is a program that lets you manage the usercode/password database for the authentication feature of the XS-HTTPD.

Authentication works very simply: if a file called .xsauth is present in the directory in which a file is going to be retrieved, then the remote user will be asked for a usercode and password before the file is allowed to be retrieved. This program manages the .xsauth file.

RUNNING XSPASSWD
Change your current directory to the directory that you wish to protect with usercodes and passwords. Note that subdirectories of that subdirectory are not protected. You have to place a seperate .xsauth file per directory that you wish to protect. You can of course use symbolic or hard links to make them all equal.

Then, type xspasswd. The program will start up. It will ask you for a username. Type a username and press ENTER. Then, the program asks for a password for that username. Type something press ENTER. The program then asks you to re-enter the password that you just typed. Do that and press ENTER again. Now the program asks if you wish to lock the password. If you answer yes, it will not be possible to change the password using the WWW form (see below). If you answer no, it is possible to change the password using the WWW form. After you press ENTER, the program will update (or create) the .xsauth file.

Note that you can have as many usercodes and passwords as you wish.

You can also use this program to change passwords. Just type an existing username when the program prompts you for a username. You do not have to enter the old password. Users using the WWW form are required to enter the old password before changing it to a new one.

THE WWW FORM
This program has a similar program for the WWW. This other program is called xschpass. It can be used by making a link to the following URL:

http://your.site.name/cgi-bin/xschpass/~USERNAME/directory

where USERNAME is your usercode on that system. directory is the directory in which the .xsauth file is situated.

Users using the WWW form are only allowed to change a password if they know the old password.

ACKNOWLEDGEMENTS
I thank all the members at MCGV Stack who are actively involved in the entire WWW happening.

SEE ALSO
http://www.stack.nl/~sven/xs-httpd/
httpd(1), imagemap(1), clearxs(1), readxs(1), gfxcount(1), xsindex(1), httpdc(1)

COPYRIGHT
All the programs in the XS-HTTPD package are copyright (C) 1995, 1996 by Sven Berkvens, except the imagemapper.

AUTHOR
The author of the XS WWW server and its accompanying programs is Sven Berkvens (sven@stack.nl). I made all the programs, except the imagemapper, which I took from the NCSA distribution, but I cleaned it up.