DragonFly On-Line Manual Pages

ping_send(3)                       liboping                       ping_send(3)

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.

1.6.2                             2011-09-06                      ping_send(3)