native handles
0.1.0Retrieve the native handle of an operating system-backed resource of your implementation, such as streams, sockets, threads, etc.
Table of Contents
About native-handles
This library is a portability wrapper digging into the guts of implementations to retrieve the native operating system handles and pointers for objects that are backed by such, like streams, sockets, threads, shared libraries, and possibly locks and so forth.
The only entry point is native-handle which will return the native handle for an object as a pointer or integer, if possible.
Implementation Support
Currently the following implementations are supported:
CCL
ECL
SBCL
System Information
Definition Index
-
ORG.SHIRAKUMO.NATIVE-HANDLES
No documentation provided.-
EXTERNAL CONDITION UNSUPPORTED-ERROR
Error signalled if a requested object cannot be turned into an OS handle.
-
EXTERNAL FUNCTION NATIVE-HANDLE
- THING
Returns the native handle of THING as a pointer or integer. If the THING is no longer backed by a native OS object, then NIL may be returned instead. Note however, that even if a pointer or integer is returned, it is in no way guaranteed that the handle is still valid within the OS context. It may have been freed. It is up to you to ensure that you only access handles that are still valid. If the THING is not backed by an OS object, or there is no known way to retrieve its OS handle, an error of type UNSUPPORTED-ERROR is signalled. See UNSUPPORTED-ERROR
-