[PATCH] doc: deprecation notice for EAL runtime path changes

[PATCH] doc: deprecation notice for EAL runtime path changes

[Anatoly Burakov]

Most of this work was already done, but runtime config path is
considered to be part of public API because of high likelihood of
it being used by various tools in the DPDK ecosystem, and thus
requires a deprecation notice.

Signed-off-by: Anatoly Burakov <anatoly.burakov@intel.com>
---
 doc/guides/rel_notes/deprecation.rst | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst
index 1e2443c..36d2e23 100644
--- a/doc/guides/rel_notes/deprecation.rst
+++ b/doc/guides/rel_notes/deprecation.rst
@@ -8,6 +8,15 @@ API and ABI deprecation notices are to be posted here.
 Deprecation Notices
 -------------------
 
+* eal: DPDK runtime configuration file (located at
+  ``/var/run/.<prefix>_config``) will be moved. The new path will be as follows:
+  - if DPDK is running as root, path will be set to
+    ``/var/run/dpdk/<prefix>/config``
+  - if DPDK is not running as root and $XDG_RUNTIME_DIR is set, path will be set
+    to ``$XDG_RUNTIME_DIR/dpdk/<prefix>/config``
+  - if DPDK is not running as root and $XDG_RUNTIME_DIR is not set, path will be
+    set to ``/tmp/dpdk/<prefix>/config``
+
 * eal: both declaring and identifying devices will be streamlined in v18.05.
   New functions will appear to query a specific port from buses, classes of
   device and device drivers. Device declaration will be made coherent with the
-- 
2.7.4

Re: [PATCH] doc: deprecation notice for EAL runtime path changes

[Bruce Richardson]

On Fri, May 25, 2018 at 02:38:43PM +0100, Anatoly Burakov wrote:
> Most of this work was already done, but runtime config path is
> considered to be part of public API because of high likelihood of
> it being used by various tools in the DPDK ecosystem, and thus
> requires a deprecation notice.
> 
> Signed-off-by: Anatoly Burakov <anatoly.burakov@intel.com>
> ---
Acked-by: Bruce Richardson <bruce.richardson@intel.com>

Re: [PATCH] doc: deprecation notice for EAL runtime path changes

[Thomas Monjalon]

25/05/2018 15:58, Bruce Richardson:
> On Fri, May 25, 2018 at 02:38:43PM +0100, Anatoly Burakov wrote:
> > Most of this work was already done, but runtime config path is
> > considered to be part of public API because of high likelihood of
> > it being used by various tools in the DPDK ecosystem, and thus
> > requires a deprecation notice.
> > 
> > Signed-off-by: Anatoly Burakov <anatoly.burakov@intel.com>
> > ---
> Acked-by: Bruce Richardson <bruce.richardson@intel.com>

Acked-by: Thomas Monjalon <thomas@monjalon.net>

Applied, thanks

Re: [PATCH] doc: deprecation notice for EAL runtime path changes

[Van Haaren, Harry]

> From: Burakov, Anatoly
> Sent: Friday, May 25, 2018 2:39 PM
> To: dev@dpdk.org
> Cc: Neil Horman <nhorman@tuxdriver.com>; Mcnamara, John
> <john.mcnamara@intel.com>; Kovacevic, Marko <marko.kovacevic@intel.com>;
> thomas@monjalon.net; Richardson, Bruce <bruce.richardson@intel.com>; Van
> Haaren, Harry <harry.van.haaren@intel.com>
> Subject: [PATCH] doc: deprecation notice for EAL runtime path changes
> 
> Most of this work was already done, but runtime config path is
> considered to be part of public API because of high likelihood of
> it being used by various tools in the DPDK ecosystem, and thus
> requires a deprecation notice.
> 
> Signed-off-by: Anatoly Burakov <anatoly.burakov@intel.com>

Acked-by: Harry van Haaren <harry.van.haaren@intel.com>