1 /* 2 * Copyright (c) 2017, EPAM Systems 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 are met: 7 * 8 * 1. Redistributions of source code must retain the above copyright notice, 9 * this list of conditions and the following disclaimer. 10 * 11 * 2. Redistributions in binary form must reproduce the above copyright notice, 12 * this list of conditions and the following disclaimer in the documentation 13 * and/or other materials provided with the distribution. 14 * 15 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" 16 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 17 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 18 * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE 19 * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 20 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 21 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 22 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 23 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 24 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 25 * POSSIBILITY OF SUCH DAMAGE. 26 */ 27 28 #ifndef KERNEL_MSG_PARAM_H 29 #define KERNEL_MSG_PARAM_H 30 31 #include <optee_msg.h> 32 #include <stdio.h> 33 #include <types_ext.h> 34 #include <kernel/msg_param.h> 35 #include <mm/mobj.h> 36 37 /* 38 * This enum is used in tee_fill_memparam(). It describes direction of memory 39 * parameter. 40 */ 41 enum msg_param_mem_dir { 42 MSG_PARAM_MEM_DIR_IN = 0, 43 MSG_PARAM_MEM_DIR_OUT, 44 MSG_PARAM_MEM_DIR_INOUT, 45 }; 46 47 /** 48 * msg_param_mobj_from_noncontig() - construct mobj from non-contiguous 49 * list of pages. 50 * 51 * @buf_ptr - optee_msg_param.u.tmem.buf_ptr value 52 * @size - optee_msg_param.u.tmem.size value 53 * @shm_ref - optee_msg_param.u.tmem.shm_ref value 54 * @map_buffer - true if buffer needs to be mapped into OP-TEE address space 55 * 56 * return: 57 * mobj or NULL on error 58 */ 59 struct mobj *msg_param_mobj_from_noncontig(paddr_t buf_ptr, size_t size, 60 uint64_t shm_ref, bool map_buffer); 61 62 /** 63 * msg_param_init_memparam() - fill memory reference parameter for RPC call 64 * @param - parameter to fill 65 * @mobj - mobj describing the shared memory buffer 66 * @offset - offset of the buffer 67 * @size - size of the buffer 68 * @cookie - NW cookie of the shared buffer 69 * @dir - data direction 70 * 71 * Idea behind this function is that thread_rpc_alloc() can return 72 * either buffer from preallocated memory pool, of buffer constructed 73 * from supplicant's memory. In first case parameter will have type 74 * OPTEE_MSG_ATTR_TYPE_TMEM_* and OPTEE_MSG_ATTR_TYPE_RMEM_ in second case. 75 * This function will fill parameter structure with right type, depending on 76 * the passed mobj. 77 * 78 * return: 79 * true on success, false on failure 80 */ 81 bool msg_param_init_memparam(struct optee_msg_param *param, struct mobj *mobj, 82 size_t offset, size_t size, 83 uint64_t cookie, enum msg_param_mem_dir dir); 84 /** 85 * msg_param_get_buf_size() - helper functions that reads [T/R]MEM 86 * parameter size 87 * 88 * @param - struct optee_msg_param to read size from 89 * 90 * return: 91 * corresponding size field 92 */ 93 static inline size_t msg_param_get_buf_size(const struct optee_msg_param *param) 94 { 95 switch (param->attr & OPTEE_MSG_ATTR_TYPE_MASK) { 96 case OPTEE_MSG_ATTR_TYPE_TMEM_INPUT: 97 case OPTEE_MSG_ATTR_TYPE_TMEM_OUTPUT: 98 case OPTEE_MSG_ATTR_TYPE_TMEM_INOUT: 99 return param->u.tmem.size; 100 case OPTEE_MSG_ATTR_TYPE_RMEM_INPUT: 101 case OPTEE_MSG_ATTR_TYPE_RMEM_OUTPUT: 102 case OPTEE_MSG_ATTR_TYPE_RMEM_INOUT: 103 return param->u.rmem.size; 104 default: 105 return 0; 106 } 107 } 108 109 /** 110 * msg_param_attr_is_tmem - helper functions that cheks if attribute is tmem 111 * 112 * @attr - attribute to check 113 * 114 * return: 115 * corresponding size field 116 */ 117 static inline bool msg_param_attr_is_tmem(uint64_t attr) 118 { 119 switch (attr & OPTEE_MSG_ATTR_TYPE_MASK) { 120 case OPTEE_MSG_ATTR_TYPE_TMEM_INPUT: 121 case OPTEE_MSG_ATTR_TYPE_TMEM_OUTPUT: 122 case OPTEE_MSG_ATTR_TYPE_TMEM_INOUT: 123 return true; 124 default: 125 return false; 126 } 127 } 128 129 #endif /*KERNEL_MSG_PARAM_H*/ 130