Net::Netrc - OO 介面至使用者 netrc 檔案
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 檔案,尋找與指定的遠端機器相符的機器代碼。一旦找到相符的代碼,就會處理後續的 .netrc 代碼,直到到達檔案結尾或遇到其他機器或預設代碼為止。
這與機器名稱相同,但預設會與任何名稱相符。只能有一個預設代碼,而且它必須在所有機器代碼之後。這通常用於
default login anonymous password user@site
從而讓使用者自動匿名登入未在 .netrc 中指定的機器。
識別遠端機器上的使用者。如果存在此代碼,自動登入程序將使用指定的使用者名稱發起登入。
提供密碼。如果存在此代碼,自動登入程序會提供指定的字串,如果遠端伺服器需要密碼作為登入程序的一部分。
提供額外的帳戶密碼。如果存在此代碼,自動登入程序會提供指定的字串,如果遠端伺服器需要額外的帳戶密碼。
定義巨集。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。
Graham Barr <gbarr@pobox.com>。
Steve Hay <shay@cpan.org> 目前維護 libnet,版本為 1.22_02。
版權所有 (C) 1995-1998 Graham Barr。保留所有權利。
版權所有 (C) 2013-2014、2020 Steve Hay。保留所有權利。
這個模組是免費軟體;您可以在與 Perl 相同的條款下重新散布或修改它,也就是在 LICENCE 檔案中指定的 GNU 通用公共授權或 Artistic 授權條款下。
版本 3.15
2023 年 3 月 20 日
請參閱 Changes 檔案。