From e02f617d5f8579a7a5a782f1d833e8ccd2592adc Mon Sep 17 00:00:00 2001 From: Daniele Sciascia Date: Thu, 14 Feb 2019 08:53:20 +0100 Subject: [PATCH] Document log_position param in client_service::prepare_data_for_replication() --- include/wsrep/client_service.hpp | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/include/wsrep/client_service.hpp b/include/wsrep/client_service.hpp index 0007966..795e502 100644 --- a/include/wsrep/client_service.hpp +++ b/include/wsrep/client_service.hpp @@ -100,12 +100,17 @@ namespace wsrep /** * Prepare a buffer containing data for the next fragment to replicate. + * The caller may set log_position to record the database specific + * position corresponding to changes contained in the buffer. + * When the call returns, the log_position will be available to read + * from streaming_context::log_position(). * * @return Zero in case of success, non-zero on failure. * If there is no data to replicate, the method shall return * zero and leave the buffer empty. */ - virtual int prepare_fragment_for_replication(wsrep::mutable_buffer&, size_t&) = 0; + virtual int prepare_fragment_for_replication(wsrep::mutable_buffer& buffer, + size_t& log_position) = 0; /** * Remove fragments from the storage within current transaction.