libs/newlib-cygwin
libs
/
newlib-cygwin
mirror of git://sourceware.org/git/newlib-cygwin.git
4
0
Fork 0
Code Issues Projects Releases Wiki Activity

Cygwin: api docs: add missing fallocate 

Also add notes in terms of fallocate quirks.

Signed-off-by: Corinna Vinschen <corinna@vinschen.de>
This commit is contained in:
Corinna Vinschen 2024-01-15 11:03:48 +01:00
parent 241b50a7ab
commit 4ecfb5b729
1 changed files with 9 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

9
winsup/doc/posix.xml
View File

@ -1314,6 +1314,7 @@ also IEEE Std 1003.1-2017 (POSIX.1-2017).</para>
exp10
exp10f
exp10l
fallocate (see <xref linkend="std-notes">chapter "Implementation Notes"</xref>)
fcloseall
fcloseall_r
fedisableexcept
@ -1755,6 +1756,14 @@ RLIMIT_CORE and RLIMIT_STACK return the current values and set the requested
values.
All other resource arguments return -1 and set EINVAL.</para>
<para><function>fallocate</function> has a few Windows quirks: The
FALLOC_FL_ZERO_RANGE operation is NOT atomic. With flags set to 0 and
FALLOC_FL_KEEP_SIZE, sparse blocks in the given range are re-allocated
as per the POSIX requirements. This re-allocation operation isn't
atomic either. Over-allocation with FALLOC_FL_KEEP_SIZE is only
temporary on Windows until the last handle to the file is closed.
Over-allocation on sparse files is entirely ignored on Windows.</para>
</sect1>
</chapter>