summaryrefslogtreecommitdiff
path: root/lib/libc/asr/async_resolver.3
diff options
context:
space:
mode:
authorEric Faurot <eric@cvs.openbsd.org>2012-08-18 16:48:18 +0000
committerEric Faurot <eric@cvs.openbsd.org>2012-08-18 16:48:18 +0000
commit2d6170fe443f939945152c4cd272112d4f396646 (patch)
treed3c68ef23fe798f210956132cbcde53b53c04964 /lib/libc/asr/async_resolver.3
parente4218038d13ffd6856abc67fe6b5fd2b44d0a970 (diff)
ensure that async_run() and async_run_sync() always preserve errno.
Diffstat (limited to 'lib/libc/asr/async_resolver.3')
-rw-r--r--lib/libc/asr/async_resolver.312
1 files changed, 10 insertions, 2 deletions
diff --git a/lib/libc/asr/async_resolver.3 b/lib/libc/asr/async_resolver.3
index 2fa4204abe7..81ae9f92e23 100644
--- a/lib/libc/asr/async_resolver.3
+++ b/lib/libc/asr/async_resolver.3
@@ -1,4 +1,4 @@
-.\" $OpenBSD: async_resolver.3,v 1.2 2012/04/15 15:08:12 jmc Exp $
+.\" $OpenBSD: async_resolver.3,v 1.3 2012/08/18 16:48:17 eric Exp $
.\"
.\" Copyright (c) 2012, Eric Faurot <eric@openbsd.org>
.\"
@@ -14,7 +14,7 @@
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
-.Dd $Mdocdate: April 15 2012 $
+.Dd $Mdocdate: August 18 2012 $
.Dt ASYN_RESOLVER 3
.Os
.Sh NAME
@@ -212,6 +212,13 @@ are set accordingly and the resolving process can be resumed by calling
.Fn async_run .
.El
.Pp
+Note that although the query itself may fail (the error being properly reported
+in the
+.Fa ar
+structure), the
+.Fn async_run
+function itself cannot fail and it always preserves errno.
+.Pp
The
.Fn async_run_sync
function is a wrapper around
@@ -220,6 +227,7 @@ that handles the read/write conditions, thus falling back to a blocking
interface.
It only returns partial and complete results through ASYNC_YIELD and ASYNC_DONE
respectively.
+It also preserves errno.
.Pp
The
.Fn async_abort