1ping_send(3)                       liboping                       ping_send(3)
2
3
4

NAME

6       ping_send - Send ICMP echo requests to all associated hosts and wait
7       for ICMP echo responses to arrive
8

SYNOPSIS

10         #include <oping.h>
11
12         int ping_send (pingobj_t *obj);
13

DESCRIPTION

15       The ping_send method is the actual workhorse of this library. It crafts
16       ICMP packets for the hosts associated with obj and sends them via the
17       corresponding sockets. It then waits for echo responses and receives
18       them, writing latency information for each host. The method returns
19       after all echo replies have been read or the timeout (set with
20       ping_setopt(3)) is reached.
21
22       After this function returns you will most likely iterate over all hosts
23       using ping_iterator_get(3) and ping_iterator_next (described in the
24       same manual page) and call ping_iterator_get_info(3) on each host.
25

RETURN VALUE

27       ping_send returns the value of echo replies received or a value less
28       than zero if an error occurred. Use ping_get_error(3) to receive an
29       error message.
30

SEE ALSO

32       ping_construct(3), ping_setopt(3), ping_iterator_get(3),
33       ping_iterator_get_info(3), ping_get_error(3), liboping(3)
34

AUTHOR

36       liboping is written by Florian octo Forster <octo at verplant.org>.
37       It's homepage can be found at <http://verplant.org/liboping/>.
38
39       (c) 2005-2009 by Florian octo Forster.
40
41
42
431.3.4                             2009-12-20                      ping_send(3)
Impressum