Apache > HTTP Server > 文档 > 版本2.2 > 支持程序
   致谢 | 本篇译者:金步国(其他作品) | 本页最后更新:2006年10月20日[查看最新版本]

dbmmanage - 管理DBM格式的用户认证文件

dbmmanage建立和更新存储用户名和密码的DBM格式的文件,以用于mod_authn_dbm对HTTP用户进行基本认证。Apache HTTP服务器上的有效资源可以被限制为仅允许由dbmmanage建立的文件中的用户所访问。此程序仅用于用户名是存储在一个DBM文件中的情况下,如果使用文本数据库,请参见htpasswd

本手册页仅列出命令行参数,配置用户认证的相关信息请参见认证、授权、访问控制文档。

语法

dbmmanage [ encoding ] filename add|adduser|check|delete|update username [ encpasswd [ group[,group...] [ comment ] ] ]

dbmmanage filename view [ username ]

dbmmanage filename import

选项

filename
DBM格式文件的文件名。一般不带 .db, .pag, .dir 后缀。
username
操作所针对的用户。username中不能有冒号(:)。
encpasswd
这是已经加密的密码,用于updateadd命令。使用一个连字符(-)可以显示输入密码的提示,然后输入。另外,在用于update命令时,使用一个句号(.)可以保持原有密码不变。
group
用户所属的组名,组名中不能有冒号(:)。如果不希望指定该用户所属的组,可以使用一个连字符(-),但是需要填写comment项。另外,在用于update命令时,使用一个句号(.)可以保持原来所属的组不变。
comment
这是对该用户的说明,如真实姓名、邮件地址之类。服务器本身并不使用此信息。

编码

-d
crypt 加密(在Windows和Netware以外平台上的默认值)
-m
MD5 加密(在Windows和Netware平台上的默认值)
-s
SHA1 加密
-p
纯文本(不推荐)

命令

add
filename中增加一个包含了username和已加密密码encpasswd的项。

dbmmanage passwords.dat add rbowen foKntnEF3KSXA

adduser
要求输入密码,然后在filename中增加一个username项。

dbmmanage passwords.dat adduser krietz

check
要求输入密码,然后检查filename中是否存在username并且其密码与输入的相同。

dbmmanage passwords.dat check rbowen

delete
filename中删除username项。

dbmmanage passwords.dat delete rbowen

import
STDIN读取 username:password 的信息(每行一对),然后增加到filename中。其中的密码必须是已加密的。
update
类似adduser命令,但是它可以确认username已经存在于filename中。

dbmmanage passwords.dat update rbowen

view
仅显示DBM文件的内容。如果指定了username则仅显示该用户的信息。

dbmmanage passwords.dat view

Bugs

注意,实际上存在有许多不同的DBM文件格式,你的系统中也可能存在不止一种的支持库,常见的有SDBM, NDBM, GDBM, Berkeley DB 2 。麻烦的是,所有这些库都使用了不同的文件格式,因而你必须确保filename所采用的格式能够为dbmmanage所接受。目前,dbmmanage无法自己确定所查找的文件的DBM类型。如果使用了错误的格式,则简单返回nothing ,或者建立一个不同名称的不同的DBM文件,而最坏的情况是,在试图写入这个文件时,可能会破坏该DBM文件。

dbmmanage有一个DBM格式参数选择列表,在程序前部由 @AnyDBM::ISA 数组定义。由于我们更喜欢 Berkeley DB 2 格式,dbmmanage查找系统库的顺序是:Berkeley DB 2, NDBM, GDBM, SDBM 。dbmmanage会使用第一个找到的库来处理所有的DBM文件操作。此顺序与perl中标准的 @AnyDBM::ISA 的顺序略微不同,所以,如果要使用任何其他工具来管理DBM文件,则必须确保该工具是按此顺序处理的。在用其他语言比如C的程序来处理这些文件时,也要考虑这一点。

在大多数Unix系统中,都可以用file程序来查看DBM文件的格式。