rpc_svc_calls(3nsl): svc_getrpccaller() description should be improved
manpage - manual pages
In the rpc_svc_calls(3nsl) man page there is this description of svc_getrpccaller():
struct netbuf *svc_getrpccaller(const SVCXPRT *xprt);
The svc_getrpccaller() function is the approved way of get- ting the network address of the caller of a procedure asso- ciated with the RPC service transport handle xprt. This function macro is Safe in multithreaded applications.
There are two minor issues with it:
- The svc_getrpccaller() is not a macro.
- It is not clear whether the svc_getrpccaller() returns an allocated copy of struct netbuf, or not. IOW, it is not clear whether the svc_getrpccaller() caller should deallocate the returned netbuf, or not. To avoid confusion, it should be stated in the man page that the returned netbuf shouldn't be deallocated by the svc_getrpccaller() caller.
Updated by Electric Monk over 6 years ago
- Status changed from Pending RTI to Closed
- % Done changed from 0 to 100
commit db26b99f059a8c142f2792443c9feacf20492ce7 Author: Marcel Telka <firstname.lastname@example.org> Date: 2014-11-24T21:41:53.000Z 4325 rpc_svc_calls(3nsl): svc_getrpccaller() description should be improved Reviewed by: Richard Lowe <email@example.com> Reviewed by: Gordon Ross <firstname.lastname@example.org> Reviewed by: Yuri Pankov <email@example.com> Approved by: Dan McDonald <firstname.lastname@example.org>