Received: by 2002:a05:6358:9144:b0:117:f937:c515 with SMTP id r4csp1055319rwr; Thu, 20 Apr 2023 09:23:01 -0700 (PDT) X-Google-Smtp-Source: AKy350YPdOw0t4Oe5pIXEFvtrpCkrz1WjUmhEcKenjR3lfag4mFw+gSyYo/GsBn9h29Hx+D9qoNQ X-Received: by 2002:a17:90a:9a8b:b0:247:53b4:ec52 with SMTP id e11-20020a17090a9a8b00b0024753b4ec52mr2274032pjp.8.1682007781655; Thu, 20 Apr 2023 09:23:01 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1682007781; cv=none; d=google.com; s=arc-20160816; b=uPIGdZgEy7Q3qU1nc0RsqccNMN08HtklA3Fh4a9X/G0X2ONMRp4TlgLV2+KXpvAZ+C Mx3tI73x56d6advRPxidZDYOa9j9+XknZRejm5AIz+EURja5NWslOqI9fSL/uc8TLS03 71vrwKMQTERy3ypf0bBKvMOIFzrHX4TB1lAifZJB7A0nJNljIvrVelKBX8gNrxRrS8Uq XIk5lz7isewgfGEZofRfHtypyQAwo31d736+8srQwIN3R9dnmGSG6Qhyvwmn66LEsj6s 910lq/o/Od4cfb6TjHyIobQXlzKY0Leq1JSxkpMryEIyFus+6ecE2DiD3YZMiJunkhU/ 1cXA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:mime-version:message-id:date:references :in-reply-to:subject:cc:to:from:dkim-signature:dkim-filter; bh=dIoh7Uzva2QsUh5vyGcccNj94Y882Db73hATcucqawE=; b=w1KwzXYXqgjlIB/C4ilkaD5cf6UBRCn+ecz0jNdI7rmwiekxaAgkEfiuwfr0STwsUA 9jGz+Jc1E3D5IubxzOhbDoFIlvFvBOE/zECI8GtRtSZZB2kVgB7G+LsuwAL6bVV9/0VL AegxRh877PYfOtDsvo0pp2uElZnH7wMCSiaRJzYiKkCJzPDW3bac2phwoxDUHh054Pyh KNPQZDnytF0rbNHu/Zh2Act5WBLmNR3qFfCFuxh+xWTaENsp1O39g7kDX1zvgW/OiWj7 jiCiMOWuaE6u+BAndAv6Ei+xsK9fjpAP/vQPg3tPYfHPT8kCV8ALe1nl0t4/T2XaPfcz 2bHg== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@lwn.net header.s=20201203 header.b=VANjqdpH; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Return-Path: Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id y7-20020a17090aa40700b0024769e2d554si2277913pjp.34.2023.04.20.09.22.47; Thu, 20 Apr 2023 09:23:01 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) client-ip=2620:137:e000::1:20; Authentication-Results: mx.google.com; dkim=pass header.i=@lwn.net header.s=20201203 header.b=VANjqdpH; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S232257AbjDTQQA (ORCPT + 99 others); Thu, 20 Apr 2023 12:16:00 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:39452 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S231341AbjDTQP6 (ORCPT ); Thu, 20 Apr 2023 12:15:58 -0400 Received: from ms.lwn.net (ms.lwn.net [IPv6:2600:3c01:e000:3a1::42]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 9CD703596; Thu, 20 Apr 2023 09:15:57 -0700 (PDT) Received: from localhost (unknown [IPv6:2601:281:8300:73::5f6]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ms.lwn.net (Postfix) with ESMTPSA id 4038C2AE; Thu, 20 Apr 2023 16:15:57 +0000 (UTC) DKIM-Filter: OpenDKIM Filter v2.11.0 ms.lwn.net 4038C2AE DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=lwn.net; s=20201203; t=1682007357; bh=dIoh7Uzva2QsUh5vyGcccNj94Y882Db73hATcucqawE=; h=From:To:Cc:Subject:In-Reply-To:References:Date:From; b=VANjqdpHV1W5XdXIB/wV+x8VC4ql3kGUs/Per8arX/UNuGOuxeKFb/7Av0anFrvms k2opc6Z1dgRJBQh0L+vo4aO3IZ6rk1D1BicOJephalElMdkwyzKggqcxWNqG4OVJLo KloTTSAaHOH4IGy3uYVMjyqnHdaIJTj7zO3MOaqMsisjTVETjJkOO66AcYdmNbZn3D xcJNJf0KQeN4YWpLFn2TkGN+FDvBF6CFmG6Ph9Y320FpFKBVDL1z2sFaliP6/C7v4y FTZSDSMqKbWjWmDM4+nEUU8ASgxHKz0/vH/CfYklDAAipUkksA5j/Ri8cMe226p3TD Mktp/fj4YA+LA== From: Jonathan Corbet To: Brian Masney , sboyd@kernel.org Cc: linux-clk@vger.kernel.org, linux-kernel@vger.kernel.org, mturquette@baylibre.com, linux-doc@vger.kernel.org Subject: Re: [PATCH] docs: clk: add documentation to log which clocks have been disabled In-Reply-To: <20230411192153.289688-1-bmasney@redhat.com> References: <20230411192153.289688-1-bmasney@redhat.com> Date: Thu, 20 Apr 2023 10:15:56 -0600 Message-ID: <87y1mmsf5v.fsf@meer.lwn.net> MIME-Version: 1.0 Content-Type: text/plain X-Spam-Status: No, score=-2.1 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,SPF_HELO_NONE,SPF_PASS, T_SCC_BODY_TEXT_LINE autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on lindbergh.monkeyblade.net Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Brian Masney writes: > The existing clk documentation has a section that talks about the > clk_ignore_unused kernel parameter. Add additional documentation that > describes how to log which clocks the kernel disables on bootup. This > will log messages like the following to the console on bootup: > > [ 1.268115] clk: Disabling unused clocks > [ 1.272167] clk_disable: gcc_usb_clkref_en > [ 1.276389] clk_disable: gcc_usb30_sec_sleep_clk > [ 1.281131] clk_disable: gcc_usb30_prim_sleep_clk > ... > > Signed-off-by: Brian Masney > --- > Documentation/driver-api/clk.rst | 5 +++++ > 1 file changed, 5 insertions(+) I've applied this, but... > diff --git a/Documentation/driver-api/clk.rst b/Documentation/driver-api/clk.rst > index 3cad45d14187..2199c0042e75 100644 > --- a/Documentation/driver-api/clk.rst > +++ b/Documentation/driver-api/clk.rst > @@ -258,6 +258,11 @@ clocks properly but rely on them being on from the bootloader, bypassing > the disabling means that the driver will remain functional while the issues > are sorted out. > > +You can see which clocks have been disabled by booting your kernel with these > +parameters: ...I took the liberty of making that "parameters::" so that the options would be formatted as a literal block. > + tp_printk trace_event=clk:clk_disable > + > To bypass this disabling, include "clk_ignore_unused" in the bootargs to the > kernel. Thanks, jon