:orphan: .. index:: pair: group; API: RCF RPC .. _doxid-group__te__lib__rcfrpc: API: RCF RPC ============ .. toctree:: :hidden: struct_rcf_rpc_server.rst struct_rcf_rpc_server_hook.rst struct_vfork_thread_data.rst Overview ~~~~~~~~ .. ref-code-block:: cpp :class: doxyrest-overview-code-block // typedefs typedef struct :ref:`rcf_rpc_server` :ref:`rcf_rpc_server`; typedef struct :ref:`vfork_thread_data` :ref:`vfork_thread_data`; typedef struct :ref:`rcf_rpc_server_hook` :target:`rcf_rpc_server_hook`; // structs struct :ref:`rcf_rpc_server`; struct :ref:`rcf_rpc_server_hook`; struct :ref:`vfork_thread_data`; // global functions :ref:`te_errno` :ref:`rcf_rpc_server_get`(const char* ta, const char* name, const char* father, int flags, :ref:`rcf_rpc_server`** p_handle); static :ref:`te_errno` :ref:`rcf_rpc_server_create`(const char* ta, const char* name, :ref:`rcf_rpc_server`** p_handle); static :ref:`te_errno` :ref:`rcf_rpc_server_thread_create`(:ref:`rcf_rpc_server`* rpcs, const char* name, :ref:`rcf_rpc_server`** p_new); static :ref:`te_errno` :ref:`rcf_rpc_server_fork`(:ref:`rcf_rpc_server`* rpcs, const char* name, :ref:`rcf_rpc_server`** p_new); static :ref:`te_errno` :ref:`rcf_rpc_server_fork_exec`(:ref:`rcf_rpc_server`* rpcs, const char* name, :ref:`rcf_rpc_server`** p_new); :ref:`te_errno` :ref:`rcf_rpc_server_create_process`(:ref:`rcf_rpc_server`* rpcs, const char* name, int flags, :ref:`rcf_rpc_server`** p_new); :ref:`te_errno` :ref:`rcf_rpc_server_vfork`(:ref:`rcf_rpc_server`* rpcs, const char* name, uint32_t time_to_wait, pid_t* pid, uint32_t* elapsed_time); :ref:`te_errno` :ref:`rcf_rpc_server_vfork_in_thread`(:ref:`vfork_thread_data`* data, pthread_t* thread_id, :ref:`rcf_rpc_server`** p_new); :ref:`te_errno` :ref:`rcf_rpc_server_exec`(:ref:`rcf_rpc_server`* rpcs); :ref:`te_errno` :ref:`rcf_rpc_setlibname`(:ref:`rcf_rpc_server`* rpcs, const char* libname); static :ref:`te_errno` :ref:`rcf_rpc_server_restart`(:ref:`rcf_rpc_server`* rpcs); :ref:`te_errno` :ref:`rcf_rpc_servers_restart_all`(void); :ref:`te_errno` :ref:`rcf_rpc_server_destroy`(:ref:`rcf_rpc_server`* rpcs); static :ref:`te_errno` :ref:`rcf_rpc_server_dead`(:ref:`rcf_rpc_server`* rpcs); static :ref:`te_errno` :ref:`rcf_rpc_server_finished`(:ref:`rcf_rpc_server`* rpcs); void :ref:`rcf_rpc_call`(:ref:`rcf_rpc_server`* rpcs, const char* proc, void* in_arg, void* out_arg); :ref:`te_errno` :ref:`rcf_rpc_server_is_op_done`(:ref:`rcf_rpc_server`* rpcs, bool* done); bool :ref:`rcf_rpc_server_is_alive`(:ref:`rcf_rpc_server`* rpcs); static void :ref:`rcf_rpc_free_result`(void* out_arg, xdrproc_t out_proc); static const char* :ref:`rpcop2str`(:ref:`rcf_rpc_op` op); bool :ref:`rcf_rpc_server_has_children`(:ref:`rcf_rpc_server`* rpcs); void :ref:`rcf_rpc_namespace_free_cache`(:ref:`rcf_rpc_server`* rpcs); :ref:`te_errno` :ref:`rcf_rpc_namespace_id2str`(:ref:`rcf_rpc_server`* rpcs, :ref:`rpc_ptr_id_namespace` id, char** str); typedef :target:`SLIST_HEAD`(:ref:`rcf_rpc_server_hook`); :ref:`te_errno` :ref:`rcf_rpc_server_hook_register`(void(*)(:ref:`rcf_rpc_server`*rpcs) hook_to_register); // macros #define :ref:`RCF_RPC_DEFAULT_TIMEOUT` #define :ref:`RCF_RPC_UNSPEC_TIMEOUT` #define :ref:`RPC_AWAITING_ERROR`(_rpcs) #define :ref:`RPC_AWAIT_ERROR`(_rpcs) #define :ref:`RPC_AWAIT_IUT_ERROR`(_rpcs) #define :ref:`RPC_DONT_AWAIT_ERROR`(_rpcs) #define :ref:`RPC_DONT_AWAIT_IUT_ERROR`(_rpcs) #define :ref:`RPC_ERRNO`(_rpcs) #define :ref:`RPC_ERROR_ARGS`(_rpcs) #define :ref:`RPC_ERROR_FMT` #define :ref:`RPC_ERROR_MSG`(_rpcs) #define :ref:`RPC_IS_CALL_OK`(_rpcs) #define :ref:`RPC_NAME`(rpcs_) #define :ref:`TEST_GET_RPCS`(_ta, _name, _rpcs) #define :ref:`TEST_GET_RPCS_SAFE`(_ta, _name, _rpcs) .. _details-group__te__lib__rcfrpc: Detailed Documentation ~~~~~~~~~~~~~~~~~~~~~~ Typedefs -------- .. index:: pair: typedef; rcf_rpc_server .. _doxid-group__te__lib__rcfrpc_1ga5d60e7b896cebd2fd664c051fe61976f: .. ref-code-block:: cpp :class: doxyrest-title-code-block typedef struct :ref:`rcf_rpc_server` rcf_rpc_server RPC server context .. index:: pair: typedef; vfork_thread_data .. _doxid-group__te__lib__rcfrpc_1ga2b243e8d0caa8c396d65b51dde898602: .. ref-code-block:: cpp :class: doxyrest-title-code-block typedef struct :ref:`vfork_thread_data` vfork_thread_data Input/output parameters for :ref:`rcf_rpc_server_vfork() ` called in a thread. Global Functions ---------------- .. index:: pair: function; rcf_rpc_server_get .. _doxid-group__te__lib__rcfrpc_1ga104709105907cc5d527268ea0f381eed: .. ref-code-block:: cpp :class: doxyrest-title-code-block :ref:`te_errno` rcf_rpc_server_get(const char* ta, const char* name, const char* father, int flags, :ref:`rcf_rpc_server`** p_handle) Obtain server handle. RPC server is created/restarted, if necessary. .. rubric:: Parameters: .. list-table:: :widths: 20 80 * - ta - Test Agent name * - name - name of the new server (should not start from fork\_, forkexec\_ or thread\_) or existing server * - father - father name or NULL (should be NULL if RCF_RPC_SERVER_GET_REUSE or RCF_RPC_SERVER_GET_EXISTING flag is set). * - flags - RCF_RPC_SERVER_GET\_\* flags * - p_handle - location for new RPC server handle or NULL .. rubric:: Returns: Status code .. index:: pair: function; rcf_rpc_server_create .. _doxid-group__te__lib__rcfrpc_1gadd6023c0ba484fcd9cc070c849a76cbe: .. ref-code-block:: cpp :class: doxyrest-title-code-block static :ref:`te_errno` rcf_rpc_server_create(const char* ta, const char* name, :ref:`rcf_rpc_server`** p_handle) Create RPC server. .. rubric:: Parameters: .. list-table:: :widths: 20 80 * - ta - Test Agent name * - name - name of the new server * - p_handle - location for new RPC server handle .. rubric:: Returns: Status code .. index:: pair: function; rcf_rpc_server_thread_create .. _doxid-group__te__lib__rcfrpc_1gac587e23c562e4d4a0fdae00e35e0a8be: .. ref-code-block:: cpp :class: doxyrest-title-code-block static :ref:`te_errno` rcf_rpc_server_thread_create(:ref:`rcf_rpc_server`* rpcs, const char* name, :ref:`rcf_rpc_server`** p_new) Create thread in the process with RPC server. .. rubric:: Parameters: .. list-table:: :widths: 20 80 * - rpcs - existing RPC server handle * - name - name of the new server * - p_new - location for new RPC server handle .. rubric:: Returns: Status code .. index:: pair: function; rcf_rpc_server_fork .. _doxid-group__te__lib__rcfrpc_1gadc722d5beae0739de16066207f5d8516: .. ref-code-block:: cpp :class: doxyrest-title-code-block static :ref:`te_errno` rcf_rpc_server_fork(:ref:`rcf_rpc_server`* rpcs, const char* name, :ref:`rcf_rpc_server`** p_new) Fork RPC server. .. rubric:: Parameters: .. list-table:: :widths: 20 80 * - rpcs - existing RPC server handle * - name - name of the new server * - p_new - location for new RPC server handle .. rubric:: Returns: Status code .. index:: pair: function; rcf_rpc_server_fork_exec .. _doxid-group__te__lib__rcfrpc_1ga485c827d96d8eb7cfbb7aed42aa19921: .. ref-code-block:: cpp :class: doxyrest-title-code-block static :ref:`te_errno` rcf_rpc_server_fork_exec(:ref:`rcf_rpc_server`* rpcs, const char* name, :ref:`rcf_rpc_server`** p_new) Fork-and-exec RPC server. .. rubric:: Parameters: .. list-table:: :widths: 20 80 * - rpcs - existing RPC server handle * - name - name of the new server * - p_new - location for new RPC server handle .. rubric:: Returns: Status code .. index:: pair: function; rcf_rpc_server_create_process .. _doxid-group__te__lib__rcfrpc_1gab9cc27bc3b60411f42baab23f0317d48: .. ref-code-block:: cpp :class: doxyrest-title-code-block :ref:`te_errno` rcf_rpc_server_create_process(:ref:`rcf_rpc_server`* rpcs, const char* name, int flags, :ref:`rcf_rpc_server`** p_new) Fork RPC server with non-default conditions. .. rubric:: Parameters: .. list-table:: :widths: 20 80 * - rpcs - existing RPC server handle * - name - name of the new server * - flags - RCF_RPC_SERVER_GET\_\* flags to use on process creation * - p_new - location for new RPC server handle .. rubric:: Returns: Status code .. index:: pair: function; rcf_rpc_server_vfork .. _doxid-group__te__lib__rcfrpc_1ga7f88efe9c4c460674ccaa2a6d29693e8: .. ref-code-block:: cpp :class: doxyrest-title-code-block :ref:`te_errno` rcf_rpc_server_vfork(:ref:`rcf_rpc_server`* rpcs, const char* name, uint32_t time_to_wait, pid_t* pid, uint32_t* elapsed_time) Call vfork() in RPC server. .. rubric:: Parameters: .. list-table:: :widths: 20 80 * - rpcs - Existing RPC server handle * - name - Name of the new server * - time_to_wait - How much time to wait after vfork() call * - pid - If not NULL, will be set to result of vfork() call * - elapsed_time - Time elapsed until vfork() returned .. rubric:: Returns: Status code .. index:: pair: function; rcf_rpc_server_vfork_in_thread .. _doxid-group__te__lib__rcfrpc_1gafcf57ca8843cbd15336c770a2aed4042: .. ref-code-block:: cpp :class: doxyrest-title-code-block :ref:`te_errno` rcf_rpc_server_vfork_in_thread(:ref:`vfork_thread_data`* data, pthread_t* thread_id, :ref:`rcf_rpc_server`** p_new) Call :ref:`rcf_rpc_server_vfork() ` in a new thread. .. rubric:: Parameters: .. list-table:: :widths: 20 80 * - data - Data to be passed to the thread * - thread_id - Where to save an ID of the created thread * - p_new - Where to save an ID of the created RPC server .. rubric:: Returns: Status code .. index:: pair: function; rcf_rpc_server_exec .. _doxid-group__te__lib__rcfrpc_1gaea4b75cea1ec9cd14c6803a1f81585d8: .. ref-code-block:: cpp :class: doxyrest-title-code-block :ref:`te_errno` rcf_rpc_server_exec(:ref:`rcf_rpc_server`* rpcs) Perform execve() on the RPC server. Filename of the running process if used as the first argument. .. rubric:: Parameters: .. list-table:: :widths: 20 80 * - rpcs - RPC server handle .. rubric:: Returns: Status code .. index:: pair: function; rcf_rpc_setlibname .. _doxid-group__te__lib__rcfrpc_1ga93f11072f7e2bc2f87edce186c7d33ea: .. ref-code-block:: cpp :class: doxyrest-title-code-block :ref:`te_errno` rcf_rpc_setlibname(:ref:`rcf_rpc_server`* rpcs, const char* libname) Set dynamic library name to be used for additional name resolution. .. rubric:: Parameters: .. list-table:: :widths: 20 80 * - rpcs - existing RPC server handle * - libname - name of the dynamic library or NULL .. rubric:: Returns: Status code .. index:: pair: function; rcf_rpc_server_restart .. _doxid-group__te__lib__rcfrpc_1ga1bb6ac73c8c7ecfb2d90301bde3b3965: .. ref-code-block:: cpp :class: doxyrest-title-code-block static :ref:`te_errno` rcf_rpc_server_restart(:ref:`rcf_rpc_server`* rpcs) Restart RPC server. .. rubric:: Parameters: .. list-table:: :widths: 20 80 * - rpcs - RPC server handle .. rubric:: Returns: Status code .. index:: pair: function; rcf_rpc_servers_restart_all .. _doxid-group__te__lib__rcfrpc_1gaab1f2acbf243558b553606aae6b8668a: .. ref-code-block:: cpp :class: doxyrest-title-code-block :ref:`te_errno` rcf_rpc_servers_restart_all(void) Restart all RPC servers. This function has a lot of limitations. It does not work when fork child and thread RPC servers exist. It does not preserve name of the dynamic library to be used for functions name to pointer resolution. .. rubric:: Returns: Status code. .. index:: pair: function; rcf_rpc_server_destroy .. _doxid-group__te__lib__rcfrpc_1ga0148b1d62fe5a40561bad917b300f9a4: .. ref-code-block:: cpp :class: doxyrest-title-code-block :ref:`te_errno` rcf_rpc_server_destroy(:ref:`rcf_rpc_server`* rpcs) Destroy RPC server. The caller should assume the RPC server non-existent even if the function returned non-zero. .. rubric:: Parameters: .. list-table:: :widths: 20 80 * - rpcs - RPC server handle .. rubric:: Returns: status code .. index:: pair: function; rcf_rpc_server_dead .. _doxid-group__te__lib__rcfrpc_1gac2f2ab8f443e5aa59f16bda35f343788: .. ref-code-block:: cpp :class: doxyrest-title-code-block static :ref:`te_errno` rcf_rpc_server_dead(:ref:`rcf_rpc_server`* rpcs) Mark RPC server as dead to force its killing by :ref:`rcf_rpc_server_destroy() `. .. rubric:: Parameters: .. list-table:: :widths: 20 80 * - rpcs - RPC server handle .. rubric:: Returns: Status code .. index:: pair: function; rcf_rpc_server_finished .. _doxid-group__te__lib__rcfrpc_1ga54f3b521caab25f2c82e37eb09e82088: .. ref-code-block:: cpp :class: doxyrest-title-code-block static :ref:`te_errno` rcf_rpc_server_finished(:ref:`rcf_rpc_server`* rpcs) Mark RPC server as finished (i.e. it was terminated and waitpid() or pthread_join() was already called - so only associated data structures remained to be freed on TA). .. rubric:: Parameters: .. list-table:: :widths: 20 80 * - rpcs - RPC server handle .. rubric:: Returns: Status code .. index:: pair: function; rcf_rpc_call .. _doxid-group__te__lib__rcfrpc_1ga3175cd6f2a0dce9edbc315c7ec1709af: .. ref-code-block:: cpp :class: doxyrest-title-code-block void rcf_rpc_call(:ref:`rcf_rpc_server`* rpcs, const char* proc, void* in_arg, void* out_arg) Call SUN RPC on the TA via RCF. The function is also used for checking of status of non-blocking RPC call and waiting for the finish of the non-blocking RPC call. The Status code is returned in rpcs _errno. If rpcs is NULL the function does nothing. .. rubric:: Parameters: .. list-table:: :widths: 20 80 * - rpcs - RPC server * - proc - RPC to be called * - in_arg - input argument * - out_arg - output argument .. index:: pair: function; rcf_rpc_server_is_op_done .. _doxid-group__te__lib__rcfrpc_1gaa0e218518312730e41db2d603afc1dfa: .. ref-code-block:: cpp :class: doxyrest-title-code-block :ref:`te_errno` rcf_rpc_server_is_op_done(:ref:`rcf_rpc_server`* rpcs, bool* done) Check whether a function called using non-blocking RPC has been done. .. rubric:: Parameters: .. list-table:: :widths: 20 80 * - rpcs - existing RPC server handle * - done - location for the result .. rubric:: Returns: Status code .. index:: pair: function; rcf_rpc_server_is_alive .. _doxid-group__te__lib__rcfrpc_1gaf76504be36c862a983d8e5bd720dd5db: .. ref-code-block:: cpp :class: doxyrest-title-code-block bool rcf_rpc_server_is_alive(:ref:`rcf_rpc_server`* rpcs) Check whether RPC server is alive. .. rubric:: Parameters: .. list-table:: :widths: 20 80 * - rpcs - existing RPC server handle .. rubric:: Returns: ``true`` or ``false`` .. index:: pair: function; rcf_rpc_free_result .. _doxid-group__te__lib__rcfrpc_1ga3b403f60284676ce4d26e490bd9d499f: .. ref-code-block:: cpp :class: doxyrest-title-code-block static void rcf_rpc_free_result(void* out_arg, xdrproc_t out_proc) Free memory allocated by rcf_rpc_call .. index:: pair: function; rpcop2str .. _doxid-group__te__lib__rcfrpc_1gaabf3307a005ae8d1b8dc024f8c40fccf: .. ref-code-block:: cpp :class: doxyrest-title-code-block static const char* rpcop2str(:ref:`rcf_rpc_op` op) Convert RCF RPC operation to string. .. rubric:: Parameters: .. list-table:: :widths: 20 80 * - op - RCF RPC operation .. rubric:: Returns: null-terminated string .. index:: pair: function; rcf_rpc_server_has_children .. _doxid-group__te__lib__rcfrpc_1ga7e7686d56d658ba76fe7c08023017c60: .. ref-code-block:: cpp :class: doxyrest-title-code-block bool rcf_rpc_server_has_children(:ref:`rcf_rpc_server`* rpcs) Check is the RPC server has thread children. .. rubric:: Parameters: .. list-table:: :widths: 20 80 * - rpcs - RPC server .. rubric:: Returns: ``true`` if RPC server has children .. index:: pair: function; rcf_rpc_namespace_free_cache .. _doxid-group__te__lib__rcfrpc_1gad3d3ac8d3e41e864699984dcf44f5236: .. ref-code-block:: cpp :class: doxyrest-title-code-block void rcf_rpc_namespace_free_cache(:ref:`rcf_rpc_server`* rpcs) Free namespace cache .. rubric:: Parameters: .. list-table:: :widths: 20 80 * - rpcs - RPC server .. index:: pair: function; rcf_rpc_namespace_id2str .. _doxid-group__te__lib__rcfrpc_1gadebf7622dfc097ae987f75d833bb2e6d: .. ref-code-block:: cpp :class: doxyrest-title-code-block :ref:`te_errno` rcf_rpc_namespace_id2str(:ref:`rcf_rpc_server`* rpcs, :ref:`rpc_ptr_id_namespace` id, char** str) Convert namespace id to its name. .. rubric:: Parameters: .. list-table:: :widths: 20 80 * - rpcs - RPC server * - id - namespace id * - str - namespace as string .. rubric:: Returns: Status code .. index:: pair: function; rcf_rpc_server_hook_register .. _doxid-group__te__lib__rcfrpc_1gac9b369828b53fe979dcbaf706f71f271: .. ref-code-block:: cpp :class: doxyrest-title-code-block :ref:`te_errno` rcf_rpc_server_hook_register(void(*)(:ref:`rcf_rpc_server`*rpcs) hook_to_register) Add new hook to rcf_rpc_server_hook_list, that will be executed after :ref:`rcf_rpc_server ` is created. .. rubric:: Parameters: .. list-table:: :widths: 20 80 * - hook_to_register - Function to execute .. rubric:: Returns: Status code Macros ------ .. index:: pair: define; RCF_RPC_DEFAULT_TIMEOUT .. _doxid-group__te__lib__rcfrpc_1gae78ab4c065c347f4778ffa88aaa5f67c: .. ref-code-block:: cpp :class: doxyrest-title-code-block #define RCF_RPC_DEFAULT_TIMEOUT Default RPC timeout in milliseconds .. index:: pair: define; RCF_RPC_UNSPEC_TIMEOUT .. _doxid-group__te__lib__rcfrpc_1gafaaaa5d1f91156be35d329ed4e1bf3ca: .. ref-code-block:: cpp :class: doxyrest-title-code-block #define RCF_RPC_UNSPEC_TIMEOUT Unspecified RPC timeout in milliseconds .. index:: pair: define; RPC_AWAITING_ERROR .. _doxid-group__te__lib__rcfrpc_1gaf10111954d5dbc2f06fcb1e924cc0483: .. ref-code-block:: cpp :class: doxyrest-title-code-block #define RPC_AWAITING_ERROR(_rpcs) Are we awaiting an error? .. index:: pair: define; RPC_AWAIT_ERROR .. _doxid-group__te__lib__rcfrpc_1ga33847084e55ec8c13e635b26812b9821: .. ref-code-block:: cpp :class: doxyrest-title-code-block #define RPC_AWAIT_ERROR(_rpcs) Do not jump from the TAPI RPC library call in the case of any error .. index:: pair: define; RPC_AWAIT_IUT_ERROR .. _doxid-group__te__lib__rcfrpc_1ga8fdf87f7fd729794cad82629cd2a4473: .. ref-code-block:: cpp :class: doxyrest-title-code-block #define RPC_AWAIT_IUT_ERROR(_rpcs) Do not jump from the TAPI RPC library call in the case of IUT error .. index:: pair: define; RPC_DONT_AWAIT_ERROR .. _doxid-group__te__lib__rcfrpc_1gab97fdd0621c32339ceebec33792716f7: .. ref-code-block:: cpp :class: doxyrest-title-code-block #define RPC_DONT_AWAIT_ERROR(_rpcs) Roll back RPC_AWAIT_ERROR effect .. index:: pair: define; RPC_DONT_AWAIT_IUT_ERROR .. _doxid-group__te__lib__rcfrpc_1gae356b95ed055b3e0a7db5ef12d4ca067: .. ref-code-block:: cpp :class: doxyrest-title-code-block #define RPC_DONT_AWAIT_IUT_ERROR(_rpcs) Roll back RPC_AWAIT_IUT_ERROR effect .. index:: pair: define; RPC_ERRNO .. _doxid-group__te__lib__rcfrpc_1ga98b23de539d6cac225a3d5c45ce8faa7: .. ref-code-block:: cpp :class: doxyrest-title-code-block #define RPC_ERRNO(_rpcs) Return RPC server context errno .. index:: pair: define; RPC_ERROR_ARGS .. _doxid-group__te__lib__rcfrpc_1ga42702e4fcb64146fe02160ed36e7e99e: .. ref-code-block:: cpp :class: doxyrest-title-code-block #define RPC_ERROR_ARGS(_rpcs) Arguments for RPC_ERROR_FMT. .. rubric:: Parameters: .. list-table:: :widths: 20 80 * - _rpcs - Pointer to :ref:`rcf_rpc_server ` structure. .. index:: pair: define; RPC_ERROR_FMT .. _doxid-group__te__lib__rcfrpc_1ga21acb1b9659cc5ed1cc33f997f04efd3: .. ref-code-block:: cpp :class: doxyrest-title-code-block #define RPC_ERROR_FMT Format string for logging RPC server error (both number and message) .. index:: pair: define; RPC_ERROR_MSG .. _doxid-group__te__lib__rcfrpc_1gad24d189804e1369b4d639c6af15f8fee: .. ref-code-block:: cpp :class: doxyrest-title-code-block #define RPC_ERROR_MSG(_rpcs) Get RPC error message. .. rubric:: Parameters: .. list-table:: :widths: 20 80 * - _rpcs - Pointer to :ref:`rcf_rpc_server ` structure. .. index:: pair: define; RPC_IS_CALL_OK .. _doxid-group__te__lib__rcfrpc_1ga00ab86f6cd87e1411422c62155e6eab4: .. ref-code-block:: cpp :class: doxyrest-title-code-block #define RPC_IS_CALL_OK(_rpcs) Check, if RPC is called successfully .. index:: pair: define; RPC_NAME .. _doxid-group__te__lib__rcfrpc_1gae144d58068df71f125324ffbedde1a29: .. ref-code-block:: cpp :class: doxyrest-title-code-block #define RPC_NAME(rpcs_) Extract name of the PCO by RCP server handle .. rubric:: Parameters: .. list-table:: :widths: 20 80 * - rpcs\_ - - RPC server handle .. rubric:: Returns: Name of the PCO .. index:: pair: define; TEST_GET_RPCS .. _doxid-group__te__lib__rcfrpc_1ga5573bcb6f758d72543fb3e5694c27533: .. ref-code-block:: cpp :class: doxyrest-title-code-block #define TEST_GET_RPCS(_ta, _name, _rpcs) Get RPC server handle, restart it if necessary. .. rubric:: Parameters: .. list-table:: :widths: 20 80 * - _ta - name of Test Agent * - _name - name of RCF RPC server * - _rpcs - variable for RPC server handle .. index:: pair: define; TEST_GET_RPCS_SAFE .. _doxid-group__te__lib__rcfrpc_1gabe00de8592a0efcda9d1744a5f44ce7b: .. ref-code-block:: cpp :class: doxyrest-title-code-block #define TEST_GET_RPCS_SAFE(_ta, _name, _rpcs) Get RPC server handle, restart it if necessary. Don't fail. .. rubric:: Parameters: .. list-table:: :widths: 20 80 * - _ta - name of Test Agent * - _name - name of RCF RPC server * - _rpcs - variable for RPC server handle