1
0
mirror of https://github.com/samba-team/samba.git synced 2024-12-23 17:34:34 +03:00

s3:messaging: explain why the messaging_send*() functions need a tevent-loop.

Signed-off-by: Michael Adam <obnox@samba.org>
Reviewed-by: Stefan Metzmacher <metze@samba.org>
Reviewed-by: Volker Lendecke <vl@samba.org>
This commit is contained in:
Michael Adam 2014-09-30 10:01:51 +02:00
parent d7d9ec31df
commit 797ada104e

View File

@ -105,6 +105,16 @@ NTSTATUS messaging_register(struct messaging_context *msg_ctx,
DATA_BLOB *data));
void messaging_deregister(struct messaging_context *ctx, uint32_t msg_type,
void *private_data);
/**
* CAVEAT:
*
* While the messaging_send*() functions are synchronuous by API,
* they trigger a tevent-based loop upon sending bigger messages.
*
* Hence callers should not use these in purely synchonous code,
* but run a tevent_loop instead.
*/
NTSTATUS messaging_send(struct messaging_context *msg_ctx,
struct server_id server,
uint32_t msg_type, const DATA_BLOB *data);