osfmk/kern/zalloc.h

90  *	A zone is a collection of fixed size blocks for which there
92  *	use zones to manage data structures dynamically, creating a zone
97 struct zone {
100 	decl_lck_mtx_data(,lock)	/* zone lock */
102 	lck_attr_t      lock_attr;	/* zone lock attribute */
103 	lck_grp_t       lock_grp;	/* zone lock group */
104 	lck_grp_attr_t  lock_grp_attr;	/* zone lock group attribute */
106 	vm_size_t	max_size;	/* how large can this zone grow */
109 	uint64_t	sum_count;	/* count of allocs (life of zone) */
113 	/* boolean_t */	expandable :1,	/* (T) expand zone (with message)? */
115 	/* boolean_t */	doing_alloc :1,	/* is zone expanding now? */
128 	int		index;		/* index into zone_info arrays for this zone */
129 	struct zone *	next_zone;	/* Link for all-zones list */
131 	const char	*zone_name;	/* a name for the zone */
139 	uint32_t zleak_capture;		/* per-zone counter for capturing every N allocations */
150  *	structure for tracking zone usage
151  *	Used either one per task/thread for all zones or <per-task,per-zone>.
163 /* Steal memory for zone module */
166 /* Bootstrap zone module (create zone zone) */
169 /* Init zone module */
173 /* Handle per-task zone info */
210 /* Allocate from zone */
212 					zone_t		zone);
214 /* Free zone element */
216 					zone_t		zone,
219 /* Create zone */
224 					const char	*name);		/* a name for the zone */
229 					zone_t		zone);
233 					zone_t		zone,
236 /* Get from zone free list */
238 					zone_t		zone);
240 /* Fill zone with memory */
242 					zone_t		zone,
246 /* Initially fill zone with specified number of elements */
248 					zone_t		zone,
251 /* Change zone parameters */
253 					zone_t			zone,
258 #define Z_EXHAUST	1	/* Make zone exhaustible	*/
259 #define Z_COLLECT	2	/* Make zone collectable	*/
260 #define Z_EXPAND	3	/* Make zone expandable		*/
261 #define	Z_FOREIGN	4	/* Allow collectable zone to contain foreign elements */
263 #define Z_NOENCRYPT	6	/* Don't encrypt zone during hibernation */
264 #define Z_NOCALLOUT 	7	/* Don't asynchronously replenish the zone via
269 /* Preallocate space for zone from zone map */
271 					zone_t		zone,
275 						zone_t		zone);
278  * MAX_ZTRACE_DEPTH configures how deep of a stack trace is taken on each zalloc in the zone of interest.  15
282  * This is used both for the zone leak detector and the zone corruption log.
319 #define lock_zone(zone)					\
321 	lck_mtx_lock_spin(&(zone)->lock);		\
324 #define unlock_zone(zone)				\
326 	lck_mtx_unlock(&(zone)->lock);			\