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, Version 1.0 only 6 * (the "License"). You may not use this file except in compliance 7 * with the License. 8 * 9 * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE 10 * or http://www.opensolaris.org/os/licensing. 11 * See the License for the specific language governing permissions 12 * and limitations under the License. 13 * 14 * When distributing Covered Code, include this CDDL HEADER in each 15 * file and include the License file at usr/src/OPENSOLARIS.LICENSE. 16 * If applicable, add the following below this CDDL HEADER, with the 17 * fields enclosed by brackets "[]" replaced with your own identifying 18 * information: Portions Copyright [yyyy] [name of copyright owner] 19 * 20 * CDDL HEADER END 21 */ 22 /* 23 * Copyright 2004 Sun Microsystems, Inc. All rights reserved. 24 * Use is subject to license terms. 25 */ 26 27 /* Copyright (c) 1988 AT&T */ 28 /* All Rights Reserved */ 29 30 31 #ifndef _SYS_CLASS_H 32 #define _SYS_CLASS_H 33 34 #pragma ident "%Z%%M% %I% %E% SMI" 35 36 #include <sys/t_lock.h> 37 #include <sys/cred.h> 38 #include <sys/thread.h> 39 #include <sys/priocntl.h> 40 #include <sys/mutex.h> 41 42 #ifdef __cplusplus 43 extern "C" { 44 #endif 45 46 /* 47 * NOTE: Developers making use of the scheduler class switch mechanism 48 * to develop scheduling class modules should be aware that the 49 * architecture is not frozen and the kernel interface for scheduling 50 * class modules may change in future releases of System V. Support 51 * for the current interface is not guaranteed and class modules 52 * developed to this interface may require changes in order to work 53 * with future releases of the system. 54 */ 55 56 /* 57 * three different ops vectors are bundled together, here. 58 * one is for each of the fundamental objects acted upon 59 * by these operators: procs, threads, and the class manager itself. 60 */ 61 62 typedef struct class_ops { 63 int (*cl_admin)(caddr_t, cred_t *); 64 int (*cl_getclinfo)(void *); 65 int (*cl_parmsin)(void *); 66 int (*cl_parmsout)(void *, pc_vaparms_t *); 67 int (*cl_vaparmsin)(void *, pc_vaparms_t *); 68 int (*cl_vaparmsout)(void *, pc_vaparms_t *); 69 int (*cl_getclpri)(pcpri_t *); 70 int (*cl_alloc)(void **, int); 71 void (*cl_free)(void *); 72 } class_ops_t; 73 74 typedef struct thread_ops { 75 int (*cl_enterclass)(kthread_id_t, id_t, void *, cred_t *, void *); 76 void (*cl_exitclass)(void *); 77 int (*cl_canexit)(kthread_id_t, cred_t *); 78 int (*cl_fork)(kthread_id_t, kthread_id_t, void *); 79 void (*cl_forkret)(kthread_id_t, kthread_id_t); 80 void (*cl_parmsget)(kthread_id_t, void *); 81 int (*cl_parmsset)(kthread_id_t, void *, id_t, cred_t *); 82 void (*cl_stop)(kthread_id_t, int, int); 83 void (*cl_exit)(kthread_id_t); 84 void (*cl_active)(kthread_id_t); 85 void (*cl_inactive)(kthread_id_t); 86 pri_t (*cl_swapin)(kthread_id_t, int); 87 pri_t (*cl_swapout)(kthread_id_t, int); 88 void (*cl_trapret)(kthread_id_t); 89 void (*cl_preempt)(kthread_id_t); 90 void (*cl_setrun)(kthread_id_t); 91 void (*cl_sleep)(kthread_id_t); 92 void (*cl_tick)(kthread_id_t); 93 void (*cl_wakeup)(kthread_id_t); 94 int (*cl_donice)(kthread_id_t, cred_t *, int, int *); 95 pri_t (*cl_globpri)(kthread_id_t); 96 void (*cl_set_process_group)(pid_t, pid_t, pid_t); 97 void (*cl_yield)(kthread_id_t); 98 } thread_ops_t; 99 100 typedef struct classfuncs { 101 class_ops_t sclass; 102 thread_ops_t thread; 103 } classfuncs_t; 104 105 typedef struct sclass { 106 char *cl_name; /* class name */ 107 /* class specific initialization function */ 108 pri_t (*cl_init)(id_t, int, classfuncs_t **); 109 classfuncs_t *cl_funcs; /* pointer to classfuncs structure */ 110 krwlock_t *cl_lock; /* class structure read/write lock */ 111 int cl_count; /* # of threads trying to load class */ 112 } sclass_t; 113 114 #define STATIC_SCHED (krwlock_t *)0xffffffff 115 #define LOADABLE_SCHED(s) ((s)->cl_lock != STATIC_SCHED) 116 #define SCHED_INSTALLED(s) ((s)->cl_funcs != NULL) 117 #define ALLOCATED_SCHED(s) ((s)->cl_lock != NULL) 118 119 #ifdef _KERNEL 120 121 extern int nclass; /* number of configured scheduling classes */ 122 extern char *defaultclass; /* default class for newproc'd processes */ 123 extern struct sclass sclass[]; /* the class table */ 124 extern kmutex_t class_lock; /* lock protecting class table */ 125 extern int loaded_classes; /* number of classes loaded */ 126 127 extern pri_t minclsyspri; 128 extern id_t syscid; /* system scheduling class ID */ 129 extern id_t defaultcid; /* "default" class id; see dispadmin(1M) */ 130 131 extern int alloc_cid(char *, id_t *); 132 extern int scheduler_load(char *, sclass_t *); 133 extern int getcid(char *, id_t *); 134 extern int getcidbyname(char *, id_t *); 135 extern int parmsin(pcparms_t *, pc_vaparms_t *); 136 extern int parmsout(pcparms_t *, pc_vaparms_t *); 137 extern int parmsset(pcparms_t *, kthread_id_t); 138 extern void parmsget(kthread_id_t, pcparms_t *); 139 extern int vaparmsout(char *, pcparms_t *, pc_vaparms_t *); 140 141 #endif 142 143 #define CL_ADMIN(clp, uaddr, reqpcredp) \ 144 (*(clp)->cl_funcs->sclass.cl_admin)(uaddr, reqpcredp) 145 146 #define CL_ENTERCLASS(t, cid, clparmsp, credp, bufp) \ 147 (sclass[cid].cl_funcs->thread.cl_enterclass) (t, cid, \ 148 (void *)clparmsp, credp, bufp) 149 150 #define CL_EXITCLASS(cid, clprocp)\ 151 (sclass[cid].cl_funcs->thread.cl_exitclass) ((void *)clprocp) 152 153 #define CL_CANEXIT(t, cr) (*(t)->t_clfuncs->cl_canexit)(t, cr) 154 155 #define CL_FORK(tp, ct, bufp) (*(tp)->t_clfuncs->cl_fork)(tp, ct, bufp) 156 157 #define CL_FORKRET(t, ct) (*(t)->t_clfuncs->cl_forkret)(t, ct) 158 159 #define CL_GETCLINFO(clp, clinfop) \ 160 (*(clp)->cl_funcs->sclass.cl_getclinfo)((void *)clinfop) 161 162 #define CL_GETCLPRI(clp, clprip) \ 163 (*(clp)->cl_funcs->sclass.cl_getclpri)(clprip) 164 165 #define CL_PARMSGET(t, clparmsp) \ 166 (*(t)->t_clfuncs->cl_parmsget)(t, (void *)clparmsp) 167 168 #define CL_PARMSIN(clp, clparmsp) \ 169 (clp)->cl_funcs->sclass.cl_parmsin((void *)clparmsp) 170 171 #define CL_PARMSOUT(clp, clparmsp, vaparmsp) \ 172 (clp)->cl_funcs->sclass.cl_parmsout((void *)clparmsp, vaparmsp) 173 174 #define CL_VAPARMSIN(clp, clparmsp, vaparmsp) \ 175 (clp)->cl_funcs->sclass.cl_vaparmsin((void *)clparmsp, vaparmsp) 176 177 #define CL_VAPARMSOUT(clp, clparmsp, vaparmsp) \ 178 (clp)->cl_funcs->sclass.cl_vaparmsout((void *)clparmsp, vaparmsp) 179 180 #define CL_PARMSSET(t, clparmsp, cid, curpcredp) \ 181 (*(t)->t_clfuncs->cl_parmsset)(t, (void *)clparmsp, cid, curpcredp) 182 183 #define CL_PREEMPT(tp) (*(tp)->t_clfuncs->cl_preempt)(tp) 184 185 #define CL_SETRUN(tp) (*(tp)->t_clfuncs->cl_setrun)(tp) 186 187 #define CL_SLEEP(tp) (*(tp)->t_clfuncs->cl_sleep)(tp) 188 189 #define CL_STOP(t, why, what) (*(t)->t_clfuncs->cl_stop)(t, why, what) 190 191 #define CL_EXIT(t) (*(t)->t_clfuncs->cl_exit)(t) 192 193 #define CL_ACTIVE(t) (*(t)->t_clfuncs->cl_active)(t) 194 195 #define CL_INACTIVE(t) (*(t)->t_clfuncs->cl_inactive)(t) 196 197 #define CL_SWAPIN(t, flags) (*(t)->t_clfuncs->cl_swapin)(t, flags) 198 199 #define CL_SWAPOUT(t, flags) (*(t)->t_clfuncs->cl_swapout)(t, flags) 200 201 #define CL_TICK(t) (*(t)->t_clfuncs->cl_tick)(t) 202 203 #define CL_TRAPRET(t) (*(t)->t_clfuncs->cl_trapret)(t) 204 205 #define CL_WAKEUP(t) (*(t)->t_clfuncs->cl_wakeup)(t) 206 207 #define CL_DONICE(t, cr, inc, ret) \ 208 (*(t)->t_clfuncs->cl_donice)(t, cr, inc, ret) 209 210 #define CL_GLOBPRI(t) (*(t)->t_clfuncs->cl_globpri)(t) 211 212 #define CL_SET_PROCESS_GROUP(t, s, b, f) \ 213 (*(t)->t_clfuncs->cl_set_process_group)(s, b, f) 214 215 #define CL_YIELD(tp) (*(tp)->t_clfuncs->cl_yield)(tp) 216 217 #define CL_ALLOC(pp, cid, flag) \ 218 (sclass[cid].cl_funcs->sclass.cl_alloc) (pp, flag) 219 220 #define CL_FREE(cid, bufp) (sclass[cid].cl_funcs->sclass.cl_free) (bufp) 221 222 #ifdef __cplusplus 223 } 224 #endif 225 226 #endif /* _SYS_CLASS_H */ 227