X-Git-Url: https://gerrit.o-ran-sc.org/r/gitweb?a=blobdiff_plain;f=doc%2Fsrc%2Fman%2Frmr_rcv_msg.3.xfm;h=1287ff4f0a011dbdd16e4ed471c01d4e8ae3fcf3;hb=5157a97ada5447efcee4da6192798a3b6799884c;hp=c53dcf5fc0966e35f01ad9cfe79378d6074c7583;hpb=708ebac12488fe6fb204ff2861fc0045afb73b78;p=ric-plt%2Flib%2Frmr.git diff --git a/doc/src/man/rmr_rcv_msg.3.xfm b/doc/src/man/rmr_rcv_msg.3.xfm index c53dcf5..1287ff4 100644 --- a/doc/src/man/rmr_rcv_msg.3.xfm +++ b/doc/src/man/rmr_rcv_msg.3.xfm @@ -1,7 +1,7 @@ .if false ================================================================================== - Copyright (c) 2019 Nokia - Copyright (c) 2018-2019 AT&T Intellectual Property. + Copyright (c) 2019 Nokia + Copyright (c) 2018-2019 AT&T Intellectual Property. Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. @@ -17,20 +17,20 @@ ================================================================================== .fi .if false - Mnemonic rmr_rcv_msg_man.xfm - Abstract The manual page for the rmr_rcv_msg function. - Author E. Scott Daniels - Date 29 January 2019 + Mnemonic rmr_rcv_msg_man.xfm + Abstract The manual page for the rmr_rcv_msg function. + Author E. Scott Daniels + Date 29 January 2019 .fi .gv e LIB lib -.im &{lib}/man/setup.im +.im &{lib}/man/setup.im &line_len(6i) &h1(RMR Library Functions) &h2(NAME) - rmr_rcv_msg + rmr_rcv_msg &h2(SYNOPSIS ) &indent @@ -44,27 +44,27 @@ rmr_mbuf_t* rmr_rcv_msg( void* vctx, rmr_mbuf_t* old_msg ); &h2(DESCRIPTION) The &cw(rmr_rcv_msg) function blocks until a message is received, returning the message to the caller via a pointer to a &cw(rmr_mbuf_t) structure type. -If messages were queued while waiting for the response to a previous invocation -of &cw(rmr_call,) the oldest message is removed from the queue and returned +If messages were queued while waiting for the response to a previous invocation +of &cw(rmr_call,) the oldest message is removed from the queue and returned without delay. &space The &ital(vctx) pointer is the pointer returned by the &cw(rmr_init) function. -&ital(Old_msg) is a pointer to a previously used message buffer or NULL. +&ital(Old_msg) is a pointer to a previously used message buffer or NULL. The ability to reuse message buffers helps to avoid alloc/free cycles in the -user application. +user application. When no buffer is available to supply, the receive function will allocate one. &h2(RETURN VALUE) The function returns a pointer to the &cw(rmr_mbuf_t) structure which references -the message information (state, length, payload), or a NULL pointer in the case +the message information (state, length, payload), or a nil pointer in the case of an extreme error. &h2(ERRORS) -The &ital(state) field in the message buffer will indicate either &cw(RMR_OK) +The &ital(state) field in the message buffer will indicate &cw(RMR_OK) when the message receive process was successful and the message can be used by the caller. -Depending on the underlying transport mechanism, one of the following RMR +Depending on the underlying transport mechanism, one of the following RMR error stats may be returned: &half_space @@ -74,7 +74,7 @@ error stats may be returned: &half_space &di(RMR_ERR_TIMEOUT) For some transport mechanisms, or if reading the receive queue from multiple threads, it is possible for one thread to find no data -waiting when it queries the queue. When this state is reported, the +waiting when it queries the queue. When this state is reported, the message buffer does not contain message data and the user application should reinvoke the receive function. &end_dlist @@ -87,7 +87,7 @@ provide more information. The following is a list of possible values that might accompany the states listed above: &half_space -&cw(RMR_ERR_EMPTY) if an empty message was received. +&cw(RMR_ERR_EMPTY) if an empty message was received. If a nil pointer is returned, or any other state value was set in the message buffer, &cw(errno) will be set to one of the following: &space