Message-Id: <5.0.2.1.0.20010201231243.027cd960@pop5.banet.net>
X-Sender: usbanet DOT farley3 AT pop5 DOT banet DOT net
X-Mailer: QUALCOMM Windows Eudora Version 5.0.2
Date: Thu, 01 Feb 2001 23:19:33 -0500
To: "Mark E." <snowball3 AT bigfoot DOT com>
From: "Peter J. Farley III" <pjfarley AT banet DOT net>
Subject: Re: Finished
Cc: djgpp-workers AT delorie DOT com
In-Reply-To: <3A79C51C.13324.2C69B2@localhost>
Mime-Version: 1.0
Content-Type: multipart/mixed;
	boundary="=====================_8990059==_"
Reply-To: djgpp-workers AT delorie DOT com
Errors-To: nobody AT delorie DOT com
X-Mailing-List: djgpp-workers AT delorie DOT com
X-Unsubscribes-To: listserv AT delorie DOT com
Precedence: bulk

--=====================_8990059==_
Content-Type: text/plain; charset="us-ascii"; format=flowed

Here are the diffs for the missing doc files for the *64 lock/unlock 
functions.  I had a little time this evening, and it was easier than I 
thought it would be to craft them out of the existing docs.

--=====================_8990059==_
Content-Type: text/plain; charset="us-ascii"

diff -ruN djgpp-cvs/src/libc/dos/io/doslk64.txh djgpp/src/libc/dos/io/doslk64.txh
--- djgpp-cvs/src/libc/dos/io/doslk64.txh	Thu Jan  1 00:00:00 1970
+++ djgpp/src/libc/dos/io/doslk64.txh	Thu Feb  1 23:00:14 2001
@@ -0,0 +1,28 @@
+@node _dos_lk64, dos
+@subheading Syntax
+
+@example
+#include <io.h>
+
+int _dos_lk64(int _fd, long long _offset, long long _length)
+@end example
+
+@subheading Description
+
+Adds an advisory lock to the specified region of the file.
+
+Arguments @var{_offset} and @var{_length} must be of type @code{long
+long}, thus enabling you to lock with offsets and lengths as large as
+~@math{2^63} (FAT16 limits this to ~@math{2^31}; FAT32 limits this to
+@math{2^32-2}).
+
+@xref{_dos_unlk64}.
+
+@subheading Return Value
+
+Zero if the lock was added, nonzero otherwise.
+
+@subheading Portability
+
+@portability !ansi, !posix
+
diff -ruN djgpp-cvs/src/libc/dos/io/dosunl64.txh djgpp/src/libc/dos/io/dosunl64.txh
--- djgpp-cvs/src/libc/dos/io/dosunl64.txh	Thu Jan  1 00:00:00 1970
+++ djgpp/src/libc/dos/io/dosunl64.txh	Thu Feb  1 23:00:14 2001
@@ -0,0 +1,28 @@
+@node _dos_unlk64, dos
+@subheading Syntax
+
+@example
+#include <io.h>
+
+int _dos_unlk64(int _fd, long long _offset, long long _length)
+@end example
+
+@subheading Description
+
+Removes an advisory lock to the specified region of the file.
+
+Arguments @var{_offset} and @var{_length} must be of type @code{long
+long}, thus enabling you to unlock with offsets and lengths as large as
+~@math{2^63} (FAT16 limits this to ~@math{2^31}; FAT32 limits this to
+@math{2^32-2}).
+
+@xref{_dos_lk64}.
+
+@subheading Return Value
+
+Zero if the lock was removed, nonzero otherwise.
+
+@subheading Portability
+
+@portability !ansi, !posix
+
diff -ruN djgpp-cvs/src/libc/dos/io/lock64.txh djgpp/src/libc/dos/io/lock64.txh
--- djgpp-cvs/src/libc/dos/io/lock64.txh	Thu Jan  1 00:00:00 1970
+++ djgpp/src/libc/dos/io/lock64.txh	Thu Feb  1 23:00:16 2001
@@ -0,0 +1,35 @@
+@node lock64, io
+@subheading Syntax
+
+@example
+#include <io.h>
+
+int lock64(int fd, long long offset, long long length)
+@end example
+
+@subheading Description
+Locks a region in file @var{fd} using MS-DOS file sharing interface.
+The region of @var{length} bytes, starting from @var{offset}, will
+become entirely inaccessible to other processes. If multiple locks
+are used on a single file they must be non-overlapping. The lock
+must be removed before the file is closed.
+
+This function will fail unless SHARE, or a network software
+providing similar interface, is installed. This function is
+compatible with Borland C++ function of the same name.
+
+Arguments @var{offset} and @var{length} must be of type @code{long
+long}, thus enabling you to lock with offsets and lengths as large as
+~@math{2^63} (FAT16 limits this to ~@math{2^31}; FAT32 limits this to
+@math{2^32-2}).
+
+@xref{unlock64}.
+
+@subheading Return Value
+Zero if successful, nonzero if not.
+
+
+@subheading Portability
+
+@portability !ansi, !posix
+
diff -ruN djgpp-cvs/src/libc/dos/io/unlock64.txh djgpp/src/libc/dos/io/unlock64.txh
--- djgpp-cvs/src/libc/dos/io/unlock64.txh	Thu Jan  1 00:00:00 1970
+++ djgpp/src/libc/dos/io/unlock64.txh	Thu Feb  1 23:02:30 2001
@@ -0,0 +1,27 @@
+@node unlock64, io
+@subheading Syntax
+
+@example
+#include <io.h>
+
+int unlock64(int fd, long long offset, long long length)
+@end example
+
+@subheading Description
+Unlocks a region previously locked by @code{lock64}.
+
+Arguments @var{offset} and @var{length} must be of type @code{long
+long}, thus enabling you to unlock with offsets and lengths as large as
+~@math{2^63} (FAT16 limits this to ~@math{2^31}; FAT32 limits this to
+@math{2^32-2}).
+
+@xref{lock64}.
+
+@subheading Return Value
+Zero if successful, nonzero if not.
+
+
+@subheading Portability
+
+@portability !ansi, !posix
+

--=====================_8990059==_
Content-Type: text/plain; charset="us-ascii"; format=flowed

---------------------------------------------------------
Peter J. Farley III (pjfarley AT dorsai DOT org OR
                      pjfarley AT banet DOT net)
--=====================_8990059==_--