* include/apr_file_io.h: Add APR_LARGEFILE flag, with warning.

* file_io/unix/open.c (apr_file_open): Map APR_LARGEFILE onto
O_LARGEFILE for non-LFS builds.


git-svn-id: http://svn.apache.org/repos/asf/apr/apr/trunk@65032 13f79535-47bb-0310-9956-ffa450edef68

1 files changed, 14 insertions, 0 deletions

diff --git a/include/apr_file_io.h b/include/apr_file_io.h
index dd5acb72b..86692ca7f 100644
--- a/include/apr_file_io.h
+++ b/include/apr_file_io.h
@@ -69,6 +69,20 @@ extern "C" {
                                         is opened */
 #define APR_SENDFILE_ENABLED 0x01000 /**< Advisory flag that this file should
                                           support apr_socket_sendfile operation */
+#define APR_LARGEFILE   0x04000    /**< Platform dependent flag to enable large file
+                                        support; WARNING see below. */
+
+/** @warning The APR_LARGEFILE flag only has effect on some platforms
+ * where sizeof(apr_off_t) == 4.  Where implemented, it allows opening
+ * and writing to a file which exceeds the size which can be
+ * represented by apr_off_t (2 gigabytes).  When a file's size does
+ * exceed 2Gb, apr_file_info_get() will fail with an error on the
+ * descriptor, likewise apr_stat()/apr_lstat() will fail on the
+ * filename.  apr_dir_read() will fail with APR_INCOMPLETE on a
+ * directory entry for a large file depending on the particular
+ * APR_FINFO_* flags.  Generally, it is not recommended to use this
+ * flag. */
+
 /** @} */
 
 /**