Grid RPC API List

[Note]

A 'G' at the beginning of a line indicates an API that is defined in the Grid RPC specifications.

'New' at the beginning of a line indicates an API that has been added in Ver. 2.

'Changed' at the beginning of a line indicates an API for which the interface has been changed in Ver. 2.

'Deleted' at the beginning of a line indicates an API that is not provided in Ver. 2.

[Error codes]

When the API specifications were being studied, error codes for which new definitions were required arose. Those codes have the suffix '_NP' attached (e.g., GRPCERR_*_NP). They are described below.

GRPC_DESTRUCTED_NP
The specified function handle has already been discarded.
GRPCERR_NO_SESSION_NP
The specified session does not exist.

[API list (without arguments)]

[API for initializing and terminating Ninf-G]

   G       grpc_initialize()
   G       grpc_finalize()
   New     grpc_config_file_read_np()

[API for manipulating function handles]

   G       grpc_function_handle_init()
   New     grpc_function_handle_init_with_attr_np()
   G       grpc_function_handle_default()
   G       grpc_function_handle_destruct()
   New     grpc_function_handle_array_init_np()
   New     grpc_function_handle_array_init_with_attr_np()
   New     grpc_function_handle_array_default_np()
   New     grpc_function_handle_array_destruct_np()
   New     grpc_function_handle_get_attr_np()
   New     grpc_function_handle_get_from_session_np()
   G       grpc_get_handle()
   New     grpc_function_handle_perror_np()
   New     grpc_function_handle_get_error_np()
   New     grpc_function_handle_is_ready_np()

[API for manipulating object handles]

   New     grpc_object_handle_init_np()
   New     grpc_object_handle_init_with_attr_np()
   New     grpc_object_handle_default_np()
   New     grpc_object_handle_destruct_np()
   New     grpc_object_handle_array_init_np()
   New     grpc_object_handle_array_init_with_attr_np()
   New     grpc_object_handle_array_default_np()
   New     grpc_object_handle_array_destruct_np()
   New     grpc_object_handle_get_attr_np()
   New     grpc_object_handle_get_from_session_np()
   New     grpc_object_handle_perror_np()
   New     grpc_object_handle_get_error_np()
   New     grpc_object_handle_is_ready_np()

[API for setting handle attributes]

   New     grpc_handle_attr_initialize_np()
   New     grpc_handle_attr_destruct_np()
   New     grpc_handle_attr_get_np()
   New     grpc_handle_attr_set_np()
   New     grpc_handle_attr_release_np()

[Function calling API]

   G       grpc_call()
   G       grpc_call_async()
   G       grpc_call_arg_stack()
   G       grpc_call_arg_stack_async()
   New     grpc_call_with_attr_np()
   New     grpc_call_async_with_attr_np()
   New     grpc_call_arg_stack_with_attr_np()
   New     grpc_call_arg_stack_async_with_attr_np()

[Method calling API]

   New     grpc_invoke_np()
   New     grpc_invoke_async_np()
   New     grpc_invoke_arg_stack_np()
   New     grpc_invoke_arg_stack_async_np()
   New     grpc_invoke_with_attr_np()
   New     grpc_invoke_async_with_attr_np()
   New     grpc_invoke_arg_stack_with_attr_np()
   New     grpc_invoke_arg_stack_async_with_attr_np()

[API for setting session attributes]

   New     grpc_session_attr_initialize_np()
   New     grpc_session_attr_initialize_with_object_handle_np()
   New     grpc_session_attr_destruct_np()
   New     grpc_session_attr_get_np()
   New     grpc_session_attr_set_np()
   New     grpc_session_attr_release_np()

[Stack manipulation API]

   G       grpc_arg_stack_new()
   G       grpc_arg_stack_destruct()
   G       grpc_arg_stack_push_arg()
   G       grpc_arg_stack_pop_arg()

[Session WAIT API]

   G       grpc_wait()
   G       grpc_wait_all()
   G       grpc_wait_and()
   G       grpc_wait_any()
   G       grpc_wait_or()
   Deleted grpc_wait_and_set()
   Deleted grpc_wait_or_set()

[API for manipulating sessions]

   G       grpc_cancel()
   New     grpc_cancel_all()

[API for manipulating session information]

   G       grpc_probe()
   New     grpc_probe_or()
   New     grpc_session_info_get_np()
   New     grpc_session_info_release_np()
   New     grpc_session_info_set_threshold_np()
   New     grpc_session_info_remove_np()
   New     grpc_session_info_get_np()
   New     grpc_session_info_release_np()
   G       grpc_get_error()
   Changed grpc_get_info_np()
   Changed grpc_get_last_info_np()

grpc_get_info_np() and grpc_get_last_info_np() do not recommend. Use rpc_session_info_get_np() instead.

[Error processing API]

   G       grpc_error_string()
   G       grpc_perror_np()
   New     grpc_get_failed_sessionid()
   New     grpc_last_error_get_np()

[API list (with arguments)]

[API for initializing and terminating Ninf-G]

   G       grpc_error_t grpc_initialize(char *config_file_name)
   G       grpc_error_t grpc_finalize(void)
   New     grpc_error_t grpc_config_file_read_np(char *config_file_name)

[API for manipulating function handles]

   G       grpc_error_t grpc_function_handle_init(
               grpc_function_handle_t *handle,
               char *host_name,
               int port,
               char *func_name)
   New     grpc_error_t grpc_function_handle_init_with_attr_np(
               grpc_function_handle_t *handle,
               grpc_handle_attr_t_np *attr)
   G       grpc_error_t grpc_function_handle_default(
               grpc_function_handle_t *handle,
               char *func_name)
   G       grpc_error_t grpc_function_handle_destruct(
               grpc_function_handle_t *handle)
   New     grpc_error_t grpc_function_handle_array_init_np(
               grpc_function_handle_t *handles,
               size_t nhandles,
               char *host_name,
               int port,
               char *func_name)
   New     grpc_error_t grpc_function_handle_array_init_with_attr_np(
               grpc_function_handle_t *handles,
               size_t nhandles,
               grpc_handle_attr_t_np *attr)
   New     grpc_error_t grpc_function_handle_array_default_np(
               grpc_function_handle_t *handles,
               size_t nhandles,
               char *func_name)
   New     grpc_error_t grpc_function_handle_array_destruct_np(
               grpc_function_handle_t *handles,
               size_t nhandles)
   New     grpc_error_t grpc_function_handle_get_attr_np(
               grpc_function_handle_t *handle,
               grpc_handle_attr_t_np *attr)
   New     grpc_error_t grpc_function_handle_get_from_session_np(
               grpc_function_handle_t *handle,
               grpc_sessionid_t session_id)
   G       grpc_error_t grpc_get_handle(
               grpc_function_handle_t *handle,
               grpc_sessionid_t session_id)
   New     void grpc_function_handle_perror_np(
               grpc_function_handle_t *handle,
               char *str)
   New     grpc_error_t grpc_function_handle_get_error_np(
               grpc_function_handle_t *handle)
   New     grpc_error_t grpc_function_handle_is_ready_np(
               grpc_function_handle_t *handle)

[API for manipulating object handles]

   New     grpc_error_t grpc_object_handle_init_np(
               grpc_object_handle_t_np *handle,
               char *host_name,
               int port,
               char *func_name)
   New     grpc_error_t grpc_object_handle_init_with_attr_np(
               grpc_object_handle_t_np *handle,
               grpc_handle_attr_t_np *attr)
   New     grpc_error_t grpc_object_handle_default_np(
               grpc_object_handle_t_np *handle,
               char *func_name)
   New     grpc_error_t grpc_object_handle_destruct_np(
               grpc_object_handle_t_np *handle)
   New     grpc_error_t grpc_object_handle_array_init_np(
               grpc_object_handle_t_np *handles,
               size_t nhandles,
               char *host_name,
               int port,
               char *func_name)
   New     grpc_error_t grpc_object_handle_array_init_with_attr_np(
               grpc_object_handle_t_np *handles,
               size_t nhandles,
               grpc_handle_attr_t_np *attr)
   New     grpc_error_t grpc_object_handle_array_default_np(
               grpc_object_handle_t_np *handles,
               size_t nhandles,
               char *func_name)
   New     grpc_error_t grpc_object_handle_array_destruct_np(
               grpc_object_handle_t_np *handles,
               size_t nhandles)
   New     grpc_error_t grpc_object_handle_get_attr_np(
               grpc_object_handle_t_np *handle,
               grpc_handle_attr_t_np *attr)
   New     grpc_error_t grpc_object_handle_get_from_session_np(
               grpc_object_handle_t_np *handle,
               grpc_sessionid_t session_id)
   New     void grpc_object_handle_perror_np(
               grpc_object_handle_t_np *handle,
               char *str)
   New     grpc_error_t grpc_object_handle_get_error_np(
               grpc_object_handle_t_np *handle)
   New     grpc_error_t grpc_object_handle_is_ready_np(
               grpc_object_handle_t_np *handle)

[API for setting handle attributes]

   New     grpc_error_t grpc_handle_attr_initialize_np(
               grpc_handle_attr_t_np *attr)
   New     grpc_error_t grpc_handle_attr_destruct_np(
               grpc_handle_attr_t_np *attr)
   New     grpc_error_t grpc_handle_attr_get_np(
               grpc_handle_attr_t_np *attr,
               grpc_handle_attr_name_t_np name,
               void *value)
   New     grpc_error_t grpc_handle_attr_set_np(
               grpc_handle_attr_t_np *attr,
               grpc_handle_attr_name_t_np name,
               void *value)
   New     grpc_error_t grpc_handle_attr_release_np(
               void *value)

[Function calling API]

   G       grpc_error_t grpc_call(
               grpc_function_handle_t *handle,
               ...)
   G       grpc_error_t grpc_call_async(
               grpc_function_handle_t *handle,
               grpc_sessionid_t *session_id,
               ...)

   G       int grpc_call_arg_stack(
               grpc_function_handle_t *handle,
               grpc_arg_stack *stack)
   G       int grpc_call_arg_stack_async(
               grpc_function_handle_t *handle,
               grpc_arg_stack *stack)

   New     grpc_error_t grpc_call_with_attr_np(
               grpc_function_handle_t *handle,
               grpc_session_attr_t_np *session_attr,
               ...)
   New     grpc_error_t grpc_call_async_with_attr_np(
               grpc_function_handle_t *handle,
               grpc_sessionid_t *session_id,
               grpc_session_attr_t_np *session_attr,
               ...)

   New     int grpc_call_arg_stack_with_attr_np(
               grpc_function_handle_t *handle,
               grpc_session_attr_t_np *session_attr,
               grpc_arg_stack *stack)
   New     int grpc_call_arg_stack_async_with_attr_np(
               grpc_function_handle_t *handle,
               grpc_session_attr_t_np *session_attr,
               grpc_arg_stack *stack)

[Method calling API]

   New     grpc_error_t grpc_invoke_np(
               grpc_object_handle_t_np *handle,
               char *method_name,
               ...)
   New     grpc_error_t grpc_invoke_async_np(
               grpc_object_handle_t_np *handle,
               char *method_name,
               grpc_sessionid_t *session_id,
               ...)

   New     int grpc_invoke_arg_stack_np(
               grpc_object_handle_t_np *handle,
               char *method_name,
               grpc_arg_stack *stack)
   New     int grpc_invoke_arg_stack_async_np(
               grpc_object_handle_t_np *handle,
               char *method_name,
               grpc_arg_stack *stack)

   New     grpc_error_t grpc_invoke_with_attr_np(
               grpc_object_handle_t_np *handle,
               char *method_name,
               grpc_session_attr_t_np *session_attr,
               ...)
   New     grpc_error_t grpc_invoke_async_with_attr_np(
               grpc_object_handle_t_np *handle,
               char *method_name,
               grpc_sessionid_t *session_id,
               grpc_session_attr_t_np *session_attr,
               ...)

   New     int grpc_invoke_arg_stack_with_attr_np(
               grpc_object_handle_t_np *handle,
               char *method_name,
               grpc_session_attr_t_np *session_attr,
               grpc_arg_stack *stack)
   New     int grpc_invoke_arg_stack_async_with_attr_np(
               grpc_object_handle_t_np *handle,
               char *method_name,
               grpc_session_attr_t_np *session_attr,
               grpc_arg_stack *stack)

[API for setting session attributes]

   New     grpc_error_t grpc_session_attr_initialize_np(
               grpc_function_handle_t *handle,
               grpc_session_attr_t_np *attr)
   New     grpc_error_t grpc_session_attr_initialize_with_object_handle_np(
               grpc_object_handle_t_np *handle,
               grpc_session_attr_t_np *attr)
   New     grpc_error_t grpc_session_attr_destruct_np(
               grpc_session_attr_t_np *attr)
   New     grpc_error_t grpc_session_attr_get_np(
               grpc_session_attr_t_np *attr,
               grpc_session_attr_name_t_np name,
               void **value)
   New     grpc_error_t grpc_session_attr_set_np(
               grpc_session_attr_t_np *attr,
               grpc_session_attr_name_t_np name,
               void *value)
   New     grpc_error_t grpc_session_attr_release_np(
               void *value)

[Stack manipulation API]

   G       grpc_arg_stack_t *grpc_arg_stack_new(int args)
   G       int grpc_arg_stack_destruct(grpc_arg_stack_t *stack)
   G       int grpc_arg_stack_push_arg(grpc_arg_stack_t *stack, void *arg)
   G       void *grpc_arg_stack_pop_arg(grpc_arg_stack_t *stack)

[Session WAIT API]

   G       grpc_error_t grpc_wait(grpc_sessionid_t session_id)
   G       grpc_error_t grpc_wait_all()
   G       grpc_error_t grpc_wait_and(grpc_sessionid_t *idArray, size_t length)
   G       grpc_error_t grpc_wait_any(grpc_sessionid_t *idPtr)
   G       grpc_error_t grpc_wait_or(
               grpc_sessionid_t *idArray,
               size_t length,
               grpc_sessionid_t *idPtr)
   Deleted int grpc_wait_and_set(nsapi_id_set_t *set)
   Deleted int grpc_wait_or_set(nsapi_id_set_t *set, int *id)

[API for manipulating sessions]

   G       grpc_error_t grpc_cancel(grpc_sessionid_t session_id)
   New     grpc_error_t grpc_cancel_all(void)

[API for manipulating session information]

   G       grpc_error_t grpc_probe(grpc_sessionid_t session_id)
   New     grpc_error_t grpc_probe_or(
               grpc_sessionid_t *idArray,
               size_t length,
               grpc_sessionid_t *idPtr)
   New     grpc_error_t grpc_session_info_get_np(
               grpc_sessionid_t session_id,
               grpc_session_info_t_np **info,
               int *status)
   New     grpc_error_t grpc_session_info_release_np(
               grpc_session_info_t_np *info)
   New     grpc_error_t grpc_session_info_set_threshold_np(int threshold)
   New     grpc_error_t grpc_session_info_remove_np(
               grpc_sessionid_t session_id)
   G       grpc_error_t grpc_get_error(grpc_sessionid_t session_id)
   Changed int grpc_get_info_np(int session_id, grpc_exec_info_t *info)
      ->Former nsapi_exec_info_t *grpc_get_info(int session_id)
   Changed int grpc_get_last_info_np(grpc_exec_info_t *info)
      ->Former nsapi_exec_info_t *grpc_get_last_info()

[Error processing API]

   G       char *grpc_error_string(grpc_error_t error_code)
   G       void grpc_perror_np(char *str)
   New     grpc_error_t grpc_get_failed_sessionid(grpc_sessionid_t *idPtr)
   G       grpc_error_t grpc_last_error_get_np()

last update : $Date: 2005/08/04 02:32:49 $