From nobody Tue Apr 7 14:36:43 2026 Received: from mail-pl1-f175.google.com (mail-pl1-f175.google.com [209.85.214.175]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 24D333FE37F for ; Thu, 12 Mar 2026 17:54:05 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.214.175 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1773338046; cv=none; b=YvZ5xVaxXSISb5GrJkPhihxG7g5ebNxEzsTozToCy6GtSH/MjuwfVJmP8e/sdXI1jdaBq/zGLRa493wad4kpONp/kDERRyl5x43kue9ulc8ZPzxDyZqmCqs/DjXMDRUTy1FOCt1WULawP/KOCLCa+LLAxrNewOuGthKJPnEks/c= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1773338046; c=relaxed/simple; bh=0mqHB9yCWgRA+Ai3Bj2tlZRNssxUZO57dPTv+g71rYU=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=PNXWMRMdoScG/6nmvxdR1NmDMnYjoCQBEpJGDFl6kerVCWRh6JbE4LxZZdp8Uk6HALptHtagf2rjwV2Oo28COES5IHrmlzcXla0iv/f7TT21fD4i/7MH9YGoUN2dgGsote2M5np0OKJf3+O9Ztgq3ShDby8pxAmcOPdFXNqhBj0= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=QtAdK+Ae; arc=none smtp.client-ip=209.85.214.175 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="QtAdK+Ae" Received: by mail-pl1-f175.google.com with SMTP id d9443c01a7336-2ad21f437eeso11192575ad.0 for ; Thu, 12 Mar 2026 10:54:05 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1773338044; x=1773942844; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=1AHYXlCzw3aqCugUumSoYXfA+lp584l7NZmh/mNebwA=; b=QtAdK+AerAI634FbrngbY5Q9mmbUrgeoBov06sQTMuQvnN7iqd5y/swZKG6le+eVvU /72rcraGffnlsPgKASkTH0czuQQhIj6jlIP8U5WlOrh4wGf07xxGxurrdtCkwU1YMO7h 2rvq9BbAUhEhSybd1rVi9XeSLXXBXNHgbs+eEhqU8ihWpG2qhmpQhFIpDIucvl9Ld6de /50fzw8ezaoxeWk2BkOcd6GVRMHM5L/0XHuC6oBb0v2J4CQyjvbsm+a5EuwKjOoHLR6m 5bsFPhAjL+GEQO9Taxc/HhQYvilnQ4274GUnD8aYYbYHinwZ0dtM6GkJpEHPeP5OnMbN /7BQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1773338044; x=1773942844; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-gg:x-gm-message-state:from :to:cc:subject:date:message-id:reply-to; bh=1AHYXlCzw3aqCugUumSoYXfA+lp584l7NZmh/mNebwA=; b=cdfQx/vQg2nQjJPZIjnZgcAE1/hjo/mWLTHnrmM+t/+wMAwsMt0OIPgyZkqfoNBesE EqO7kHDS2Gnd6hqLJzt0HUey/5g98ZbR2EdsXA668dWjb5RJw5Msm/0K8QVxE7cg/wtW hFVdMv4qtBoiyY/7o00vo+Fb7zIdm3B0wN4X9NDLhvFwDehWA74HpqYpbqgXa8cOhPqd wYyqFwLpnhTCoDen6eioDFdG+CZC21FCPiACVB8KGiQBhqU7M65G/8e9RLYTIBu8fDQ7 Xh3MJteNMXhN4BrX3PwXgzOQagbU5o6uoVZc+HDfDFZPiJkXrYH7nQ65uM3S35a5ZTa5 rLuA== X-Forwarded-Encrypted: i=1; AJvYcCXCeiuNsSMeyeMXsGD2Ilb9Pcweop4Wdroq4zUnE9okgG2Ya6TPrKOjvTWPUAzKN3T0I9+63Dgcvm35uBY=@vger.kernel.org X-Gm-Message-State: AOJu0YxZ2SEnTAO0I5kO6QcoSH4ONav4+xMTAoC5YJVa8E0+f282Fy6r gk0H5LQAH+17pgvlrr/j8FwmzLIjMZEYmCWRcrSBzR9zCwPQTqcBCnYQ X-Gm-Gg: ATEYQzzyBcKd4yjHCF+XxpN0Gow0A5qwNpSXfuD/Yd3/L9lzl581yuTrzbLB1YNdLUZ VFwDT8A9lKqOd3pNWsWMAlgobylMqPcHogBmQyXlO63E3WVbWWl+c0f3+jkMnhi5qT4TfYJ/hw1 JZ+YRLL1hpcAcAydqbE5BFZeQODu7zKjvcdsZmyG4rC76NCkr6Qj1D4Mkvd33ZMWIemE7jwmiCr CiaBhALV3R69DF81ed2M+74sdIGr5B74kO+PXHW8q7qiURy2NKOWm63mKqf9HiZgsVvpgjtxEAq KNK78rY13VKw9YbGIReROffRhTb7RVjr0Dls/UyuUW0ttfex/m/fDAdMBlZTpB4AqmwE2IaSQvH F1xCGGbUT4qzxzetzOAxS3KKpk3wY9xzsZgpXR0SvTFb3UcZd1ci2se6a07WkB0iY7ycWKQgAtp 5TNAJ1401EWO7XaUJWf+jbmF5ICwphyLpWBXONIcTYDUMsYz8yMxwIJm8tWA0G1qKLReDbVtZWe WLUGZdsKNBI0X88/djPitrbqvrkfDE2LrBf X-Received: by 2002:a17:903:2f8c:b0:2ae:42c1:6f49 with SMTP id d9443c01a7336-2aeba4eac08mr40989635ad.15.1773338044416; Thu, 12 Mar 2026 10:54:04 -0700 (PDT) Received: from visitorckw-work01.c.googlers.com.com (7.162.199.104.bc.googleusercontent.com. [104.199.162.7]) by smtp.gmail.com with ESMTPSA id d9443c01a7336-2aeae378ca7sm60453345ad.91.2026.03.12.10.54.02 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 12 Mar 2026 10:54:03 -0700 (PDT) From: Kuan-Wei Chiu To: djakov@kernel.org, corbet@lwn.net, skhan@linuxfoundation.org Cc: marscheng@google.com, wllee@google.com, aarontian@google.com, jserv@ccns.ncku.edu.tw, linux-doc@vger.kernel.org, linux-pm@vger.kernel.org, linux-kernel@vger.kernel.org, Kuan-Wei Chiu Subject: [PATCH 1/2] docs: interconnect: Add provider APIs to documentation Date: Thu, 12 Mar 2026 17:53:40 +0000 Message-ID: <20260312175341.2944154-2-visitorckw@gmail.com> X-Mailer: git-send-email 2.53.0.851.ga537e3e6e9-goog In-Reply-To: <20260312175341.2944154-1-visitorckw@gmail.com> References: <20260312175341.2944154-1-visitorckw@gmail.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" The "Interconnect providers" section currently only includes data structures from include/linux/interconnect-provider.h. Include drivers/interconnect/core.c to extract provider-specific API documentation. The :functions: directive is used to prevent mixing with consumer APIs. Signed-off-by: Kuan-Wei Chiu --- Documentation/driver-api/interconnect.rst | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/Documentation/driver-api/interconnect.rst b/Documentation/driv= er-api/interconnect.rst index a92d0f277a1f..cf7a83f8c953 100644 --- a/Documentation/driver-api/interconnect.rst +++ b/Documentation/driver-api/interconnect.rst @@ -84,6 +84,12 @@ be registered with the interconnect provider core. =20 .. kernel-doc:: include/linux/interconnect-provider.h =20 +.. kernel-doc:: drivers/interconnect/core.c + :functions: icc_provider_init icc_provider_register icc_provider_deregi= ster + icc_node_create icc_node_create_dyn icc_node_destroy + icc_node_add icc_node_del icc_nodes_remove icc_node_set_name + icc_link_create icc_link_nodes + Interconnect consumers ---------------------- =20 --=20 2.53.0.851.ga537e3e6e9-goog From nobody Tue Apr 7 14:36:43 2026 Received: from mail-pl1-f176.google.com (mail-pl1-f176.google.com [209.85.214.176]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 3AA653FE64F for ; Thu, 12 Mar 2026 17:54:10 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.214.176 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1773338051; cv=none; b=dEhG4KzSCPFHA4n8JejV2nl9KnTtLBMwszPUXj2gPjLwz/NVxB76Pic6+tEwXG1dXS+wztXLv3DYEpZ2oN488e/rI1riK3dky8bQrG6ghYLwD1u5QiOujw4kB/IW/SkyYbIFWpNh8cDzXdIHCYxIpyPqFu+NaiDaElzW4id+7QY= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1773338051; c=relaxed/simple; bh=JCTBH7GXPbxvcv4uKgjSOwbR68uwRtHYauKTbfhWfuk=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=OXmK9zbB/eqgQtVSMT1fpMI/xsad3zCZyG+sgjlRCWHkZh0BCFlGXMYZ4WMphGAakQFd0v5eXDSEAobubR1VIR9siFJL3barKlbq+qm5lsxy0e3cjVK0PTNkJRKjA1NwdnHH9Q2Q9Jnx2AubgaDtWzwg43DeX0YiU8cILvV533s= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=QsczDYEn; arc=none smtp.client-ip=209.85.214.176 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="QsczDYEn" Received: by mail-pl1-f176.google.com with SMTP id d9443c01a7336-2ae4e538abdso15128935ad.3 for ; Thu, 12 Mar 2026 10:54:10 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1773338049; x=1773942849; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=uUkJl4DF7APJYPjD474UUxiLiC7WbxzdLnKNmRAWUWg=; b=QsczDYEnpqjOeM9qM7T4bSWbvkCrmkOGQMkWci28R5R3WswZiQSf3YDXOxeu9fvZjp juyksWSwnKJC9yutWn2HT0oVGj0be2MUBrKjwJbNShZgq8g8jjB1dNvT8FmlzeIGuoI1 gt5J+YoRpcE/BI9jcF2HejhKGZl0NQxlG40g8+Ru6C3UsHn9rU0hM/wp+WxWB4NcoCTJ m2awI8W9mX2SMUOwsTmT7ce46SE9alITjX0kogwYkPGnLemYLehUHAKsKt4bM679dWVt 9IzwOXJmH0/VpJ1xVVWKCviafDGj8/PNQSmtg2PllqVwsKG19MmhSZwsq4z7LyYFFKTs KEeA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1773338049; x=1773942849; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-gg:x-gm-message-state:from :to:cc:subject:date:message-id:reply-to; bh=uUkJl4DF7APJYPjD474UUxiLiC7WbxzdLnKNmRAWUWg=; b=NwWEUGRYUf/EQl0YzHjz5daXDrM+3q7uQoHTvDXsJjIxOkBhHrzX7qed8DiWLkPUC6 f63Ec+l4BqNy8M9CPTJhhaDNLSan2EMZ+FykpYNNW/n8SD6559HdbRSjyXzNoFWfK+Yg Tw1EDxjM2OqLEBcXHaz7AGIQVxSd8stxRNyeEYc3tB5bANYiCDi7jHku4M47q2u97Y2D D0ptbZa9JWTxPeWWS6YC/QLCzwW6MbEBsKGZJ5GuxnCGfYLZCtM1k0BEoHbECD2nL4YA jyNqObrzqXJLKpkPHiKclhzki1LA2Nor8l0vasF6eDF1Wg4X6e9j+T/9MbhHmh9ooYLv ExSw== X-Forwarded-Encrypted: i=1; AJvYcCXPgejrJLj/yTG0DAQft5N/KxQyWUdrk/vPEXEmhAWYmrHHTnt/7T94Wec7qv2DUv1DDBtsN9fCP9hPiKE=@vger.kernel.org X-Gm-Message-State: AOJu0Yzna6u+BfVnR4N4pK57QA/Bvvs9iG+uv+eB6RGCOrnOR6ZCnWae KDRl5TixEOO9D5BdZoUUFPo9Tx+lRqMjCHzYxw6et7DPSDwxbVCB9xlh X-Gm-Gg: ATEYQzxYQThE2Iri32oYnE9UbqVZ+9B6mkTLyqPHZQC+6VUh1crk+ElhVSoO+jdgBkc VKF+X0/Lt/9erBuw+y0+CGaAo01R6bjZfF3Im6T1AWCRd9YUGr/qAU7e2ZDudurAR9SKvMTxxpd p+gFDjr5yrLwHzys0AleHEwRpdRdt5IWV+Xtulk8gkk19B7cuQKOSJ8l1xt8FV3cI83WCDB/nTK L3f+77//mYc3LEgRrPzP8yKm/RXB7QbfpfdemAb0gtJDbK9T8Zo/HTZ0JbM4HYu5B3hZRjiqNpZ 1k/NzfO/Sg2BCIdWNVWG6cJfufZ6lGzZp09bOck4G/F93AqWN6ifm9f4eairv0hJlNCcsTBaL7x fp253OGVvga3Ul5caYT1e8Jq2np8K4VvyRxF4DZWv0rrEHNgvtf5O9LBMC4vA8M+iJkjfn2B6vu MeeX3paDAjh+Eq0THvsx9tBgB88mM8bOcpaxIBB6xzmUodeh6V3VEhsw1NzJgRQVGbTIRDS1xJU aPpzfzhFvzIF1Oe7kFWTzuGoOEsW88t5B7CtgUVOYIcr+w= X-Received: by 2002:a17:903:17c3:b0:2ad:d5d7:bad2 with SMTP id d9443c01a7336-2aecac36dfdmr3146585ad.48.1773338049641; Thu, 12 Mar 2026 10:54:09 -0700 (PDT) Received: from visitorckw-work01.c.googlers.com.com (7.162.199.104.bc.googleusercontent.com. [104.199.162.7]) by smtp.gmail.com with ESMTPSA id d9443c01a7336-2aeae378ca7sm60453345ad.91.2026.03.12.10.54.07 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 12 Mar 2026 10:54:08 -0700 (PDT) From: Kuan-Wei Chiu To: djakov@kernel.org, corbet@lwn.net, skhan@linuxfoundation.org Cc: marscheng@google.com, wllee@google.com, aarontian@google.com, jserv@ccns.ncku.edu.tw, linux-doc@vger.kernel.org, linux-pm@vger.kernel.org, linux-kernel@vger.kernel.org, Kuan-Wei Chiu Subject: [PATCH 2/2] docs: interconnect: Document consumer APIs and drop outdated text Date: Thu, 12 Mar 2026 17:53:41 +0000 Message-ID: <20260312175341.2944154-3-visitorckw@gmail.com> X-Mailer: git-send-email 2.53.0.851.ga537e3e6e9-goog In-Reply-To: <20260312175341.2944154-1-visitorckw@gmail.com> References: <20260312175341.2944154-1-visitorckw@gmail.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" The documentation currently states that consumer interfaces are not documented, which is no longer true. Remove the outdated claim and include the existing kernel-doc from drivers/interconnect/core.c (filtered for consumer APIs) and drivers/interconnect/bulk.c. Signed-off-by: Kuan-Wei Chiu --- Documentation/driver-api/interconnect.rst | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/Documentation/driver-api/interconnect.rst b/Documentation/driv= er-api/interconnect.rst index cf7a83f8c953..cebb77b49d8d 100644 --- a/Documentation/driver-api/interconnect.rst +++ b/Documentation/driver-api/interconnect.rst @@ -95,8 +95,14 @@ Interconnect consumers =20 Interconnect consumers are the clients which use the interconnect APIs to get paths between endpoints and set their bandwidth/latency/QoS requiremen= ts -for these interconnect paths. These interfaces are not currently -documented. +for these interconnect paths. + +.. kernel-doc:: drivers/interconnect/core.c + :functions: devm_of_icc_get of_icc_get_by_index of_icc_get icc_get + icc_put icc_enable icc_disable icc_set_bw icc_set_tag + icc_get_name + +.. kernel-doc:: drivers/interconnect/bulk.c =20 Interconnect debugfs interfaces ------------------------------- --=20 2.53.0.851.ga537e3e6e9-goog