czmq-ffi-gen 0.13.0-x86-mingw32 → 0.14.1-x86-mingw32

data/vendor/local/include/zmsg.h

@@ -29,27 +29,27 @@ extern "C" {
 CZMQ_EXPORT zmsg_t *
     zmsg_new (void);
 
-//  Receive message from socket, returns zmsg_t object or NULL if the recv   
-//  was interrupted. Does a blocking recv. If you want to not block then use 
+//  Receive message from socket, returns zmsg_t object or NULL if the recv
+//  was interrupted. Does a blocking recv. If you want to not block then use
 //  the zloop class or zmsg_recv_nowait or zmq_poll to check for socket input
-//  before receiving.                                                        
+//  before receiving.
 CZMQ_EXPORT zmsg_t *
     zmsg_recv (void *source);
 
 //  Load/append an open file into new message, return the message.
-//  Returns NULL if the message could not be loaded.              
+//  Returns NULL if the message could not be loaded.
 CZMQ_EXPORT zmsg_t *
     zmsg_load (FILE *file);
 
 //  Decodes a serialized message frame created by zmsg_encode () and returns
-//  a new zmsg_t object. Returns NULL if the frame was badly formatted or   
-//  there was insufficient memory to work.                                  
+//  a new zmsg_t object. Returns NULL if the frame was badly formatted or
+//  there was insufficient memory to work.
 CZMQ_EXPORT zmsg_t *
     zmsg_decode (zframe_t *frame);
 
 //  Generate a signal message encoding the given status. A signal is a short
-//  message carrying a 1-byte success/failure code (by convention, 0 means  
-//  OK). Signals are encoded to be distinguishable from "normal" messages.  
+//  message carrying a 1-byte success/failure code (by convention, 0 means
+//  OK). Signals are encoded to be distinguishable from "normal" messages.
 CZMQ_EXPORT zmsg_t *
     zmsg_new_signal (byte status);
 
@@ -59,17 +59,17 @@ CZMQ_EXPORT void
 
 //  Send message to destination socket, and destroy the message after sending
 //  it successfully. If the message has no frames, sends nothing but destroys
-//  the message anyhow. Nullifies the caller's reference to the message (as  
-//  it is a destructor).                                                     
+//  the message anyhow. Nullifies the caller's reference to the message (as
+//  it is a destructor).
 CZMQ_EXPORT int
     zmsg_send (zmsg_t **self_p, void *dest);
 
-//  Send message to destination socket as part of a multipart sequence, and 
-//  destroy the message after sending it successfully. Note that after a    
+//  Send message to destination socket as part of a multipart sequence, and
+//  destroy the message after sending it successfully. Note that after a
 //  zmsg_sendm, you must call zmsg_send or another method that sends a final
-//  message part. If the message has no frames, sends nothing but destroys  
-//  the message anyhow. Nullifies the caller's reference to the message (as 
-//  it is a destructor).                                                    
+//  message part. If the message has no frames, sends nothing but destroys
+//  the message anyhow. Nullifies the caller's reference to the message (as
+//  it is a destructor).
 CZMQ_EXPORT int
     zmsg_sendm (zmsg_t **self_p, void *dest);
 
@@ -81,17 +81,17 @@ CZMQ_EXPORT size_t
 CZMQ_EXPORT size_t
     zmsg_content_size (zmsg_t *self);
 
-//  Push frame to the front of the message, i.e. before all other frames.  
+//  Push frame to the front of the message, i.e. before all other frames.
 //  Message takes ownership of frame, will destroy it when message is sent.
-//  Returns 0 on success, -1 on error. Deprecates zmsg_push, which did not 
-//  nullify the caller's frame reference.                                  
+//  Returns 0 on success, -1 on error. Deprecates zmsg_push, which did not
+//  nullify the caller's frame reference.
 CZMQ_EXPORT int
     zmsg_prepend (zmsg_t *self, zframe_t **frame_p);
 
-//  Add frame to the end of the message, i.e. after all other frames.      
+//  Add frame to the end of the message, i.e. after all other frames.
 //  Message takes ownership of frame, will destroy it when message is sent.
-//  Returns 0 on success. Deprecates zmsg_add, which did not nullify the   
-//  caller's frame reference.                                              
+//  Returns 0 on success. Deprecates zmsg_add, which did not nullify the
+//  caller's frame reference.
 CZMQ_EXPORT int
     zmsg_append (zmsg_t *self, zframe_t **frame_p);
 
@@ -101,49 +101,49 @@ CZMQ_EXPORT zframe_t *
     zmsg_pop (zmsg_t *self);
 
 //  Push block of memory to front of message, as a new frame.
-//  Returns 0 on success, -1 on error.                       
+//  Returns 0 on success, -1 on error.
 CZMQ_EXPORT int
     zmsg_pushmem (zmsg_t *self, const void *data, size_t size);
 
 //  Add block of memory to the end of the message, as a new frame.
-//  Returns 0 on success, -1 on error.                            
+//  Returns 0 on success, -1 on error.
 CZMQ_EXPORT int
     zmsg_addmem (zmsg_t *self, const void *data, size_t size);
 
 //  Push string as new frame to front of message.
-//  Returns 0 on success, -1 on error.           
+//  Returns 0 on success, -1 on error.
 CZMQ_EXPORT int
     zmsg_pushstr (zmsg_t *self, const char *string);
 
 //  Push string as new frame to end of message.
-//  Returns 0 on success, -1 on error.         
+//  Returns 0 on success, -1 on error.
 CZMQ_EXPORT int
     zmsg_addstr (zmsg_t *self, const char *string);
 
 //  Push formatted string as new frame to front of message.
-//  Returns 0 on success, -1 on error.                     
+//  Returns 0 on success, -1 on error.
 CZMQ_EXPORT int
     zmsg_pushstrf (zmsg_t *self, const char *format, ...) CHECK_PRINTF (2);
 
 //  Push formatted string as new frame to end of message.
-//  Returns 0 on success, -1 on error.                   
+//  Returns 0 on success, -1 on error.
 CZMQ_EXPORT int
     zmsg_addstrf (zmsg_t *self, const char *format, ...) CHECK_PRINTF (2);
 
 //  Pop frame off front of message, return as fresh string. If there were
-//  no more frames in the message, returns NULL.                         
+//  no more frames in the message, returns NULL.
 //  Caller owns return value and must destroy it when done.
 CZMQ_EXPORT char *
     zmsg_popstr (zmsg_t *self);
 
-//  Push encoded message as a new frame. Message takes ownership of    
+//  Push encoded message as a new frame. Message takes ownership of
 //  submessage, so the original is destroyed in this call. Returns 0 on
-//  success, -1 on error.                                              
+//  success, -1 on error.
 CZMQ_EXPORT int
     zmsg_addmsg (zmsg_t *self, zmsg_t **msg_p);
 
 //  Remove first submessage from message, if any. Returns zmsg_t, or NULL if
-//  decoding was not successful.                                            
+//  decoding was not successful.
 //  Caller owns return value and must destroy it when done.
 CZMQ_EXPORT zmsg_t *
     zmsg_popmsg (zmsg_t *self);
@@ -153,12 +153,12 @@ CZMQ_EXPORT void
     zmsg_remove (zmsg_t *self, zframe_t *frame);
 
 //  Set cursor to first frame in message. Returns frame, or NULL, if the
-//  message is empty. Use this to navigate the frames as a list.        
+//  message is empty. Use this to navigate the frames as a list.
 CZMQ_EXPORT zframe_t *
     zmsg_first (zmsg_t *self);
 
 //  Return the next frame. If there are no more frames, returns NULL. To move
-//  to the first frame call zmsg_first(). Advances the cursor.               
+//  to the first frame call zmsg_first(). Advances the cursor.
 CZMQ_EXPORT zframe_t *
     zmsg_next (zmsg_t *self);
 
@@ -166,35 +166,35 @@ CZMQ_EXPORT zframe_t *
 CZMQ_EXPORT zframe_t *
     zmsg_last (zmsg_t *self);
 
-//  Save message to an open file, return 0 if OK, else -1. The message is  
-//  saved as a series of frames, each with length and data. Note that the  
-//  file is NOT guaranteed to be portable between operating systems, not   
+//  Save message to an open file, return 0 if OK, else -1. The message is
+//  saved as a series of frames, each with length and data. Note that the
+//  file is NOT guaranteed to be portable between operating systems, not
 //  versions of CZMQ. The file format is at present undocumented and liable
-//  to arbitrary change.                                                   
+//  to arbitrary change.
 CZMQ_EXPORT int
     zmsg_save (zmsg_t *self, FILE *file);
 
 //  Serialize multipart message to a single message frame. Use this method
-//  to send structured messages across transports that do not support     
-//  multipart data. Allocates and returns a new frame containing the      
-//  serialized message. To decode a serialized message frame, use         
-//  zmsg_decode ().                                                       
+//  to send structured messages across transports that do not support
+//  multipart data. Allocates and returns a new frame containing the
+//  serialized message. To decode a serialized message frame, use
+//  zmsg_decode ().
 //  Caller owns return value and must destroy it when done.
 CZMQ_EXPORT zframe_t *
     zmsg_encode (zmsg_t *self);
 
 //  Create copy of message, as new message object. Returns a fresh zmsg_t
-//  object. If message is null, or memory was exhausted, returns null.   
+//  object. If message is null, or memory was exhausted, returns null.
 //  Caller owns return value and must destroy it when done.
 CZMQ_EXPORT zmsg_t *
     zmsg_dup (zmsg_t *self);
 
 //  Send message to zsys log sink (may be stdout, or system facility as
-//  configured by zsys_set_logstream).                                 
+//  configured by zsys_set_logstream).
 CZMQ_EXPORT void
     zmsg_print (zmsg_t *self);
 
-//  Return true if the two messages have the same number of frames and each  
+//  Return true if the two messages have the same number of frames and each
 //  frame in the first message is identical to the corresponding frame in the
 //  other message. As with zframe_eq, return false if either message is NULL.
 CZMQ_EXPORT bool
@@ -215,13 +215,13 @@ CZMQ_EXPORT void
 #ifdef CZMQ_BUILD_DRAFT_API
 //  *** Draft method, for development use, may change without warning ***
 //  Return message routing ID, if the message came from a ZMQ_SERVER socket.
-//  Else returns zero.                                                      
+//  Else returns zero.
 CZMQ_EXPORT uint32_t
     zmsg_routing_id (zmsg_t *self);
 
 //  *** Draft method, for development use, may change without warning ***
 //  Set routing ID on message. This is used if/when the message is sent to a
-//  ZMQ_SERVER socket.                                                      
+//  ZMQ_SERVER socket.
 CZMQ_EXPORT void
     zmsg_set_routing_id (zmsg_t *self, uint32_t routing_id);
 

data/vendor/local/include/zpoller.h

@@ -23,9 +23,9 @@ extern "C" {
 //  @interface
 //  This is a stable class, and may not change except for emergencies. It
 //  is provided in stable builds.
-//  Create new poller, specifying zero or more readers. The list of 
+//  Create new poller, specifying zero or more readers. The list of
 //  readers ends in a NULL. Each reader can be a zsock_t instance, a
-//  zactor_t instance, a libzmq socket (void *), or a file handle.  
+//  zactor_t instance, a libzmq socket (void *), or a file handle.
 CZMQ_EXPORT zpoller_t *
     zpoller_new (void *reader, ...);
 
@@ -34,41 +34,41 @@ CZMQ_EXPORT void
     zpoller_destroy (zpoller_t **self_p);
 
 //  Add a reader to be polled. Returns 0 if OK, -1 on failure. The reader may
-//  be a libzmq void * socket, a zsock_t instance, or a zactor_t instance.   
+//  be a libzmq void * socket, a zsock_t instance, or a zactor_t instance.
 CZMQ_EXPORT int
     zpoller_add (zpoller_t *self, void *reader);
 
 //  Remove a reader from the poller; returns 0 if OK, -1 on failure. The reader
-//  must have been passed during construction, or in an zpoller_add () call.   
+//  must have been passed during construction, or in an zpoller_add () call.
 CZMQ_EXPORT int
     zpoller_remove (zpoller_t *self, void *reader);
 
-//  By default the poller stops if the process receives a SIGINT or SIGTERM  
+//  By default the poller stops if the process receives a SIGINT or SIGTERM
 //  signal. This makes it impossible to shut-down message based architectures
 //  like zactors. This method lets you switch off break handling. The default
-//  nonstop setting is off (false).                                          
+//  nonstop setting is off (false).
 CZMQ_EXPORT void
     zpoller_set_nonstop (zpoller_t *self, bool nonstop);
 
-//  Poll the registered readers for I/O, return first reader that has input.  
-//  The reader will be a libzmq void * socket, or a zsock_t or zactor_t       
-//  instance as specified in zpoller_new/zpoller_add. The timeout should be   
-//  zero or greater, or -1 to wait indefinitely. Socket priority is defined   
-//  by their order in the poll list. If you need a balanced poll, use the low 
+//  Poll the registered readers for I/O, return first reader that has input.
+//  The reader will be a libzmq void * socket, or a zsock_t or zactor_t
+//  instance as specified in zpoller_new/zpoller_add. The timeout should be
+//  zero or greater, or -1 to wait indefinitely. Socket priority is defined
+//  by their order in the poll list. If you need a balanced poll, use the low
 //  level zmq_poll method directly. If the poll call was interrupted (SIGINT),
-//  or the ZMQ context was destroyed, or the timeout expired, returns NULL.   
-//  You can test the actual exit condition by calling zpoller_expired () and  
-//  zpoller_terminated (). The timeout is in msec.                            
+//  or the ZMQ context was destroyed, or the timeout expired, returns NULL.
+//  You can test the actual exit condition by calling zpoller_expired () and
+//  zpoller_terminated (). The timeout is in msec.
 CZMQ_EXPORT void *
     zpoller_wait (zpoller_t *self, int timeout);
 
 //  Return true if the last zpoller_wait () call ended because the timeout
-//  expired, without any error.                                           
+//  expired, without any error.
 CZMQ_EXPORT bool
     zpoller_expired (zpoller_t *self);
 
 //  Return true if the last zpoller_wait () call ended because the process
-//  was interrupted, or the parent context was destroyed.                 
+//  was interrupted, or the parent context was destroyed.
 CZMQ_EXPORT bool
     zpoller_terminated (zpoller_t *self);
 

data/vendor/local/include/zsock.h

@@ -32,11 +32,11 @@ extern "C" {
 //  This class has draft methods, which may change over time. They are not
 //  in stable releases, by default. Use --enable-drafts to enable.
 //  Create a new socket. Returns the new socket, or NULL if the new socket
-//  could not be created. Note that the symbol zsock_new (and other       
-//  constructors/destructors for zsock) are redirected to the *_checked   
-//  variant, enabling intelligent socket leak detection. This can have    
+//  could not be created. Note that the symbol zsock_new (and other
+//  constructors/destructors for zsock) are redirected to the *_checked
+//  variant, enabling intelligent socket leak detection. This can have
 //  performance implications if you use a LOT of sockets. To turn off this
-//  redirection behaviour, define ZSOCK_NOCHECK.                          
+//  redirection behaviour, define ZSOCK_NOCHECK.
 CZMQ_EXPORT zsock_t *
     zsock_new (int type);
 
@@ -45,7 +45,7 @@ CZMQ_EXPORT zsock_t *
     zsock_new_pub (const char *endpoint);
 
 //  Create a SUB socket, and optionally subscribe to some prefix string. Default
-//  action is connect.                                                          
+//  action is connect.
 CZMQ_EXPORT zsock_t *
     zsock_new_sub (const char *endpoint, const char *subscribe);
 
@@ -90,30 +90,30 @@ CZMQ_EXPORT zsock_t *
     zsock_new_stream (const char *endpoint);
 
 //  Destroy the socket. You must use this for any socket created via the
-//  zsock_new method.                                                   
+//  zsock_new method.
 CZMQ_EXPORT void
     zsock_destroy (zsock_t **self_p);
 
-//  Bind a socket to a formatted endpoint. For tcp:// endpoints, supports   
-//  ephemeral ports, if you specify the port number as "*". By default      
-//  zsock uses the IANA designated range from C000 (49152) to FFFF (65535). 
-//  To override this range, follow the "*" with "[first-last]". Either or   
-//  both first and last may be empty. To bind to a random port within the   
-//  range, use "!" in place of "*".                                         
-//                                                                          
-//  Examples:                                                               
-//      tcp://127.0.0.1:*           bind to first free port from C000 up    
-//      tcp://127.0.0.1:!           bind to random port from C000 to FFFF   
-//      tcp://127.0.0.1:*[60000-]   bind to first free port from 60000 up   
-//      tcp://127.0.0.1:![-60000]   bind to random port from C000 to 60000  
-//      tcp://127.0.0.1:![55000-55999]                                      
-//                                  bind to random port from 55000 to 55999 
-//                                                                          
-//  On success, returns the actual port number used, for tcp:// endpoints,  
+//  Bind a socket to a formatted endpoint. For tcp:// endpoints, supports
+//  ephemeral ports, if you specify the port number as "*". By default
+//  zsock uses the IANA designated range from C000 (49152) to FFFF (65535).
+//  To override this range, follow the "*" with "[first-last]". Either or
+//  both first and last may be empty. To bind to a random port within the
+//  range, use "!" in place of "*".
+//
+//  Examples:
+//      tcp://127.0.0.1:*           bind to first free port from C000 up
+//      tcp://127.0.0.1:!           bind to random port from C000 to FFFF
+//      tcp://127.0.0.1:*[60000-]   bind to first free port from 60000 up
+//      tcp://127.0.0.1:![-60000]   bind to random port from C000 to 60000
+//      tcp://127.0.0.1:![55000-55999]
+//                                  bind to random port from 55000 to 55999
+//
+//  On success, returns the actual port number used, for tcp:// endpoints,
 //  and 0 for other transports. On failure, returns -1. Note that when using
-//  ephemeral ports, a port may be reused by different services without     
-//  clients being aware. Protocols that run on ephemeral ports should take  
-//  this into account.                                                      
+//  ephemeral ports, a port may be reused by different services without
+//  clients being aware. Protocols that run on ephemeral ports should take
+//  this into account.
 CZMQ_EXPORT int
     zsock_bind (zsock_t *self, const char *format, ...) CHECK_PRINTF (2);
 
@@ -121,29 +121,29 @@ CZMQ_EXPORT int
 CZMQ_EXPORT const char *
     zsock_endpoint (zsock_t *self);
 
-//  Unbind a socket from a formatted endpoint.                     
+//  Unbind a socket from a formatted endpoint.
 //  Returns 0 if OK, -1 if the endpoint was invalid or the function
-//  isn't supported.                                               
+//  isn't supported.
 CZMQ_EXPORT int
     zsock_unbind (zsock_t *self, const char *format, ...) CHECK_PRINTF (2);
 
-//  Connect a socket to a formatted endpoint        
+//  Connect a socket to a formatted endpoint
 //  Returns 0 if OK, -1 if the endpoint was invalid.
 CZMQ_EXPORT int
     zsock_connect (zsock_t *self, const char *format, ...) CHECK_PRINTF (2);
 
-//  Disconnect a socket from a formatted endpoint                  
+//  Disconnect a socket from a formatted endpoint
 //  Returns 0 if OK, -1 if the endpoint was invalid or the function
-//  isn't supported.                                               
+//  isn't supported.
 CZMQ_EXPORT int
     zsock_disconnect (zsock_t *self, const char *format, ...) CHECK_PRINTF (2);
 
-//  Attach a socket to zero or more endpoints. If endpoints is not null,     
-//  parses as list of ZeroMQ endpoints, separated by commas, and prefixed by 
+//  Attach a socket to zero or more endpoints. If endpoints is not null,
+//  parses as list of ZeroMQ endpoints, separated by commas, and prefixed by
 //  '@' (to bind the socket) or '>' (to connect the socket). Returns 0 if all
-//  endpoints were valid, or -1 if there was a syntax error. If the endpoint 
-//  does not start with '@' or '>', the serverish argument defines whether   
-//  it is used to bind (serverish = true) or connect (serverish = false).    
+//  endpoints were valid, or -1 if there was a syntax error. If the endpoint
+//  does not start with '@' or '>', the serverish argument defines whether
+//  it is used to bind (serverish = true) or connect (serverish = false).
 CZMQ_EXPORT int
     zsock_attach (zsock_t *self, const char *endpoints, bool serverish);
 
@@ -151,861 +151,911 @@ CZMQ_EXPORT int
 CZMQ_EXPORT const char *
     zsock_type_str (zsock_t *self);
 
-//  Send a 'picture' message to the socket (or actor). The picture is a   
+//  Send a 'picture' message to the socket (or actor). The picture is a
 //  string that defines the type of each frame. This makes it easy to send
-//  a complex multiframe message in one call. The picture can contain any 
-//  of these characters, each corresponding to one or two arguments:      
-//                                                                        
-//      i = int (signed)                                                  
-//      1 = uint8_t                                                       
-//      2 = uint16_t                                                      
-//      4 = uint32_t                                                      
-//      8 = uint64_t                                                      
-//      s = char *                                                        
-//      b = byte *, size_t (2 arguments)                                  
-//      c = zchunk_t *                                                    
-//      f = zframe_t *                                                    
-//      h = zhashx_t *                                                    
-//      U = zuuid_t *                                                     
-//      p = void * (sends the pointer value, only meaningful over inproc) 
-//      m = zmsg_t * (sends all frames in the zmsg)                       
-//      z = sends zero-sized frame (0 arguments)                          
-//      u = uint (deprecated)                                             
-//                                                                        
-//  Note that s, b, c, and f are encoded the same way and the choice is   
-//  offered as a convenience to the sender, which may or may not already  
-//  have data in a zchunk or zframe. Does not change or take ownership of 
-//  any arguments. Returns 0 if successful, -1 if sending failed for any  
-//  reason.                                                               
+//  a complex multiframe message in one call. The picture can contain any
+//  of these characters, each corresponding to one or two arguments:
+//
+//      i = int (signed)
+//      1 = uint8_t
+//      2 = uint16_t
+//      4 = uint32_t
+//      8 = uint64_t
+//      s = char *
+//      b = byte *, size_t (2 arguments)
+//      c = zchunk_t *
+//      f = zframe_t *
+//      h = zhashx_t *
+//      U = zuuid_t *
+//      p = void * (sends the pointer value, only meaningful over inproc)
+//      m = zmsg_t * (sends all frames in the zmsg)
+//      z = sends zero-sized frame (0 arguments)
+//      u = uint (deprecated)
+//
+//  Note that s, b, c, and f are encoded the same way and the choice is
+//  offered as a convenience to the sender, which may or may not already
+//  have data in a zchunk or zframe. Does not change or take ownership of
+//  any arguments. Returns 0 if successful, -1 if sending failed for any
+//  reason.
 CZMQ_EXPORT int
     zsock_send (void *self, const char *picture, ...);
 
-//  Send a 'picture' message to the socket (or actor). This is a va_list 
+//  Send a 'picture' message to the socket (or actor). This is a va_list
 //  version of zsock_send (), so please consult its documentation for the
-//  details.                                                             
+//  details.
 CZMQ_EXPORT int
     zsock_vsend (void *self, const char *picture, va_list argptr);
 
 //  Receive a 'picture' message to the socket (or actor). See zsock_send for
 //  the format and meaning of the picture. Returns the picture elements into
-//  a series of pointers as provided by the caller:                         
-//                                                                          
-//      i = int * (stores signed integer)                                   
-//      4 = uint32_t * (stores 32-bit unsigned integer)                     
-//      8 = uint64_t * (stores 64-bit unsigned integer)                     
-//      s = char ** (allocates new string)                                  
-//      b = byte **, size_t * (2 arguments) (allocates memory)              
-//      c = zchunk_t ** (creates zchunk)                                    
-//      f = zframe_t ** (creates zframe)                                    
-//      U = zuuid_t * (creates a zuuid with the data)                       
-//      h = zhashx_t ** (creates zhashx)                                    
-//      p = void ** (stores pointer)                                        
-//      m = zmsg_t ** (creates a zmsg with the remaing frames)              
-//      z = null, asserts empty frame (0 arguments)                         
-//      u = uint * (stores unsigned integer, deprecated)                    
-//                                                                          
-//  Note that zsock_recv creates the returned objects, and the caller must  
-//  destroy them when finished with them. The supplied pointers do not need 
-//  to be initialized. Returns 0 if successful, or -1 if it failed to recv  
-//  a message, in which case the pointers are not modified. When message    
+//  a series of pointers as provided by the caller:
+//
+//      i = int * (stores signed integer)
+//      4 = uint32_t * (stores 32-bit unsigned integer)
+//      8 = uint64_t * (stores 64-bit unsigned integer)
+//      s = char ** (allocates new string)
+//      b = byte **, size_t * (2 arguments) (allocates memory)
+//      c = zchunk_t ** (creates zchunk)
+//      f = zframe_t ** (creates zframe)
+//      U = zuuid_t * (creates a zuuid with the data)
+//      h = zhashx_t ** (creates zhashx)
+//      p = void ** (stores pointer)
+//      m = zmsg_t ** (creates a zmsg with the remaing frames)
+//      z = null, asserts empty frame (0 arguments)
+//      u = uint * (stores unsigned integer, deprecated)
+//
+//  Note that zsock_recv creates the returned objects, and the caller must
+//  destroy them when finished with them. The supplied pointers do not need
+//  to be initialized. Returns 0 if successful, or -1 if it failed to recv
+//  a message, in which case the pointers are not modified. When message
 //  frames are truncated (a short message), sets return values to zero/null.
-//  If an argument pointer is NULL, does not store any value (skips it).    
-//  An 'n' picture matches an empty frame; if the message does not match,   
-//  the method will return -1.                                              
+//  If an argument pointer is NULL, does not store any value (skips it).
+//  An 'n' picture matches an empty frame; if the message does not match,
+//  the method will return -1.
 CZMQ_EXPORT int
     zsock_recv (void *self, const char *picture, ...);
 
-//  Receive a 'picture' message from the socket (or actor). This is a    
+//  Receive a 'picture' message from the socket (or actor). This is a
 //  va_list version of zsock_recv (), so please consult its documentation
-//  for the details.                                                     
+//  for the details.
 CZMQ_EXPORT int
     zsock_vrecv (void *self, const char *picture, va_list argptr);
 
-//  Send a binary encoded 'picture' message to the socket (or actor). This 
-//  method is similar to zsock_send, except the arguments are encoded in a 
+//  Send a binary encoded 'picture' message to the socket (or actor). This
+//  method is similar to zsock_send, except the arguments are encoded in a
 //  binary format that is compatible with zproto, and is designed to reduce
-//  memory allocations. The pattern argument is a string that defines the  
-//  type of each argument. Supports these argument types:                  
-//                                                                         
-//   pattern    C type                  zproto type:                       
-//      1       uint8_t                 type = "number" size = "1"         
-//      2       uint16_t                type = "number" size = "2"         
-//      4       uint32_t                type = "number" size = "3"         
-//      8       uint64_t                type = "number" size = "4"         
-//      s       char *, 0-255 chars     type = "string"                    
-//      S       char *, 0-2^32-1 chars  type = "longstr"                   
-//      c       zchunk_t *              type = "chunk"                     
-//      f       zframe_t *              type = "frame"                     
-//      u       zuuid_t *               type = "uuid"                      
-//      m       zmsg_t *                type = "msg"                       
-//      p       void *, sends pointer value, only over inproc              
-//                                                                         
-//  Does not change or take ownership of any arguments. Returns 0 if       
-//  successful, -1 if sending failed for any reason.                       
+//  memory allocations. The pattern argument is a string that defines the
+//  type of each argument. Supports these argument types:
+//
+//   pattern    C type                  zproto type:
+//      1       uint8_t                 type = "number" size = "1"
+//      2       uint16_t                type = "number" size = "2"
+//      4       uint32_t                type = "number" size = "3"
+//      8       uint64_t                type = "number" size = "4"
+//      s       char *, 0-255 chars     type = "string"
+//      S       char *, 0-2^32-1 chars  type = "longstr"
+//      c       zchunk_t *              type = "chunk"
+//      f       zframe_t *              type = "frame"
+//      u       zuuid_t *               type = "uuid"
+//      m       zmsg_t *                type = "msg"
+//      p       void *, sends pointer value, only over inproc
+//
+//  Does not change or take ownership of any arguments. Returns 0 if
+//  successful, -1 if sending failed for any reason.
 CZMQ_EXPORT int
     zsock_bsend (void *self, const char *picture, ...);
 
-//  Receive a binary encoded 'picture' message from the socket (or actor).  
-//  This method is similar to zsock_recv, except the arguments are encoded  
-//  in a binary format that is compatible with zproto, and is designed to   
+//  Receive a binary encoded 'picture' message from the socket (or actor).
+//  This method is similar to zsock_recv, except the arguments are encoded
+//  in a binary format that is compatible with zproto, and is designed to
 //  reduce memory allocations. The pattern argument is a string that defines
-//  the type of each argument. See zsock_bsend for the supported argument   
-//  types. All arguments must be pointers; this call sets them to point to  
-//  values held on a per-socket basis.                                      
-//  Note that zsock_brecv creates the returned objects, and the caller must 
-//  destroy them when finished with them. The supplied pointers do not need 
-//  to be initialized. Returns 0 if successful, or -1 if it failed to read  
-//  a message.                                                              
+//  the type of each argument. See zsock_bsend for the supported argument
+//  types. All arguments must be pointers; this call sets them to point to
+//  values held on a per-socket basis.
+//  For types 1, 2, 4 and 8 the caller must allocate the memory itself before
+//  calling zsock_brecv.
+//  For types S, the caller must free the value once finished with it, as
+//  zsock_brecv will allocate the buffer.
+//  For type s, the caller must not free the value as it is stored in a
+//  local cache for performance purposes.
+//  For types c, f, u and m the caller must call the appropriate destructor
+//  depending on the object as zsock_brecv will create new objects.
+//  For type p the caller must coordinate with the sender, as it is just a
+//  pointer value being passed.
 CZMQ_EXPORT int
     zsock_brecv (void *self, const char *picture, ...);
 
 //  Set socket to use unbounded pipes (HWM=0); use this in cases when you are
-//  totally certain the message volume can fit in memory. This method works  
-//  across all versions of ZeroMQ. Takes a polymorphic socket reference.     
+//  totally certain the message volume can fit in memory. This method works
+//  across all versions of ZeroMQ. Takes a polymorphic socket reference.
 CZMQ_EXPORT void
     zsock_set_unbounded (void *self);
 
-//  Send a signal over a socket. A signal is a short message carrying a   
-//  success/failure code (by convention, 0 means OK). Signals are encoded 
-//  to be distinguishable from "normal" messages. Accepts a zsock_t or a  
+//  Send a signal over a socket. A signal is a short message carrying a
+//  success/failure code (by convention, 0 means OK). Signals are encoded
+//  to be distinguishable from "normal" messages. Accepts a zsock_t or a
 //  zactor_t argument, and returns 0 if successful, -1 if the signal could
-//  not be sent. Takes a polymorphic socket reference.                    
+//  not be sent. Takes a polymorphic socket reference.
 CZMQ_EXPORT int
     zsock_signal (void *self, byte status);
 
-//  Wait on a signal. Use this to coordinate between threads, over pipe  
+//  Wait on a signal. Use this to coordinate between threads, over pipe
 //  pairs. Blocks until the signal is received. Returns -1 on error, 0 or
-//  greater on success. Accepts a zsock_t or a zactor_t as argument.     
-//  Takes a polymorphic socket reference.                                
+//  greater on success. Accepts a zsock_t or a zactor_t as argument.
+//  Takes a polymorphic socket reference.
 CZMQ_EXPORT int
     zsock_wait (void *self);
 
-//  If there is a partial message still waiting on the socket, remove and    
+//  If there is a partial message still waiting on the socket, remove and
 //  discard it. This is useful when reading partial messages, to get specific
-//  message types.                                                           
+//  message types.
 CZMQ_EXPORT void
     zsock_flush (void *self);
 
 //  Probe the supplied object, and report if it looks like a zsock_t.
-//  Takes a polymorphic socket reference.                            
+//  Takes a polymorphic socket reference.
 CZMQ_EXPORT bool
     zsock_is (void *self);
 
 //  Probe the supplied reference. If it looks like a zsock_t instance, return
-//  the underlying libzmq socket handle; else if it looks like a file        
-//  descriptor, return NULL; else if it looks like a libzmq socket handle,   
-//  return the supplied value. Takes a polymorphic socket reference.         
+//  the underlying libzmq socket handle; else if it looks like a file
+//  descriptor, return NULL; else if it looks like a libzmq socket handle,
+//  return the supplied value. Takes a polymorphic socket reference.
 CZMQ_EXPORT void *
     zsock_resolve (void *self);
 
 //  Get socket option `heartbeat_ivl`.
-//  Available from libzmq 4.2.0.      
+//  Available from libzmq 4.2.0.
 //  Caller owns return value and must destroy it when done.
 CZMQ_EXPORT int
     zsock_heartbeat_ivl (void *self);
 
 //  Set socket option `heartbeat_ivl`.
-//  Available from libzmq 4.2.0.      
+//  Available from libzmq 4.2.0.
 CZMQ_EXPORT void
     zsock_set_heartbeat_ivl (void *self, int heartbeat_ivl);
 
 //  Get socket option `heartbeat_ttl`.
-//  Available from libzmq 4.2.0.      
+//  Available from libzmq 4.2.0.
 //  Caller owns return value and must destroy it when done.
 CZMQ_EXPORT int
     zsock_heartbeat_ttl (void *self);
 
 //  Set socket option `heartbeat_ttl`.
-//  Available from libzmq 4.2.0.      
+//  Available from libzmq 4.2.0.
 CZMQ_EXPORT void
     zsock_set_heartbeat_ttl (void *self, int heartbeat_ttl);
 
 //  Get socket option `heartbeat_timeout`.
-//  Available from libzmq 4.2.0.          
+//  Available from libzmq 4.2.0.
 //  Caller owns return value and must destroy it when done.
 CZMQ_EXPORT int
     zsock_heartbeat_timeout (void *self);
 
 //  Set socket option `heartbeat_timeout`.
-//  Available from libzmq 4.2.0.          
+//  Available from libzmq 4.2.0.
 CZMQ_EXPORT void
     zsock_set_heartbeat_timeout (void *self, int heartbeat_timeout);
 
-//  Get socket option `use_fd`. 
+//  Get socket option `use_fd`.
 //  Available from libzmq 4.2.0.
 //  Caller owns return value and must destroy it when done.
 CZMQ_EXPORT int
     zsock_use_fd (void *self);
 
-//  Set socket option `use_fd`. 
+//  Set socket option `use_fd`.
 //  Available from libzmq 4.2.0.
 CZMQ_EXPORT void
     zsock_set_use_fd (void *self, int use_fd);
 
 //  Set socket option `xpub_manual`.
-//  Available from libzmq 4.2.0.    
+//  Available from libzmq 4.2.0.
 CZMQ_EXPORT void
     zsock_set_xpub_manual (void *self, int xpub_manual);
 
 //  Set socket option `xpub_welcome_msg`.
-//  Available from libzmq 4.2.0.         
+//  Available from libzmq 4.2.0.
 CZMQ_EXPORT void
     zsock_set_xpub_welcome_msg (void *self, const char *xpub_welcome_msg);
 
 //  Set socket option `stream_notify`.
-//  Available from libzmq 4.2.0.      
+//  Available from libzmq 4.2.0.
 CZMQ_EXPORT void
     zsock_set_stream_notify (void *self, int stream_notify);
 
 //  Get socket option `invert_matching`.
-//  Available from libzmq 4.2.0.        
+//  Available from libzmq 4.2.0.
 //  Caller owns return value and must destroy it when done.
 CZMQ_EXPORT int
     zsock_invert_matching (void *self);
 
 //  Set socket option `invert_matching`.
-//  Available from libzmq 4.2.0.        
+//  Available from libzmq 4.2.0.
 CZMQ_EXPORT void
     zsock_set_invert_matching (void *self, int invert_matching);
 
 //  Set socket option `xpub_verboser`.
-//  Available from libzmq 4.2.0.      
+//  Available from libzmq 4.2.0.
 CZMQ_EXPORT void
     zsock_set_xpub_verboser (void *self, int xpub_verboser);
 
 //  Get socket option `connect_timeout`.
-//  Available from libzmq 4.2.0.        
+//  Available from libzmq 4.2.0.
 //  Caller owns return value and must destroy it when done.
 CZMQ_EXPORT int
     zsock_connect_timeout (void *self);
 
 //  Set socket option `connect_timeout`.
-//  Available from libzmq 4.2.0.        
+//  Available from libzmq 4.2.0.
 CZMQ_EXPORT void
     zsock_set_connect_timeout (void *self, int connect_timeout);
 
 //  Get socket option `tcp_maxrt`.
-//  Available from libzmq 4.2.0.  
+//  Available from libzmq 4.2.0.
 //  Caller owns return value and must destroy it when done.
 CZMQ_EXPORT int
     zsock_tcp_maxrt (void *self);
 
 //  Set socket option `tcp_maxrt`.
-//  Available from libzmq 4.2.0.  
+//  Available from libzmq 4.2.0.
 CZMQ_EXPORT void
     zsock_set_tcp_maxrt (void *self, int tcp_maxrt);
 
 //  Get socket option `thread_safe`.
-//  Available from libzmq 4.2.0.    
+//  Available from libzmq 4.2.0.
 //  Caller owns return value and must destroy it when done.
 CZMQ_EXPORT int
     zsock_thread_safe (void *self);
 
 //  Get socket option `multicast_maxtpdu`.
-//  Available from libzmq 4.2.0.          
+//  Available from libzmq 4.2.0.
 //  Caller owns return value and must destroy it when done.
 CZMQ_EXPORT int
     zsock_multicast_maxtpdu (void *self);
 
 //  Set socket option `multicast_maxtpdu`.
-//  Available from libzmq 4.2.0.          
+//  Available from libzmq 4.2.0.
 CZMQ_EXPORT void
     zsock_set_multicast_maxtpdu (void *self, int multicast_maxtpdu);
 
 //  Get socket option `vmci_buffer_size`.
-//  Available from libzmq 4.2.0.         
+//  Available from libzmq 4.2.0.
 //  Caller owns return value and must destroy it when done.
 CZMQ_EXPORT int
     zsock_vmci_buffer_size (void *self);
 
 //  Set socket option `vmci_buffer_size`.
-//  Available from libzmq 4.2.0.         
+//  Available from libzmq 4.2.0.
 CZMQ_EXPORT void
     zsock_set_vmci_buffer_size (void *self, int vmci_buffer_size);
 
 //  Get socket option `vmci_buffer_min_size`.
-//  Available from libzmq 4.2.0.             
+//  Available from libzmq 4.2.0.
 //  Caller owns return value and must destroy it when done.
 CZMQ_EXPORT int
     zsock_vmci_buffer_min_size (void *self);
 
 //  Set socket option `vmci_buffer_min_size`.
-//  Available from libzmq 4.2.0.             
+//  Available from libzmq 4.2.0.
 CZMQ_EXPORT void
     zsock_set_vmci_buffer_min_size (void *self, int vmci_buffer_min_size);
 
 //  Get socket option `vmci_buffer_max_size`.
-//  Available from libzmq 4.2.0.             
+//  Available from libzmq 4.2.0.
 //  Caller owns return value and must destroy it when done.
 CZMQ_EXPORT int
     zsock_vmci_buffer_max_size (void *self);
 
 //  Set socket option `vmci_buffer_max_size`.
-//  Available from libzmq 4.2.0.             
+//  Available from libzmq 4.2.0.
 CZMQ_EXPORT void
     zsock_set_vmci_buffer_max_size (void *self, int vmci_buffer_max_size);
 
 //  Get socket option `vmci_connect_timeout`.
-//  Available from libzmq 4.2.0.             
+//  Available from libzmq 4.2.0.
 //  Caller owns return value and must destroy it when done.
 CZMQ_EXPORT int
     zsock_vmci_connect_timeout (void *self);
 
 //  Set socket option `vmci_connect_timeout`.
-//  Available from libzmq 4.2.0.             
+//  Available from libzmq 4.2.0.
 CZMQ_EXPORT void
     zsock_set_vmci_connect_timeout (void *self, int vmci_connect_timeout);
 
-//  Get socket option `tos`.    
+//  Get socket option `tos`.
 //  Available from libzmq 4.1.0.
 //  Caller owns return value and must destroy it when done.
 CZMQ_EXPORT int
     zsock_tos (void *self);
 
-//  Set socket option `tos`.    
+//  Set socket option `tos`.
 //  Available from libzmq 4.1.0.
 CZMQ_EXPORT void
     zsock_set_tos (void *self, int tos);
 
 //  Set socket option `router_handover`.
-//  Available from libzmq 4.1.0.        
+//  Available from libzmq 4.1.0.
 CZMQ_EXPORT void
     zsock_set_router_handover (void *self, int router_handover);
 
 //  Set socket option `connect_rid`.
-//  Available from libzmq 4.1.0.    
+//  Available from libzmq 4.1.0.
 CZMQ_EXPORT void
     zsock_set_connect_rid (void *self, const char *connect_rid);
 
 //  Set socket option `connect_rid` from 32-octet binary
-//  Available from libzmq 4.1.0.                        
+//  Available from libzmq 4.1.0.
 CZMQ_EXPORT void
     zsock_set_connect_rid_bin (void *self, const byte *connect_rid);
 
 //  Get socket option `handshake_ivl`.
-//  Available from libzmq 4.1.0.      
+//  Available from libzmq 4.1.0.
 //  Caller owns return value and must destroy it when done.
 CZMQ_EXPORT int
     zsock_handshake_ivl (void *self);
 
 //  Set socket option `handshake_ivl`.
-//  Available from libzmq 4.1.0.      
+//  Available from libzmq 4.1.0.
 CZMQ_EXPORT void
     zsock_set_handshake_ivl (void *self, int handshake_ivl);
 
 //  Get socket option `socks_proxy`.
-//  Available from libzmq 4.1.0.    
+//  Available from libzmq 4.1.0.
 //  Caller owns return value and must destroy it when done.
 CZMQ_EXPORT char *
     zsock_socks_proxy (void *self);
 
 //  Set socket option `socks_proxy`.
-//  Available from libzmq 4.1.0.    
+//  Available from libzmq 4.1.0.
 CZMQ_EXPORT void
     zsock_set_socks_proxy (void *self, const char *socks_proxy);
 
 //  Set socket option `xpub_nodrop`.
-//  Available from libzmq 4.1.0.    
+//  Available from libzmq 4.1.0.
 CZMQ_EXPORT void
     zsock_set_xpub_nodrop (void *self, int xpub_nodrop);
 
 //  Set socket option `router_mandatory`.
-//  Available from libzmq 4.0.0.         
+//  Available from libzmq 4.0.0.
 CZMQ_EXPORT void
     zsock_set_router_mandatory (void *self, int router_mandatory);
 
 //  Set socket option `probe_router`.
-//  Available from libzmq 4.0.0.     
+//  Available from libzmq 4.0.0.
 CZMQ_EXPORT void
     zsock_set_probe_router (void *self, int probe_router);
 
 //  Set socket option `req_relaxed`.
-//  Available from libzmq 4.0.0.    
+//  Available from libzmq 4.0.0.
 CZMQ_EXPORT void
     zsock_set_req_relaxed (void *self, int req_relaxed);
 
 //  Set socket option `req_correlate`.
-//  Available from libzmq 4.0.0.      
+//  Available from libzmq 4.0.0.
 CZMQ_EXPORT void
     zsock_set_req_correlate (void *self, int req_correlate);
 
 //  Set socket option `conflate`.
-//  Available from libzmq 4.0.0. 
+//  Available from libzmq 4.0.0.
 CZMQ_EXPORT void
     zsock_set_conflate (void *self, int conflate);
 
 //  Get socket option `zap_domain`.
-//  Available from libzmq 4.0.0.   
+//  Available from libzmq 4.0.0.
 //  Caller owns return value and must destroy it when done.
 CZMQ_EXPORT char *
     zsock_zap_domain (void *self);
 
 //  Set socket option `zap_domain`.
-//  Available from libzmq 4.0.0.   
+//  Available from libzmq 4.0.0.
 CZMQ_EXPORT void
     zsock_set_zap_domain (void *self, const char *zap_domain);
 
 //  Get socket option `mechanism`.
-//  Available from libzmq 4.0.0.  
+//  Available from libzmq 4.0.0.
 //  Caller owns return value and must destroy it when done.
 CZMQ_EXPORT int
     zsock_mechanism (void *self);
 
 //  Get socket option `plain_server`.
-//  Available from libzmq 4.0.0.     
+//  Available from libzmq 4.0.0.
 //  Caller owns return value and must destroy it when done.
 CZMQ_EXPORT int
     zsock_plain_server (void *self);
 
 //  Set socket option `plain_server`.
-//  Available from libzmq 4.0.0.     
+//  Available from libzmq 4.0.0.
 CZMQ_EXPORT void
     zsock_set_plain_server (void *self, int plain_server);
 
 //  Get socket option `plain_username`.
-//  Available from libzmq 4.0.0.       
+//  Available from libzmq 4.0.0.
 //  Caller owns return value and must destroy it when done.
 CZMQ_EXPORT char *
     zsock_plain_username (void *self);
 
 //  Set socket option `plain_username`.
-//  Available from libzmq 4.0.0.       
+//  Available from libzmq 4.0.0.
 CZMQ_EXPORT void
     zsock_set_plain_username (void *self, const char *plain_username);
 
 //  Get socket option `plain_password`.
-//  Available from libzmq 4.0.0.       
+//  Available from libzmq 4.0.0.
 //  Caller owns return value and must destroy it when done.
 CZMQ_EXPORT char *
     zsock_plain_password (void *self);
 
 //  Set socket option `plain_password`.
-//  Available from libzmq 4.0.0.       
+//  Available from libzmq 4.0.0.
 CZMQ_EXPORT void
     zsock_set_plain_password (void *self, const char *plain_password);
 
 //  Get socket option `curve_server`.
-//  Available from libzmq 4.0.0.     
+//  Available from libzmq 4.0.0.
 //  Caller owns return value and must destroy it when done.
 CZMQ_EXPORT int
     zsock_curve_server (void *self);
 
 //  Set socket option `curve_server`.
-//  Available from libzmq 4.0.0.     
+//  Available from libzmq 4.0.0.
 CZMQ_EXPORT void
     zsock_set_curve_server (void *self, int curve_server);
 
 //  Get socket option `curve_publickey`.
-//  Available from libzmq 4.0.0.        
+//  Available from libzmq 4.0.0.
 //  Caller owns return value and must destroy it when done.
 CZMQ_EXPORT char *
     zsock_curve_publickey (void *self);
 
 //  Set socket option `curve_publickey`.
-//  Available from libzmq 4.0.0.        
+//  Available from libzmq 4.0.0.
 CZMQ_EXPORT void
     zsock_set_curve_publickey (void *self, const char *curve_publickey);
 
 //  Set socket option `curve_publickey` from 32-octet binary
-//  Available from libzmq 4.0.0.                            
+//  Available from libzmq 4.0.0.
 CZMQ_EXPORT void
     zsock_set_curve_publickey_bin (void *self, const byte *curve_publickey);
 
 //  Get socket option `curve_secretkey`.
-//  Available from libzmq 4.0.0.        
+//  Available from libzmq 4.0.0.
 //  Caller owns return value and must destroy it when done.
 CZMQ_EXPORT char *
     zsock_curve_secretkey (void *self);
 
 //  Set socket option `curve_secretkey`.
-//  Available from libzmq 4.0.0.        
+//  Available from libzmq 4.0.0.
 CZMQ_EXPORT void
     zsock_set_curve_secretkey (void *self, const char *curve_secretkey);
 
 //  Set socket option `curve_secretkey` from 32-octet binary
-//  Available from libzmq 4.0.0.                            
+//  Available from libzmq 4.0.0.
 CZMQ_EXPORT void
     zsock_set_curve_secretkey_bin (void *self, const byte *curve_secretkey);
 
 //  Get socket option `curve_serverkey`.
-//  Available from libzmq 4.0.0.        
+//  Available from libzmq 4.0.0.
 //  Caller owns return value and must destroy it when done.
 CZMQ_EXPORT char *
     zsock_curve_serverkey (void *self);
 
 //  Set socket option `curve_serverkey`.
-//  Available from libzmq 4.0.0.        
+//  Available from libzmq 4.0.0.
 CZMQ_EXPORT void
     zsock_set_curve_serverkey (void *self, const char *curve_serverkey);
 
 //  Set socket option `curve_serverkey` from 32-octet binary
-//  Available from libzmq 4.0.0.                            
+//  Available from libzmq 4.0.0.
 CZMQ_EXPORT void
     zsock_set_curve_serverkey_bin (void *self, const byte *curve_serverkey);
 
 //  Get socket option `gssapi_server`.
-//  Available from libzmq 4.0.0.      
+//  Available from libzmq 4.0.0.
 //  Caller owns return value and must destroy it when done.
 CZMQ_EXPORT int
     zsock_gssapi_server (void *self);
 
 //  Set socket option `gssapi_server`.
-//  Available from libzmq 4.0.0.      
+//  Available from libzmq 4.0.0.
 CZMQ_EXPORT void
     zsock_set_gssapi_server (void *self, int gssapi_server);
 
 //  Get socket option `gssapi_plaintext`.
-//  Available from libzmq 4.0.0.         
+//  Available from libzmq 4.0.0.
 //  Caller owns return value and must destroy it when done.
 CZMQ_EXPORT int
     zsock_gssapi_plaintext (void *self);
 
 //  Set socket option `gssapi_plaintext`.
-//  Available from libzmq 4.0.0.         
+//  Available from libzmq 4.0.0.
 CZMQ_EXPORT void
     zsock_set_gssapi_plaintext (void *self, int gssapi_plaintext);
 
 //  Get socket option `gssapi_principal`.
-//  Available from libzmq 4.0.0.         
+//  Available from libzmq 4.0.0.
 //  Caller owns return value and must destroy it when done.
 CZMQ_EXPORT char *
     zsock_gssapi_principal (void *self);
 
 //  Set socket option `gssapi_principal`.
-//  Available from libzmq 4.0.0.         
+//  Available from libzmq 4.0.0.
 CZMQ_EXPORT void
     zsock_set_gssapi_principal (void *self, const char *gssapi_principal);
 
 //  Get socket option `gssapi_service_principal`.
-//  Available from libzmq 4.0.0.                 
+//  Available from libzmq 4.0.0.
 //  Caller owns return value and must destroy it when done.
 CZMQ_EXPORT char *
     zsock_gssapi_service_principal (void *self);
 
 //  Set socket option `gssapi_service_principal`.
-//  Available from libzmq 4.0.0.                 
+//  Available from libzmq 4.0.0.
 CZMQ_EXPORT void
     zsock_set_gssapi_service_principal (void *self, const char *gssapi_service_principal);
 
-//  Get socket option `ipv6`.   
+//  Get socket option `ipv6`.
 //  Available from libzmq 4.0.0.
 //  Caller owns return value and must destroy it when done.
 CZMQ_EXPORT int
     zsock_ipv6 (void *self);
 
-//  Set socket option `ipv6`.   
+//  Set socket option `ipv6`.
 //  Available from libzmq 4.0.0.
 CZMQ_EXPORT void
     zsock_set_ipv6 (void *self, int ipv6);
 
 //  Get socket option `immediate`.
-//  Available from libzmq 4.0.0.  
+//  Available from libzmq 4.0.0.
 //  Caller owns return value and must destroy it when done.
 CZMQ_EXPORT int
     zsock_immediate (void *self);
 
 //  Set socket option `immediate`.
-//  Available from libzmq 4.0.0.  
+//  Available from libzmq 4.0.0.
 CZMQ_EXPORT void
     zsock_set_immediate (void *self, int immediate);
 
-//  Get socket option `type`.   
-//  Available from libzmq 3.0.0.
-//  Caller owns return value and must destroy it when done.
-CZMQ_EXPORT int
-    zsock_type (void *self);
-
-//  Get socket option `sndhwm`. 
+//  Get socket option `sndhwm`.
 //  Available from libzmq 3.0.0.
 //  Caller owns return value and must destroy it when done.
 CZMQ_EXPORT int
     zsock_sndhwm (void *self);
 
-//  Set socket option `sndhwm`. 
+//  Set socket option `sndhwm`.
 //  Available from libzmq 3.0.0.
 CZMQ_EXPORT void
     zsock_set_sndhwm (void *self, int sndhwm);
 
-//  Get socket option `rcvhwm`. 
+//  Get socket option `rcvhwm`.
 //  Available from libzmq 3.0.0.
 //  Caller owns return value and must destroy it when done.
 CZMQ_EXPORT int
     zsock_rcvhwm (void *self);
 
-//  Set socket option `rcvhwm`. 
+//  Set socket option `rcvhwm`.
 //  Available from libzmq 3.0.0.
 CZMQ_EXPORT void
     zsock_set_rcvhwm (void *self, int rcvhwm);
 
-//  Get socket option `affinity`.
-//  Available from libzmq 3.0.0. 
+//  Get socket option `maxmsgsize`.
+//  Available from libzmq 3.0.0.
 //  Caller owns return value and must destroy it when done.
 CZMQ_EXPORT int
-    zsock_affinity (void *self);
+    zsock_maxmsgsize (void *self);
 
-//  Set socket option `affinity`.
-//  Available from libzmq 3.0.0. 
+//  Set socket option `maxmsgsize`.
+//  Available from libzmq 3.0.0.
 CZMQ_EXPORT void
-    zsock_set_affinity (void *self, int affinity);
+    zsock_set_maxmsgsize (void *self, int maxmsgsize);
 
-//  Set socket option `subscribe`.
-//  Available from libzmq 3.0.0.  
+//  Get socket option `multicast_hops`.
+//  Available from libzmq 3.0.0.
+//  Caller owns return value and must destroy it when done.
+CZMQ_EXPORT int
+    zsock_multicast_hops (void *self);
+
+//  Set socket option `multicast_hops`.
+//  Available from libzmq 3.0.0.
 CZMQ_EXPORT void
-    zsock_set_subscribe (void *self, const char *subscribe);
+    zsock_set_multicast_hops (void *self, int multicast_hops);
 
-//  Set socket option `unsubscribe`.
-//  Available from libzmq 3.0.0.    
+//  Set socket option `xpub_verbose`.
+//  Available from libzmq 3.0.0.
 CZMQ_EXPORT void
-    zsock_set_unsubscribe (void *self, const char *unsubscribe);
+    zsock_set_xpub_verbose (void *self, int xpub_verbose);
 
-//  Get socket option `identity`.
-//  Available from libzmq 3.0.0. 
+//  Get socket option `tcp_keepalive`.
+//  Available from libzmq 3.0.0.
 //  Caller owns return value and must destroy it when done.
-CZMQ_EXPORT char *
-    zsock_identity (void *self);
+CZMQ_EXPORT int
+    zsock_tcp_keepalive (void *self);
 
-//  Set socket option `identity`.
-//  Available from libzmq 3.0.0. 
+//  Set socket option `tcp_keepalive`.
+//  Available from libzmq 3.0.0.
 CZMQ_EXPORT void
-    zsock_set_identity (void *self, const char *identity);
+    zsock_set_tcp_keepalive (void *self, int tcp_keepalive);
 
-//  Get socket option `rate`.   
+//  Get socket option `tcp_keepalive_idle`.
 //  Available from libzmq 3.0.0.
 //  Caller owns return value and must destroy it when done.
 CZMQ_EXPORT int
-    zsock_rate (void *self);
+    zsock_tcp_keepalive_idle (void *self);
 
-//  Set socket option `rate`.   
+//  Set socket option `tcp_keepalive_idle`.
 //  Available from libzmq 3.0.0.
 CZMQ_EXPORT void
-    zsock_set_rate (void *self, int rate);
+    zsock_set_tcp_keepalive_idle (void *self, int tcp_keepalive_idle);
 
-//  Get socket option `recovery_ivl`.
-//  Available from libzmq 3.0.0.     
+//  Get socket option `tcp_keepalive_cnt`.
+//  Available from libzmq 3.0.0.
 //  Caller owns return value and must destroy it when done.
 CZMQ_EXPORT int
-    zsock_recovery_ivl (void *self);
+    zsock_tcp_keepalive_cnt (void *self);
 
-//  Set socket option `recovery_ivl`.
-//  Available from libzmq 3.0.0.     
+//  Set socket option `tcp_keepalive_cnt`.
+//  Available from libzmq 3.0.0.
 CZMQ_EXPORT void
-    zsock_set_recovery_ivl (void *self, int recovery_ivl);
+    zsock_set_tcp_keepalive_cnt (void *self, int tcp_keepalive_cnt);
 
-//  Get socket option `sndbuf`. 
+//  Get socket option `tcp_keepalive_intvl`.
 //  Available from libzmq 3.0.0.
 //  Caller owns return value and must destroy it when done.
 CZMQ_EXPORT int
-    zsock_sndbuf (void *self);
+    zsock_tcp_keepalive_intvl (void *self);
 
-//  Set socket option `sndbuf`. 
+//  Set socket option `tcp_keepalive_intvl`.
 //  Available from libzmq 3.0.0.
 CZMQ_EXPORT void
-    zsock_set_sndbuf (void *self, int sndbuf);
+    zsock_set_tcp_keepalive_intvl (void *self, int tcp_keepalive_intvl);
 
-//  Get socket option `rcvbuf`. 
+//  Get socket option `tcp_accept_filter`.
 //  Available from libzmq 3.0.0.
 //  Caller owns return value and must destroy it when done.
-CZMQ_EXPORT int
-    zsock_rcvbuf (void *self);
+CZMQ_EXPORT char *
+    zsock_tcp_accept_filter (void *self);
 
-//  Set socket option `rcvbuf`. 
+//  Set socket option `tcp_accept_filter`.
 //  Available from libzmq 3.0.0.
 CZMQ_EXPORT void
-    zsock_set_rcvbuf (void *self, int rcvbuf);
+    zsock_set_tcp_accept_filter (void *self, const char *tcp_accept_filter);
+
+//  Get socket option `last_endpoint`.
+//  Available from libzmq 3.0.0.
+//  Caller owns return value and must destroy it when done.
+CZMQ_EXPORT char *
+    zsock_last_endpoint (void *self);
 
-//  Get socket option `linger`. 
+//  Set socket option `router_raw`.
+//  Available from libzmq 3.0.0.
+CZMQ_EXPORT void
+    zsock_set_router_raw (void *self, int router_raw);
+
+//  Get socket option `ipv4only`.
 //  Available from libzmq 3.0.0.
 //  Caller owns return value and must destroy it when done.
 CZMQ_EXPORT int
-    zsock_linger (void *self);
+    zsock_ipv4only (void *self);
 
-//  Set socket option `linger`. 
+//  Set socket option `ipv4only`.
 //  Available from libzmq 3.0.0.
 CZMQ_EXPORT void
-    zsock_set_linger (void *self, int linger);
+    zsock_set_ipv4only (void *self, int ipv4only);
 
-//  Get socket option `reconnect_ivl`.
-//  Available from libzmq 3.0.0.      
+//  Set socket option `delay_attach_on_connect`.
+//  Available from libzmq 3.0.0.
+CZMQ_EXPORT void
+    zsock_set_delay_attach_on_connect (void *self, int delay_attach_on_connect);
+
+//  Get socket option `hwm`.
+//  Available from libzmq 2.0.0 to 3.0.0.
 //  Caller owns return value and must destroy it when done.
 CZMQ_EXPORT int
-    zsock_reconnect_ivl (void *self);
+    zsock_hwm (void *self);
 
-//  Set socket option `reconnect_ivl`.
-//  Available from libzmq 3.0.0.      
+//  Set socket option `hwm`.
+//  Available from libzmq 2.0.0 to 3.0.0.
 CZMQ_EXPORT void
-    zsock_set_reconnect_ivl (void *self, int reconnect_ivl);
+    zsock_set_hwm (void *self, int hwm);
 
-//  Get socket option `reconnect_ivl_max`.
-//  Available from libzmq 3.0.0.          
+//  Get socket option `swap`.
+//  Available from libzmq 2.0.0 to 3.0.0.
 //  Caller owns return value and must destroy it when done.
 CZMQ_EXPORT int
-    zsock_reconnect_ivl_max (void *self);
+    zsock_swap (void *self);
 
-//  Set socket option `reconnect_ivl_max`.
-//  Available from libzmq 3.0.0.          
+//  Set socket option `swap`.
+//  Available from libzmq 2.0.0 to 3.0.0.
 CZMQ_EXPORT void
-    zsock_set_reconnect_ivl_max (void *self, int reconnect_ivl_max);
+    zsock_set_swap (void *self, int swap);
 
-//  Get socket option `backlog`.
-//  Available from libzmq 3.0.0.
+//  Get socket option `affinity`.
+//  Available from libzmq 2.0.0.
 //  Caller owns return value and must destroy it when done.
 CZMQ_EXPORT int
-    zsock_backlog (void *self);
+    zsock_affinity (void *self);
 
-//  Set socket option `backlog`.
-//  Available from libzmq 3.0.0.
+//  Set socket option `affinity`.
+//  Available from libzmq 2.0.0.
 CZMQ_EXPORT void
-    zsock_set_backlog (void *self, int backlog);
+    zsock_set_affinity (void *self, int affinity);
 
-//  Get socket option `maxmsgsize`.
-//  Available from libzmq 3.0.0.   
+//  Get socket option `identity`.
+//  Available from libzmq 2.0.0.
+//  Caller owns return value and must destroy it when done.
+CZMQ_EXPORT char *
+    zsock_identity (void *self);
+
+//  Set socket option `identity`.
+//  Available from libzmq 2.0.0.
+CZMQ_EXPORT void
+    zsock_set_identity (void *self, const char *identity);
+
+//  Get socket option `rate`.
+//  Available from libzmq 2.0.0.
 //  Caller owns return value and must destroy it when done.
 CZMQ_EXPORT int
-    zsock_maxmsgsize (void *self);
+    zsock_rate (void *self);
 
-//  Set socket option `maxmsgsize`.
-//  Available from libzmq 3.0.0.   
+//  Set socket option `rate`.
+//  Available from libzmq 2.0.0.
 CZMQ_EXPORT void
-    zsock_set_maxmsgsize (void *self, int maxmsgsize);
+    zsock_set_rate (void *self, int rate);
 
-//  Get socket option `multicast_hops`.
-//  Available from libzmq 3.0.0.       
+//  Get socket option `recovery_ivl`.
+//  Available from libzmq 2.0.0.
 //  Caller owns return value and must destroy it when done.
 CZMQ_EXPORT int
-    zsock_multicast_hops (void *self);
+    zsock_recovery_ivl (void *self);
 
-//  Set socket option `multicast_hops`.
-//  Available from libzmq 3.0.0.       
+//  Set socket option `recovery_ivl`.
+//  Available from libzmq 2.0.0.
 CZMQ_EXPORT void
-    zsock_set_multicast_hops (void *self, int multicast_hops);
+    zsock_set_recovery_ivl (void *self, int recovery_ivl);
+
+//  Get socket option `recovery_ivl_msec`.
+//  Available from libzmq 2.0.0 to 3.0.0.
+//  Caller owns return value and must destroy it when done.
+CZMQ_EXPORT int
+    zsock_recovery_ivl_msec (void *self);
+
+//  Set socket option `recovery_ivl_msec`.
+//  Available from libzmq 2.0.0 to 3.0.0.
+CZMQ_EXPORT void
+    zsock_set_recovery_ivl_msec (void *self, int recovery_ivl_msec);
+
+//  Get socket option `mcast_loop`.
+//  Available from libzmq 2.0.0 to 3.0.0.
+//  Caller owns return value and must destroy it when done.
+CZMQ_EXPORT int
+    zsock_mcast_loop (void *self);
+
+//  Set socket option `mcast_loop`.
+//  Available from libzmq 2.0.0 to 3.0.0.
+CZMQ_EXPORT void
+    zsock_set_mcast_loop (void *self, int mcast_loop);
 
 //  Get socket option `rcvtimeo`.
-//  Available from libzmq 3.0.0. 
+//  Available from libzmq 2.2.0.
 //  Caller owns return value and must destroy it when done.
 CZMQ_EXPORT int
     zsock_rcvtimeo (void *self);
 
 //  Set socket option `rcvtimeo`.
-//  Available from libzmq 3.0.0. 
+//  Available from libzmq 2.2.0.
 CZMQ_EXPORT void
     zsock_set_rcvtimeo (void *self, int rcvtimeo);
 
 //  Get socket option `sndtimeo`.
-//  Available from libzmq 3.0.0. 
+//  Available from libzmq 2.2.0.
 //  Caller owns return value and must destroy it when done.
 CZMQ_EXPORT int
     zsock_sndtimeo (void *self);
 
 //  Set socket option `sndtimeo`.
-//  Available from libzmq 3.0.0. 
+//  Available from libzmq 2.2.0.
 CZMQ_EXPORT void
     zsock_set_sndtimeo (void *self, int sndtimeo);
 
-//  Set socket option `xpub_verbose`.
-//  Available from libzmq 3.0.0.     
+//  Get socket option `sndbuf`.
+//  Available from libzmq 2.0.0.
+//  Caller owns return value and must destroy it when done.
+CZMQ_EXPORT int
+    zsock_sndbuf (void *self);
+
+//  Set socket option `sndbuf`.
+//  Available from libzmq 2.0.0.
 CZMQ_EXPORT void
-    zsock_set_xpub_verbose (void *self, int xpub_verbose);
+    zsock_set_sndbuf (void *self, int sndbuf);
 
-//  Get socket option `tcp_keepalive`.
-//  Available from libzmq 3.0.0.      
+//  Get socket option `rcvbuf`.
+//  Available from libzmq 2.0.0.
 //  Caller owns return value and must destroy it when done.
 CZMQ_EXPORT int
-    zsock_tcp_keepalive (void *self);
+    zsock_rcvbuf (void *self);
 
-//  Set socket option `tcp_keepalive`.
-//  Available from libzmq 3.0.0.      
+//  Set socket option `rcvbuf`.
+//  Available from libzmq 2.0.0.
 CZMQ_EXPORT void
-    zsock_set_tcp_keepalive (void *self, int tcp_keepalive);
+    zsock_set_rcvbuf (void *self, int rcvbuf);
 
-//  Get socket option `tcp_keepalive_idle`.
-//  Available from libzmq 3.0.0.           
+//  Get socket option `linger`.
+//  Available from libzmq 2.0.0.
 //  Caller owns return value and must destroy it when done.
 CZMQ_EXPORT int
-    zsock_tcp_keepalive_idle (void *self);
+    zsock_linger (void *self);
 
-//  Set socket option `tcp_keepalive_idle`.
-//  Available from libzmq 3.0.0.           
+//  Set socket option `linger`.
+//  Available from libzmq 2.0.0.
 CZMQ_EXPORT void
-    zsock_set_tcp_keepalive_idle (void *self, int tcp_keepalive_idle);
+    zsock_set_linger (void *self, int linger);
 
-//  Get socket option `tcp_keepalive_cnt`.
-//  Available from libzmq 3.0.0.          
+//  Get socket option `reconnect_ivl`.
+//  Available from libzmq 2.0.0.
 //  Caller owns return value and must destroy it when done.
 CZMQ_EXPORT int
-    zsock_tcp_keepalive_cnt (void *self);
+    zsock_reconnect_ivl (void *self);
 
-//  Set socket option `tcp_keepalive_cnt`.
-//  Available from libzmq 3.0.0.          
+//  Set socket option `reconnect_ivl`.
+//  Available from libzmq 2.0.0.
 CZMQ_EXPORT void
-    zsock_set_tcp_keepalive_cnt (void *self, int tcp_keepalive_cnt);
+    zsock_set_reconnect_ivl (void *self, int reconnect_ivl);
 
-//  Get socket option `tcp_keepalive_intvl`.
-//  Available from libzmq 3.0.0.            
+//  Get socket option `reconnect_ivl_max`.
+//  Available from libzmq 2.0.0.
 //  Caller owns return value and must destroy it when done.
 CZMQ_EXPORT int
-    zsock_tcp_keepalive_intvl (void *self);
+    zsock_reconnect_ivl_max (void *self);
 
-//  Set socket option `tcp_keepalive_intvl`.
-//  Available from libzmq 3.0.0.            
+//  Set socket option `reconnect_ivl_max`.
+//  Available from libzmq 2.0.0.
 CZMQ_EXPORT void
-    zsock_set_tcp_keepalive_intvl (void *self, int tcp_keepalive_intvl);
+    zsock_set_reconnect_ivl_max (void *self, int reconnect_ivl_max);
 
-//  Get socket option `tcp_accept_filter`.
-//  Available from libzmq 3.0.0.          
+//  Get socket option `backlog`.
+//  Available from libzmq 2.0.0.
 //  Caller owns return value and must destroy it when done.
-CZMQ_EXPORT char *
-    zsock_tcp_accept_filter (void *self);
+CZMQ_EXPORT int
+    zsock_backlog (void *self);
 
-//  Set socket option `tcp_accept_filter`.
-//  Available from libzmq 3.0.0.          
+//  Set socket option `backlog`.
+//  Available from libzmq 2.0.0.
 CZMQ_EXPORT void
-    zsock_set_tcp_accept_filter (void *self, const char *tcp_accept_filter);
+    zsock_set_backlog (void *self, int backlog);
+
+//  Set socket option `subscribe`.
+//  Available from libzmq 2.0.0.
+CZMQ_EXPORT void
+    zsock_set_subscribe (void *self, const char *subscribe);
+
+//  Set socket option `unsubscribe`.
+//  Available from libzmq 2.0.0.
+CZMQ_EXPORT void
+    zsock_set_unsubscribe (void *self, const char *unsubscribe);
+
+//  Get socket option `type`.
+//  Available from libzmq 2.0.0.
+//  Caller owns return value and must destroy it when done.
+CZMQ_EXPORT int
+    zsock_type (void *self);
 
 //  Get socket option `rcvmore`.
-//  Available from libzmq 3.0.0.
+//  Available from libzmq 2.0.0.
 //  Caller owns return value and must destroy it when done.
 CZMQ_EXPORT int
     zsock_rcvmore (void *self);
 
-//  Get socket option `fd`.     
-//  Available from libzmq 3.0.0.
+//  Get socket option `fd`.
+//  Available from libzmq 2.0.0.
 //  Caller owns return value and must destroy it when done.
 CZMQ_EXPORT SOCKET
     zsock_fd (void *self);
 
-//  Get socket option `events`. 
-//  Available from libzmq 3.0.0.
+//  Get socket option `events`.
+//  Available from libzmq 2.0.0.
 //  Caller owns return value and must destroy it when done.
 CZMQ_EXPORT int
     zsock_events (void *self);
 
-//  Get socket option `last_endpoint`.
-//  Available from libzmq 3.0.0.      
-//  Caller owns return value and must destroy it when done.
-CZMQ_EXPORT char *
-    zsock_last_endpoint (void *self);
-
-//  Set socket option `router_raw`.
-//  Available from libzmq 3.0.0.   
-CZMQ_EXPORT void
-    zsock_set_router_raw (void *self, int router_raw);
-
-//  Get socket option `ipv4only`.
-//  Available from libzmq 3.0.0. 
-//  Caller owns return value and must destroy it when done.
-CZMQ_EXPORT int
-    zsock_ipv4only (void *self);
-
-//  Set socket option `ipv4only`.
-//  Available from libzmq 3.0.0. 
-CZMQ_EXPORT void
-    zsock_set_ipv4only (void *self, int ipv4only);
-
-//  Set socket option `delay_attach_on_connect`.
-//  Available from libzmq 3.0.0.                
-CZMQ_EXPORT void
-    zsock_set_delay_attach_on_connect (void *self, int delay_attach_on_connect);
-
 //  Self test of this class.
 CZMQ_EXPORT void
     zsock_test (bool verbose);
@@ -1043,25 +1093,25 @@ CZMQ_EXPORT zsock_t *
 
 //  *** Draft method, for development use, may change without warning ***
 //  Return socket routing ID if any. This returns 0 if the socket is not
-//  of type ZMQ_SERVER or if no request was already received on it.     
+//  of type ZMQ_SERVER or if no request was already received on it.
 CZMQ_EXPORT uint32_t
     zsock_routing_id (zsock_t *self);
 
 //  *** Draft method, for development use, may change without warning ***
-//  Set routing ID on socket. The socket MUST be of type ZMQ_SERVER.        
+//  Set routing ID on socket. The socket MUST be of type ZMQ_SERVER.
 //  This will be used when sending messages on the socket via the zsock API.
 CZMQ_EXPORT void
     zsock_set_routing_id (zsock_t *self, uint32_t routing_id);
 
 //  *** Draft method, for development use, may change without warning ***
 //  Join a group for the RADIO-DISH pattern. Call only on ZMQ_DISH.
-//  Returns 0 if OK, -1 if failed.                                 
+//  Returns 0 if OK, -1 if failed.
 CZMQ_EXPORT int
     zsock_join (void *self, const char *group);
 
 //  *** Draft method, for development use, may change without warning ***
 //  Leave a group for the RADIO-DISH pattern. Call only on ZMQ_DISH.
-//  Returns 0 if OK, -1 if failed.                                  
+//  Returns 0 if OK, -1 if failed.
 CZMQ_EXPORT int
     zsock_leave (void *self, const char *group);