NAME
htpasswd.php - http server password file generation tool
SYNOPSIS
htpasswd.php --file=/path/to/.htpasswd --create-file=’box title’
htpasswd.php -f .htpasswd --add-user=’login passwd’
htpasswd.php -f .htpasswd --modify-user=’login passwd’
DESCRIPTION
The htpasswd.php utility can be used to create authentication files to
be used inside Nanoweb. These files are usually called .htpasswd or
.nwauth (deprecated) and can be used with other common webservers as
well.
These authentication files of course contain the passwords in an
encrypted format, usually MD5 or crypt(3), what makes this utility
neccessary for editing these files.
OPTIONS
-f .htpasswd, --file=/var/www/.htpasswd
This specifies the authentication file to be worked on (or that
shall be created).
-c title, --create-file=title
Creates the file given with the -f switch. Nanoweb
authentication files (.nwauth) usually carry an authentication
realm (title) inside, which can be set using this option.
-a login passwd, --add-user=login pw
Use this to add an user name and its password to the
authentication file.
You need to use double quotes or ticks here, as your shell would
otherwise treat the space character as seperator and thus pass
login and password as two seperate arguments to the htpasswd.php
utility.
-m login passwd, --modify-user=login pw
Allows to change the password for a login name, which is already
in the authentication file.
-d, --display-result
Changes made to the authentication file are not written back,
but instead printed to stdout.
-h, --help
Prints out the help screen with all available command line
options.
-v, --version
Shows version information.
BUGS
When the --help switch is given on the command line, the help message
is errornously printed two times.
SEE ALSO
nanoweb.php(8)