summaryrefslogtreecommitdiff
path: root/ares
diff options
context:
space:
mode:
authorYang Tse <yangsita@gmail.com>2009-11-20 14:15:05 +0000
committerYang Tse <yangsita@gmail.com>2009-11-20 14:15:05 +0000
commitc3266a5eb1340f5d7e467ced428a32b68b57a8f7 (patch)
tree24f7bef92bce1d49bf197370516e47244fd9354d /ares
parentced1e1e7267df300094936b576b19810a6b4f8df (diff)
downloadcurl-c3266a5eb1340f5d7e467ced428a32b68b57a8f7.tar.gz
Sync man page with reality
Diffstat (limited to 'ares')
-rw-r--r--ares/ares_expand_name.34
-rw-r--r--ares/ares_expand_string.34
-rw-r--r--ares/ares_mkquery.34
-rw-r--r--ares/ares_parse_aaaa_reply.36
-rw-r--r--ares/ares_set_socket_callback.39
5 files changed, 16 insertions, 11 deletions
diff --git a/ares/ares_expand_name.3 b/ares/ares_expand_name.3
index 65f16ebe6..e960bd6ed 100644
--- a/ares/ares_expand_name.3
+++ b/ares/ares_expand_name.3
@@ -14,7 +14,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 +23,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
diff --git a/ares/ares_expand_string.3 b/ares/ares_expand_string.3
index 872e677f7..9e6eb5ea8 100644
--- a/ares/ares_expand_string.3
+++ b/ares/ares_expand_string.3
@@ -14,7 +14,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_string \- Expand a length encoded string
.SH SYNOPSIS
@@ -23,7 +23,7 @@ ares_expand_string \- Expand a length encoded string
.PP
.B int ares_expand_string(const unsigned char *\fIencoded\fP,
.B const unsigned char *\fIabuf\fP, int \fIalen\fP, unsigned char **\fIs\fP,
-.B int *\fIenclen\fP)
+.B long *\fIenclen\fP)
.fi
.SH DESCRIPTION
The
diff --git a/ares/ares_mkquery.3 b/ares/ares_mkquery.3
index 613076bcf..ac3f36f03 100644
--- a/ares/ares_mkquery.3
+++ b/ares/ares_mkquery.3
@@ -14,7 +14,7 @@
.\" this software for any purpose. It is provided "as is"
.\" without express or implied warranty.
.\"
-.TH ARES_MKQUERY 3 "4 January 2000"
+.TH ARES_MKQUERY 3 "20 Nov 2009"
.SH NAME
ares_mkquery \- Compose a single-question DNS query buffer
.SH SYNOPSIS
@@ -22,7 +22,7 @@ ares_mkquery \- Compose a single-question DNS query buffer
.B #include <ares.h>
.PP
.B int ares_mkquery(const char *\fIname\fP, int \fIdnsclass\fP, int \fItype\fP,
-.B unsigned short \fIid\fP, int \fIrd\fP, char **\fIbuf\fP,
+.B unsigned short \fIid\fP, int \fIrd\fP, unsigned char **\fIbuf\fP,
.B int *\fIbuflen\fP)
.fi
.SH DESCRIPTION
diff --git a/ares/ares_parse_aaaa_reply.3 b/ares/ares_parse_aaaa_reply.3
index ea29036d5..f25cb9372 100644
--- a/ares/ares_parse_aaaa_reply.3
+++ b/ares/ares_parse_aaaa_reply.3
@@ -14,7 +14,7 @@
.\" this software for any purpose. It is provided "as is"
.\" without express or implied warranty.
.\"
-.TH ARES_PARSE_AAAA_REPLY 3 "10 March 2005"
+.TH ARES_PARSE_AAAA_REPLY 3 "20 Nov 2009"
.SH NAME
ares_parse_aaaa_reply \- Parse a reply to a DNS query of type AAAA
.SH SYNOPSIS
@@ -23,7 +23,7 @@ ares_parse_aaaa_reply \- Parse a reply to a DNS query of type AAAA
.PP
.B int ares_parse_aaaa_reply(const unsigned char *\fIabuf\fP, int \fIalen\fP,
.B struct hostent **\fIhost\fP,
-.B struct addrttl *\fIaddrttls\fB, int *\fInaddrttls\fB);
+.B struct addr6ttl *\fIaddrttls\fB, int *\fInaddrttls\fB);
.fi
.SH DESCRIPTION
The
@@ -31,7 +31,7 @@ The
function parses the response to a query of type AAAA into a
.BR "struct hostent"
and/or an array of
-.BR "struct addrttls" .
+.BR "struct addr6ttl" .
The parameters
.I abuf
and
diff --git a/ares/ares_set_socket_callback.3 b/ares/ares_set_socket_callback.3
index c4f045577..fb598ca29 100644
--- a/ares/ares_set_socket_callback.3
+++ b/ares/ares_set_socket_callback.3
@@ -1,15 +1,20 @@
.\" $Id$
.\"
-.TH ARES_SET_SOCKET_CALLBACK 3 "2 Dec 2008"
+.TH ARES_SET_SOCKET_CALLBACK 3 "20 Nov 2009"
.SH NAME
ares_set_socket_callback \- Set a socket creation callback
.SH SYNOPSIS
.nf
-int ares_set_socket_callback(ares_channel \fIchannel\fP,
+.B #include <ares.h>
+.PP
+.B void ares_set_socket_callback(ares_channel \fIchannel\fP,
ares_sock_create_callback \fIcallback\fP,
void *\fIuserdata\fP)
+.PP
+.B cc file.c -lcares
.fi
.SH DESCRIPTION
+.PP
This function sets a \fIcallback\fP in the given ares channel handle. This
callback function will be invoked after the socket has been created, and
connected to the remote server. The callback must return ARES_SUCCESS if