Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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 cor-
     responding 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 us-
     ing ping_iterator_get(3) and ping_iterator_next (described in the same man-
     ual 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  mes-
     sage.

SEE ALSO
     ping_construct(3),    ping_setopt(3),   ping_iterator_get(3),   ping_itera-
     tor_get_info(3), ping_get_error(3), liboping(3)

AUTHOR
     liboping is written by Florian "octo" Forster <ff at octo.it>.   Its  home-
     page can be found at <http://noping.cc/>.

     Copyright (c) 2006-2017 by Florian "octo" Forster.

1.10.0				   2017-05-11			    ping_send(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=ping_send&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help