1 /**
2  * Copyright © 2019 IBM Corporation
3  *
4  * Licensed under the Apache License, Version 2.0 (the "License");
5  * you may not use this file except in compliance with the License.
6  * You may obtain a copy of the License at
7  *
8  *     http://www.apache.org/licenses/LICENSE-2.0
9  *
10  * Unless required by applicable law or agreed to in writing, software
11  * distributed under the License is distributed on an "AS IS" BASIS,
12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13  * See the License for the specific language governing permissions and
14  * limitations under the License.
15  */
16 #include "config.h"
17 
18 #include "../bcd_time.hpp"
19 #include "../json_utils.hpp"
20 #include "../paths.hpp"
21 #include "../pel.hpp"
22 #include "../pel_types.hpp"
23 #include "../pel_values.hpp"
24 #include "trace.hpp"
25 
26 #include <Python.h>
27 #include <fmt/format.h>
28 
29 #include <CLI/CLI.hpp>
30 #include <bitset>
31 #include <fstream>
32 #include <iostream>
33 #include <regex>
34 #include <string>
35 #include <xyz/openbmc_project/Common/File/error.hpp>
36 
37 #include "config_main.h"
38 
39 namespace fs = std::filesystem;
40 using namespace openpower::pels;
41 namespace file_error = sdbusplus::xyz::openbmc_project::Common::File::Error;
42 namespace message = openpower::pels::message;
43 namespace pv = openpower::pels::pel_values;
44 
45 const uint8_t critSysTermSeverity = 0x51;
46 
47 using PELFunc = std::function<void(const PEL&, bool hexDump)>;
48 message::Registry registry(getPELReadOnlyDataPath() / message::registryFileName,
49                            false);
50 namespace service
51 {
52 constexpr auto logging = "xyz.openbmc_project.Logging";
53 } // namespace service
54 
55 namespace interface
56 {
57 constexpr auto deleteObj = "xyz.openbmc_project.Object.Delete";
58 constexpr auto deleteAll = "xyz.openbmc_project.Collection.DeleteAll";
59 } // namespace interface
60 
61 namespace object_path
62 {
63 constexpr auto logEntry = "/xyz/openbmc_project/logging/entry/";
64 constexpr auto logging = "/xyz/openbmc_project/logging";
65 } // namespace object_path
66 
67 std::string pelLogDir()
68 {
69     return std::string(EXTENSION_PERSIST_DIR) + "/pels/logs";
70 }
71 
72 /**
73  * @brief helper function to get PEL commit timestamp from file name
74  * @retrun uint64_t - PEL commit timestamp
75  * @param[in] std::string - file name
76  */
77 uint64_t fileNameToTimestamp(const std::string& fileName)
78 {
79     std::string token = fileName.substr(0, fileName.find("_"));
80     int i = 0;
81     uint64_t bcdTime = 0;
82     if (token.length() >= 14)
83     {
84         try
85         {
86             auto tmp = std::stoul(token.substr(i, 2), 0, 16);
87             bcdTime |= (static_cast<uint64_t>(tmp) << 56);
88         }
89         catch (const std::exception& err)
90         {
91             std::cout << "Conversion failure: " << err.what() << std::endl;
92         }
93         i += 2;
94         try
95         {
96             auto tmp = std::stoul(token.substr(i, 2), 0, 16);
97             bcdTime |= (static_cast<uint64_t>(tmp) << 48);
98         }
99         catch (const std::exception& err)
100         {
101             std::cout << "Conversion failure: " << err.what() << std::endl;
102         }
103         i += 2;
104         try
105         {
106             auto tmp = std::stoul(token.substr(i, 2), 0, 16);
107             bcdTime |= (static_cast<uint64_t>(tmp) << 40);
108         }
109         catch (const std::exception& err)
110         {
111             std::cout << "Conversion failure: " << err.what() << std::endl;
112         }
113         i += 2;
114         try
115         {
116             auto tmp = std::stoul(token.substr(i, 2), 0, 16);
117             bcdTime |= (static_cast<uint64_t>(tmp) << 32);
118         }
119         catch (const std::exception& err)
120         {
121             std::cout << "Conversion failure: " << err.what() << std::endl;
122         }
123         i += 2;
124         try
125         {
126             auto tmp = std::stoul(token.substr(i, 2), 0, 16);
127             bcdTime |= (tmp << 24);
128         }
129         catch (const std::exception& err)
130         {
131             std::cout << "Conversion failure: " << err.what() << std::endl;
132         }
133         i += 2;
134         try
135         {
136             auto tmp = std::stoul(token.substr(i, 2), 0, 16);
137             bcdTime |= (tmp << 16);
138         }
139         catch (const std::exception& err)
140         {
141             std::cout << "Conversion failure: " << err.what() << std::endl;
142         }
143         i += 2;
144         try
145         {
146             auto tmp = std::stoul(token.substr(i, 2), 0, 16);
147             bcdTime |= (tmp << 8);
148         }
149         catch (const std::exception& err)
150         {
151             std::cout << "Conversion failure: " << err.what() << std::endl;
152         }
153         i += 2;
154         try
155         {
156             auto tmp = std::stoul(token.substr(i, 2), 0, 16);
157             bcdTime |= tmp;
158         }
159         catch (const std::exception& err)
160         {
161             std::cout << "Conversion failure: " << err.what() << std::endl;
162         }
163     }
164     return bcdTime;
165 }
166 
167 /**
168  * @brief helper function to get PEL id from file name
169  * @retrun uint32_t - PEL id
170  * @param[in] std::string - file name
171  */
172 uint32_t fileNameToPELId(const std::string& fileName)
173 {
174     uint32_t num = 0;
175     try
176     {
177         num = std::stoul(fileName.substr(fileName.find("_") + 1), 0, 16);
178     }
179     catch (const std::exception& err)
180     {
181         std::cout << "Conversion failure: " << err.what() << std::endl;
182     }
183     return num;
184 }
185 
186 /**
187  * @brief helper function to check string suffix
188  * @retrun bool - true with suffix matches
189  * @param[in] std::string - string to check for suffix
190  * @param[in] std::string - suffix string
191  */
192 bool ends_with(const std::string& str, const std::string& end)
193 {
194     size_t slen = str.size(), elen = end.size();
195     if (slen < elen)
196         return false;
197     while (elen)
198     {
199         if (str[--slen] != end[--elen])
200             return false;
201     }
202     return true;
203 }
204 
205 /**
206  * @brief get data form raw PEL file.
207  * @param[in] std::string Name of file with raw PEL
208  * @return std::vector<uint8_t> char vector read from raw PEL file.
209  */
210 std::vector<uint8_t> getFileData(const std::string& name)
211 {
212     std::ifstream file(name, std::ifstream::in);
213     if (file.good())
214     {
215         std::vector<uint8_t> data{std::istreambuf_iterator<char>(file),
216                                   std::istreambuf_iterator<char>()};
217         return data;
218     }
219     else
220     {
221         return {};
222     }
223 }
224 
225 /**
226  * @brief Initialize Python interpreter and gather all UD parser modules under
227  *        the paths found in Python sys.path and the current user directory.
228  *        This is to prevent calling a non-existant module which causes Python
229  *        to print an import error message and breaking JSON output.
230  *
231  * @return std::vector<std::string> Vector of plugins found in filesystem
232  */
233 std::vector<std::string> getPlugins()
234 {
235     Py_Initialize();
236     std::vector<std::string> plugins;
237     std::vector<std::string> siteDirs;
238     std::array<std::string, 2> parserDirs = {"udparsers", "srcparsers"};
239     PyObject* pName = PyUnicode_FromString("sys");
240     PyObject* pModule = PyImport_Import(pName);
241     Py_XDECREF(pName);
242     PyObject* pDict = PyModule_GetDict(pModule);
243     Py_XDECREF(pModule);
244     PyObject* pResult = PyDict_GetItemString(pDict, "path");
245     PyObject* pValue = PyUnicode_FromString(".");
246     PyList_Append(pResult, pValue);
247     Py_XDECREF(pValue);
248     auto list_size = PyList_Size(pResult);
249     for (auto i = 0; i < list_size; i++)
250     {
251         PyObject* item = PyList_GetItem(pResult, i);
252         PyObject* pBytes = PyUnicode_AsEncodedString(item, "utf-8", "~E~");
253         const char* output = PyBytes_AS_STRING(pBytes);
254         Py_XDECREF(pBytes);
255         std::string tmpStr(output);
256         siteDirs.push_back(tmpStr);
257     }
258     for (const auto& dir : siteDirs)
259     {
260         for (const auto& parserDir : parserDirs)
261         {
262             if (fs::exists(dir + "/" + parserDir))
263             {
264                 for (const auto& entry :
265                      fs::directory_iterator(dir + "/" + parserDir))
266                 {
267                     if (entry.is_directory() and
268                         fs::exists(entry.path().string() + "/" +
269                                    entry.path().stem().string() + ".py"))
270                     {
271                         plugins.push_back(entry.path().stem());
272                     }
273                 }
274             }
275         }
276     }
277     return plugins;
278 }
279 
280 /**
281  * @brief Creates JSON string of a PEL entry if fullPEL is false or prints to
282  *        stdout the full PEL in JSON if fullPEL is true
283  * @param[in] itr - std::map iterator of <uint32_t, BCDTime>
284  * @param[in] hidden - Boolean to include hidden PELs
285  * @param[in] includeInfo - Boolean to include informational PELs
286  * @param[in] critSysTerm - Boolean to include critical error and system
287  * termination PELs
288  * @param[in] fullPEL - Boolean to print full JSON representation of PEL
289  * @param[in] foundPEL - Boolean to check if any PEL is present
290  * @param[in] scrubRegex - SRC regex object
291  * @param[in] plugins - Vector of strings of plugins found in filesystem
292  * @param[in] hexDump - Boolean to print hexdump of PEL instead of JSON
293  * @return std::string - JSON string of PEL entry (empty if fullPEL is true)
294  */
295 template <typename T>
296 std::string genPELJSON(T itr, bool hidden, bool includeInfo, bool critSysTerm,
297                        bool fullPEL, bool& foundPEL,
298                        const std::optional<std::regex>& scrubRegex,
299                        const std::vector<std::string>& plugins, bool hexDump,
300                        bool archive)
301 {
302     std::size_t found;
303     std::string val;
304     char tmpValStr[50];
305     std::string listStr;
306     char name[51];
307     sprintf(name, "/%.2X%.2X%.2X%.2X%.2X%.2X%.2X%.2X_%.8X",
308             static_cast<uint8_t>((itr.second >> 56) & 0xFF),
309             static_cast<uint8_t>((itr.second >> 48) & 0xFF),
310             static_cast<uint8_t>((itr.second >> 40) & 0xFF),
311             static_cast<uint8_t>((itr.second >> 32) & 0xFF),
312             static_cast<uint8_t>((itr.second >> 24) & 0xFF),
313             static_cast<uint8_t>((itr.second >> 16) & 0xFF),
314             static_cast<uint8_t>((itr.second >> 8) & 0xFF),
315             static_cast<uint8_t>(itr.second & 0xFF), itr.first);
316 
317     auto fileName = (archive ? pelLogDir() + "/archive" : pelLogDir()) + name;
318     try
319     {
320         std::vector<uint8_t> data = getFileData(fileName);
321         if (data.empty())
322         {
323             trace::error(fmt::format("Empty PEL file {}", fileName));
324             return listStr;
325         }
326         PEL pel{data};
327         if (!pel.valid())
328         {
329             return listStr;
330         }
331         if (!includeInfo && pel.userHeader().severity() == 0)
332         {
333             return listStr;
334         }
335         if (critSysTerm && pel.userHeader().severity() != critSysTermSeverity)
336         {
337             return listStr;
338         }
339         std::bitset<16> actionFlags{pel.userHeader().actionFlags()};
340         if (!hidden && actionFlags.test(hiddenFlagBit))
341         {
342             return listStr;
343         }
344         if (pel.primarySRC() && scrubRegex)
345         {
346             val = pel.primarySRC().value()->asciiString();
347             if (std::regex_search(trimEnd(val), scrubRegex.value(),
348                                   std::regex_constants::match_not_null))
349             {
350                 return listStr;
351             }
352         }
353         if (hexDump)
354         {
355             std::cout << dumpHex(std::data(pel.data()), pel.size(), 0, false)
356                       << std::endl;
357         }
358         else if (fullPEL)
359         {
360             if (!foundPEL)
361             {
362                 std::cout << "[\n";
363                 foundPEL = true;
364             }
365             else
366             {
367                 std::cout << ",\n\n";
368             }
369             pel.toJSON(registry, plugins);
370         }
371         else
372         {
373             // id
374             listStr += "    \"" +
375                        getNumberString("0x%X", pel.privateHeader().id()) +
376                        "\": {\n";
377             // ASCII
378             if (pel.primarySRC())
379             {
380                 val = pel.primarySRC().value()->asciiString();
381                 jsonInsert(listStr, "SRC", trimEnd(val), 2);
382 
383                 // Registry message
384                 auto regVal = pel.primarySRC().value()->getErrorDetails(
385                     registry, DetailLevel::message, true);
386                 if (regVal)
387                 {
388                     val = regVal.value();
389                     jsonInsert(listStr, "Message", val, 2);
390                 }
391             }
392             else
393             {
394                 jsonInsert(listStr, "SRC", "No SRC", 2);
395             }
396 
397             // platformid
398             jsonInsert(listStr, "PLID",
399                        getNumberString("0x%X", pel.privateHeader().plid()), 2);
400 
401             // creatorid
402             std::string creatorID =
403                 getNumberString("%c", pel.privateHeader().creatorID());
404             val = pv::creatorIDs.count(creatorID) ? pv::creatorIDs.at(creatorID)
405                                                   : "Unknown Creator ID";
406             jsonInsert(listStr, "CreatorID", val, 2);
407 
408             // subsystem
409             std::string subsystem = pv::getValue(pel.userHeader().subsystem(),
410                                                  pel_values::subsystemValues);
411             jsonInsert(listStr, "Subsystem", subsystem, 2);
412 
413             // commit time
414             sprintf(tmpValStr, "%02X/%02X/%02X%02X %02X:%02X:%02X",
415                     pel.privateHeader().commitTimestamp().month,
416                     pel.privateHeader().commitTimestamp().day,
417                     pel.privateHeader().commitTimestamp().yearMSB,
418                     pel.privateHeader().commitTimestamp().yearLSB,
419                     pel.privateHeader().commitTimestamp().hour,
420                     pel.privateHeader().commitTimestamp().minutes,
421                     pel.privateHeader().commitTimestamp().seconds);
422             jsonInsert(listStr, "Commit Time", tmpValStr, 2);
423 
424             // severity
425             std::string severity = pv::getValue(pel.userHeader().severity(),
426                                                 pel_values::severityValues);
427             jsonInsert(listStr, "Sev", severity, 2);
428 
429             // compID
430             jsonInsert(listStr, "CompID",
431                        getNumberString(
432                            "0x%X", pel.privateHeader().header().componentID),
433                        2);
434 
435             found = listStr.rfind(",");
436             if (found != std::string::npos)
437             {
438                 listStr.replace(found, 1, "");
439                 listStr += "    },\n";
440             }
441             foundPEL = true;
442         }
443     }
444     catch (const std::exception& e)
445     {
446         trace::error(fmt::format("Hit exception when reading PEL file {}: {}",
447                                  fileName, e.what()));
448     }
449     return listStr;
450 }
451 
452 /**
453  * @brief Print a list of PELs or a JSON array of PELs
454  * @param[in] order - Boolean to print in reverse orser
455  * @param[in] hidden - Boolean to include hidden PELs
456  * @param[in] includeInfo - Boolean to include informational PELs
457  * @param[in] critSysTerm - Boolean to include critical error and system
458  * termination PELs
459  * @param[in] fullPEL - Boolean to print full PEL into a JSON array
460  * @param[in] scrubRegex - SRC regex object
461  * @param[in] hexDump - Boolean to print hexdump of PEL instead of JSON
462  */
463 void printPELs(bool order, bool hidden, bool includeInfo, bool critSysTerm,
464                bool fullPEL, const std::optional<std::regex>& scrubRegex,
465                bool hexDump, bool archive = false)
466 {
467     std::string listStr;
468     std::vector<std::pair<uint32_t, uint64_t>> PELs;
469     std::vector<std::string> plugins;
470     listStr = "{\n";
471     for (auto it = (archive ? fs::directory_iterator(pelLogDir() + "/archive")
472                             : fs::directory_iterator(pelLogDir()));
473          it != fs::directory_iterator(); ++it)
474     {
475         if (!fs::is_regular_file((*it).path()))
476         {
477             continue;
478         }
479         else
480         {
481             PELs.emplace_back(fileNameToPELId((*it).path().filename()),
482                               fileNameToTimestamp((*it).path().filename()));
483         }
484     }
485 
486     // Sort the pairs based on second time parameter
487     std::sort(PELs.begin(), PELs.end(), [](auto& left, auto& right) {
488         return left.second < right.second;
489     });
490 
491     bool foundPEL = false;
492 
493     if (fullPEL && !hexDump)
494     {
495         plugins = getPlugins();
496     }
497     auto buildJSON = [&listStr, &hidden, &includeInfo, &critSysTerm, &fullPEL,
498                       &foundPEL, &scrubRegex, &plugins, &hexDump,
499                       &archive](const auto& i) {
500         listStr += genPELJSON(i, hidden, includeInfo, critSysTerm, fullPEL,
501                               foundPEL, scrubRegex, plugins, hexDump, archive);
502     };
503     if (order)
504     {
505         std::for_each(PELs.rbegin(), PELs.rend(), buildJSON);
506     }
507     else
508     {
509         std::for_each(PELs.begin(), PELs.end(), buildJSON);
510     }
511     if (hexDump)
512     {
513         return;
514     }
515     if (foundPEL)
516     {
517         if (fullPEL)
518         {
519             std::cout << "]" << std::endl;
520         }
521         else
522         {
523             std::size_t found;
524             found = listStr.rfind(",");
525             if (found != std::string::npos)
526             {
527                 listStr.replace(found, 1, "");
528                 listStr += "}\n";
529                 printf("%s", listStr.c_str());
530             }
531         }
532     }
533     else
534     {
535         std::string emptyJSON = fullPEL ? "[]" : "{}";
536         std::cout << emptyJSON << std::endl;
537     }
538 }
539 
540 /**
541  * @brief Calls the function passed in on the PEL with the ID
542  *        passed in.
543  *
544  * @param[in] id - The string version of the PEL or BMC Log ID, either with or
545  *                 without the 0x prefix.
546  * @param[in] func - The std::function<void(const PEL&, bool hexDump)> function
547  *                   to run.
548  * @param[in] useBMC - if true, search by BMC Log ID, else search by PEL ID
549  * @param[in] hexDump - Boolean to print hexdump of PEL instead of JSON
550  */
551 void callFunctionOnPEL(const std::string& id, const PELFunc& func,
552                        bool useBMC = false, bool hexDump = false,
553                        bool archive = false)
554 {
555     std::string pelID{id};
556     if (!useBMC)
557     {
558         std::transform(pelID.begin(), pelID.end(), pelID.begin(), toupper);
559 
560         if (pelID.find("0X") == 0)
561         {
562             pelID.erase(0, 2);
563         }
564     }
565 
566     bool found = false;
567 
568     for (auto it = (archive ? fs::directory_iterator(pelLogDir() + "/archive")
569                             : fs::directory_iterator(pelLogDir()));
570          it != fs::directory_iterator(); ++it)
571     {
572         // The PEL ID is part of the filename, so use that to find the PEL if
573         // "useBMC" is set to false, otherwise we have to search within the PEL
574 
575         if (!fs::is_regular_file((*it).path()))
576         {
577             continue;
578         }
579 
580         if ((ends_with((*it).path(), pelID) && !useBMC) || useBMC)
581         {
582             auto data = getFileData((*it).path());
583             if (!data.empty())
584             {
585                 PEL pel{data};
586                 if (!useBMC ||
587                     (useBMC && pel.obmcLogID() == std::stoul(id, nullptr, 0)))
588                 {
589                     found = true;
590                     try
591                     {
592                         func(pel, hexDump);
593                         break;
594                     }
595                     catch (const std::exception& e)
596                     {
597                         std::cerr << " Internal function threw an exception: "
598                                   << e.what() << "\n";
599                         exit(1);
600                     }
601                 }
602             }
603             else
604             {
605                 std::cerr << "Could not read PEL file\n";
606                 exit(1);
607             }
608         }
609     }
610 
611     if (!found)
612     {
613         std::cerr << "PEL not found\n";
614         exit(1);
615     }
616 }
617 
618 /**
619  * @brief Delete a PEL file.
620  *
621  * @param[in] id - The PEL ID to delete.
622  */
623 void deletePEL(const std::string& id)
624 {
625     std::string pelID{id};
626 
627     std::transform(pelID.begin(), pelID.end(), pelID.begin(), toupper);
628 
629     if (pelID.find("0X") == 0)
630     {
631         pelID.erase(0, 2);
632     }
633 
634     for (auto it = fs::directory_iterator(pelLogDir());
635          it != fs::directory_iterator(); ++it)
636     {
637         if (ends_with((*it).path(), pelID))
638         {
639             fs::remove((*it).path());
640         }
641     }
642 }
643 
644 /**
645  * @brief Delete all PEL files.
646  */
647 void deleteAllPELs()
648 {
649     trace::info("peltool deleting all event logs");
650 
651     for (const auto& entry : fs::directory_iterator(pelLogDir()))
652     {
653         if (!fs::is_regular_file(entry.path()))
654         {
655             continue;
656         }
657         fs::remove(entry.path());
658     }
659 }
660 
661 /**
662  * @brief Display a single PEL
663  *
664  * @param[in] pel - the PEL to display
665  * @param[in] hexDump - Boolean to print hexdump of PEL instead of JSON
666  */
667 void displayPEL(const PEL& pel, bool hexDump)
668 {
669     if (pel.valid())
670     {
671         if (hexDump)
672         {
673             std::string dstr =
674                 dumpHex(std::data(pel.data()), pel.size(), 0, false);
675             std::cout << dstr << std::endl;
676         }
677         else
678         {
679             auto plugins = getPlugins();
680             pel.toJSON(registry, plugins);
681         }
682     }
683     else
684     {
685         std::cerr << "PEL was malformed\n";
686         exit(1);
687     }
688 }
689 
690 /**
691  * @brief Print number of PELs
692  * @param[in] hidden - Bool to include hidden logs
693  * @param[in] includeInfo - Bool to include informational logs
694  * @param[in] critSysTerm - Bool to include CritSysTerm
695  * @param[in] scrubRegex - SRC regex object
696  */
697 void printPELCount(bool hidden, bool includeInfo, bool critSysTerm,
698                    const std::optional<std::regex>& scrubRegex)
699 {
700     std::size_t count = 0;
701 
702     for (auto it = fs::directory_iterator(pelLogDir());
703          it != fs::directory_iterator(); ++it)
704     {
705         if (!fs::is_regular_file((*it).path()))
706         {
707             continue;
708         }
709         std::vector<uint8_t> data = getFileData((*it).path());
710         if (data.empty())
711         {
712             continue;
713         }
714         PEL pel{data};
715         if (!pel.valid())
716         {
717             continue;
718         }
719         if (!includeInfo && pel.userHeader().severity() == 0)
720         {
721             continue;
722         }
723         if (critSysTerm && pel.userHeader().severity() != critSysTermSeverity)
724         {
725             continue;
726         }
727         std::bitset<16> actionFlags{pel.userHeader().actionFlags()};
728         if (!hidden && actionFlags.test(hiddenFlagBit))
729         {
730             continue;
731         }
732         if (pel.primarySRC() && scrubRegex)
733         {
734             std::string val = pel.primarySRC().value()->asciiString();
735             if (std::regex_search(trimEnd(val), scrubRegex.value(),
736                                   std::regex_constants::match_not_null))
737             {
738                 continue;
739             }
740         }
741         count++;
742     }
743     std::cout << "{\n"
744               << "    \"Number of PELs found\": "
745               << getNumberString("%d", count) << "\n}\n";
746 }
747 
748 /**
749  * @brief Generate regex pattern object from file contents
750  * @param[in] scrubFile - File containing regex pattern
751  * @return std::regex - SRC regex object
752  */
753 std::regex genRegex(std::string& scrubFile)
754 {
755     std::string pattern;
756     std::ifstream contents(scrubFile);
757     if (contents.fail())
758     {
759         std::cerr << "Can't open \"" << scrubFile << "\"\n";
760         exit(1);
761     }
762     std::string line;
763     while (std::getline(contents, line))
764     {
765         if (!line.empty())
766         {
767             pattern.append(line + "|");
768         }
769     }
770     try
771     {
772         std::regex scrubRegex(pattern, std::regex::icase);
773         return scrubRegex;
774     }
775     catch (const std::regex_error& e)
776     {
777         if (e.code() == std::regex_constants::error_collate)
778             std::cerr << "Invalid collating element request\n";
779         else if (e.code() == std::regex_constants::error_ctype)
780             std::cerr << "Invalid character class\n";
781         else if (e.code() == std::regex_constants::error_escape)
782             std::cerr << "Invalid escape character or trailing escape\n";
783         else if (e.code() == std::regex_constants::error_backref)
784             std::cerr << "Invalid back reference\n";
785         else if (e.code() == std::regex_constants::error_brack)
786             std::cerr << "Mismatched bracket ([ or ])\n";
787         else if (e.code() == std::regex_constants::error_paren)
788         {
789             // to catch return code error_badrepeat when error_paren is retured
790             // instead
791             size_t pos = pattern.find_first_of("*+?{");
792             while (pos != std::string::npos)
793             {
794                 if (pos == 0 || pattern.substr(pos - 1, 1) == "|")
795                 {
796                     std::cerr
797                         << "A repetition character (*, ?, +, or {) was not "
798                            "preceded by a valid regular expression\n";
799                     exit(1);
800                 }
801                 pos = pattern.find_first_of("*+?{", pos + 1);
802             }
803             std::cerr << "Mismatched parentheses (( or ))\n";
804         }
805         else if (e.code() == std::regex_constants::error_brace)
806             std::cerr << "Mismatched brace ({ or })\n";
807         else if (e.code() == std::regex_constants::error_badbrace)
808             std::cerr << "Invalid range inside a { }\n";
809         else if (e.code() == std::regex_constants::error_range)
810             std::cerr << "Invalid character range (e.g., [z-a])\n";
811         else if (e.code() == std::regex_constants::error_space)
812             std::cerr << "Insufficient memory to handle regular expression\n";
813         else if (e.code() == std::regex_constants::error_badrepeat)
814             std::cerr << "A repetition character (*, ?, +, or {) was not "
815                          "preceded by a valid regular expression\n";
816         else if (e.code() == std::regex_constants::error_complexity)
817             std::cerr << "The requested match is too complex\n";
818         else if (e.code() == std::regex_constants::error_stack)
819             std::cerr << "Insufficient memory to evaluate a match\n";
820         exit(1);
821     }
822 }
823 
824 static void exitWithError(const std::string& help, const char* err)
825 {
826     std::cerr << "ERROR: " << err << std::endl << help << std::endl;
827     exit(-1);
828 }
829 
830 int main(int argc, char** argv)
831 {
832     CLI::App app{"OpenBMC PEL Tool"};
833     std::string fileName;
834     std::string idPEL;
835     std::string bmcId;
836     std::string idToDelete;
837     std::string scrubFile;
838     std::optional<std::regex> scrubRegex;
839     bool listPEL = false;
840     bool listPELDescOrd = false;
841     bool hidden = false;
842     bool includeInfo = false;
843     bool critSysTerm = false;
844     bool deleteAll = false;
845     bool showPELCount = false;
846     bool fullPEL = false;
847     bool hexDump = false;
848     bool archive = false;
849 
850     app.set_help_flag("--help", "Print this help message and exit");
851     app.add_option("--file", fileName, "Display a PEL using its Raw PEL file");
852     app.add_option("-i, --id", idPEL, "Display a PEL based on its ID");
853     app.add_option("--bmc-id", bmcId,
854                    "Display a PEL based on its BMC Event ID");
855     app.add_flag("-a", fullPEL, "Display all PELs");
856     app.add_flag("-l", listPEL, "List PELs");
857     app.add_flag("-n", showPELCount, "Show number of PELs");
858     app.add_flag("-r", listPELDescOrd, "Reverse order of output");
859     app.add_flag("-h", hidden, "Include hidden PELs");
860     app.add_flag("-f,--info", includeInfo, "Include informational PELs");
861     app.add_flag("-t, --termination", critSysTerm,
862                  "List only critical system terminating PELs");
863     app.add_option("-d, --delete", idToDelete, "Delete a PEL based on its ID");
864     app.add_flag("-D, --delete-all", deleteAll, "Delete all PELs");
865     app.add_option("-s, --scrub", scrubFile,
866                    "File containing SRC regular expressions to ignore");
867     app.add_flag("-x", hexDump, "Display PEL(s) in hexdump instead of JSON");
868     app.add_flag("--archive", archive, "List or display archived PELs");
869 
870     CLI11_PARSE(app, argc, argv);
871 
872     if (!fileName.empty())
873     {
874         std::vector<uint8_t> data = getFileData(fileName);
875         if (!data.empty())
876         {
877             PEL pel{data};
878             if (hexDump)
879             {
880                 std::string dstr =
881                     dumpHex(std::data(pel.data()), pel.size(), 0, false);
882                 std::cout << dstr << std::endl;
883             }
884             else
885             {
886                 auto plugins = getPlugins();
887                 pel.toJSON(registry, plugins);
888             }
889         }
890         else
891         {
892             exitWithError(app.help("", CLI::AppFormatMode::All),
893                           "Raw PEL file can't be read.");
894         }
895     }
896     else if (!idPEL.empty())
897     {
898         callFunctionOnPEL(idPEL, displayPEL, false, hexDump, archive);
899     }
900     else if (!bmcId.empty())
901     {
902         callFunctionOnPEL(bmcId, displayPEL, true, hexDump, archive);
903     }
904     else if (fullPEL || listPEL)
905     {
906         if (!scrubFile.empty())
907         {
908             scrubRegex = genRegex(scrubFile);
909         }
910         printPELs(listPELDescOrd, hidden, includeInfo, critSysTerm, fullPEL,
911                   scrubRegex, hexDump, archive);
912     }
913     else if (showPELCount)
914     {
915         if (!scrubFile.empty())
916         {
917             scrubRegex = genRegex(scrubFile);
918         }
919         printPELCount(hidden, includeInfo, critSysTerm, scrubRegex);
920     }
921     else if (!idToDelete.empty())
922     {
923         deletePEL(idToDelete);
924     }
925     else if (deleteAll)
926     {
927         deleteAllPELs();
928     }
929     else
930     {
931         std::cout << app.help("", CLI::AppFormatMode::All) << std::endl;
932     }
933     Py_Finalize();
934     return 0;
935 }
936