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

FreeBSD Manual Pages

  
 
  

home | help
ping_iterator_get(3)		    liboping		    ping_iterator_get(3)

NAME
     ping_iterator_get,  ping_iterator_next - Iterate over all hosts of a libop-
     ing object

SYNOPSIS
       #include <oping.h>

       pingobj_iter_t *ping_iterator_get (pingobj_t *obj);
       pingobj_iter_t *ping_iterator_next (pingobj_iter_t *iter)

DESCRIPTION
     These two functions can be used to iterate over all hosts associated with a
     liboping object. You can use these methods as follows:

       pingobj_iter_t *iter;

       for (iter = ping_iterator_get (obj);
	    iter != NULL;
	    iter = ping_iterator_next (iter))
       {
	 ...;
       }

     To get usable information from an iterator object (which is also an  opaque
     data   type,   just  like	the  liboping  object  itself)	use  ping_itera-
     tor_get_info(3) and ping_iterator_get_context(3).

RETURN VALUE
     The ping_iterator_get returns an iterator for obj or NULL if no host is as-
     sociated with obj.

     The ping_iterator_next returns an iterator for the host following	iter  or
     NULL if the last host has been reached.

SEE ALSO
     ping_host_add(3),	ping_iterator_get_info(3), ping_iterator_get_context(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_iterator_get(3)

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

home | help