aboutsummaryrefslogtreecommitdiff
path: root/ares
diff options
context:
space:
mode:
authorDaniel Stenberg <daniel@haxx.se>2004-01-29 12:07:48 +0000
committerDaniel Stenberg <daniel@haxx.se>2004-01-29 12:07:48 +0000
commit3415ac3866aba39b1f4cb8bec4f9a546acf4f451 (patch)
treee31271c9877b1ac012652ecc19ca915baceb3a2d /ares
parentd50b209a7a7e20234f23562ff607e0364704d3ba (diff)
documented ares_version()
Diffstat (limited to 'ares')
-rw-r--r--ares/ares_version.339
1 files changed, 39 insertions, 0 deletions
diff --git a/ares/ares_version.3 b/ares/ares_version.3
new file mode 100644
index 000000000..7aeabf7e0
--- /dev/null
+++ b/ares/ares_version.3
@@ -0,0 +1,39 @@
+.\" $Id$
+.\"
+.\" Copyright 2004 by Daniel Stenberg
+.\"
+.\" 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_VERSION 3 "29 January 2004"
+.SH NAME
+ares_version \- Get the version number of the library
+.SH SYNOPSIS
+.nf
+.B #include <ares.h>
+.PP
+.B const char *ares_version(int *\fIversion\fP)
+.fi
+.SH DESCRIPTION
+The
+.B ares_version
+function gets the library version as a string and optionally as an integer
+stored in the
+.IR version ,
+argument. If you pass a NULL, no integer is attempted to be returned.
+
+The integer is built up as 24bit number, with 8 separate bits used for major
+number, minor number and patch number. This makes a version string such as
+1.2.3 will be returned as the hexadecimal number 0x010203 (decimal 66051).
+.SH AUTHOR
+Daniel Stenberg
+