=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.
=item B<PING_INFO_IDENT>
Return the ident that is put into every ICMP packet sent to this host. Per
-convention this usually is the PID of the sending process, but since liboping
-can handle several hosts in parallel it uses a (pseudo-)random number here. The
+convention this usually is the PID of the sending process, but since
+I<liboping> can handle several hosts in parallel it uses a (pseudo-)random
+number here. The buffer should be big enough to hold an integer value.
+
+=item B<PING_INFO_RECV_TTL>
+
+Returns the I<time to live> (TTL) of the received network packets. This number
+depends on the value that was used by the remote host when it sent the echo
+reply and has nothing to do with the B<PING_OPT_TTL> of L<ping_setopt(3)>. The
buffer should be big enough to hold an integer value.
=back
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)>,