libzmq Source Git Repository

libzmq development happens on the Source git repository at http://github.com/zeromq/libzmq. This git also holds the project issue tracker. The master branch holds the latest unstable version of libzmq (version 3.1 at present). Source code documentation is at http://travlr.github.com/libzmq. Man pages for current versions are at http://api.zeromq.org.

Here is how to build ØMQ from the source repository on various platforms. You need to have git installed. Then clone the repository using the read-only github URI:

git clone git://github.com/zeromq/libzmq.git

Note: The libzmq master is a work in progress, and not supported by most language bindings. If you are looking for a stable libzmq to build on, please download the current stable package.

UNIX-like platforms

You will need the build-essential, libtool, autoconf, automake, and uuid-dev packages or their equivalents. The asciidoc package is optional: if it is missing, you will not get man pages. To build, after cloning the git:

$ cd libzmq
$ ./autogen.sh
$ ./configure     # add other options here
$ make
$ make check
$ sudo make install

The build system checks whether asciidoc is installed. If it is, you will get man pages. Otherwise you won't.

Linux

On Linux, run sudo ldconfig after make install.

Mac OS X

On OS X, the autogen.sh step requires pkg-config. You do not need pkg-config to build from a released source package. If pkg-config is incorrectly installed you may see errors when you run configure. To fix these errors, install and configure the latest pkg-config:

$ tar xzf pkg-config-0.23.tar.gz
$ cd pkg-config-0.23
$ ./configure --prefix=/usr/local/pkg-config-0.23 --datarootdir=/usr/share
$ make
$ sudo make install

Then put /usr/local/pkg-config-0.23/bin on your $PATH. It is important to include the —datarootdir=/usr/share option, which will install the pkg.m4 file in /usr/share/aclocal, where aclocal will be able to find it.

Windows

You will need MSVC++ 2008 or newer. Open the file libzmq\builds\msvc\msvc.sln and build the solution. The ØMQ libraries are built in the lib subdirectory.

Cross-platform build with CMake

  1. Download and install CMake http://cmake.org/cmake/resources/software.html.
  2. Use CMake to generate appropriate build files for your operating system and build tools.
  3. Instructions on how to use CMake can be found here: http://cmake.org/cmake/help/runningcmake.html