blob: f27efdf1d6456160ea4a78c7959dc1dc7c153f5f [file] [log] [blame]
The Android Open Source Project1dc9e472009-03-03 19:28:35 -08001/*
2 * Copyright (C) 2008 The Android Open Source Project
3 * All rights reserved.
4 *
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions
7 * are met:
8 * * Redistributions of source code must retain the above copyright
9 * notice, this list of conditions and the following disclaimer.
10 * * Redistributions in binary form must reproduce the above copyright
11 * notice, this list of conditions and the following disclaimer in
12 * the documentation and/or other materials provided with the
13 * distribution.
14 *
15 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
16 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
17 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
18 * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
19 * COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
20 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
21 * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
22 * OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
23 * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
24 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
25 * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
26 * SUCH DAMAGE.
27 */
Elliott Hughese9893992013-10-17 11:45:22 -070028
The Android Open Source Project1dc9e472009-03-03 19:28:35 -080029#ifndef _FCNTL_H
30#define _FCNTL_H
31
32#include <sys/cdefs.h>
33#include <sys/types.h>
Elliott Hughes01e505a2014-01-07 17:47:20 -080034#include <linux/fadvise.h>
Nick Desaulniers09d900d2016-07-19 15:20:24 -070035#include <linux/falloc.h>
The Android Open Source Project1dc9e472009-03-03 19:28:35 -080036#include <linux/fcntl.h>
Elliott Hughes64d83822014-12-29 11:14:38 -080037#include <linux/stat.h>
Elliott Hughes3f525d42014-06-24 16:32:01 -070038#include <linux/uio.h>
The Android Open Source Project1dc9e472009-03-03 19:28:35 -080039
Josh Gaoee8d1692016-04-07 14:16:30 -070040#include <bits/fcntl.h>
Elliott Hughesfd936ae2016-08-12 10:16:34 -070041#include <bits/seek_constants.h>
Josh Gaoee8d1692016-04-07 14:16:30 -070042
Elliott Hughes5704c422016-01-25 18:06:24 -080043#if defined(__USE_GNU) || defined(__USE_BSD)
44#include <bits/lockf.h>
45#endif
46
The Android Open Source Project1dc9e472009-03-03 19:28:35 -080047__BEGIN_DECLS
48
Serban Constantinescu48501af2014-03-14 13:16:25 +000049#ifdef __LP64__
Christopher Ferrisba8d4f42014-09-03 19:56:49 -070050/* LP64 kernels don't have F_*64 defines because their flock is 64-bit. */
Serban Constantinescu48501af2014-03-14 13:16:25 +000051#define F_GETLK64 F_GETLK
52#define F_SETLK64 F_SETLK
53#define F_SETLKW64 F_SETLKW
54#endif
55
Elliott Hughes3f525d42014-06-24 16:32:01 -070056#define O_ASYNC FASYNC
Elliott Hughes31165ed2014-09-23 17:34:29 -070057#define O_RSYNC O_SYNC
Elliott Hughes3f525d42014-06-24 16:32:01 -070058
Elliott Hughes9d250722017-07-05 15:59:58 -070059#if __ANDROID_API__ >= __ANDROID_API_L__
Elliott Hughes3f525d42014-06-24 16:32:01 -070060#define SPLICE_F_MOVE 1
61#define SPLICE_F_NONBLOCK 2
62#define SPLICE_F_MORE 4
63#define SPLICE_F_GIFT 8
Elliott Hughes9d250722017-07-05 15:59:58 -070064#endif
The Android Open Source Project1dc9e472009-03-03 19:28:35 -080065
Elliott Hughes9d250722017-07-05 15:59:58 -070066#if __ANDROID_API__ >= __ANDROID_API_O__
Elliott Hughes34347272014-02-26 11:10:32 -080067#define SYNC_FILE_RANGE_WAIT_BEFORE 1
68#define SYNC_FILE_RANGE_WRITE 2
69#define SYNC_FILE_RANGE_WAIT_AFTER 4
Elliott Hughes9d250722017-07-05 15:59:58 -070070#endif
Elliott Hughes34347272014-02-26 11:10:32 -080071
Elliott Hughes3b2096a2016-07-22 18:57:12 -070072int creat(const char*, mode_t);
73int creat64(const char*, mode_t) __INTRODUCED_IN(21);
Elliott Hughes7c5a8512017-07-20 10:00:28 -070074int openat(int, const char*, int, ...) __overloadable __RENAME_CLANG(openat);
Elliott Hughes3b2096a2016-07-22 18:57:12 -070075int openat64(int, const char*, int, ...) __INTRODUCED_IN(21);
George Burgess IV7cc779f2017-02-09 00:00:31 -080076int open(const char*, int, ...) __overloadable __RENAME_CLANG(open);
Elliott Hughes3b2096a2016-07-22 18:57:12 -070077int open64(const char*, int, ...) __INTRODUCED_IN(21);
78ssize_t splice(int, off64_t*, int, off64_t*, size_t, unsigned int) __INTRODUCED_IN(21);
79ssize_t tee(int, int, size_t, unsigned int) __INTRODUCED_IN(21);
80ssize_t vmsplice(int, const struct iovec*, size_t, unsigned int) __INTRODUCED_IN(21);
The Android Open Source Project1dc9e472009-03-03 19:28:35 -080081
Elliott Hughes7c5a8512017-07-20 10:00:28 -070082int fallocate(int, int, off_t, off_t) __RENAME_IF_FILE_OFFSET64(fallocate64) __INTRODUCED_IN(21);
Elliott Hughes3b2096a2016-07-22 18:57:12 -070083int fallocate64(int, int, off64_t, off64_t) __INTRODUCED_IN(21);
Elliott Hughes7c5a8512017-07-20 10:00:28 -070084int posix_fadvise(int, off_t, off_t, int) __RENAME_IF_FILE_OFFSET64(posix_fadvise64) __INTRODUCED_IN(21);
Elliott Hughes3b2096a2016-07-22 18:57:12 -070085int posix_fadvise64(int, off64_t, off64_t, int) __INTRODUCED_IN(21);
Elliott Hughes7c5a8512017-07-20 10:00:28 -070086int posix_fallocate(int, off_t, off_t) __RENAME_IF_FILE_OFFSET64(posix_fallocate64) __INTRODUCED_IN(21);
Elliott Hughes3b2096a2016-07-22 18:57:12 -070087int posix_fallocate64(int, off64_t, off64_t) __INTRODUCED_IN(21);
Elliott Hughes68dc20d2015-02-06 22:28:49 -080088
Elliott Hughes55147ad2016-04-05 11:06:02 -070089#if defined(__USE_GNU)
Josh Gao46b44162016-05-27 11:14:16 -070090ssize_t readahead(int, off64_t, size_t) __INTRODUCED_IN(16);
Josh Gao2e8e5e62017-04-20 12:58:31 -070091int sync_file_range(int, off64_t, off64_t, unsigned int) __INTRODUCED_IN(26);
Elliott Hughes55147ad2016-04-05 11:06:02 -070092#endif
93
Elliott Hughes3b2096a2016-07-22 18:57:12 -070094int __open_2(const char*, int) __INTRODUCED_IN(17);
Elliott Hughes3b2096a2016-07-22 18:57:12 -070095int __openat_2(int, const char*, int) __INTRODUCED_IN(17);
George Burgess IV7cc779f2017-02-09 00:00:31 -080096/*
97 * These are the easiest way to call the real open even in clang FORTIFY.
98 */
99int __open_real(const char*, int, ...) __RENAME(open);
Elliott Hughes3b2096a2016-07-22 18:57:12 -0700100int __openat_real(int, const char*, int, ...) __RENAME(openat);
George Burgess IV7cc779f2017-02-09 00:00:31 -0800101
Elliott Hughescd0609f2013-12-19 12:21:07 -0800102
Dan Albert658727e2014-10-07 11:10:36 -0700103#if defined(__BIONIC_FORTIFY)
George Burgess IV7cc779f2017-02-09 00:00:31 -0800104#define __open_too_many_args_error "too many arguments"
105#define __open_too_few_args_error "called with O_CREAT, but missing mode"
106#if defined(__clang__)
Dan Albert658727e2014-10-07 11:10:36 -0700107
Dan Albert9c2094f2017-02-14 19:28:18 -0800108#if __ANDROID_API__ >= __ANDROID_API_J_MR1__
George Burgess IV7cc779f2017-02-09 00:00:31 -0800109__BIONIC_ERROR_FUNCTION_VISIBILITY
110int open(const char* pathname, int flags, mode_t modes, ...) __overloadable
111 __errorattr(__open_too_many_args_error);
112
113__BIONIC_ERROR_FUNCTION_VISIBILITY
114int open(const char* pathname, int flags) __overloadable
115 __enable_if(flags & O_CREAT, __open_too_few_args_error)
116 __errorattr(__open_too_few_args_error);
117
118/*
119 * pass_object_size serves two purposes here, neither of which involve __bos: it
120 * disqualifies this function from having its address taken (so &open works),
121 * and it makes overload resolution prefer open(const char *, int) over
122 * open(const char *, int, ...).
123 */
124__BIONIC_FORTIFY_INLINE
125int open(const char* const __pass_object_size pathname,
126 int flags) __overloadable {
127 return __open_2(pathname, flags);
128}
129
130__BIONIC_FORTIFY_INLINE
131int open(const char* const __pass_object_size pathname, int flags, mode_t modes)
132 __overloadable {
133 return __open_real(pathname, flags, modes);
134}
135
136__BIONIC_ERROR_FUNCTION_VISIBILITY
137int openat(int dirfd, const char* pathname, int flags) __overloadable
138 __enable_if(flags & O_CREAT, __open_too_few_args_error)
139 __errorattr(__open_too_few_args_error);
140
141__BIONIC_ERROR_FUNCTION_VISIBILITY
142int openat(int dirfd, const char* pathname, int flags, mode_t modes, ...)
143 __overloadable
144 __errorattr(__open_too_many_args_error);
145
146__BIONIC_FORTIFY_INLINE
147int openat(int dirfd, const char* const __pass_object_size pathname,
148 int flags) __overloadable {
149 return __openat_2(dirfd, pathname, flags);
150}
151
152__BIONIC_FORTIFY_INLINE
153int openat(int dirfd, const char* const __pass_object_size pathname, int flags,
154 mode_t modes) __overloadable {
155 return __openat_real(dirfd, pathname, flags, modes);
156}
Dan Albert9c2094f2017-02-14 19:28:18 -0800157#endif /* __ANDROID_API__ >= __ANDROID_API_J_MR1__ */
George Burgess IV7cc779f2017-02-09 00:00:31 -0800158
159#else /* defined(__clang__) */
160__errordecl(__creat_missing_mode, __open_too_few_args_error);
161__errordecl(__creat_too_many_args, __open_too_many_args_error);
Nick Kralevich8118f622012-06-26 15:08:06 -0700162
Dan Albert9c2094f2017-02-14 19:28:18 -0800163#if __ANDROID_API__ >= __ANDROID_API_J_MR1__
Nick Kralevich8118f622012-06-26 15:08:06 -0700164__BIONIC_FORTIFY_INLINE
Elliott Hughescd0609f2013-12-19 12:21:07 -0800165int open(const char* pathname, int flags, ...) {
Nick Kralevich8118f622012-06-26 15:08:06 -0700166 if (__builtin_constant_p(flags)) {
167 if ((flags & O_CREAT) && __builtin_va_arg_pack_len() == 0) {
Elliott Hughes3ba55f82016-06-08 18:11:23 -0700168 __creat_missing_mode(); /* Compile time error. */
Nick Kralevich8118f622012-06-26 15:08:06 -0700169 }
170 }
171
172 if (__builtin_va_arg_pack_len() > 1) {
Elliott Hughes3ba55f82016-06-08 18:11:23 -0700173 __creat_too_many_args(); /* Compile time error. */
Nick Kralevich8118f622012-06-26 15:08:06 -0700174 }
175
Nick Kralevicha3e230d2012-07-02 12:24:42 -0700176 if ((__builtin_va_arg_pack_len() == 0) && !__builtin_constant_p(flags)) {
Nick Kralevich8118f622012-06-26 15:08:06 -0700177 return __open_2(pathname, flags);
178 }
179
180 return __open_real(pathname, flags, __builtin_va_arg_pack());
181}
182
Nick Kralevicha3e230d2012-07-02 12:24:42 -0700183__BIONIC_FORTIFY_INLINE
Elliott Hughescd0609f2013-12-19 12:21:07 -0800184int openat(int dirfd, const char* pathname, int flags, ...) {
Nick Kralevicha3e230d2012-07-02 12:24:42 -0700185 if (__builtin_constant_p(flags)) {
186 if ((flags & O_CREAT) && __builtin_va_arg_pack_len() == 0) {
Elliott Hughes3ba55f82016-06-08 18:11:23 -0700187 __creat_missing_mode(); /* Compile time error. */
Nick Kralevicha3e230d2012-07-02 12:24:42 -0700188 }
189 }
190
191 if (__builtin_va_arg_pack_len() > 1) {
Elliott Hughes3ba55f82016-06-08 18:11:23 -0700192 __creat_too_many_args(); /* Compile time error. */
Nick Kralevicha3e230d2012-07-02 12:24:42 -0700193 }
194
195 if ((__builtin_va_arg_pack_len() == 0) && !__builtin_constant_p(flags)) {
196 return __openat_2(dirfd, pathname, flags);
197 }
198
199 return __openat_real(dirfd, pathname, flags, __builtin_va_arg_pack());
200}
Dan Albert9c2094f2017-02-14 19:28:18 -0800201#endif /* __ANDROID_API__ >= __ANDROID_API_J_MR1__ */
Nick Kralevicha3e230d2012-07-02 12:24:42 -0700202
George Burgess IV7cc779f2017-02-09 00:00:31 -0800203#endif /* defined(__clang__) */
Elliott Hughescd0609f2013-12-19 12:21:07 -0800204
George Burgess IV7cc779f2017-02-09 00:00:31 -0800205#undef __open_too_many_args_error
206#undef __open_too_few_args_error
Elliott Hughescd0609f2013-12-19 12:21:07 -0800207#endif /* defined(__BIONIC_FORTIFY) */
Nick Kralevich8118f622012-06-26 15:08:06 -0700208
The Android Open Source Project1dc9e472009-03-03 19:28:35 -0800209__END_DECLS
210
211#endif /* _FCNTL_H */