From mboxrd@z Thu Jan 1 00:00:00 1970 From: Damien Millescamps Subject: Re: [vmxnet3 PATCH] doc: describe kernel dependency and --vmware-tsc-map Date: Fri, 26 Jul 2013 11:01:18 +0200 Message-ID: <51F23ADE.9070104@6wind.com> References: <1374784721-18184-1-git-send-email-thomas.monjalon@6wind.com> Mime-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit To: dev-VfR2kkLFssw@public.gmane.org Return-path: In-Reply-To: <1374784721-18184-1-git-send-email-thomas.monjalon-pdR9zngts4EAvxtiuMwx3w@public.gmane.org> List-Id: patches and discussions about DPDK List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces-VfR2kkLFssw@public.gmane.org Sender: "dev" On 07/25/2013 10:38 PM, Thomas Monjalon wrote: > Be more verbose on kernel dependency about version and parameters. > And add description of DPDK parameter for VMware. > > Signed-off-by: Thomas Monjalon > --- > README.rst | 17 ++++++++++++----- > 1 file changed, 12 insertions(+), 5 deletions(-) > > diff --git a/README.rst b/README.rst > index 55436a4..c718ec7 100644 > --- a/README.rst > +++ b/README.rst > @@ -49,6 +49,9 @@ HOW TO BUILD > > There are two build dependencies: Linux kernel headers and DPDK >= 1.2.3r3. > > +The kernel driver is based on vmxnet3-8.6.10 from VMware ESXi-5.0.0u2. > +So the latest supported Linux version is 3.2. > + > DPDK must be built first in order to have all its header files in the same > directory, that RTE_INCLUDE must point to. > > @@ -93,15 +96,19 @@ Other parameters have a global effect: > - ``num_rxds=int``: number of RX descriptors per queue > - ``num_txds=int``: number of TX descriptors per queue > > +Because the kernel module initializes interfaces, **it's very important that > +DPDK parameters match kernel ones**. It won't work otherwise. > + > For more information, use ``modinfo vmxnet3-usermap.ko``. > > -The values of the kernel module parameters must match the DPDK ones. > +In userland, librte_pmd_vmxnet3.so must be loaded by the DPDK using the ``-d`` > +option. > > -Because the kernel module initializes interfaces, it's very important that > -DPDK parameters match kernel ones. It won't work otherwise. > +Another interesting option is ``--vmware-tsc-map``. > +It allows VMware TSC mapping which provides an access to physical TSC. > +When this option is used, take care of setting this ESXi parameter:: > > -In userland, librte_pmd_vmxnet3.so must be loaded by the DPDK using the "-d" > -option. > + monitor_control.pseudo_perfctr = TRUE > > ``testpmd`` example for two ports, matching the ``insmod`` command above:: > ack