ping_construct(3) [debian 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)

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

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

1.6.2								    2012-01-31							      ping_send(3)