ares_build.h.dist: enhance non-configure GCC ABI detection logic
[platform/upstream/c-ares.git] / ares_expand_name.3
index 65f16eb..fc18df3 100644 (file)
@@ -1,4 +1,3 @@
-.\" $Id$
 .\"
 .\" Copyright 1998 by the Massachusetts Institute of Technology.
 .\"
@@ -14,7 +13,7 @@
 .\" this software for any purpose.  It is provided "as is"
 .\" without express or implied warranty.
 .\"
-.TH ARES_EXPAND_NAME 3 "23 July 1998"
+.TH ARES_EXPAND_NAME 3 "20 Nov 2009"
 .SH NAME
 ares_expand_name \- Expand a DNS-encoded domain name
 .SH SYNOPSIS
@@ -23,7 +22,7 @@ ares_expand_name \- Expand a DNS-encoded domain name
 .PP
 .B int ares_expand_name(const unsigned char *\fIencoded\fP,
 .B      const unsigned char *\fIabuf\fP, int \fIalen\fP, char **\fIs\fP,
-.B     int *\fIenclen\fP)
+.B     long *\fIenclen\fP)
 .fi
 .SH DESCRIPTION
 The
@@ -44,6 +43,8 @@ The length of the encoded name is stored in the variable pointed to by
 .I enclen
 so that the caller can advance past the encoded domain name to read
 further data in the message.
+
+Use \fIares_free_string(3)\fP to free the allocated hostname.
 .SH RETURN VALUES
 .B ares_expand_name
 can return any of the following values:
@@ -57,7 +58,7 @@ The encoded domain name was malformed and could not be expanded.
 .B ARES_ENOMEM
 Memory was exhausted.
 .SH SEE ALSO
-.BR ares_mkquery (3)
+.BR ares_mkquery (3), ares_free_string (3)
 .SH AUTHOR
 Greg Hudson, MIT Information Systems
 .br