From patchwork Tue Jan 9 05:25:48 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Frank Li X-Patchwork-Id: 186220 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a05:7300:37c1:b0:101:2151:f287 with SMTP id y1csp1453638dyq; Mon, 8 Jan 2024 21:26:27 -0800 (PST) X-Google-Smtp-Source: AGHT+IFaiDDbpE8jjZ2Rl4L+7RL79In2QEFzCCoApm+MtSxqNByAe98zDeBBWwjcVWsT+NfhlOzb X-Received: by 2002:a05:622a:1006:b0:429:a5ed:9a80 with SMTP id d6-20020a05622a100600b00429a5ed9a80mr512929qte.19.1704777987009; Mon, 08 Jan 2024 21:26:27 -0800 (PST) ARC-Seal: i=2; a=rsa-sha256; t=1704777986; cv=pass; d=google.com; s=arc-20160816; b=NlRkyHxhRYggZlHfo8AXfzka1nKpQZRBsovNmVdVKMRfV9R7AzIRngTmYUflVlZ4g7 MJnVhpQm9G7Gppw0NlZsqOirabcrkUvkTolwPv8pMMa47vv4tGJjPMQUq7U2wIRo5ftM eW0L8nwMndcsarXUqDElhreYdiKSkKiWvv8BmLT4tcn2EzNuOADubS99aOVrRqU428i0 CgBhs13GrMFJ1kxowT7KB5MM9musKaOcPziP6l4p58OmTte1IAbKLF2u+gvAdrJZGrkz DT7hNZG+I6v0WGpJIVVmvXjbDq1ry11d2qqMyCWur57b7iet/gRDZI5oEIQ7vAuIw8p8 QlCw== ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=mime-version:list-unsubscribe:list-subscribe:list-id:precedence :content-transfer-encoding:message-id:date:subject:cc:to:from :dkim-signature; bh=VJBAg9at4SySdpk0H41dhzwrh0m9WEbs/M7wyHIadEo=; fh=Art6/TrRFgzUQVSDSdAvIz5xQSuLP5dMkY92cmnajWI=; b=sSmgZnT4wJA7ivtW5P8IwvghcqI6ma3xF2DFinhtPFJOCpLoRkS/Z99MhI5DOJupF1 AnLFCxp89RBTo+PophhAn9gH48Wz1G/NLu/8VDOAoAiMzvojA0rwlydGLi7EAFbK49Y3 B9d+OfJvZYoymEbiHftx+C24pdrGNMRVkKV4a76SC/r34D1urkmGjRnC50C8i5n32Ao1 ERqTjoIhlKZqIeIZUdYjL7LUmaTXxWe9UDIlZFi5UFrA7Xoy7N8L8Ob4jcEPMX5ytj/X bHAeGbGJa0LGyevivU4k2zNCGlVjTBBfUMRnvZBZo/M458m1YpsPe9j0f1h8v2RCT/ew QdzA== ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@nxp.com header.s=selector2 header.b=CIVO2ejF; arc=pass (i=1 spf=pass spfdomain=nxp.com dkim=pass dkdomain=nxp.com dmarc=pass fromdomain=nxp.com); spf=pass (google.com: domain of linux-kernel+bounces-20405-ouuuleilei=gmail.com@vger.kernel.org designates 147.75.199.223 as permitted sender) smtp.mailfrom="linux-kernel+bounces-20405-ouuuleilei=gmail.com@vger.kernel.org"; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=nxp.com Received: from ny.mirrors.kernel.org (ny.mirrors.kernel.org. [147.75.199.223]) by mx.google.com with ESMTPS id g3-20020ac87f43000000b00429a6932cc9si432393qtk.304.2024.01.08.21.26.26 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 08 Jan 2024 21:26:26 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel+bounces-20405-ouuuleilei=gmail.com@vger.kernel.org designates 147.75.199.223 as permitted sender) client-ip=147.75.199.223; Authentication-Results: mx.google.com; dkim=pass header.i=@nxp.com header.s=selector2 header.b=CIVO2ejF; arc=pass (i=1 spf=pass spfdomain=nxp.com dkim=pass dkdomain=nxp.com dmarc=pass fromdomain=nxp.com); spf=pass (google.com: domain of linux-kernel+bounces-20405-ouuuleilei=gmail.com@vger.kernel.org designates 147.75.199.223 as permitted sender) smtp.mailfrom="linux-kernel+bounces-20405-ouuuleilei=gmail.com@vger.kernel.org"; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=nxp.com Received: from smtp.subspace.kernel.org (wormhole.subspace.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ny.mirrors.kernel.org (Postfix) with ESMTPS id BCBF01C2353C for ; Tue, 9 Jan 2024 05:26:26 +0000 (UTC) Received: from localhost.localdomain (localhost.localdomain [127.0.0.1]) by smtp.subspace.kernel.org (Postfix) with ESMTP id 846997476; Tue, 9 Jan 2024 05:26:13 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dkim=pass (1024-bit key) header.d=nxp.com header.i=@nxp.com header.b="CIVO2ejF" Received: from EUR05-DB8-obe.outbound.protection.outlook.com (mail-db8eur05on2061.outbound.protection.outlook.com [40.107.20.61]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 55AB6646; Tue, 9 Jan 2024 05:26:08 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=nxp.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=nxp.com ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=KrCNSIVHZ9Ku8Qmhy6EvPfwrm0UafTnKNezHT6e7pqvkBvclF6HAE/a4hHbZvFsyCIr5wvWvL0GpfszgqqZg92K+zw43ZvU36Y7yvb7UmXqtq9+m8/SMvqCqSv2W1IMay8kiqmFURzo52pJ9HO7OaejYBL6Zf3YMYOmjh67D1d/41oeT/Hs9A/MmIeLTIJkmx5ck6B/eHwLFnwV6nfzoCTd2adC1Q9OlhFWoWpbFMTwuhLksdUFoLiLLdkcZouBU2wvIhWk1xhHXhx2EgF/sF7fEFZZvjgv+CFQOWu3+k1WRRJYEXs585+/fa0MjxhGoxLOvool1EC/vM4apGNJiZw== 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=VJBAg9at4SySdpk0H41dhzwrh0m9WEbs/M7wyHIadEo=; b=nnaV+bDf5VTUFoSUnrRptmTChYioz6squmDgpDVffiYUs2cHQ1TIqwcW5VFieErJLvGpdk4KrDUlbRe5ry5Net3smJdkDjiUoyv8baiJtH5dsxcDgAWdmCmFRXR83rdW73Zt2PQ1RfUBdtEp9prkTY+wngM6Rx3ZrZGe5VdbARUaEvf2Of6/R/vx76HLcFHfPF/6VLW5wkS+GPcboo0i8SUoCgwqc8Ar3yJN+VLQI7M4MUT5H/iCoqw/7a7c20TbFx6pCR9NyDP38nGFSCXndgYTH6de+Yk11/+k5Kt2JzAXYsdIe9KVgodbVbQGa3CcIhCquvmLPymmiHFzeOM6mg== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=nxp.com; dmarc=pass action=none header.from=nxp.com; dkim=pass header.d=nxp.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=nxp.com; s=selector2; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=VJBAg9at4SySdpk0H41dhzwrh0m9WEbs/M7wyHIadEo=; b=CIVO2ejFGdB9HhMD/LpLV6YUYuAWoVYbMpgMN/98XADc28BQ6utZrnSdjTvckRyeUz3cX5+8NTgo93xbevjgYYwLX6ndxKkHBMCR1ljdm16CgZyhicSNy7gV7ebAZbeFNuvitYN5fvVOs5kPYiJFlbv9KRarnhV9LI9W3N6cOIo= Authentication-Results: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=nxp.com; Received: from AS8PR04MB7511.eurprd04.prod.outlook.com (2603:10a6:20b:23f::5) by PAXPR04MB8110.eurprd04.prod.outlook.com (2603:10a6:102:1bd::5) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.7159.23; Tue, 9 Jan 2024 05:26:05 +0000 Received: from AS8PR04MB7511.eurprd04.prod.outlook.com ([fe80::8ee3:bac5:a2da:d469]) by AS8PR04MB7511.eurprd04.prod.outlook.com ([fe80::8ee3:bac5:a2da:d469%4]) with mapi id 15.20.7159.020; Tue, 9 Jan 2024 05:26:05 +0000 From: Frank Li To: alexandre.belloni@bootlin.com, linux-kernel@vger.kernel.org, linux-next@vger.kernel.org Cc: conor.culhane@silvaco.com, imx@lists.linux.dev, joe@perches.com, linux-i3c@lists.infradead.org, miquel.raynal@bootlin.com, zbigniew.lukwinski@linux.intel.com Subject: [PATCH 1/1] i3c: master: fix kernel-doc check warning Date: Tue, 9 Jan 2024 00:25:48 -0500 Message-Id: <20240109052548.2128133-1-Frank.Li@nxp.com> X-Mailer: git-send-email 2.34.1 X-ClientProxiedBy: BYAPR11CA0064.namprd11.prod.outlook.com (2603:10b6:a03:80::41) To AS8PR04MB7511.eurprd04.prod.outlook.com (2603:10a6:20b:23f::5) Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: AS8PR04MB7511:EE_|PAXPR04MB8110:EE_ X-MS-Office365-Filtering-Correlation-Id: 19e97e04-0030-4615-1058-08dc10d37a50 X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: BJvWeYvJzLKWimwPoguKgaOWQbiWkCI/gca1i6XZUXHZu1cHL8CUF4FOsc6Pa0JWd5Jk6yx7pkXRMSTnXSm/shqzdQMC0gIl4Yz0NrKyFq52OzWvYS//AIbHddIHcpxlHddMtewuVWB/chBqC58Uw749vPobyQWZQTWtL/M22o4ieMIwLM/tJCfH7OXj7w2IaRo2tfF+SmLYLQbX47Njo/UpqS+IvlWw1J4IE/tbAZ2V8YOGeDnfCjQKcRWR3qF7dlJ4/nFnA1p9CduR6KSBxz4tIuQB+s58/USrwa8kh5ACMXx2QtR8oaf8XycXuEjp+141hxA9+o9sZqJ9BC7/OCW7m69u+eI8VVtelufZJOuFjozZdH/Z2Jib4iCWwC4QP/QTYaIsntDM6a6x84vKG7xZHedB/2TQLBq+8O+btj7l5PUHrGlRO19hmu4Rhtw6st1f8t+gSLq+84ppNcMLaNXIwdr9NBs3vhy7/lfzt/pJzIS0ONr4QsSYpqgMvcuCFm97gQ50/uXwONHz5n7vIh5mr4XlmUOvxrx4HhZiHglSMR5uga9AGDGMOXdALMO7z4hX7tC6uwza15+Y82Q1t4SNvuupNlLIT1Vcoj9HSejQ4w2QsP2ObQo2/D2bC1c3quVnk/LgpYTEUF+iODrCATk4g3+n79/fhfUbri20/OM= X-Forefront-Antispam-Report: CIP:255.255.255.255;CTRY:;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:AS8PR04MB7511.eurprd04.prod.outlook.com;PTR:;CAT:NONE;SFS:(13230031)(396003)(39860400002)(366004)(346002)(376002)(136003)(230922051799003)(230173577357003)(230273577357003)(1800799012)(451199024)(186009)(64100799003)(2906002)(38350700005)(5660300002)(41300700001)(83380400001)(478600001)(6486002)(26005)(2616005)(1076003)(38100700002)(52116002)(6506007)(6512007)(6666004)(8676002)(8936002)(4326008)(36756003)(86362001)(66946007)(66556008)(66476007)(316002);DIR:OUT;SFP:1101; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: is5CA8i7i13JA+soXlJDr3baFZ/qyCY13jZHLz+XItT8w5grv+eJa9ObF3YbO7/8LUe3WAcBNGQvtoqSV3nkRJRb9XyAQQNaFWyal9IgCT5GP0Sn3GX6PnDbHa/E6UYKGE6igekAORXBjBLq4tGkQBsJUiPzW5XQ8Dw/oF4SIROs/m+QGq/WecYK/4DzioInjbn/ZSxRzAJQxYFxWRgpMXce7eBaHg1qRxVjkUC2+CNbWGBNFYa8FH1OR2Ej0AlS4UIiG3eWP+lkyDQDogCt04i84NEtSVKfOP3+9KwQXEc4jXr2DrtBQ0AZqm/jJy78N2rpeEe0mWAvgcrzre/rH8hP8/lKooVfGBWZhqZyx+sbzX+oImQ/On83KeOBES7h+4ftMuOUZ9ukPvTHoEjHx28fO4D80fGkFq4m1r3KxkR5Iudoe9fBJvYeNwmxHQxmm2nDzK1+2py3WEKLi8XxCm759YCgfcI9V5PzBQdDeVwG0v9ByRpxyBpzaCyPn1ri4Qg4azXxg7phL02JVbLSpO7Iqf2i67YwkXGelKJM6U6N5MIyq7JlzFGV165F6O3isyyQLmWgI9lzRB2NUWeOpcjxuYBhMwKBj+4fhUJ9d3O3gxA/gTDXIc7+jzFykBlP/1yzPuDQ20BWtku2n4coO2npmDLU4O6Y+xOVh5Za0piTF6fd6bHlspmUNXU4K7Q4VdYjxXdbYPSA+bNSMn4nexyZTt3dtPXfDLKkmLNU6bzIKoGSfeB6Hi/IdJDidXmVLx2O4AexmRaUz4kbL6jMMXLawqpORg4lEJmbp0A1hFsompJBERqhio1DfKVEiwvfG8utYreplBg0FIRVsljwtKMXdFWu53GQ8bKsrmGsdQOpbZ9GbmpsWPdmbuPv0ON4d1Js8MnJgLU1rBsmpYCBwVqm8xmDo9CRUKj49YwqFEDl+AsGO2oj5ngjc0JK3SOjj1wgJvy4Gs8Qh1ibWhQT6GPL6EjZjrYYs6REpGpz/Hplo1PCKUqrx2zEo1Quwm1ztNuhmAq32rQxReWxJ3jOSy2KtrD1TUYpoe5HmIIL/LU5gqdmXU7gnroY/1dJdL3v3Ln/sjr4I26xjNkO80bNQ9Pu4jsC3rUnU8aupfN5XmnkVhUnRHd5JednSB1EN7uKfLRBp4nrfOV1nnx3o/WWP1rzvUpVm3spYHRh8aXQJpnmKWAmgi9JVNCqYF8suRSfoWIwIID6UjQndoS39fZkvga5BIZrYRpjjEauWX5cOXcVf6z2ZhDZqoLqt7vOrGbor4XvqFlsBl9yk/QQ5S+rMCz4Vf1qbM175j9XkzbIcxa9Hj2JGYCJkA0Bky6nVvL2tRAyEJqp3QfDb33icR9cRbZbKFyGSSHLxGAi5eNzkNEmpkGOV+uBPt67HXuwDPZGJn7TRY4YltUH9QVUXs/4VyRgSuxK1Sw3lXus/ibB6HYLAX2+aJ3aSYxDztkg1zXBTmwxfLzQZBGXNZFz6V7Rny0tIQUouBrqWrFMMaIISB3l0AH9nPg8DtjCmvb3eBePCXxV9Gj0F6SLxMc1EEbnkZpY+a7phMjgDm6pvxsTJ2ea4uYKwGVXMCcv+eyDIUsD X-OriginatorOrg: nxp.com X-MS-Exchange-CrossTenant-Network-Message-Id: 19e97e04-0030-4615-1058-08dc10d37a50 X-MS-Exchange-CrossTenant-AuthSource: AS8PR04MB7511.eurprd04.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 09 Jan 2024 05:26:05.7447 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 686ea1d3-bc2b-4c6f-a92c-d99c5c301635 X-MS-Exchange-CrossTenant-MailboxType: HOSTED X-MS-Exchange-CrossTenant-UserPrincipalName: HYAQuXbGeFZca7CuUC635RW+jxyrIvnXkmYajsM2dhUy2qoJf48IVNHPILzSzJiO3xe0M/r+EDIEXyPwFuJTZQ== X-MS-Exchange-Transport-CrossTenantHeadersStamped: PAXPR04MB8110 X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: 1787589282526562714 X-GMAIL-MSGID: 1787589282526562714 Fix warning found by 'scripts/kernel-doc -v -none include/linux/i3c/master.h' include/linux/i3c/master.h:457: warning: Function parameter or member 'enable_hotjoin' not described in 'i3c_master_controller_ops' include/linux/i3c/master.h:457: warning: Function parameter or member 'disable_hotjoin' not described in 'i3c_master_controller_ops' include/linux/i3c/master.h:499: warning: Function parameter or member 'hotjoin' not described in 'i3c_master_controller' Signed-off-by: Frank Li Reviewed-by: Miquel Raynal --- include/linux/i3c/master.h | 3 +++ 1 file changed, 3 insertions(+) diff --git a/include/linux/i3c/master.h b/include/linux/i3c/master.h index 65b8965968af2..1cbf0baca65fe 100644 --- a/include/linux/i3c/master.h +++ b/include/linux/i3c/master.h @@ -426,6 +426,8 @@ struct i3c_bus { * for a future IBI * This method is mandatory only if ->request_ibi is not * NULL. + * @enable_hotjoin: enable hot join event detect. + * @disable_hotjoin: disable hot join event detect. */ struct i3c_master_controller_ops { int (*bus_init)(struct i3c_master_controller *master); @@ -467,6 +469,7 @@ struct i3c_master_controller_ops { * @ops: master operations. See &struct i3c_master_controller_ops * @secondary: true if the master is a secondary master * @init_done: true when the bus initialization is done + * @hotjoin: true if the master support hotjoin * @boardinfo.i3c: list of I3C boardinfo objects * @boardinfo.i2c: list of I2C boardinfo objects * @boardinfo: board-level information attached to devices connected on the bus