Skip to content
Snippets Groups Projects
Commit c00d0f79 authored by Nathaniel Manista's avatar Nathaniel Manista
Browse files

Clarify grpc_call_start_batch error semantics

parent 82870cad
No related branches found
No related tags found
No related merge requests found
...@@ -197,9 +197,15 @@ GRPCAPI grpc_call *grpc_channel_create_registered_call( ...@@ -197,9 +197,15 @@ GRPCAPI grpc_call *grpc_channel_create_registered_call(
completion of type 'tag' to the completion queue bound to the call. completion of type 'tag' to the completion queue bound to the call.
The order of ops specified in the batch has no significance. The order of ops specified in the batch has no significance.
Only one operation of each type can be active at once in any given Only one operation of each type can be active at once in any given
batch. You must call grpc_completion_queue_next or batch.
grpc_completion_queue_pluck on the completion queue associated with 'call' If a call to grpc_call_start_batch returns GRPC_CALL_OK you must call
for work to be performed. grpc_completion_queue_next or grpc_completion_queue_pluck on the completion
queue associated with 'call' for work to be performed. If a call to
grpc_call_start_batch returns any value other than GRPC_CALL_OK it is
guaranteed that no state associated with 'call' is changed and it is not
appropriate to call grpc_completion_queue_next or
grpc_completion_queue_pluck consequent to the failed grpc_call_start_batch
call.
THREAD SAFETY: access to grpc_call_start_batch in multi-threaded environment THREAD SAFETY: access to grpc_call_start_batch in multi-threaded environment
needs to be synchronized. As an optimization, you may synchronize batches needs to be synchronized. As an optimization, you may synchronize batches
containing just send operations independently from batches containing just containing just send operations independently from batches containing just
......
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Please register or to comment