Function gnunet_sys::GNUNET_TRANSPORT_monitor_peers

pub unsafe extern "C" fn GNUNET_TRANSPORT_monitor_peers(
    cfg: *const GNUNET_CONFIGURATION_Handle, 
    peer: *const GNUNET_PeerIdentity, 
    one_shot: c_int, 
    peer_callback: GNUNET_TRANSPORT_PeerIterateCallback, 
    peer_callback_cls: *mut c_void
) -> *mut GNUNET_TRANSPORT_PeerMonitoringContext

Return information about a specific peer or all peers currently known to transport service once or in monitoring mode. To obtain information about a specific peer, a peer identity can be passed. To obtain information about all peers currently known to transport service, NULL can be passed as peer identity.

For each peer, the callback is called with information about the address used to communicate with this peer, the state this peer is currently in and the the current timeout for this state.

Upon completion, the #GNUNET_TRANSPORT_PeerIterateCallback is called one more time with NULL. After this, the operation must no longer be explicitly canceled.

The #GNUNET_TRANSPORT_monitor_peers_cancel call MUST not be called in the the peer_callback!

@param cfg configuration to use @param peer a specific peer identity to obtain information for, NULL for all peers @param one_shot #GNUNET_YES to return the current state and then end (with NULL+NULL), #GNUNET_NO to monitor peers continuously @param peer_callback function to call with the results @param peer_callback_cls closure for @a peer_callback