FILE: C:\Program Files\Git\usr\share\licenses\perl-Net-SSLeay\LICENSE

--
Net-SSLeay - Perl bindings for OpenSSL and LibreSSL

By popular demand...
--------------------

   perl -MNet::SSLeay -e '($p)=Net::SSLeay::get_https("www.openssl.org", 443, "/"); print $p'


for the released versions:
   https://metacpan.org/release/Net-SSLeay

for the latest and possibly unstable version from git:

   https://github.com/radiator-software/p5-net-ssleay


Prerequisites
-------------

Perl 5.8.1 or higher.

One of the following libssl implementations:

* Any stable release of OpenSSL (https://www.openssl.org) in the
  0.9.8 - 3.0 branches, except for OpenSSL 0.9.8 - 0.9.8b.
* Any stable release of LibreSSL (https://www.libressl.org) in the
  2.0 - 3.4 series, except for LibreSSL 3.2.2 and 3.2.3.

Net-SSLeay may not compile or pass its tests against releases other
than the ones listed above due to libssl API incompatibilities, or, in
the case of LibreSSL, because of deviations from the libssl API.

If you are using a version of OpenSSL or LibreSSL distributed by your
operating system vendor, you may also need to install a "development"
package containing the header files that correspond to the OpenSSL or
LibreSSL library package. Examples include:

* libssl-dev for OpenSSL on Debian and Ubuntu;
* openssl-devel for OpenSSL on Red Hat Enterprise Linux and Fedora.

On Linux, zlib is also required, even when libssl is built without
support for TLS compression. zlib is probably also available via your
Linux distribution's package manager, e.g.:

* zlib1g-dev on Debian and Ubuntu;
* zlib-devel on Red Hat Enterprise Linux and Fedora.

A future version of Net-SSLeay will remove this requirement when
building against a libssl without support for TLS compression.

The same C compiler and options should be used to compile all of Perl,
OpenSSL/LibreSSL, and Net-SSLeay. Mixing compilers and options often
leads to build errors or run-time malfunctions that are difficult to
debug.


Installing
----------

Unix:
	# build or install OpenSSL as per instructions in that package

	gunzip  bt              # show stack trace
	gdb perl            # run live with debugging
	  # set break point in SSLeay.xs or in suspect function of OpenSSL
	  > br XS_Net__SSLeay_connect
	  > run yourscript.pl arg arg

For gdb'ing make sure gdb finds all the relevant source code. This
may mean that you must run perl and OpenSSL from the directories where
the respective makefiles build them.

You can also enable PR and PRN macros in SSLeay.xs and sprinkle
even some more around the code to figure out what's happening.

Some exotic configurations of perl may cause unstability: make sure
OpenSSL uses the same malloc as perl. Recompile perl without
threads. Try not using the PerlIO abstraction.

If you need to tweak build for some platform, please let me know
so I can fix it. Patches and gdb session dumps are also welcome.

Copyright
---------

Copyright (c) 1996-2003 Sampo Kellomäki 
Copyright (c) 2005-2010 Florian Ragwitz 
Copyright (c) 2005-2018 Mike McCauley 
Copyright (c) 2018- Chris Novakovic 
Copyright (c) 2018- Tuure Vartiainen 
Copyright (c) 2018- Heikki Vatiainen 

All rights reserved.

License
-------

Net-SSLeay is released under the terms of the Artistic License 2.0. For
details, see the LICENSE file.

Recommended reading
-------------------

===> HTTP protocol specification. It applies 100% to HTTPS too and doing
password authentication is explained there. <===

If you are newbie interested in grabbing web pages from https servers,
please read HTTP documentation from http://www.w3c.org/ before asking trivial
questions. That document also covers the basic-auth FAQ (URLs like
http://user:pass@host). Do not ask questions about authentication before
consulting the HTTP specification. HTTPS is just HTTP in SSL transport.

If you are doing advanced stuff, and don't find documentation you need,
please try to extrapolate from OpenSSL documentation (which unfortunately
is quite sparse) and the source code.

If you run into build problems, especially regarding shared libraries,
check your perl documentation, especially the perlxtut(1) man page,
which gives excellent tutorial of the build process of XSUBs.

  perlxtut(1)
  perlxs(1)
  perlguts(1)
  perlcall(1)

Say `perldoc Net::SSLeay' _NOW_!

To download OpenSSL, see https://www.openssl.org/

Bug reports, patch submission, feature requests and git access to the
latest source code etc., can be obtained at
https://github.com/radiator-software/p5-net-ssleay



--