From 2d57f933c6d28b648ce1ee43b406f8697301653c Mon Sep 17 00:00:00 2001
From: Bob Haarman <inglorion@google.com>
Date: Fri, 30 Jun 2023 20:51:55 +0000
Subject: [PATCH] document that O_LARGEFILE is accepted, but now redundant

---
 src/fcntl.rs | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/src/fcntl.rs b/src/fcntl.rs
index f2957337fd..1561fa8c73 100644
--- a/src/fcntl.rs
+++ b/src/fcntl.rs
@@ -122,7 +122,10 @@ libc_bitflags!(
                   target_os = "redox"))]
         #[cfg_attr(docsrs, doc(cfg(all())))]
         O_FSYNC;
-        /// Allow files whose sizes can't be represented in an `off_t` to be opened.
+        /// On 32-bit Linux, O_LARGEFILE allows the use of file
+        /// offsets greater than 32 bits. Nix accepts the flag for
+        /// compatibility, but always opens files in large file mode
+        /// even if it isn't specified.
         #[cfg(any(target_os = "android", target_os = "linux"))]
         #[cfg_attr(docsrs, doc(cfg(all())))]
         O_LARGEFILE;