Man Page: rmr_bytes2meid¶
RMR LIBRARY FUNCTIONS¶
NAME¶
rmr_bytes2meid
SYNOPSIS¶
#include <rmr/rmr.h>
int rmr_bytes2meid( rmr_mbuf_t* mbuf, unsigned char* src, int len )
DESCRIPTION¶
The rmr_bytes2meid
function will copy up to len bytes
from src to the managed entity ID (meid) field in the
message. The field is a fixed length, gated by the constant
RMR_MAX_MEID
and if len is larger than this value, only
RMR_MAX_MEID bytes will actually be copied.
RETURN VALUE¶
On success, the actual number of bytes copied is returned, or
-1 to indicate a hard error. If the length is less than 0, or
not the same as length passed in, errno
is set to one of
the errors described in the Errors section.
ERRORS¶
If the returned length does not match the length passed in,
errno
will be set to one of the following constants with
the meaning listed below.
EINVAL
The message, or an internal portion of the message, was corrupted or the pointer was invalid.
EOVERFLOW
The length passed in was larger than the maximum length of the field; only a portion of the source bytes were copied.
EXAMPLE¶
SEE ALSO¶
rmr_alloc_msg(3), rmr_bytes2xact(3), rmr_call(3), rmr_free_msg(3), rmr_get_rcvfd(3), rmr_get_meid(3), rmr_payload_size(3), rmr_send_msg(3), rmr_rcv_msg(3), rmr_rcv_specific(3), rmr_rts_msg(3), rmr_ready(3), rmr_fib(3), rmr_has_str(3), rmr_tokenise(3), rmr_mk_ring(3), rmr_ring_free(3), rmr_str2meid(3), rmr_str2xact(3), rmr_wh_open(3), rmr_wh_send_msg(3)