194 lines
6.7 KiB
C
194 lines
6.7 KiB
C
/****************************************************************************
|
|
* include/android/fdsan.h
|
|
*
|
|
* SPDX-License-Identifier: BSD-2-Clause
|
|
* SPDX-FileCopyrightText: 2018 The Android Open Source Project
|
|
*
|
|
* All rights reserved.
|
|
*
|
|
* Redistribution and use in source and binary forms, with or without
|
|
* modification, are permitted provided that the following conditions
|
|
* are met:
|
|
* * Redistributions of source code must retain the above copyright
|
|
* notice, this list of conditions and the following disclaimer.
|
|
* * Redistributions in binary form must reproduce the above copyright
|
|
* notice, this list of conditions and the following disclaimer in
|
|
* the documentation and/or other materials provided with the
|
|
* distribution.
|
|
*
|
|
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
|
|
* "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
|
|
* LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
|
|
* FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
|
|
* COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
|
|
* INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
|
|
* BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
|
|
* OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
|
|
* AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
|
|
* OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
|
|
* OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
|
|
* SUCH DAMAGE.
|
|
****************************************************************************/
|
|
|
|
#ifndef __INCLUDE_ANDROID_FDSAN_H
|
|
#define __INCLUDE_ANDROID_FDSAN_H
|
|
|
|
/****************************************************************************
|
|
* Included Files
|
|
****************************************************************************/
|
|
|
|
#include <stdbool.h>
|
|
#include <stdint.h>
|
|
|
|
/****************************************************************************
|
|
* Pre-processor Definitions
|
|
****************************************************************************/
|
|
|
|
/****************************************************************************
|
|
* Error checking for close(2).
|
|
*
|
|
* Mishandling of file descriptor ownership is a common source of errors that
|
|
* can be extremely difficult to diagnose. Mistakes like the following can
|
|
* result in seemingly 'impossible' failures showing up on other threads that
|
|
* happened to try to open a file descriptor
|
|
* between the buggy code's close and fclose:
|
|
*
|
|
* int print(int fd) {
|
|
* int rc;
|
|
* char buf[128];
|
|
* while ((rc = read(fd, buf, sizeof(buf))) > 0) {
|
|
* printf("%.*s", rc);
|
|
* }
|
|
* close(fd);
|
|
* }
|
|
*
|
|
* int bug() {
|
|
* FILE* f = fopen("foo", "r");
|
|
* print(fileno(f));
|
|
* fclose(f);
|
|
* }
|
|
*
|
|
* To make it easier to find this class of bugs, bionic provides a method to
|
|
* require that file descriptors are closed by their owners. File descriptors
|
|
* can be associated with tags with which they must be closed. This allows
|
|
* objects that conceptually own an fd (FILE*, unique_fd, etc.) to use their
|
|
* own address at the tag, to enforce that closure of the fd must come as a
|
|
* result of their own destruction (fclose, ~unique_fd, etc.)
|
|
*
|
|
* By default, a file descriptor's tag is 0, and close(fd) is equivalent to
|
|
* closing fd with the tag 0.
|
|
****************************************************************************/
|
|
|
|
/****************************************************************************
|
|
* For improved diagnostics, the type of a file descriptors owner can be
|
|
* encoded in the most significant byte of the owner tag. Values of 0 and
|
|
* 0xff are ignored, which allows for raw pointers to be used as owner tags
|
|
* without modification.
|
|
****************************************************************************/
|
|
|
|
#ifdef __cplusplus
|
|
#define EXTERN extern "C"
|
|
extern "C"
|
|
{
|
|
#else
|
|
#define EXTERN extern
|
|
#endif
|
|
|
|
enum android_fdsan_owner_type
|
|
{
|
|
/**************************************************************************
|
|
* Generic Java or native owners.
|
|
*
|
|
* Generic Java objects always use 255 as their type, using
|
|
* identityHashCode as the value of the tag, leaving bits 33-56 unset.
|
|
* Native pointers are sign extended from 48-bits of virtual address space,
|
|
* and so can have the MSB set to 255 as well. Use the value of bits 49-56
|
|
* to distinguish between these cases.
|
|
**************************************************************************/
|
|
|
|
ANDROID_FDSAN_OWNER_TYPE_GENERIC_00 = 0,
|
|
ANDROID_FDSAN_OWNER_TYPE_GENERIC_FF = 255,
|
|
|
|
/* FILE* */
|
|
|
|
ANDROID_FDSAN_OWNER_TYPE_FILE = 1,
|
|
|
|
/* DIR* */
|
|
|
|
ANDROID_FDSAN_OWNER_TYPE_DIR = 2,
|
|
|
|
/* android::base::unique_fd */
|
|
|
|
ANDROID_FDSAN_OWNER_TYPE_UNIQUE_FD = 3,
|
|
|
|
/* sqlite-owned file descriptors */
|
|
|
|
ANDROID_FDSAN_OWNER_TYPE_SQLITE = 4,
|
|
|
|
/* java.io.FileInputStream */
|
|
|
|
ANDROID_FDSAN_OWNER_TYPE_FILEINPUTSTREAM = 5,
|
|
|
|
/* java.io.FileOutputStream */
|
|
|
|
ANDROID_FDSAN_OWNER_TYPE_FILEOUTPUTSTREAM = 6,
|
|
|
|
/* java.io.RandomAccessFile */
|
|
|
|
ANDROID_FDSAN_OWNER_TYPE_RANDOMACCESSFILE = 7,
|
|
|
|
/* android.os.ParcelFileDescriptor */
|
|
|
|
ANDROID_FDSAN_OWNER_TYPE_PARCELFILEDESCRIPTOR = 8,
|
|
|
|
/* ART FdFile */
|
|
|
|
ANDROID_FDSAN_OWNER_TYPE_ART_FDFILE = 9,
|
|
|
|
/* java.net.DatagramSocketImpl */
|
|
|
|
ANDROID_FDSAN_OWNER_TYPE_DATAGRAMSOCKETIMPL = 10,
|
|
|
|
/* java.net.SocketImpl */
|
|
|
|
ANDROID_FDSAN_OWNER_TYPE_SOCKETIMPL = 11,
|
|
|
|
/* libziparchive's ZipArchive */
|
|
|
|
ANDROID_FDSAN_OWNER_TYPE_ZIPARCHIVE = 12,
|
|
};
|
|
|
|
typedef enum android_fdsan_owner_type android_fdsan_owner_type_t;
|
|
|
|
/****************************************************************************
|
|
* Create an owner tag with the specified type and
|
|
* least significant 56 bits of tag.
|
|
****************************************************************************/
|
|
|
|
uint64_t android_fdsan_create_owner_tag(enum android_fdsan_owner_type type,
|
|
uint64_t tag);
|
|
|
|
/****************************************************************************
|
|
* Exchange a file descriptor's tag.
|
|
*
|
|
* Logs and aborts if the fd's tag does not match expected_tag.
|
|
****************************************************************************/
|
|
|
|
void android_fdsan_exchange_owner_tag(int fd, uint64_t expected_tag,
|
|
uint64_t new_tag);
|
|
|
|
/****************************************************************************
|
|
* Close a file descriptor with a tag, and resets the tag to 0.
|
|
*
|
|
* Logs and aborts if the tag is incorrect.
|
|
****************************************************************************/
|
|
|
|
int android_fdsan_close_with_tag(int fd, uint64_t tag);
|
|
|
|
#undef EXTERN
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif /* __INCLUDE_ANDROID_FDSAN_H */
|