[apple/xnu.git] / osfmk / mach / policy.h

/*
 * Copyright (c) 2000 Apple Computer, Inc. All rights reserved.
 *
 * @APPLE_LICENSE_HEADER_START@
 * 
 * The contents of this file constitute Original Code as defined in and
 * are subject to the Apple Public Source License Version 1.1 (the
 * "License").  You may not use this file except in compliance with the
 * License.  Please obtain a copy of the License at
 * http://www.apple.com/publicsource and read it before using this file.
 * 
 * This Original Code and all software distributed under the License are
 * distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY KIND, EITHER
 * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
 * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT.  Please see the
 * License for the specific language governing rights and limitations
 * under the License.
 * 
 * @APPLE_LICENSE_HEADER_END@
 */
/*
 * @OSF_COPYRIGHT@
 */
/* 
 * Mach Operating System
 * Copyright (c) 1991,1990,1989,1988 Carnegie Mellon University
 * All Rights Reserved.
 * 
 * Permission to use, copy, modify and distribute this software and its
 * documentation is hereby granted, provided that both the copyright
 * notice and this permission notice appear in all copies of the
 * software, derivative works or modified versions, and any portions
 * thereof, and that both notices appear in supporting documentation.
 * 
 * CARNEGIE MELLON ALLOWS FREE USE OF THIS SOFTWARE IN ITS "AS IS"
 * CONDITION.  CARNEGIE MELLON DISCLAIMS ANY LIABILITY OF ANY KIND FOR
 * ANY DAMAGES WHATSOEVER RESULTING FROM THE USE OF THIS SOFTWARE.
 * 
 * Carnegie Mellon requests users of this software to return to
 * 
 *  Software Distribution Coordinator  or  Software.Distribution@CS.CMU.EDU
 *  School of Computer Science
 *  Carnegie Mellon University
 *  Pittsburgh PA 15213-3890
 * 
 * any improvements or extensions that they make and grant Carnegie Mellon
 * the rights to redistribute these changes.
 */
/*
 */

#ifndef	_MACH_POLICY_H_
#define _MACH_POLICY_H_

/*
 *	mach/policy.h
 *
 *	Definitions for scheduing policy.
 *
 *  N.B. The interfaces defined here are all obsolete!!
 */

#include <mach/boolean.h>
#include <mach/vm_types.h>

#include <sys/appleapiopts.h>

/*
 *	Old scheduling control interface
 */
typedef int 				policy_t;
typedef integer_t			*policy_info_t;
typedef integer_t			*policy_base_t;
typedef integer_t			*policy_limit_t;

#ifdef	__APPLE_API_UNSTABLE

/*
 *	Policy definitions.  Policies should be powers of 2,
 *	but cannot be or'd together other than to test for a
 *	policy 'class'.
 */
#define	POLICY_NULL		0	/* none			*/
#define	POLICY_TIMESHARE	1	/* timesharing		*/
#define	POLICY_RR		2	/* fixed round robin	*/
#define POLICY_FIFO		4	/* fixed fifo		*/

#define __NEW_SCHEDULING_FRAMEWORK__

/*
 *	Check if policy is of 'class' fixed-priority.
 */
#define	POLICYCLASS_FIXEDPRI	(POLICY_RR | POLICY_FIFO)

/*
 *	Check if policy is valid.
 */
#define invalid_policy(policy)			\
	((policy) != POLICY_TIMESHARE &&	\
	 (policy) != POLICY_RR &&		\
	 (policy) != POLICY_FIFO)


/*
 * 	Types for TIMESHARE policy
 */
struct policy_timeshare_base {			
	integer_t		base_priority;
};
struct policy_timeshare_limit {
	integer_t		max_priority;
};
struct policy_timeshare_info {
	integer_t		max_priority;
	integer_t		base_priority;
	integer_t		cur_priority;
	boolean_t		depressed;
	integer_t		depress_priority;
};

typedef struct policy_timeshare_base	*policy_timeshare_base_t; 
typedef struct policy_timeshare_limit	*policy_timeshare_limit_t;
typedef struct policy_timeshare_info	*policy_timeshare_info_t;

typedef struct policy_timeshare_base	policy_timeshare_base_data_t; 
typedef struct policy_timeshare_limit	policy_timeshare_limit_data_t;
typedef struct policy_timeshare_info	policy_timeshare_info_data_t;


#define POLICY_TIMESHARE_BASE_COUNT		\
	(sizeof(struct policy_timeshare_base)/sizeof(integer_t))
#define POLICY_TIMESHARE_LIMIT_COUNT		\
	(sizeof(struct policy_timeshare_limit)/sizeof(integer_t))
#define POLICY_TIMESHARE_INFO_COUNT		\
	(sizeof(struct policy_timeshare_info)/sizeof(integer_t))


/*
 *	Types for the ROUND ROBIN (RR) policy
 */
struct policy_rr_base {				
	integer_t		base_priority;
	integer_t		quantum;
};
struct policy_rr_limit {
	integer_t		max_priority;
};
struct policy_rr_info {
	integer_t		max_priority;
	integer_t		base_priority;
	integer_t		quantum;
	boolean_t		depressed;
	integer_t		depress_priority;
};

typedef struct policy_rr_base		*policy_rr_base_t;
typedef struct policy_rr_limit		*policy_rr_limit_t;
typedef struct policy_rr_info		*policy_rr_info_t;

typedef struct policy_rr_base		policy_rr_base_data_t;
typedef struct policy_rr_limit		policy_rr_limit_data_t;
typedef struct policy_rr_info		policy_rr_info_data_t;

#define POLICY_RR_BASE_COUNT		\
	(sizeof(struct policy_rr_base)/sizeof(integer_t))
#define POLICY_RR_LIMIT_COUNT		\
	(sizeof(struct policy_rr_limit)/sizeof(integer_t))
#define POLICY_RR_INFO_COUNT		\
	(sizeof(struct policy_rr_info)/sizeof(integer_t))


/*
 * 	Types for the FIRST-IN-FIRST-OUT (FIFO) policy
 */
struct policy_fifo_base {		
	integer_t		base_priority;
};
struct policy_fifo_limit {
	integer_t		max_priority;
};
struct policy_fifo_info {
	integer_t		max_priority;
	integer_t		base_priority;
	boolean_t		depressed;
	integer_t		depress_priority;
};

typedef struct policy_fifo_base		*policy_fifo_base_t;
typedef struct policy_fifo_limit	*policy_fifo_limit_t;
typedef struct policy_fifo_info		*policy_fifo_info_t;

typedef struct policy_fifo_base		policy_fifo_base_data_t;
typedef struct policy_fifo_limit	policy_fifo_limit_data_t;
typedef struct policy_fifo_info		policy_fifo_info_data_t;

#define POLICY_FIFO_BASE_COUNT		\
	(sizeof(struct policy_fifo_base)/sizeof(integer_t))
#define POLICY_FIFO_LIMIT_COUNT		\
	(sizeof(struct policy_fifo_limit)/sizeof(integer_t))
#define POLICY_FIFO_INFO_COUNT		\
	(sizeof(struct policy_fifo_info)/sizeof(integer_t))

/*
 * 	Aggregate policy types
 */

struct policy_bases {
	policy_timeshare_base_data_t	ts;
	policy_rr_base_data_t		rr;
	policy_fifo_base_data_t		fifo;
};

struct policy_limits {
	policy_timeshare_limit_data_t	ts;
	policy_rr_limit_data_t		rr;
	policy_fifo_limit_data_t	fifo;
};

struct policy_infos {
	policy_timeshare_info_data_t	ts;
	policy_rr_info_data_t		rr;
	policy_fifo_info_data_t		fifo;
};

typedef struct policy_bases		policy_base_data_t;
typedef struct policy_limits		policy_limit_data_t;
typedef struct policy_infos		policy_info_data_t;

#endif	/* __APPLE_API_UNSTABLE */

#endif /* _MACH_POLICY_H_ */
Commit	Line	Data
1c79356b A	1	/*
	2	* Copyright (c) 2000 Apple Computer, Inc. All rights reserved.
	3	*
	4	* @APPLE_LICENSE_HEADER_START@
	5	*
e5568f75 A	6	* The contents of this file constitute Original Code as defined in and
	7	* are subject to the Apple Public Source License Version 1.1 (the
	8	* "License"). You may not use this file except in compliance with the
	9	* License. Please obtain a copy of the License at
	10	* http://www.apple.com/publicsource and read it before using this file.
1c79356b	11	*
e5568f75 A	12	* This Original Code and all software distributed under the License are
e5568f75 A	13	* distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY KIND, EITHER
1c79356b A	14	* EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
1c79356b A	15	* INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
e5568f75 A	16	* FITNESS FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT. Please see the
	17	* License for the specific language governing rights and limitations
	18	* under the License.
1c79356b A	19	*
	20	* @APPLE_LICENSE_HEADER_END@
	21	*/
	22	/*
	23	* @OSF_COPYRIGHT@
	24	*/
	25	/*
	26	* Mach Operating System
	27	* Copyright (c) 1991,1990,1989,1988 Carnegie Mellon University
	28	* All Rights Reserved.
	29	*
	30	* Permission to use, copy, modify and distribute this software and its
	31	* documentation is hereby granted, provided that both the copyright
	32	* notice and this permission notice appear in all copies of the
	33	* software, derivative works or modified versions, and any portions
	34	* thereof, and that both notices appear in supporting documentation.
	35	*
	36	* CARNEGIE MELLON ALLOWS FREE USE OF THIS SOFTWARE IN ITS "AS IS"
	37	* CONDITION. CARNEGIE MELLON DISCLAIMS ANY LIABILITY OF ANY KIND FOR
	38	* ANY DAMAGES WHATSOEVER RESULTING FROM THE USE OF THIS SOFTWARE.
	39	*
	40	* Carnegie Mellon requests users of this software to return to
	41	*
	42	* Software Distribution Coordinator or Software.Distribution@CS.CMU.EDU
	43	* School of Computer Science
	44	* Carnegie Mellon University
	45	* Pittsburgh PA 15213-3890
	46	*
	47	* any improvements or extensions that they make and grant Carnegie Mellon
	48	* the rights to redistribute these changes.
	49	*/
	50	/*
	51	*/
	52
	53	#ifndef _MACH_POLICY_H_
	54	#define _MACH_POLICY_H_
	55
	56	/*
	57	* mach/policy.h
	58	*
	59	* Definitions for scheduing policy.
	60	*
	61	* N.B. The interfaces defined here are all obsolete!!
	62	*/
	63
	64	#include <mach/boolean.h>
	65	#include <mach/vm_types.h>
	66
9bccf70c A	67	#include <sys/appleapiopts.h>
	68
	69	/*
	70	* Old scheduling control interface
	71	*/
	72	typedef int policy_t;
	73	typedef integer_t *policy_info_t;
	74	typedef integer_t *policy_base_t;
	75	typedef integer_t *policy_limit_t;
	76
	77	#ifdef __APPLE_API_UNSTABLE
	78
1c79356b A	79	/*
	80	* Policy definitions. Policies should be powers of 2,
	81	* but cannot be or'd together other than to test for a
	82	* policy 'class'.
	83	*/
	84	#define POLICY_NULL 0 /* none */
	85	#define POLICY_TIMESHARE 1 /* timesharing */
	86	#define POLICY_RR 2 /* fixed round robin */
	87	#define POLICY_FIFO 4 /* fixed fifo */
	88
	89	#define __NEW_SCHEDULING_FRAMEWORK__
	90
	91	/*
	92	* Check if policy is of 'class' fixed-priority.
	93	*/
	94	#define POLICYCLASS_FIXEDPRI (POLICY_RR \| POLICY_FIFO)
	95
	96	/*
	97	* Check if policy is valid.
	98	*/
	99	#define invalid_policy(policy) \
	100	((policy) != POLICY_TIMESHARE && \
	101	(policy) != POLICY_RR && \
	102	(policy) != POLICY_FIFO)
	103
	104
1c79356b A	105	/*
	106	* Types for TIMESHARE policy
	107	*/
	108	struct policy_timeshare_base {
	109	integer_t base_priority;
	110	};
	111	struct policy_timeshare_limit {
	112	integer_t max_priority;
	113	};
	114	struct policy_timeshare_info {
	115	integer_t max_priority;
	116	integer_t base_priority;
	117	integer_t cur_priority;
	118	boolean_t depressed;
	119	integer_t depress_priority;
	120	};
	121
	122	typedef struct policy_timeshare_base *policy_timeshare_base_t;
	123	typedef struct policy_timeshare_limit *policy_timeshare_limit_t;
	124	typedef struct policy_timeshare_info *policy_timeshare_info_t;
	125
	126	typedef struct policy_timeshare_base policy_timeshare_base_data_t;
	127	typedef struct policy_timeshare_limit policy_timeshare_limit_data_t;
	128	typedef struct policy_timeshare_info policy_timeshare_info_data_t;
	129
	130
	131	#define POLICY_TIMESHARE_BASE_COUNT \
	132	(sizeof(struct policy_timeshare_base)/sizeof(integer_t))
	133	#define POLICY_TIMESHARE_LIMIT_COUNT \
	134	(sizeof(struct policy_timeshare_limit)/sizeof(integer_t))
	135	#define POLICY_TIMESHARE_INFO_COUNT \
	136	(sizeof(struct policy_timeshare_info)/sizeof(integer_t))
	137
	138
	139	/*
	140	* Types for the ROUND ROBIN (RR) policy
	141	*/
	142	struct policy_rr_base {
	143	integer_t base_priority;
	144	integer_t quantum;
	145	};
	146	struct policy_rr_limit {
	147	integer_t max_priority;
	148	};
	149	struct policy_rr_info {
	150	integer_t max_priority;
	151	integer_t base_priority;
	152	integer_t quantum;
	153	boolean_t depressed;
	154	integer_t depress_priority;
	155	};
	156
	157	typedef struct policy_rr_base *policy_rr_base_t;
	158	typedef struct policy_rr_limit *policy_rr_limit_t;
	159	typedef struct policy_rr_info *policy_rr_info_t;
	160
	161	typedef struct policy_rr_base policy_rr_base_data_t;
	162	typedef struct policy_rr_limit policy_rr_limit_data_t;
	163	typedef struct policy_rr_info policy_rr_info_data_t;
	164
	165	#define POLICY_RR_BASE_COUNT \
	166	(sizeof(struct policy_rr_base)/sizeof(integer_t))
	167	#define POLICY_RR_LIMIT_COUNT \
	168	(sizeof(struct policy_rr_limit)/sizeof(integer_t))
169	#define POLICY_RR_INFO_COUNT \
170	(sizeof(struct policy_rr_info)/sizeof(integer_t))
171
172
173	/*
174	* Types for the FIRST-IN-FIRST-OUT (FIFO) policy
175	*/
176	struct policy_fifo_base {
177	integer_t base_priority;
178	};
179	struct policy_fifo_limit {
180	integer_t max_priority;
181	};
182	struct policy_fifo_info {
183	integer_t max_priority;
184	integer_t base_priority;
185	boolean_t depressed;
186	integer_t depress_priority;
187	};
188
189	typedef struct policy_fifo_base *policy_fifo_base_t;
190	typedef struct policy_fifo_limit *policy_fifo_limit_t;
191	typedef struct policy_fifo_info *policy_fifo_info_t;
192
193	typedef struct policy_fifo_base policy_fifo_base_data_t;
194	typedef struct policy_fifo_limit policy_fifo_limit_data_t;
195	typedef struct policy_fifo_info policy_fifo_info_data_t;
196
197	#define POLICY_FIFO_BASE_COUNT \
198	(sizeof(struct policy_fifo_base)/sizeof(integer_t))
199	#define POLICY_FIFO_LIMIT_COUNT \
200	(sizeof(struct policy_fifo_limit)/sizeof(integer_t))
201	#define POLICY_FIFO_INFO_COUNT \
202	(sizeof(struct policy_fifo_info)/sizeof(integer_t))
203
204	/*
205	* Aggregate policy types
206	*/
207
208	struct policy_bases {
209	policy_timeshare_base_data_t ts;
210	policy_rr_base_data_t rr;
211	policy_fifo_base_data_t fifo;
212	};
213
214	struct policy_limits {
215	policy_timeshare_limit_data_t ts;
216	policy_rr_limit_data_t rr;
217	policy_fifo_limit_data_t fifo;
218	};
219
220	struct policy_infos {
221	policy_timeshare_info_data_t ts;
222	policy_rr_info_data_t rr;
223	policy_fifo_info_data_t fifo;
224	};
225
226	typedef struct policy_bases policy_base_data_t;
227	typedef struct policy_limits policy_limit_data_t;
228	typedef struct policy_infos policy_info_data_t;
229
9bccf70c A	230	#endif /* __APPLE_API_UNSTABLE */
9bccf70c A	231
1c79356b	232	#endif /* _MACH_POLICY_H_ */