"Fossies" - the Fresh Open Source Software Archive

Member "liboping-1.10.0/src/mans/ping_iterator_get.pod" (11 May 2017, 1294 Bytes) of package /linux/privat/liboping-1.10.0.tar.gz:


Caution: As a special service "Fossies" has tried to format the requested pod source page into HTML format but links to other pod pages may be missing or even erroneous. Alternatively you can here view or download the uninterpreted pod source code. A member file download can also be achieved by clicking within a package contents listing on the according byte size field. See also the latest Fossies "Diffs" side-by-side code changes report for "ping_iterator_get.pod": 1.9.0_vs_1.10.0.

NAME

ping_iterator_get, ping_iterator_next - Iterate over all hosts of a liboping 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_iterator_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 associated 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 homepage can be found at http://noping.cc/.

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