htpasswd - 管理用于basic认证的用户文件

htpasswd建立和更新存储用户名、密码的文本文件，用于对HTTP用户的basic认证。如果htpasswd不能存取文件，比如，不能写入到输出文件中，或者读取需要更新的文件，它将不做任何改变，并返回一个出错代码。

Apache HTTP服务器上的有效资源可以被限制为由htpasswd建立的文件中的用户所访问。此程序只能管理存储在文本文件中的用户名和密码，但是，它可以加密并显示密码信息，从而可以为其他数据存储类型所利用。要使用DBM数据库，见.

htpasswd使用专为Apache作了修改的MD5或系统函数crypt()加密密码。 htpasswd所管理的文件可以包含两种类型的密码；有些用户的密码使用MD5加密的，而同一个文件中的其他用户是用crypt()加密的。

本手册页仅列出命令行参数，配置用户认证的相关指令的细节请参见httpd手册，它是Apache发行包的一部分，也可以访问。

安全方面的提示

参见

发行版中support/SHA1目录下的脚本

htpasswd [ -c ] [ -m ] passwdfile username

htpasswd -b [ -c ] [ -m | -d | -p | -s ] passwdfile username password

htpasswd -n [ -m | -d | -s | -p ] username

htpasswd -nb [ -m | -d | -s | -p ] username password

-b: 使用批处理方式; 即, 从命令行中获得密码，而不显示提示要求输入。此选项的使用应该极为谨慎，因为命令行中的密码是清晰可见的。
-c: 建立passwdfile文件。如果passwdfile已经存在，则它被重写并截断。此选项不能与-n选项同时使用。
-n: 在标准输出设备上显示结果，而不更新文件。用于生成可以为Apache非文本输出存储格式所接受的密码记录。此选项在命令行中的语法有所改变，因为passwdfile参数(通常是第一个)被省略了。此选项不能与-c选项同时使用。
-m: 使用MD5加密密码。在Windows, Netware 和TPF上，这是默认的。
-d: 使用crypt()加密密码。在除了Windows, Netware和TPF的平台上，这是默认的。虽然它在所有平台上可以为htpasswd所支持，但是在Windows, Netware和TPF上不能为服务器所支持。
-s: 使用SHA加密密码。它是为了方便转入或移植到使用LDAP Directory Interchange Format (ldif)的Netscape而设计的。
-p: 使用纯文本的密码。虽然在所有平台上htpasswd都可以建立这样的密码，但是后台只在Windows, Netware和TPF上支持纯文本的密码。
passwdfile: 包含用户名和密码的文件的名称。如果使用了-c，而此文件不存在则建立，如果已经存在，则重写并截断此文件。
username: 需要在passwdfile中建立或更新的用户名。如果此文件中username不存在，则增加一项，如果已经存在，则改变其密码。
password: 将被加密并存储到文件中的纯文本的密码。仅用于和-b选项同时使用。

如果htpasswd成功地在passwdfile中增加或修改了用户名和密码，则其返回值是0("真")；如果存取文件发生某种错误，则返回1；如果命令行语法有问题，则返回2；如果进入交互状态而两次输入的密码不相同，则返回3；如果操作被中断，则返回4；如果一个值太长(用户名、文件名、密码或者最后得到的记录长度)，则返回5；如果用户名包含非法字符(见)，则返回6。