Perl in a Nutshell, 2nd Edition

Net::Config

Holds configuration data for the modules in the libnet distribution. Net::Config builds this configuration interactively at install time of libnet, and the Net::Config file is further queried when you use modules such as Net::FTP. This module is part of the core Perl distribution starting with Perl 5.8.

Net::Config stores the following values (which can be undef): nntp_hosts, snpp_hosts, pop3_hosts, smtp_hosts, ph_hosts, daytime_hosts, and time_hosts. Each is a reference to an array of hostnames (in order of preference), which should be used for the given protocol. You can override any of the Net::Config values when you use any of the modules that live under the libnet umbrella. In addition, you can maintain your own .libnetrc to hold your custom values all the time. A sample .libnetrc follows:

$ cat .libnetrc
# .libnetrc
{
    nntp_hosts => [ "news.my.host", "news.their.host" ]
}
_  _END_  _

In addition to the options listed previously, the following options can be specified:

inet_domain

Your Internet domain name.

ftp_firewall

If you have an FTP proxy firewall (not an HTTP or SOCKS firewall), then this value should be set to the firewall hostname. If your firewall does not listen on port 21, then this value should be set to hostname:port (e.g., hostname:99).

ftp_firewall_type

An integer from 1 to 7 signifying the sequence of commands that Net::FTP will use to traverse a firewall, as follows:

*

There is no firewall (default).

1

USER [e-mail]
PASS password

2

USER firewall_username ...