登录

在成功通过此数据存储的验证之后，将会存储该数据存储后端的用户名和密码。此用户名和密码以后可用于调用 pgtool 命令。

证书存储在管理员主目录中名为 .apocpass 的文件中。如果此文件已存在但不具有正确的权限，命令将退出并报告错误。

如果指定了用户名，则提示管理员输入密码，否则将提示管理员输入用户名和密码。将使用数据存储的匿名访问来验证用户名和密码。如果不支持匿名访问，将提示管理员输入授权的用户名和密码。如果授权的用户名未通过验证，命令将退出并报告错误。

通过验证之后，会使用由主机/端口/基本 DN 和用户名组成的关键字，将用户名/密码对条目存储在管理员的 .apocpass 文件中，以便可以在同一文件中为其他后端存储用户名/密码对 。

可以在命令行中指定引导信息，即使用 - -file 选项指定包含此信息的文件，或者使用 --url 选项直接指定此信息。有关引导的详细信息，请参见 CLI 所需的引导信息。

如果引导信息不可用或者无法创建证书文件，命令将会退出并报告错误。

如果成功创建了证书文件，则不必为使用此存储后端的后续 pgtool 命令指定用户名和密码。此时将使用存储在证书文件中的用户名和密码信息。

语法

login [--username=<username>] [--file=<bootstrap file>] [--url=<url>]

--username=<username>：以存储后端使用的格式表示的管理员用户名，例如 "jmonroe"。

--file=<bootstrap file>：引导文件的全限定路径。默认文件为 $HOME/pgtool.properties。此选项与 --url 选项不兼容。

--url=<url>：用于标识数据存储的 URL。URL 的格式为 ldap://<hostname>:<port>/<base name>，其中 <hostname> 是服务器名称（默认值为 localhost），<port> 是服务器上的端口号（默认值为 389），<base name> 是基本条目的标识名。

示例 3–7 登录

% pgtool login --username=jmonroe [Enter the correct password when prompted]

创建具有 "jmonroe" 和 "password" 条目的 ~/.apocpass 文件，此文件的权限为 600。有关要连接的后端的信息，请参见默认引导文件 ~/pgtool.properties。