minor edits

This commit is contained in:
Daniel Stenberg 2004-04-02 09:50:42 +00:00
parent 7ba4d3464f
commit ce6b767b47
5 changed files with 15 additions and 25 deletions

View File

@ -36,7 +36,8 @@ status of
These calls give the callbacks a chance to clean up any state which These calls give the callbacks a chance to clean up any state which
might have been stored in their arguments. might have been stored in their arguments.
.SH SEE ALSO .SH SEE ALSO
.BR ares_init (3) .BR ares_init (3),
.BR ares_cancel (3)
.SH AUTHOR .SH AUTHOR
Greg Hudson, MIT Information Systems Greg Hudson, MIT Information Systems
.br .br

View File

@ -28,21 +28,16 @@ The
.I ares_free_hostent .I ares_free_hostent
function frees a function frees a
.B struct hostent .B struct hostent
allocated by one of the functions allocated by one of the functions \fIares_parse_a_reply(3)\fP or
.I ares_parse_a_reply \fIares_parse_ptr_reply(3)\fP.
or .SH NOTES
.IR ares_parse_ptr_reply . It is not necessary (and is not correct) to free the host structure passed to
the callback functions for \fIares_gethostbyname(3)\fP or
\fIares_gethostbyaddr(3)\fP. The ares library will automatically free such
host structures when the callback returns.
.SH SEE ALSO .SH SEE ALSO
.BR ares_parse_a_reply (3), .BR ares_parse_a_reply (3),
.BR ares_parse_ptr_reply (3) .BR ares_parse_ptr_reply (3)
.SH NOTES
It is not necessary (and is not correct) to free the host structure
passed to the callback functions for
.I ares_gethostbyname
or
.IR ares_gethostbyaddr .
The ares library will automatically free such host structures when the
callback returns.
.SH AUTHOR .SH AUTHOR
Greg Hudson, MIT Information Systems Greg Hudson, MIT Information Systems
.br .br

View File

@ -50,8 +50,7 @@ stored in the variable pointed to by
and the length of which will be stored in the variable pointed to by and the length of which will be stored in the variable pointed to by
.IR buflen . .IR buflen .
It is the caller's responsibility to free this buffer using It is the caller's responsibility to free this buffer using
.B ares_free_string \fIares_free_string(3)\fP when it is no longer needed.
when it is no longer needed.
.SH RETURN VALUES .SH RETURN VALUES
.B ares_mkquery .B ares_mkquery
can return any of the following values: can return any of the following values:

View File

@ -35,13 +35,10 @@ The file descriptor sets pointed to by
and and
.I write_fds .I write_fds
should have file descriptors set in them according to whether the file should have file descriptors set in them according to whether the file
descriptors specified by descriptors specified by \fIares_fds(3)\fP are ready for reading and writing.
.BR ares_fds (3) (The easiest way to determine this information is to invoke
are ready for reading and writing. (The easiest way to determine this
information is to invoke
.B select .B select
with a timeout no greater than the timeout given by with a timeout no greater than the timeout given by \fIares_timeout(3)\fP ).
.BR ares_timeout (3)).
.PP .PP
The The
.B ares_process .B ares_process

View File

@ -27,10 +27,8 @@ ares_fds \- Get file descriptors to select on for name service
.SH DESCRIPTION .SH DESCRIPTION
The The
.B ares_timeout .B ares_timeout
function determines the maximum time for which the caller should wait function determines the maximum time for which the caller should wait before
before invoking invoking \fIares_process(3)\fP to process timeouts. The parameter
.BR ares_process (3)
to process timeouts. The parameter
.I maxtv .I maxtv
specifies a existing maximum timeout, or specifies a existing maximum timeout, or
.B NULL .B NULL