Charles McGarvey > Alien-ZMQ-0.03 > Alien::ZMQ

Download:
Alien-ZMQ-0.03.tar.gz

Dependencies

Annotate this POD

View/Report Bugs
Module Version: 0.03   Source   Latest Release: Alien-ZMQ-0.06

NAME ^

Alien::ZMQ - detect and/or install zeromq

VERSION ^

version 0.03

SYNOPSIS ^

    use Alien::ZMQ;

    my $version = Alien::ZMQ::lib_version;

DESCRIPTION ^

Upon installation, the target system is probed for the presence of libzmq. If it is not found, zeromq 3.2.2 is installed in a shared directory. In short, modules that need libzmq can depend on this module to make sure that it is available.

METHODS ^

inc_version

Get the version number of libzmq as a dotted version string according to the zmq.h header file.

lib_version

Get the version number of libzmq as a dotted version string according to the libzmq.so file.

inc_dir

Get the directory containing the zmq.h header file.

lib_dir

Get the directory containing the libzmq.so file.

cflags

Get the C compiler flags required to compile a program that uses libzmq. This is a shortcut for constructing a -I flag using inc_dir.

libs

Get the linker flags required to link a program against libzmq. This is a shortcut for constructing a -L flag using lib_dir, plus -lzmq.

OPTIONS ^

These options to Build.PL affect the installation of this module.

--zmq-skip-probe

By default, zeromq is not compiled and installed if it is detected to already be on the system. Use this to skip those checks and always install zeromq.

--zmq-config=...

Pass extra flags to zeromq's configure script. You may want to consider passing either --with-pgm or --with-system-pgm if you need support for PGM; this is not enabled by default because it is not supported by every system.

--zmq-libs=...

Pass extra flags to the linker when probing for an existing installation of zeromq. In particular, if your libzmq.so file is installed to a special location, you may pass flags such as -L/opt/libzmq2/lib -lzmq.

--zmq-cflags=...

Pass extra flags to the compiler when probing for an existing installation of zeromq. These flags will not be used when actually compiling zeromq from source. For that, just use the CFLAGS environment variable.

CAVEATS ^

Probing is only done upon installation, so if you are using a system-installed version of libzmq and you uninstall or upgrade it, you will also need to reinstall this module.

BUGS ^

Windows is not yet supported. Patches are welcome.

SEE ALSO ^

ACKNOWLEDGEMENTS ^

The design and implementation of this module were influenced by other Alien modules, including Alien::GMP and Alien::Tidyp.

AUTHOR ^

Charles McGarvey <ccm@cpan.org>

COPYRIGHT AND LICENSE ^

This software is copyright (c) 2013 by Charles McGarvey.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.

syntax highlighting: