vpd-manager: Add module VPD sanity check

Added new dbus API to perform the santity check for all the vpds.
It takes one eeprom path at a time and checks for it's header, TOC
and all it's records.

Test:
	busctl introspect com.ibm.VPD.Manager /com/ibm/VPD/Manager com.ibm.VPD.Manager
	NAME                             TYPE      SIGNATURE RESULT/VALUE FLAGS
	.CollectFRUVPD                   method    o         -            -
	.GetExpandedLocationCode         method    sq        s            -
	.GetFRUsByExpandedLocationCode   method    s         ao           -
	.GetFRUsByUnexpandedLocationCode method    sq        ao           -
	.GetHardwarePath                 method    o         s            -
	.PerformVPDRecollection          method    -         -            -
	.ReadKeyword                     method    sv        v            -
	.UpdateKeyword                   method    sv        i            -
	.WriteKeyword                    method    ossay     i            -
	.WriteKeywordOnHardware          method    sv        i            -
	.deleteFRUVPD                    method    o         -            -
        .performVpdSanityCheck          method    s         -            -
	.CollectionStatus                property  s         "Completed"  emits-change writable

	busctl  call com.ibm.VPD.Manager /com/ibm/VPD/Manager com.ibm.VPD.Manager performVpdSanityCheck  s "/sys/bus/spi/drivers/at25/spi12.0/eeprom"

	Journal-
	vpd-manager[1078]: FileName: /usr/src/debug/openpower-fru-vpd/1.0+git/vpd-manager/src/ipz_parser.cpp, Line: 1011 Performing sanity check for file path: /sys/bus/spi/drivers/at25/spi12.0/eeprom
	vpd-manager[1078]: FileName: /usr/src/debug/openpower-fru-vpd/1.0+git/vpd-manager/src/ipz_parser.cpp, Line: 206 DBG: test purpose:checkHeader done
	vpd-manager[1078]: FileName: /usr/src/debug/openpower-fru-vpd/1.0+git/vpd-manager/src/ipz_parser.cpp, Line: 246 DBG: test purpose:readTOC done
	vpd-manager[1078]: FileName: /usr/src/debug/openpower-fru-vpd/1.0+git/vpd-manager/src/ipz_parser.cpp, Line: 297 DBG: test purpose:readPT done
	vpd-manager[1078]: FileName: /usr/src/debug/openpower-fru-vpd/1.0+git/vpd-manager/src/ipz_parser.cpp, Line: 1023 SUCCESS

busctl  call com.ibm.VPD.Manager /com/ibm/VPD/Manager com.ibm.VPD.Manager performVpdSanityCheck  s ""

   "0x50003D0E": {
        "SRC":                  "BD554000",
        "Message":              "An EEPROM path access error occurred.",
        "PLID":                 "0x50003D0E",
        "CreatorID":            "BMC",
        "Subsystem":            "CEC Hardware - VPD Interface",
        "Commit Time":          "09/05/2025 09:10:03",
        "Sev":                  "Informational Event",
        "CompID":               "bmc vpd"
Signed-off-by: Alpana Kumari <[email protected]>

Author: Alpana07

vpd-manager/include/ipz_parser.hpp

@@ -106,6 +106,13 @@ class IpzVpdParser : public ParserInterface
      */
     int writeKeywordOnHardware(const types::WriteVpdParams i_paramsToWriteData);
 
+    /**
+     * @brief API to perform sanity check on EEPROM.
+     *
+     * @return SUCCESS or FAILURE.
+     */
+    int vpdSanityCheck();
+
   private:
     /**
      * @brief Check ECC of VPD header.

vpd-manager/include/manager.hpp

@@ -203,6 +203,15 @@ class Manager
      */
     void performVpdRecollection();
 
+    /**
+     * @brief API to perform sanity check on EEPROM.
+     *
+     * @param[in] i_vpdPath - EEPROM path
+     *
+     * @return SUCCESS or FAILURE.
+     */
+    int performVpdSanityCheck(const types::Path i_vpdPath);
+
     /**
      * @brief Get unexpanded location code.
      *

vpd-manager/include/parser_interface.hpp

@@ -61,6 +61,15 @@ class ParserInterface
         return -1;
     }
 
+    /**
+     * @brief API to perform sanity check on EEPROM.
+     *
+     * @return SUCCESS or FAILURE.
+     */
+    virtual int vpdSanityCheck()
+    {
+        return -1;
+    }
     /**
      * @brief Virtual destructor.
      */

vpd-manager/src/ipz_parser.cpp

@@ -272,6 +272,8 @@ std::pair<types::RecordOffsetList, types::InvalidRecordList>
             // Verify the ECC for this Record
             if (!recordEccCheck(itrToPT))
             {
+                logging::logMessage(
+                    "ERROR: ECC check failed for [" + recordName + "]");
                 throw(EccException("ERROR: ECC check failed"));
             }
         }
@@ -996,4 +998,34 @@ bool IpzVpdParser::processInvalidRecords(
     }
     return l_rc;
 }
+
+int IpzVpdParser::vpdSanityCheck()
+{
+    try
+    {
+        logging::logMessage(
+            "Performing sanity check for file path: " + m_vpdFilePath);
+        auto itrToVPD = m_vpdVector.cbegin();
+
+        // Check vaidity of VHDR record
+        checkHeader(itrToVPD);
+
+        // Read the table of contents
+        auto ptLen = readTOC(itrToVPD);
+
+        // Read the table of contents record, to get offsets to other records.
+        auto l_result = readPT(itrToVPD, ptLen);
+
+        logging::logMessage("SUCCESS");
+        return constants::SUCCESS;
+    }
+    catch (const std::exception& e)
+    {
+        logging::logMessage(
+            "FAILED: Exception caught [" + std::string(e.what()) + "]");
+
+        return constants::FAILURE;
+    }
+}
+
 } // namespace vpd

vpd-manager/src/manager.cpp

@@ -121,6 +121,11 @@ Manager::Manager(
             this->performVpdRecollection();
         });
 
+        iFace->register_method("performVpdSanityCheck",
+                               [this](const types::Path i_vpdPath) {
+                                   this->performVpdSanityCheck(i_vpdPath);
+                               });
+
         // Indicates FRU VPD collection for the system has not started.
         iFace->register_property_rw<std::string>(
             "CollectionStatus", sdbusplus::vtable::property_::emits_change,
@@ -640,4 +645,42 @@ void Manager::performVpdRecollection()
         m_worker->performVpdRecollection();
     }
 }
+
+int Manager::performVpdSanityCheck(const types::Path i_vpdPath)
+{
+    try
+    {
+        if (i_vpdPath.empty())
+        {
+            throw std::runtime_error("Given FRU path is empty");
+        }
+
+        nlohmann::json l_sysCfgJsonObj{};
+
+        if (m_worker.get() != nullptr)
+        {
+            l_sysCfgJsonObj = m_worker->getSysCfgJsonObj();
+        }
+
+        std::shared_ptr<Parser> l_parserObj =
+            std::make_shared<Parser>(i_vpdPath, l_sysCfgJsonObj);
+
+        std::shared_ptr<vpd::ParserInterface> l_vpdParserInstance =
+            l_parserObj->getVpdParserInstance();
+
+        return l_vpdParserInstance->vpdSanityCheck();
+    }
+    catch (const std::exception& l_exception)
+    {
+        EventLogger::createAsyncPel(
+            types::ErrorType::InvalidEeprom, types::SeverityType::Informational,
+            __FILE__, __FUNCTION__, 0,
+            "Sanity check failed for file[" + i_vpdPath +
+                "], reason: " + std::string(l_exception.what()),
+            std::nullopt, std::nullopt, std::nullopt, std::nullopt);
+
+        return constants::FAILURE;
+    }
+}
+
 } // namespace vpd