xref: /optee_os/lib/libutee/arch/arm/gprof/gmon_out.h (revision 883c4be3d11cacf49665f51d1d6af4c02a0a0afd)

/*
 * Copyright (c) 2016, Linaro Limited
 * All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions are met:
 *
 * 1. Redistributions of source code must retain the above copyright notice,
 * this list of conditions and the following disclaimer.
 *
 * 2. Redistributions in binary form must reproduce the above copyright notice,
 * this list of conditions and the following disclaimer in the documentation
 * and/or other materials provided with the distribution.
 *
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
 * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
 * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 * POSSIBILITY OF SUCH DAMAGE.
 */

/*
 * gmon.out file format
 *
 * This file is adapted from glibc's gmon/sys/gmon_out.h
 * Although gmon/sys/gmon_out.h is covered by the LGPL v2.1 license or later
 * as stated below, please note the following:
 * (https://www.gnu.org/licenses/lgpl-3.0.en.html#section3)
 *
 * "3. Object Code Incorporating Material from Library Header Files.
 *  The object code form of an Application may incorporate material from a
 *  header file that is part of the Library. You may convey such object code
 *  under terms of your choice, provided that, if the incorporated material
 *  is not limited to numerical parameters, data structure layouts and
 *  accessors, or small macros, inline functions and templates (ten or fewer
 *  lines in length), you do both of the following: [...]"
 *
 * The code below is indeed limited to data structure layouts.
 */

/*
 * Copyright (C) 1996-2016 Free Software Foundation, Inc.
 * This file is part of the GNU C Library.
 * Contributed by David Mosberger <davidm@cs.arizona.edu>.
 *
 * The GNU C Library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation; either
 * version 2.1 of the License, or (at your option) any later version.
 *
 * The GNU C Library is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public
 * License along with the GNU C Library; if not, see
 * <http://www.gnu.org/licenses/>.
 */

/*
 * This file specifies the format of gmon.out files.  It should have
 * as few external dependencies as possible as it is going to be included
 * in many different programs.  That is, minimize the number of #include's.
 *
 * A gmon.out file consists of a header (defined by gmon_hdr) followed by
 * a sequence of records.  Each record starts with a one-byte tag
 * identifying the type of records, followed by records specific data.
 */

#ifndef GMON_OUT_H
#define GMON_OUT_H

#define	GMON_MAGIC	"gmon"	/* magic cookie */
#define GMON_VERSION	1	/* version number */

/*
 * Raw header as it appears on file (without padding).  This header
 * always comes first in gmon.out and is then followed by a series
 * records defined below.
 * Virtual addresses are stored as uintptr_t, gprof knows which size to expect
 * because the executable file is provided.
 */
struct gmon_hdr {
	char cookie[4];
	int32_t version;
	char spare[3 * 4];
} __packed;

/* types of records in this file: */
enum gmon_record_tag {
	GMON_TAG_TIME_HIST = 0,
	GMON_TAG_CG_ARC = 1,
	GMON_TAG_BB_COUNT = 2
};

struct gmon_hist_hdr {
	uintptr_t low_pc;	/* base pc address of sample buffer */
	uintptr_t high_pc;	/* max pc address of sampled buffer */
	uint32_t hist_size;	/* size of sample buffer */
	uint32_t prof_rate;	/* profiling clock rate */
	char dimen[15];		/* phys. dim., usually "seconds" */
	char dimen_abbrev;	/* usually 's' for "seconds" */
} __packed;

struct gmon_cg_arc_record {
	uintptr_t from_pc;	/* address within caller's body */
	uintptr_t self_pc;	/* address within callee's body */
	int32_t count;		/* number of arc traversals */
} __packed;

#endif /* GMON_OUT_H */