From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-16.8 required=3.0 tests=BAYES_00, HEADER_FROM_DIFFERENT_DOMAINS,INCLUDES_CR_TRAILER,INCLUDES_PATCH, MAILING_LIST_MULTI,SPF_HELO_NONE,SPF_PASS,URIBL_BLOCKED,USER_AGENT_GIT autolearn=ham autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 6E0BCC07E95 for ; Fri, 2 Jul 2021 20:40:27 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by mail.kernel.org (Postfix) with ESMTP id 56DD261410 for ; Fri, 2 Jul 2021 20:40:27 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S231186AbhGBUm7 (ORCPT ); Fri, 2 Jul 2021 16:42:59 -0400 Received: from mail-lj1-f182.google.com ([209.85.208.182]:39889 "EHLO mail-lj1-f182.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S231179AbhGBUm6 (ORCPT ); Fri, 2 Jul 2021 16:42:58 -0400 Received: by mail-lj1-f182.google.com with SMTP id e3so6522127ljo.6 for ; Fri, 02 Jul 2021 13:40:25 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:mime-version :content-transfer-encoding; bh=8XmZGkFlIjDwabyMzBOy9CvoDQY094ZNfNgHxGJydqU=; b=jQq3TspO6gY5XaFMq7XSOAaxtBNaWbO7SA+U+vUP8S6AXdl+YlN79p9Se6eekd9wZz 2i8ORiQYKn1pE4l2hTIu7cpJYWbAuEAQ4X7MJcMxFzRP8UkojZxOCwCZhz5AsuXbRtnF WOnW4ZHvJ9P6MYZAqRVy2I3XIYROtKuSqe0sTrm7spaKvzB/dd9WtJTnn+KEZ+eRSHxb n+h/VxLstMWNav4EwUakBzw93/K0oHQVpfq9b7FUmyFUDbmPYxqgI2jetVg2cKm09e2U 234hHyCnSY3q1UpZFXH9x8IHwrHqwCC1m4w470OFfSDr/lu/EmbH/V43NrbQb8JCsYHs NAwQ== X-Gm-Message-State: AOAM533VaIiZyu1jpGvHCci0d2/EgwFvlY525btZp8taWyHK98QXyziV gfPHu/2BwALjyDkpaTjiZlg= X-Google-Smtp-Source: ABdhPJypg+iexLBW3WPDv001kjr9yidLe0RVPFcjpaX8B5vb4zz6NS5iC3Vq8H8BvBWbKE1Gii99dQ== X-Received: by 2002:a2e:3e07:: with SMTP id l7mr970502lja.131.1625258424304; Fri, 02 Jul 2021 13:40:24 -0700 (PDT) Received: from workstation.lan ([95.155.85.46]) by smtp.gmail.com with ESMTPSA id o142sm364201lfa.299.2021.07.02.13.40.23 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 02 Jul 2021 13:40:23 -0700 (PDT) From: =?UTF-8?q?Krzysztof=20Wilczy=C5=84ski?= To: Ray Jui Cc: Bjorn Helgaas , Lorenzo Pieralisi , Rob Herring , Scott Branden , bcm-kernel-feedback-list@broadcom.com, linux-pci@vger.kernel.org, linux-arm-kernel@lists.infradead.org Subject: [PATCH v3] PCI: iproc: Fix a non-compliant kernel-doc Date: Fri, 2 Jul 2021 20:40:22 +0000 Message-Id: <20210702204022.1654290-1-kw@linux.com> X-Mailer: git-send-email 2.32.0 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Precedence: bulk List-ID: X-Mailing-List: linux-pci@vger.kernel.org Fix a non-compliant kernel-doc used to describe struct and enum types and functions in the pcie-iproc.c, pcie-iproc-msi.c and pcie-iproc.h files. Add missing documentation of the "mem" filed of the struct iproc_pcie, and the enum values "IPROC_PCIE_IB_MAP_MEM", "IPROC_PCIE_IB_MAP_IO" and "IPROC_PCIE_IB_MAP_INVALID" of the enum iproc_pcie_ib_map_type. Thus, resolve the following build time warning related to kernel-doc: drivers/pci/controller/pcie-iproc.c:92: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst drivers/pci/controller/pcie-iproc.c:139: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst drivers/pci/controller/pcie-iproc.c:153: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst drivers/pci/controller/pcie-iproc.c:441: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst drivers/pci/controller/pcie-iproc.c:623: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst drivers/pci/controller/pcie-iproc.c:901: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst drivers/pci/controller/pcie-iproc.c:151: warning: Enum value 'IPROC_PCIE_IB_MAP_MEM' not described in enum 'iproc_pcie_ib_map_type' drivers/pci/controller/pcie-iproc.c:151: warning: Enum value 'IPROC_PCIE_IB_MAP_IO' not described in enum 'iproc_pcie_ib_map_type' drivers/pci/controller/pcie-iproc.c:151: warning: Enum value 'IPROC_PCIE_IB_MAP_INVALID' not described in enum 'iproc_pcie_ib_map_type' drivers/pci/controller/pcie-iproc-msi.c:52: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst drivers/pci/controller/pcie-iproc-msi.c:68: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst drivers/pci/controller/pcie-iproc.h:11: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst drivers/pci/controller/pcie-iproc.h:28: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst drivers/pci/controller/pcie-iproc.h:39: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst drivers/pci/controller/pcie-iproc.h:51: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst drivers/pci/controller/pcie-iproc.h:112: warning: Function parameter or member 'mem' not described in 'iproc_pcie' No change to functionality intended. Signed-off-by: Krzysztof Wilczyński --- drivers/pci/controller/pcie-iproc-msi.c | 54 +++++++-------- drivers/pci/controller/pcie-iproc.c | 49 +++++++------- drivers/pci/controller/pcie-iproc.h | 88 +++++++++++++++---------- 3 files changed, 103 insertions(+), 88 deletions(-) diff --git a/drivers/pci/controller/pcie-iproc-msi.c b/drivers/pci/controller/pcie-iproc-msi.c index eede4e8f3f75..d20e66319774 100644 --- a/drivers/pci/controller/pcie-iproc-msi.c +++ b/drivers/pci/controller/pcie-iproc-msi.c @@ -49,14 +49,14 @@ enum iproc_msi_reg { struct iproc_msi; /** - * iProc MSI group + * struct iproc_msi_grp - iProc MSI group. * - * One MSI group is allocated per GIC interrupt, serviced by one iProc MSI - * event queue. + * @msi: Pointer to iProc MSI data. + * @gic_irq: GIC interrupt. + * @eq: Event queue number. * - * @msi: pointer to iProc MSI data - * @gic_irq: GIC interrupt - * @eq: Event queue number + * One MSI group is allocated per GIC interrupt, serviced by one iProc MSI event + * queue. */ struct iproc_msi_grp { struct iproc_msi *msi; @@ -65,30 +65,30 @@ struct iproc_msi_grp { }; /** - * iProc event queue based MSI + * struct iproc_msi - iProc event queue based MSI. + * + * @pcie: Pointer to iProc PCIe data. + * @reg_offsets: MSI register offsets. + * @grps: MSI groups. + * @nr_irqs: Number of total interrupts connected to GIC. + * @nr_cpus: Number of toal CPUs. + * @has_inten_reg: Indicates the MSI interrupt enable register needs to be + * set explicitly (required for some legacy platforms). + * @bitmap: MSI vector bitmap. + * @bitmap_lock: Lock to protect access to the MSI bitmap. + * @nr_msi_vecs: Total number of MSI vectors. + * @inner_domain: Inner IRQ domain. + * @msi_domain: MSI IRQ domain. + * @nr_eq_region: Required number of 4K aligned memory region for MSI + * event queues. + * @nr_msi_region: Required number of 4K aligned address region for MSI + * posted writes. + * @eq_cpu: Pointer to allocated memory region for MSI event queues. + * @eq_dma: DMA address of MSI event queues. + * @msi_addr: MSI address. * * Only meant to be used on platforms without MSI support integrated into the * GIC. - * - * @pcie: pointer to iProc PCIe data - * @reg_offsets: MSI register offsets - * @grps: MSI groups - * @nr_irqs: number of total interrupts connected to GIC - * @nr_cpus: number of toal CPUs - * @has_inten_reg: indicates the MSI interrupt enable register needs to be - * set explicitly (required for some legacy platforms) - * @bitmap: MSI vector bitmap - * @bitmap_lock: lock to protect access to the MSI bitmap - * @nr_msi_vecs: total number of MSI vectors - * @inner_domain: inner IRQ domain - * @msi_domain: MSI IRQ domain - * @nr_eq_region: required number of 4K aligned memory region for MSI event - * queues - * @nr_msi_region: required number of 4K aligned address region for MSI posted - * writes - * @eq_cpu: pointer to allocated memory region for MSI event queues - * @eq_dma: DMA address of MSI event queues - * @msi_addr: MSI address */ struct iproc_msi { struct iproc_pcie *pcie; diff --git a/drivers/pci/controller/pcie-iproc.c b/drivers/pci/controller/pcie-iproc.c index 02e52f698eeb..2a400bf81f58 100644 --- a/drivers/pci/controller/pcie-iproc.c +++ b/drivers/pci/controller/pcie-iproc.c @@ -89,10 +89,10 @@ #define IPROC_PCIE_REG_INVALID 0xffff /** - * iProc PCIe outbound mapping controller specific parameters - * - * @window_sizes: list of supported outbound mapping window sizes in MB - * @nr_sizes: number of supported outbound mapping window sizes + * struct iproc_pcie_ob_map - iProc PCIe outbound mapping controller specific + * parameters. + * @window_sizes: List of supported outbound mapping window sizes in MB. + * @nr_sizes: Number of supported outbound mapping window sizes. */ struct iproc_pcie_ob_map { resource_size_t window_sizes[MAX_NUM_OB_WINDOW_SIZES]; @@ -136,32 +136,31 @@ static const struct iproc_pcie_ob_map paxb_v2_ob_map[] = { }; /** - * iProc PCIe inbound mapping type + * enum iproc_pcie_ib_map_type - iProc PCIe inbound mapping type. + * @IPROC_PCIE_IB_MAP_MEM: DDR memory. + * @IPROC_PCIE_IB_MAP_IO: Device I/O memory. + * @IPROC_PCIE_IB_MAP_INVALID: Invalid or unused. */ enum iproc_pcie_ib_map_type { - /* for DDR memory */ IPROC_PCIE_IB_MAP_MEM = 0, - - /* for device I/O memory */ IPROC_PCIE_IB_MAP_IO, - - /* invalid or unused */ IPROC_PCIE_IB_MAP_INVALID }; /** - * iProc PCIe inbound mapping controller specific parameters - * - * @type: inbound mapping region type - * @size_unit: inbound mapping region size unit, could be SZ_1K, SZ_1M, or - * SZ_1G - * @region_sizes: list of supported inbound mapping region sizes in KB, MB, or - * GB, depending on the size unit - * @nr_sizes: number of supported inbound mapping region sizes - * @nr_windows: number of supported inbound mapping windows for the region - * @imap_addr_offset: register offset between the upper and lower 32-bit - * IMAP address registers - * @imap_window_offset: register offset between each IMAP window + * struct iproc_pcie_ib_map - iProc PCIe inbound mapping controller specific + * parameters. + * @type: Inbound mapping region type + * @size_unit: Inbound mapping region size unit, could be SZ_1K, SZ_1M, + * or SZ_1G. + * @region_sizes: List of supported inbound mapping region sizes in KB, + * MB, or GB, depending on the size unit. + * @nr_sizes: Number of supported inbound mapping region sizes. + * @nr_windows: Number of supported inbound mapping windows for the + * region. + * @imap_addr_offset: Register offset between the upper and lower 32-bit IMAP + * address registers. + * @imap_window_offset: Register offset between each IMAP window. */ struct iproc_pcie_ib_map { enum iproc_pcie_ib_map_type type; @@ -437,7 +436,7 @@ static inline void iproc_pcie_write_reg(struct iproc_pcie *pcie, writel(val, pcie->base + offset); } -/** +/* * APB error forwarding can be disabled during access of configuration * registers of the endpoint device, to prevent unsupported requests * (typically seen during enumeration with multi-function devices) from @@ -619,7 +618,7 @@ static int iproc_pcie_config_read(struct pci_bus *bus, unsigned int devfn, return PCIBIOS_SUCCESSFUL; } -/** +/* * Note access to the configuration registers are protected at the higher layer * by 'pci_lock' in drivers/pci/access.c */ @@ -897,7 +896,7 @@ static inline int iproc_pcie_ob_write(struct iproc_pcie *pcie, int window_idx, return 0; } -/** +/* * Some iProc SoCs require the SW to configure the outbound address mapping * * Outbound address translation: diff --git a/drivers/pci/controller/pcie-iproc.h b/drivers/pci/controller/pcie-iproc.h index c2676e442f55..432ce216f1fb 100644 --- a/drivers/pci/controller/pcie-iproc.h +++ b/drivers/pci/controller/pcie-iproc.h @@ -7,7 +7,16 @@ #define _PCIE_IPROC_H /** - * iProc PCIe interface type + * enum iproc_pcie_type - iProc PCIe interface type. + * @IPROC_PCIE_PAXB_BCMA: New generation of iProc BCMA-based host + * controllers. + * @IPROC_PCIE_PAXB: iProc PAXB-based host controllers for SoCs such + * as NS, NSP, Cygnus, NS2 and Pegasus. + * @IPROC_PCIE_PAXB_V2: Next generation of iProc PAXB-based host + * controllers using the Stingray SoCs. + * @IPROC_PCIE_PAXC: iProx PAXC-based host controllers. + * @IPROC_PCIE_PAXC_V2: Second generation of the iProc PAXC-based host + * controllers. * * PAXB is the wrapper used in root complex that can be connected to an * external endpoint device. @@ -24,10 +33,10 @@ enum iproc_pcie_type { }; /** - * iProc PCIe outbound mapping - * @axi_offset: offset from the AXI address to the internal address used by - * the iProc PCIe core - * @nr_windows: total number of supported outbound mapping windows + * struct iproc_pcie_ob - iProc PCIe outbound mapping. + * @axi_offset: Offset from the AXI address to the internal address used by the + * iProc PCIe core. + * @nr_windows: Total number of supported outbound mapping windows. */ struct iproc_pcie_ob { resource_size_t axi_offset; @@ -35,8 +44,8 @@ struct iproc_pcie_ob { }; /** - * iProc PCIe inbound mapping - * @nr_regions: total number of supported inbound mapping regions + * struct iproc_pcie_ib - iProc PCIe inbound mapping. + * @nr_regions: Total number of supported inbound mapping regions. */ struct iproc_pcie_ib { unsigned int nr_regions; @@ -47,35 +56,42 @@ struct iproc_pcie_ib_map; struct iproc_msi; /** - * iProc PCIe device - * - * @dev: pointer to device data structure - * @type: iProc PCIe interface type - * @reg_offsets: register offsets - * @base: PCIe host controller I/O register base - * @base_addr: PCIe host controller register base physical address - * @phy: optional PHY device that controls the Serdes - * @map_irq: function callback to map interrupts - * @ep_is_internal: indicates an internal emulated endpoint device is connected - * @iproc_cfg_read: indicates the iProc config read function should be used - * @rej_unconfig_pf: indicates the root complex needs to detect and reject - * enumeration against unconfigured physical functions emulated in the ASIC - * @has_apb_err_disable: indicates the controller can be configured to prevent - * unsupported request from being forwarded as an APB bus error - * @fix_paxc_cap: indicates the controller has corrupted capability list in its - * config space registers and requires SW based fixup - * - * @need_ob_cfg: indicates SW needs to configure the outbound mapping window - * @ob: outbound mapping related parameters - * @ob_map: outbound mapping related parameters specific to the controller - * - * @need_ib_cfg: indicates SW needs to configure the inbound mapping window - * @ib: inbound mapping related parameters - * @ib_map: outbound mapping region related parameters - * - * @need_msi_steer: indicates additional configuration of the iProc PCIe - * controller is required to steer MSI writes to external interrupt controller - * @msi: MSI data + * struct iproc_pcie - iProc PCIe device. + * @dev: Pointer to device data structure. + * @type: iProc PCIe interface type. + * @reg_offsets: Register offsets. + * @base: PCIe host controller I/O register base. + * @base_addr: PCIe host controller register base physical + * address. + * @mem: Host bridge memory window resource. + * @phy: Optional PHY device that controls the Serdes. + * @map_irq: Function callback to map interrupts. + * @ep_is_internal: Indicates an internal emulated endpoint device + * is connected. + * @iproc_cfg_read: Indicates the iProc config read function should + * be used. + * @rej_unconfig_pf: Indicates the root complex needs to detect and + * reject enumeration against unconfigured physical + * functions emulated in the ASIC. + * @has_apb_err_disable: Indicates the controller can be configured to + * prevent unsupported request from being forwarded + * as an APB bus error. + * @fix_paxc_cap: Indicates the controller has corrupted + * capability list in its config space registers + * and requires SW based fixup. + * @need_ob_cfg: Indicates SW needs to configure the outbound + * mapping window. + * @ob: Outbound mapping related parameters. + * @ob_map: Outbound mapping related parameters specific to + * the controller. + * @need_ib_cfg: indicates SW needs to configure the inbound + * mapping window. + * @ib: Inbound mapping related parameters. + * @ib_map: Outbound mapping region related parameters. + * @need_msi_steer: Indicates additional configuration of the iProc + * PCIe controller is required to steer MSI writes + * to external interrupt controller. + * @msi: MSI data. */ struct iproc_pcie { struct device *dev; -- 2.32.0 From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-17.1 required=3.0 tests=BAYES_00,DKIMWL_WL_HIGH, DKIM_SIGNED,DKIM_VALID,HEADER_FROM_DIFFERENT_DOMAINS,INCLUDES_CR_TRAILER, INCLUDES_PATCH,MAILING_LIST_MULTI,SPF_HELO_NONE,SPF_PASS,URIBL_BLOCKED, USER_AGENT_GIT autolearn=ham autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id A14C9C07E95 for ; Fri, 2 Jul 2021 20:42:22 +0000 (UTC) Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPS id 5FFD6613E0 for ; Fri, 2 Jul 2021 20:42:22 +0000 (UTC) DMARC-Filter: OpenDMARC Filter v1.3.2 mail.kernel.org 5FFD6613E0 Authentication-Results: mail.kernel.org; dmarc=none (p=none dis=none) header.from=linux.com Authentication-Results: mail.kernel.org; spf=none smtp.mailfrom=linux-arm-kernel-bounces+linux-arm-kernel=archiver.kernel.org@lists.infradead.org DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=bombadil.20210309; h=Sender: Content-Transfer-Encoding:Content-Type:List-Subscribe:List-Help:List-Post: List-Archive:List-Unsubscribe:List-Id:MIME-Version:Message-Id:Date:Subject:Cc :To:From:Reply-To:Content-ID:Content-Description:Resent-Date:Resent-From: Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID:In-Reply-To:References: List-Owner; bh=QAz7Of7Zd4e9LDoZpLyR5M1gbnkw5+juL5SiglLGmKM=; b=qDhPsFV8PGmoIZ YDP68sGy/cscQ34SMwz1HW4IxJeYPc7KlU+TXr/FB+yscvZONK+WNxJPywQA0L2MOUHXctxcQzhQg Y7m24W9A49Sx9NttaP+mmIjLmUtjjp17yJdb/jxPHJMKwx7eyM51Xzg9i7VaWOmJ2OCsUkifrlUzm PPYRnD9WuREgOjvLlk9P7EYwWZRt/7id5fOL4SRNavm1H+vQKqtXmMG9/nBn7gof5R7OJ7JrEi80Y OIgBc6QPD1sEQsShCcnuk5He6+BVEgG8bAFNvC+3Fla1BEvg1Uae5ZcY8jC9acMPEzITjlq5DNYDn F25vnxSHUB/NnQ0tqDWA==; Received: from localhost ([::1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.94.2 #2 (Red Hat Linux)) id 1lzPxg-0041P0-4p; Fri, 02 Jul 2021 20:40:32 +0000 Received: from mail-lj1-f171.google.com ([209.85.208.171]) by bombadil.infradead.org with esmtps (Exim 4.94.2 #2 (Red Hat Linux)) id 1lzPxb-0041OV-8Q for linux-arm-kernel@lists.infradead.org; Fri, 02 Jul 2021 20:40:29 +0000 Received: by mail-lj1-f171.google.com with SMTP id r16so14962423ljk.9 for ; Fri, 02 Jul 2021 13:40:25 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:mime-version :content-transfer-encoding; bh=8XmZGkFlIjDwabyMzBOy9CvoDQY094ZNfNgHxGJydqU=; b=QfGSQ9Z6yVxW3rIBB9Jm+7RQ73uTYj5IuKtySod69vyyHnTZv7X1WhvLqlH+n52Cng J+RK8pPz8IlxttcNP88V+WOJRVwoqKX17zRmCQwE/kWwivHJYNEp7GFzpGydwXD/4oDy 3+3vsQbs6BIAEviYFyHQFpvDueDsoN6oIzWLNrPwET+tj1cB8L+BDitU37eI81Kvzjcc Co2uHXQBusR1PoP/MwMPuG5YMAsxZN4/Geqqpgp86kcu4yZGtPM/siybFOK7e1OWOUKl u82LccDUCXN4fr/Y74NwYyj0A3KXCwcY+6kCiWab8ITOT4KG+Y6cxLrE24hXtZN/59HR GVEg== X-Gm-Message-State: AOAM533aDo37s0NJ9plc03qEen0RylLGYfKT1MmOGl8vJQ5o3RfElxa9 F1+TgoRtaWOC8MHyULgd7p3OYyxfcZH1/g== X-Google-Smtp-Source: ABdhPJypg+iexLBW3WPDv001kjr9yidLe0RVPFcjpaX8B5vb4zz6NS5iC3Vq8H8BvBWbKE1Gii99dQ== X-Received: by 2002:a2e:3e07:: with SMTP id l7mr970502lja.131.1625258424304; Fri, 02 Jul 2021 13:40:24 -0700 (PDT) Received: from workstation.lan ([95.155.85.46]) by smtp.gmail.com with ESMTPSA id o142sm364201lfa.299.2021.07.02.13.40.23 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 02 Jul 2021 13:40:23 -0700 (PDT) From: =?UTF-8?q?Krzysztof=20Wilczy=C5=84ski?= To: Ray Jui Cc: Bjorn Helgaas , Lorenzo Pieralisi , Rob Herring , Scott Branden , bcm-kernel-feedback-list@broadcom.com, linux-pci@vger.kernel.org, linux-arm-kernel@lists.infradead.org Subject: [PATCH v3] PCI: iproc: Fix a non-compliant kernel-doc Date: Fri, 2 Jul 2021 20:40:22 +0000 Message-Id: <20210702204022.1654290-1-kw@linux.com> X-Mailer: git-send-email 2.32.0 MIME-Version: 1.0 X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20210702_134027_359745_7BE4E9E6 X-CRM114-Status: GOOD ( 25.06 ) X-BeenThere: linux-arm-kernel@lists.infradead.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: base64 Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+linux-arm-kernel=archiver.kernel.org@lists.infradead.org Rml4IGEgbm9uLWNvbXBsaWFudCBrZXJuZWwtZG9jIHVzZWQgdG8gZGVzY3JpYmUgc3RydWN0IGFu ZCBlbnVtIHR5cGVzCmFuZCBmdW5jdGlvbnMgaW4gdGhlIHBjaWUtaXByb2MuYywgcGNpZS1pcHJv Yy1tc2kuYyBhbmQgcGNpZS1pcHJvYy5oCmZpbGVzLgoKQWRkIG1pc3NpbmcgZG9jdW1lbnRhdGlv biBvZiB0aGUgIm1lbSIgZmlsZWQgb2YgdGhlIHN0cnVjdCBpcHJvY19wY2llLAphbmQgdGhlIGVu dW0gdmFsdWVzICJJUFJPQ19QQ0lFX0lCX01BUF9NRU0iLCAiSVBST0NfUENJRV9JQl9NQVBfSU8i IGFuZAoiSVBST0NfUENJRV9JQl9NQVBfSU5WQUxJRCIgb2YgdGhlIGVudW0gaXByb2NfcGNpZV9p Yl9tYXBfdHlwZS4KClRodXMsIHJlc29sdmUgdGhlIGZvbGxvd2luZyBidWlsZCB0aW1lIHdhcm5p bmcgcmVsYXRlZCB0byBrZXJuZWwtZG9jOgoKICBkcml2ZXJzL3BjaS9jb250cm9sbGVyL3BjaWUt aXByb2MuYzo5Mjogd2FybmluZzogVGhpcyBjb21tZW50IHN0YXJ0cyB3aXRoICcvKionLCBidXQg aXNuJ3QgYSBrZXJuZWwtZG9jIGNvbW1lbnQuIFJlZmVyIERvY3VtZW50YXRpb24vZG9jLWd1aWRl L2tlcm5lbC1kb2MucnN0CiAgZHJpdmVycy9wY2kvY29udHJvbGxlci9wY2llLWlwcm9jLmM6MTM5 OiB3YXJuaW5nOiBUaGlzIGNvbW1lbnQgc3RhcnRzIHdpdGggJy8qKicsIGJ1dCBpc24ndCBhIGtl cm5lbC1kb2MgY29tbWVudC4gUmVmZXIgRG9jdW1lbnRhdGlvbi9kb2MtZ3VpZGUva2VybmVsLWRv Yy5yc3QKICBkcml2ZXJzL3BjaS9jb250cm9sbGVyL3BjaWUtaXByb2MuYzoxNTM6IHdhcm5pbmc6 IFRoaXMgY29tbWVudCBzdGFydHMgd2l0aCAnLyoqJywgYnV0IGlzbid0IGEga2VybmVsLWRvYyBj b21tZW50LiBSZWZlciBEb2N1bWVudGF0aW9uL2RvYy1ndWlkZS9rZXJuZWwtZG9jLnJzdAogIGRy aXZlcnMvcGNpL2NvbnRyb2xsZXIvcGNpZS1pcHJvYy5jOjQ0MTogd2FybmluZzogVGhpcyBjb21t ZW50IHN0YXJ0cyB3aXRoICcvKionLCBidXQgaXNuJ3QgYSBrZXJuZWwtZG9jIGNvbW1lbnQuIFJl ZmVyIERvY3VtZW50YXRpb24vZG9jLWd1aWRlL2tlcm5lbC1kb2MucnN0CiAgZHJpdmVycy9wY2kv Y29udHJvbGxlci9wY2llLWlwcm9jLmM6NjIzOiB3YXJuaW5nOiBUaGlzIGNvbW1lbnQgc3RhcnRz IHdpdGggJy8qKicsIGJ1dCBpc24ndCBhIGtlcm5lbC1kb2MgY29tbWVudC4gUmVmZXIgRG9jdW1l bnRhdGlvbi9kb2MtZ3VpZGUva2VybmVsLWRvYy5yc3QKICBkcml2ZXJzL3BjaS9jb250cm9sbGVy L3BjaWUtaXByb2MuYzo5MDE6IHdhcm5pbmc6IFRoaXMgY29tbWVudCBzdGFydHMgd2l0aCAnLyoq JywgYnV0IGlzbid0IGEga2VybmVsLWRvYyBjb21tZW50LiBSZWZlciBEb2N1bWVudGF0aW9uL2Rv Yy1ndWlkZS9rZXJuZWwtZG9jLnJzdAogIGRyaXZlcnMvcGNpL2NvbnRyb2xsZXIvcGNpZS1pcHJv Yy5jOjE1MTogd2FybmluZzogRW51bSB2YWx1ZSAnSVBST0NfUENJRV9JQl9NQVBfTUVNJyBub3Qg ZGVzY3JpYmVkIGluIGVudW0gJ2lwcm9jX3BjaWVfaWJfbWFwX3R5cGUnCiAgZHJpdmVycy9wY2kv Y29udHJvbGxlci9wY2llLWlwcm9jLmM6MTUxOiB3YXJuaW5nOiBFbnVtIHZhbHVlICdJUFJPQ19Q Q0lFX0lCX01BUF9JTycgbm90IGRlc2NyaWJlZCBpbiBlbnVtICdpcHJvY19wY2llX2liX21hcF90 eXBlJwogIGRyaXZlcnMvcGNpL2NvbnRyb2xsZXIvcGNpZS1pcHJvYy5jOjE1MTogd2FybmluZzog RW51bSB2YWx1ZSAnSVBST0NfUENJRV9JQl9NQVBfSU5WQUxJRCcgbm90IGRlc2NyaWJlZCBpbiBl bnVtICdpcHJvY19wY2llX2liX21hcF90eXBlJwoKICBkcml2ZXJzL3BjaS9jb250cm9sbGVyL3Bj aWUtaXByb2MtbXNpLmM6NTI6IHdhcm5pbmc6IFRoaXMgY29tbWVudCBzdGFydHMgd2l0aCAnLyoq JywgYnV0IGlzbid0IGEga2VybmVsLWRvYyBjb21tZW50LiBSZWZlciBEb2N1bWVudGF0aW9uL2Rv Yy1ndWlkZS9rZXJuZWwtZG9jLnJzdAogIGRyaXZlcnMvcGNpL2NvbnRyb2xsZXIvcGNpZS1pcHJv Yy1tc2kuYzo2ODogd2FybmluZzogVGhpcyBjb21tZW50IHN0YXJ0cyB3aXRoICcvKionLCBidXQg aXNuJ3QgYSBrZXJuZWwtZG9jIGNvbW1lbnQuIFJlZmVyIERvY3VtZW50YXRpb24vZG9jLWd1aWRl L2tlcm5lbC1kb2MucnN0CgogIGRyaXZlcnMvcGNpL2NvbnRyb2xsZXIvcGNpZS1pcHJvYy5oOjEx OiB3YXJuaW5nOiBUaGlzIGNvbW1lbnQgc3RhcnRzIHdpdGggJy8qKicsIGJ1dCBpc24ndCBhIGtl cm5lbC1kb2MgY29tbWVudC4gUmVmZXIgRG9jdW1lbnRhdGlvbi9kb2MtZ3VpZGUva2VybmVsLWRv Yy5yc3QKICBkcml2ZXJzL3BjaS9jb250cm9sbGVyL3BjaWUtaXByb2MuaDoyODogd2FybmluZzog VGhpcyBjb21tZW50IHN0YXJ0cyB3aXRoICcvKionLCBidXQgaXNuJ3QgYSBrZXJuZWwtZG9jIGNv bW1lbnQuIFJlZmVyIERvY3VtZW50YXRpb24vZG9jLWd1aWRlL2tlcm5lbC1kb2MucnN0CiAgZHJp dmVycy9wY2kvY29udHJvbGxlci9wY2llLWlwcm9jLmg6Mzk6IHdhcm5pbmc6IFRoaXMgY29tbWVu dCBzdGFydHMgd2l0aCAnLyoqJywgYnV0IGlzbid0IGEga2VybmVsLWRvYyBjb21tZW50LiBSZWZl ciBEb2N1bWVudGF0aW9uL2RvYy1ndWlkZS9rZXJuZWwtZG9jLnJzdAogIGRyaXZlcnMvcGNpL2Nv bnRyb2xsZXIvcGNpZS1pcHJvYy5oOjUxOiB3YXJuaW5nOiBUaGlzIGNvbW1lbnQgc3RhcnRzIHdp dGggJy8qKicsIGJ1dCBpc24ndCBhIGtlcm5lbC1kb2MgY29tbWVudC4gUmVmZXIgRG9jdW1lbnRh dGlvbi9kb2MtZ3VpZGUva2VybmVsLWRvYy5yc3QKICBkcml2ZXJzL3BjaS9jb250cm9sbGVyL3Bj aWUtaXByb2MuaDoxMTI6IHdhcm5pbmc6IEZ1bmN0aW9uIHBhcmFtZXRlciBvciBtZW1iZXIgJ21l bScgbm90IGRlc2NyaWJlZCBpbiAnaXByb2NfcGNpZScKCk5vIGNoYW5nZSB0byBmdW5jdGlvbmFs aXR5IGludGVuZGVkLgoKU2lnbmVkLW9mZi1ieTogS3J6eXN6dG9mIFdpbGN6ecWEc2tpIDxrd0Bs aW51eC5jb20+Ci0tLQogZHJpdmVycy9wY2kvY29udHJvbGxlci9wY2llLWlwcm9jLW1zaS5jIHwg NTQgKysrKysrKy0tLS0tLS0tCiBkcml2ZXJzL3BjaS9jb250cm9sbGVyL3BjaWUtaXByb2MuYyAg ICAgfCA0OSArKysrKysrLS0tLS0tLQogZHJpdmVycy9wY2kvY29udHJvbGxlci9wY2llLWlwcm9j LmggICAgIHwgODggKysrKysrKysrKysrKysrLS0tLS0tLS0tLQogMyBmaWxlcyBjaGFuZ2VkLCAx MDMgaW5zZXJ0aW9ucygrKSwgODggZGVsZXRpb25zKC0pCgpkaWZmIC0tZ2l0IGEvZHJpdmVycy9w Y2kvY29udHJvbGxlci9wY2llLWlwcm9jLW1zaS5jIGIvZHJpdmVycy9wY2kvY29udHJvbGxlci9w Y2llLWlwcm9jLW1zaS5jCmluZGV4IGVlZGU0ZThmM2Y3NS4uZDIwZTY2MzE5Nzc0IDEwMDY0NAot LS0gYS9kcml2ZXJzL3BjaS9jb250cm9sbGVyL3BjaWUtaXByb2MtbXNpLmMKKysrIGIvZHJpdmVy cy9wY2kvY29udHJvbGxlci9wY2llLWlwcm9jLW1zaS5jCkBAIC00OSwxNCArNDksMTQgQEAgZW51 bSBpcHJvY19tc2lfcmVnIHsKIHN0cnVjdCBpcHJvY19tc2k7CiAKIC8qKgotICogaVByb2MgTVNJ IGdyb3VwCisgKiBzdHJ1Y3QgaXByb2NfbXNpX2dycCAtIGlQcm9jIE1TSSBncm91cC4KICAqCi0g KiBPbmUgTVNJIGdyb3VwIGlzIGFsbG9jYXRlZCBwZXIgR0lDIGludGVycnVwdCwgc2VydmljZWQg Ynkgb25lIGlQcm9jIE1TSQotICogZXZlbnQgcXVldWUuCisgKiBAbXNpOglQb2ludGVyIHRvIGlQ cm9jIE1TSSBkYXRhLgorICogQGdpY19pcnE6CUdJQyBpbnRlcnJ1cHQuCisgKiBAZXE6CQlFdmVu dCBxdWV1ZSBudW1iZXIuCiAgKgotICogQG1zaTogcG9pbnRlciB0byBpUHJvYyBNU0kgZGF0YQot ICogQGdpY19pcnE6IEdJQyBpbnRlcnJ1cHQKLSAqIEBlcTogRXZlbnQgcXVldWUgbnVtYmVyCisg KiBPbmUgTVNJIGdyb3VwIGlzIGFsbG9jYXRlZCBwZXIgR0lDIGludGVycnVwdCwgc2VydmljZWQg Ynkgb25lIGlQcm9jIE1TSSBldmVudAorICogcXVldWUuCiAgKi8KIHN0cnVjdCBpcHJvY19tc2lf Z3JwIHsKIAlzdHJ1Y3QgaXByb2NfbXNpICptc2k7CkBAIC02NSwzMCArNjUsMzAgQEAgc3RydWN0 IGlwcm9jX21zaV9ncnAgewogfTsKIAogLyoqCi0gKiBpUHJvYyBldmVudCBxdWV1ZSBiYXNlZCBN U0kKKyAqIHN0cnVjdCBpcHJvY19tc2kgLSBpUHJvYyBldmVudCBxdWV1ZSBiYXNlZCBNU0kuCisg KgorICogQHBjaWU6CQlQb2ludGVyIHRvIGlQcm9jIFBDSWUgZGF0YS4KKyAqIEByZWdfb2Zmc2V0 czoJTVNJIHJlZ2lzdGVyIG9mZnNldHMuCisgKiBAZ3JwczoJCU1TSSBncm91cHMuCisgKiBAbnJf aXJxczoJCU51bWJlciBvZiB0b3RhbCBpbnRlcnJ1cHRzIGNvbm5lY3RlZCB0byBHSUMuCisgKiBA bnJfY3B1czoJCU51bWJlciBvZiB0b2FsIENQVXMuCisgKiBAaGFzX2ludGVuX3JlZzoJSW5kaWNh dGVzIHRoZSBNU0kgaW50ZXJydXB0IGVuYWJsZSByZWdpc3RlciBuZWVkcyB0byBiZQorICoJCQlz ZXQgZXhwbGljaXRseSAocmVxdWlyZWQgZm9yIHNvbWUgbGVnYWN5IHBsYXRmb3JtcykuCisgKiBA Yml0bWFwOgkJTVNJIHZlY3RvciBiaXRtYXAuCisgKiBAYml0bWFwX2xvY2s6CUxvY2sgdG8gcHJv dGVjdCBhY2Nlc3MgdG8gdGhlIE1TSSBiaXRtYXAuCisgKiBAbnJfbXNpX3ZlY3M6CVRvdGFsIG51 bWJlciBvZiBNU0kgdmVjdG9ycy4KKyAqIEBpbm5lcl9kb21haW46CUlubmVyIElSUSBkb21haW4u CisgKiBAbXNpX2RvbWFpbjoJCU1TSSBJUlEgZG9tYWluLgorICogQG5yX2VxX3JlZ2lvbjoJUmVx dWlyZWQgbnVtYmVyIG9mIDRLIGFsaWduZWQgbWVtb3J5IHJlZ2lvbiBmb3IgTVNJCisgKgkJCWV2 ZW50IHF1ZXVlcy4KKyAqIEBucl9tc2lfcmVnaW9uOglSZXF1aXJlZCBudW1iZXIgb2YgNEsgYWxp Z25lZCBhZGRyZXNzIHJlZ2lvbiBmb3IgTVNJCisgKgkJCXBvc3RlZCB3cml0ZXMuCisgKiBAZXFf Y3B1OgkJUG9pbnRlciB0byBhbGxvY2F0ZWQgbWVtb3J5IHJlZ2lvbiBmb3IgTVNJIGV2ZW50IHF1 ZXVlcy4KKyAqIEBlcV9kbWE6CQlETUEgYWRkcmVzcyBvZiBNU0kgZXZlbnQgcXVldWVzLgorICog QG1zaV9hZGRyOgkJTVNJIGFkZHJlc3MuCiAgKgogICogT25seSBtZWFudCB0byBiZSB1c2VkIG9u IHBsYXRmb3JtcyB3aXRob3V0IE1TSSBzdXBwb3J0IGludGVncmF0ZWQgaW50byB0aGUKICAqIEdJ Qy4KLSAqCi0gKiBAcGNpZTogcG9pbnRlciB0byBpUHJvYyBQQ0llIGRhdGEKLSAqIEByZWdfb2Zm c2V0czogTVNJIHJlZ2lzdGVyIG9mZnNldHMKLSAqIEBncnBzOiBNU0kgZ3JvdXBzCi0gKiBAbnJf aXJxczogbnVtYmVyIG9mIHRvdGFsIGludGVycnVwdHMgY29ubmVjdGVkIHRvIEdJQwotICogQG5y X2NwdXM6IG51bWJlciBvZiB0b2FsIENQVXMKLSAqIEBoYXNfaW50ZW5fcmVnOiBpbmRpY2F0ZXMg dGhlIE1TSSBpbnRlcnJ1cHQgZW5hYmxlIHJlZ2lzdGVyIG5lZWRzIHRvIGJlCi0gKiBzZXQgZXhw bGljaXRseSAocmVxdWlyZWQgZm9yIHNvbWUgbGVnYWN5IHBsYXRmb3JtcykKLSAqIEBiaXRtYXA6 IE1TSSB2ZWN0b3IgYml0bWFwCi0gKiBAYml0bWFwX2xvY2s6IGxvY2sgdG8gcHJvdGVjdCBhY2Nl c3MgdG8gdGhlIE1TSSBiaXRtYXAKLSAqIEBucl9tc2lfdmVjczogdG90YWwgbnVtYmVyIG9mIE1T SSB2ZWN0b3JzCi0gKiBAaW5uZXJfZG9tYWluOiBpbm5lciBJUlEgZG9tYWluCi0gKiBAbXNpX2Rv bWFpbjogTVNJIElSUSBkb21haW4KLSAqIEBucl9lcV9yZWdpb246IHJlcXVpcmVkIG51bWJlciBv ZiA0SyBhbGlnbmVkIG1lbW9yeSByZWdpb24gZm9yIE1TSSBldmVudAotICogcXVldWVzCi0gKiBA bnJfbXNpX3JlZ2lvbjogcmVxdWlyZWQgbnVtYmVyIG9mIDRLIGFsaWduZWQgYWRkcmVzcyByZWdp b24gZm9yIE1TSSBwb3N0ZWQKLSAqIHdyaXRlcwotICogQGVxX2NwdTogcG9pbnRlciB0byBhbGxv Y2F0ZWQgbWVtb3J5IHJlZ2lvbiBmb3IgTVNJIGV2ZW50IHF1ZXVlcwotICogQGVxX2RtYTogRE1B IGFkZHJlc3Mgb2YgTVNJIGV2ZW50IHF1ZXVlcwotICogQG1zaV9hZGRyOiBNU0kgYWRkcmVzcwog ICovCiBzdHJ1Y3QgaXByb2NfbXNpIHsKIAlzdHJ1Y3QgaXByb2NfcGNpZSAqcGNpZTsKZGlmZiAt LWdpdCBhL2RyaXZlcnMvcGNpL2NvbnRyb2xsZXIvcGNpZS1pcHJvYy5jIGIvZHJpdmVycy9wY2kv Y29udHJvbGxlci9wY2llLWlwcm9jLmMKaW5kZXggMDJlNTJmNjk4ZWViLi4yYTQwMGJmODFmNTgg MTAwNjQ0Ci0tLSBhL2RyaXZlcnMvcGNpL2NvbnRyb2xsZXIvcGNpZS1pcHJvYy5jCisrKyBiL2Ry aXZlcnMvcGNpL2NvbnRyb2xsZXIvcGNpZS1pcHJvYy5jCkBAIC04OSwxMCArODksMTAgQEAKICNk ZWZpbmUgSVBST0NfUENJRV9SRUdfSU5WQUxJRAkJMHhmZmZmCiAKIC8qKgotICogaVByb2MgUENJ ZSBvdXRib3VuZCBtYXBwaW5nIGNvbnRyb2xsZXIgc3BlY2lmaWMgcGFyYW1ldGVycwotICoKLSAq IEB3aW5kb3dfc2l6ZXM6IGxpc3Qgb2Ygc3VwcG9ydGVkIG91dGJvdW5kIG1hcHBpbmcgd2luZG93 IHNpemVzIGluIE1CCi0gKiBAbnJfc2l6ZXM6IG51bWJlciBvZiBzdXBwb3J0ZWQgb3V0Ym91bmQg bWFwcGluZyB3aW5kb3cgc2l6ZXMKKyAqIHN0cnVjdCBpcHJvY19wY2llX29iX21hcCAtIGlQcm9j IFBDSWUgb3V0Ym91bmQgbWFwcGluZyBjb250cm9sbGVyIHNwZWNpZmljCisgKgkJCSAgICAgIHBh cmFtZXRlcnMuCisgKiBAd2luZG93X3NpemVzOglMaXN0IG9mIHN1cHBvcnRlZCBvdXRib3VuZCBt YXBwaW5nIHdpbmRvdyBzaXplcyBpbiBNQi4KKyAqIEBucl9zaXplczoJCU51bWJlciBvZiBzdXBw b3J0ZWQgb3V0Ym91bmQgbWFwcGluZyB3aW5kb3cgc2l6ZXMuCiAgKi8KIHN0cnVjdCBpcHJvY19w Y2llX29iX21hcCB7CiAJcmVzb3VyY2Vfc2l6ZV90IHdpbmRvd19zaXplc1tNQVhfTlVNX09CX1dJ TkRPV19TSVpFU107CkBAIC0xMzYsMzIgKzEzNiwzMSBAQCBzdGF0aWMgY29uc3Qgc3RydWN0IGlw cm9jX3BjaWVfb2JfbWFwIHBheGJfdjJfb2JfbWFwW10gPSB7CiB9OwogCiAvKioKLSAqIGlQcm9j IFBDSWUgaW5ib3VuZCBtYXBwaW5nIHR5cGUKKyAqIGVudW0gaXByb2NfcGNpZV9pYl9tYXBfdHlw ZSAtIGlQcm9jIFBDSWUgaW5ib3VuZCBtYXBwaW5nIHR5cGUuCisgKiBASVBST0NfUENJRV9JQl9N QVBfTUVNOglERFIgbWVtb3J5LgorICogQElQUk9DX1BDSUVfSUJfTUFQX0lPOglEZXZpY2UgSS9P IG1lbW9yeS4KKyAqIEBJUFJPQ19QQ0lFX0lCX01BUF9JTlZBTElEOglJbnZhbGlkIG9yIHVudXNl ZC4KICAqLwogZW51bSBpcHJvY19wY2llX2liX21hcF90eXBlIHsKLQkvKiBmb3IgRERSIG1lbW9y eSAqLwogCUlQUk9DX1BDSUVfSUJfTUFQX01FTSA9IDAsCi0KLQkvKiBmb3IgZGV2aWNlIEkvTyBt ZW1vcnkgKi8KIAlJUFJPQ19QQ0lFX0lCX01BUF9JTywKLQotCS8qIGludmFsaWQgb3IgdW51c2Vk ICovCiAJSVBST0NfUENJRV9JQl9NQVBfSU5WQUxJRAogfTsKIAogLyoqCi0gKiBpUHJvYyBQQ0ll IGluYm91bmQgbWFwcGluZyBjb250cm9sbGVyIHNwZWNpZmljIHBhcmFtZXRlcnMKLSAqCi0gKiBA dHlwZTogaW5ib3VuZCBtYXBwaW5nIHJlZ2lvbiB0eXBlCi0gKiBAc2l6ZV91bml0OiBpbmJvdW5k IG1hcHBpbmcgcmVnaW9uIHNpemUgdW5pdCwgY291bGQgYmUgU1pfMUssIFNaXzFNLCBvcgotICog U1pfMUcKLSAqIEByZWdpb25fc2l6ZXM6IGxpc3Qgb2Ygc3VwcG9ydGVkIGluYm91bmQgbWFwcGlu ZyByZWdpb24gc2l6ZXMgaW4gS0IsIE1CLCBvcgotICogR0IsIGRlcGVuZGluZyBvbiB0aGUgc2l6 ZSB1bml0Ci0gKiBAbnJfc2l6ZXM6IG51bWJlciBvZiBzdXBwb3J0ZWQgaW5ib3VuZCBtYXBwaW5n IHJlZ2lvbiBzaXplcwotICogQG5yX3dpbmRvd3M6IG51bWJlciBvZiBzdXBwb3J0ZWQgaW5ib3Vu ZCBtYXBwaW5nIHdpbmRvd3MgZm9yIHRoZSByZWdpb24KLSAqIEBpbWFwX2FkZHJfb2Zmc2V0OiBy ZWdpc3RlciBvZmZzZXQgYmV0d2VlbiB0aGUgdXBwZXIgYW5kIGxvd2VyIDMyLWJpdAotICogSU1B UCBhZGRyZXNzIHJlZ2lzdGVycwotICogQGltYXBfd2luZG93X29mZnNldDogcmVnaXN0ZXIgb2Zm c2V0IGJldHdlZW4gZWFjaCBJTUFQIHdpbmRvdworICogc3RydWN0IGlwcm9jX3BjaWVfaWJfbWFw IC0gaVByb2MgUENJZSBpbmJvdW5kIG1hcHBpbmcgY29udHJvbGxlciBzcGVjaWZpYworICoJCQkg ICAgICBwYXJhbWV0ZXJzLgorICogQHR5cGU6CQlJbmJvdW5kIG1hcHBpbmcgcmVnaW9uIHR5cGUK KyAqIEBzaXplX3VuaXQ6CQlJbmJvdW5kIG1hcHBpbmcgcmVnaW9uIHNpemUgdW5pdCwgY291bGQg YmUgU1pfMUssIFNaXzFNLAorICoJCQlvciBTWl8xRy4KKyAqIEByZWdpb25fc2l6ZXM6CUxpc3Qg b2Ygc3VwcG9ydGVkIGluYm91bmQgbWFwcGluZyByZWdpb24gc2l6ZXMgaW4gS0IsCisgKgkJCU1C LCBvciBHQiwgZGVwZW5kaW5nIG9uIHRoZSBzaXplIHVuaXQuCisgKiBAbnJfc2l6ZXM6CQlOdW1i ZXIgb2Ygc3VwcG9ydGVkIGluYm91bmQgbWFwcGluZyByZWdpb24gc2l6ZXMuCisgKiBAbnJfd2lu ZG93czoJCU51bWJlciBvZiBzdXBwb3J0ZWQgaW5ib3VuZCBtYXBwaW5nIHdpbmRvd3MgZm9yIHRo ZQorICoJCQlyZWdpb24uCisgKiBAaW1hcF9hZGRyX29mZnNldDoJUmVnaXN0ZXIgb2Zmc2V0IGJl dHdlZW4gdGhlIHVwcGVyIGFuZCBsb3dlciAzMi1iaXQgSU1BUAorICoJCQlhZGRyZXNzIHJlZ2lz dGVycy4KKyAqIEBpbWFwX3dpbmRvd19vZmZzZXQ6CVJlZ2lzdGVyIG9mZnNldCBiZXR3ZWVuIGVh Y2ggSU1BUCB3aW5kb3cuCiAgKi8KIHN0cnVjdCBpcHJvY19wY2llX2liX21hcCB7CiAJZW51bSBp cHJvY19wY2llX2liX21hcF90eXBlIHR5cGU7CkBAIC00MzcsNyArNDM2LDcgQEAgc3RhdGljIGlu bGluZSB2b2lkIGlwcm9jX3BjaWVfd3JpdGVfcmVnKHN0cnVjdCBpcHJvY19wY2llICpwY2llLAog CXdyaXRlbCh2YWwsIHBjaWUtPmJhc2UgKyBvZmZzZXQpOwogfQogCi0vKioKKy8qCiAgKiBBUEIg ZXJyb3IgZm9yd2FyZGluZyBjYW4gYmUgZGlzYWJsZWQgZHVyaW5nIGFjY2VzcyBvZiBjb25maWd1 cmF0aW9uCiAgKiByZWdpc3RlcnMgb2YgdGhlIGVuZHBvaW50IGRldmljZSwgdG8gcHJldmVudCB1 bnN1cHBvcnRlZCByZXF1ZXN0cwogICogKHR5cGljYWxseSBzZWVuIGR1cmluZyBlbnVtZXJhdGlv biB3aXRoIG11bHRpLWZ1bmN0aW9uIGRldmljZXMpIGZyb20KQEAgLTYxOSw3ICs2MTgsNyBAQCBz dGF0aWMgaW50IGlwcm9jX3BjaWVfY29uZmlnX3JlYWQoc3RydWN0IHBjaV9idXMgKmJ1cywgdW5z aWduZWQgaW50IGRldmZuLAogCXJldHVybiBQQ0lCSU9TX1NVQ0NFU1NGVUw7CiB9CiAKLS8qKgor LyoKICAqIE5vdGUgYWNjZXNzIHRvIHRoZSBjb25maWd1cmF0aW9uIHJlZ2lzdGVycyBhcmUgcHJv dGVjdGVkIGF0IHRoZSBoaWdoZXIgbGF5ZXIKICAqIGJ5ICdwY2lfbG9jaycgaW4gZHJpdmVycy9w Y2kvYWNjZXNzLmMKICAqLwpAQCAtODk3LDcgKzg5Niw3IEBAIHN0YXRpYyBpbmxpbmUgaW50IGlw cm9jX3BjaWVfb2Jfd3JpdGUoc3RydWN0IGlwcm9jX3BjaWUgKnBjaWUsIGludCB3aW5kb3dfaWR4 LAogCXJldHVybiAwOwogfQogCi0vKioKKy8qCiAgKiBTb21lIGlQcm9jIFNvQ3MgcmVxdWlyZSB0 aGUgU1cgdG8gY29uZmlndXJlIHRoZSBvdXRib3VuZCBhZGRyZXNzIG1hcHBpbmcKICAqCiAgKiBP dXRib3VuZCBhZGRyZXNzIHRyYW5zbGF0aW9uOgpkaWZmIC0tZ2l0IGEvZHJpdmVycy9wY2kvY29u dHJvbGxlci9wY2llLWlwcm9jLmggYi9kcml2ZXJzL3BjaS9jb250cm9sbGVyL3BjaWUtaXByb2Mu aAppbmRleCBjMjY3NmU0NDJmNTUuLjQzMmNlMjE2ZjFmYiAxMDA2NDQKLS0tIGEvZHJpdmVycy9w Y2kvY29udHJvbGxlci9wY2llLWlwcm9jLmgKKysrIGIvZHJpdmVycy9wY2kvY29udHJvbGxlci9w Y2llLWlwcm9jLmgKQEAgLTcsNyArNywxNiBAQAogI2RlZmluZSBfUENJRV9JUFJPQ19ICiAKIC8q KgotICogaVByb2MgUENJZSBpbnRlcmZhY2UgdHlwZQorICogZW51bSBpcHJvY19wY2llX3R5cGUg LSBpUHJvYyBQQ0llIGludGVyZmFjZSB0eXBlLgorICogQElQUk9DX1BDSUVfUEFYQl9CQ01BOglO ZXcgZ2VuZXJhdGlvbiBvZiBpUHJvYyBCQ01BLWJhc2VkIGhvc3QKKyAqCQkJCWNvbnRyb2xsZXJz LgorICogQElQUk9DX1BDSUVfUEFYQjoJCWlQcm9jIFBBWEItYmFzZWQgaG9zdCBjb250cm9sbGVy cyBmb3IgU29DcyBzdWNoCisgKgkJCQlhcyBOUywgTlNQLCBDeWdudXMsIE5TMiBhbmQgUGVnYXN1 cy4KKyAqIEBJUFJPQ19QQ0lFX1BBWEJfVjI6CQlOZXh0IGdlbmVyYXRpb24gb2YgaVByb2MgUEFY Qi1iYXNlZCBob3N0CisgKgkJCQljb250cm9sbGVycyB1c2luZyB0aGUgU3RpbmdyYXkgU29Dcy4K KyAqIEBJUFJPQ19QQ0lFX1BBWEM6CQlpUHJveCBQQVhDLWJhc2VkIGhvc3QgY29udHJvbGxlcnMu CisgKiBASVBST0NfUENJRV9QQVhDX1YyOgkJU2Vjb25kIGdlbmVyYXRpb24gb2YgdGhlIGlQcm9j IFBBWEMtYmFzZWQgaG9zdAorICoJCQkJY29udHJvbGxlcnMuCiAgKgogICogUEFYQiBpcyB0aGUg d3JhcHBlciB1c2VkIGluIHJvb3QgY29tcGxleCB0aGF0IGNhbiBiZSBjb25uZWN0ZWQgdG8gYW4K ICAqIGV4dGVybmFsIGVuZHBvaW50IGRldmljZS4KQEAgLTI0LDEwICszMywxMCBAQCBlbnVtIGlw cm9jX3BjaWVfdHlwZSB7CiB9OwogCiAvKioKLSAqIGlQcm9jIFBDSWUgb3V0Ym91bmQgbWFwcGlu ZwotICogQGF4aV9vZmZzZXQ6IG9mZnNldCBmcm9tIHRoZSBBWEkgYWRkcmVzcyB0byB0aGUgaW50 ZXJuYWwgYWRkcmVzcyB1c2VkIGJ5Ci0gKiB0aGUgaVByb2MgUENJZSBjb3JlCi0gKiBAbnJfd2lu ZG93czogdG90YWwgbnVtYmVyIG9mIHN1cHBvcnRlZCBvdXRib3VuZCBtYXBwaW5nIHdpbmRvd3MK KyAqIHN0cnVjdCBpcHJvY19wY2llX29iIC0gaVByb2MgUENJZSBvdXRib3VuZCBtYXBwaW5nLgor ICogQGF4aV9vZmZzZXQ6CU9mZnNldCBmcm9tIHRoZSBBWEkgYWRkcmVzcyB0byB0aGUgaW50ZXJu YWwgYWRkcmVzcyB1c2VkIGJ5IHRoZQorICoJCWlQcm9jIFBDSWUgY29yZS4KKyAqIEBucl93aW5k b3dzOglUb3RhbCBudW1iZXIgb2Ygc3VwcG9ydGVkIG91dGJvdW5kIG1hcHBpbmcgd2luZG93cy4K ICAqLwogc3RydWN0IGlwcm9jX3BjaWVfb2IgewogCXJlc291cmNlX3NpemVfdCBheGlfb2Zmc2V0 OwpAQCAtMzUsOCArNDQsOCBAQCBzdHJ1Y3QgaXByb2NfcGNpZV9vYiB7CiB9OwogCiAvKioKLSAq IGlQcm9jIFBDSWUgaW5ib3VuZCBtYXBwaW5nCi0gKiBAbnJfcmVnaW9uczogdG90YWwgbnVtYmVy IG9mIHN1cHBvcnRlZCBpbmJvdW5kIG1hcHBpbmcgcmVnaW9ucworICogc3RydWN0IGlwcm9jX3Bj aWVfaWIgLSBpUHJvYyBQQ0llIGluYm91bmQgbWFwcGluZy4KKyAqIEBucl9yZWdpb25zOglUb3Rh bCBudW1iZXIgb2Ygc3VwcG9ydGVkIGluYm91bmQgbWFwcGluZyByZWdpb25zLgogICovCiBzdHJ1 Y3QgaXByb2NfcGNpZV9pYiB7CiAJdW5zaWduZWQgaW50IG5yX3JlZ2lvbnM7CkBAIC00NywzNSAr NTYsNDIgQEAgc3RydWN0IGlwcm9jX3BjaWVfaWJfbWFwOwogc3RydWN0IGlwcm9jX21zaTsKIAog LyoqCi0gKiBpUHJvYyBQQ0llIGRldmljZQotICoKLSAqIEBkZXY6IHBvaW50ZXIgdG8gZGV2aWNl IGRhdGEgc3RydWN0dXJlCi0gKiBAdHlwZTogaVByb2MgUENJZSBpbnRlcmZhY2UgdHlwZQotICog QHJlZ19vZmZzZXRzOiByZWdpc3RlciBvZmZzZXRzCi0gKiBAYmFzZTogUENJZSBob3N0IGNvbnRy b2xsZXIgSS9PIHJlZ2lzdGVyIGJhc2UKLSAqIEBiYXNlX2FkZHI6IFBDSWUgaG9zdCBjb250cm9s bGVyIHJlZ2lzdGVyIGJhc2UgcGh5c2ljYWwgYWRkcmVzcwotICogQHBoeTogb3B0aW9uYWwgUEhZ IGRldmljZSB0aGF0IGNvbnRyb2xzIHRoZSBTZXJkZXMKLSAqIEBtYXBfaXJxOiBmdW5jdGlvbiBj YWxsYmFjayB0byBtYXAgaW50ZXJydXB0cwotICogQGVwX2lzX2ludGVybmFsOiBpbmRpY2F0ZXMg YW4gaW50ZXJuYWwgZW11bGF0ZWQgZW5kcG9pbnQgZGV2aWNlIGlzIGNvbm5lY3RlZAotICogQGlw cm9jX2NmZ19yZWFkOiBpbmRpY2F0ZXMgdGhlIGlQcm9jIGNvbmZpZyByZWFkIGZ1bmN0aW9uIHNo b3VsZCBiZSB1c2VkCi0gKiBAcmVqX3VuY29uZmlnX3BmOiBpbmRpY2F0ZXMgdGhlIHJvb3QgY29t cGxleCBuZWVkcyB0byBkZXRlY3QgYW5kIHJlamVjdAotICogZW51bWVyYXRpb24gYWdhaW5zdCB1 bmNvbmZpZ3VyZWQgcGh5c2ljYWwgZnVuY3Rpb25zIGVtdWxhdGVkIGluIHRoZSBBU0lDCi0gKiBA aGFzX2FwYl9lcnJfZGlzYWJsZTogaW5kaWNhdGVzIHRoZSBjb250cm9sbGVyIGNhbiBiZSBjb25m aWd1cmVkIHRvIHByZXZlbnQKLSAqIHVuc3VwcG9ydGVkIHJlcXVlc3QgZnJvbSBiZWluZyBmb3J3 YXJkZWQgYXMgYW4gQVBCIGJ1cyBlcnJvcgotICogQGZpeF9wYXhjX2NhcDogaW5kaWNhdGVzIHRo ZSBjb250cm9sbGVyIGhhcyBjb3JydXB0ZWQgY2FwYWJpbGl0eSBsaXN0IGluIGl0cwotICogY29u ZmlnIHNwYWNlIHJlZ2lzdGVycyBhbmQgcmVxdWlyZXMgU1cgYmFzZWQgZml4dXAKLSAqCi0gKiBA bmVlZF9vYl9jZmc6IGluZGljYXRlcyBTVyBuZWVkcyB0byBjb25maWd1cmUgdGhlIG91dGJvdW5k IG1hcHBpbmcgd2luZG93Ci0gKiBAb2I6IG91dGJvdW5kIG1hcHBpbmcgcmVsYXRlZCBwYXJhbWV0 ZXJzCi0gKiBAb2JfbWFwOiBvdXRib3VuZCBtYXBwaW5nIHJlbGF0ZWQgcGFyYW1ldGVycyBzcGVj aWZpYyB0byB0aGUgY29udHJvbGxlcgotICoKLSAqIEBuZWVkX2liX2NmZzogaW5kaWNhdGVzIFNX IG5lZWRzIHRvIGNvbmZpZ3VyZSB0aGUgaW5ib3VuZCBtYXBwaW5nIHdpbmRvdwotICogQGliOiBp bmJvdW5kIG1hcHBpbmcgcmVsYXRlZCBwYXJhbWV0ZXJzCi0gKiBAaWJfbWFwOiBvdXRib3VuZCBt YXBwaW5nIHJlZ2lvbiByZWxhdGVkIHBhcmFtZXRlcnMKLSAqCi0gKiBAbmVlZF9tc2lfc3RlZXI6 IGluZGljYXRlcyBhZGRpdGlvbmFsIGNvbmZpZ3VyYXRpb24gb2YgdGhlIGlQcm9jIFBDSWUKLSAq IGNvbnRyb2xsZXIgaXMgcmVxdWlyZWQgdG8gc3RlZXIgTVNJIHdyaXRlcyB0byBleHRlcm5hbCBp bnRlcnJ1cHQgY29udHJvbGxlcgotICogQG1zaTogTVNJIGRhdGEKKyAqIHN0cnVjdCBpcHJvY19w Y2llIC0gaVByb2MgUENJZSBkZXZpY2UuCisgKiBAZGV2OgkJCVBvaW50ZXIgdG8gZGV2aWNlIGRh dGEgc3RydWN0dXJlLgorICogQHR5cGU6CQkJaVByb2MgUENJZSBpbnRlcmZhY2UgdHlwZS4KKyAq IEByZWdfb2Zmc2V0czoJCVJlZ2lzdGVyIG9mZnNldHMuCisgKiBAYmFzZToJCQlQQ0llIGhvc3Qg Y29udHJvbGxlciBJL08gcmVnaXN0ZXIgYmFzZS4KKyAqIEBiYXNlX2FkZHI6CQkJUENJZSBob3N0 IGNvbnRyb2xsZXIgcmVnaXN0ZXIgYmFzZSBwaHlzaWNhbAorICoJCQkJYWRkcmVzcy4KKyAqIEBt ZW06CQkJSG9zdCBicmlkZ2UgbWVtb3J5IHdpbmRvdyByZXNvdXJjZS4KKyAqIEBwaHk6CQkJT3B0 aW9uYWwgUEhZIGRldmljZSB0aGF0IGNvbnRyb2xzIHRoZSBTZXJkZXMuCisgKiBAbWFwX2lycToJ CQlGdW5jdGlvbiBjYWxsYmFjayB0byBtYXAgaW50ZXJydXB0cy4KKyAqIEBlcF9pc19pbnRlcm5h bDoJCUluZGljYXRlcyBhbiBpbnRlcm5hbCBlbXVsYXRlZCBlbmRwb2ludCBkZXZpY2UKKyAqCQkJ CWlzIGNvbm5lY3RlZC4KKyAqIEBpcHJvY19jZmdfcmVhZDoJCUluZGljYXRlcyB0aGUgaVByb2Mg Y29uZmlnIHJlYWQgZnVuY3Rpb24gc2hvdWxkCisgKgkJCQliZSB1c2VkLgorICogQHJlal91bmNv bmZpZ19wZjoJCUluZGljYXRlcyB0aGUgcm9vdCBjb21wbGV4IG5lZWRzIHRvIGRldGVjdCBhbmQK KyAqCQkJCXJlamVjdCBlbnVtZXJhdGlvbiBhZ2FpbnN0IHVuY29uZmlndXJlZCBwaHlzaWNhbAor ICoJCQkJZnVuY3Rpb25zIGVtdWxhdGVkIGluIHRoZSBBU0lDLgorICogQGhhc19hcGJfZXJyX2Rp c2FibGU6CUluZGljYXRlcyB0aGUgY29udHJvbGxlciBjYW4gYmUgY29uZmlndXJlZCB0bworICoJ CQkJcHJldmVudCB1bnN1cHBvcnRlZCByZXF1ZXN0IGZyb20gYmVpbmcgZm9yd2FyZGVkCisgKgkJ CQlhcyBhbiBBUEIgYnVzIGVycm9yLgorICogQGZpeF9wYXhjX2NhcDoJCUluZGljYXRlcyB0aGUg Y29udHJvbGxlciBoYXMgY29ycnVwdGVkCisgKgkJCQljYXBhYmlsaXR5IGxpc3QgaW4gaXRzIGNv bmZpZyBzcGFjZSByZWdpc3RlcnMKKyAqCQkJCWFuZCByZXF1aXJlcyBTVyBiYXNlZCBmaXh1cC4K KyAqIEBuZWVkX29iX2NmZzoJCUluZGljYXRlcyBTVyBuZWVkcyB0byBjb25maWd1cmUgdGhlIG91 dGJvdW5kCisgKgkJCQltYXBwaW5nIHdpbmRvdy4KKyAqIEBvYjoJCQkJT3V0Ym91bmQgbWFwcGlu ZyByZWxhdGVkIHBhcmFtZXRlcnMuCisgKiBAb2JfbWFwOgkJCU91dGJvdW5kIG1hcHBpbmcgcmVs YXRlZCBwYXJhbWV0ZXJzIHNwZWNpZmljIHRvCisgKgkJCQl0aGUgY29udHJvbGxlci4KKyAqIEBu ZWVkX2liX2NmZzoJCWluZGljYXRlcyBTVyBuZWVkcyB0byBjb25maWd1cmUgdGhlIGluYm91bmQK KyAqCQkJCW1hcHBpbmcgd2luZG93LgorICogQGliOgkJCQlJbmJvdW5kIG1hcHBpbmcgcmVsYXRl ZCBwYXJhbWV0ZXJzLgorICogQGliX21hcDoJCQlPdXRib3VuZCBtYXBwaW5nIHJlZ2lvbiByZWxh dGVkIHBhcmFtZXRlcnMuCisgKiBAbmVlZF9tc2lfc3RlZXI6CQlJbmRpY2F0ZXMgYWRkaXRpb25h bCBjb25maWd1cmF0aW9uIG9mIHRoZSBpUHJvYworICoJCQkJUENJZSBjb250cm9sbGVyIGlzIHJl cXVpcmVkIHRvIHN0ZWVyIE1TSSB3cml0ZXMKKyAqCQkJCXRvIGV4dGVybmFsIGludGVycnVwdCBj b250cm9sbGVyLgorICogQG1zaToJCQlNU0kgZGF0YS4KICAqLwogc3RydWN0IGlwcm9jX3BjaWUg ewogCXN0cnVjdCBkZXZpY2UgKmRldjsKLS0gCjIuMzIuMAoKCl9fX19fX19fX19fX19fX19fX19f X19fX19fX19fX19fX19fX19fX19fX19fX19fCmxpbnV4LWFybS1rZXJuZWwgbWFpbGluZyBsaXN0 CmxpbnV4LWFybS1rZXJuZWxAbGlzdHMuaW5mcmFkZWFkLm9yZwpodHRwOi8vbGlzdHMuaW5mcmFk ZWFkLm9yZy9tYWlsbWFuL2xpc3RpbmZvL2xpbnV4LWFybS1rZXJuZWwK