typedef void(* mira_net_ping_callback_t) (const mira_net_address_t *address, uint8_t ttl, int32_t rtt, void *storage);
Type for the callback to execute on ping reply.
|address||Address of the source of the reply.|
|ttl||Time to live; how many more hops the packet would live.|
|rtt||It is >= 0 at ping reply, < 0 when no reply was received.|
|storage||Data set upon sending the ping, see mira_net_ping_send().|
rtt is only used to tell if a reply was received.
mira_status_t mira_net_ping_send(const mira_net_address_t *address, mira_net_ping_callback_t cb, void *storage);
Send a ping to the specified address.
The callback is only called once. Either at the first ping reply or when mira_net_ping_send is called the next time. The callback's rtt argument is < 0 if no reply was received.
|address||The node address.|
|cb||The callback function, executes on ping reply.|
|storage||Storage pointer which is used to store optional information to be used by the callback function. E.g. it could be used as an identifier or to pass on a configuration struct.|