Date: Sun, 30 Nov 1997 14:45:13 +0200 (IST)
From: Eli Zaretskii <eliz AT is DOT elta DOT co DOT il>
To: DJ Delorie <dj AT delorie DOT com>
cc: djgpp-workers AT delorie DOT com
Subject: Docs for _is_remote_xxx functions
Message-ID: <Pine.SUN.3.91.971130144400.5999D-100000@is>
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII
Precedence: bulk

Here's the missing docs for these two functions:

*** /dev/null	Sat Nov 29 15:48:22 1997
--- src/libc/dos/dos/remotdrv.txh	Sat Nov 29 15:46:12 1997
***************
*** 0 ****
--- 1,47 ----
+ @c -------------------------------------------------------------------
+ @node _is_remote_drive, io
+ @subheading Syntax
+ 
+ @example
+ int _is_remote_drive(int drv);
+ @end example
+ 
+ @subheading Description
+ 
+ Given the drive number in @var{drv} (A: = 0, B: = 1, etc.), this
+ function returns non-zero if the drive is treated by DOS as a remote
+ (networked) drive, or zero otherwise.  It does so by calling subfunction
+ 09h of the DOS IOCTL function (interrupt 21h, AX=4409h) and looking at
+ bit 12 of the device attribute word returned in the DX register.
+ 
+ Note that DOS treats CD-ROM drives as remote.
+ 
+ @subheading Return Value
+ 
+ Zero for local drives, non-zero for remote and CD-ROM drives.
+ 
+ @c -------------------------------------------------------------------
+ 
+ @node _is_remote_handle, io
+ @subheading Syntax
+ 
+ @example
+ int _is_remote_handle(int fhandle);
+ @end example
+ 
+ @subheading Description
+ 
+ Given the file handle of an open file in @var{fhandle}, this function
+ returns non-zero if the drive where that file resides is treated by DOS
+ as a remote (networked) drive, or zero otherwise.  It does so by calling
+ subfunction 0Ah of the DOS IOCTL function (interrupt 21h, AX=440Ah) and
+ looking at bit 15 of the device attribute word returned in the DX
+ register.
+ 
+ Note that DOS treats CD-ROM drives as remote.
+ 
+ @subheading Return Value
+ 
+ Zero for files on local drives, non-zero for files on remote and CD-ROM
+ drives.
+