1 /* 2 * SYS/CAPS.H 3 * 4 * Implements an architecture independant Capability Service API 5 * 6 * $DragonFly: src/sys/sys/caps.h,v 1.8 2004/04/25 18:54:32 cpressey Exp $ 7 */ 8 9 #ifndef _SYS_CAPS_H_ 10 #define _SYS_CAPS_H_ 11 12 #ifndef _SYS_TYPES_H_ 13 #include <sys/types.h> 14 #endif 15 #ifndef _SYS_MSGPORT_H_ 16 #include <sys/msgport.h> 17 #endif 18 #ifndef _SYS_XIO_H_ 19 #include <sys/xio.h> 20 #endif 21 22 typedef enum caps_msg_state { 23 CAPMS_REQUEST, 24 CAPMS_REQUEST_RETRY, /* internal / FUTURE */ 25 CAPMS_REPLY, 26 CAPMS_REPLY_RETRY, /* internal / FUTURE */ 27 CAPMS_DISPOSE 28 } caps_msg_state_t; 29 30 typedef struct caps_msgid { 31 off_t c_id; 32 caps_msg_state_t c_state; 33 int c_reserved01; 34 } *caps_msgid_t; 35 36 typedef enum caps_type { 37 CAPT_UNKNOWN, CAPT_CLIENT, CAPT_SERVICE, CAPT_REMOTE, CAPT_FORKED 38 } caps_type_t; 39 40 typedef int64_t caps_gen_t; 41 42 /* 43 * Note: upper 16 bits reserved for kernel use 44 */ 45 #define CAPF_UFLAGS 0xFFFF 46 #define CAPF_USER 0x0001 47 #define CAPF_GROUP 0x0002 48 #define CAPF_WORLD 0x0004 49 #define CAPF_EXCL 0x0008 50 #define CAPF_ANYCLIENT (CAPF_USER|CAPF_GROUP|CAPF_WORLD) 51 #define CAPF_WCRED 0x0010 /* waiting for cred */ 52 #define CAPF_NOFORK 0x0020 /* do not create a dummy entry on fork */ 53 #define CAPF_WAITSVC 0x0040 /* block if service not available */ 54 /* FUTURE: CAPF_ASYNC - support async services */ 55 /* FUTURE: CAPF_NOGROUPS - don't bother filling in the groups[] array */ 56 /* FUTURE: CAPF_TERM - send termination request to existing service */ 57 /* FUTURE: CAPF_TAKE - take over existing service's connections */ 58 /* FUTURE: CAPF_DISPOSE_IMM - need immediate dispose wakeups */ 59 60 /* 61 * Abort codes 62 */ 63 #define CAPS_ABORT_NOTIMPL 0 /* abort not implemented, no action */ 64 #define CAPS_ABORT_RETURNED 1 /* already returned, no action */ 65 #define CAPS_ABORT_BEFORESERVER 2 /* caught before the server got it */ 66 #define CAPS_ABORT_ATSERVER 3 /* server had retrieved message */ 67 68 #define CAPF_ABORT_HARD 0x0001 /* rip out from under server (3) */ 69 70 #define CAPS_MAXGROUPS 16 71 #define CAPS_MAXNAMELEN 64 72 #define CAPS_MAXINPROG 128 73 74 struct thread; 75 76 typedef struct caps_port { 77 struct lwkt_port cp_lport; 78 int cp_portid; /* caps port id */ 79 int cp_upcallid; /* upcall id */ 80 } *caps_port_t; 81 82 typedef struct caps_cred { 83 pid_t pid; 84 uid_t uid; 85 uid_t euid; 86 gid_t gid; 87 int ngroups; 88 int cacheid; 89 gid_t groups[CAPS_MAXGROUPS]; 90 } *caps_cred_t; 91 92 #if defined(_KERNEL) || defined(_KERNEL_STRUCTURES) 93 94 struct caps_kmsg; 95 96 TAILQ_HEAD(caps_kmsg_queue, caps_kmsg); 97 98 /* 99 * caps_kinfo - Holds a client or service registration 100 * 101 * ci_msgpendq: holds the kernel copy of the message after it has been 102 * sent to the local port. The message is matched up against 103 * replies and automatically replied if the owner closes its 104 * connection. 105 */ 106 typedef struct caps_kinfo { 107 struct lwkt_port ci_lport; /* embedded local port */ 108 struct caps_kinfo *ci_tdnext; /* per-process list */ 109 struct caps_kinfo *ci_hnext; /* registration hash table */ 110 struct thread *ci_td; /* owner */ 111 struct caps_kmsg_queue ci_msgpendq; /* pending reply (just rcvd) */ 112 struct caps_kmsg_queue ci_msguserq; /* pending reply (user holds) */ 113 struct caps_kinfo *ci_rcaps; /* connected to remote */ 114 int ci_cmsgcount; /* client in-progress msgs */ 115 int ci_id; 116 int ci_flags; 117 int ci_refs; 118 caps_type_t ci_type; 119 caps_gen_t ci_gen; 120 uid_t ci_uid; 121 gid_t ci_gid; 122 int ci_namelen; 123 char ci_name[4]; /* variable length */ 124 /* ci_name must be last element */ 125 } *caps_kinfo_t; 126 127 /* note: user flags are held in the low 16 bits */ 128 #define CAPKF_TDLIST 0x00010000 129 #define CAPKF_HLIST 0x00020000 130 #define CAPKF_FLUSH 0x00040000 131 #define CAPKF_RCAPS 0x00080000 132 #define CAPKF_CLOSED 0x00100000 133 #define CAPKF_MWAIT 0x00200000 134 135 /* 136 * Kernel caps message. The kernel keepps track of messagse received, 137 * undergoing processing by the service, and returned. User-supplied data 138 * is copied on reception rather then transmission. 139 */ 140 typedef struct caps_kmsg { 141 TAILQ_ENTRY(caps_kmsg) km_node; 142 caps_kinfo_t km_mcaps; /* message sender */ 143 struct xio km_xio; /* mcaps user data */ 144 struct caps_cred km_ccr; /* caps cred for msg */ 145 struct caps_msgid km_msgid; 146 int km_flags; 147 } *caps_kmsg_t; 148 149 #define km_state km_msgid.c_state 150 151 #define CAPKMF_ONUSERQ 0x0001 152 #define CAPKMF_ONPENDQ 0x0002 153 #define CAPKMF_REPLY 0x0004 154 #define CAPKMF_CDONE 0x0008 155 #define CAPKMF_PEEKED 0x0010 156 #define CAPKMF_ABORTED 0x0020 157 158 #endif 159 160 #ifdef _KERNEL 161 162 /* 163 * kernel support 164 */ 165 void caps_exit(struct thread *td); 166 void caps_fork(struct proc *p1, struct proc *p2, int flags); 167 168 #else 169 170 /* 171 * Userland API (libcaps) 172 */ 173 caps_port_t caps_service(const char *, uid_t, gid_t, mode_t, int); 174 caps_port_t caps_client(const char *, uid_t, gid_t, int); 175 176 /* 177 * Syscall API 178 */ 179 int caps_sys_service(const char *, uid_t, gid_t, int, int); 180 int caps_sys_client(const char *, uid_t, gid_t, int, int); 181 off_t caps_sys_put(int, void *, int); 182 int caps_sys_reply(int, void *, int, off_t); 183 int caps_sys_get(int, void *, int, caps_msgid_t, caps_cred_t); 184 int caps_sys_wait(int, void *, int, caps_msgid_t, caps_cred_t); 185 int caps_sys_abort(int, off_t, int); 186 int caps_sys_setgen(int, caps_gen_t); 187 caps_gen_t caps_sys_getgen(int); 188 int caps_sys_close(int); 189 190 #endif 191 192 #endif 193 194