NAME¶
ping_send - Send ICMP echo requests to all associated hosts and wait for ICMP
echo responses to arrive
SYNOPSIS¶
#include <oping.h>
int ping_send (pingobj_t *obj);
DESCRIPTION¶
The
ping_send method is the actual workhorse of this library. It crafts
ICMP packets for the hosts associated with
obj and sends them via the
corresponding sockets. It then waits for echo responses and receives them,
writing latency information for each host. The method returns after all echo
replies have been read or the timeout (set with
ping_setopt(3)) is
reached.
After this function returns you will most likely iterate over all hosts using
ping_iterator_get(3) and ping_iterator_next (described in the same
manual page) and call
ping_iterator_get_info(3) on each host.
RETURN VALUE¶
ping_send returns the number of echo replies received or a value less
than zero if an error occurred. Use
ping_get_error(3) to receive an
error message.
SEE ALSO¶
ping_construct(3),
ping_setopt(3),
ping_iterator_get(3),
ping_iterator_get_info(3),
ping_get_error(3),
liboping(3)
AUTHOR¶
liboping is written by Florian "octo" Forster <octo at
verplant.org>. Its homepage can be found at
<
http://verplant.org/liboping/>.
Copyright (c) 2005-2011 by Florian "octo" Forster.