Click above to get retro games delivered to your door ever month!

__FSEXT_alloc_fd
================

Syntax
------

     #include <sys/fsext.h>
     
     int __FSEXT_alloc_fd(__FSEXT_Function *_function);

Description
-----------

This function is part of the File System Extensions:.  It is used   
by extensions that fully emulate the I/O functions, and thus don't have
a corresponding DOS file handle.  This function opens DOS's `NUL'
device, so as to allocate a handle that DOS won't then reuse.  It also
assigns the handler function for that descriptor.

The module is responsible for calling `_close' on the descriptor after
setting the handler function to zero in the extended close handler.

Example
-------


     int socket()
     {
       int fd = __FSEXT_alloc_fd(socket_handler);
       init_socket(fd);
       return fd;
     }