内容

名称

Net::Netrc - 用户 netrc 文件的 OO 接口

概要

use Net::Netrc;

$mach = Net::Netrc->lookup('some.machine');
$login = $mach->login;
($login, $password, $account) = $mach->lpa;

描述

Net::Netrc 是一个类,它实现了对 .netrc 文件的简单接口,该文件被 ftp 程序使用。

Net::Netrc 还实现了与 ftp 程序相同的安全检查,这些检查包括:首先,.netrc 文件必须由用户拥有;其次,所有权权限应确保只有所有者具有读写访问权限。如果这些条件不满足,则会输出警告,并且不会读取 .netrc 文件。

.netrc 文件

.netrc 文件包含自动登录过程中使用的登录和初始化信息。它位于用户的 home 目录中。以下标记被识别;它们可以用空格、制表符或换行符分隔

机器名称

标识远程机器名称。自动登录过程会在 .netrc 文件中搜索与指定远程机器匹配的机器令牌。一旦匹配成功,就会处理后续的 .netrc 令牌,直到遇到文件末尾或另一个机器或默认令牌为止。

默认

这与机器名称相同,只是默认匹配任何名称。只能有一个默认令牌,并且它必须位于所有机器令牌之后。这通常用作

default login anonymous password user@site

从而为用户提供对 .netrc 中未指定的机器的匿名自动登录。

登录名称

标识远程机器上的用户。如果存在此令牌,自动登录过程将使用指定的名称启动登录。

密码字符串

提供密码。如果存在此令牌,自动登录过程将在远程服务器需要密码作为登录过程的一部分时提供指定的字符串。

帐户字符串

提供额外的帐户密码。如果存在此令牌,自动登录过程将在远程服务器需要额外的帐户密码时提供指定的字符串。

macdef 名称

定义宏。Net::Netrc 仅解析此字段以与 ftp 兼容。

类方法

Net::Netrc 对象的构造函数不称为 new,因为它实际上并没有创建新的对象。而是称为 lookup,因为这本质上是它所做的。

lookup($machine[, $login])

查找并返回对 $machine 条目的引用。如果给出了 $login,则返回的条目将具有给定的登录。如果没有给出 $login,则将返回 .netrc 文件中 $machine 的第一个条目。

如果找不到匹配的条目,并且存在默认条目,则返回对默认条目的引用。

如果找不到匹配的条目,并且没有定义默认值,或者没有找到 .netrc 文件,则返回 undef

对象方法

login()

返回 netrc 条目的登录 ID

password()

返回 netrc 条目的密码

account()

返回 netrc 条目的帐户信息

lpa()

返回 netrc 条目的登录、密码和帐户信息的列表

导出

.

已知错误

参见 https://rt.cpan.org/Dist/Display.html?Status=Active&Queue=libnet

参见

Net::Cmd.

作者

Graham Barr <[email protected]>。

Steve Hay <[email protected]> 从 1.22_02 版本开始维护 libnet。

版权

版权所有 (C) 1995-1998 Graham Barr。保留所有权利。

版权所有 (C) 2013-2014, 2020 Steve Hay。保留所有权利。

许可证

本模块是自由软件;您可以根据与 Perl 本身相同的条款重新分发和/或修改它,即根据 GNU 通用公共许可证或 Artistic 许可证的条款,如 LICENCE 文件中所述。

版本

版本 3.15

日期

2023 年 3 月 20 日

历史

参见 Changes 文件。