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)