LXR linux/drivers/staging/android/uapi/ion

   1/*
   2 * drivers/staging/android/uapi/ion.h
   3 *
   4 * Copyright (C) 2011 Google, Inc.
   5 *
   6 * This software is licensed under the terms of the GNU General Public
   7 * License version 2, as published by the Free Software Foundation, and
   8 * may be copied, distributed, and modified under those terms.
   9 *
  10 * This program is distributed in the hope that it will be useful,
  11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
  12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  13 * GNU General Public License for more details.
  14 *
  15 */
  16
  17#ifndef _UAPI_LINUX_ION_TEST_H
  18#define _UAPI_LINUX_ION_TEST_H
  19
  20#include <linux/ioctl.h>
  21#include <linux/types.h>
  22
  23/**
  24 * struct ion_test_rw_data - metadata passed to the kernel to read handle
  25 * @ptr:        a pointer to an area at least as large as size
  26 * @offset:     offset into the ion buffer to start reading
  27 * @size:       size to read or write
  28 * @write:      1 to write, 0 to read
  29 */
  30struct ion_test_rw_data {
  31        __u64 ptr;
  32        __u64 offset;
  33        __u64 size;
  34        int write;
  35        int __padding;
  36};
  37
  38#define ION_IOC_MAGIC           'I'
  39
  40/**
  41 * DOC: ION_IOC_TEST_SET_DMA_BUF - attach a dma buf to the test driver
  42 *
  43 * Attaches a dma buf fd to the test driver.  Passing a second fd or -1 will
  44 * release the first fd.
  45 */
  46#define ION_IOC_TEST_SET_FD \
  47                        _IO(ION_IOC_MAGIC, 0xf0)
  48
  49/**
  50 * DOC: ION_IOC_TEST_DMA_MAPPING - read or write memory from a handle as DMA
  51 *
  52 * Reads or writes the memory from a handle using an uncached mapping.  Can be
  53 * used by unit tests to emulate a DMA engine as close as possible.  Only
  54 * expected to be used for debugging and testing, may not always be available.
  55 */
  56#define ION_IOC_TEST_DMA_MAPPING \
  57                        _IOW(ION_IOC_MAGIC, 0xf1, struct ion_test_rw_data)
  58
  59/**
  60 * DOC: ION_IOC_TEST_KERNEL_MAPPING - read or write memory from a handle
  61 *
  62 * Reads or writes the memory from a handle using a kernel mapping.  Can be
  63 * used by unit tests to test heap map_kernel functions.  Only expected to be
  64 * used for debugging and testing, may not always be available.
  65 */
  66#define ION_IOC_TEST_KERNEL_MAPPING \
  67                        _IOW(ION_IOC_MAGIC, 0xf2, struct ion_test_rw_data)
  68
  69
  70#endif /* _UAPI_LINUX_ION_H */
  71