htpasswd.nanoweb

Langue: en

Version: November 2002 (ubuntu - 07/07/09)

Section: 1 (Commandes utilisateur)

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)