From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mails.dpdk.org (mails.dpdk.org [217.70.189.124]) by inbox.dpdk.org (Postfix) with ESMTP id E0FD4A0032; Mon, 11 Jul 2022 12:43:53 +0200 (CEST) Received: from [217.70.189.124] (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id D0E0E41156; Mon, 11 Jul 2022 12:43:53 +0200 (CEST) Received: from mga11.intel.com (mga11.intel.com [192.55.52.93]) by mails.dpdk.org (Postfix) with ESMTP id 36C504021F for ; Mon, 11 Jul 2022 12:43:52 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=intel.com; i=@intel.com; q=dns/txt; s=Intel; t=1657536232; x=1689072232; h=from:to:cc:subject:date:message-id:references: in-reply-to:content-transfer-encoding:mime-version; bh=/xi7NMvn3o6ry/WddceCqJnEwo04fpVq2C3y0fnb8RA=; b=jlT2fNZ/qNRMLekuszFsKc8lnYCcWNbezZPqwS4Y8wtfSBA6EGnQoOlM b8PK0MOah80ggSIDMQVSgFu0/3worSepuGejfgmALB/m4Qq7qEuT+B69N USSwfbwyxn/T3KCURz7XJXZJwS21Ub4UxRDUxGKmrCeMpthVbMTWBCvyN xyXBcHU2Xgs7MVWu9hDmGBKkYruoh9N88b05kVgAINBQjyWcA8nv++tf8 5g2OUS6vpfQuLCJ0eWFo9yCE470o3P1AoBKc0wTBQQ2duQUa2/ykeAFkJ Smz0Y1k467CTva2YZs7q601ks10E7DeWEoj+3rfqKx4Xm9h8a49U6sRLj Q==; X-IronPort-AV: E=McAfee;i="6400,9594,10404"; a="282180128" X-IronPort-AV: E=Sophos;i="5.92,262,1650956400"; d="scan'208";a="282180128" Received: from fmsmga004.fm.intel.com ([10.253.24.48]) by fmsmga102.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 11 Jul 2022 03:43:50 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.92,262,1650956400"; d="scan'208";a="662499863" Received: from orsmsx604.amr.corp.intel.com ([10.22.229.17]) by fmsmga004.fm.intel.com with ESMTP; 11 Jul 2022 03:43:50 -0700 Received: from orsmsx611.amr.corp.intel.com (10.22.229.24) by ORSMSX604.amr.corp.intel.com (10.22.229.17) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2308.27; Mon, 11 Jul 2022 03:43:50 -0700 Received: from orsmsx606.amr.corp.intel.com (10.22.229.19) by ORSMSX611.amr.corp.intel.com (10.22.229.24) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2308.27; Mon, 11 Jul 2022 03:43:49 -0700 Received: from orsedg603.ED.cps.intel.com (10.7.248.4) by orsmsx606.amr.corp.intel.com (10.22.229.19) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2308.27 via Frontend Transport; Mon, 11 Jul 2022 03:43:49 -0700 Received: from NAM02-SN1-obe.outbound.protection.outlook.com (104.47.57.45) by edgegateway.intel.com (134.134.137.100) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.1.2308.27; Mon, 11 Jul 2022 03:43:49 -0700 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=J81RcsoROAhtaEiMiuRRj5CVLx2EhyeXeKKRrbS1T1m+YaD/uBjobR8+8UVLwu81kIF2y2tWVA2Jgg+hLbhZvfNTIipJ4H0Lt1WhmfbS7sCArfV9DwmPX2z14InAb1McqYke0NC21e/G8UaB86NLUHtnuwpLrY9kWtoLalGDP7osXVhwht/Hl3kbnavOFco68g8K265ehnus0orPFyeJE39x2fCPOQa7O0PhxXA2P1eMKByHuCHomRCfkyia5vGwxu4+hh9nwYXbWzWemwpBOWWu1fsCEIn+BcHixb3Nvg+sZWvl1qqf9tpLPrgmW2qQe40e5CTvZCRYgR4bS5F/Rg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=nU+qVmHdR25hGLNqCerHRN2eZiufiWzo4/8fyzIbpmU=; b=cqMtNmdyk4SUCR1vH/Yn1cyLlTZCL3Iq40xGRPNF/2JJXlHDzVfkKtoRSSvvOm2fRMoAfuZfD8zHWEbBmDchCMFjuLlZ3iUYHvmP5o+gEEn+ky44FV8qRtXQu7FZv2O2AQZbsWpOK5ju3PvEjz4oUXmhSDOlWT/4x6m52FNzrO01tC1oWVIP97e1FFVb0DTZd1pdiFeMYELBOeEdgDiw6wkyD6YS5GaZMtfSbZk+hcQs3ioRy0adySLZYpM74GglU0CO5bTqddV6K5rv/kx85mi7AOX39+ZbaU8T9qT0uwIZB78N2YfOuFONNYHjA7rVR0FOki46dB3cO3wN7s/OLQ== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=intel.com; dmarc=pass action=none header.from=intel.com; dkim=pass header.d=intel.com; arc=none Received: from MN2PR11MB3821.namprd11.prod.outlook.com (2603:10b6:208:f7::24) by PH0PR11MB5611.namprd11.prod.outlook.com (2603:10b6:510:ed::9) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5417.16; Mon, 11 Jul 2022 10:43:48 +0000 Received: from MN2PR11MB3821.namprd11.prod.outlook.com ([fe80::d48f:f6a4:eac4:d541]) by MN2PR11MB3821.namprd11.prod.outlook.com ([fe80::d48f:f6a4:eac4:d541%7]) with mapi id 15.20.5417.026; Mon, 11 Jul 2022 10:43:47 +0000 From: "Power, Ciara" To: "Richardson, Bruce" , "dev@dpdk.org" CC: "mb@smartsharesystems.com" , "stephen@networkplumber.org" Subject: RE: [PATCH] doc: add deprecation for restrictions in telemetry naming Thread-Topic: [PATCH] doc: add deprecation for restrictions in telemetry naming Thread-Index: AQHYkgcFZO0D/5CU6E2c1ra1oO3YPq15AdpQ Date: Mon, 11 Jul 2022 10:43:47 +0000 Message-ID: References: <20220707133931.752248-1-bruce.richardson@intel.com> In-Reply-To: <20220707133931.752248-1-bruce.richardson@intel.com> Accept-Language: en-IE, en-US Content-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: dlp-version: 11.6.500.17 dlp-product: dlpe-windows dlp-reaction: no-action authentication-results: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=intel.com; x-ms-publictraffictype: Email x-ms-office365-filtering-correlation-id: ba31ca87-c09c-4c96-32c1-08da632a3c5a x-ms-traffictypediagnostic: PH0PR11MB5611:EE_ x-ld-processed: 46c98d88-e344-4ed4-8496-4ed7712e255d,ExtAddr x-ms-exchange-senderadcheck: 1 x-ms-exchange-antispam-relay: 0 x-microsoft-antispam: BCL:0; x-microsoft-antispam-message-info: +JUwdW4Gmwf3aYtzNz3ll/VP+YIZmnxa3i2zbop4+MmoVKD7hKOCmMuiic6z19lyLOgrLGbk9oejuDUCcreY8vRpyV70BJa6Y4EXwMIvTyFrDQcbRi1X3wQgnzZr1A6q8HZylc5y3nuRidbHSsxZXBXl7fR6VSOzPftOpcfhtBVuatN12H1J7TZ0KKkkftQblNZOZ/JkgcfPf38vcliWzHQrNDy+t090xS2d/BCx1yZDUoajy+o7S0K0hpr5V9HPEX8CNkx6Dsjv9mod3hs4ki/LFdoPNlbOX1nq6zlw1IwbXfW6Ud5/cFCO6OYmepms26VlglFbiVHq9IAUOs0p1yZzl3TPdeuNmbRkF86q6n5NBf7w87fWvVrbZEyZ27rYordboTc2wLMHbqmaXl6/pqmqtdYgH9YXHERC9jlX3nVYvO7YGGuscVNrFf59r3s41LsUFT3P036VehMmjdL8p5HoXulzxxIgOYcnzWuQ+Rz5WEpKjgloKm/By5FgcD1Fns3feU1JGKgYVB89rkNGvS2NUbKnkOqJxpvZ89d2+BvUBrJ8IEEB55acrUjpwJkbik5j6eKMadLGchso+KAquGlrBBnNanhgoVA52+iGjbIYNydQFjRKNYCMdUEANejkEDT77RUILPYfdbfOKPdEUrxxeW/HgK/7UTWwZt2+A3hF03l2wjaj423paJUVrtD0zKV6vx9JhHGTo6LKywHBWk2uM3CFLcP3bjueI2LcQlpFx5vd287ETARVCS6wrsOHWlIUISU0QxZ6J8h6tjcEXMETWH1YgCsu+AlK5nXZULK+BVXReIiOYVyTxJPJSOrhVH+Mm132+dSPnkM4JIPsNpGQrYprOvmTiyqpEid4Mkk= x-forefront-antispam-report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:MN2PR11MB3821.namprd11.prod.outlook.com; PTR:; CAT:NONE; SFS:(13230016)(366004)(376002)(39860400002)(346002)(396003)(136003)(2906002)(33656002)(6506007)(966005)(83380400001)(55016003)(186003)(7696005)(8936002)(86362001)(5660300002)(64756008)(4326008)(66946007)(66556008)(66446008)(8676002)(76116006)(66476007)(53546011)(26005)(478600001)(316002)(38100700002)(54906003)(38070700005)(82960400001)(110136005)(71200400001)(9686003)(122000001)(52536014)(41300700001); DIR:OUT; SFP:1102; x-ms-exchange-antispam-messagedata-chunkcount: 1 x-ms-exchange-antispam-messagedata-0: =?us-ascii?Q?l04FX3WHhPbUkvE2GUewTdFX4oRpKSJV3GRL/jPw8zRKLxpVc+0XqbkAMHKn?= =?us-ascii?Q?ndibMnYzyiIj6tdsiCU2l+c9t9o0XbTuuvV4kwjdXgjy54Vq3e/OL+kjVhIa?= =?us-ascii?Q?ZznlvdeH+4s8xcavS4KVrdjVywL5FeC7WsmOqDKtmwU54XXChdvXnU0QhAWc?= =?us-ascii?Q?eLoA+zze/0/V5nhrlpyZ1aiN/mEn1R3DEP+TVqbbEQmHixmA8BJq22YFxExv?= =?us-ascii?Q?a/GHWWBT/raekXGYfxJkJkmU3/v0LhntLm87uWb9ukazkHsHYd/6XHQ2N2L7?= =?us-ascii?Q?osOiPFWiru4uHlcGIC1f9nE1F5fwKDMy1mIH/yd6o/aMy469+/DukvdF9qr4?= =?us-ascii?Q?45/4ab69czs3hRNbnxhmrqRYRyQX+Hhv7krbg3pQ13P8dQ7nAhy9k7cvwrGB?= =?us-ascii?Q?1/MsMsUXReNNNzR6ZRQc1Pie/8V/XyJFtYdL3IpyDl5h4hzVRwnt4lPyAXU+?= =?us-ascii?Q?DvN09hABi9UIsVhQOWpMcgWstt72RirXMTr291AY0EWp2N+DI7rzYba3a0rJ?= =?us-ascii?Q?aiZMF5lS+h5k6EKQZgsrNUv1bUfkwKA2lXhqVAgB0kwlZJ/Ufy3MAkIE0+DX?= =?us-ascii?Q?kIgqNp8HSPbPu/cTtHxqd7dcc7C+oyxG8o1eHF6lVJ9EgHbCEPjtRi1MxNVn?= =?us-ascii?Q?QLNeiBZ9pVepGhq4KO74WdzjKvudUS1dhfcHKY2Npxe463uPYQGbUiXXH12Q?= =?us-ascii?Q?ilzKCqIUOgqFcB2ZrT7+ZLS2596S12hA2WJFjRAU9PChkwvgWLhG8xaHJ8fz?= =?us-ascii?Q?eQlRUH4+1D4dbL63IBPwnE25Q3piohSPG1wWL1mV3qAGitkhAvq7pIStxwcS?= =?us-ascii?Q?NgtCy5V/O/tCScrERQG9tHLmMaEisukl1KoQoSNjVg1mdcBScoYT05UcBUbu?= =?us-ascii?Q?xrjex0RzpKAP2nv78j6ghf/mit2xQAc7qRxx2c6GJVjJXTz/mmiwI2RtoO/N?= =?us-ascii?Q?BZTDkZGpANzJOb6HfgPbcMVNCXvgN13rLJjNI9dHaB34pTGYqwZdAgo/GAii?= =?us-ascii?Q?cGAZQ/zolGiK2TqXscr69gsnA6zVRbwEv0PohRavGIeKbrQ6jrBjEvuUaTW+?= =?us-ascii?Q?HQvUGJp8p2g45ZiDQEEYUiBMyo+3ur574Om/5jFsslcM9vMZ3n9Kw+zAG5UI?= =?us-ascii?Q?uc2rXg5f0SjEQHhY0BuVRDycHzmWZe4COA9lRj5gRcIvpHYWQYHmKETM3rSu?= =?us-ascii?Q?crtgIqZFfUmfAIt32FWOSl9jgZ+VfM82lSo0KUUOpTeyoQUTKIu/oZQBLHK5?= =?us-ascii?Q?i8zQTX/V9cdIVgTdcPvKeI5OOZQpp/cJTKtaTkKKK21YwNIIaztwPWBsrflq?= =?us-ascii?Q?P9YtkjBKuEno8m9MqBPzj+npx5mDvCl4eyGNQm2H8ADnHTWihjMzqmpGEuTW?= =?us-ascii?Q?ikJnKonWAx+hB2U+5YFzH1mqvLa18pA7a4hHAK9CwxYPcliVyB/ICoPDFHCi?= =?us-ascii?Q?ueKLq76LwxTQgnbHQvThy3ewdMPIVMJEgC4Gq/q3ALr9jfCehv6s+8EwtzBu?= =?us-ascii?Q?uWl/uX/15nk6QXtj482yCIJo873y+7EXZMRKx7JpDT0VjUUehm8GVKAlxVdo?= =?us-ascii?Q?HQ03RtWiTaDzRdZmddivEJZ47wK6IOaeflejK4ul?= Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-AuthSource: MN2PR11MB3821.namprd11.prod.outlook.com X-MS-Exchange-CrossTenant-Network-Message-Id: ba31ca87-c09c-4c96-32c1-08da632a3c5a X-MS-Exchange-CrossTenant-originalarrivaltime: 11 Jul 2022 10:43:47.8510 (UTC) X-MS-Exchange-CrossTenant-fromentityheader: Hosted X-MS-Exchange-CrossTenant-id: 46c98d88-e344-4ed4-8496-4ed7712e255d X-MS-Exchange-CrossTenant-mailboxtype: HOSTED X-MS-Exchange-CrossTenant-userprincipalname: 4SsL4bM6HaD4krdd06Gu+rOq7DZwq5oDXE/BEsbUrnqmy4LAPJEuK3wC8QZ+88ORJjwTTdfGSwBo22O489znTg== X-MS-Exchange-Transport-CrossTenantHeadersStamped: PH0PR11MB5611 X-OriginatorOrg: intel.com X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org > -----Original Message----- > From: Richardson, Bruce > Sent: Thursday 7 July 2022 14:40 > To: dev@dpdk.org > Cc: Richardson, Bruce ; > mb@smartsharesystems.com; stephen@networkplumber.org; Power, Ciara > > Subject: [PATCH] doc: add deprecation for restrictions in telemetry namin= g >=20 > Following discussion on-list [1], we will look to limited the allowed cha= racters in > names for items in telemetry. This will simplify the escaping needed for = json > output, or any future output formats. The lists will initially be minimal= , since > expansion to allow more characters can be done without affecting > compatibility, while reducing the set cannot. >=20 > Cc: mb@smartsharesystems.com > Cc: stephen@networkplumber.org > Cc: ciara.power@intel.com >=20 > Signed-off-by: Bruce Richardson >=20 > [1] http://inbox.dpdk.org/dev/20220623164245.561371-1- > bruce.richardson@intel.com/#r > --- > doc/guides/rel_notes/deprecation.rst | 6 ++++++ > 1 file changed, 6 insertions(+) >=20 > diff --git a/doc/guides/rel_notes/deprecation.rst > b/doc/guides/rel_notes/deprecation.rst > index 4e5b23c53d..9366690ec5 100644 > --- a/doc/guides/rel_notes/deprecation.rst > +++ b/doc/guides/rel_notes/deprecation.rst > @@ -119,6 +119,12 @@ Deprecation Notices > * metrics: The function ``rte_metrics_init`` will have a non-void return > in order to notify errors instead of calling ``rte_exit``. >=20 > +* telemetry: The allowed characters in names for dictionary values will > +be limited to > + alphanumeric characters and a small subset of additional printable cha= racters. > + This will ensure that all dictionary parameter names can be output > +without escaping > + in json - or in any future output format used. Names for the > +telemetry commands will > + be similarly limited. > + > * raw/ioat: The ``ioat`` rawdev driver has been deprecated, since it's > functionality is provided through the new ``dmadev`` infrastructure. > To continue to use hardware previously supported by the ``ioat`` rawde= v > driver, > -- > 2.34.1 Acked-by: Ciara Power