From cc3755a16f00026af882ed14d122cc8aa6d50e82 Mon Sep 17 00:00:00 2001 From: Martin Sustrik Date: Mon, 3 Aug 2009 11:30:13 +0200 Subject: renamed from zs to zmq --- include/zmq.h | 207 ++++++++++++++++++++++++++++++++++++++++++++++++++ include/zmq.hpp | 231 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++ include/zs.h | 206 -------------------------------------------------- include/zs.hpp | 231 -------------------------------------------------------- 4 files changed, 438 insertions(+), 437 deletions(-) create mode 100644 include/zmq.h create mode 100644 include/zmq.hpp delete mode 100644 include/zs.h delete mode 100644 include/zs.hpp (limited to 'include') diff --git a/include/zmq.h b/include/zmq.h new file mode 100644 index 0000000..0fbc142 --- /dev/null +++ b/include/zmq.h @@ -0,0 +1,207 @@ +/* + Copyright (c) 2007-2009 FastMQ Inc. + + This file is part of 0MQ. + + 0MQ is free software; you can redistribute it and/or modify it under + the terms of the Lesser GNU General Public License as published by + the Free Software Foundation; either version 3 of the License, or + (at your option) any later version. + + 0MQ is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + Lesser GNU General Public License for more details. + + You should have received a copy of the Lesser GNU General Public License + along with this program. If not, see . +*/ + +#ifndef __ZMQ_H_INCLUDED__ +#define __ZMQ_H_INCLUDED__ + +#ifdef __cplusplus +extern "C" { +#endif + +#include +#include + +#if defined MSC_VER && defined ZMQ_BUILDING_LIBZMQ +#define ZMQ_EXPORT __declspec(dllexport) +#else +#define ZMQ_EXPORT +#endif + +// Maximal size of "Very Small Message". VSMs are passed by value +// to avoid excessive memory allocation/deallocation. +#define ZMQ_MAX_VSM_SIZE 30 + +// Message & notification types. +#define ZMQ_GAP 1 +#define ZMQ_DELIMITER 31 +#define ZMQ_VSM 32 + +// The operation should be performed in non-blocking mode. I.e. if it cannot +// be processed immediately, error should be returned with errno set to EAGAIN. +#define ZMQ_NOBLOCK 1 + +// zmq_send should not flush the message downstream immediately. Instead, it +// should batch ZMQ_NOFLUSH messages and send them downstream only if zmq_flush +// is invoked. This is an optimisation for cases where several messages are +// sent in a single business transaction. However, the effect is measurable +// only in extremely high-perf scenarios (million messages a second or so). +// If that's not your case, use standard flushing send instead. See exchange +// example for illustration of ZMQ_NOFLUSH functionality. +#define ZMQ_NOFLUSH 2 + +// Socket to communicate with a single peer. Allows for a singe connect or a +// single accept. There's no message routing or message filtering involved. +#define ZMQ_P2P 0 + +// Socket to distribute data. Recv fuction is not implemeted for this socket +// type. Messages are distributed in fanout fashion to all peers. +#define ZMQ_PUB 1 + +// Socket to subscribe to distributed data. Send function is not implemented +// for this socket type. However, subscribe function can be used to modify the +// message filter. +#define ZMQ_SUB 2 + +// Socket to send requests on and receive replies from. Requests are +// load-balanced among all the peers. This socket type doesn't allow for more +// recv's that there were send's. +#define ZMQ_REQ 3 + +// Socket to receive requests from and send replies to. This socket type allows +// only an alternated sequence of recv's and send's. Each send is routed to +// the peer that the previous recv delivered message from. +#define ZMQ_REP 4 + +// Prototype for the message body deallocation functions. +// It is deliberately defined in the way to comply with standard C free. +typedef void (zmq_free_fn) (void *data); + +// A message. If 'shared' is true, message content pointed to by 'content' +// is shared, i.e. reference counting is used to manage its lifetime +// rather than straighforward malloc/free. struct zmq_msg_content is +// not declared in the API. +struct zmq_msg +{ + struct zmq_msg_content *content; + unsigned char shared; + uint16_t vsm_size; + unsigned char vsm_data [ZMQ_MAX_VSM_SIZE]; +}; + +// TODO: Different options... +struct zmq_opts +{ + uint64_t hwm; + uint64_t lwm; + uint64_t swap; + uint64_t mask; + uint64_t taskset; + const char *identity; + const char *args; +}; + +// Initialise an empty message (zero bytes long). +ZMQ_EXPORT int zmq_msg_init (zmq_msg *msg); + +// Initialise a message 'size' bytes long. +// +// Errors: ENOMEM - the size is too large to allocate. +ZMQ_EXPORT int zmq_msg_init_size (zmq_msg *msg, size_t size); + +// Initialise a message from an existing buffer. Message isn't copied, +// instead 0SOCKETS infrastructure take ownership of the buffer and call +// deallocation functio (ffn) once it's not needed anymore. +ZMQ_EXPORT int zmq_msg_init_data (zmq_msg *msg, void *data, size_t size, + zmq_free_fn *ffn); + +// Deallocate the message. +ZMQ_EXPORT int zmq_msg_close (zmq_msg *msg); + +// Move the content of the message from 'src' to 'dest'. The content isn't +// copied, just moved. 'src' is an empty message after the call. Original +// content of 'dest' message is deallocated. +ZMQ_EXPORT int zmq_msg_move (zmq_msg *dest, zmq_msg *src); + +// Copy the 'src' message to 'dest'. The content isn't copied, instead +// reference count is increased. Don't modify the message data after the +// call as they are shared between two messages. Original content of 'dest' +// message is deallocated. +ZMQ_EXPORT int zmq_msg_copy (zmq_msg *dest, zmq_msg *src); + +// Returns pointer to message data. +ZMQ_EXPORT void *zmq_msg_data (zmq_msg *msg); + +// Return size of message data (in bytes). +ZMQ_EXPORT size_t zmq_msg_size (zmq_msg *msg); + +// Returns type of the message. +ZMQ_EXPORT int zmq_msg_type (zmq_msg *msg); + +// Initialise 0SOCKETS context. 'app_threads' specifies maximal number +// of application threads that can have open sockets at the same time. +// 'io_threads' specifies the size of thread pool to handle I/O operations. +// +// Errors: EINVAL - one of the arguments is less than zero or there are no +// threads declared at all. +ZMQ_EXPORT void *zmq_init (int app_threads, int io_threads); + +// Deinitialise 0SOCKETS context including all the open sockets. Closing +// sockets after zmq_term has been called will result in undefined behaviour. +ZMQ_EXPORT int zmq_term (void *context); + +// Open a socket. +// +// Errors: EINVAL - invalid socket type. +// EMFILE - the number of application threads entitled to hold open +// sockets at the same time was exceeded. +ZMQ_EXPORT void *zmq_socket (void *context, int type); + +// Close the socket. +ZMQ_EXPORT int zmq_close (void *s); + +// Bind the socket to a particular address. +ZMQ_EXPORT int zmq_bind (void *s, const char *addr, zmq_opts *opts); + +// Connect the socket to a particular address. +ZMQ_EXPORT int zmq_connect (void *s, const char *addr, zmq_opts *opts); + +// Subscribe for the subset of messages identified by 'criteria' argument. +ZMQ_EXPORT int zmq_subscribe (void *s, const char *criteria); + +// Send the message 'msg' to the socket 's'. 'flags' argument can be +// combination of following values: +// ZMQ_NOBLOCK - if message cannot be sent, return immediately. +// ZMQ_NOFLUSH - message won't be sent immediately. It'll be sent with either +// subsequent flushing send or explicit call to zmq_flush +// function. +// +// Errors: EAGAIN - message cannot be sent at the moment (applies only to +// non-blocking send). +// ENOTSUP - function isn't supported by particular socket type. +ZMQ_EXPORT int zmq_send (void *s, zmq_msg *msg, int flags); + +// Flush the messages that were send using ZMQ_NOFLUSH flag down the stream. +// +// Errors: ENOTSUP - function isn't supported by particular socket type. +ZMQ_EXPORT int zmq_flush (void *s); + +// Send a message from the socket 's'. 'flags' argument can be combination +// of following values: +// ZMQ_NOBLOCK - if message cannot be received, return immediately. +// +// Errors: EAGAIN - message cannot be received at the moment (applies only to +// non-blocking receive). +// ENOTSUP - function isn't supported by particular socket type. +ZMQ_EXPORT int zmq_recv (void *s, zmq_msg *msg, int flags); + +#ifdef __cplusplus +} +#endif + +#endif diff --git a/include/zmq.hpp b/include/zmq.hpp new file mode 100644 index 0000000..317fddf --- /dev/null +++ b/include/zmq.hpp @@ -0,0 +1,231 @@ +/* + Copyright (c) 2007-2009 FastMQ Inc. + + This file is part of 0MQ. + + 0MQ is free software; you can redistribute it and/or modify it under + the terms of the Lesser GNU General Public License as published by + the Free Software Foundation; either version 3 of the License, or + (at your option) any later version. + + 0MQ is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + Lesser GNU General Public License for more details. + + You should have received a copy of the Lesser GNU General Public License + along with this program. If not, see . +*/ + +#ifndef __ZMQ_HPP_INCLUDED__ +#define __ZMQ_HPP_INCLUDED__ + +#include "zmq.h" + +#include + +namespace zmq +{ + + typedef zmq_free_fn free_fn; + + enum message_type_t + { + message_data = 1 << 0, + message_gap = 1 << ZMQ_GAP, + message_delimiter = 1 << ZMQ_DELIMITER + }; + + // A message. Caution: Don't change the body of the message once you've + // copied it - the behaviour is undefined. Don't change the body of the + // received message either - other threads may be accessing it in parallel. + + class message_t : private zmq_msg + { + friend class socket_t; + + public: + + // Creates message size_ bytes long. + inline message_t (size_t size_ = 0) + { + int rc = zmq_msg_init_size (this, size_); + assert (rc == 0); + } + + // Creates message from the supplied buffer. 0MQ takes care of + // deallocating the buffer once it is not needed. The deallocation + // function is supplied in ffn_ parameter. If ffn_ is NULL, no + // deallocation happens - this is useful for sending static buffers. + inline message_t (void *data_, size_t size_, + free_fn *ffn_) + { + int rc = zmq_msg_init_data (this, data_, size_, ffn_); + assert (rc == 0); + } + + // Destroys the message. + inline ~message_t () + { + int rc = zmq_msg_close (this); + assert (rc == 0); + } + + // Destroys old content of the message and allocates buffer for the + // new message body. Having this as a separate function allows user + // to reuse once-allocated message for multiple times. + inline void rebuild (size_t size_) + { + int rc = zmq_msg_close (this); + assert (rc == 0); + rc = zmq_msg_init_size (this, size_); + assert (rc == 0); + } + + // Same as above, however, the message is rebuilt from the supplied + // buffer. See appropriate constructor for discussion of buffer + // deallocation mechanism. + inline void rebuild (void *data_, size_t size_, free_fn *ffn_) + { + int rc = zmq_msg_close (this); + assert (rc == 0); + rc = zmq_msg_init_data (this, data_, size_, ffn_); + assert (rc == 0); + } + + // Moves the message content from one message to the another. If the + // destination message have contained data prior to the operation + // these get deallocated. The source message will contain 0 bytes + // of data after the operation. + inline void move_to (message_t *msg_) + { + int rc = zmq_msg_move (this, (zmq_msg*) msg_); + assert (rc == 0); + } + + // Copies the message content from one message to the another. If the + // destination message have contained data prior to the operation + // these get deallocated. + inline void copy_to (message_t *msg_) + { + int rc = zmq_msg_copy (this, (zmq_msg*) msg_); + assert (rc == 0); + } + + // Returns message type. + inline message_type_t type () + { + return (message_type_t) (1 << zmq_msg_type (this)); + } + + // Returns pointer to message's data buffer. + inline void *data () + { + return zmq_msg_data (this); + } + + // Returns the size of message data buffer. + inline size_t size () + { + return zmq_msg_size (this); + } + + private: + + // Disable implicit message copying, so that users won't use shared + // messages (less efficient) without being aware of the fact. + message_t (const message_t&); + void operator = (const message_t&); + }; + + class context_t + { + friend class socket_t; + + public: + + inline context_t (int app_threads_, int io_threads_) + { + ptr = zmq_init (app_threads_, io_threads_); + assert (ptr); + } + + inline ~context_t () + { + int rc = zmq_term (ptr); + assert (rc == 0); + } + + private: + + void *ptr; + + // Disable copying. + context_t (const context_t&); + void operator = (const context_t&); + }; + + class socket_t + { + public: + + inline socket_t (context_t &context_, int type_ = 0) + { + ptr = zmq_socket (context_.ptr, type_); + assert (ptr); + } + + inline ~socket_t () + { + int rc = zmq_close (ptr); + assert (rc == 0); + } + + inline void bind (const char *addr_, zmq_opts *opts_ = NULL) + { + int rc = zmq_bind (ptr, addr_, opts_); + assert (rc == 0); + } + + inline void connect (const char *addr_, zmq_opts *opts_ = NULL) + { + int rc = zmq_connect (ptr, addr_, opts_); + assert (rc == 0); + } + + inline void subscribe (const char *criteria_) + { + int rc = zmq_subscribe (ptr, criteria_); + assert (rc == 0); + } + + inline void send (message_t &msg_, int flags_ = 0) + { + int rc = zmq_send (ptr, &msg_, flags_); + assert (rc == 0); + } + + inline void flush () + { + int rc = zmq_flush (ptr); + assert (rc == 0); + } + + inline void recv (message_t *msg_, int flags_ = 0) + { + int rc = zmq_recv (ptr, msg_, flags_); + assert (rc == 0); + } + + private: + + void *ptr; + + // Disable copying. + socket_t (const socket_t&); + void operator = (const socket_t&); + }; + +} + +#endif diff --git a/include/zs.h b/include/zs.h deleted file mode 100644 index cae1a17..0000000 --- a/include/zs.h +++ /dev/null @@ -1,206 +0,0 @@ -/* - Copyright (c) 2007-2009 FastMQ Inc. - - This file is part of 0MQ. - - 0MQ is free software; you can redistribute it and/or modify it under - the terms of the Lesser GNU General Public License as published by - the Free Software Foundation; either version 3 of the License, or - (at your option) any later version. - - 0MQ is distributed in the hope that it will be useful, - but WITHOUT ANY WARRANTY; without even the implied warranty of - MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the - Lesser GNU General Public License for more details. - - You should have received a copy of the Lesser GNU General Public License - along with this program. If not, see . -*/ - -#ifndef __ZSOCKETS_H_INCLUDED__ -#define __ZSOCKETS_H_INCLUDED__ - -#ifdef __cplusplus -extern "C" { -#endif - -#include -#include - -#if defined MSC_VER && defined ZS_BUILDING_LIBZS -#define ZS_EXPORT __declspec(dllexport) -#else -#define ZS_EXPORT -#endif - -// Maximal size of "Very Small Message". VSMs are passed by value -// to avoid excessive memory allocation/deallocation. -#define ZS_MAX_VSM_SIZE 30 - -// Message & notification types. -#define ZS_GAP 1 -#define ZS_DELIMITER 31 -#define ZS_VSM 32 - -// The operation should be performed in non-blocking mode. I.e. if it cannot -// be processed immediately, error should be returned with errno set to EAGAIN. -#define ZS_NOBLOCK 1 - -// zs_send should not flush the message downstream immediately. Instead, it -// should batch ZS_NOFLUSH messages and send them downstream only when zs_flush -// is invoked. This is an optimisation for cases where several messages are -// sent in a single business transaction. However, the effect is measurable -// only in extremely high-perf scenarios (million messages a second or so). -// If that's not your case, use standard flushing send instead. See exchange -// example for illustration of ZS_NOFLUSH functionality. -#define ZS_NOFLUSH 2 - -// Socket to communicate with a single peer. Allows for a singe connect or a -// single accept. There's no message routing or message filtering involved. -#define ZS_P2P 0 - -// Socket to distribute data. Recv fuction is not implemeted for this socket -// type. Messages are distributed in fanout fashion to all peers. -#define ZS_PUB 1 - -// Socket to subscribe to distributed data. Send function is not implemented -// for this socket type. However, subscribe function can be used to modify the -// message filter. -#define ZS_SUB 2 - -// Socket to send requests on and receive replies from. Requests are -// load-balanced among all the peers. This socket type doesn't allow for more -// recv's that there were send's. -#define ZS_REQ 3 - -// Socket to receive requests from and send replies to. This socket type allows -// only an alternated sequence of recv's and send's. Each send is routed to -// the peer that the previous recv delivered message from. -#define ZS_REP 4 - -// Prototype for the message body deallocation functions. -// It is deliberately defined in the way to comply with standard C free. -typedef void (zs_free_fn) (void *data); - -// A message. If 'shared' is true, message content pointed to by 'content' -// is shared, i.e. reference counting is used to manage its lifetime -// rather than straighforward malloc/free. struct zs_msg_content is -// not declared in the API. -struct zs_msg -{ - struct zs_msg_content *content; - unsigned char shared; - uint16_t vsm_size; - unsigned char vsm_data [ZS_MAX_VSM_SIZE]; -}; - -// TODO: Different options... -struct zs_opts -{ - uint64_t hwm; - uint64_t lwm; - uint64_t swap; - uint64_t mask; - uint64_t taskset; - const char *identity; - const char *args; -}; - -// Initialise an empty message (zero bytes long). -ZS_EXPORT int zs_msg_init (zs_msg *msg); - -// Initialise a message 'size' bytes long. -// -// Errors: ENOMEM - the size is too large to allocate. -ZS_EXPORT int zs_msg_init_size (zs_msg *msg, size_t size); - -// Initialise a message from an existing buffer. Message isn't copied, -// instead 0SOCKETS infrastructure take ownership of the buffer and call -// deallocation functio (ffn) once it's not needed anymore. -ZS_EXPORT int zs_msg_init_data (zs_msg *msg, void *data, size_t size, - zs_free_fn *ffn); - -// Deallocate the message. -ZS_EXPORT int zs_msg_close (zs_msg *msg); - -// Move the content of the message from 'src' to 'dest'. The content isn't -// copied, just moved. 'src' is an empty message after the call. Original -// content of 'dest' message is deallocated. -ZS_EXPORT int zs_msg_move (zs_msg *dest, zs_msg *src); - -// Copy the 'src' message to 'dest'. The content isn't copied, instead -// reference count is increased. Don't modify the message data after the -// call as they are shared between two messages. Original content of 'dest' -// message is deallocated. -ZS_EXPORT int zs_msg_copy (zs_msg *dest, zs_msg *src); - -// Returns pointer to message data. -ZS_EXPORT void *zs_msg_data (zs_msg *msg); - -// Return size of message data (in bytes). -ZS_EXPORT size_t zs_msg_size (zs_msg *msg); - -// Returns type of the message. -ZS_EXPORT int zs_msg_type (zs_msg *msg); - -// Initialise 0SOCKETS context. 'app_threads' specifies maximal number -// of application threads that can have open sockets at the same time. -// 'io_threads' specifies the size of thread pool to handle I/O operations. -// -// Errors: EINVAL - one of the arguments is less than zero or there are no -// threads declared at all. -ZS_EXPORT void *zs_init (int app_threads, int io_threads); - -// Deinitialise 0SOCKETS context including all the open sockets. Closing -// sockets after zs_term has been called will result in undefined behaviour. -ZS_EXPORT int zs_term (void *context); - -// Open a socket. -// -// Errors: EINVAL - invalid socket type. -// EMFILE - the number of application threads entitled to hold open -// sockets at the same time was exceeded. -ZS_EXPORT void *zs_socket (void *context, int type); - -// Close the socket. -ZS_EXPORT int zs_close (void *s); - -// Bind the socket to a particular address. -ZS_EXPORT int zs_bind (void *s, const char *addr, zs_opts *opts); - -// Connect the socket to a particular address. -ZS_EXPORT int zs_connect (void *s, const char *addr, zs_opts *opts); - -// Subscribe for the subset of messages identified by 'criteria' argument. -ZS_EXPORT int zs_subscribe (void *s, const char *criteria); - -// Send the message 'msg' to the socket 's'. 'flags' argument can be -// combination of following values: -// ZS_NOBLOCK - if message cannot be sent, return immediately. -// ZS_NOFLUSH - message won't be sent immediately. It'll be sent with either -// subsequent flushing send or explicit call to zs_flush function. -// -// Errors: EAGAIN - message cannot be sent at the moment (applies only to -// non-blocking send). -// ENOTSUP - function isn't supported by particular socket type. -ZS_EXPORT int zs_send (void *s, zs_msg *msg, int flags); - -// Flush the messages that were send using ZS_NOFLUSH flag down the stream. -// -// Errors: ENOTSUP - function isn't supported by particular socket type. -ZS_EXPORT int zs_flush (void *s); - -// Send a message from the socket 's'. 'flags' argument can be combination -// of following values: -// ZS_NOBLOCK - if message cannot be received, return immediately. -// -// Errors: EAGAIN - message cannot be received at the moment (applies only to -// non-blocking receive). -// ENOTSUP - function isn't supported by particular socket type. -ZS_EXPORT int zs_recv (void *s, zs_msg *msg, int flags); - -#ifdef __cplusplus -} -#endif - -#endif diff --git a/include/zs.hpp b/include/zs.hpp deleted file mode 100644 index d0f607f..0000000 --- a/include/zs.hpp +++ /dev/null @@ -1,231 +0,0 @@ -/* - Copyright (c) 2007-2009 FastMQ Inc. - - This file is part of 0MQ. - - 0MQ is free software; you can redistribute it and/or modify it under - the terms of the Lesser GNU General Public License as published by - the Free Software Foundation; either version 3 of the License, or - (at your option) any later version. - - 0MQ is distributed in the hope that it will be useful, - but WITHOUT ANY WARRANTY; without even the implied warranty of - MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the - Lesser GNU General Public License for more details. - - You should have received a copy of the Lesser GNU General Public License - along with this program. If not, see . -*/ - -#ifndef __ZSOCKETS_HPP_INCLUDED__ -#define __ZSOCKETS_HPP_INCLUDED__ - -#include "zs.h" - -#include - -namespace zs -{ - - typedef zs_free_fn free_fn; - - enum message_type_t - { - message_data = 1 << 0, - message_gap = 1 << ZS_GAP, - message_delimiter = 1 << ZS_DELIMITER - }; - - // A message. Caution: Don't change the body of the message once you've - // copied it - the behaviour is undefined. Don't change the body of the - // received message either - other threads may be accessing it in parallel. - - class message_t : private zs_msg - { - friend class socket_t; - - public: - - // Creates message size_ bytes long. - inline message_t (size_t size_ = 0) - { - int rc = zs_msg_init_size (this, size_); - assert (rc == 0); - } - - // Creates message from the supplied buffer. 0MQ takes care of - // deallocating the buffer once it is not needed. The deallocation - // function is supplied in ffn_ parameter. If ffn_ is NULL, no - // deallocation happens - this is useful for sending static buffers. - inline message_t (void *data_, size_t size_, - free_fn *ffn_) - { - int rc = zs_msg_init_data (this, data_, size_, ffn_); - assert (rc == 0); - } - - // Destroys the message. - inline ~message_t () - { - int rc = zs_msg_close (this); - assert (rc == 0); - } - - // Destroys old content of the message and allocates buffer for the - // new message body. Having this as a separate function allows user - // to reuse once-allocated message for multiple times. - inline void rebuild (size_t size_) - { - int rc = zs_msg_close (this); - assert (rc == 0); - rc = zs_msg_init_size (this, size_); - assert (rc == 0); - } - - // Same as above, however, the message is rebuilt from the supplied - // buffer. See appropriate constructor for discussion of buffer - // deallocation mechanism. - inline void rebuild (void *data_, size_t size_, free_fn *ffn_) - { - int rc = zs_msg_close (this); - assert (rc == 0); - rc = zs_msg_init_data (this, data_, size_, ffn_); - assert (rc == 0); - } - - // Moves the message content from one message to the another. If the - // destination message have contained data prior to the operation - // these get deallocated. The source message will contain 0 bytes - // of data after the operation. - inline void move_to (message_t *msg_) - { - int rc = zs_msg_move (this, (zs_msg*) msg_); - assert (rc == 0); - } - - // Copies the message content from one message to the another. If the - // destination message have contained data prior to the operation - // these get deallocated. - inline void copy_to (message_t *msg_) - { - int rc = zs_msg_copy (this, (zs_msg*) msg_); - assert (rc == 0); - } - - // Returns message type. - inline message_type_t type () - { - return (message_type_t) (1 << zs_msg_type (this)); - } - - // Returns pointer to message's data buffer. - inline void *data () - { - return zs_msg_data (this); - } - - // Returns the size of message data buffer. - inline size_t size () - { - return zs_msg_size (this); - } - - private: - - // Disable implicit message copying, so that users won't use shared - // messages (less efficient) without being aware of the fact. - message_t (const message_t&); - void operator = (const message_t&); - }; - - class context_t - { - friend class socket_t; - - public: - - inline context_t (int app_threads_, int io_threads_) - { - ptr = zs_init (app_threads_, io_threads_); - assert (ptr); - } - - inline ~context_t () - { - int rc = zs_term (ptr); - assert (rc == 0); - } - - private: - - void *ptr; - - // Disable copying. - context_t (const context_t&); - void operator = (const context_t&); - }; - - class socket_t - { - public: - - inline socket_t (context_t &context_, int type_ = 0) - { - ptr = zs_socket (context_.ptr, type_); - assert (ptr); - } - - inline ~socket_t () - { - int rc = zs_close (ptr); - assert (rc == 0); - } - - inline void bind (const char *addr_, zs_opts *opts_ = NULL) - { - int rc = zs_bind (ptr, addr_, opts_); - assert (rc == 0); - } - - inline void connect (const char *addr_, zs_opts *opts_ = NULL) - { - int rc = zs_connect (ptr, addr_, opts_); - assert (rc == 0); - } - - inline void subscribe (const char *criteria_) - { - int rc = zs_subscribe (ptr, criteria_); - assert (rc == 0); - } - - inline void send (message_t &msg_, int flags_ = 0) - { - int rc = zs_send (ptr, &msg_, flags_); - assert (rc == 0); - } - - inline void flush () - { - int rc = zs_flush (ptr); - assert (rc == 0); - } - - inline void recv (message_t *msg_, int flags_ = 0) - { - int rc = zs_recv (ptr, msg_, flags_); - assert (rc == 0); - } - - private: - - void *ptr; - - // Disable copying. - socket_t (const socket_t&); - void operator = (const socket_t&); - }; - -} - -#endif -- cgit v1.2.3