[#CConnman-EvictTxPeerIfFull]
= xref:CConnman.adoc[CConnman]::EvictTxPeerIfFull
:relfileprefix: ../
:mrdocs:

If we are at capacity for inbound tx‐relay peers, attempt to evict one.

== Synopsis

Declared in `<net.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
[[requires_capability(0x7f2e2b749108), requires_capability(0x7f2e28941e18), requires_capability(0x7f2e234d0ff8), requires_capability(0x7f2e2737d798), requires_capability(0x7f2e235eee28), requires_capability(0x7f2e2a34af18), requires_capability(0x7f2e219f7ce8), requires_capability(0x7f2e21c82ba8), requires_capability(0x7f2e1aa35708), requires_capability(0x7f2e376b77e8), requires_capability(0x7f2e433cd378)]]
bool
EvictTxPeerIfFull(std::optional<NodeId> protect_peer = std::nullopt);
----

== Return Value

bool Returns true if successful (either there is no need for eviction, or a peer was evicted). Returns false, if we are full but couldn't find a peer to evict (all eligible peers are protected) so that the caller can deal with this.

== Parameters

[cols="1,4"]
|===
| Name| Description
| *protect_peer* [in]
| NodeId of a peer we want to protect
|===


[.small]#Created with https://www.mrdocs.com[MrDocs]#