Code

Update copyright notices.
[liboping.git] / src / mans / ping_construct.pod
1 =head1 NAME
3 ping_construct - Constructor for the liboping class
5 =head1 SYNOPSIS
7   #include <oping.h>
9   pingobj_t *ping_construct (void);
10   void       ping_destroy   (pingobj_t *obj);
12 =head1 DESCRIPTION
14 The B<ping_construct> constructor allocates the memory necessary for a
15 liboping object, initializes that memory and returns a pointer to it.
17 The B<ping_destroy> iterates over all hosts associated with the liboping object
18 I<obj>, closes the sockets, removes the hosts and frees I<obj>'s memory.
20 =head1 RETURN VALUE
22 The B<ping_construct> constructor returns a pointer to the allocated memory or NULL if no memory could be allocated.
24 =head1 SEE ALSO
26 L<ping_setopt(3)>,
27 L<ping_send(3)>,
28 L<ping_host_add(3)>,
29 L<ping_get_error(3)>,
30 L<ping_iterator_get(3)>,
31 L<liboping(3)>
33 =head1 AUTHOR
35 liboping is written by Florian "octo" Forster E<lt>ff at octo.itE<gt>.
36 Its homepage can be found at L<http://noping.cc/>.
38 Copyright (c) 2005-2016 by Florian "octo" Forster.