[apple/xnu.git] / bsd / sys / kern_memorystatus.h

/*
 * Copyright (c) 2006 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@
 */
/*!
	@header kern_memorystatus.h
	This header defines a kernel event subclass for the OSMemoryNotification API
 */

#ifndef SYS_KERN_MEMORYSTATUS_H
#define SYS_KERN_MEMORYSTATUS_H

#ifndef MACH_KERNEL_PRIVATE

#include <stdint.h>
#include <sys/time.h>
#include <sys/proc.h>

/*
 * Define Memory Status event subclass.
 * Subclass of KEV_SYSTEM_CLASS
 */

/*!
	@defined KEV_MEMORYSTATUS_SUBCLASS
	@discussion The kernel event subclass for memory status events.
*/
#define KEV_MEMORYSTATUS_SUBCLASS        3

enum {
	kMemoryStatusLevelNote = 1,
	kMemoryStatusSnapshotNote = 2
};

enum {
	kMemoryStatusLevelAny = -1,
	kMemoryStatusLevelNormal = 0,
	kMemoryStatusLevelWarning = 1,
	kMemoryStatusLevelUrgent = 2,
	kMemoryStatusLevelCritical = 3
};

typedef struct jetsam_priority_entry {
	pid_t pid;
	uint32_t flags;
} jetsam_priority_entry_t;

/*
** maximum killable processes to keep track of
*/
#define kMaxPriorityEntries 64 

typedef struct jetsam_snapshot_entry {
	pid_t pid;
	char name[MAXCOMLEN+1];
	uint32_t pages;
	uint32_t flags;
	uint8_t uuid[16];
} jetsam_snapshot_entry_t;

/*
** how many processes to snapshot
*/
#define kMaxSnapshotEntries 128 

typedef struct jetsam_kernel_stats {
	uint32_t free_pages;
	uint32_t active_pages;
	uint32_t inactive_pages;
	uint32_t purgeable_pages;
	uint32_t wired_pages;
} jetsam_kernel_stats_t;

/*
** This is a variable-length struct.
** Allocate a buffer of the size returned by the sysctl, cast to a jetsam_snapshot_t *
*/

typedef struct jetsam_snapshot {
	jetsam_kernel_stats_t stats;
	size_t entry_count;
	jetsam_snapshot_entry_t entries[1];
} jetsam_snapshot_t;

enum {
	kJetsamFlagsFrontmost =	(1 << 0),
	kJetsamFlagsKilled =	(1 << 1)
};
#endif /* !MACH_KERNEL_PRIVATE */

#ifdef KERNEL
extern void kern_memorystatus_init(void) __attribute__((section("__TEXT, initcode")));

extern int kern_memorystatus_wakeup;
extern int kern_memorystatus_level;

#endif /* KERNEL */
#endif /* SYS_KERN_MEMORYSTATUS_H */
Commit	Line	Data
2d21ac55 A	1	/*
	2	* Copyright (c) 2006 Apple Computer, Inc. All rights reserved.
	3	*
	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
	24	* limitations under the License.
	25	*
	26	* @APPLE_OSREFERENCE_LICENSE_HEADER_END@
	27	*/
	28	/*!
	29	@header kern_memorystatus.h
	30	This header defines a kernel event subclass for the OSMemoryNotification API
	31	*/
	32
	33	#ifndef SYS_KERN_MEMORYSTATUS_H
	34	#define SYS_KERN_MEMORYSTATUS_H
	35
b0d623f7 A	36	#ifndef MACH_KERNEL_PRIVATE
	37
	38	#include <stdint.h>
	39	#include <sys/time.h>
	40	#include <sys/proc.h>
	41
2d21ac55 A	42	/*
	43	* Define Memory Status event subclass.
	44	* Subclass of KEV_SYSTEM_CLASS
	45	*/
	46
	47	/*!
	48	@defined KEV_MEMORYSTATUS_SUBCLASS
	49	@discussion The kernel event subclass for memory status events.
	50	*/
	51	#define KEV_MEMORYSTATUS_SUBCLASS 3
	52
b0d623f7 A	53	enum {
	54	kMemoryStatusLevelNote = 1,
	55	kMemoryStatusSnapshotNote = 2
	56	};
	57
2d21ac55 A	58	enum {
	59	kMemoryStatusLevelAny = -1,
	60	kMemoryStatusLevelNormal = 0,
	61	kMemoryStatusLevelWarning = 1,
	62	kMemoryStatusLevelUrgent = 2,
	63	kMemoryStatusLevelCritical = 3
	64	};
	65
b0d623f7 A	66	typedef struct jetsam_priority_entry {
	67	pid_t pid;
	68	uint32_t flags;
	69	} jetsam_priority_entry_t;
	70
	71	/*
	72	** maximum killable processes to keep track of
	73	*/
	74	#define kMaxPriorityEntries 64
	75
	76	typedef struct jetsam_snapshot_entry {
	77	pid_t pid;
	78	char name[MAXCOMLEN+1];
	79	uint32_t pages;
	80	uint32_t flags;
	81	uint8_t uuid[16];
	82	} jetsam_snapshot_entry_t;
	83
	84	/*
	85	** how many processes to snapshot
	86	*/
	87	#define kMaxSnapshotEntries 128
	88
	89	typedef struct jetsam_kernel_stats {
	90	uint32_t free_pages;
	91	uint32_t active_pages;
	92	uint32_t inactive_pages;
	93	uint32_t purgeable_pages;
	94	uint32_t wired_pages;
	95	} jetsam_kernel_stats_t;
	96
	97	/*
	98	** This is a variable-length struct.
	99	** Allocate a buffer of the size returned by the sysctl, cast to a jetsam_snapshot_t *
	100	*/
	101
	102	typedef struct jetsam_snapshot {
	103	jetsam_kernel_stats_t stats;
	104	size_t entry_count;
	105	jetsam_snapshot_entry_t entries[1];
	106	} jetsam_snapshot_t;
	107
	108	enum {
	109	kJetsamFlagsFrontmost = (1 << 0),
	110	kJetsamFlagsKilled = (1 << 1)
	111	};
	112	#endif /* !MACH_KERNEL_PRIVATE */
	113
2d21ac55 A	114	#ifdef KERNEL
	115	extern void kern_memorystatus_init(void) __attribute__((section("__TEXT, initcode")));
	116
	117	extern int kern_memorystatus_wakeup;
	118	extern int kern_memorystatus_level;
	119
	120	#endif /* KERNEL */
	121	#endif /* SYS_KERN_MEMORYSTATUS_H */