xnu-7195.101.1.tar.gz

[apple/xnu.git] / osfmk / mach_debug / zone_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.
 */
/*
 */

#ifndef _MACH_DEBUG_ZONE_INFO_H_
#define _MACH_DEBUG_ZONE_INFO_H_

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

/*
 *	Legacy definitions for host_zone_info().  This interface, and
 *	these definitions have been deprecated in favor of the new
 *	mach_zone_info() inteface and types below.
 */

#define ZONE_NAME_MAX_LEN               80

typedef struct zone_name {
	char            zn_name[ZONE_NAME_MAX_LEN];
} zone_name_t;

typedef zone_name_t *zone_name_array_t;


typedef struct zone_info {
	integer_t       zi_count;       /* Number of elements used now */
	vm_size_t       zi_cur_size;    /* current memory utilization */
	vm_size_t       zi_max_size;    /* how large can this zone grow */
	vm_size_t       zi_elem_size;   /* size of an element */
	vm_size_t       zi_alloc_size;  /* size used for more memory */
	integer_t       zi_pageable;    /* zone pageable? */
	integer_t       zi_sleepable;   /* sleep if empty? */
	integer_t       zi_exhaustible; /* merely return if empty? */
	integer_t       zi_collectable; /* garbage collect elements? */
} zone_info_t;

typedef zone_info_t *zone_info_array_t;


/*
 *	Remember to update the mig type definitions
 *	in mach_debug_types.defs when adding/removing fields.
 */

#define MACH_ZONE_NAME_MAX_LEN          80

typedef struct mach_zone_name {
	char            mzn_name[ZONE_NAME_MAX_LEN];
} mach_zone_name_t;

typedef mach_zone_name_t *mach_zone_name_array_t;

typedef struct mach_zone_info_data {
	uint64_t        mzi_count;      /* count of elements in use */
	uint64_t        mzi_cur_size;   /* current memory utilization */
	uint64_t        mzi_max_size;   /* how large can this zone grow */
	uint64_t        mzi_elem_size;  /* size of an element */
	uint64_t        mzi_alloc_size; /* size used for more memory */
	uint64_t        mzi_sum_size;   /* sum of all allocs (life of zone) */
	uint64_t        mzi_exhaustible;        /* merely return if empty? */
	uint64_t        mzi_collectable;        /* garbage collect elements? and how much? */
} mach_zone_info_t;

typedef mach_zone_info_t *mach_zone_info_array_t;

/*
 * The lowest bit of mzi_collectable indicates whether or not the zone
 * is collectable by zone_gc(). The higher bits contain the size in bytes
 * that can be collected.
 */
#define GET_MZI_COLLECTABLE_BYTES(val)  ((val) >> 1)
#define GET_MZI_COLLECTABLE_FLAG(val)   ((val) & 1)

#define SET_MZI_COLLECTABLE_BYTES(val, size)    \
	(val) = ((val) & 1) | ((size) << 1)
#define SET_MZI_COLLECTABLE_FLAG(val, flag)             \
	(val) = (flag) ? ((val) | 1) : (val)

typedef struct task_zone_info_data {
	uint64_t        tzi_count;      /* count of elements in use */
	uint64_t        tzi_cur_size;   /* current memory utilization */
	uint64_t        tzi_max_size;   /* how large can this zone grow */
	uint64_t        tzi_elem_size;  /* size of an element */
	uint64_t        tzi_alloc_size; /* size used for more memory */
	uint64_t        tzi_sum_size;   /* sum of all allocs (life of zone) */
	uint64_t        tzi_exhaustible;        /* merely return if empty? */
	uint64_t        tzi_collectable;        /* garbage collect elements? */
	uint64_t        tzi_caller_acct;        /* charged to caller (or kernel) */
	uint64_t        tzi_task_alloc; /* sum of all allocs by this task */
	uint64_t        tzi_task_free;  /* sum of all frees by this task */
} task_zone_info_t;

typedef task_zone_info_t *task_zone_info_array_t;

#define MACH_MEMORY_INFO_NAME_MAX_LEN   80

typedef struct mach_memory_info {
	uint64_t flags;
	uint64_t site;
	uint64_t size;
	uint64_t free;
	uint64_t largest;
	uint64_t collectable_bytes;
	uint64_t mapped;
	uint64_t peak;
	uint16_t tag;
	uint16_t zone;
	uint16_t _resvA[2];
	uint64_t _resv[3];
	char     name[MACH_MEMORY_INFO_NAME_MAX_LEN];
} mach_memory_info_t;

typedef mach_memory_info_t *mach_memory_info_array_t;

/*
 * MAX_ZTRACE_DEPTH configures how deep of a stack trace is taken on each zalloc in the zone of interest.  15
 * levels is usually enough to get past all the layers of code in kalloc and IOKit and see who the actual
 * caller is up above these lower levels.
 *
 * This is used both for the zone leak detector and the zone corruption log. Make sure this isn't greater than
 * BTLOG_MAX_DEPTH defined in btlog.h. Also make sure to update the definition of zone_btrecord_t in
 * mach_debug_types.defs if this changes.
 */

#define MAX_ZTRACE_DEPTH        15

/*
 * Opcodes for the btlog operation field:
 */

#define ZOP_ALLOC       1
#define ZOP_FREE        0

/*
 * Structure used to copy out btlog records to userspace, via the MIG call
 * mach_zone_get_btlog_records().
 */
typedef struct zone_btrecord {
	uint32_t    ref_count;                                  /* no. of active references on the record */
	uint32_t        operation_type;                         /* operation type (alloc/free) */
	uint64_t        bt[MAX_ZTRACE_DEPTH];           /* backtrace */
} zone_btrecord_t;

typedef zone_btrecord_t *zone_btrecord_array_t;

#endif  /* _MACH_DEBUG_ZONE_INFO_H_ */