index 1d4e8cf212c2d47ff8240b970afb7620cddc63fa..e1cd24fb4b37c2f02c8ee5335dc6eacab8138fdb 100644 (file)
=head1 NAME
-ping_iterator_get_info - Constructor for the liboping class
+ping_iterator_get_info - Receive information about a host
=head1 SYNOPSIS
Return the hostname of the host the iterator points to. Since the name is
looked up using the socket address this may differ from the hostname passed to
L<ping_host_add(3)>. The hostname is actually looked up every time you call
-this method, no cache is involved within liboping.
+this method, no cache is involved within I<liboping>.
It is recommended to include C<netdb.h> and allocate B<NI_MAXHOST> bytes of
buffer.
=item B<PING_INFO_FAMILY>
-Returns the address family of the host. The buffer should be ig enough to hold
+Returns the address family of the host. The buffer should be big enough to hold
an integer. The value is either B<AF_INET> or B<AF_INET6>.
=item B<PING_INFO_LATENCY>
-Return the last measured latency or less than zero if the timeout occured
+Return the last measured latency or less than zero if the timeout occurred
before a echo response was received. The buffer should be big enough to hold a
double value.
@@ -103,6 +103,17 @@ If the requested information didn't fit into I<buffer> then the size that would
have been needed is written into I<buffer_len>; I<buffer> itself is left
untouched. The return value is B<ENOMEM> in this case.
+=head1 KNOWN BUGS
+
+=over 4
+
+=item
+
+B<PING_INFO_RECV_TTL> is not available under Debian Etch due to a missing
+define in the header files.
+
+=back
+
=head1 SEE ALSO
L<ping_iterator_get(3)>,