Net::Config - Local configuration data for libnet

<!DOCTYPE html> <html lang="en"> <head> <meta charset="utf-8"> <meta http-equiv="X-UA-Compatible" content="IE=edge"> <meta name="viewport" content="width=device-width, initial-scale=1"> <title>Net::Config - Local configuration data for libnet - Perldoc Browser</title> <link rel="search" href="/opensearch.xml" type="application/opensearchdescription+xml" title="Perldoc Browser"> <link rel="canonical" href="https://perldoc.perl.org/Net::Config"> <link rel="stylesheet" href="https://stackpath.bootstrapcdn.com/bootstrap/4.5.2/css/bootstrap.min.css" integrity="sha384-JcKb8q3iqJ61gNV9KGb8thSsNjpSL0n8PARn9HuZOnIxN0hoP+VmmDGMN5t9UJ0Z" crossorigin="anonymous"> <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/styles/stackoverflow-light.min.css" integrity="sha512-cG1IdFxqipi3gqLmksLtuk13C+hBa57a6zpWxMeoY3Q9O6ooFxq50DayCdm0QrDgZjMUn23z/0PMZlgft7Yp5Q==" crossorigin="anonymous" /> <style> body { background: #f4f4f5; color: #020202; } .navbar-dark { background-image: -webkit-linear-gradient(top, #005f85 0, #002e49 100%); background-image: -o-linear-gradient(top, #005f85 0, #002e49 100%); background-image: linear-gradient(to bottom, #005f85 0, #002e49 100%); filter: progid:DXImageTransform.Microsoft.gradient(startColorstr='#ff005f85', endColorstr='#ff002e49', GradientType=0); background-repeat: repeat-x; } .navbar-dark .navbar-nav .nav-link, .navbar-dark .navbar-nav .nav-link:focus { color: #fff } .navbar-dark .navbar-nav .nav-link:hover { color: #ffef68 } #wrapperlicious { margin: 0 auto; font: 0.9em 'Helvetica Neue', Helvetica, sans-serif; font-weight: normal; line-height: 1.5em; margin: 0; padding: 0; } #wrapperlicious h1 { font-size: 1.5em } #wrapperlicious h2 { font-size: 1.3em } #wrapperlicious h3 { font-size: 1.1em } #wrapperlicious h4 { font-size: 0.9em } #wrapperlicious h1, #wrapperlicious h2, #wrapperlicious h3, #wrapperlicious h4, #wrapperlicious dt { color: #020202; margin-top: 1em; margin-bottom: 1em; position: relative; font-weight: bold; } #wrapperlicious a { color: inherit; text-decoration: underline } #wrapperlicious #toc { text-decoration: none } #wrapperlicious a:hover { color: #2a2a2a } #wrapperlicious a img { border: 0 } #wrapperlicious :not(pre) > code { color: inherit; background-color: rgba(0, 0, 0, 0.04); border-radius: 3px; font: 0.9em Consolas, Menlo, Monaco, monospace; padding: 0.3em; } #wrapperlicious dd { margin: 0; margin-left: 2em; } #wrapperlicious dt { color: #2a2a2a; font-weight: bold; margin-left: 0.9em; } #wrapperlicious p { margin-bottom: 1em; margin-top: 1em; } #wrapperlicious li > p { margin-bottom: 0; margin-top: 0; } #wrapperlicious pre { border: 1px solid #c1c1c1; border-radius: 3px; font: 100% Consolas, Menlo, Monaco, monospace; margin-bottom: 1em; margin-top: 1em; } #wrapperlicious pre > code { display: block; background-color: #f6f6f6; font: 0.9em Consolas, Menlo, Monaco, monospace; line-height: 1.5em; text-align: left; white-space: pre; padding: 1em; } #wrapperlicious dl, #wrapperlicious ol, #wrapperlicious ul { margin-bottom: 1em; margin-top: 1em; } #wrapperlicious ul { list-style-type: square; } #wrapperlicious ul ul { margin-bottom: 0px; margin-top: 0px; } #footer { font-size: 0.8em; padding-top: 0.5em; text-align: center; } #more { display: inline; font-size: 0.8em; } #perldocdiv { background-color: #fff; border: 1px solid #c1c1c1; border-bottom-left-radius: 5px; border-bottom-right-radius: 5px; margin-left: auto; margin-right: auto; padding: 3em; padding-top: 1em; max-width: 960px; } #moduleversion { float: right } #wrapperlicious .leading-notice { font-style: italic; padding-left: 1em; margin-top: 1em; margin-bottom: 1em; } #wrapperlicious .permalink { display: none; left: -0.75em; position: absolute; padding-right: 0.25em; text-decoration: none; } #wrapperlicious h1:hover .permalink, #wrapperlicious h2:hover .permalink, #wrapperlicious h3:hover .permalink, #wrapperlicious h4:hover .permalink, #wrapperlicious dt:hover .permalink { display: block; } </style>  <script async src="https://www.googletagmanager.com/gtag/js?id=G-KVNWBNT5FB"></script> <script> window.dataLayer = window.dataLayer || []; function gtag(){dataLayer.push(arguments);} gtag('js', new Date()); gtag('config', 'G-KVNWBNT5FB'); gtag('config', 'UA-50555-3'); </script> </head> <body> <nav class="navbar navbar-expand-md navbar-dark bg-dark justify-content-between"> <button class="navbar-toggler" type="button" data-toggle="collapse" data-target="#navbarNav" aria-controls="navbarNav" aria-expanded="false" aria-label="Toggle navigation"> <span class="navbar-toggler-icon"></span> </button> <a class="navbar-brand" href="/"><img src="/images/perl_camel_30.png" width="30" height="30" class="d-inline-block align-top" alt="Perl Camel Logo"> Perldoc Browser</a> <div class="collapse navbar-collapse" id="navbarNav"> <ul class="navbar-nav mr-auto"> <li class="nav-item dropdown text-nowrap"> <a class="nav-link dropdown-toggle" href="#" id="dropdownlink-stable" role="button" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">5.41.5</a> <div class="dropdown-menu" aria-labelledby="dropdownlink-stable"> <a class="dropdown-item" href="/Net::Config">Latest</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.40.1/Net::Config">5.40.1</a> <a class="dropdown-item" href="/5.40.0/Net::Config">5.40.0</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.38.3/Net::Config">5.38.3</a> <a class="dropdown-item" href="/5.38.2/Net::Config">5.38.2</a> <a class="dropdown-item" href="/5.38.1/Net::Config">5.38.1</a> <a class="dropdown-item" href="/5.38.0/Net::Config">5.38.0</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.36.3/Net::Config">5.36.3</a> <a class="dropdown-item" href="/5.36.2/Net::Config">5.36.2</a> <a class="dropdown-item" href="/5.36.1/Net::Config">5.36.1</a> <a class="dropdown-item" href="/5.36.0/Net::Config">5.36.0</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.34.3/Net::Config">5.34.3</a> <a class="dropdown-item" href="/5.34.2/Net::Config">5.34.2</a> <a class="dropdown-item" href="/5.34.1/Net::Config">5.34.1</a> <a class="dropdown-item" href="/5.34.0/Net::Config">5.34.0</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.32.1/Net::Config">5.32.1</a> <a class="dropdown-item" href="/5.32.0/Net::Config">5.32.0</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.30.3/Net::Config">5.30.3</a> <a class="dropdown-item" href="/5.30.2/Net::Config">5.30.2</a> <a class="dropdown-item" href="/5.30.1/Net::Config">5.30.1</a> <a class="dropdown-item" href="/5.30.0/Net::Config">5.30.0</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.28.3/Net::Config">5.28.3</a> <a class="dropdown-item" href="/5.28.2/Net::Config">5.28.2</a> <a class="dropdown-item" href="/5.28.1/Net::Config">5.28.1</a> <a class="dropdown-item" href="/5.28.0/Net::Config">5.28.0</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.26.3/Net::Config">5.26.3</a> <a class="dropdown-item" href="/5.26.2/Net::Config">5.26.2</a> <a class="dropdown-item" href="/5.26.1/Net::Config">5.26.1</a> <a class="dropdown-item" href="/5.26.0/Net::Config">5.26.0</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.24.4/Net::Config">5.24.4</a> <a class="dropdown-item" href="/5.24.3/Net::Config">5.24.3</a> <a class="dropdown-item" href="/5.24.2/Net::Config">5.24.2</a> <a class="dropdown-item" href="/5.24.1/Net::Config">5.24.1</a> <a class="dropdown-item" href="/5.24.0/Net::Config">5.24.0</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.22.4/Net::Config">5.22.4</a> <a class="dropdown-item" href="/5.22.3/Net::Config">5.22.3</a> <a class="dropdown-item" href="/5.22.2/Net::Config">5.22.2</a> <a class="dropdown-item" href="/5.22.1/Net::Config">5.22.1</a> <a class="dropdown-item" href="/5.22.0/Net::Config">5.22.0</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.20.3/Net::Config">5.20.3</a> <a class="dropdown-item" href="/5.20.2/Net::Config">5.20.2</a> <a class="dropdown-item" href="/5.20.1/Net::Config">5.20.1</a> <a class="dropdown-item" href="/5.20.0/Net::Config">5.20.0</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.18.4/Net::Config">5.18.4</a> <a class="dropdown-item" href="/5.18.3/Net::Config">5.18.3</a> <a class="dropdown-item" href="/5.18.2/Net::Config">5.18.2</a> <a class="dropdown-item" href="/5.18.1/Net::Config">5.18.1</a> <a class="dropdown-item" href="/5.18.0/Net::Config">5.18.0</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.16.3/Net::Config">5.16.3</a> <a class="dropdown-item" href="/5.16.2/Net::Config">5.16.2</a> <a class="dropdown-item" href="/5.16.1/Net::Config">5.16.1</a> <a class="dropdown-item" href="/5.16.0/Net::Config">5.16.0</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.14.4/Net::Config">5.14.4</a> <a class="dropdown-item" href="/5.14.3/Net::Config">5.14.3</a> <a class="dropdown-item" href="/5.14.2/Net::Config">5.14.2</a> <a class="dropdown-item" href="/5.14.1/Net::Config">5.14.1</a> <a class="dropdown-item" href="/5.14.0/Net::Config">5.14.0</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.12.5/Net::Config">5.12.5</a> <a class="dropdown-item" href="/5.12.4/Net::Config">5.12.4</a> <a class="dropdown-item" href="/5.12.3/Net::Config">5.12.3</a> <a class="dropdown-item" href="/5.12.2/Net::Config">5.12.2</a> <a class="dropdown-item" href="/5.12.1/Net::Config">5.12.1</a> <a class="dropdown-item" href="/5.12.0/Net::Config">5.12.0</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.10.1/Net::Config">5.10.1</a> <a class="dropdown-item" href="/5.10.0/Net::Config">5.10.0</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.8.9/Net::Config">5.8.9</a> <a class="dropdown-item" href="/5.8.8/Net::Config">5.8.8</a> <a class="dropdown-item" href="/5.8.7/Net::Config">5.8.7</a> <a class="dropdown-item" href="/5.8.6/Net::Config">5.8.6</a> <a class="dropdown-item" href="/5.8.5/Net::Config">5.8.5</a> <a class="dropdown-item" href="/5.8.4/Net::Config">5.8.4</a> <a class="dropdown-item" href="/5.8.3/Net::Config">5.8.3</a> <a class="dropdown-item" href="/5.8.2/Net::Config">5.8.2</a> <a class="dropdown-item" href="/5.8.1/Net::Config">5.8.1</a> <a class="dropdown-item" href="/5.8.0/Net::Config">5.8.0</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.6.2/Net::Config">5.6.2</a> <a class="dropdown-item" href="/5.6.1/Net::Config">5.6.1</a> <a class="dropdown-item" href="/5.6.0/Net::Config">5.6.0</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.005_04/Net::Config">5.005_04</a> <a class="dropdown-item" href="/5.005_03/Net::Config">5.005_03</a> <a class="dropdown-item" href="/5.005_02/Net::Config">5.005_02</a> <a class="dropdown-item" href="/5.005_01/Net::Config">5.005_01</a> <a class="dropdown-item" href="/5.005/Net::Config">5.005</a> </div> </li> <li class="nav-item dropdown text-nowrap"> <a class="nav-link dropdown-toggle" href="#" id="dropdownlink-dev" role="button" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">Dev</a> <div class="dropdown-menu" aria-labelledby="dropdownlink-dev"> <a class="dropdown-item" href="/blead/Net::Config">blead</a> <a class="dropdown-item" href="/5.41.10/Net::Config">5.41.10</a> <a class="dropdown-item" href="/5.41.9/Net::Config">5.41.9</a> <a class="dropdown-item" href="/5.41.8/Net::Config">5.41.8</a> <a class="dropdown-item" href="/5.41.7/Net::Config">5.41.7</a> <a class="dropdown-item" href="/5.41.6/Net::Config">5.41.6</a> <a class="dropdown-item active" href="/5.41.5/Net::Config">5.41.5</a> <a class="dropdown-item" href="/5.41.4/Net::Config">5.41.4</a> <a class="dropdown-item" href="/5.41.3/Net::Config">5.41.3</a> <a class="dropdown-item" href="/5.41.2/Net::Config">5.41.2</a> <a class="dropdown-item" href="/5.41.1/Net::Config">5.41.1</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.40.1-RC1/Net::Config">5.40.1-RC1</a> <a class="dropdown-item" href="/5.40.0-RC2/Net::Config">5.40.0-RC2</a> <a class="dropdown-item" href="/5.40.0-RC1/Net::Config">5.40.0-RC1</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.39.10/Net::Config">5.39.10</a> <a class="dropdown-item" href="/5.39.9/Net::Config">5.39.9</a> <a class="dropdown-item" href="/5.39.8/Net::Config">5.39.8</a> <a class="dropdown-item" href="/5.39.7/Net::Config">5.39.7</a> <a class="dropdown-item" href="/5.39.6/Net::Config">5.39.6</a> <a class="dropdown-item" href="/5.39.5/Net::Config">5.39.5</a> <a class="dropdown-item" href="/5.39.4/Net::Config">5.39.4</a> <a class="dropdown-item" href="/5.39.3/Net::Config">5.39.3</a> <a class="dropdown-item" href="/5.39.2/Net::Config">5.39.2</a> <a class="dropdown-item" href="/5.39.1/Net::Config">5.39.1</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.38.3-RC1/Net::Config">5.38.3-RC1</a> </div> </li> <li class="nav-item dropdown text-nowrap"> <a class="nav-link dropdown-toggle" href="#" id="dropdownlink-nav" role="button" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">Documentation</a> <div class="dropdown-menu" aria-labelledby="dropdownlink-nav"> <a class="dropdown-item" href="/5.41.5/perl">Perl</a> <a class="dropdown-item" href="/5.41.5/perlintro">Intro</a> <a class="dropdown-item" href="/5.41.5/perl#Tutorials">Tutorials</a> <a class="dropdown-item" href="/5.41.5/perlfaq">FAQs</a> <a class="dropdown-item" href="/5.41.5/perl#Reference-Manual">Reference</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.41.5/perlop">Operators</a> <a class="dropdown-item" href="/5.41.5/functions">Functions</a> <a class="dropdown-item" href="/5.41.5/variables">Variables</a> <a class="dropdown-item" href="/5.41.5/modules">Modules</a> <a class="dropdown-item" href="/5.41.5/perlutil">Utilities</a> <div class="dropdown-divider"></div> <a class="dropdown-item" href="/5.41.5/perldelta">Release Notes</a> <a class="dropdown-item" href="/5.41.5/perlcommunity">Community</a> <a class="dropdown-item" href="/5.41.5/perlhist">History</a> </div> </li> </ul> <ul class="navbar-nav"> <script> function set_expand (expand) { var perldocdiv = document.getElementById('perldocdiv'); var width = window.getComputedStyle(perldocdiv).getPropertyValue('max-width'); var expanded = (width == '' || width == 'none') ? true : false; if (expand === null) { expand = !expanded; } if ((expand && !expanded) || (!expand && expanded)) { perldocdiv.style.setProperty('max-width', expand ? 'none' : '960px'); var button_classlist = document.getElementById('content-expand-button').classList; if (expand) { button_classlist.add('btn-light'); button_classlist.remove('btn-outline-light'); } else { button_classlist.add('btn-outline-light'); button_classlist.remove('btn-light'); } } return expand; } function toggle_expand () { var expand = set_expand(null); document.cookie = 'perldoc_expand=' + (expand ? 1 : 0) + '; path=/; expires=Tue, 19 Jan 2038 03:14:07 UTC'; } function read_expand () { return document.cookie.split(';').some(function (item) { return item.indexOf('perldoc_expand=1') >= 0 }); } if (document.readyState === 'loading') { document.addEventListener('DOMContentLoaded', function () { if (read_expand()) { set_expand(true); } }); } else if (read_expand()) { set_expand(true); } </script> <button id="content-expand-button" type="button" class="btn btn-outline-light d-none d-lg-inline-block mr-4" onclick="toggle_expand()">Expand</button> </ul> <form class="form-inline" method="get" action="/5.41.5/search"> <input class="form-control mr-3" type="search" name="q" placeholder="Search" aria-label="Search" value=""> </form> </div> </nav> <div id="wrapperlicious" class="container-fluid"> <div id="perldocdiv"> <div id="links"> <a href="/5.41.5/Net::Config">Net::Config</a> <div id="more"> (<a href="/5.41.5/Net::Config.txt">source</a>, <a href="https://metacpan.org/pod/Net::Config">CPAN</a>) </div> <div id="moduleversion">version 3.15</div> </div> <div class="leading-notice"> You are viewing the version of this documentation from Perl 5.41.5. This is a development version of Perl. </div> <h1><a id="toc">CONTENTS</a></h1> <ul> <li> <a class="text-decoration-none" href="#NAME">NAME</a> </li> <li> <a class="text-decoration-none" href="#SYNOPSIS">SYNOPSIS</a> </li> <li> <a class="text-decoration-none" href="#DESCRIPTION">DESCRIPTION</a> <ul> <li> <a class="text-decoration-none" href="#Class-Methods">Class Methods</a> </li> <li> <a class="text-decoration-none" href="#NetConfig-Values">NetConfig Values</a> </li> </ul> </li> <li> <a class="text-decoration-none" href="#EXPORTS">EXPORTS</a> </li> <li> <a class="text-decoration-none" href="#KNOWN-BUGS">KNOWN BUGS</a> </li> <li> <a class="text-decoration-none" href="#AUTHOR">AUTHOR</a> </li> <li> <a class="text-decoration-none" href="#COPYRIGHT">COPYRIGHT</a> </li> <li> <a class="text-decoration-none" href="#LICENCE">LICENCE</a> </li> <li> <a class="text-decoration-none" href="#VERSION">VERSION</a> </li> <li> <a class="text-decoration-none" href="#DATE">DATE</a> </li> <li> <a class="text-decoration-none" href="#HISTORY">HISTORY</a> </li> </ul> <h1 id="NAME"><a class="permalink" href="#NAME">#</a>NAME</h1> <p>Net::Config - Local configuration data for libnet</p> <h1 id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">#</a>SYNOPSIS</h1> <pre><code>use Net::Config qw(%NetConfig);</code></pre> <h1 id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">#</a>DESCRIPTION</h1> <p><code>Net::Config</code> holds configuration data for the modules in the libnet distribution. During installation you will be asked for these values.</p> <p>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 <code>.libnetrc</code> file in their home directory. This file should return a reference to a HASH containing the keys described below. For example</p> <pre><code># .libnetrc { nntp_hosts => [ "my_preferred_host" ], ph_hosts => [ "my_ph_server" ], } __END__</code></pre> <h2 id="Class-Methods"><a class="permalink" href="#Class-Methods">#</a><a id="Class"></a>Class Methods</h2> <p><code>Net::Config</code> defines the following methods. They are methods as they are invoked as class methods. This is because <code>Net::Config</code> inherits from <code>Net::LocalCfg</code> so you can override these methods if you want.</p> <dl> <dt id="requires_firewall($host)"><a class="permalink" href="#requires_firewall($host)">#</a><a id="requires_firewall"></a><a id="requires_firewall-host"></a><code>requires_firewall($host)</code></dt> <dd> <p>Attempts to determine if a given host is outside your firewall. Possible return values are.</p> <pre><code class="plaintext">-1 Cannot lookup hostname 0 Host is inside firewall (or there is no ftp_firewall entry) 1 Host is outside the firewall</code></pre> <p>This is done by using hostname lookup and the <code>local_netmask</code> entry in the configuration data.</p> </dd> </dl> <h2 id="NetConfig-Values"><a class="permalink" href="#NetConfig-Values">#</a><a id="NetConfig"></a>NetConfig Values</h2> <dl> <dt id="nntp_hosts"><a class="permalink" href="#nntp_hosts">#</a>nntp_hosts</dt> <dd> </dd> <dt id="snpp_hosts"><a class="permalink" href="#snpp_hosts">#</a>snpp_hosts</dt> <dd> </dd> <dt id="pop3_hosts"><a class="permalink" href="#pop3_hosts">#</a>pop3_hosts</dt> <dd> </dd> <dt id="smtp_hosts"><a class="permalink" href="#smtp_hosts">#</a>smtp_hosts</dt> <dd> </dd> <dt id="ph_hosts"><a class="permalink" href="#ph_hosts">#</a>ph_hosts</dt> <dd> </dd> <dt id="daytime_hosts"><a class="permalink" href="#daytime_hosts">#</a>daytime_hosts</dt> <dd> </dd> <dt id="time_hosts"><a class="permalink" href="#time_hosts">#</a>time_hosts</dt> <dd> <p>Each is a reference to an array of hostnames (in order of preference), which should be used for the given protocol</p> </dd> <dt id="inet_domain"><a class="permalink" href="#inet_domain">#</a>inet_domain</dt> <dd> <p>Your internet domain name</p> </dd> <dt id="ftp_firewall"><a class="permalink" href="#ftp_firewall">#</a>ftp_firewall</dt> <dd> <p>If you have an FTP proxy firewall (<b>NOT</b> 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 <code>"hostname:port"</code> (eg <code>"hostname:99"</code>)</p> </dd> <dt id="ftp_firewall_type"><a class="permalink" href="#ftp_firewall_type">#</a>ftp_firewall_type</dt> <dd> <p>There are many different ftp firewall products available. 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</p> <pre><code class="plaintext">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</code></pre> <dl> <dt id="0"><a class="permalink" href="#0">#</a><a id="pod0"></a>0</dt> <dd> <p>There is no firewall</p> </dd> <dt id="1"><a class="permalink" href="#1">#</a><a id="pod1"></a>1</dt> <dd> <pre><code>USER user@remote.host PASS pass</code></pre> </dd> <dt id="2"><a class="permalink" href="#2">#</a><a id="pod2"></a>2</dt> <dd> <pre><code>USER fwuser PASS fwpass USER user@remote.host PASS pass</code></pre> </dd> <dt id="3"><a class="permalink" href="#3">#</a><a id="pod3"></a>3</dt> <dd> <pre><code class="plaintext">USER fwuser PASS fwpass SITE remote.site USER user PASS pass</code></pre> </dd> <dt id="4"><a class="permalink" href="#4">#</a><a id="pod4"></a>4</dt> <dd> <pre><code class="plaintext">USER fwuser PASS fwpass OPEN remote.site USER user PASS pass</code></pre> </dd> <dt id="5"><a class="permalink" href="#5">#</a><a id="pod5"></a>5</dt> <dd> <pre><code>USER user@fwuser@remote.site PASS pass@fwpass</code></pre> </dd> <dt id="6"><a class="permalink" href="#6">#</a><a id="pod6"></a>6</dt> <dd> <pre><code>USER fwuser@remote.site PASS fwpass USER user PASS pass</code></pre> </dd> <dt id="7"><a class="permalink" href="#7">#</a><a id="pod7"></a>7</dt> <dd> <pre><code>USER user@remote.host PASS pass AUTH fwuser RESP fwpass</code></pre> </dd> </dl> </dd> <dt id="ftp_ext_passive"><a class="permalink" href="#ftp_ext_passive">#</a>ftp_ext_passive</dt> <dd> </dd> <dt id="ftp_int_passive"><a class="permalink" href="#ftp_int_passive">#</a>ftp_int_passive</dt> <dd> <p>FTP servers can work in passive or active mode. Active mode is when you want to transfer data you have to tell the server the address and port to connect to. Passive mode is when the server provide the address and port and you establish the connection.</p> <p>With some firewalls active mode 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 command. In this case you should set <code>ftp_ext_passive</code> to a <i>true</i> value.</p> <p>Some servers are configured to only work in passive mode. If you have one of these you can force <code>Net::FTP</code> to always transfer in passive mode; when not going via a firewall, by setting <code>ftp_int_passive</code> to a <i>true</i> value.</p> </dd> <dt id="local_netmask"><a class="permalink" href="#local_netmask">#</a>local_netmask</dt> <dd> <p>A reference to a list of netmask strings in the form <code>"134.99.4.0/24"</code>. These are used by the <code>requires_firewall</code> function to determine if a given host is inside or outside your firewall.</p> </dd> </dl> <p>The following entries are used during installation & testing on the libnet package</p> <dl> <dt id="test_hosts"><a class="permalink" href="#test_hosts">#</a>test_hosts</dt> <dd> <p>If true then <code>make test</code> may attempt to connect to hosts given in the configuration.</p> </dd> <dt id="test_exists"><a class="permalink" href="#test_exists">#</a>test_exists</dt> <dd> <p>If true then <code>Configure</code> will check each hostname given that it exists</p> </dd> </dl> <h1 id="EXPORTS"><a class="permalink" href="#EXPORTS">#</a>EXPORTS</h1> <p>The following symbols are, or can be, exported by this module:</p> <dl> <dt id="Default-Exports"><a class="permalink" href="#Default-Exports">#</a><a id="Default"></a>Default Exports</dt> <dd> <p><code>%NetConfig</code>.</p> </dd> <dt id="Optional-Exports"><a class="permalink" href="#Optional-Exports">#</a><a id="Optional"></a>Optional Exports</dt> <dd> <p><i>None</i>.</p> </dd> <dt id="Export-Tags"><a class="permalink" href="#Export-Tags">#</a><a id="Export"></a>Export Tags</dt> <dd> <p><i>None</i>.</p> </dd> </dl> <h1 id="KNOWN-BUGS"><a class="permalink" href="#KNOWN-BUGS">#</a><a id="KNOWN"></a>KNOWN BUGS</h1> <p><i>None</i>.</p> <h1 id="AUTHOR"><a class="permalink" href="#AUTHOR">#</a>AUTHOR</h1> <p>Graham Barr <<a href="mailto:gbarr@pobox.com">gbarr@pobox.com</a>>.</p> <p>Steve Hay <<a href="mailto:shay@cpan.org">shay@cpan.org</a>> is now maintaining libnet as of version 1.22_02.</p> <h1 id="COPYRIGHT"><a class="permalink" href="#COPYRIGHT">#</a>COPYRIGHT</h1> <p>Copyright (C) 2000 Graham Barr. All rights reserved.</p> <p>Copyright (C) 2013-2014, 2016, 2020 Steve Hay. All rights reserved.</p> <h1 id="LICENCE"><a class="permalink" href="#LICENCE">#</a>LICENCE</h1> <p>This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself, i.e. under the terms of either the GNU General Public License or the Artistic License, as specified in the <i>LICENCE</i> file.</p> <h1 id="VERSION"><a class="permalink" href="#VERSION">#</a>VERSION</h1> <p>Version 3.15</p> <h1 id="DATE"><a class="permalink" href="#DATE">#</a>DATE</h1> <p>20 March 2023</p> <h1 id="HISTORY"><a class="permalink" href="#HISTORY">#</a>HISTORY</h1> <p>See the <i>Changes</i> file.</p> </div> <div id="footer"> <p>Perldoc Browser is maintained by Dan Book (<a href="https://metacpan.org/author/DBOOK">DBOOK</a>). Please contact him via the <a href="https://github.com/Grinnz/perldoc-browser/issues">GitHub issue tracker</a> or <a href="mailto:dbook@cpan.org">email</a> regarding any issues with the site itself, search, or rendering of documentation.</p> <p>The Perl documentation is maintained by the Perl 5 Porters in the development of Perl. Please contact them via the <a href="https://github.com/Perl/perl5/issues">Perl issue tracker</a>, the <a href="https://lists.perl.org/list/perl5-porters.html">mailing list</a>, or <a href="https://kiwiirc.com/client/irc.perl.org/p5p">IRC</a> to report any issues with the contents or format of the documentation.</p> </div> </div> <script src="https://cdnjs.cloudflare.com/ajax/libs/jquery/3.5.1/jquery.slim.min.js" integrity="sha512-/DXTXr6nQodMUiq+IUJYCt2PPOUjrHJ9wFrqpJ3XkgPNOZVfMok7cRw6CSxyCQxXn6ozlESsSh1/sMCTF1rL/g==" crossorigin="anonymous"></script> <script src="https://cdnjs.cloudflare.com/ajax/libs/popper.js/1.16.1/umd/popper.min.js" integrity="sha512-ubuT8Z88WxezgSqf3RLuNi5lmjstiJcyezx34yIU2gAHonIi27Na7atqzUZCOoY4CExaoFumzOsFQ2Ch+I/HCw==" crossorigin="anonymous"></script> <script src="https://stackpath.bootstrapcdn.com/bootstrap/4.5.2/js/bootstrap.min.js" integrity="sha384-B4gt1jrGC7Jh4AgTPSdUtOBvfO8shuf57BaghqFfPlYxofvL8/KUEfYiJOMMV+rV" crossorigin="anonymous"></script> <script src="/js/highlight.pack.js"></script> <script>hljs.highlightAll();</script> </body> </html>

CINXE.COM

Net::Config - Local configuration data for libnet - Perldoc Browser