MirOS Manual: Net::Config(3p)


Net::Config(3p) Perl Programmers Reference Guide  Net::Config(3p)

NAME

     Net::Config - Local configuration data for libnet

SYNOPSYS

         use Net::Config qw(%NetConfig);

DESCRIPTION

     "Net::Config" holds configuration data for the modules in
     the libnet distribuion. During installation you will be
     asked for these values.

     The configuration data is held globally in a file in the
     perl installation tree, but a user may override any of these
     values by providing their own. This can be done by having a
     ".libnetrc" file in their home directory. This file should
     return a reference to a HASH containing the keys described
     below. For example

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

METHODS

     "Net::Config" defines the following methods. They are
     methods as they are invoked as class methods. This is
     because "Net::Config" inherits from "Net::LocalCfg" so you
     can override these methods if you want.

     requires_firewall HOST
         Attempts to determine if a given host is outside your
         firewall. Possible return values are.

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

         This is done by using hostname lookup and the
         "local_netmask" entry in the configuration data.

NetConfig VALUES

     nntp_hosts
     snpp_hosts
     pop3_hosts
     smtp_hosts
     ph_hosts
     daytime_hosts
     time_hosts
         Each is a reference to an array of hostnames (in order
         of preference), which should be used for the given

perl v5.8.8                2005-02-05                           1

Net::Config(3p) Perl Programmers Reference Guide  Net::Config(3p)

         protocol

     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 to port 21,
         then this value should be set to "hostname:port" (eg
         "hostname:99")

     ftp_firewall_type
         There are many different ftp firewall products avail-
         able. But unfortunately there is no standard for how to
         traverse a firewall.  The list below shows the sequence
         of commands that Net::FTP will use

           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   There is no firewall

         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

perl v5.8.8                2005-02-05                           2

Net::Config(3p) Perl Programmers Reference Guide  Net::Config(3p)

                  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_pasive
         FTP servers normally work on a non-passive mode. That is
         when you want to transfer data you have to tell the
         server the address and port to connect to.

         With some firewalls this does not work as the server
         cannot connect to your machine (because you are behind a
         firewall) and the firewall does not re-write the com-
         mand. In this case you should set "ftp_ext_passive" to a
         true value.

         Some servers are configured to only work in passive
         mode. If you have one of these you can force "Net::FTP"
         to always transfer in passive mode; when not going via a
         firewall, by setting "ftp_int_passive" to a true value.

     local_netmask
         A reference to a list of netmask strings in the form
         "134.99.4.0/24". These are used by the
         "requires_firewall" function to determine if a given
         host is inside or outside your firewall.

     The following entries are used during installation & testing
     on the libnet package

     test_hosts
         If true then "make test" may attempt to connect to hosts
         given in the configuration.

     test_exists
         If true then "Configure" will check each hostname given
         that it exists

     $Id: //depot/libnet/Net/Config.pm#17 $

perl v5.8.8                2005-02-05                           3

Generated on 2014-07-04 21:17:45 by $MirOS: src/scripts/roff2htm,v 1.79 2014/02/10 00:36:11 tg Exp $

These manual pages and other documentation are copyrighted by their respective writers; their source is available at our CVSweb, AnonCVS, and other mirrors. The rest is Copyright © 2002‒2014 The MirOS Project, Germany.
This product includes material provided by Thorsten Glaser.

This manual page’s HTML representation is supposed to be valid XHTML/1.1; if not, please send a bug report – diffs preferred.