diff options
| author |  Nicolas Noble <nicolasnoble@users.noreply.github.com> | 2016-12-19 14:36:24 -0800 |
|---|---|---|
| committer |  GitHub <noreply@github.com> | 2016-12-19 14:36:24 -0800 |
| commit | f29de2619476622e61c894559f8885ca3cc8971c (patch) | |
| tree | 6f64a2b4c2b431730dc92a7f093cf16920257949 /include | |
| parent | 4e00a995f2fb0810625f9d7947a70cbc5380f1bb (diff) | |
| parent | 8f7b0b48bf75b652653cb0391fff06c5160e46fa (diff) | |
Merge pull request #9145 from nathanielmanistaatgoogle/v1.0.x-upmerge
v1.0.x manual upmerge
Diffstat (limited to 'include')
| -rw-r--r-- | include/grpc/grpc.h | 12 |
1 files changed, 9 insertions, 3 deletions
diff --git a/include/grpc/grpc.h b/include/grpc/grpc.h index 5e486215e0..898f4d533b 100644 --- a/include/grpc/grpc.h +++ b/include/grpc/grpc.h @@ -202,9 +202,15 @@ GRPCAPI grpc_call *grpc_channel_create_registered_call( completion of type 'tag' to the completion queue bound to the call. 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 - batch. You must call grpc_completion_queue_next or - grpc_completion_queue_pluck on the completion queue associated with 'call' - for work to be performed. + batch. + If a call to grpc_call_start_batch returns GRPC_CALL_OK you must call + 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 needs to be synchronized. As an optimization, you may synchronize batches containing just send operations independently from batches containing just |