ping_iterator_get_context(3) [debian man page]

ping_iterator_get_context(3)					     liboping					      ping_iterator_get_context(3)

NAME

       ping_iterator_get_context, ping_iterator_set_context - Store host-dependent data

SYNOPSIS

	 #include <oping.h>

	 void *ping_iterator_get_context (pingobj_iter_t *iter);
	 void  ping_iterator_set_context (pingobj_iter_t *iter, void *context);

DESCRIPTION

       ping_iterator_set_context can be used to store host-specific data within the liboping structures. This data can be received again by
       calling ping_iterator_get_context. The data itself is never touched by liboping. If you call ping_host_remove (see ping_host_add(3)) or
       ping_destroy (see ping_construct(3)) and the context is not NULL liboping will assume you know what you're doing and simply ignore the fact
       this might be a memory leak.

       The iter argument is an iterator object as returned by ping_iterator_get(3) and ping_iterator_next.

       The context argument of ping_iterator_set_context is a pointer to anything and may be NULL.

RETURN VALUE

       ping_iterator_get_context returns the same pointer previously passed to ping_iterator_set_context or NULL if ping_iterator_set_context has
       never been called before.

SEE ALSO

       ping_iterator_get(3), ping_construct(3), ping_host_add(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/>.

       Copyright (c) 2005-2011 by Florian "octo" Forster.

1.6.2								    2012-01-31					      ping_iterator_get_context(3)

Check Out this Related Man Page

ping_construct(3)						     liboping							 ping_construct(3)

NAME

       ping_construct - Constructor for the liboping class

SYNOPSIS

	 #include <oping.h>

	 pingobj_t *ping_construct (void);
	 void	    ping_destroy   (pingobj_t *obj);

DESCRIPTION

       The ping_construct constructor allocates the memory necessary for a liboping object, initializes that memory and returns a pointer to it.

       The ping_destroy iterates over all hosts associated with the liboping object obj, closes the sockets, removes the hosts and frees obj's
       memory.

RETURN VALUE

       The ping_construct constructor returns a pointer to the allocated memory or NULL if no memory could be allocated.

SEE ALSO

       ping_setopt(3), ping_send(3), ping_host_add(3), ping_get_error(3), ping_iterator_get(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/>.

       Copyright (c) 2005-2011 by Florian "octo" Forster.

1.6.2								    2012-01-31							 ping_construct(3)

Linux and UNIX Man Pages

ping_iterator_get_context(3) [debian man page]

Check Out this Related Man Page