Man Page: rmr_bytes2xact

RMR LIBRARY FUNCTIONS

NAME

rmr_bytes2xact

SYNOPSIS

#include <rmr/rmr.h>

int rmr_bytes2xact( rmr_mbuf_t* mbuf, unsigned char* src, int len )

DESCRIPTION

The rmr_bytes2xact function will copy up to len bytes from src to the transaction ID (xaction) field in the message. The field is a fixed length, gated by the constant RMR_MAX_XID and if len is larger than this value, only RMR_MAX_XID 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_bytes2meid(3), rmr_call(3), rmr_free_msg(3), rmr_get_meid(3), rmr_get_rcvfd(3), rmr_get_xact(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_wh_open(3), rmr_wh_send_msg(3)