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.
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.
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.
You will need DevStudio 2010 or newer.
Open a CMD.EXE window using DevStudio Tools Shortcuts and click on "VS20xx X64 Native Tools Command Prompt" or "VS20xx X86 Native Tools Command Prompt" shortcut.
On the CMD.EXE window it creates, execute:
$ cd libzmq\builds\msvc\build $ buildall.bat
This will build using the environment set on the command window. The ØMQ libraries are built in the libzmq\builds\msvc\lib subdirectory.
In case you want to build for multiple versions of DevStudio installed on this machine, edit the buildall.bat command and uncomment the build command for each desired version.
Cross-platform build with CMake
Written: 07 Jan 2010 07:52
Revised: 17 Feb 2016 17:04
If you found this page useful, please rate it up so others will find it.
- An Introduction to ØMQ
- Coding Style Guidelines
- Guidelines for ØMQ bindings
- Installing on Windows
- Mailing Lists
- Message API Goals
- ØMQ Contribution Policy
- ØMQ Cookbook
- ØMQ Distributions
- ØMQ Labs
- ØMQ Owners
- ØMQ Release Policies
- ØMQ/2.1 Class Diagram
- ØMQ/3.0 Roadmap
- ØMQ/3.2 Roadmap
- Process Manager
- Projects using ØMQ
- Release notes for ØMQ/4.0.0
- Reporting and Tracking an Issue
- The native ØMQ API (libzmq)
- The ØMQ Guide
- The Ten Minute Talk
- Trademark Policy
- Tuning ØMQ
- Upgrading from 2.0 to 2.1
- Upgrading from libzmq 2.x to 3.2
- Upgrading to 4.1 from 4.0
- Using Valgrind
- Welcome from AMQP
- ZeroMQ Feature List
Who's watching this page?Dominic Luciano
Fernando J Quintero