Date 19 April 2019
.fi
-.** if formatting with tfm, the roff.im will cause roff output to be generated
-.** if formatting with pfm, then pretty postscript will be generated
.gv e LIB lib
-.if pfm
- .im &{lib}/generic_ps.im
-.ei
- .gv e OUTPUT_RST use_rst
- .if .ev &use_rst 1 =
- .im &{lib}/rst.im
- .ei
- .im &{lib}/roff.im
- .fi
-.fi
+.im &{lib}/man/setup.im
&line_len(6i)
&space
&beg_dlist(.75i : ^&bold_font )
-&ditem(state ) Is the current buffer state. Following a call to &cw(rmr_send_msg)
+&diitem(state ) Is the current buffer state. Following a call to &cw(rmr_send_msg)
the state indicates whether the buffer was successfully sent which determines
exactly what the payload points to. If the send failed, the payload referenced
by the buffer is the message that failed to send (allowing the application to
may fill in in preparation to send.
&half_space
-&ditem(mtype ) When sending a message, the application is expected to set this field
+&diitem(mtype ) When sending a message, the application is expected to set this field
to the appropriate message type value (as determined by the user programme). Upon send
this value determines how the a library will route the message.
For a buffer which has been received, this field will contain the message type that was
set by the sending application.
&half_space
-&ditem(len ) The application using a buffer to send a message is expected to set the
+&diitem(len ) The application using a buffer to send a message is expected to set the
length value to the actual number of bytes that it placed into the message. This
is likely less than the total number of bytes that the message can carry.
For a message buffer that is passed to the application as the result of a receive
indicate the number of bytes in the payload which are valid.
&half_space
-&ditem(payload ) The payload is a pointer to the actual received data. The
+&diitem(payload ) The payload is a pointer to the actual received data. The
user programme may read and write from/to the memory referenced by the payload
up until the point in time that the buffer is used on a &cw(rmr_send, rmr_call)
or &cw(rmr_reply) function call.
&half_space
-&ditem(xaction) The &ital(xaction) field is a pointer to a fixed sized area in
+&diitem(xaction) The &ital(xaction) field is a pointer to a fixed sized area in
the message into which the user may write a transaction ID.
The ID is optional with the exception of when the user application uses the &cw(rmr_call)
function to send a message and wait for the reply; the underlying a processing
.** &h2(EXAMPLE)
&h2(SEE ALSO )
+.ju off
rmr_alloc_msg(3),
rmr_mbuf(3)
rmr_call(3),
rmr_mk_ring(3),
rmr_ring_free(3),
rmr_set_trace(3)
-
-
-.qu
+.ju on