X-Git-Url: https://asedeno.scripts.mit.edu/gitweb/?a=blobdiff_plain;f=libares%2Fares_parse_a_reply.3;fp=libares%2Fares_parse_a_reply.3;h=0000000000000000000000000000000000000000;hb=7ca563751835c3ffa62d66b31aa79b09f98f0051;hp=7d395dda0a86f2d91a5ff7176b930eb1752da041;hpb=ef5f158dd73b0584e10ced93e40827cbb100dc6f;p=1ts-debian.git diff --git a/libares/ares_parse_a_reply.3 b/libares/ares_parse_a_reply.3 deleted file mode 100644 index 7d395dd..0000000 --- a/libares/ares_parse_a_reply.3 +++ /dev/null @@ -1,65 +0,0 @@ -.\" $Id: ares_parse_a_reply.3,v 1.1 1998/08/13 18:07:33 ghudson Exp $ -.\" -.\" Copyright 1998 by the Massachusetts Institute of Technology. -.\" -.\" Permission to use, copy, modify, and distribute this -.\" software and its documentation for any purpose and without -.\" fee is hereby granted, provided that the above copyright -.\" notice appear in all copies and that both that copyright -.\" notice and this permission notice appear in supporting -.\" documentation, and that the name of M.I.T. not be used in -.\" advertising or publicity pertaining to distribution of the -.\" software without specific, written prior permission. -.\" M.I.T. makes no representations about the suitability of -.\" this software for any purpose. It is provided "as is" -.\" without express or implied warranty. -.\" -.TH ARES_PARSE_A_REPLY 3 "25 July 1998" -.SH NAME -ares_parse_a_reply \- Parse a reply to a DNS query of type A into a hostent -.SH SYNOPSIS -.nf -.B #include -.PP -.B -int ares_parse_a_reply(const unsigned char *\fIabuf\fB, int \fIalen\fB, -.B struct hostent **\fIhost\fB); -.fi -.SH DESCRIPTION -The -.B ares_parse_a_reply -function parses the response to a query of type A into a -.BR "struct hostent" . -The parameters -.I abuf -and -.I alen -give the contents of the response. The result is stored in allocated -memory and a pointer to it stored into the variable pointed to by -.IR host . -It is the caller's responsibility to free the resulting host structure -using -.BR ares_free_hostent (3) -when it is no longer needed. -.SH RETURN VALUES -.B ares_parse_a_reply -can return any of the following values: -.TP 15 -.B ARES_SUCCESS -The response was successfully parsed. -.TP 15 -.B ARES_EBADRESP -The response was malformatted. -.TP 15 -.B ARES_ENODATA -The response did not contain an answer to the query. -.TP 15 -.B ARES_ENOMEM -Memory was exhausted. -.SH SEE ALSO -.BR ares_gethostbyname (3), -.BR ares_free_hostent (3) -.SH AUTHOR -Greg Hudson, MIT Information Systems -.br -Copyright 1998 by the Massachusetts Institute of Technology.