From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mails.dpdk.org (mails.dpdk.org [217.70.189.124]) by inbox.dpdk.org (Postfix) with ESMTP id 56D5D45DCE; Fri, 29 Nov 2024 17:39:51 +0100 (CET) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id E0E5C402AE; Fri, 29 Nov 2024 17:39:50 +0100 (CET) Received: from mail-pf1-f176.google.com (mail-pf1-f176.google.com [209.85.210.176]) by mails.dpdk.org (Postfix) with ESMTP id 7AD8B4014F for ; Fri, 29 Nov 2024 17:39:49 +0100 (CET) Received: by mail-pf1-f176.google.com with SMTP id d2e1a72fcca58-7250c199602so1746623b3a.1 for ; Fri, 29 Nov 2024 08:39:49 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=networkplumber-org.20230601.gappssmtp.com; s=20230601; t=1732898388; x=1733503188; darn=dpdk.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:subject:cc:to:from:date:from:to:cc:subject:date :message-id:reply-to; bh=/klhuK/0XCN7bfi8kwbuj892GUfUFjvuCsl52IAOw9o=; b=XppdsRcisfb1hGq97X+f1EYXi3cgvP9gvSPSAe5LHY8C8rOobiRs2Cw4uFQd3ZTmuu 8B1cC+9MAjcVuz5wezkQiEkxGd9E8ELPCgpfuAIcfzbd9yQrDCN3P02SPKXC2ubORRJv f202oaohFWHjIvimCd1slm0NOmQeSATvyV+NDWble9Cg/DBS5NvII+f2qFAO32UupCQI rxbsjf/RmcHuk5f+Ef5d57TyPMX2REK8uvwug+BXzeeNZP3UDfzAtVh7FpR7bSjSX0Iu S5L0TZfQbaXsIOlkTi93Rx0pekrvojS+0niTXhdGf6LsiaTBZSBgQYuQJOm/Tq8gufCa pAGQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1732898388; x=1733503188; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:subject:cc:to:from:date:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=/klhuK/0XCN7bfi8kwbuj892GUfUFjvuCsl52IAOw9o=; b=gEWka/dmOeg/8QECEzPhs6Ad+1a0qBPkOndiA21O9hmh+yhrhskIgTtDHa53gFURgE dyqgp1OLGbMZwqGtHsBxRxZQ2Tboapo/orWPyaDkO38HDi1HGkTvZfUxIKO4f8ZLswgp ogJg4asa2Pj417W9gTnYEV+eMHoBnj/IVuBCbB6UKBn0ysLHM3nsv6AD1bvbTG9uhp/W d2Lbst1wWC2kczduP+IC4qnrLijwADxFNEhSfccyJQ85sGVwu4I2BygLL0ugL1VeN/Sc uwn0yk5MSdCa9TRA4+rQ+hd6ohif/7RXarbvZmjbf99vAnF3skyexMIKSAm4ipc3SsfG zLqw== X-Forwarded-Encrypted: i=1; AJvYcCXAcOogEt+OAeUaPTE3jsDOh/MyhMS4WXdgND1ltvtmINNifIE/aPQ/2cokH1ti46lpp5I=@dpdk.org X-Gm-Message-State: AOJu0YwJ9dwGYvfPhZ7xDu5WgSVZuxUizxXHD/v/IjvRtlOT0clVFPnd EtQI8yvwRTuvv9T4RqOdL0FbDMP6plYkPi4ctKf7Mp60JlktBXh/9woPsnkmaHY= X-Gm-Gg: ASbGnctGd0SipCn7Zl0nb2icRKPfFHUp3938HqZpzEFXUbER7j/tSAm9SwzueZSRB2F qMQeRw9jG2Hu0Tjt7XK+UmHk95w0omiu+7+nMgKF5lMBk+DJimP+LDPL2MNOYY8rZdDqPGODDHZ 20psFq6kfT9uhGBBjLgCtiCYQIVo1M0wLcIYTlGC+bV0gZsNTBOvPPq3nzmzLOwoigMsKJRiZto 3t8gPnPzxoSBuCoMv6CM0dndoysWBKktDOq6csdcAmx6mnPTjV1SXfs0U9+/5PYko3eR43aEEvH hP5F+Eq9OwThpgghny2H1mBT+x8= X-Google-Smtp-Source: AGHT+IGS9YwhLCySbT65zbPvCwOIdYCHJZi4H1S9slmz5iT8I+raCD/rrldrdUwSx/oJL5++rz2vpQ== X-Received: by 2002:a05:6a00:1c8d:b0:725:3bd4:9b56 with SMTP id d2e1a72fcca58-7253bd49c85mr13442827b3a.5.1732898388413; Fri, 29 Nov 2024 08:39:48 -0800 (PST) Received: from hermes.local (204-195-96-226.wavecable.com. [204.195.96.226]) by smtp.gmail.com with ESMTPSA id 41be03b00d2f7-7fc9c387ac9sm3303839a12.60.2024.11.29.08.39.47 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 29 Nov 2024 08:39:48 -0800 (PST) Date: Fri, 29 Nov 2024 08:39:30 -0800 From: Stephen Hemminger To: Sivaprasad Tummala Cc: , , , , , , , , , Subject: Re: [PATCH] power/amd_uncore: add e-smi installation instructions Message-ID: <20241129083930.6595763c@hermes.local> In-Reply-To: <20241129043207.999912-1-sivaprasad.tummala@amd.com> References: <20231219032826.4814-1-sivaprasad.tummala@amd.com> <20241129043207.999912-1-sivaprasad.tummala@amd.com> MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org On Fri, 29 Nov 2024 04:32:07 +0000 Sivaprasad Tummala wrote: > Added section for installing and building the E-SMI library > for AMD EPYC Uncore support and version requirements. > > Signed-off-by: Sivaprasad Tummala > --- > 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 `_ > +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/* > + > +Library file, header and tool are installed at /opt/e-sms. The DPDK should always recommend users use the packages provided by their distro. This project should work with distros to package this like any other library. Build instructions belong in the project, not in DPDK. The project will change its build instructions and DPDK will get out of date. > + > +Note: Library is dependent on amd_hsmp.h header and without this, compilation will break. > + > +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+ > + ============== ============== ===================== The library needs to have stable API's and work in any kernel that supports the system calls it uses. But that is for it to learn. DPDK should just say (in the programmer's guide) to use E-SMI 4.0 or later.