X-Git-Url: https://gerrit.o-ran-sc.org/r/gitweb?a=blobdiff_plain;f=docs%2Frmr_get_xact.3.rst;fp=docs%2Frmr_get_xact.3.rst;h=887d65465c8f4e4ccfa668a74a739717e1ecb8fe;hb=a3a121ca4a0426ec964fa684fb27c397f2ee9e24;hp=0372a956f1963cff29b4914aca0af3d80774ea2c;hpb=2b3c393e660c5e1037191f43cc70537da8316b89;p=ric-plt%2Flib%2Frmr.git diff --git a/docs/rmr_get_xact.3.rst b/docs/rmr_get_xact.3.rst index 0372a95..887d654 100644 --- a/docs/rmr_get_xact.3.rst +++ b/docs/rmr_get_xact.3.rst @@ -1,79 +1,88 @@ - - .. This work is licensed under a Creative Commons Attribution 4.0 International License. .. SPDX-License-Identifier: CC-BY-4.0 .. CAUTION: this document is generated from source in doc/src/rtd. .. To make changes edit the source and recompile the document. .. Do NOT make changes directly to .rst or .md files. - ============================================================================================ Man Page: rmr_get_xact ============================================================================================ -RMR Library Functions -============================================================================================ - - -NAME --------------------------------------------------------------------------------------------- + + +RMR LIBRARY FUNCTIONS +===================== + + + +NAME +---- + rmr_get_xact - -SYNOPSIS --------------------------------------------------------------------------------------------- - + + +SYNOPSIS +-------- + :: - + #include + char* rmr_get_xact( rmr_mbuf_t* mbuf, unsigned char* dest ) - - -DESCRIPTION --------------------------------------------------------------------------------------------- - -The rmr_get_xact function will copy the transaction field + + +DESCRIPTION +----------- + +The ``rmr_get_xact`` function will copy the transaction field from the message into the *dest* buffer provided by the user. The buffer referenced by *dest* is assumed to be at least -RMR_MAX_XID bytes in length. If *dest* is NULL, then a buffer -is allocated (the calling application is expected to free -when the buffer is no longer needed). - -RETURN VALUE --------------------------------------------------------------------------------------------- - +``RMR_MAX_XID`` bytes in length. If *dest* is NULL, then a +buffer is allocated (the calling application is expected to +free when the buffer is no longer needed). + + +RETURN VALUE +------------ + On success, a pointer to the extracted string is returned. If *dest* was supplied, then this is just a pointer to the caller's buffer. If *dest* was NULL, this is a pointer to the allocated buffer. If an error occurs, a nil pointer is returned and errno is set as described below. - -ERRORS --------------------------------------------------------------------------------------------- - -If an error occurs, the value of the global variable errno -will be set to one of the following with the indicated -meaning. - - - -EINVAL - - The message, or an internal portion of the message, was - corrupted or the pointer was invalid. - - -ENOMEM - - A nil pointer was passed for *dest,* however it was not - possible to allocate a buffer using malloc(). - - -SEE ALSO --------------------------------------------------------------------------------------------- - + + +ERRORS +------ + +If an error occurs, the value of the global variable +``errno`` will be set to one of the following with the +indicated meaning. + + .. list-table:: + :widths: auto + :header-rows: 0 + :class: borderless + + * - **EINVAL** + - + The message, or an internal portion of the message, was + corrupted or the pointer was invalid. + + * - **ENOMEM** + - + A nil pointer was passed for *dest,* however it was not + possible to allocate a buffer using malloc(). + + + + +SEE ALSO +-------- + rmr_alloc_msg(3), rmr_bytes2xact(3), rmr_bytes2meid(3), rmr_call(3), rmr_free_msg(3), rmr_get_rcvfd(3), rmr_get_meid(3), rmr_payload_size(3), rmr_send_msg(3),