Received: by 2002:ac8:3b51:0:b0:3f3:9eb6:4eb6 with SMTP id r17csp2758109qtf; Mon, 12 Jun 2023 09:30:16 -0700 (PDT) X-Google-Smtp-Source: ACHHUZ6lLvsrAqiRn9myfAmVwEfWfXVB0XMrbNoFhza9i9tNQYdqgnvuC9/ApkVfG/GhPvyVfFJ2 X-Received: by 2002:a17:90b:4fc2:b0:252:7114:b37a with SMTP id qa2-20020a17090b4fc200b002527114b37amr8592330pjb.47.1686587415839; Mon, 12 Jun 2023 09:30:15 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1686587415; cv=none; d=google.com; s=arc-20160816; b=xhNr1Z8QPgbPOwkDEkgh7KIXH0WRpSl1a7lpxl0XxuhWYl4qjzNoUBy7Hl/ZG5MXNf lO/FquC1jz2JvvMMes2QSWmkc0YtFQe+5cjj5HwTKjeZ2l387W7udCmffHRKJT/x8sDA 64NmT6CZLuokTajYlD3qVOFnFCD2OFv0q+tL0ZvXn59xf1HpeACtiY0b2kuSYMKEeHAw ja2737xUXSYJaTlY/uzbyXzM4iKF0GwdElTJz6zCm6rStYabQUNKpKu524iz8JCXOEOg 8Ttn0jFMCQ7om+RIEw/ij8eNhjopdPRMa0C0fGt2FNyhuYsAy5todPEB5KykdZ9L3gbT Ky9g== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:in-reply-to:from :references:cc:to:content-language:subject:user-agent:mime-version :date:message-id; bh=qt1TPwchcj2VuqrNTLbU1dI0zylo16OsUsxj0udlo1g=; b=H1Vx4GhpZKsE9r/tl9obiA0k5o1drk3/9PHAniJnQsHa39fiBOdaXtIzetsytyFz8c 0l7cO76x59ud5wPZkLTGeWAml/nz0Jd4WSxjG6ZYr37JbvhOdPj4qjuIWE1/ojs1f+3J aj06KdyyVlv3HT7fQg0VofE7LPQUWHG+z4Qh7ZFM57ARjZi0B66GUve4+29z69EJWE89 8YR9GcLeP5t3Irfv+Vzdvh76+6iVL/nJ6JOeoE5DACXNZgYCruOlOhBN/aSu5f4FLg7f 7ffaaTylSYpgmEvWXU+L6q5JnIvLr9uco31zjowLfQ74TU7RSxP2DmBwB6jKSQ/++EmA YzZg== ARC-Authentication-Results: i=1; mx.google.com; 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; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=acm.org Return-Path: Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id t12-20020a17090aba8c00b002597c3244c5si7184626pjr.80.2023.06.12.09.29.58; Mon, 12 Jun 2023 09:30:15 -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; 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; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=acm.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S237605AbjFLPaL (ORCPT + 99 others); Mon, 12 Jun 2023 11:30:11 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:56664 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S237032AbjFLPaI (ORCPT ); Mon, 12 Jun 2023 11:30:08 -0400 Received: from mail-pl1-f177.google.com (mail-pl1-f177.google.com [209.85.214.177]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 881001B8; Mon, 12 Jun 2023 08:30:07 -0700 (PDT) Received: by mail-pl1-f177.google.com with SMTP id d9443c01a7336-1b3cc77ccbfso7285315ad.1; Mon, 12 Jun 2023 08:30:07 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20221208; t=1686583807; x=1689175807; h=content-transfer-encoding:in-reply-to:from:references:cc:to :content-language:subject:user-agent:mime-version:date:message-id :x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=qt1TPwchcj2VuqrNTLbU1dI0zylo16OsUsxj0udlo1g=; b=LACI8dK6zyguXqfSuRhBMgacWIxDFOiIlKuWiEGI9nRXzKUBoYuoY3Qzp5RLzea3vT KngVfSTbq6B3LGU9zJxC0KV/iJNzpxuVMQX2mEcCGXWfZGQpUenoypaD1JY5hWcQZUkA NbgBBQWs/wL36/X5xP1fMsoBbQZ9rxNiv8MXfSNdmhr/5dlx6TLUZXhLFSF/4mZRdRXs leetK5TNVLy2r0Rnfv0qmXSUVzq2C+M0cWxOS7QlDjDsgELMNS0yzsCgF+WW3IREHFAP Z/ncCYv4H/PsoMY1Z2QAK03R4cWDQWPs1K16zmrEmaQhvso8GhxZnIlNEpUBoWQWYrMh rFMg== X-Gm-Message-State: AC+VfDwadUGramQnMowR+ym69z8ftHouyy7UT/RVPfv6yW8FJQhsWFUr uMhjES1QZRhfCDxAqoTehME= X-Received: by 2002:a17:903:2347:b0:1b1:99c9:8ce1 with SMTP id c7-20020a170903234700b001b199c98ce1mr7581876plh.51.1686583806811; Mon, 12 Jun 2023 08:30:06 -0700 (PDT) Received: from [192.168.51.14] ([98.51.102.78]) by smtp.gmail.com with ESMTPSA id jl1-20020a170903134100b001a245b49731sm6989724plb.128.2023.06.12.08.30.04 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Mon, 12 Jun 2023 08:30:06 -0700 (PDT) Message-ID: Date: Mon, 12 Jun 2023 08:30:03 -0700 MIME-Version: 1.0 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:102.0) Gecko/20100101 Thunderbird/102.11.0 Subject: Re: [RFC PATCH v8 01/10] dpll: documentation on DPLL subsystem interface Content-Language: en-US To: Arkadiusz Kubalewski , kuba@kernel.org, jiri@resnulli.us, vadfed@meta.com, jonathan.lemon@gmail.com, pabeni@redhat.com Cc: corbet@lwn.net, davem@davemloft.net, edumazet@google.com, vadfed@fb.com, jesse.brandeburg@intel.com, anthony.l.nguyen@intel.com, saeedm@nvidia.com, leon@kernel.org, richardcochran@gmail.com, sj@kernel.org, javierm@redhat.com, ricardo.canuelo@collabora.com, mst@redhat.com, tzimmermann@suse.de, michal.michalik@intel.com, gregkh@linuxfoundation.org, jacek.lawrynowicz@linux.intel.com, airlied@redhat.com, ogabbay@kernel.org, arnd@arndb.de, nipun.gupta@amd.com, axboe@kernel.dk, linux@zary.sk, masahiroy@kernel.org, benjamin.tissoires@redhat.com, geert+renesas@glider.be, milena.olech@intel.com, kuniyu@amazon.com, liuhangbin@gmail.com, hkallweit1@gmail.com, andy.ren@getcruise.com, razor@blackwall.org, idosch@nvidia.com, lucien.xin@gmail.com, nicolas.dichtel@6wind.com, phil@nwl.cc, claudiajkang@gmail.com, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, netdev@vger.kernel.org, intel-wired-lan@lists.osuosl.org, linux-rdma@vger.kernel.org, linux-arm-kernel@lists.infradead.org, poros@redhat.com, mschmidt@redhat.com, linux-clk@vger.kernel.org, vadim.fedorenko@linux.dev References: <20230609121853.3607724-1-arkadiusz.kubalewski@intel.com> <20230609121853.3607724-2-arkadiusz.kubalewski@intel.com> From: Bart Van Assche In-Reply-To: <20230609121853.3607724-2-arkadiusz.kubalewski@intel.com> Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit X-Spam-Status: No, score=-1.5 required=5.0 tests=BAYES_00, FREEMAIL_FORGED_FROMDOMAIN,FREEMAIL_FROM,HEADER_FROM_DIFFERENT_DOMAINS, NICE_REPLY_A,RCVD_IN_DNSWL_NONE,RCVD_IN_MSPIKE_H3,RCVD_IN_MSPIKE_WL, SPF_HELO_NONE,SPF_PASS,T_SCC_BODY_TEXT_LINE autolearn=no 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 On 6/9/23 05:18, Arkadiusz Kubalewski wrote: > diff --git a/Documentation/driver-api/dpll.rst b/Documentation/driver-api/dpll.rst > new file mode 100644 > index 000000000000..8caa4af022ad > --- /dev/null > +++ b/Documentation/driver-api/dpll.rst > @@ -0,0 +1,458 @@ > +.. SPDX-License-Identifier: GPL-2.0 > + > +=============================== > +The Linux kernel dpll subsystem > +=============================== > + > +The main purpose of dpll subsystem is to provide general interface > +to configure devices that use any kind of Digital PLL and could use > +different sources of signal to synchronize to as well as different > +types of outputs. > +The main interface is NETLINK_GENERIC based protocol with an event > +monitoring multicast group defined. A section that explains what "DPLL" stands for is missing. Please add such a section. Thanks, Bart.