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

/*
 * Copyright (c) 2000-2005 Apple Computer, Inc. All rights reserved.
 *
 * @APPLE_OSREFERENCE_LICENSE_HEADER_START@
 * 
 * This file contains Original Code and/or Modifications of Original Code
 * as defined in and that are subject to the Apple Public Source License
 * Version 2.0 (the 'License'). You may not use this file except in
 * compliance with the License. The rights granted to you under the License
 * may not be used to create, or enable the creation or redistribution of,
 * unlawful or unlicensed copies of an Apple operating system, or to
 * circumvent, violate, or enable the circumvention or violation of, any
 * terms of an Apple operating system software license agreement.
 * 
 * Please obtain a copy of the License at
 * http://www.opensource.apple.com/apsl/ and read it before using this file.
 * 
 * The 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, QUIET ENJOYMENT OR NON-INFRINGEMENT.
 * Please see the License for the specific language governing rights and
 * limitations under the License.
 * 
 * @APPLE_OSREFERENCE_LICENSE_HEADER_END@
 */
/*
 * @OSF_COPYRIGHT@
 */
/* 
 * Mach Operating System
 * Copyright (c) 1991,1990,1989 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.
 */
/*
 */

/*
 *	File:	mach/processor_info.h
 *	Author:	David L. Black
 *	Date:	1988
 *
 *	Data structure definitions for processor_info, processor_set_info
 */

#ifndef	_MACH_PROCESSOR_INFO_H_
#define _MACH_PROCESSOR_INFO_H_

#include <mach/message.h>
#include <mach/machine.h>
#include <mach/machine/processor_info.h>

/*
 *	Generic information structure to allow for expansion.
 */
typedef integer_t	*processor_info_t;	/* varying array of int. */
typedef integer_t	*processor_info_array_t;  /* varying array of int */

#define PROCESSOR_INFO_MAX	(1024)	/* max array size */
typedef integer_t	processor_info_data_t[PROCESSOR_INFO_MAX];


typedef integer_t	*processor_set_info_t;	/* varying array of int. */

#define PROCESSOR_SET_INFO_MAX	(1024)	/* max array size */
typedef integer_t	processor_set_info_data_t[PROCESSOR_SET_INFO_MAX];

/*
 *	Currently defined information.
 */
typedef int	processor_flavor_t;
#define	PROCESSOR_BASIC_INFO	1		/* basic information */
#define	PROCESSOR_CPU_LOAD_INFO	2	/* cpu load information */
#define	PROCESSOR_PM_REGS_INFO	0x10000001	/* performance monitor register info */
#define	PROCESSOR_TEMPERATURE	0x10000002	/* Processor core temperature */

struct processor_basic_info {
	cpu_type_t	cpu_type;	/* type of cpu */
	cpu_subtype_t	cpu_subtype;	/* subtype of cpu */
	boolean_t	running;	/* is processor running */
	int		slot_num;	/* slot number */
	boolean_t	is_master;	/* is this the master processor */
};

typedef	struct processor_basic_info	processor_basic_info_data_t;
typedef struct processor_basic_info	*processor_basic_info_t;
#define PROCESSOR_BASIC_INFO_COUNT	((mach_msg_type_number_t) \
		(sizeof(processor_basic_info_data_t)/sizeof(natural_t)))

struct processor_cpu_load_info {             /* number of ticks while running... */
        unsigned long   cpu_ticks[CPU_STATE_MAX]; /* ... in the given mode */
}; 

typedef	struct processor_cpu_load_info	processor_cpu_load_info_data_t;
typedef struct processor_cpu_load_info	*processor_cpu_load_info_t;
#define PROCESSOR_CPU_LOAD_INFO_COUNT	((mach_msg_type_number_t) \
		(sizeof(processor_cpu_load_info_data_t)/sizeof(natural_t)))

/*
 *	Scaling factor for load_average, mach_factor.
 */
#define	LOAD_SCALE	1000		

typedef	int	processor_set_flavor_t;
#define	PROCESSOR_SET_BASIC_INFO	5	/* basic information */

struct processor_set_basic_info {
	int		processor_count;	/* How many processors */
	int		default_policy;		/* When others not enabled */
};

typedef	struct processor_set_basic_info	processor_set_basic_info_data_t;
typedef struct processor_set_basic_info	*processor_set_basic_info_t;
#define PROCESSOR_SET_BASIC_INFO_COUNT	((mach_msg_type_number_t) \
		(sizeof(processor_set_basic_info_data_t)/sizeof(natural_t)))

#define PROCESSOR_SET_LOAD_INFO		4	/* scheduling statistics */

struct processor_set_load_info {
        int             task_count;             /* How many tasks */
        int             thread_count;           /* How many threads */
        integer_t       load_average;           /* Scaled */
        integer_t       mach_factor;            /* Scaled */
};

typedef struct processor_set_load_info processor_set_load_info_data_t;
typedef struct processor_set_load_info *processor_set_load_info_t;
#define PROCESSOR_SET_LOAD_INFO_COUNT	((mach_msg_type_number_t) \
                (sizeof(processor_set_load_info_data_t)/sizeof(natural_t)))

#ifdef	PRIVATE

#define PROCESSOR_SET_ENABLED_POLICIES                   3
#define PROCESSOR_SET_ENABLED_POLICIES_COUNT ((mach_msg_type_number_t) \
		(sizeof(policy_t)/sizeof(natural_t)))

#define PROCESSOR_SET_TIMESHARE_DEFAULT                 10
#define PROCESSOR_SET_TIMESHARE_LIMITS                  11

#define PROCESSOR_SET_RR_DEFAULT                        20
#define PROCESSOR_SET_RR_LIMITS                         21

#define PROCESSOR_SET_FIFO_DEFAULT                      30
#define PROCESSOR_SET_FIFO_LIMITS                       31

#endif	/* PRIVATE */

#endif	/* _MACH_PROCESSOR_INFO_H_ */
Commit	Line	Data
1c79356b	1	/*
91447636	2	* Copyright (c) 2000-2005 Apple Computer, Inc. All rights reserved.
1c79356b	3	*
8f6c56a5 A	4	* @APPLE_OSREFERENCE_LICENSE_HEADER_START@
	5	*
	6	* This file contains Original Code and/or Modifications of Original Code
	7	* as defined in and that are subject to the Apple Public Source License
	8	* Version 2.0 (the 'License'). You may not use this file except in
	9	* compliance with the License. The rights granted to you under the License
	10	* may not be used to create, or enable the creation or redistribution of,
	11	* unlawful or unlicensed copies of an Apple operating system, or to
	12	* circumvent, violate, or enable the circumvention or violation of, any
	13	* terms of an Apple operating system software license agreement.
	14	*
	15	* Please obtain a copy of the License at
	16	* http://www.opensource.apple.com/apsl/ and read it before using this file.
	17	*
	18	* The Original Code and all software distributed under the License are
	19	* distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
	20	* EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
	21	* INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
	22	* FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
	23	* Please see the License for the specific language governing rights and
8ad349bb	24	* limitations under the License.
8f6c56a5 A	25	*
8f6c56a5 A	26	* @APPLE_OSREFERENCE_LICENSE_HEADER_END@
1c79356b A	27	*/
	28	/*
	29	* @OSF_COPYRIGHT@
	30	*/
	31	/*
	32	* Mach Operating System
	33	* Copyright (c) 1991,1990,1989 Carnegie Mellon University
	34	* All Rights Reserved.
	35	*
	36	* Permission to use, copy, modify and distribute this software and its
	37	* documentation is hereby granted, provided that both the copyright
	38	* notice and this permission notice appear in all copies of the
	39	* software, derivative works or modified versions, and any portions
	40	* thereof, and that both notices appear in supporting documentation.
	41	*
	42	* CARNEGIE MELLON ALLOWS FREE USE OF THIS SOFTWARE IN ITS "AS IS"
	43	* CONDITION. CARNEGIE MELLON DISCLAIMS ANY LIABILITY OF ANY KIND FOR
	44	* ANY DAMAGES WHATSOEVER RESULTING FROM THE USE OF THIS SOFTWARE.
	45	*
	46	* Carnegie Mellon requests users of this software to return to
	47	*
	48	* Software Distribution Coordinator or Software.Distribution@CS.CMU.EDU
	49	* School of Computer Science
	50	* Carnegie Mellon University
	51	* Pittsburgh PA 15213-3890
	52	*
	53	* any improvements or extensions that they make and grant Carnegie Mellon
	54	* the rights to redistribute these changes.
	55	*/
	56	/*
	57	*/
	58
	59	/*
	60	* File: mach/processor_info.h
	61	* Author: David L. Black
	62	* Date: 1988
	63	*
	64	* Data structure definitions for processor_info, processor_set_info
	65	*/
	66
	67	#ifndef _MACH_PROCESSOR_INFO_H_
	68	#define _MACH_PROCESSOR_INFO_H_
	69
91447636	70	#include <mach/message.h>
1c79356b A	71	#include <mach/machine.h>
	72	#include <mach/machine/processor_info.h>
	73
	74	/*
	75	* Generic information structure to allow for expansion.
	76	*/
	77	typedef integer_t processor_info_t; / varying array of int. */
	78	typedef integer_t processor_info_array_t; / varying array of int */
	79
	80	#define PROCESSOR_INFO_MAX (1024) /* max array size */
	81	typedef integer_t processor_info_data_t[PROCESSOR_INFO_MAX];
	82
	83
	84	typedef integer_t processor_set_info_t; / varying array of int. */
	85
	86	#define PROCESSOR_SET_INFO_MAX (1024) /* max array size */
	87	typedef integer_t processor_set_info_data_t[PROCESSOR_SET_INFO_MAX];
	88
	89	/*
	90	* Currently defined information.
	91	*/
	92	typedef int processor_flavor_t;
	93	#define PROCESSOR_BASIC_INFO 1 /* basic information */
	94	#define PROCESSOR_CPU_LOAD_INFO 2 /* cpu load information */
	95	#define PROCESSOR_PM_REGS_INFO 0x10000001 /* performance monitor register info */
	96	#define PROCESSOR_TEMPERATURE 0x10000002 /* Processor core temperature */
	97
	98	struct processor_basic_info {
	99	cpu_type_t cpu_type; /* type of cpu */
	100	cpu_subtype_t cpu_subtype; /* subtype of cpu */
	101	boolean_t running; /* is processor running */
	102	int slot_num; /* slot number */
	103	boolean_t is_master; /* is this the master processor */
	104	};
	105
	106	typedef struct processor_basic_info processor_basic_info_data_t;
	107	typedef struct processor_basic_info *processor_basic_info_t;
91447636 A	108	#define PROCESSOR_BASIC_INFO_COUNT ((mach_msg_type_number_t) \
91447636 A	109	(sizeof(processor_basic_info_data_t)/sizeof(natural_t)))
1c79356b A	110
	111	struct processor_cpu_load_info { /* number of ticks while running... */
	112	unsigned long cpu_ticks[CPU_STATE_MAX]; /* ... in the given mode */
	113	};
	114
	115	typedef struct processor_cpu_load_info processor_cpu_load_info_data_t;
	116	typedef struct processor_cpu_load_info *processor_cpu_load_info_t;
91447636 A	117	#define PROCESSOR_CPU_LOAD_INFO_COUNT ((mach_msg_type_number_t) \
91447636 A	118	(sizeof(processor_cpu_load_info_data_t)/sizeof(natural_t)))
1c79356b A	119
	120	/*
	121	* Scaling factor for load_average, mach_factor.
	122	*/
	123	#define LOAD_SCALE 1000
	124
	125	typedef int processor_set_flavor_t;
	126	#define PROCESSOR_SET_BASIC_INFO 5 /* basic information */
	127
	128	struct processor_set_basic_info {
	129	int processor_count; /* How many processors */
	130	int default_policy; /* When others not enabled */
	131	};
	132
	133	typedef struct processor_set_basic_info processor_set_basic_info_data_t;
	134	typedef struct processor_set_basic_info *processor_set_basic_info_t;
91447636 A	135	#define PROCESSOR_SET_BASIC_INFO_COUNT ((mach_msg_type_number_t) \
91447636 A	136	(sizeof(processor_set_basic_info_data_t)/sizeof(natural_t)))
1c79356b A	137
	138	#define PROCESSOR_SET_LOAD_INFO 4 /* scheduling statistics */
	139
	140	struct processor_set_load_info {
	141	int task_count; /* How many tasks */
	142	int thread_count; /* How many threads */
	143	integer_t load_average; /* Scaled */
	144	integer_t mach_factor; /* Scaled */
	145	};
	146
	147	typedef struct processor_set_load_info processor_set_load_info_data_t;
	148	typedef struct processor_set_load_info *processor_set_load_info_t;
91447636 A	149	#define PROCESSOR_SET_LOAD_INFO_COUNT ((mach_msg_type_number_t) \
91447636 A	150	(sizeof(processor_set_load_info_data_t)/sizeof(natural_t)))
1c79356b	151
91447636	152	#ifdef PRIVATE
1c79356b	153
1c79356b	154	#define PROCESSOR_SET_ENABLED_POLICIES 3
91447636 A	155	#define PROCESSOR_SET_ENABLED_POLICIES_COUNT ((mach_msg_type_number_t) \
91447636 A	156	(sizeof(policy_t)/sizeof(natural_t)))
1c79356b A	157
	158	#define PROCESSOR_SET_TIMESHARE_DEFAULT 10
	159	#define PROCESSOR_SET_TIMESHARE_LIMITS 11
	160
	161	#define PROCESSOR_SET_RR_DEFAULT 20
	162	#define PROCESSOR_SET_RR_LIMITS 21
	163
	164	#define PROCESSOR_SET_FIFO_DEFAULT 30
	165	#define PROCESSOR_SET_FIFO_LIMITS 31
	166
91447636 A	167	#endif /* PRIVATE */
91447636 A	168
1c79356b	169	#endif /* _MACH_PROCESSOR_INFO_H_ */