Adding upstream version 4.22.0.upstream/4.22.0

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

1 files changed, 300 insertions, 0 deletions

diff --git a/upstream/debian-bookworm/man3/Net::Config.3perl b/upstream/debian-bookworm/man3/Net::Config.3perl
new file mode 100644
index 00000000..f31e4cdb
--- /dev/null
+++ b/upstream/debian-bookworm/man3/Net::Config.3perl
@@ -0,0 +1,300 @@
+.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.43)
+.\"
+.\" Standard preamble:
+.\" ========================================================================
+.de Sp \" Vertical space (when we can't use .PP)
+.if t .sp .5v
+.if n .sp
+..
+.de Vb \" Begin verbatim text
+.ft CW
+.nf
+.ne \\$1
+..
+.de Ve \" End verbatim text
+.ft R
+.fi
+..
+.\" Set up some character translations and predefined strings.  \*(-- will
+.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
+.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
+.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
+.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
+.\" nothing in troff, for use with C<>.
+.tr \(*W-
+.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
+.ie n \{\
+.    ds -- \(*W-
+.    ds PI pi
+.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
+.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
+.    ds L" ""
+.    ds R" ""
+.    ds C` ""
+.    ds C' ""
+'br\}
+.el\{\
+.    ds -- \|\(em\|
+.    ds PI \(*p
+.    ds L" ``
+.    ds R" ''
+.    ds C`
+.    ds C'
+'br\}
+.\"
+.\" Escape single quotes in literal strings from groff's Unicode transform.
+.ie \n(.g .ds Aq \(aq
+.el       .ds Aq '
+.\"
+.\" If the F register is >0, we'll generate index entries on stderr for
+.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
+.\" entries marked with X<> in POD.  Of course, you'll have to process the
+.\" output yourself in some meaningful fashion.
+.\"
+.\" Avoid warning from groff about undefined register 'F'.
+.de IX
+..
+.nr rF 0
+.if \n(.g .if rF .nr rF 1
+.if (\n(rF:(\n(.g==0)) \{\
+.    if \nF \{\
+.        de IX
+.        tm Index:\\$1\t\\n%\t"\\$2"
+..
+.        if !\nF==2 \{\
+.            nr % 0
+.            nr F 2
+.        \}
+.    \}
+.\}
+.rr rF
+.\" ========================================================================
+.\"
+.IX Title "Net::Config 3perl"
+.TH Net::Config 3perl "2023-11-25" "perl v5.36.0" "Perl Programmers Reference Guide"
+.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
+.\" way too many mistakes in technical documents.
+.if n .ad l
+.nh
+.SH "NAME"
+Net::Config \- Local configuration data for libnet
+.SH "SYNOPSIS"
+.IX Header "SYNOPSIS"
+.Vb 1
+\&    use Net::Config qw(%NetConfig);
+.Ve
+.SH "DESCRIPTION"
+.IX Header "DESCRIPTION"
+\&\f(CW\*(C`Net::Config\*(C'\fR holds configuration data for the modules in the libnet
+distribution. During installation you will be asked for these values.
+.PP
+The configuration data is held globally in \f(CW\*(C`/etc/perl/Net/libnet.cfg\*(C'\fR,
+but a user may override any of these values by providing their own. This
+can be done by having a \f(CW\*(C`.libnetrc\*(C'\fR file in their home directory. This file
+should return a reference to a \s-1HASH\s0 containing the keys described below.
+For example
+.PP
+.Vb 6
+\&    # .libnetrc
+\&    {
+\&        nntp_hosts => [ "my_preferred_host" ],
+\&        ph_hosts   => [ "my_ph_server" ],
+\&    }
+\&    _\|_END_\|_
+.Ve
+.SS "Class Methods"
+.IX Subsection "Class Methods"
+\&\f(CW\*(C`Net::Config\*(C'\fR defines the following methods. They are methods as they are
+invoked as class methods. This is because \f(CW\*(C`Net::Config\*(C'\fR inherits from
+\&\f(CW\*(C`Net::LocalCfg\*(C'\fR so you can override these methods if you want.
+.ie n .IP """requires_firewall($host)""" 4
+.el .IP "\f(CWrequires_firewall($host)\fR" 4
+.IX Item "requires_firewall($host)"
+Attempts to determine if a given host is outside your firewall. Possible
+return values are.
+.Sp
+.Vb 3
+\&  \-1  Cannot lookup hostname
+\&   0  Host is inside firewall (or there is no ftp_firewall entry)
+\&   1  Host is outside the firewall
+.Ve
+.Sp
+This is done by using hostname lookup and the \f(CW\*(C`local_netmask\*(C'\fR entry in
+the configuration data.
+.SS "NetConfig Values"
+.IX Subsection "NetConfig Values"
+.IP "nntp_hosts" 4
+.IX Item "nntp_hosts"
+.PD 0
+.IP "snpp_hosts" 4
+.IX Item "snpp_hosts"
+.IP "pop3_hosts" 4
+.IX Item "pop3_hosts"
+.IP "smtp_hosts" 4
+.IX Item "smtp_hosts"
+.IP "ph_hosts" 4
+.IX Item "ph_hosts"
+.IP "daytime_hosts" 4
+.IX Item "daytime_hosts"
+.IP "time_hosts" 4
+.IX Item "time_hosts"
+.PD
+Each is a reference to an array of hostnames (in order of preference),
+which should be used for the given protocol
+.IP "inet_domain" 4
+.IX Item "inet_domain"
+Your internet domain name
+.IP "ftp_firewall" 4
+.IX Item "ftp_firewall"
+If you have an \s-1FTP\s0 proxy firewall (\fB\s-1NOT\s0\fR an \s-1HTTP\s0 or \s-1SOCKS\s0 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
+\&\f(CW"hostname:port"\fR (eg \f(CW"hostname:99"\fR)
+.IP "ftp_firewall_type" 4
+.IX Item "ftp_firewall_type"
+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
+.Sp
+.Vb 5
+\&  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
+.Ve
+.RS 4
+.IP "0" 4
+There is no firewall
+.IP "1" 4
+.IX Item "1"
+.Vb 2
+\&     USER user@remote.host
+\&     PASS pass
+.Ve
+.IP "2" 4
+.IX Item "2"
+.Vb 4
+\&     USER fwuser
+\&     PASS fwpass
+\&     USER user@remote.host
+\&     PASS pass
+.Ve
+.IP "3" 4
+.IX Item "3"
+.Vb 5
+\&     USER fwuser
+\&     PASS fwpass
+\&     SITE remote.site
+\&     USER user
+\&     PASS pass
+.Ve
+.IP "4" 4
+.IX Item "4"
+.Vb 5
+\&     USER fwuser
+\&     PASS fwpass
+\&     OPEN remote.site
+\&     USER user
+\&     PASS pass
+.Ve
+.IP "5" 4
+.IX Item "5"
+.Vb 2
+\&     USER user@fwuser@remote.site
+\&     PASS pass@fwpass
+.Ve
+.IP "6" 4
+.IX Item "6"
+.Vb 4
+\&     USER fwuser@remote.site
+\&     PASS fwpass
+\&     USER user
+\&     PASS pass
+.Ve
+.IP "7" 4
+.IX Item "7"
+.Vb 4
+\&     USER user@remote.host
+\&     PASS pass
+\&     AUTH fwuser
+\&     RESP fwpass
+.Ve
+.RE
+.RS 4
+.RE
+.IP "ftp_ext_passive" 4
+.IX Item "ftp_ext_passive"
+.PD 0
+.IP "ftp_int_passive" 4
+.IX Item "ftp_int_passive"
+.PD
+\&\s-1FTP\s0 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.
+.Sp
+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 \f(CW\*(C`ftp_ext_passive\*(C'\fR
+to a \fItrue\fR value.
+.Sp
+Some servers are configured to only work in passive mode. If you have
+one of these you can force \f(CW\*(C`Net::FTP\*(C'\fR to always transfer in passive
+mode; when not going via a firewall, by setting \f(CW\*(C`ftp_int_passive\*(C'\fR to
+a \fItrue\fR value.
+.IP "local_netmask" 4
+.IX Item "local_netmask"
+A reference to a list of netmask strings in the form \f(CW"134.99.4.0/24"\fR.
+These are used by the \f(CW\*(C`requires_firewall\*(C'\fR function to determine if a given
+host is inside or outside your firewall.
+.PP
+The following entries are used during installation & testing on the
+libnet package
+.IP "test_hosts" 4
+.IX Item "test_hosts"
+If true then \f(CW\*(C`make test\*(C'\fR may attempt to connect to hosts given in the
+configuration.
+.IP "test_exists" 4
+.IX Item "test_exists"
+If true then \f(CW\*(C`Configure\*(C'\fR will check each hostname given that it exists
+.SH "EXPORTS"
+.IX Header "EXPORTS"
+The following symbols are, or can be, exported by this module:
+.IP "Default Exports" 4
+.IX Item "Default Exports"
+\&\f(CW%NetConfig\fR.
+.IP "Optional Exports" 4
+.IX Item "Optional Exports"
+\&\fINone\fR.
+.IP "Export Tags" 4
+.IX Item "Export Tags"
+\&\fINone\fR.
+.SH "KNOWN BUGS"
+.IX Header "KNOWN BUGS"
+\&\fINone\fR.
+.SH "AUTHOR"
+.IX Header "AUTHOR"
+Graham Barr <gbarr@pobox.com <mailto:gbarr@pobox.com>>.
+.PP
+Steve Hay <shay@cpan.org <mailto:shay@cpan.org>> is now maintaining
+libnet as of version 1.22_02.
+.SH "COPYRIGHT"
+.IX Header "COPYRIGHT"
+Copyright (C) 2000 Graham Barr.  All rights reserved.
+.PP
+Copyright (C) 2013\-2014, 2016, 2020 Steve Hay.  All rights reserved.
+.SH "LICENCE"
+.IX Header "LICENCE"
+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 \s-1GNU\s0 General Public
+License or the Artistic License, as specified in the \fI\s-1LICENCE\s0\fR file.
+.SH "VERSION"
+.IX Header "VERSION"
+Version 3.14
+.SH "DATE"
+.IX Header "DATE"
+23 Dec 2020
+.SH "HISTORY"
+.IX Header "HISTORY"
+See the \fIChanges\fR file.