Apache HTTPD
Macros
File Open Flags/Routines

Macros

#define APR_FOPEN_READ   0x00001
 
#define APR_FOPEN_WRITE   0x00002
 
#define APR_FOPEN_CREATE   0x00004
 
#define APR_FOPEN_APPEND   0x00008
 
#define APR_FOPEN_TRUNCATE   0x00010
 
#define APR_FOPEN_BINARY   0x00020
 
#define APR_FOPEN_EXCL   0x00040
 
#define APR_FOPEN_BUFFERED   0x00080
 
#define APR_FOPEN_DELONCLOSE   0x00100
 
#define APR_FOPEN_XTHREAD   0x00200
 
#define APR_FOPEN_SHARELOCK   0x00400
 
#define APR_FOPEN_NOCLEANUP   0x00800
 
#define APR_FOPEN_SENDFILE_ENABLED   0x01000
 
#define APR_FOPEN_LARGEFILE   0x04000
 
#define APR_FOPEN_SPARSE   0x08000
 
#define APR_FOPEN_NONBLOCK   0x40000
 
#define APR_READ   APR_FOPEN_READ
 
#define APR_WRITE   APR_FOPEN_WRITE
 
#define APR_CREATE   APR_FOPEN_CREATE
 
#define APR_APPEND   APR_FOPEN_APPEND
 
#define APR_TRUNCATE   APR_FOPEN_TRUNCATE
 
#define APR_BINARY   APR_FOPEN_BINARY
 
#define APR_EXCL   APR_FOPEN_EXCL
 
#define APR_BUFFERED   APR_FOPEN_BUFFERED
 
#define APR_DELONCLOSE   APR_FOPEN_DELONCLOSE
 
#define APR_XTHREAD   APR_FOPEN_XTHREAD
 
#define APR_SHARELOCK   APR_FOPEN_SHARELOCK
 
#define APR_FILE_NOCLEANUP   APR_FOPEN_NOCLEANUP
 
#define APR_SENDFILE_ENABLED   APR_FOPEN_SENDFILE_ENABLED
 
#define APR_LARGEFILE   APR_FOPEN_LARGEFILE
 

Detailed Description

Macro Definition Documentation

◆ APR_APPEND

#define APR_APPEND   APR_FOPEN_APPEND
Deprecated:
See also
APR_FOPEN_APPEND

Definition at line 96 of file apr_file_io.h.

◆ APR_BINARY

#define APR_BINARY   APR_FOPEN_BINARY
Deprecated:
See also
APR_FOPEN_BINARY

Definition at line 98 of file apr_file_io.h.

◆ APR_BUFFERED

#define APR_BUFFERED   APR_FOPEN_BUFFERED
Deprecated:
See also
APR_FOPEN_BUFFERED

Definition at line 100 of file apr_file_io.h.

◆ APR_CREATE

#define APR_CREATE   APR_FOPEN_CREATE
Deprecated:
See also
APR_FOPEN_CREATE

Definition at line 95 of file apr_file_io.h.

◆ APR_DELONCLOSE

#define APR_DELONCLOSE   APR_FOPEN_DELONCLOSE
Deprecated:
See also
APR_FOPEN_DELONCLOSE

Definition at line 101 of file apr_file_io.h.

◆ APR_EXCL

#define APR_EXCL   APR_FOPEN_EXCL
Deprecated:
See also
APR_FOPEN_EXCL

Definition at line 99 of file apr_file_io.h.

◆ APR_FILE_NOCLEANUP

#define APR_FILE_NOCLEANUP   APR_FOPEN_NOCLEANUP
Deprecated:
See also
APR_FOPEN_NOCLEANUP

Definition at line 104 of file apr_file_io.h.

◆ APR_FOPEN_APPEND

#define APR_FOPEN_APPEND   0x00008

Append to the end of the file

Definition at line 57 of file apr_file_io.h.

◆ APR_FOPEN_BINARY

#define APR_FOPEN_BINARY   0x00020

Open the file in binary mode (This flag is ignored on UNIX because it has no meaning)

Definition at line 62 of file apr_file_io.h.

◆ APR_FOPEN_BUFFERED

#define APR_FOPEN_BUFFERED   0x00080

Open the file for buffered I/O

Definition at line 65 of file apr_file_io.h.

◆ APR_FOPEN_CREATE

#define APR_FOPEN_CREATE   0x00004

Create the file if not there

Definition at line 56 of file apr_file_io.h.

◆ APR_FOPEN_DELONCLOSE

#define APR_FOPEN_DELONCLOSE   0x00100

Delete the file after close

Definition at line 66 of file apr_file_io.h.

◆ APR_FOPEN_EXCL

#define APR_FOPEN_EXCL   0x00040

Open should fail if APR_FOPEN_CREATE and file exists.

Definition at line 64 of file apr_file_io.h.

◆ APR_FOPEN_LARGEFILE

#define APR_FOPEN_LARGEFILE   0x04000

Platform dependent flag to enable large file support, see WARNING below

Warning
APR_FOPEN_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.

Definition at line 84 of file apr_file_io.h.

◆ APR_FOPEN_NOCLEANUP

#define APR_FOPEN_NOCLEANUP   0x00800

Do not register a cleanup when the file is opened. The apr_os_file_t handle in apr_file_t will not be closed when the pool is destroyed.

Definition at line 78 of file apr_file_io.h.

◆ APR_FOPEN_NONBLOCK

#define APR_FOPEN_NONBLOCK   0x40000

Platform dependent flag to enable non blocking file io

Warning
APR_FOPEN_NONBLOCK is not implemented on all platforms. Callers should be prepared for it to fail with APR_ENOTIMPL.

Definition at line 89 of file apr_file_io.h.

◆ APR_FOPEN_READ

#define APR_FOPEN_READ   0x00001

Open the file for reading

Definition at line 54 of file apr_file_io.h.

◆ APR_FOPEN_SENDFILE_ENABLED

#define APR_FOPEN_SENDFILE_ENABLED   0x01000

Advisory flag that this file should support apr_socket_sendfile operation

Definition at line 81 of file apr_file_io.h.

◆ APR_FOPEN_SHARELOCK

#define APR_FOPEN_SHARELOCK   0x00400

Platform dependent support for higher level locked read/write access to support writes across process/machines

Definition at line 73 of file apr_file_io.h.

◆ APR_FOPEN_SPARSE

#define APR_FOPEN_SPARSE   0x08000

Platform dependent flag to enable sparse file support, see WARNING below

Warning
APR_FOPEN_SPARSE may, depending on platform, convert a normal file to a sparse file. Some applications may be unable to decipher a sparse file, so it's critical that the sparse file flag should only be used for files accessed only by APR or other applications known to be able to decipher them. APR does not guarantee that it will compress the file into sparse segments if it was previously created and written without the sparse flag. On platforms which do not understand, or on file systems which cannot handle sparse files, the flag is ignored by apr_file_open().

Definition at line 87 of file apr_file_io.h.

◆ APR_FOPEN_TRUNCATE

#define APR_FOPEN_TRUNCATE   0x00010

Open the file and truncate to 0 length

Definition at line 59 of file apr_file_io.h.

◆ APR_FOPEN_WRITE

#define APR_FOPEN_WRITE   0x00002

Open the file for writing

Definition at line 55 of file apr_file_io.h.

◆ APR_FOPEN_XTHREAD

#define APR_FOPEN_XTHREAD   0x00200

Platform dependent tag to open the file for use across multiple threads

Definition at line 69 of file apr_file_io.h.

◆ APR_LARGEFILE

#define APR_LARGEFILE   APR_FOPEN_LARGEFILE
Deprecated:
See also
APR_FOPEN_LARGEFILE

Definition at line 106 of file apr_file_io.h.

◆ APR_READ

#define APR_READ   APR_FOPEN_READ
Deprecated:
See also
APR_FOPEN_READ

Definition at line 93 of file apr_file_io.h.

◆ APR_SENDFILE_ENABLED

#define APR_SENDFILE_ENABLED   APR_FOPEN_SENDFILE_ENABLED
Deprecated:
See also
APR_FOPEN_SENDFILE_ENABLED

Definition at line 105 of file apr_file_io.h.

◆ APR_SHARELOCK

#define APR_SHARELOCK   APR_FOPEN_SHARELOCK
Deprecated:
See also
APR_FOPEN_SHARELOCK

Definition at line 103 of file apr_file_io.h.

◆ APR_TRUNCATE

#define APR_TRUNCATE   APR_FOPEN_TRUNCATE
Deprecated:
See also
APR_FOPEN_TRUNCATE

Definition at line 97 of file apr_file_io.h.

◆ APR_WRITE

#define APR_WRITE   APR_FOPEN_WRITE
Deprecated:
See also
APR_FOPEN_WRITE

Definition at line 94 of file apr_file_io.h.

◆ APR_XTHREAD

#define APR_XTHREAD   APR_FOPEN_XTHREAD
Deprecated:
See also
APR_FOPEN_XTHREAD

Definition at line 102 of file apr_file_io.h.