3 .. This work is licensed under a Creative Commons Attribution 4.0 International License.
4 .. SPDX-License-Identifier: CC-BY-4.0
5 .. CAUTION: this document is generated from source in doc/src/rtd.
6 .. To make changes edit the source and recompile the document.
7 .. Do NOT make changes directly to .rst or .md files.
10 ============================================================================================
11 Man Page: rmr_str2meid
12 ============================================================================================
15 ============================================================================================
19 --------------------------------------------------------------------------------------------
24 --------------------------------------------------------------------------------------------
30 int rmr_str2meid( rmr_mbuf_t* mbuf, unsigned char* src, int len )
35 --------------------------------------------------------------------------------------------
37 The rmr_str2meid function will copy the string pointed to by
38 src to the managed entity ID (meid) field in the given
39 message. The field is a fixed length, gated by the constant
40 RMR_MAX_MEID and if string length is larger than this value,
41 then **nothing** will be copied. (Note, this differs slightly
42 from the behaviour of the lrmr_bytes2meid() function.)
45 --------------------------------------------------------------------------------------------
47 On success, the value RMR_OK is returned. If the string
48 cannot be copied to the message, the return value will be one
49 of the errors listed below.
52 --------------------------------------------------------------------------------------------
54 If the return value is not RMR_OK, then it will be set to one
61 The message, or an internal portion of the message, was
62 corrupted or the pointer was invalid.
67 The length passed in was larger than the maximum length of
68 the field; only a portion of the source bytes were copied.
72 --------------------------------------------------------------------------------------------
76 --------------------------------------------------------------------------------------------
78 rmr_alloc_msg(3), rmr_call(3), rmr_free_msg(3),
79 rmr_get_meid(3), rmr_get_rcvfd(3), rmr_payload_size(3),
80 rmr_send_msg(3), rmr_rcv_msg(3), rmr_rcv_specific(3),
81 rmr_rts_msg(3), rmr_ready(3), rmr_fib(3), rmr_has_str(3),
82 rmr_tokenise(3), rmr_mk_ring(3), rmr_ring_free(3),
83 rmr_bytes2meid(3), rmr_wh_open(3), rmr_wh_send_msg(3)