From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mail-we0-f177.google.com (mail-we0-f177.google.com [74.125.82.177]) by dpdk.org (Postfix) with ESMTP id 7CB3858EE for ; Thu, 25 Jul 2013 22:38:23 +0200 (CEST) Received: by mail-we0-f177.google.com with SMTP id m46so1121418wev.36 for ; Thu, 25 Jul 2013 13:38:46 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=20120113; h=from:to:subject:date:message-id:x-mailer:x-gm-message-state; bh=1Cks2d/B3dtIQU9S7Mg7Mu/vGjhn7nq11tuhqONh17k=; b=IAD/zdoR0evUy36beJtD4a/YZ2v9flO9TErmQojOUG+fgeCQL6eblYpwvcthrw3Fm9 3u+z/8QH1QVTcyeL4eOvBhE7glpl/rAWRGr59pfawz9XYbFAZZXF74NOfFWySqF4L4Q7 0vh+TzVEmYkDVr99I1dH0zhDyA4WA0GS8DDjBAtCU0UGNHXofOylMCywtPYK88JQ9Tat kBBb1OO3ONrDcuO4neSvFxvgsZ6OQ58sfggw/+Oo6P7/nsKpMbZz2Muuk6BT1bnoQEbN 6ACGe0AIoVvJRqwrN+p6rsn7/lKWH2BlBiVgdxbFaNkosrVvbw3EAYX2ZJI4tulB1L2x Pr+Q== X-Received: by 10.194.123.199 with SMTP id mc7mr31917158wjb.35.1374784725848; Thu, 25 Jul 2013 13:38:45 -0700 (PDT) Received: from 6wind.com (6wind.net2.nerim.net. [213.41.180.237]) by mx.google.com with ESMTPSA id r8sm392969wiz.5.2013.07.25.13.38.42 for (version=TLSv1 cipher=RC4-SHA bits=128/128); Thu, 25 Jul 2013 13:38:44 -0700 (PDT) Received: by 6wind.com (sSMTP sendmail emulation); Thu, 25 Jul 2013 22:38:41 +0200 From: Thomas Monjalon To: dev@dpdk.org Date: Thu, 25 Jul 2013 22:38:41 +0200 Message-Id: <1374784721-18184-1-git-send-email-thomas.monjalon@6wind.com> X-Mailer: git-send-email 1.7.10.4 X-Gm-Message-State: ALoCoQmr8OTC0P7zhfBJXvxWLfHiR4hCY5mizWzQGtQsjnbp5kIgdPFFBhGqa3sXxZf3taWPMkQ2 Subject: [dpdk-dev] [vmxnet3 PATCH] doc: describe kernel dependency and --vmware-tsc-map X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: patches and discussions about DPDK List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 25 Jul 2013 20:38:23 -0000 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:: -- 1.7.10.4