1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
|
/* IBM_PROLOG_BEGIN_TAG */
/* This is an automatically generated prolog. */
/* */
/* $Source: src/include/usr/runtime/runtime.H $ */
/* */
/* IBM CONFIDENTIAL */
/* */
/* COPYRIGHT International Business Machines Corp. 2012,2013 */
/* */
/* p1 */
/* */
/* Object Code Only (OCO) source materials */
/* Licensed Internal Code Source Materials */
/* IBM HostBoot Licensed Internal Code */
/* */
/* The source code for this program is not published or otherwise */
/* divested of its trade secrets, irrespective of what has been */
/* deposited with the U.S. Copyright Office. */
/* */
/* Origin: 30 */
/* */
/* IBM_PROLOG_END_TAG */
#ifndef __RUNTIME_H
#define __RUNTIME_H
#include <stdint.h>
#include <builtins.h>
#include <errl/errlentry.H>
namespace RUNTIME
{
/**
* @brief Populate attributes in mainstore for HostServices
*
* @return errlHndl_t NULL on success
*/
errlHndl_t populate_attributes( void );
/**
* @brief Populate node attributes in mainstore for HostServices
*
* @return errlHndl_t NULL on Success
*/
errlHndl_t populate_node_attributes( uint64_t i_nodeNum );
/**
* @brief Add the host data mainstore location to VMM
*
* @description If running with the standard PHYP payload this function
* will map all supported HDAT sections into the VMM to allow access
* from user space. When running in standalone (no payload) mode,
* some reserved memory will be mapped in for testcases. If AVPs are
* enabled, no memory will be mapped and the PAYLOAD_KIND attribute
* will be set appropriately.
*
* @return errlHndl_t NULL on success
*/
errlHndl_t load_host_data( void );
/**
* HDAT Sections
*/
enum SectionId
{
HSVC_NODE_DATA, //< HostServices Node Attributes
HSVC_SYSTEM_DATA, //< HostServices System Attributes
IPLPARMS_SYSTEM, //< IPL Parms
MS_DUMP_SRC_TBL, //< MDST: Memory Dump Source Table
MS_DUMP_DST_TBL, //< MDDT: Memory Dump Destination Table
MS_DUMP_RESULTS_TBL, //< MDRT: Memory Dump Results Table
SPIRA_S, //< SPIRA-S
SPIRA_H, //< SPIRA-H
SPIRA_L, //< Legacy SPIRA
NACA, //< NACA
};
/**
* @brief Get a pointer to the beginning of a particular section of
* the host data memory.
*
* @description The returned pointer will not include any header hdat header
* information.
*
* @param[in] i_section Chunk of data to find
* @param[in] i_instance Instance of section when there are multiple entries
* @param[out] o_dataAddr Physical memory address of data
* @param[out] o_dataSize Size of data in bytes, 0 on error, DATA_SIZE_UNKNOWN if unknown
*
* @return errlHndl_t NULL on success
*/
errlHndl_t get_host_data_section( SectionId i_section,
uint64_t i_instance,
uint64_t& o_dataAddr,
size_t& o_dataSize );
const size_t DATA_SIZE_UNKNOWN = 0xFFFFFFFFFFFFFFFF;
/**
* @brief Update the actual count of section. Only supported for
* memory dump results table
*
* @param[in] i_section Chunk of data to find
* @param[out] i_count Actual countPhysical memory address of data
*
* @return errlHndl_t NULL on success
*/
errlHndl_t update_host_data_section_actual( SectionId i_section,
uint16_t i_count );
/**
* @brief This function updates the actual count for the MDRT
* May be called at anytime, but the actual value is updated
* to the SPIRA during populate_attributes
*
*/
void update_MDRT_Count(uint16_t i_count);
/**
* @brief This function writes the stored count for the MDRT
* out to the SPIRA
*
* @return errlHndl_t
*/
errlHndl_t write_MDRT_Count(void);
/*
* @brief Retrieve and log FFDC data relevant to a given section of
* host data memory
*
* @param[in] i_section Relevant section
* @param[inout] io_errlog Log to append FFDC to
*
* @return errlHndl_t NULL on success
*/
void add_host_data_ffdc( SectionId i_section,
errlHndl_t& io_errlog );
}
#endif
|
