summaryrefslogtreecommitdiff
path: root/man/man3/zmq_msg_init.3
diff options
context:
space:
mode:
authorMartin Sustrik <sustrik@fastmq.commkdir>2009-11-23 09:22:25 +0100
committerMartin Sustrik <sustrik@fastmq.commkdir>2009-11-23 09:22:25 +0100
commit5cd98bc575517ea72c435770a5313711484f7d34 (patch)
tree5efe4d8904ecb84fa864c8d7cd1aba5bdc072b47 /man/man3/zmq_msg_init.3
parente90ada0d044636201c57786307a49a52f9cf7643 (diff)
the rest of man3 man pages filled in
Diffstat (limited to 'man/man3/zmq_msg_init.3')
-rw-r--r--man/man3/zmq_msg_init.321
1 files changed, 21 insertions, 0 deletions
diff --git a/man/man3/zmq_msg_init.3 b/man/man3/zmq_msg_init.3
index 8b18207..a531fc1 100644
--- a/man/man3/zmq_msg_init.3
+++ b/man/man3/zmq_msg_init.3
@@ -4,9 +4,30 @@ zmq_msg_init \- initialises empty 0MQ message
.SH SYNOPSIS
.B int zmq_msg_init (zmq_msg_t *msg);
.SH DESCRIPTION
+Initialises 0MQ message zero bytes long. The function is most useful
+to initialise a
+.IR zmq_msg_t
+structure before receiving a message.
.SH RETURN VALUE
+In case of success the function returns zero. Otherwise it returns -1 and
+sets
+.IR errno
+to the appropriate value.
.SH ERRORS
+No errors are defined.
.SH EXAMPLE
+.nf
+zmq_msg_t msg;
+rc = zmq_msg_init (&msg);
+assert (rc == 0);
+rc = zmq_recv (s, &msg, 0);
+assert (rc == 0);
+.fi
.SH SEE ALSO
+.BR zmq_msg_close (3)
+.BR zmq_msg_init_size (3)
+.BR zmq_msg_init_data (3)
+.BR zmq_msg_data (3)
+.BR zmq_msg_size (3)
.SH AUTHOR
Martin Sustrik <sustrik at 250bpm dot com>