3 ping_send - Send ICMP echo requests to all associated hosts and wait for ICMP echo responses to arrive
9 int ping_send (pingobj_t *obj);
13 The B<ping_send> method is the actual workhorse of this library. It crafts ICMP
14 packets for the hosts associated with I<obj> and sends them via the
15 corresponding sockets. It then waits for echo responses and receives them,
16 writing latency information for each host. The method returns after all echo
17 replies have been read or the timeout (set with L<ping_setopt(3)>) is reached.
19 After this function returns you will most likely iterate over all hosts using
20 L<ping_iterator_get(3)> and ping_iterator_next (described in the same manpage)
21 and call L<ping_iterator_get_info(3)> on each host.
25 B<ping_send> returns the value of echo replies received or a value less than
26 zero if an error occured. Use L<ping_get_error(3)> to receive an error message.
32 L<ping_iterator_get(3)>,
33 L<ping_iterator_get_info(3)>,
39 liboping is written by Florian octo Forster E<lt>octo at verplant.orgE<gt>.
40 It's homepage can be found at L<http://verplant.org/liboping/>.
42 (c) 2005-2009 by Florian octo Forster.