Home | History | Annotate | Download | only in sys
      1 /*
      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  */
     28 
     29 #ifndef _SYS_MMAN_H_
     30 #define _SYS_MMAN_H_
     31 
     32 #include <sys/cdefs.h>
     33 #include <sys/types.h>
     34 #include <asm/mman.h>
     35 
     36 __BEGIN_DECLS
     37 
     38 #ifndef MAP_ANON
     39 #define MAP_ANON  MAP_ANONYMOUS
     40 #endif
     41 
     42 #define MAP_FAILED __BIONIC_CAST(reinterpret_cast, void*, -1)
     43 
     44 #define MREMAP_MAYMOVE  1
     45 #define MREMAP_FIXED    2
     46 
     47 /*
     48  * See https://android.googlesource.com/platform/bionic/+/master/docs/32-bit-abi.md
     49  *
     50  * mmap64 wasn't really around until L, but we added an inline for it since it
     51  * allows a lot more code to compile with _FILE_OFFSET_BITS=64.
     52  *
     53  * GCC removes the static inline unless it is explicitly used. We can get around
     54  * this with __attribute__((used)), but that needlessly adds a definition of
     55  * mmap64 to every translation unit that includes this header. Instead, just
     56  * preserve the old behavior for GCC and emit a useful diagnostic.
     57  */
     58 #if defined(__USE_FILE_OFFSET64)
     59 void* mmap(void* __addr, size_t __size, int __prot, int __flags, int __fd, off_t __offset)
     60 #  if !defined(__clang__) && __ANDROID_API__ < __ANDROID_API_L__
     61       __attribute__((error("mmap is not available with _FILE_OFFSET_BITS=64 when using GCC until "
     62                            "android-21. Either raise your minSdkVersion, disable "
     63                            "_FILE_OFFSET_BITS=64, or switch to Clang.")));
     64 #  else
     65     __RENAME(mmap64);
     66 #  endif
     67 #else
     68 void* mmap(void* __addr, size_t __size, int __prot, int __flags, int __fd, off_t __offset);
     69 #endif
     70 
     71 #if __ANDROID_API__ >= __ANDROID_API_L__
     72 void* mmap64(void* __addr, size_t __size, int __prot, int __flags, int __fd, off64_t __offset) __INTRODUCED_IN(21);
     73 #endif
     74 
     75 int munmap(void* __addr, size_t __size);
     76 int msync(void* __addr, size_t __size, int __flags);
     77 int mprotect(void* __addr, size_t __size, int __prot);
     78 void* mremap(void* __old_addr, size_t __old_size, size_t __new_size, int __flags, ...);
     79 
     80 int mlockall(int __flags) __INTRODUCED_IN(17);
     81 int munlockall(void) __INTRODUCED_IN(17);
     82 
     83 int mlock(const void* __addr, size_t __size);
     84 int munlock(const void* __addr, size_t __size);
     85 
     86 int mincore(void* __addr, size_t __size, unsigned char* __vector);
     87 
     88 int madvise(void* __addr, size_t __size, int __advice);
     89 
     90 #if __ANDROID_API__ >= __ANDROID_API_M__
     91 /*
     92  * Some third-party code uses the existence of POSIX_MADV_NORMAL to detect the
     93  * availability of posix_madvise. This is not correct, since having up-to-date
     94  * UAPI headers says nothing about the C library, but for the time being we
     95  * don't want to harm adoption of the unified headers.
     96  *
     97  * https://github.com/android-ndk/ndk/issues/395
     98  */
     99 #define POSIX_MADV_NORMAL     MADV_NORMAL
    100 #define POSIX_MADV_RANDOM     MADV_RANDOM
    101 #define POSIX_MADV_SEQUENTIAL MADV_SEQUENTIAL
    102 #define POSIX_MADV_WILLNEED   MADV_WILLNEED
    103 #define POSIX_MADV_DONTNEED   MADV_DONTNEED
    104 #endif
    105 int posix_madvise(void* __addr, size_t __size, int __advice) __INTRODUCED_IN(23);
    106 
    107 __END_DECLS
    108 
    109 #include <android/legacy_sys_mman_inlines.h>
    110 
    111 #endif
    112