Poster of Linux kernelThe best gift for a Linux geek
ping_send

ping_send

Section: liboping (3) Updated: 2010-06-13
Local index Up
 

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/>.

(c) 2005-2009 by Florian octo Forster.


 

Index

NAME
SYNOPSIS
DESCRIPTION
RETURN VALUE
SEE ALSO
AUTHOR

This document was created by man2html, using the manual pages.
Time: 21:52:27 GMT, April 16, 2011