1 /* 2 * CDDL HEADER START 3 * 4 * The contents of this file are subject to the terms of the 5 * Common Development and Distribution License (the "License"). 6 * You may not use this file except in compliance with the License. 7 * 8 * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE 9 * or http://www.opensolaris.org/os/licensing. 10 * See the License for the specific language governing permissions 11 * and limitations under the License. 12 * 13 * When distributing Covered Code, include this CDDL HEADER in each 14 * file and include the License file at usr/src/OPENSOLARIS.LICENSE. 15 * If applicable, add the following below this CDDL HEADER, with the 16 * fields enclosed by brackets "[]" replaced with your own identifying 17 * information: Portions Copyright [yyyy] [name of copyright owner] 18 * 19 * CDDL HEADER END 20 */ 21 /* 22 * Copyright 2008 Sun Microsystems, Inc. All rights reserved. 23 * Use is subject to license terms. 24 */ 25 26 #ifndef _SYS_DOOR_DATA_H 27 #define _SYS_DOOR_DATA_H 28 29 #pragma ident "%Z%%M% %I% %E% SMI" 30 31 #include <sys/types.h> 32 #include <sys/door.h> 33 34 #if defined(_KERNEL) 35 #include <sys/thread.h> 36 #include <sys/file.h> 37 #endif 38 39 #ifdef __cplusplus 40 extern "C" { 41 #endif 42 43 #if defined(_KERNEL) 44 /* door_return() stack layout */ 45 typedef struct door_layout { 46 caddr_t dl_descp; /* start of descriptors (or 0) */ 47 caddr_t dl_datap; /* start of data (or 0) */ 48 caddr_t dl_infop; /* start of door_info_t (or 0) */ 49 caddr_t dl_resultsp; /* start of door_results{32}_t */ 50 caddr_t dl_sp; /* final stack pointer (non-biased) */ 51 } door_layout_t; 52 53 /* upcall invocation information */ 54 typedef struct door_upcall_data { 55 cred_t *du_cred; /* Credential associated w/ upcall */ 56 size_t du_max_data; /* Maximum amount of reply data */ 57 uint_t du_max_descs; /* Maximum number of reply descs */ 58 } door_upcall_t; 59 60 /* 61 * Per-thread data associated with door invocations. Each door invocation 62 * effects the client structure of one thread and the server structure of 63 * another. This way, the server thread for one door_call() can make door 64 * calls of its own without interference. 65 */ 66 typedef struct door_client { 67 door_arg_t d_args; /* Door arg/results */ 68 door_upcall_t *d_upcall; /* upcall information */ 69 caddr_t d_buf; /* Temp buffer for data transfer */ 70 int d_bufsize; /* Size of temp buffer */ 71 int d_fpp_size; /* Number of File ptrs */ 72 struct file **d_fpp; /* File ptrs */ 73 int d_error; /* Error (if any) */ 74 kcondvar_t d_cv; 75 uchar_t d_args_done; /* server has processed client's args */ 76 uchar_t d_hold; /* Thread needs to stick around */ 77 uchar_t d_noresults; /* No results allowed */ 78 uchar_t d_overflow; /* Result overflow occurred */ 79 uchar_t d_kernel; /* Kernel door server */ 80 } door_client_t; 81 82 typedef struct door_server { 83 struct _kthread *d_caller; /* Door caller */ 84 struct _kthread *d_servers; /* List of door servers */ 85 struct door_node *d_active; /* Active door */ 86 struct door_node *d_pool; /* our server thread pool */ 87 door_layout_t d_layout; 88 caddr_t d_sp; /* Saved thread stack base */ 89 size_t d_ssize; /* Saved thread stack size */ 90 kcondvar_t d_cv; 91 uchar_t d_hold; /* Thread needs to stick around */ 92 uchar_t d_invbound; /* Thread is bound to invalid door */ 93 uchar_t d_layout_done; /* d_layout has been filled */ 94 } door_server_t; 95 96 typedef struct door_data { 97 door_client_t d_client; 98 door_server_t d_server; 99 } door_data_t; 100 101 #define DOOR_CLIENT(dp) (&(dp)->d_client) 102 #define DOOR_SERVER(dp) (&(dp)->d_server) 103 104 /* 105 * Macros for holding a thread in place. Takes a door_server_t or 106 * door_client_t pointer as an argument. 107 */ 108 #define DOOR_T_HELD(cst) ((cst)->d_hold) 109 110 #define DOOR_T_HOLD(cst) \ 111 (ASSERT(!DOOR_T_HELD(cst)), ((cst)->d_hold = 1)) 112 #define DOOR_T_RELEASE(cst) \ 113 (ASSERT(DOOR_T_HELD(cst)), ((cst)->d_hold = 0), \ 114 cv_broadcast(&(cst)->d_cv)) 115 116 /* 117 * Roundup buffer size when passing/returning data via kernel buffer. 118 * This cuts down on the number of overflows that occur on return 119 */ 120 #define DOOR_ROUND 128 121 122 #endif /* defined(_KERNEL) */ 123 124 #ifdef __cplusplus 125 } 126 #endif 127 128 #endif /* _SYS_DOOR_DATA_H */ 129