From e58598e833d5737900fe3c4369e26f2a08166892 Mon Sep 17 00:00:00 2001 From: John Newbery Date: Thu, 28 Oct 2021 12:46:26 +0100 Subject: [PATCH] [addrman] Add doxygen comment to AddrMan::Add() Does not document the return value since we're going to fix the semantics in a future commit. --- src/addrman.h | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/src/addrman.h b/src/addrman.h index 174ab4f811b..1fbc827183a 100644 --- a/src/addrman.h +++ b/src/addrman.h @@ -69,7 +69,14 @@ public: //! Return the number of (unique) addresses in all tables. size_t size() const; - //! Add addresses to addrman's new table. + /** + * Attempt to add one or more addresses to addrman's new table. + * + * @param[in] vAddr Address records to attempt to add. + * @param[in] source The address of the node that sent us these addr records. + * @param[in] nTimePenalty A "time penalty" to apply to the address record's nTime. If a peer + * sends us an address record with nTime=n, then we'll add it to our + * addrman with nTime=(n - nTimePenalty). */ bool Add(const std::vector& vAddr, const CNetAddr& source, int64_t nTimePenalty = 0); //! Mark an entry as accessible, possibly moving it from "new" to "tried".