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)

Debian GNU/Linux                                  November 2002                                  htpasswd.php(1)