From patchwork Mon Oct 9 10:33:51 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: tip-bot2 for Thomas Gleixner X-Patchwork-Id: 149934 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a59:a888:0:b0:403:3b70:6f57 with SMTP id x8csp1772866vqo; Mon, 9 Oct 2023 03:34:27 -0700 (PDT) X-Google-Smtp-Source: AGHT+IE9ZEGL2KhcGWHbNfEyj0wLujs0CC/hVm+7ZGh7BexJR74gHIVBZY5m/7KsRVF6YzsX43fq X-Received: by 2002:aca:280b:0:b0:3a4:298f:b2e0 with SMTP id 11-20020aca280b000000b003a4298fb2e0mr15632748oix.26.1696847667183; Mon, 09 Oct 2023 03:34:27 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1696847667; cv=none; d=google.com; s=arc-20160816; b=kaDLJdNW2hdgsBqFyWGdN9+asLOsBwRzAELJBeXbnVGm1VNzhCfTa8iTRxBD76mFE+ 5H4ucagF03mrfkhSXW8s0Y2kl/HifIshVgJMwEagEaDWGe3+LRgSRvcTy2w573OG/YK8 Mlf9zEey9Z57m1/K4gbQC9NcQyTJlZ8S+7Mvfsw1oSss0AP16z8JiDLLRkxaTdFDbLIb Rff7ZGwGpfJtqj61cgsK3fWlHPSk2yg6MYAD+vvvgBYQKSbdQysNayPGZXcfm/nlJWMG Vj5zHeS1xcQ//NcFUpFZc2CvZL7yKEfOSuhOP9Ac+Kh5iyHg93Tk/ZP7eunKZhXEZo+M OkBg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:robot-unsubscribe :robot-id:message-id:mime-version:references:in-reply-to:cc:subject :to:reply-to:sender:from:dkim-signature:dkim-signature:date; bh=ED3Q9EjTvFOqHf0F/fp3lKmzOsY2Fj8/fhVP6Rz/qq8=; fh=AzCX//G+255O8a10y5F1hb1p6OqztEaGEunIxgTrW/w=; b=Gd/uFqUI3Z1mKpJUC79EQpFA4uSxIu4GARL00/F3ay+PT/GkMhkJBV8Vm/WNB39ens EjOUB9AMovOK6Lj0bqGn8Z8a40nUjlh0oDpIg15k1uQ1xq4ZvUogZkWqsR9xIJw18MoF zrogEt9QqkDOdBNUF0+eN1flNQ6wq7f7BhdCT15sbe8YULfXJsyi2sywWju7hW6ktPa+ C4Hj4/yXmg60Sp1ElBF9JYidn+OYo8MZUgzMGXEQts1BRJY4nhYsGDhjLtHxmrQ4HO1a 5YnCTDj1mvnVyirKbdz3sqHYs5CyCD7yoARkBNlbQos456xXWevFHkRmkAIv4tJuwlbT CDKg== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linutronix.de header.s=2020 header.b=1O76Tzng; dkim=neutral (no key) header.i=@linutronix.de; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.35 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=QUARANTINE dis=NONE) header.from=linutronix.de Received: from groat.vger.email (groat.vger.email. [23.128.96.35]) by mx.google.com with ESMTPS id cf5-20020a056a02084500b005859c874eb5si8711182pgb.275.2023.10.09.03.34.26 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 09 Oct 2023 03:34:27 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.35 as permitted sender) client-ip=23.128.96.35; Authentication-Results: mx.google.com; dkim=pass header.i=@linutronix.de header.s=2020 header.b=1O76Tzng; dkim=neutral (no key) header.i=@linutronix.de; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.35 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=QUARANTINE dis=NONE) header.from=linutronix.de Received: from out1.vger.email (depot.vger.email [IPv6:2620:137:e000::3:0]) by groat.vger.email (Postfix) with ESMTP id DA79A8052BD3; Mon, 9 Oct 2023 03:34:24 -0700 (PDT) X-Virus-Status: Clean X-Virus-Scanned: clamav-milter 0.103.10 at groat.vger.email Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1345829AbjJIKd6 (ORCPT + 18 others); Mon, 9 Oct 2023 06:33:58 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:60282 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1345759AbjJIKdz (ORCPT ); Mon, 9 Oct 2023 06:33:55 -0400 Received: from galois.linutronix.de (Galois.linutronix.de [193.142.43.55]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id D440C9C; Mon, 9 Oct 2023 03:33:53 -0700 (PDT) Date: Mon, 09 Oct 2023 10:33:51 -0000 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linutronix.de; s=2020; t=1696847632; h=from:from:sender:sender:reply-to:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=ED3Q9EjTvFOqHf0F/fp3lKmzOsY2Fj8/fhVP6Rz/qq8=; b=1O76TzngN6JMYbkBMKcuu6QxC9AtzdG5Iyh43yjtaKxyYJjHhtI8vH/JIytigD+hlgVtRa R7tRpKBiCm0lyYPIBHxEITQsiXj/9+WylbqYSiBRIEfxnYGbqkOEAMvH3lijyhpwPQgE7b MSXn9Q4Zz9cp9sOQ1ciMuZpiHkSGT5REHkuXyz2+jRhg1Ko2BUPMWn36Eyq9Q0JxftY+f9 MlIRIdGOeMmYJDyoR2cP3sebccRtlYoJe3co3J0lnPKMe1OiIjQEUiu+AMje4U6pY7gLrf BxHCop0u5fdr4WECYVcsKBQejpdABWONHcOmjUCq9IkFYP8n/2fofyZG1dUPhw== DKIM-Signature: v=1; a=ed25519-sha256; c=relaxed/relaxed; d=linutronix.de; s=2020e; t=1696847632; h=from:from:sender:sender:reply-to:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=ED3Q9EjTvFOqHf0F/fp3lKmzOsY2Fj8/fhVP6Rz/qq8=; b=Zochh8pnIHQzxrmzxfltO7ruWbcxrZGQE0Mdu2vPuJ3oiLcEgDpzx30nEMb+AfQ5JfVa30 NyV3lP+fwYK2SzDA== From: "tip-bot2 for Lucy Mielke" Sender: tip-bot2@linutronix.de Reply-to: linux-kernel@vger.kernel.org To: linux-tip-commits@vger.kernel.org Subject: [tip: perf/core] perf/x86/intel/pt: Fix kernel-doc comments Cc: Lucy Mielke , Ingo Molnar , x86@kernel.org, linux-kernel@vger.kernel.org In-Reply-To: References: MIME-Version: 1.0 Message-ID: <169684763154.3135.4873019894270877876.tip-bot2@tip-bot2> Robot-ID: Robot-Unsubscribe: Contact to get blacklisted from these emails X-Spam-Status: No, score=2.7 required=5.0 tests=DKIM_SIGNED,DKIM_VALID, DKIM_VALID_AU,HEADER_FROM_DIFFERENT_DOMAINS,MAILING_LIST_MULTI, RCVD_IN_SBL_CSS,SPF_HELO_NONE,SPF_PASS autolearn=no autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on groat.vger.email Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org X-Greylist: Sender passed SPF test, not delayed by milter-greylist-4.6.4 (groat.vger.email [0.0.0.0]); Mon, 09 Oct 2023 03:34:24 -0700 (PDT) X-Spam-Level: ** X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: 1779273739101451168 X-GMAIL-MSGID: 1779273739101451168 The following commit has been merged into the perf/core branch of tip: Commit-ID: 38cd5b6a875adc877681faf8e3ad47fdbd6eceb5 Gitweb: https://git.kernel.org/tip/38cd5b6a875adc877681faf8e3ad47fdbd6eceb5 Author: Lucy Mielke AuthorDate: Mon, 09 Oct 2023 08:54:54 +02:00 Committer: Ingo Molnar CommitterDate: Mon, 09 Oct 2023 12:26:22 +02:00 perf/x86/intel/pt: Fix kernel-doc comments Some parameters or return codes were either wrong or missing, update them. Signed-off-by: Lucy Mielke Signed-off-by: Ingo Molnar Link: https://lore.kernel.org/r/ZSOjQW3e2nJR4bAo@fedora.fritz.box --- arch/x86/events/intel/pt.c | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/arch/x86/events/intel/pt.c b/arch/x86/events/intel/pt.c index 42a5579..8e2a122 100644 --- a/arch/x86/events/intel/pt.c +++ b/arch/x86/events/intel/pt.c @@ -736,6 +736,7 @@ static bool topa_table_full(struct topa *topa) /** * topa_insert_pages() - create a list of ToPA tables * @buf: PT buffer being initialized. + * @cpu: CPU on which to allocate. * @gfp: Allocation flags. * * This initializes a list of ToPA tables with entries from @@ -1207,8 +1208,11 @@ static void pt_buffer_fini_topa(struct pt_buffer *buf) /** * pt_buffer_init_topa() - initialize ToPA table for pt buffer * @buf: PT buffer. - * @size: Total size of all regions within this ToPA. + * @cpu: CPU on which to allocate. + * @nr_pages: No. of pages to allocate. * @gfp: Allocation flags. + * + * Return: 0 on success or error code. */ static int pt_buffer_init_topa(struct pt_buffer *buf, int cpu, unsigned long nr_pages, gfp_t gfp) @@ -1281,7 +1285,7 @@ out: /** * pt_buffer_setup_aux() - set up topa tables for a PT buffer - * @cpu: Cpu on which to allocate, -1 means current. + * @event: Performance event * @pages: Array of pointers to buffer pages passed from perf core. * @nr_pages: Number of pages in the buffer. * @snapshot: If this is a snapshot/overwrite counter.