Net::Config

(原始碼, CPAN)

版本 3.15

內容

名稱
語法
說明
- 類別方法
- NetConfig 值
匯出
已知錯誤
作者
版權
授權
版本
日期
歷史

#名稱

Net::Config - libnet 的本機組態資料

#語法

use Net::Config qw(%NetConfig);

#說明

Net::Config 儲存 libnet 套件中模組的組態資料。安裝時，系統會詢問您這些值。

組態資料會儲存在 Perl 安裝目錄中的檔案中，但使用者可以提供自己的值來覆寫這些值。方法是在其家目錄中建立 .libnetrc 檔案。此檔案應該傳回一個包含以下所述金鑰的雜湊參照。例如

# .libnetrc
{
    nntp_hosts => [ "my_preferred_host" ],
    ph_hosts   => [ "my_ph_server" ],
}
__END__

#類別方法

Net::Config 定義下列方法。它們是方法，因為它們作為類別方法被呼叫。這是因為 Net::Config 繼承自 Net::LocalCfg，所以您可以覆寫這些方法（如果您願意）。

#requires_firewall($host)

嘗試判斷指定的 host 是否在防火牆外。可能的回傳值為。

-1  Cannot lookup hostname
 0  Host is inside firewall (or there is no ftp_firewall entry)
 1  Host is outside the firewall

這是透過使用主機名稱查詢和設定資料中的 local_netmask 項目來完成的。

#NetConfig 值

#nntp_hosts

#snpp_hosts

#pop3_hosts

#smtp_hosts

#ph_hosts

#daytime_hosts

#time_hosts

每個都是對主機名稱陣列的參考 (依偏好順序)，應該用於指定的通訊協定

#inet_domain

您的網際網路網域名稱

#ftp_firewall

如果您有 FTP 代理防火牆 (不是 HTTP 或 SOCKS 防火牆)，則此值應該設為防火牆主機名稱。如果您的防火牆沒有監聽埠 21，則此值應該設為 "hostname:port" (例如 "hostname:99")

#ftp_firewall_type

有許多不同的 ftp 防火牆產品可用。但很不幸地，沒有如何穿越防火牆的標準。下列清單顯示 Net::FTP 將使用的命令順序

user        Username for remote host
pass        Password for remote host
fwuser      Username for firewall
fwpass      Password for firewall
remote.host The hostname of the remote ftp server

#0

沒有防火牆

#1

USER user@remote.host
PASS pass

#2

USER fwuser
PASS fwpass
USER user@remote.host
PASS pass

#3

USER fwuser
PASS fwpass
SITE remote.site
USER user
PASS pass

#4

USER fwuser
PASS fwpass
OPEN remote.site
USER user
PASS pass

#5

USER user@fwuser@remote.site
PASS pass@fwpass

#6

USER fwuser@remote.site
PASS fwpass
USER user
PASS pass

#7

USER user@remote.host
PASS pass
AUTH fwuser
RESP fwpass

#ftp_ext_passive

#ftp_int_passive

FTP 伺服器可以在被動或主動模式下運作。主動模式是當您想要傳輸資料時，您必須告訴伺服器要連線的位址和埠。被動模式是當伺服器提供位址和埠，而您建立連線時。

對於某些防火牆，主動模式無法運作，因為伺服器無法連線到您的機器 (因為您在防火牆之後)，而防火牆不會重新撰寫命令。在此情況下，您應該將 ftp_ext_passive 設為 true 值。

某些伺服器設定為只能在被動模式下運作。如果您有其中一個，您可以強制 Net::FTP 透過防火牆時，總是使用被動模式傳輸；方法是將 ftp_int_passive 設為 true 值。

#local_netmask

對 "134.99.4.0/24" 形式的網路遮罩字串清單的參考。這些字串由 requires_firewall 函式用來判斷指定的 host 是否在您的防火牆內或外。

下列項目用於 libnet 套件的安裝和測試期間

#test_hosts: 如果為真，則 make test 可能嘗試連線到設定檔中指定的 hosts。
#test_exists: 如果為真，則 Configure 會檢查每個指定的 hostname 是否存在

#EXPORTS

下列符號是，或可以，由這個模組匯出

#預設匯出: %NetConfig.
#選擇性匯出: 無.
#匯出標籤: 無.

#已知錯誤

無.

#作者

Graham Barr <gbarr@pobox.com>。

Steve Hay <shay@cpan.org> 自 1.22_02 版本開始維護 libnet。

#版權

#授權

這個模組是自由軟體；您可以根據與 Perl 相同的條款重新散布或修改它，也就是根據 GNU 通用公共授權條款或 Artistic 授權條款，如 LICENCE 檔案中所指定。

#版本

版本 3.15

#日期

2023 年 3 月 20 日

#歷史

請參閱 Changes 檔案。