Home | History | Annotate | Download | only in hwbinder
      1 /*
      2  * Copyright (C) 2016 The Android Open Source Project
      3  *
      4  * Licensed under the Apache License, Version 2.0 (the "License");
      5  * you may not use this file except in compliance with the License.
      6  * You may obtain a copy of the License at
      7  *
      8  *      http://www.apache.org/licenses/LICENSE-2.0
      9  *
     10  * Unless required by applicable law or agreed to in writing, software
     11  * distributed under the License is distributed on an "AS IS" BASIS,
     12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
     13  * See the License for the specific language governing permissions and
     14  * limitations under the License.
     15  */
     16 
     17 #ifndef ANDROID_HARDWARE_BINDER_KERNEL_H
     18 #define ANDROID_HARDWARE_BINDER_KERNEL_H
     19 
     20 #include <linux/android/binder.h>
     21 
     22 /**
     23  * This file exists because the uapi kernel headers in bionic are built
     24  * from upstream kernel headers only, and the hwbinder kernel changes
     25  * haven't made it upstream yet. Therefore, the modifications to the
     26  * binder header are added locally in this file.
     27  */
     28 
     29 enum {
     30 	BINDER_TYPE_PTR		= B_PACK_CHARS('p', 't', '*', B_TYPE_LARGE),
     31 	BINDER_TYPE_FDA		= B_PACK_CHARS('f', 'd', 'a', B_TYPE_LARGE),
     32 };
     33 
     34 /* This header is used in all binder objects that are fixed
     35  * up by the kernel driver */
     36 struct binder_object_header {
     37 	__u32        type;
     38 };
     39 
     40 struct binder_fd_object {
     41 	struct binder_object_header	hdr;
     42 	/* FD objects used to be represented in flat_binder_object as well,
     43 	 * so we're using pads here to remain compatibile to existing userspace
     44 	 * clients.
     45 	 */
     46 	__u32				pad_flags;
     47 	union {
     48 		binder_uintptr_t	pad_binder;
     49 		__u32			fd;
     50 	};
     51 
     52 	binder_uintptr_t		cookie;
     53 };
     54 
     55 /* A binder_buffer object represents an object that the
     56  * binder kernel driver copies verbatim to the target
     57  * address space. A buffer itself may be pointed to from
     58  * within another buffer, meaning that the pointer inside
     59  * that other buffer needs to be fixed up as well. This
     60  * can be done by specifying the parent buffer, and the
     61  * byte offset at which the pointer lives in that buffer.
     62  */
     63 struct binder_buffer_object {
     64 	struct binder_object_header	hdr;
     65 	__u32				flags;
     66 
     67 	union {
     68 		struct {
     69 			binder_uintptr_t   buffer; /* Pointer to buffer data */
     70 			binder_size_t      length; /* Length of the buffer data */
     71 		};
     72 		struct {
     73 			binder_size_t      child;        /* index of child in objects array */
     74 			binder_size_t      child_offset; /* byte offset in child buffer */
     75 		};
     76 	};
     77 	binder_size_t			parent; /* index of parent in objects array */
     78 	binder_size_t			parent_offset; /* byte offset of pointer in parent buffer */
     79 };
     80 
     81 enum {
     82 	BINDER_BUFFER_HAS_PARENT   = 1U << 0,
     83 	BINDER_BUFFER_REF          = 1U << 1,
     84 };
     85 
     86 /* A binder_fd_array object represents an array of file
     87  * descriptors embedded in a binder_buffer_object. The
     88  * kernel driver will fix up all file descriptors in
     89  * the parent buffer specified by parent and parent_offset
     90  */
     91 struct binder_fd_array_object {
     92 	struct binder_object_header	hdr;
     93 	__u32			_pad; /* hdr is 4 bytes, ensure 8-byte alignment of next fields */
     94 	binder_size_t		num_fds;
     95 	binder_size_t		parent; /* index of parent in objects array */
     96 	binder_size_t		parent_offset; /* offset of pointer in parent */
     97 };
     98 
     99 struct binder_transaction_data_sg {
    100     binder_transaction_data    tr; /* regular transaction data */
    101     binder_size_t              buffers_size; /* number of bytes of SG buffers */
    102 };
    103 
    104 enum {
    105 	BC_TRANSACTION_SG = _IOW('c', 17, struct binder_transaction_data_sg),
    106 	BC_REPLY_SG = _IOW('c', 18, struct binder_transaction_data_sg),
    107 };
    108 
    109 enum {
    110         FLAT_BINDER_FLAG_SCHEDPOLICY_MASK = 0x600,
    111         FLAT_BINDER_FLAG_SCHEDPOLICY_SHIFT = 9,
    112 };
    113 
    114 
    115 #endif // ANDROID_HARDWARE_BINDER_KERNEL_H
    116