diff options
author | wtc%google.com <devnull@localhost> | 2008-05-04 01:39:30 +0000 |
---|---|---|
committer | wtc%google.com <devnull@localhost> | 2008-05-04 01:39:30 +0000 |
commit | 293876f03c9417e938a6c0538040e669e6e30327 (patch) | |
tree | 84ec5bfc889066bcfa126ba06d8333770b491ffb | |
parent | 218a30c10e84ae074f05a11ef23d567c5c26f7fd (diff) | |
download | nspr-hg-293876f03c9417e938a6c0538040e669e6e30327.tar.gz |
Bug 431982: Improved the comment for PR_FileDesc2NativeHandle. r=nelson.
-rw-r--r-- | pr/include/private/pprio.h | 16 |
1 files changed, 14 insertions, 2 deletions
diff --git a/pr/include/private/pprio.h b/pr/include/private/pprio.h index 63e063cf..61a454bc 100644 --- a/pr/include/private/pprio.h +++ b/pr/include/private/pprio.h @@ -65,8 +65,20 @@ NSPR_API(const PRIOMethods*) PR_GetUDPMethods(void); NSPR_API(const PRIOMethods*) PR_GetPipeMethods(void); /* -** Convert a NSPR Socket Handle to a Native Socket handle. -** This function will be obsoleted with the next release; avoid using it. +** Convert a NSPR socket handle to a native socket handle. +** +** Using this function makes your code depend on the properties of the +** current NSPR implementation, which may change (although extremely +** unlikely because of NSPR's backward compatibility requirement). Avoid +** using it if you can. +** +** If you use this function, you need to understand what NSPR does to +** the native handle. For example, NSPR puts native socket handles in +** non-blocking mode or associates them with an I/O completion port (the +** WINNT build configuration only). Your use of the native handle should +** not interfere with NSPR's use of the native handle. If your code +** changes the configuration of the native handle, (e.g., changes it to +** blocking or closes it), NSPR will not work correctly. */ NSPR_API(PROsfd) PR_FileDesc2NativeHandle(PRFileDesc *); NSPR_API(void) PR_ChangeFileDescNativeHandle(PRFileDesc *, PROsfd); |