aboutsummaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
Diffstat (limited to 'doc')
-rw-r--r--doc/ChangeLog7
-rw-r--r--doc/assuan.texi9
2 files changed, 15 insertions, 1 deletions
diff --git a/doc/ChangeLog b/doc/ChangeLog
index 3804a8d..3f76d12 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,8 @@
+2007-07-12 Werner Koch <[email protected]>
+
+ * assuan.texi (Utilities): Document that under W32 we return a
+ system handle.
+
2007-07-05 Werner Koch <[email protected]>
* lgpl.texi: New. Taken from COPYING.LIB and reformatted.
@@ -36,7 +41,7 @@
* assuan.texi: Imported from newpg.
- Copyright 2003 Free Software Foundation, Inc.
+ Copyright 2003, 2007 Free Software Foundation, Inc.
This file is free software; as a special exception the author gives
unlimited permission to copy and/or distribute it, with or without
diff --git a/doc/assuan.texi b/doc/assuan.texi
index 2531d8c..f22a7f9 100644
--- a/doc/assuan.texi
+++ b/doc/assuan.texi
@@ -1207,6 +1207,12 @@ If @var{line} contains @code{FD=@var{n}}, it returns @var{n} in
just @code{FD} it returns a file descriptor at @var{rfd}; this file
descriptor needs to have been sent by the client right before using
@code{assuan_sendfd}.
+
+On W32 systems the returned file descriptor is a system handle and not a
+libc low level I/O file descriptor. Thus applications need to use
+@code{_open_osfhandle} before they can pass this descriptor to standard
+functions like @code{fdopen} or @code{dup}.
+
@end deftypefun
@deftypefun int assuan_get_input_fd (@w{assuan_context_t @var{ctx}})
@@ -1331,6 +1337,9 @@ writing. @var{fdarray} is an array of integers provided by the caller;
On success the number of active descriptors are returned. These active
descriptors are then stored in @var{fdarray}. On error @code{-1} is
returned; the most likely reason for this is a too small @var{fdarray}.
+
+Note that on W32 systems the returned file descriptor is a system handle
+and not a libc low level I/O file descriptor.
@end deftypefun