[#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(0x7f950f5feb08), requires_capability(0x7f950ed87338), requires_capability(0x7f950b48f5a8), requires_capability(0x7f95034d21c8), requires_capability(0x7f950e20f598), requires_capability(0x7f9527747238), requires_capability(0x7f950c3243c8), requires_capability(0x7f950c23fff8), requires_capability(0x7f95018b97a8), requires_capability(0x7f950bd91658), requires_capability(0x7f95065c8d58)]]
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]#