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

Net-SSLeay: Perl bindings for OpenSSL and LibreSSL
https://github.com/radiator-software/p5-net-ssleay

libressl openssl perl

Last synced: 9 months ago
JSON representation

Net-SSLeay: Perl bindings for OpenSSL and LibreSSL

Host: GitHub
URL: https://github.com/radiator-software/p5-net-ssleay
Owner: radiator-software
License: artistic-2.0
Created: 2018-06-28T08:45:49.000Z (almost 8 years ago)
Default Branch: master
Last Pushed: 2025-09-06T13:44:58.000Z (10 months ago)
Last Synced: 2025-09-06T15:27:17.471Z (10 months ago)
Topics: libressl, openssl, perl
Language: Perl
Homepage: https://metacpan.org/release/Net-SSLeay
Size: 2.31 MB
Stars: 34
Watchers: 7
Forks: 48
Open Issues: 66
Metadata Files:
- Readme: README
- Changelog: Changes
- Contributing: CONTRIBUTING.md
- License: LICENSE

Awesome Lists containing this project

README

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.2 branches, except for OpenSSL 0.9.8 - 0.9.8b.
* Any stable release of LibreSSL (https://www.libressl.org) in the
2.0 - 3.8 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.

If there are build errors, test failures or run-time malfunctions, try
to use the same compiler and options to compile your OpenSSL, Perl,
and Net::SSLeay. Mixing compilers and options may lead to build
errors, test failures or run-time malfunctions, that are difficult to
debug. The situation in 2024 is that, for example, compiling Perl with
gcc and Net::SSLeay with clang works on Linux and macOS. With Windows
it may be easier to use the same compiler and compiler options.

Installing
----------

General:
Makefile.PL tries to find OpenSSL installation location from a
number of pre-defined paths. It will print the version and
location of OpenSSL or LibreSSL it finds, or warn if it doesn't
find anything usable.

If your OpenSSL is installed in an unusual place, you can tell
Makefile.PL from where to find it with by setting the
OPENSSL_PREFIX environment variable.

On Linux, macOS and other Unix type systems:
OPENSSL_PREFIX=/home/mikem/playpen/openssl-1.0.2c perl Makefile.PL

On Windows:
set OPENSSL_PREFIX=C:\playpen\openssl-1.0.2.c
perl Makefile.PL

The logic in Makefile.PL tries to resolve the required
libraries and include directories based on the environment
variable OPENSSL_PREFIX.

Unix:
Build or install OpenSSL as per instructions in that
package. Review section 'General:' above before continuing.

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 (c) 1996-2003 Sampo Kellomäki
Copyright (c) 2005-2010 Florian Ragwitz
Copyright (c) 2005-2018 Mike McCauley
Copyright (c) 2018 Tuure Vartiainen
Copyright (c) 2018- Chris Novakovic
Copyright (c) 2018- Heikki Vatiainen

License
-------

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

ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Awesome

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

Awesome Lists containing this project

README