16552de05SJayanth Othayoth #pragma once 26552de05SJayanth Othayoth 32eb31ad2SJayanth Othayoth #include <phal_exception.H> 42eb31ad2SJayanth Othayoth 56552de05SJayanth Othayoth #include <nlohmann/json.hpp> 66552de05SJayanth Othayoth 76552de05SJayanth Othayoth #include <string> 86552de05SJayanth Othayoth #include <vector> 96552de05SJayanth Othayoth namespace openpower 106552de05SJayanth Othayoth { 116552de05SJayanth Othayoth namespace pel 126552de05SJayanth Othayoth { 136552de05SJayanth Othayoth using FFDCData = std::vector<std::pair<std::string, std::string>>; 146552de05SJayanth Othayoth 156552de05SJayanth Othayoth using json = nlohmann::json; 166552de05SJayanth Othayoth 172eb31ad2SJayanth Othayoth using namespace openpower::phal; 182eb31ad2SJayanth Othayoth 196552de05SJayanth Othayoth /** 20*8fe9ff91SJayanth Othayoth * @brief Create PEL with additional parameters and callout 216552de05SJayanth Othayoth * 22*8fe9ff91SJayanth Othayoth * @param[in] event - the event type 236552de05SJayanth Othayoth * @param[in] calloutData - callout data to append to PEL 24*8fe9ff91SJayanth Othayoth * @param[in] ffdcData - failure data to append to PEL 256552de05SJayanth Othayoth */ 26*8fe9ff91SJayanth Othayoth void createErrorPEL(const std::string& event, const json& calloutData = {}, 27*8fe9ff91SJayanth Othayoth const FFDCData& ffdcData = {}); 286552de05SJayanth Othayoth 296552de05SJayanth Othayoth /** 30fe37aea0SJayanth Othayoth * @brief Create SBE boot error PEL and return id 312eb31ad2SJayanth Othayoth * 322eb31ad2SJayanth Othayoth * @param[in] event - the event type 332eb31ad2SJayanth Othayoth * @param[in] sbeError - SBE error object 342eb31ad2SJayanth Othayoth * @param[in] ffdcData - failure data to append to PEL 35fe37aea0SJayanth Othayoth * @return Platform log id 362eb31ad2SJayanth Othayoth */ 37fe37aea0SJayanth Othayoth uint32_t createSbeErrorPEL(const std::string& event, const sbeError_t& sbeError, 382eb31ad2SJayanth Othayoth const FFDCData& ffdcData); 392eb31ad2SJayanth Othayoth 402eb31ad2SJayanth Othayoth /** 41a8d2f710SJayanth Othayoth * @brief Create a PEL for the specified event type and additional data 426552de05SJayanth Othayoth * 432eb31ad2SJayanth Othayoth * @param[in] event - the event type 44a8d2f710SJayanth Othayoth * @param[in] ffdcData - failure data to append to PEL 456552de05SJayanth Othayoth */ 46a8d2f710SJayanth Othayoth void createPEL(const std::string& event, const FFDCData& ffdcData = {}); 476552de05SJayanth Othayoth 486552de05SJayanth Othayoth /** 496552de05SJayanth Othayoth * @class FFDCFile 506552de05SJayanth Othayoth * @brief This class is used to create ffdc data file and to get fd 516552de05SJayanth Othayoth */ 526552de05SJayanth Othayoth class FFDCFile 536552de05SJayanth Othayoth { 546552de05SJayanth Othayoth public: 556552de05SJayanth Othayoth FFDCFile() = delete; 566552de05SJayanth Othayoth FFDCFile(const FFDCFile&) = delete; 576552de05SJayanth Othayoth FFDCFile& operator=(const FFDCFile&) = delete; 586552de05SJayanth Othayoth FFDCFile(FFDCFile&&) = delete; 596552de05SJayanth Othayoth FFDCFile& operator=(FFDCFile&&) = delete; 606552de05SJayanth Othayoth 616552de05SJayanth Othayoth /** 626552de05SJayanth Othayoth * Used to pass json object to create unique ffdc file by using 636552de05SJayanth Othayoth * passed json data. 646552de05SJayanth Othayoth */ 656552de05SJayanth Othayoth explicit FFDCFile(const json& pHALCalloutData); 666552de05SJayanth Othayoth 676552de05SJayanth Othayoth /** 686552de05SJayanth Othayoth * Used to remove created ffdc file. 696552de05SJayanth Othayoth */ 706552de05SJayanth Othayoth ~FFDCFile(); 716552de05SJayanth Othayoth 726552de05SJayanth Othayoth /** 736552de05SJayanth Othayoth * Used to get created ffdc file file descriptor id. 746552de05SJayanth Othayoth * 756552de05SJayanth Othayoth * @return file descriptor id 766552de05SJayanth Othayoth */ 776552de05SJayanth Othayoth int getFileFD() const; 786552de05SJayanth Othayoth 796552de05SJayanth Othayoth private: 806552de05SJayanth Othayoth /** 816552de05SJayanth Othayoth * Used to store callout ffdc data from passed json object. 826552de05SJayanth Othayoth */ 836552de05SJayanth Othayoth std::string calloutData; 846552de05SJayanth Othayoth 856552de05SJayanth Othayoth /** 866552de05SJayanth Othayoth * Used to store unique ffdc file name. 876552de05SJayanth Othayoth */ 886552de05SJayanth Othayoth std::string calloutFile; 896552de05SJayanth Othayoth 906552de05SJayanth Othayoth /** 916552de05SJayanth Othayoth * Used to store created ffdc file descriptor id. 926552de05SJayanth Othayoth */ 936552de05SJayanth Othayoth int fileFD; 946552de05SJayanth Othayoth 956552de05SJayanth Othayoth /** 966552de05SJayanth Othayoth * Used to create ffdc file to pass PEL api for creating 976552de05SJayanth Othayoth * pel records. 986552de05SJayanth Othayoth * 996552de05SJayanth Othayoth * @return NULL 1006552de05SJayanth Othayoth */ 1016552de05SJayanth Othayoth void prepareFFDCFile(); 1026552de05SJayanth Othayoth 1036552de05SJayanth Othayoth /** 1046552de05SJayanth Othayoth * Create unique ffdc file. 1056552de05SJayanth Othayoth * 1066552de05SJayanth Othayoth * @return NULL 1076552de05SJayanth Othayoth */ 1086552de05SJayanth Othayoth void createCalloutFile(); 1096552de05SJayanth Othayoth 1106552de05SJayanth Othayoth /** 1116552de05SJayanth Othayoth * Used write json object value into created file. 1126552de05SJayanth Othayoth * 1136552de05SJayanth Othayoth * @return NULL 1146552de05SJayanth Othayoth */ 1156552de05SJayanth Othayoth void writeCalloutData(); 1166552de05SJayanth Othayoth 1176552de05SJayanth Othayoth /** 1186552de05SJayanth Othayoth * Used set ffdc file seek position begining to consume by PEL 1196552de05SJayanth Othayoth * 1206552de05SJayanth Othayoth * @return NULL 1216552de05SJayanth Othayoth */ 1226552de05SJayanth Othayoth void setCalloutFileSeekPos(); 1236552de05SJayanth Othayoth 1246552de05SJayanth Othayoth /** 1256552de05SJayanth Othayoth * Used to remove created ffdc file. 1266552de05SJayanth Othayoth * 1276552de05SJayanth Othayoth * @return NULL 1286552de05SJayanth Othayoth */ 1296552de05SJayanth Othayoth void removeCalloutFile(); 1306552de05SJayanth Othayoth 1316552de05SJayanth Othayoth }; // FFDCFile end 1326552de05SJayanth Othayoth 1336552de05SJayanth Othayoth } // namespace pel 1346552de05SJayanth Othayoth } // namespace openpower 135