From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from dpdk.org (dpdk.org [92.243.14.124]) by inbox.dpdk.org (Postfix) with ESMTP id 9744DA04AE; Tue, 5 May 2020 09:46:02 +0200 (CEST) Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id CC1391D42B; Tue, 5 May 2020 09:46:01 +0200 (CEST) Received: from mx0b-0016f401.pphosted.com (mx0b-0016f401.pphosted.com [67.231.156.173]) by dpdk.org (Postfix) with ESMTP id 5DF0A1D158 for ; Tue, 5 May 2020 09:46:00 +0200 (CEST) Received: from pps.filterd (m0045851.ppops.net [127.0.0.1]) by mx0b-0016f401.pphosted.com (8.16.0.42/8.16.0.42) with SMTP id 0457fClc003501; Tue, 5 May 2020 00:45:52 -0700 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=marvell.com; h=date : from : to : cc : subject : message-id : references : content-type : in-reply-to : mime-version; s=pfpt0818; bh=Ke/pmdGQ1Cb8u+OiKgW8F8kwYQBnqqfqbCJh2VuS1Mk=; b=HCdAIPmOzcH6i/w24FBfU6IM9S9zz7O7k/b3LxPeLu7OQOV3Cgm0lKffvcDX7O8K1rE8 ETmXAX0WRNi98/AUUMXCQFLn9Cf1qG7zzGoZWnbq/P0ZA/O+TcljNdKBj8O+LMqBXAQN 8rkAHUVcjlBUIEfi/I7SXqZWqDWHgAiH6URoQ1WXKTsBd6z6cVWVfgUALF4VW8+/isxh kDCAzTeLlvgATmpIMNB7Syg5ihmzVzJe37DRXXDVG1NaXIiPdsriAuximpw6bedsKhLu NIoK6g6VsEy/raze3RbHOV3344lYNiFlEArr9ZUpXoJDbu6wHKu91riXAGGrALI7rCXc sw== Received: from sc-exch04.marvell.com ([199.233.58.184]) by mx0b-0016f401.pphosted.com with ESMTP id 30srykqvp6-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-SHA384 bits=256 verify=NOT); Tue, 05 May 2020 00:45:51 -0700 Received: from DC5-EXCH02.marvell.com (10.69.176.39) by SC-EXCH04.marvell.com (10.93.176.84) with Microsoft SMTP Server (TLS) id 15.0.1497.2; Tue, 5 May 2020 00:45:49 -0700 Received: from SC-EXCH02.marvell.com (10.93.176.82) by DC5-EXCH02.marvell.com (10.69.176.39) with Microsoft SMTP Server (TLS) id 15.0.1497.2; Tue, 5 May 2020 00:45:48 -0700 Received: from NAM02-CY1-obe.outbound.protection.outlook.com (104.47.37.51) by SC-EXCH02.marvell.com (10.93.176.82) with Microsoft SMTP Server (TLS) id 15.0.1497.2 via Frontend Transport; Tue, 5 May 2020 00:45:48 -0700 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=PEp/MUkOfrFI+ROtN0YAK9DfjYeWmv+7H+OyQn4/GqopbOxOOtiixVXbISG4SWFRUPBkrjHlVtZ1WX9ICVvQUW1EOeec7v43a69tHYnvbkysq1kSx9OvaNg+AhoVIziZEOYYdgCKu3ig8HoZv7LWeUJLNH3eIqGJSTIKTiYWNdqSERcd3wdybN3wxu5mUVw86UNZsrZNeg4urIhygkoyC/HLkSrFfRIkPffOeJVL1n/T9+EfGYc7+tYtG+2zuwB34777Zlp5LhnE2Y7LdSx3SqsDcg/nLVyqW7PSDR0bydD3QTJ1NBAPPQVTugT6/cMX3uc8GjkeYRnosepyHk+J9Q== 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-SenderADCheck; bh=Ke/pmdGQ1Cb8u+OiKgW8F8kwYQBnqqfqbCJh2VuS1Mk=; b=U+ZJP5qtp1Q6tvT8BtvGogqdEFAP+4D5GRq148E7YVoGbCXt/RzW0WDmDu0eN/Wdcd4IrRVGBZElxsoUhKaPljQvHUyeVE+BhStuOXjJ1Lw7jmHqU0Be3GS8xIcKT0PyByEC6jJvoi1LyvAKKlMO3MQmlZDnixh6zG+sp0vYIwwYWG4EfxWNS8pySovOcXfhkug9o9Djkeb/utxYxTb5o8UlBRlGYu6RSvv/ST9z4LIbJiI2dkWPUZFutcGLBStY8dkZGoIHhHl6QxL3gFrtA52fMRRSXf3AM3g5Zza57j41dpQ/G/YKgsAYcWxYjS322G8qCPATcDbzP/Vasnb+Yw== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=marvell.com; dmarc=pass action=none header.from=marvell.com; dkim=pass header.d=marvell.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=marvell.onmicrosoft.com; s=selector1-marvell-onmicrosoft-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=Ke/pmdGQ1Cb8u+OiKgW8F8kwYQBnqqfqbCJh2VuS1Mk=; b=cgJeN/jTQ4+WA7pVuPtF4ZY2rab9Pm+dmvrspI7P+lxQns/8uLJD9e/45dPp67u6MgMStKoI3+VruHekR6qDXKfTo9yhpjmQpaxtA89CVeMNH3YSq/d4BJUed7FMpHFw9jTHqZ9B+jAU8hax0y4+0efuUl/0fWV3KOnQKb4pldk= Authentication-Results: ashroe.eu; dkim=none (message not signed) header.d=none;ashroe.eu; dmarc=none action=none header.from=marvell.com; Received: from BYAPR18MB2917.namprd18.prod.outlook.com (2603:10b6:a03:105::19) by BYAPR18MB3720.namprd18.prod.outlook.com (2603:10b6:a02:c3::26) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.2958.20; Tue, 5 May 2020 07:45:46 +0000 Received: from BYAPR18MB2917.namprd18.prod.outlook.com ([fe80::a1ec:e959:77df:cd58]) by BYAPR18MB2917.namprd18.prod.outlook.com ([fe80::a1ec:e959:77df:cd58%5]) with mapi id 15.20.2958.030; Tue, 5 May 2020 07:45:46 +0000 Date: Tue, 5 May 2020 13:15:28 +0530 From: Nithin Dabilpuram To: Ray Kinsella CC: Nithin Dabilpuram , , , , , , , , , , , , John McNamara , Marko Kovacevic , , , Message-ID: <20200505074528.GA29018@outlook.office365.com> References: <20200501171622.23410-1-nithind1988@gmail.com> <11475594-5c38-d65c-332e-78342241d486@ashroe.eu> Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <11475594-5c38-d65c-332e-78342241d486@ashroe.eu> User-Agent: Mutt/1.12.2 (34cd43c) (2019-09-21) X-ClientProxiedBy: PN1PR01CA0087.INDPRD01.PROD.OUTLOOK.COM (2603:1096:c00:1::27) To BYAPR18MB2917.namprd18.prod.outlook.com (2603:10b6:a03:105::19) MIME-Version: 1.0 X-MS-Exchange-MessageSentRepresentingType: 1 Received: from outlook.office365.com (115.113.156.2) by PN1PR01CA0087.INDPRD01.PROD.OUTLOOK.COM (2603:1096:c00:1::27) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.2958.19 via Frontend Transport; Tue, 5 May 2020 07:45:40 +0000 X-Originating-IP: [115.113.156.2] X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: 55f7eb70-0d6d-4ed6-4023-08d7f0c85227 X-MS-TrafficTypeDiagnostic: BYAPR18MB3720: X-MS-Exchange-Transport-Forked: True X-Microsoft-Antispam-PRVS: X-MS-Oob-TLC-OOBClassifiers: OLM:337; X-Forefront-PRVS: 0394259C80 X-MS-Exchange-SenderADCheck: 1 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: VMa34O5tXTHx04Q0uNri/FvrXRpXRw2LDVXGUQTomBZRAqb+gILu9KQVaOC+cvI7INiMheZbpJuRORLgRj3ybBzlrJDtvDdP46bbnHxV2YJDqzxT79clwKQudCcwxNGVWQlKyPbFVIh0ZxbUNKnKsKFIfpyE+VR3v6g/NMcMyo1CoVJtlFBnVKHCIdgjEyN0t603ZR3KIwqxSFg7mYXGVFqgT6gdxBJqR+4CQQ2w8qGt/EP+UxTNvVvYHhBamPI47ZdBDDZQr8ImPJnWj857n7OeDUQxSHEtJ2U1vhxMmjyqnd5Y2PyfgJqElpy1CoSfEHdnVJ9O68ahi3xg/jvkAGUUUoOG+/D9kVdohfrwFJpo+21aZvxwvG4W6D9dLq6JcKf7re2QgiY6hDLwGVRWu6al4s5/SRR26MaThcDPuJdjzXXy868A7b9HNPMeLKRyKaXDLbWpFnTg+hHfWXXli8DToNET6J/4WzTrDHQ0o/cORuf5Ok82H0g6HnlaLMmx/x2dsCINWGmIy1qFQ6Nfw6iS1RMx6VDOf1eTZZbJdY7LYGEhU+/yZBjVU2oWW40bvs6AaoUBkenXouY+NDK1k9vWZnafNMuZU49fOPueLTA= X-Forefront-Antispam-Report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:BYAPR18MB2917.namprd18.prod.outlook.com; PTR:; CAT:NONE; SFTY:; SFS:(4636009)(396003)(39860400002)(346002)(366004)(376002)(136003)(33430700001)(4326008)(1076003)(107886003)(6666004)(66556008)(66946007)(66476007)(9686003)(55016002)(86362001)(5660300002)(54906003)(8676002)(33656002)(8936002)(316002)(16526019)(26005)(7696005)(186003)(6506007)(55236004)(956004)(52116002)(6916009)(53546011)(7416002)(15650500001)(478600001)(33440700001)(2906002)(966005); DIR:OUT; SFP:1101; X-MS-Exchange-AntiSpam-MessageData: oE/4NJ0oF3Ia0k+pLMDU+4r6nLXQwahfh2S5w52s9XiNCgKQMZFN1T61D4IuRYy448EngW02y0CIPgiaOp6NT8gAJZBI5ajksjDFOByTTzUOagEVFztKBIPP96bVlOA7tY9lUXI1mwkcrIU7JNlce+KjB09W4Bz6E0TPD26/HY1K/0WxJTO/bTQQyy1/0ux/NFwXiNkuT/di2w03DC3yvWFQWN6WNtjU6TrvSeLMGsyQc3W4ilyEoAb/ulML65ovXFxmTg+XcwfxrEegYFgu3tmYB9f6WjIy+1bG0BDO15gaxkKlQVnFPVIOCPlfLhHHCzdPB1ZgvgJ3Vs0Em2X/07B2AscNIVWnr83K2n9EeoZEcdf/6XM/EgWXydCscFhUxWS6JCKVtIYo9qZiuAz8LiAMX0oOxWsqk/3bSf9Wsubpwvg0APB/LaBpRrltWpzpcy+xg37VI1bVE9NSH0NBHTIrNzMX0pziiPsfI0+eXEPHU94ndbvOIW67/+QTyfgtTyuCBAk4lDztH3LYqloyGFb+EzpMv2kfqdgKypKohSsbhx4FkP2tlUQE8RjHdeh+jkHOOv94DITCP5jLCt4rnL8WDD83eFuRhaEK8kZbvG5fCRvhMW10Xl4k2QiG698nkDuXajNri+8ym6h1IhB7yxeQFPpBXxCyaBGuRS3c42GBe2tjhzDZbu02upWrjtb4cYZUMTCbc117O6gPdDHTRBQGSYfia7Gok0esWU2NZd/t9Rwyd0pbiyKLhpgS+0Cb8cSoYIte90Ll6KUM7AJEw83z28YYdsuKBij8wf7cI5M= X-MS-Exchange-CrossTenant-Network-Message-Id: 55f7eb70-0d6d-4ed6-4023-08d7f0c85227 X-MS-Exchange-CrossTenant-OriginalArrivalTime: 05 May 2020 07:45:46.0792 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 70e1fb47-1155-421d-87fc-2e58f638b6e0 X-MS-Exchange-CrossTenant-MailboxType: HOSTED X-MS-Exchange-CrossTenant-UserPrincipalName: Qy/exRsxk21n7bwPJTq4Ptqi+9UIrGk5H9Mc6SXZamBLPls6pd3c1E0XMprAZWoYWs4f7Oez50gHM7V3P+zZYA== X-MS-Exchange-Transport-CrossTenantHeadersStamped: BYAPR18MB3720 X-OriginatorOrg: marvell.com X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:6.0.138, 18.0.676 definitions=2020-05-05_04:2020-05-04, 2020-05-05 signatures=0 Subject: Re: [dpdk-dev] [EXT] Re: [PATCH] doc: deprication notice to mark tm spec as experimental 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: , Errors-To: dev-bounces@dpdk.org Sender: "dev" On Tue, May 05, 2020 at 07:47:43AM +0100, Ray Kinsella wrote: > External Email > > ---------------------------------------------------------------------- > > > On 01/05/2020 18:16, Nithin Dabilpuram wrote: > > From: Nithin Dabilpuram > > > > Based on the discussion in below mail thread, it is concluded that > > all traffic manager API's (rte_tm.h) need to be marked experimental > > till few more releases to support further improvements to spec. > > > > https://urldefense.proofpoint.com/v2/url?u=https-3A__mails.dpdk.org_archives_dev_2020-2DApril_164970.html&d=DwIDaQ&c=nKjWec2b6R0mOyPaz7xtfQ&r=FZ_tPCbgFOh18zwRPO9H0yDx8VW38vuapifdDfc8SFQ&m=fMY2AL-_MFowqy_OpcWEwioupC8kxy4GNU6R3LZP_2A&s=WCnFYbXTODzmkAWYDdBurNyAJ8Hxti2qkxXNnuoBic4&e= > > > > Adding deprication notice for the same in advance. > > > > Signed-off-by: Nithin Dabilpuram > > --- > > 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 1339f54..8c90ec9 100644 > > --- a/doc/guides/rel_notes/deprecation.rst > > +++ b/doc/guides/rel_notes/deprecation.rst > > @@ -118,3 +118,12 @@ Deprecation Notices > > Python 2 support will be completely removed in 20.11. > > In 20.08, explicit deprecation warnings will be displayed when running > > scripts with Python 2. > > + > > +* traffic manager: Based on the discussion in the thread > > + https://urldefense.proofpoint.com/v2/url?u=https-3A__mails.dpdk.org_archives_dev_2020-2DApril_164970.html&d=DwIDaQ&c=nKjWec2b6R0mOyPaz7xtfQ&r=FZ_tPCbgFOh18zwRPO9H0yDx8VW38vuapifdDfc8SFQ&m=fMY2AL-_MFowqy_OpcWEwioupC8kxy4GNU6R3LZP_2A&s=WCnFYbXTODzmkAWYDdBurNyAJ8Hxti2qkxXNnuoBic4&e= it turns out that > > + all traffic manager API's in ``rte_tm.h`` were mistakenly made stable even > > + though the MAINTAINER's file and header file text mentions it to be still > > + experimental. Given that even now, both the maintainer and other contributor's > > + are inclined towards keeping those API's in experimental state till some more > > + releases in support of spec improvements, it is decided that all API's in > > + ``rte_tm.h`` will be marked back as experimental in v20.11 DPDK release. > > > > Slightly wordy - suggest making it a small bit more concise as follows. > > * traffic manager: All traffic manager API's in ``rte_tm.h`` were mistakenly made > abi stable in the v19.11 release. The TM maintainer and other contributor's have > agreed to keep the TM API's as experimental in expectation of additional spec > improvements. Therefore, all API's in ``rte_tm.h`` will be marked back as > experimental in v20.11 DPDK release. For more detail, please see `the thread > `_. Ack, will send v2. > > Ray K