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
|
/* 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
{
FIRST_SECTION, //< Placeholder for arrays
HSVC_NODE_DATA = FIRST_SECTION, //< 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
LAST_SECTION = NACA //< Placeholder for arrays
};
/**
* @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 Store the actual count of a section in local memory.
*
* @param[in] i_section Chunk of data to update
* @param[in] i_count Actual number of entries
*
*/
void saveActualCount( RUNTIME::SectionId i_id,
uint16_t i_count );
/**
* @brief Write the stored actual count to SPIRA
*
* @param[in] i_section Chunk of data to update
*
* @return errlHndl_t NULL on success
*/
errlHndl_t writeActualCount( RUNTIME::SectionId i_id );
/*
* @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
|
