diff options
Diffstat (limited to 'Master/tlpkg/tlperl/lib/LWP.pm')
| -rw-r--r-- | Master/tlpkg/tlperl/lib/LWP.pm | 65 |
1 files changed, 39 insertions, 26 deletions
diff --git a/Master/tlpkg/tlperl/lib/LWP.pm b/Master/tlpkg/tlperl/lib/LWP.pm index 5ca47855701..6b16e13397e 100644 --- a/Master/tlpkg/tlperl/lib/LWP.pm +++ b/Master/tlpkg/tlperl/lib/LWP.pm @@ -1,9 +1,9 @@ package LWP; -$VERSION = "5.837"; +$VERSION = "6.04"; sub Version { $VERSION; } -require 5.005; +require 5.008; require LWP::UserAgent; # this should load everything you need 1; @@ -99,7 +99,7 @@ The libwww-perl library is based on HTTP style communication. This section tries to describe what that means. Let us start with this quote from the HTTP specification document -<URL:http://www.w3.org/pub/WWW/Protocols/>: +<URL:http://www.w3.org/Protocols/>: =over 3 @@ -152,25 +152,25 @@ The main attributes of the request objects are: =item * -The B<method> is a short string that tells what kind of +B<method> is a short string that tells what kind of request this is. The most common methods are B<GET>, B<PUT>, B<POST> and B<HEAD>. =item * -The B<uri> is a string denoting the protocol, server and +B<uri> is a string denoting the protocol, server and the name of the "document" we want to access. The B<uri> might also encode various other parameters. =item * -The B<headers> contain additional information about the +B<headers> contains additional information about the request and can also used to describe the content. The headers are a set of keyword/value pairs. =item * -The B<content> is an arbitrary amount of data. +B<content> is an arbitrary amount of data. =back @@ -183,22 +183,22 @@ The main attributes of objects of this class are: =item * -The B<code> is a numerical value that indicates the overall +B<code> is a numerical value that indicates the overall outcome of the request. =item * -The B<message> is a short, human readable string that +B<message> is a short, human readable string that corresponds to the I<code>. =item * -The B<headers> contain additional information about the +B<headers> contains additional information about the response and describe the content. =item * -The B<content> is an arbitrary amount of data. +B<content> is an arbitrary amount of data. =back @@ -211,7 +211,7 @@ response classification methods are: =item is_success() -The request was was successfully received, understood or accepted. +The request was successfully received, understood or accepted. =item is_error() @@ -251,34 +251,34 @@ application. =item * -The B<timeout> specifies how much time we give remote servers to +B<timeout> specifies how much time we give remote servers to respond before the library disconnects and creates an internal I<timeout> response. =item * -The B<agent> specifies the name that your application should use when it +B<agent> specifies the name that your application uses when it presents itself on the network. =item * -The B<from> attribute can be set to the e-mail address of the person +B<from> can be set to the e-mail address of the person responsible for running the application. If this is set, then the address will be sent to the servers with every request. =item * -The B<parse_head> specifies whether we should initialize response +B<parse_head> specifies whether we should initialize response headers from the E<lt>head> section of HTML documents. =item * -The B<proxy> and B<no_proxy> attributes specify if and when to go through -a proxy server. <URL:http://www.w3.org/pub/WWW/Proxies/> +B<proxy> and B<no_proxy> specify if and when to go through +a proxy server. <URL:http://www.w3.org/History/1994/WWW/Proxies/> =item * -The B<credentials> provide a way to set up user names and +B<credentials> provides a way to set up user names and passwords needed to access certain services. =back @@ -556,8 +556,8 @@ The following modules provide various functions and definitions. All modules contain detailed information on the interfaces they provide. The L<lwpcook> manpage is the libwww-perl cookbook that contain examples of typical usage of the library. You might want to take a -look at how the scripts L<lwp-request>, L<lwp-rget> and L<lwp-mirror> -are implemented. +look at how the scripts L<lwp-request>, L<lwp-download>, L<lwp-dump> +and L<lwp-mirror> are implemented. =head1 ENVIRONMENT @@ -582,12 +582,25 @@ These environment variables can be set to enable communication through a proxy server. See the description of the C<env_proxy> method in L<LWP::UserAgent>. -=item PERL_LWP_USE_HTTP_10 +=item PERL_LWP_ENV_PROXY -Enable the old HTTP/1.0 protocol driver instead of the new HTTP/1.1 -driver. You might want to set this to a TRUE value if you discover -that your old LWP applications fails after you installed LWP-5.60 or -better. +If set to a TRUE value, then the C<LWP::UserAgent> will by default call +C<env_proxy> during initialization. This makes LWP honor the proxy variables +described above. + +=item PERL_LWP_SSL_VERIFY_HOSTNAME + +The default C<verify_hostname> setting for C<LWP::UserAgent>. If +not set the default will be 1. Set it as 0 to disable hostname +verification (the default prior to libwww-perl 5.840. + +=item PERL_LWP_SSL_CA_FILE + +=item PERL_LWP_SSL_CA_PATH + +The file and/or directory +where the trusted Certificate Authority certificates +is located. See L<LWP::UserAgent> for details. =item PERL_HTTP_URI_CLASS |