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 6BAA342F69; Fri, 28 Jul 2023 11:46:13 +0200 (CEST) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 5941640685; Fri, 28 Jul 2023 11:46:13 +0200 (CEST) Received: from mgamail.intel.com (unknown [134.134.136.20]) by mails.dpdk.org (Postfix) with ESMTP id 445994021E for ; Fri, 28 Jul 2023 11:46:12 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=intel.com; i=@intel.com; q=dns/txt; s=Intel; t=1690537572; x=1722073572; h=date:from:to:cc:subject:message-id:references: in-reply-to:mime-version; bh=fgqBKdMRw/L/QDesR5l2YJ26QJM5OphAM/2AlJt1USA=; b=LKJ8UE5ZGM2/sB1f7K5qGzetGghviBotSHhF9nqRIijOx5eRACsStHTE xF0SFZ9t5DOVLXVdN1jDPH2H98VpCThmaRtfpo14VCDchln+IVOlVAVwY SpiM+Fy5QG8LTPAx+BvBA2DTAKPrKlxc0ySUjkFZMM2zA9sBcIkbAfVmZ BHiDXks+5NBm+vqFtDRIcEGwFtKVlR+54JyS6gGJgmZBejA1hTGPohZ3M nOX1UL9LJ1WyCCLC/OiRupHr0LQx23yR1IPfy7mfcXKsUhs2QUR4vXT0D Y/1Pw4ZuVFqOUCH98KRF+7596kWBXoyDNb8tSTxSCKR1o1iv0QvX+YoFY w==; X-IronPort-AV: E=McAfee;i="6600,9927,10784"; a="358580989" X-IronPort-AV: E=Sophos;i="6.01,237,1684825200"; d="scan'208";a="358580989" Received: from fmsmga003.fm.intel.com ([10.253.24.29]) by orsmga101.jf.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 28 Jul 2023 02:46:11 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=McAfee;i="6600,9927,10784"; a="817446798" X-IronPort-AV: E=Sophos;i="6.01,237,1684825200"; d="scan'208";a="817446798" Received: from fmsmsx601.amr.corp.intel.com ([10.18.126.81]) by FMSMGA003.fm.intel.com with ESMTP; 28 Jul 2023 02:46:06 -0700 Received: from fmsmsx612.amr.corp.intel.com (10.18.126.92) by fmsmsx601.amr.corp.intel.com (10.18.126.81) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2507.27; Fri, 28 Jul 2023 02:46:04 -0700 Received: from fmsedg601.ED.cps.intel.com (10.1.192.135) by fmsmsx612.amr.corp.intel.com (10.18.126.92) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2507.27 via Frontend Transport; Fri, 28 Jul 2023 02:46:04 -0700 Received: from NAM10-DM6-obe.outbound.protection.outlook.com (104.47.58.102) by edgegateway.intel.com (192.55.55.70) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.1.2507.27; Fri, 28 Jul 2023 02:46:04 -0700 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=Y02HEyJHRKcdruQeAjCGzsjmNM5s3tGpVk0HCeKQFVdfSSa4fYgLoNW6U4qAXZrWlNQwawgwIjqcnLtIe6DoZEEAonMUSX1jrupMkhU74azcOopkWOqdXNtqRw54GvAVCXP1N9Cb06W7aZ+FtfuAYwPuytx8zx4HhC2OifSk62jMKmajJzFvvdLD01pXXS9XEh718M8NrF+tDw0Gs4RLxb6DOhU/9SJNBXd6J5rdd6JiVm1Zxx61dMx1ixXPldbREAmPyVg3Tt5OxrgW1EgUWe+OqKeQ8mZYdE0j60GwXWIc0Im/kAumxAlldsft2SA6k/zJZ1B82D8tagDDPPCZOQ== 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=sbEwLSGBiR34aGoNJfsxymGo0Gt5B8BS21KoDN4HulQ=; b=EF4plr+3FdMEcBu5VcVKqZJXjXcLrMxZFDDQNx9FKe/IxdUSDsYcTzcBW0PhrOrCPTKaHCLahNtEU4F6J5rbVqpvLDRoktw/oFs2yNYzqpWklpt8upGuT7njcY6/4cEFpcTwNXXODunUCdG/78pJkMaBXSE8OYxNCb17nGTNoet/cxPJYl55ByPmGdtp2WndYfjZ3plFFgB/GkaQ43oyQrFU74Vpb2g5FmmnjFYtoFXY4TzYRLZWVM7a9eauRe7/BYH1G/2f1Pju456Yy1gyFlcYnS1hXgI64bOzL/kZ9iE8y7GgOqRyArSCiDFM5TfkehJZ3b/7kf/iciR0fMh+gQ== 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 Authentication-Results: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=intel.com; Received: from DS0PR11MB7309.namprd11.prod.outlook.com (2603:10b6:8:13e::17) by IA0PR11MB7260.namprd11.prod.outlook.com (2603:10b6:208:43b::18) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6631.29; Fri, 28 Jul 2023 09:45:58 +0000 Received: from DS0PR11MB7309.namprd11.prod.outlook.com ([fe80::4f48:e1c1:e09f:54c2]) by DS0PR11MB7309.namprd11.prod.outlook.com ([fe80::4f48:e1c1:e09f:54c2%6]) with mapi id 15.20.6631.026; Fri, 28 Jul 2023 09:45:57 +0000 Date: Fri, 28 Jul 2023 10:45:52 +0100 From: Bruce Richardson To: Stephen Hemminger CC: Subject: Re: [PATCH] doc: announce deprecation of cmdline_poll Message-ID: References: <20230314171858.67446-1-stephen@networkplumber.org> Content-Type: text/plain; charset="us-ascii" Content-Disposition: inline In-Reply-To: <20230314171858.67446-1-stephen@networkplumber.org> X-ClientProxiedBy: DU2PR04CA0041.eurprd04.prod.outlook.com (2603:10a6:10:234::16) To DS0PR11MB7309.namprd11.prod.outlook.com (2603:10b6:8:13e::17) MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: DS0PR11MB7309:EE_|IA0PR11MB7260:EE_ X-MS-Office365-Filtering-Correlation-Id: 455a2194-8b01-44f2-25d8-08db8f4f71a8 X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: SNAc1o4J+gOqwTFPRER4getz3JrYOUtY3jWpgIIjcbU5xv2QEchebcWebHTxmJAnK/E+vwhZDM1azXBjYiayqiMzjNKzSSizkmMhrsiovT1td+qmJJosvVGvKQ206TBooNDKjv8rL5FBTvo5J6Q0tlXXOkuauhks8c2gMVOq4vqgQCIDyRM9crnwyCi+N2acsavOxbptNUTOzgBvVmce91bY4kRksGyJRbgilFTcbp/+hMC0+pYzb6qG6ak1m2XYFKLTjofzYfLHPExtk+pbH6ucFlKIqzMlqL63Fw4oH132VchjusX1Z5VuJAJePIV9egVnar/PT9kNlJO/I/LK0jC14s1XeoR93PfYAIBwgtMioKi3hA30pS0ybzzDwli+05okbykFA88zGRUiM5sjWb7H+hFWy307A0YIkO8Ubzt9Gw0cvmZsZAoQUOh/0+i+SlSIrU2lKsGQDblmkentkB6nQcl3MWXl3TIYKCBbiGpXBXn80/RcKskLc1960hUHbtn3fdKdYRB332uHF+vzHFRxZO+S5hCa5QTqor6CX1+qsmLMO2jIUrYZBrUUc3zs X-Forefront-Antispam-Report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:DS0PR11MB7309.namprd11.prod.outlook.com; PTR:; CAT:NONE; SFS:(13230028)(136003)(346002)(396003)(376002)(39860400002)(366004)(451199021)(26005)(41300700001)(316002)(8676002)(6916009)(4326008)(8936002)(6506007)(478600001)(82960400001)(66476007)(6512007)(66946007)(66556008)(6486002)(2906002)(38100700002)(83380400001)(86362001)(6666004)(186003)(44832011)(5660300002); DIR:OUT; SFP:1102; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: =?us-ascii?Q?KCI7HP2BAVGMYhQM0xF6re6jMQcFA9z//G5Qw9x3g1A7mvlwP5zEbDbiXdpt?= =?us-ascii?Q?Phlb5hVyupazHZjVE/G+8rv0devyuzjBsNFgLxbwtezYJkoRZrYZbdORAq0f?= =?us-ascii?Q?zrskuC7eIFEN4dGW+Rv3hHx1JYs2PXQ5D7fo6eSNdGk4kt1kMmYMHgrgKWvV?= =?us-ascii?Q?7Yfwg4BaxsWD+tG/lOvTJigpaXjL+y2Ab8duUoFuRCcxkdZDuNTu3zvIsJ78?= =?us-ascii?Q?NI/+CNsycZtjbxmEBNPcc5yizkdAbrEtr6IfegDYyI4C1ALTQ9bKYtIaxJtn?= =?us-ascii?Q?0/3yTCp8R2ZBRoeH7WNOMWiEFVpj5z3U6LlTMdMbICd0NbTSxX72OV1SAssT?= =?us-ascii?Q?qOi1qZ0nlLluWF4dp8nJoMJuZ4eeE13rHyV6UjBri2gLwwu/R+oXLONWebG3?= =?us-ascii?Q?8U9cHs+vO0oVSX1dvaktTurBYDZ/LwfhHfCC/sIXpnmkEvH8DesvZkmc3S7U?= =?us-ascii?Q?1aaxz7FQ5nhsMxs96LNKdbWnTguNGCt34HsXsJ1QXGabDaq2od7YfYKK0PYs?= =?us-ascii?Q?qK7/wD55L5Mls2kLO+qeVx4CTFHHRCRfUVQDjl6YVhEBy789QiYcrQem5N7/?= =?us-ascii?Q?pIOoFhaHsHJkf7R1yJ76voAOg/pO+NM6TAkBqj0LfmvqHkhqp7DqAYUGCA+L?= =?us-ascii?Q?l4pdzWDIBruT7LBUMpOVfbDNthSHpI3AhOK5sFacZifKa2pXbZSBP70ejub+?= =?us-ascii?Q?QaN69Eo4YiPpywroUXMEGyulSV0BKV8TA4Pw9f4RXlu62gsnH03/XW/NIRMo?= =?us-ascii?Q?dcmAHsSGPNdfeDZG9sMmoshpzZyxanj2+1LXIG8l6rJ56rGP43i6qLYc9ISm?= =?us-ascii?Q?Jha+kL92wZdaEtdg1EjJKCBZ1Fxc1BT74GB+cjkpmaWSK98wc6PNsN0sBOJc?= =?us-ascii?Q?zJAe7R5f2Cj+IJOrOcIvS9zffxR/TKeRtlDl0IwlJ/MO8g3DxLlHxY8iBmLf?= =?us-ascii?Q?H3owdc3sovYK8C7pyVYo+zeEA2Kf/0damOHNwXL+xE+/YIcIpG3xjqCfBQPe?= =?us-ascii?Q?QdbjiqVy0PTKuG3RnIEwbNCwCU3e1+14JInKJS3aEI+OZLrHAMtr9XzDNdSk?= =?us-ascii?Q?rW2dmSJA3Q3VZaFBTh0ElUpQSApWShPC9LcAIqJZYWWvOT1Uz8n8CcQBMT6W?= =?us-ascii?Q?7DaNpXOgbyDoBJSqex/6LVq1P5kcf7LjuOOmm/hkKe2MRqRqVhBz4Uzi32xH?= =?us-ascii?Q?LrSeUgiQtPF/Ey5RI7EQD/pUdoSotVT3B0wFbnRs1qaLrW0SFtyxfUD1KgX7?= =?us-ascii?Q?/DVI5Ki36fmQ2rJleAxet/g7ZCy2kZ/ZGYWMptjaKNbW64LPmrzu6QbFZfro?= =?us-ascii?Q?VV0BsIzMSLpUB84Mt3g+/4DYd/4V7WybC50DdBakPB3J4Tz4hr0zv378lgzI?= =?us-ascii?Q?Z02qMt0sQqZ3uzVX+0se0wcCZxFeB0/DD2onrWLLDMuD6jy3KcOJ5yJyB4po?= =?us-ascii?Q?p9tyrC5VLOc5Xr1gI9cgtqZbcVXZHhMpsEeC1rAHsX6zziDeYMZZOJASf6UB?= =?us-ascii?Q?gLvAP1Z36XXrYdk5otcn+hV653l5XdtYlgCRp5iXqkj62VfFSXHlHiYfQ3Zl?= =?us-ascii?Q?mS1jzIjyftWRMZO3RqlREvVCEQWBdyJru8B+8btGOJwAONhK0Rxg9WOPtSbD?= =?us-ascii?Q?ug=3D=3D?= X-MS-Exchange-CrossTenant-Network-Message-Id: 455a2194-8b01-44f2-25d8-08db8f4f71a8 X-MS-Exchange-CrossTenant-AuthSource: DS0PR11MB7309.namprd11.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 28 Jul 2023 09:45:57.6116 (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: ePs0OcmoPdAY6j39hcMObQq/hqNCR/QYmsAyEVU6OoYitVLyzYZwbrk9fddqo6BiVsp+Zq97KYIdY7uG5OMj+9JaanqUmlNHzS56EL6GUts= X-MS-Exchange-Transport-CrossTenantHeadersStamped: IA0PR11MB7260 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 On Tue, Mar 14, 2023 at 10:18:58AM -0700, Stephen Hemminger wrote: > Function was added by commit 067855e651d6 ("cmdline: add polling mode") > but never tested or used by DPDK applications. Mark it for > future removal. > > Signed-off-by: Stephen Hemminger > --- > doc/guides/rel_notes/deprecation.rst | 5 +++++ > 1 file changed, 5 insertions(+) > > diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst > index 872847e938ed..28c458591a68 100644 > --- a/doc/guides/rel_notes/deprecation.rst > +++ b/doc/guides/rel_notes/deprecation.rst > @@ -135,3 +135,8 @@ Deprecation Notices > Its removal has been postponed to let potential users report interest > in maintaining it. > In the absence of such interest, this library will be removed in DPDK 23.11. > + > +* cmdline: The function ``cmdline_poll`` does not work correctly on either > + Linux or Windows and is unused by any part of DPDK. > + It will be marked deprecated > + starting in the 23.07 relead and removed in DPDK 23.11. typo: "release". We also should ack a "deprecated" tag on the function to give build-time warnings. Since we are in the middle of having patches merged, I'll spin a v2 for you to save time. > -- > 2.39.2 >