Received: by 2002:ac8:3b51:0:b0:3f3:9eb6:4eb6 with SMTP id r17csp2762053qtf; Mon, 12 Jun 2023 09:36:20 -0700 (PDT) X-Google-Smtp-Source: ACHHUZ7yx/dZ8oJZPI+7IWlb4lL4DaS20L4Chov32kfswR9kySggFx+iMpaiw7KJqDX7Lb+yTNvD X-Received: by 2002:a17:902:7d8f:b0:1ad:bb89:16f6 with SMTP id a15-20020a1709027d8f00b001adbb8916f6mr6365089plm.50.1686587780538; Mon, 12 Jun 2023 09:36:20 -0700 (PDT) ARC-Seal: i=2; a=rsa-sha256; t=1686587780; cv=pass; d=google.com; s=arc-20160816; b=wENKspUDUnBuxEhawFjSno8j5aIzmu5ZRTQ3cYWmPvuC50DO+d1wVU9XeaFeGBhd+6 Z/H1UTRSoLBySsJnfu2jx5aDNrRo0Rs+9VJmaEVRkqFP51Of4vQG7CU2sv2f6FJ4f4It yyupGqUWhWiu7bMJQ/PgVxKsi/vG/5m9VBw1ug4xlVnPfkT5UUiie+qRNOc4Hu6q5dg0 GCKZVZT6/4ilfUalCl3J7nGWz6J5aDZ0Bu7YP7hSGUF7JHCwpHPxWULTq57UKC8bLR1E PgamjV2RwVD71VPUp8TVP8evP005PJdWFTuijSRG2jVnYrgpst9bZQsqatXnrOZRyCQ8 4BvA== ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:mime-version:content-transfer-encoding :content-language:accept-language:in-reply-to:references:message-id :date:thread-index:thread-topic:subject:cc:to:from:dkim-signature; bh=TsagdoZesBUnChVWvcz/oPObwBdL+vZtRN4aUOKunrw=; b=qcZZUWj+/GGGtyAN6gmYPZnxUUzLOyGUHoARHkpO8YOIyWsrWI3sYB7q2t74SB4BA+ A2KwT8Xf7+C5CkeRJkgaEJNkxqArWrpoCunkwWWRGbY41KApHmxU+8cjW6v42U62q/0E aYdFvTrmDgk6z8Z3n74LZXia2AC+N2rIwWDY3PZRqIV/T38WERwt7uYudp+aoMy5loLH cQ4xf0fYrvVTS+PW3xxGBFSejM5CCI9WjxsZGDKq6ao1wkkIyzCXQWb54SsYdfGVIuOC GZMSoEpTuRlAhA2NobMM7HLK3nesLWnveJcu2tl+v0Z7e62jb70SQQsEq9bpocxzb2kX 12uQ== ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@intel.com header.s=Intel header.b=MeXIoeh4; arc=pass (i=1 spf=pass spfdomain=intel.com dkim=pass dkdomain=intel.com dmarc=pass fromdomain=intel.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=pass (p=NONE sp=NONE dis=NONE) header.from=intel.com Return-Path: Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id f9-20020a170902ce8900b001b3a2156ef9si3854565plg.313.2023.06.12.09.35.58; Mon, 12 Jun 2023 09:36:20 -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=@intel.com header.s=Intel header.b=MeXIoeh4; arc=pass (i=1 spf=pass spfdomain=intel.com dkim=pass dkdomain=intel.com dmarc=pass fromdomain=intel.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=pass (p=NONE sp=NONE dis=NONE) header.from=intel.com Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S238575AbjFLPZs (ORCPT + 99 others); Mon, 12 Jun 2023 11:25:48 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:52856 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S237822AbjFLPZo (ORCPT ); Mon, 12 Jun 2023 11:25:44 -0400 Received: from mga05.intel.com (mga05.intel.com [192.55.52.43]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 545B1E57; Mon, 12 Jun 2023 08:25:43 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=intel.com; i=@intel.com; q=dns/txt; s=Intel; t=1686583543; x=1718119543; h=from:to:cc:subject:date:message-id:references: in-reply-to:content-transfer-encoding:mime-version; bh=hWXbLbIIQ4KQ/Sl01egkPbXBKDmWDYSpmE3Ri2BjJ8w=; b=MeXIoeh4NHvXi7CPbjGcb67/LyIGlYAEpVLLuij96jaTWXAD1qLY/KEa D50qHlml3xgsQB7uwwELc/Leqce+/cH7Y5Jpp2E3WJY3vzfTPAzBrE8CO 4VwaO8rPDOPEq6QG9XoMdXKA1sfj894VxoyeufRPs5z014sVzOaOfWDJ1 tAOcQskV0FyyLIhpyhzH6lCWDvkh1vqAH57IEV2DFVkETLqt0NEbfmsNX N1+irCzX6RcWk7Ufu3ugSI9VRggCl8MEcoy4oHzS2WWAOejN/nfCIbN2G 1iSmFSvqInvKFszLkMLJdQyrDtj3aS98gSe3Wq92dqJhYAp3AZdZIXZ0W Q==; X-IronPort-AV: E=McAfee;i="6600,9927,10739"; a="444452851" X-IronPort-AV: E=Sophos;i="6.00,236,1681196400"; d="scan'208";a="444452851" Received: from orsmga002.jf.intel.com ([10.7.209.21]) by fmsmga105.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 12 Jun 2023 08:25:05 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=McAfee;i="6600,9927,10739"; a="711252048" X-IronPort-AV: E=Sophos;i="6.00,236,1681196400"; d="scan'208";a="711252048" Received: from fmsmsx603.amr.corp.intel.com ([10.18.126.83]) by orsmga002.jf.intel.com with ESMTP; 12 Jun 2023 08:25:03 -0700 Received: from fmsmsx612.amr.corp.intel.com (10.18.126.92) by fmsmsx603.amr.corp.intel.com (10.18.126.83) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2507.23; Mon, 12 Jun 2023 08:25:02 -0700 Received: from fmsmsx602.amr.corp.intel.com (10.18.126.82) by fmsmsx612.amr.corp.intel.com (10.18.126.92) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2507.23; Mon, 12 Jun 2023 08:25:02 -0700 Received: from fmsedg602.ED.cps.intel.com (10.1.192.136) by fmsmsx602.amr.corp.intel.com (10.18.126.82) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2507.23 via Frontend Transport; Mon, 12 Jun 2023 08:25:02 -0700 Received: from NAM12-MW2-obe.outbound.protection.outlook.com (104.47.66.48) by edgegateway.intel.com (192.55.55.71) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.1.2507.23; Mon, 12 Jun 2023 08:25:01 -0700 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=mqBhElJzhpzXe45iq9x0PsHKCniZfJhDDcwZe7cpQk5nv9126dkT7wOuRiiXeVCFTbYqUbvIZK9Til8NETpoBdRdi86hr2BhoYjxkHYYKHpTim0rSGUlaVlXNU8Sq+hp/y97tyFtWpvp5Cq5zK/Zhnh5Yv/3ZZ2SSGplThRJ3tQa3ccBIH5Fz+oJ73Vy7VT7Is+MHbH+NlM7MX13jadv9vvPsJhWQoWABaQF5KDKl5R2hdEfibGhRqmarybLYh6r/Bk6JUfPenMl2axjtMsBY6+cz8E6yfQBzbsc6OGEHdItrOok+9M0eMEvsxtPh6+AiXaNU+LwiYCsGCGoh+ndkg== 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=TsagdoZesBUnChVWvcz/oPObwBdL+vZtRN4aUOKunrw=; b=oH5a9tXp3oCKaXg6O9cVyarev31bIrQrsP76KqWs5hS7VGI6jUWeXxKWA07HrYLsuzLQTK40lkQBF2jPP/oL67xQPFo1URJts2YyIMi7B8T1u1aGbhKXQwRD5pceiDk+n8+9p6r7Mf4oz/Ya7cMO7gJybTzmOZ/eGD/RVKczzewe0HEl/4URxeeni03UPltshEca6j/LhEfRgV+0np3w4+otZ97PnE4MS8TjWwbTEmpITp0d1DzylTTOhsEmFXBY5rwcv3Pqr8qJaxDm2+ETVzSNckc2k7w316HAloDi8/14RW1JzuZi2TV7J4r048fg86x69YwMvoh7mnVXqT5dOw== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=intel.com; dmarc=pass action=none header.from=intel.com; dkim=pass header.d=intel.com; arc=none Received: from DM6PR11MB4657.namprd11.prod.outlook.com (2603:10b6:5:2a6::7) by CY8PR11MB7875.namprd11.prod.outlook.com (2603:10b6:930:6c::7) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6455.33; Mon, 12 Jun 2023 15:24:57 +0000 Received: from DM6PR11MB4657.namprd11.prod.outlook.com ([fe80::24bd:974b:5c01:83d6]) by DM6PR11MB4657.namprd11.prod.outlook.com ([fe80::24bd:974b:5c01:83d6%3]) with mapi id 15.20.6455.045; Mon, 12 Jun 2023 15:24:57 +0000 From: "Kubalewski, Arkadiusz" To: Jiri Pirko CC: "kuba@kernel.org" , "vadfed@meta.com" , "jonathan.lemon@gmail.com" , "pabeni@redhat.com" , "corbet@lwn.net" , "davem@davemloft.net" , "edumazet@google.com" , "vadfed@fb.com" , "Brandeburg, Jesse" , "Nguyen, Anthony L" , "M, Saeed" , "leon@kernel.org" , "richardcochran@gmail.com" , "sj@kernel.org" , "javierm@redhat.com" , "ricardo.canuelo@collabora.com" , "mst@redhat.com" , "tzimmermann@suse.de" , "Michalik, Michal" , "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" , "Olech, Milena" , "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 , mschmidt , "linux-clk@vger.kernel.org" , "vadim.fedorenko@linux.dev" Subject: RE: [RFC PATCH v8 01/10] dpll: documentation on DPLL subsystem interface Thread-Topic: [RFC PATCH v8 01/10] dpll: documentation on DPLL subsystem interface Thread-Index: AQHZmszoYeH83BxaW02EVqODRhjpgq+EO6aAgAMCT4A= Date: Mon, 12 Jun 2023 15:24:57 +0000 Message-ID: References: <20230609121853.3607724-1-arkadiusz.kubalewski@intel.com> <20230609121853.3607724-2-arkadiusz.kubalewski@intel.com> In-Reply-To: Accept-Language: pl-PL, en-US Content-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: authentication-results: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=intel.com; x-ms-publictraffictype: Email x-ms-traffictypediagnostic: DM6PR11MB4657:EE_|CY8PR11MB7875:EE_ x-ms-office365-filtering-correlation-id: 1c734a61-e89f-42d3-e084-08db6b592e28 x-ld-processed: 46c98d88-e344-4ed4-8496-4ed7712e255d,ExtAddr x-ms-exchange-senderadcheck: 1 x-ms-exchange-antispam-relay: 0 x-microsoft-antispam: BCL:0; x-microsoft-antispam-message-info: 6iIiQPesd9ZVNaVMlhYI9rE5IoETlpcGp6T3+k2s8zqbhx9YKX+9dJ+o5sNXNVtknP98XBvF52jnb4CZY4vJlia08zUV1kfa1LueF6UsQKD3pdz4QlizEf62WThU1aCerdx+bWPBgYnf02RBxLTrcC5pqpDaElNHp8i0xYa5GEawEtHw0qBpqPRYvLjsuAabnSaMc0+jvfYJtAiOctQv8Zx7I09VZzIZg8m6pP8ZdyTalntr5+NHcgF5CQ5+RCJMWn4eygd/xtn4w+rpvSSbIVJUtNk58eWc+UxkFqXZZsTHlhEvxu1WOpjnQfrVL+Mbx+4rJE08gLFO5E9sVVCYnZvClTWAkdlw2WCotd3nX92IDjCqKUcuwfQ3CPJhNm70KzNqJXo1gKW6/teTD7BXUkgTo5Sfuw5CIzoVDxQVUr5L5mZRNYemrdpG3RDGrPbYmA9AtcPhsjctptaGIQFQpDokU/xemJN2qd8l9r0CxFzVH3k9bmBLlBa3vtlRCCPJd9qKC2+8Z7qUJtEChEAioNLZau3mKUSLSmAmjavMp2C2+icS4SIkyVrMPsVT2slwFiq+JhTxfQKhOrixtuq2QJxW9toRAosCqNPcRbR/URqro+I/6fIhjBrPWfaYF+Rd x-forefront-antispam-report: CIP:255.255.255.255;CTRY:;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:DM6PR11MB4657.namprd11.prod.outlook.com;PTR:;CAT:NONE;SFS:(13230028)(376002)(396003)(366004)(39860400002)(346002)(136003)(451199021)(38070700005)(4744005)(2906002)(86362001)(33656002)(7416002)(7406005)(52536014)(55016003)(7696005)(186003)(9686003)(6506007)(26005)(122000001)(82960400001)(71200400001)(54906003)(6916009)(76116006)(66946007)(66476007)(66446008)(64756008)(66556008)(4326008)(5660300002)(316002)(38100700002)(478600001)(8676002)(8936002)(41300700001);DIR:OUT;SFP:1102; x-ms-exchange-antispam-messagedata-chunkcount: 1 x-ms-exchange-antispam-messagedata-0: =?us-ascii?Q?sZebeKyA/ZjxEwcGRSZshdxvgsIh52ym7iedAJng+M1+f3FetQs3Hk9UpG6W?= =?us-ascii?Q?XHiAzuJlb+rc+ZVqeJVv046xONrWlcVukLUsKisNXE2Y8VZA+uKc7gW5eq7m?= =?us-ascii?Q?WAj7QTbke2Hk47o4F7OAVqfBZ1BhFFuRYaBfHHBJM0to9Km9VCn0DdEkihDu?= =?us-ascii?Q?5fWphElt20XyVIVD65yP/xKMnha9mDTyEf3RBe3dkDCEOH5enqH1a3XmD1CC?= =?us-ascii?Q?nlaPog3WfGpFeMYZLtmW+HqpUzQzrPZkYStpidUem98D02F5RYOgU356vWbH?= =?us-ascii?Q?SBYqFf0BIjSrhOJI3eaYn8qbbusef9fersETosyQtOI8vht/v6vR6xahDd2p?= =?us-ascii?Q?gIIil3YejVnY7W0qfsjJFFRpTFAijRrBo1bhWQB8gzjKw/XTN8IVwqJSr5TH?= =?us-ascii?Q?OV0spdKM5HQTvKGfvMNcc+7qisYhgL8NQjBKRJbdEJ84+HzxQ5srDWZiVtwh?= =?us-ascii?Q?rGuJb2elFniwnsfiBKDgExw9/dA2LHAB+gE5sH776F3uV/24W4sYqErWy3iR?= =?us-ascii?Q?/xtqi55QKu53UasxZ8jcTZpE2ieyWTyrk1HqkVXvf91hbc+7MK6aGgX1nfz4?= =?us-ascii?Q?WHIbtwdVkJx/POV68KdorTX8dM6jz3szobMuMp9vYhpfR9ohvFT1c1/3p+EL?= =?us-ascii?Q?tYiPGP4P0/39Om/p9SlXaGxxrX+EZhif5PoWbMoYKn6casMyr24KojxFoELR?= =?us-ascii?Q?mfQdNz0HJFf2+zEOitRqpTeIYFumlrb/WN3FCBULA4uyuhcfslFLBWQuoTpr?= =?us-ascii?Q?XfXNkOH/vBVZD9Oc35+sNjAec6ndPRxKxWCwIk5gTq3gO9dcQAPn8K4avxXJ?= =?us-ascii?Q?cOi/6wTlvC2Thf14AWpyyJdsTf9X4rqnGx8H2FSGUOS1Koifj2EBfCJOUKH6?= =?us-ascii?Q?y3JWp9TMkLZ4HzH1gxrbEh3QFZosrlJVDOHxtKUgfBWfyNzPlBJkDhTxY3Kg?= =?us-ascii?Q?adUu7JlwG+GVB9zXShS8vkgTtOkjs3+hHIwkFLGZR4ArobcT+2ncga5Nfl2M?= =?us-ascii?Q?mE4beMWf9mDQvWq079hGpU/Kalo8NX57KZWH3IwyGsxVCJuoZPMbhomvwSQi?= =?us-ascii?Q?6kHkHJtuYFQQKwbq+UnvDzapHpEalsAAeKwINZ3zAiuqNtVLI5UBQpWxs6Dq?= =?us-ascii?Q?gTN/nW0Nd5thiUqehnc2efQLAYOU9z4hHNzIza3I+crpIUZzn+Akw0l1v5BG?= =?us-ascii?Q?83jrEeSD8BEbxULDVW2G6TRePpuWVyIn/xNMPHYiNQBSDsjDCBdcjk86O+gD?= =?us-ascii?Q?psuAFob6Amn3Qb+wnwWdjoSKQD4xpPwcIS0nYJ+yC6mbbZe6Wri/VsNsR7rH?= =?us-ascii?Q?CT8xw9YfHNoqk0Iu9XJqGDGps+S3qsBlon0BiH9G5JREn/tcK/lWy3EV3oEJ?= =?us-ascii?Q?T4qBJG60XBCHePpM136VeQWICEaUXCatc83lX65QU8uDsGZ5Sa6MNzE14prb?= =?us-ascii?Q?MhguFTdi2atL7hhdNsW81f3YP0ENzjkZJsAdllaqo7Sd3eainCPWGLq4k6Sr?= =?us-ascii?Q?nADpJMXLywh4Iuk1RdszOTm4yfs18+I35VltIyqQqKaExsk0kiIv9Oor1ugg?= =?us-ascii?Q?aJ6cjtAK3rBuFcIwjZ9178t1/vh6uEt4/qZ01QXPBc1lEAlWupluap3dLq+X?= =?us-ascii?Q?Uw=3D=3D?= Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-AuthSource: DM6PR11MB4657.namprd11.prod.outlook.com X-MS-Exchange-CrossTenant-Network-Message-Id: 1c734a61-e89f-42d3-e084-08db6b592e28 X-MS-Exchange-CrossTenant-originalarrivaltime: 12 Jun 2023 15:24:57.3362 (UTC) X-MS-Exchange-CrossTenant-fromentityheader: Hosted X-MS-Exchange-CrossTenant-id: 46c98d88-e344-4ed4-8496-4ed7712e255d X-MS-Exchange-CrossTenant-mailboxtype: HOSTED X-MS-Exchange-CrossTenant-userprincipalname: DaA/Zo/NR/dfXPV/CCSd4rZFwDDVgchhXH2klvLuSsyc6YCkjBigEvqZvw64Q05BDp2ws5Lx2CMsxTpTHE7QW5rc5ztJUiVLI6C5cjrzC6E= X-MS-Exchange-Transport-CrossTenantHeadersStamped: CY8PR11MB7875 X-OriginatorOrg: intel.com X-Spam-Status: No, score=-4.4 required=5.0 tests=BAYES_00,DKIMWL_WL_HIGH, DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,RCVD_IN_DNSWL_MED, SPF_HELO_NONE,SPF_NONE,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 >From: Jiri Pirko >Sent: Saturday, June 10, 2023 6:29 PM > >Fri, Jun 09, 2023 at 02:18:44PM CEST, arkadiusz.kubalewski@intel.com wrote= : >>From: Vadim Fedorenko >> >>Add documentation explaining common netlink interface to configure DPLL >>devices and monitoring events. Common way to implement DPLL device in >>a driver is also covered. >> >>Signed-off-by: Vadim Fedorenko >>Signed-off-by: Arkadiusz Kubalewski >>--- >> Documentation/driver-api/dpll.rst | 458 +++++++++++++++++++++++++++++ >> Documentation/driver-api/index.rst | 1 + >> 2 files changed, 459 insertions(+) >> create mode 100644 Documentation/driver-api/dpll.rst > >Looks fine to me. I just wonder if the info redundancy of this file and >the netlink yaml could be somehow reduce. IDK. Good question, will try to incorporate the dpll uapi header docs here, instead of having redundant descriptions. Thank you! Arkadiusz