xref: /optee_os/lib/libutee/include/pta_gprof.h (revision 75200110483dcee11cdcf4cef3d0ac4d92f63c14)
1 /*
2  * Copyright (c) 2016, Linaro Limited
3  * All rights reserved.
4  *
5  * Redistribution and use in source and binary forms, with or without
6  * modification, are permitted provided that the following conditions are met:
7  *
8  * 1. Redistributions of source code must retain the above copyright notice,
9  * this list of conditions and the following disclaimer.
10  *
11  * 2. Redistributions in binary form must reproduce the above copyright notice,
12  * this list of conditions and the following disclaimer in the documentation
13  * and/or other materials provided with the distribution.
14  *
15  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
16  * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
17  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
18  * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
19  * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
20  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
21  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
22  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
23  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
24  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
25  * POSSIBILITY OF SUCH DAMAGE.
26  */
27 
28 #ifndef __PTA_GPROF_H
29 #define __PTA_GPROF_H
30 
31 /*
32  * Interface to the gprof pseudo-TA, which is used by libutee to control TA
33  * profiling and forward data to tee-supplicant.
34  */
35 
36 #define PTA_GPROF_UUID { 0x2f6e0d48, 0xc574, 0x426d, { \
37 			 0x82, 0x4e, 0x40, 0x19, 0x8c, 0xde, 0x5c, 0xac } }
38 
39 /*
40  * Send TA profiling data (gmon.out format) to tee-supplicant
41  * Data may be sent in several chunks: first set id to 0, then re-use the
42  * allocated value in subsequent calls.
43  *
44  * [in/out] value[0].a: id
45  * [in]     memref[1]: profiling data
46  */
47 #define PTA_GPROF_SEND			0
48 
49 /*
50  * Start PC sampling of a user TA session
51  *
52  * [in/out] memref[0]: sampling buffer
53  * [in]     value[1].a: offset: the lowest PC value in the TA
54  * [in]     value[1].b: scale: histogram scaling factor
55  */
56 #define PTA_GPROF_START_PC_SAMPLING	1
57 
58 /*
59  * Stop PC sampling of a user TA session and retrieve data
60  *
61  * [out] value[0].a: sampling frequency
62  */
63 #define PTA_GPROF_STOP_PC_SAMPLING	2
64 
65 #endif /* __PTA_GPROF_H */
66