From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mga18.intel.com (mga18.intel.com [134.134.136.126]) by dpdk.org (Postfix) with ESMTP id 89EC825D9 for ; Thu, 26 Jul 2018 08:42:46 +0200 (CEST) X-Amp-Result: SKIPPED(no attachment in message) X-Amp-File-Uploaded: False Received: from fmsmga001.fm.intel.com ([10.253.24.23]) by orsmga106.jf.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 25 Jul 2018 23:42:45 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.51,404,1526367600"; d="scan'208";a="75606666" Received: from dpdk-test32.sh.intel.com ([10.67.119.193]) by fmsmga001.fm.intel.com with ESMTP; 25 Jul 2018 23:42:43 -0700 From: Marvin Liu To: marko.kovacevic@intel.com, tiwei.bie@intel.com, dev@dpdk.org Cc: Marvin Liu Date: Thu, 26 Jul 2018 22:27:38 +0800 Message-Id: <20180726142738.58543-1-yong.liu@intel.com> X-Mailer: git-send-email 2.17.0 In-Reply-To: <20180725171224.21113-1-yong.liu@intel.com> References: <20180725171224.21113-1-yong.liu@intel.com> Subject: [dpdk-dev] [PATCH v2] doc: add note for builtin-net-driver option X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 26 Jul 2018 06:42:47 -0000 Option builtin-net-driver is used to demonstrate how to implement vhost-user driver based on vhost lib APIs. Unfortunately, very simple vhost driver in vhost sample is incompatible with QEMU as protocol feature not supported. Signed-off-by: Marvin Liu --- v2: * Updated descriptions. --- diff --git a/doc/guides/sample_app_ug/vhost.rst b/doc/guides/sample_app_ug/vhost.rst index 9112e7897..396d83211 100644 --- a/doc/guides/sample_app_ug/vhost.rst +++ b/doc/guides/sample_app_ug/vhost.rst @@ -158,6 +158,11 @@ when disabling VLAN strip. Such feature, which heavily depends on hardware, should be removed from this example to reduce confusion. Now, VLAN strip is enabled and cannot be disabled. +**--builtin-net-driver** +Very simple enqueue and dequeue function will be used when this option is +given. It can demonstrate how to construct vhost-user driver with vhost lib +APIs. It is disabled by default. + Common Issues ------------- @@ -192,3 +197,8 @@ Common Issues according to the NIC's property. :: make EXTRA_CFLAGS="-DMAX_QUEUES=320" + +* Option "builtin-net-driver" is incompatible with QEMU. + + QEMU vhost net device start will fail if protocol feature is not + negotiated. DPDK virtio-user can be the replacement of QEMU. -- 2.17.0