Apache 2.0手册中文版翻译项目 [本文译者: kajaa * ]

项目说明 | 项目进度 | 项目讨论区 | Apache手册中文版

 


dbmmanage - 管理DBM格式的用户认证文件 - Apache HTTP服务器
<-
Apache主站 > HTTP服务器 > 文档 > 2.0版本 > Programs

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

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

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

参见

top

概要

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

dbmmanage filename view [ username ]

dbmmanage filename import

top

选项

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

编码

-d
crypt encryption (这是默认值,除非在Win32和Netware平台上)
-m
MD5 encryption (这是在Win32和Netware平台上的默认值)
-s
SHA1 encryption
-p
纯文本(不推荐使用)

命令

add
filename中 增加一个包含了username和已加密密码encpasswd的项。
adduser
要求输入密码,然后在filename增加一个username的项
check
要求输入密码,然后检查filename中是否存在username, 并且其密码与输入的相同。
delete
filename中删除username项。
import
STDIN读取username:password的信息 (每行一对),然后增加到filename中。其中的密码必须是已加密的
update
类似与adduser命令, 但是它可以确认username已经存在于filename中。
view
仅显示DBM文件的内容。 如果指定了username,则仅显示该用户的信息。
top

Bugs

你必须意识到,实际上存在有许多不同的DBM文件格式, 你的系统中也可能存在不止一种的支持库, 常见的有SDBM, NDBM, the GNU project's 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文件的格式。

 


项目维护者: kajaa [本文译者: kajaa * ]

项目说明 | 项目进度 | 项目讨论区 | Apache手册中文版