Pronounced ominum (because it's fun to say), this is the OpenMAMA Native Messaging bridge. This project really only exists to provide a reasonably efficient middleware which can be used for testing ZeroMQ. If you look at the code you'll see I have tried my best to focus on methods which reduce the number of lines of code which are required to maintain.
In future if people are using this, I may expand the functionality out some more, but in the meantime, it focuses entirely on scalar data types.
NB: This project is MIT Licensed and in no way affiliated with nor supported by the OpenMAMA project or SR Labs - if you find any issues, please report to this project via github.
The payload functionality is currently limited to:
- Serialization / Deserialization functions
- Apply methods
- Iterators (both callback based and iterator based)
- Scalar data type accessor and modification methods for both field and message
There are several known limitations which exist. Some by design, some I'll maybe correct later:
- Not network byte ordered so you can't cross CPU architectures from pub to sub
- Doesn't support any vector data types
- Doesn't support sub messages
- Doesn't support toString functionality
- Doesn't support binary data types
If you really want to overcome these limitations, let me know or feel free to contribute an implementation yourself.
NB: This is very much in development and I will always be developing on the latest version of Fedora. If I have broken an OS that you use, please let me know.
- RHEL / CentOS 5
- RHEL / CentOS 6
- Windows (coming soon)
The bridge depends on:
- MAMA / OpenMAMA
- Scons
Until dynamic bridge loading is supported, you will also need to build against
my github fork of OpenMAMA (https://github.com/fquinner/OpenMAMA) on the
feature-omzmq branch which contains the payload name and enum.
I will add the enum upstream at some point in the future too, but I plan on
using this bridge to help test the dynamic loading, so I'll not add the enum
to OpenMAMA master until that is ready.
If you have all the prerequisites, the build process should be pretty straightforward:
scons --with-mamasource=PATH --with-mamainstall=PATH --with-gtest=PATH
After building, you will have a libmamaomnmmsgimpl.so library created. Add the
directory containing this library to your LD_LIBRARY_PATH and set the macro
property USE_OMNMSG to 1 in bridge.c for the ZeroMQ bridge.
If you're interested in the thought process behind this or the ramblings of the author, you can shoot on over to my blog page.