blob: 81430aec8d57b388065c04991545b5069315c17b [file] [log] [blame]
E. Scott Danielsece5bbe2020-07-21 13:39:18 -04001.. This work is licensed under a Creative Commons Attribution 4.0 International License.
2.. SPDX-License-Identifier: CC-BY-4.0
3.. CAUTION: this document is generated from source in doc/src/rtd.
4.. To make changes edit the source and recompile the document.
5.. Do NOT make changes directly to .rst or .md files.
6
7============================================================================================
8Man Page: rmr_get_trlen
9============================================================================================
10
11
E. Scott Danielsa3a121c2020-05-06 09:07:08 -040012
13
14RMR LIBRARY FUNCTIONS
15=====================
16
17
18
19NAME
20----
21
E. Scott Danielsece5bbe2020-07-21 13:39:18 -040022rmr_get_trlen
E. Scott Danielsa3a121c2020-05-06 09:07:08 -040023
24
25SYNOPSIS
26--------
27
E. Scott Danielsece5bbe2020-07-21 13:39:18 -040028
29::
30
31 #include <rmr/rmr.h>
32
33 int rmr_get_trlen( rmr_mbuf_t* msg );
34
E. Scott Danielsa3a121c2020-05-06 09:07:08 -040035
36
37DESCRIPTION
38-----------
39
E. Scott Danielsece5bbe2020-07-21 13:39:18 -040040Given a message buffer, this function returns the amount of
41space (bytes) that have been allocated for trace data. If no
42trace data has been allocated, then 0 is returned.
E. Scott Danielsa3a121c2020-05-06 09:07:08 -040043
44
45RETURN VALUE
46------------
47
E. Scott Danielsece5bbe2020-07-21 13:39:18 -040048The number of bytes allocated for trace information in the
49given message.
E. Scott Danielsa3a121c2020-05-06 09:07:08 -040050
51
52ERRORS
53------
54
E. Scott Danielsece5bbe2020-07-21 13:39:18 -040055
56 .. list-table::
57 :widths: auto
58 :header-rows: 0
59 :class: borderless
60
61 * - **INVAL**
62 -
63 Parameter(s) passed to the function were not valid.
64
65
E. Scott Danielsa3a121c2020-05-06 09:07:08 -040066
67
68SEE ALSO
69--------
70
E. Scott Danielsece5bbe2020-07-21 13:39:18 -040071rmr_alloc_msg(3), rmr_call(3), rmr_free_msg(3),
72rmr_get_trace(3), rmr_init(3), rmr_init_trace(3),
73rmr_send_msg(3), rmr_rcv_msg(3), rmr_rcv_specific(3),
74rmr_rts_msg(3), rmr_ready(3), rmr_fib(3), rmr_has_str(3),
75rmr_tokenise(3), rmr_mk_ring(3), rmr_ring_free(3),
76rmr_set_trace(3), rmr_tralloc_msg(3)