29/11/2024 05:32, Sivaprasad Tummala: > Added section for installing and building the E-SMI library > for AMD EPYC Uncore support and version requirements. > > Signed-off-by: Sivaprasad Tummala <sivaprasad.tumm...@amd.com> > --- > doc/guides/prog_guide/power_man.rst | 32 +++++++++++++++++++++++++++++ > 1 file changed, 32 insertions(+) > > diff --git a/doc/guides/prog_guide/power_man.rst > b/doc/guides/prog_guide/power_man.rst > index 74039e5786..d367a81596 100644 > --- a/doc/guides/prog_guide/power_man.rst > +++ b/doc/guides/prog_guide/power_man.rst > @@ -249,6 +249,38 @@ Additionally, the EPYC System Management Interface > In-band Library for Linux > offers essential API, enabling user-space software > to effectively manage system functions. > > +E-SMI Installation > +------------------ > + > +To build DPDK with AMD EPYC Uncore the user is required to download the e-smi > +library from `here <https://github.com/amd/esmi_ib_library>`_ > +and compile it on their user system before building DPDK. > + > +.. code-block:: console > + > + cd esmi_ib_library > + cmake . > + sudo make install > + cp /opt/e-sms/e_smi/lib/* /usr/local/lib/* > + cp /opt/e-sms/e_smi/include/* /usr/local/include/*
Why copying the files? You can specify the directories in an environment variable. There is no pkg-config file? > + > +Library file, header and tool are installed at /opt/e-sms. > + > +Note: Library is dependent on amd_hsmp.h header and without this, > compilation will break. Yes, it does not compile on my machine (with Linux 6.12): e_smi.c:566:27: error: ‘HSMP_GET_RAPL_UNITS’ undeclared What should I do? > + > +The library requires CMake (v3.5.0) to be built. > + > +As a reference, the following table shows a mapping between the DPDK versions > +and the E-SMI library and kernel version supported by them: > + > +.. table:: DPDK and E-SMI library and kernel version compatibility > + > + ============== ============== ===================== > + DPDK version E-SMI version Linux Kernel version > + ============== ============== ===================== > + 24.11+ 4.0.0 6.7+ > + ============== ============== =====================
