From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <thomas.monjalon@6wind.com>
Received: from mail-lf0-f43.google.com (mail-lf0-f43.google.com
 [209.85.215.43]) by dpdk.org (Postfix) with ESMTP id 1DC133B5
 for <dev@dpdk.org>; Mon, 16 Jan 2017 11:05:10 +0100 (CET)
Received: by mail-lf0-f43.google.com with SMTP id k86so78179146lfi.0
 for <dev@dpdk.org>; Mon, 16 Jan 2017 02:05:10 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
 d=6wind-com.20150623.gappssmtp.com; s=20150623;
 h=from:to:cc:subject:date:message-id:user-agent:in-reply-to
 :references:mime-version:content-transfer-encoding;
 bh=pIn67gJO0GAJr94sqWGv/l1fEWavQsI+Ru/4AqVclT0=;
 b=t2Mk9OTZ08+XXGeG+31Bd9hy95gYu9VtbTiXvkCA0/Yx8IDXU/sBazYYpzqscOB3zo
 XXNHu235OLew2Dp5OiFMIneN8CUDoCENZLubAqYscz+tn4Nh/3biEa5epHUUO2ARRYqb
 o6iy/Eu5Z373y58wOh6raVNMXyr3yMllTPVysgyepNHt1WCPWbouA7s43YuSTgpbBlTQ
 7gH8x5QRcRgQ6AVO8W0AHHVViVqJNJaGR3sJwqPqP54K2IUVPWFoYWLk2kyvl3PVpT4q
 XaA51nd5DIEiUhJthtRaTpBVmyA6p+FwjQ3WinIWy6kMvin5sE4v2CRkAU+Okjrcyqdv
 iFNg==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
 d=1e100.net; s=20161025;
 h=x-gm-message-state:from:to:cc:subject:date:message-id:user-agent
 :in-reply-to:references:mime-version:content-transfer-encoding;
 bh=pIn67gJO0GAJr94sqWGv/l1fEWavQsI+Ru/4AqVclT0=;
 b=dOxqim3W0bafsMwweOaFlIzyiKoiNRW0V8BhBh3bdQXpNF7sd0DZVOQEe+1mYAJT4v
 gDSxovjOrvCj981O4CdWBZmIRIsl0Hymn+zAIVMAAzZA9+6UBpsP3IkoH7NaMmXvr0ps
 oReCSyP73AWIcWGTGzmUj+eWrAD28thS6zYFPO/FvlzqhqEbznRrQx+3+puiqMgP83XY
 frIZw3FitSkc7QvDi4mYGMAd1g6tD2vm4qIa6hqAXAjyKOUqq9rfvahthrpaS5XgSjpE
 onzPNca2il4OrXL8IkyQ8uTSRm7reSm9nt6WglV/Cx+3PSSshxmBXx4tyt3M3BZFkBk0
 9S5g==
X-Gm-Message-State: AIkVDXK735Rw3ksJCi+BA+NuQ2tlWvqrHj8qVFPbPJQtpGTusab6OCJFoqfmq8Ij2QzYAyVE
X-Received: by 10.46.77.17 with SMTP id a17mr12925971ljb.2.1484561105648;
 Mon, 16 Jan 2017 02:05:05 -0800 (PST)
Received: from xps13.localnet (184.203.134.77.rev.sfr.net. [77.134.203.184])
 by smtp.gmail.com with ESMTPSA id a71sm6891551lfe.36.2017.01.16.02.05.04
 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128);
 Mon, 16 Jan 2017 02:05:05 -0800 (PST)
From: Thomas Monjalon <thomas.monjalon@6wind.com>
To: Wenzhuo Lu <wenzhuo.lu@intel.com>
Cc: dev@dpdk.org
Date: Mon, 16 Jan 2017 11:05:04 +0100
Message-ID: <1553461.x6iY0G4dk3@xps13>
User-Agent: KMail/4.14.10 (Linux/4.5.4-1-ARCH; KDE/4.14.11; x86_64; ; )
In-Reply-To: <1484545911-40432-27-git-send-email-wenzhuo.lu@intel.com>
References: <1480637533-37425-1-git-send-email-wenzhuo.lu@intel.com>
 <1484545911-40432-1-git-send-email-wenzhuo.lu@intel.com>
 <1484545911-40432-27-git-send-email-wenzhuo.lu@intel.com>
MIME-Version: 1.0
Content-Transfer-Encoding: 7Bit
Content-Type: text/plain; charset="us-ascii"
Subject: Re: [dpdk-dev] [PATCH v10 26/26] doc: update doc for VFD
X-BeenThere: dev@dpdk.org
X-Mailman-Version: 2.1.15
Precedence: list
List-Id: DPDK patches and discussions <dev.dpdk.org>
List-Unsubscribe: <http://dpdk.org/ml/options/dev>,
 <mailto:dev-request@dpdk.org?subject=unsubscribe>
List-Archive: <http://dpdk.org/ml/archives/dev/>
List-Post: <mailto:dev@dpdk.org>
List-Help: <mailto:dev-request@dpdk.org?subject=help>
List-Subscribe: <http://dpdk.org/ml/listinfo/dev>,
 <mailto:dev-request@dpdk.org?subject=subscribe>
X-List-Received-Date: Mon, 16 Jan 2017 10:05:10 -0000

2017-01-16 13:51, Wenzhuo Lu:
> --- a/doc/guides/rel_notes/release_17_02.rst
> +++ b/doc/guides/rel_notes/release_17_02.rst
> @@ -66,6 +66,35 @@ New Features
>    Support for Mellanox ConnectX-5 family of 10/25/40/50/100 Gbps adapters
>    has been added to the existing mlx5 PMD.
>  
> +* **Added VF Daemon (VFD) on i40e. - EXPERIMENTAL**
> +
> +  This's an EXPERIMENTAL feature to enhance the capability of DPDK PF as many
> +  VF management features are not supported by kernel PF driver.
> +  Some new private APIs are implemented in PMD without abstrction layer.

Typo in abstrction

> +  They can be used directly by some users who have the need.
> +
> +  The new APIs to control VFs directly from PF include,
> +  1) set VF MAC anti-spoofing
> +  2) set VF VLAN anti-spoofing
> +  3) set TX loopback
> +  4) set VF unicast promiscuous mode
> +  5) set VF multicast promiscuous mode
> +  6) set VF MTU
> +  7) get/reset VF stats
> +  8) set VF MAC address
> +  9) set VF VLAN stripping
> +  10) VF VLAN insertion
> +  12) set VF broadcast mode
> +  13) set VF VLAN tag
> +  14) set VF VLAN filter
> +  VFD also includes VF to PF mailbox message management by APP.
> +  When PF receives mailbox messages from VF, PF should call the callback
> +  provided by APP to know if they're permitted to be processed.
> +
> +  As an EXPERIMENTAL feature, please aware it can be changed or even
> +  removed without prior notice.

It is good to explain things in the release notes, but not sufficient.
We must explain the DPDK position about PF/VF in the design doc:
	http://dpdk.org/doc/guides/contributing/design.html

It is important to explain that the primary goal of DPDK is to provide
a userland dataplane. Managing VF from a PF driver is a control plane
feature and we generally rely on the kernel for that.
So we continue adding some PF features in DPDK as experimental functions
but they must be implemented in the kernel with the same messaging interface.