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,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 885CCC07E9B for ; Sat, 3 Jul 2021 15:15:24 +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 53C1161402 for ; Sat, 3 Jul 2021 15:15:24 +0000 (UTC) DMARC-Filter: OpenDMARC Filter v1.3.2 mail.kernel.org 53C1161402 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:References:In-Reply-To: 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: List-Owner; bh=o/vynqWQE57yCFepF6zQIrM+9atfmtD7fut6L+c9Ht8=; b=MBysZjdHAAEGN/ 0bKToLe94WJ6iJXwAntjfxg4VFiXE69NvR7bj46YJw3tEXvBVW9hFwiHjAZ+Q0uYdAb2WDty8VI3b KHnp2UFMYog7xSLBb5B6nMYMqW56Xb339GzvcbdFnac0KQDF94lb7oj4D7kCQ3iubTPmXJFAiXJJw 6S7Zg2gKCBo/xym/iZJL/14b0PWooIQGAMWNZT1SaBF3pRQ8SD0He0RcjHVvFQ773mQeGx6gdOwAQ LBOSZlG8r+Unb31cHowX7EzRyu7ufOwYBptdhioIzEdT32u0VsF2NwQdiD6st1yN3X3kgJRFMeO4q X0lmdRUCEAVnce9MdTqw==; Received: from localhost ([::1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.94.2 #2 (Red Hat Linux)) id 1lzhKz-0050dw-Od; Sat, 03 Jul 2021 15:13:45 +0000 Received: from mail-lf1-f45.google.com ([209.85.167.45]) by bombadil.infradead.org with esmtps (Exim 4.94.2 #2 (Red Hat Linux)) id 1lzhKW-0050aR-Nv for linux-arm-kernel@lists.infradead.org; Sat, 03 Jul 2021 15:13:18 +0000 Received: by mail-lf1-f45.google.com with SMTP id w19so23858706lfk.5 for ; Sat, 03 Jul 2021 08:13:13 -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:in-reply-to :references:mime-version:content-transfer-encoding; bh=U7rzTOb04LbYLPb0x72Oq3slQy7w9mF5ZvWIsm7kXic=; b=E5tx7mFWvwDQFxzY/BkkWkeCF2cUQypjV4Hh+fINHhqWB5Xtc0afr5F/D49ru83DQ2 TdKrjdyKao1uoehrRxsLaJJvMB/tmF6Awq6+meiQEkRsXR4IxEZiZX+4vpdt/ot23ito +JkW4b16/h2bjXWn3JDiBIr/CFaEgqz/5VUExgwuiDMiyPqcT5O/hHpyhtn5JndjhoBe bc01RKrBu6qONdnuoGubUwK23IjHEFj/COcslYZtIOvGR4srWPAD6OYVrTO4IRpMmpAu 4rfbfqzlccODfxlRVmDkWQMA9lBANyadB1QOMEJiduyAEl/bsXJjdZGSlKgrFioobbwX PxVg== X-Gm-Message-State: AOAM531KqmnNC8AqLSuzBORwUPyXvm0M7c6qQlmonZ2YsOj1FZCs+NXq jtCxfu9STP0uGjt0crl0F5o= X-Google-Smtp-Source: ABdhPJzdvWD5Pic4JP8Q0qc1wxxJN3vK1g1cZUZ9XK2encPzy+iMlCGvKhk8fDEzbwF9fvSEQwa8eQ== X-Received: by 2002:a05:6512:238c:: with SMTP id c12mr3946443lfv.317.1625325191845; Sat, 03 Jul 2021 08:13:11 -0700 (PDT) Received: from workstation.lan ([95.155.85.46]) by smtp.gmail.com with ESMTPSA id p18sm715980ljj.56.2021.07.03.08.13.10 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 03 Jul 2021 08:13:11 -0700 (PDT) From: =?UTF-8?q?Krzysztof=20Wilczy=C5=84ski?= To: Bjorn Helgaas Cc: Lorenzo Pieralisi , Lukas Wunner , Rob Herring , Scott Branden , Scott Murray , Tom Joseph , bcm-kernel-feedback-list@broadcom.com, linux-arm-kernel@lists.infradead.org, linux-pci@vger.kernel.org Subject: [PATCH 4/5] PCI: hotplug: Fix kernel-doc formatting and add missing documentation Date: Sat, 3 Jul 2021 15:13:05 +0000 Message-Id: <20210703151306.1922450-4-kw@linux.com> X-Mailer: git-send-email 2.32.0 In-Reply-To: <20210703151306.1922450-1-kw@linux.com> References: <20210703151306.1922450-1-kw@linux.com> MIME-Version: 1.0 X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20210703_081316_829953_CCAD899E X-CRM114-Status: GOOD ( 16.43 ) 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 Rml4IGtlcm5lbC1kb2MgZm9ybWF0dGluZyBhbmQgYWRkIG1pc3NpbmcgZG9jdW1lbnRhdGlvbiBm b3IgdGhlCnBhcmFtZXRlcnMgImJ1cyIgb2YgdGhlIGdldF9zbG90X21hcHBpbmcoKSBmdW5jdGlv bi4KCkFkZCBkb2N1bWVudGF0aW9uIGZvciBtaXNzaW5nICJ0IiBhbmQgcmVtb3ZlIHN1cnBsdXMg InNsb3QiIHBhcmFtZXRlciBvZgp0aGUgY3BxaHBfcHVzaGJ1dHRvbl90aHJlYWQoKSBmdW5jdGlv bi4KCkFsc28gYWRkIG1pc3NpbmcgZG9jdW1lbnRhdGlvbiBmb3IgImluYmFuZF9wcmVzZW5jZV9k aXNhYmxlZCIgbWVtYmVyIG9mCnRoZSBzdHJ1Y3QgY29udHJvbGxlciwgYW5kIHRoZSAic2xvdF9s aXN0IiBhbmQgInBjaV9zbG90IiBtZW1iZXJzIG9mIHRoZQpzdHJ1Y3QgaG90cGx1Z19zbG90LgoK VGh1cywgcmVzb2x2ZSBidWlsZCB0aW1lIHdhcm5pbmdzIHJlbGF0ZWQgdG8ga2VybmVsLWRvYzoK CiAgZHJpdmVycy9wY2kvaG90cGx1Zy9jcHFwaHBfY29yZS5jOjMwODogd2FybmluZzogRnVuY3Rp b24gcGFyYW1ldGVyIG9yIG1lbWJlciAnYnVzJyBub3QgZGVzY3JpYmVkIGluICdnZXRfc2xvdF9t YXBwaW5nJwogIGRyaXZlcnMvcGNpL2hvdHBsdWcvY3BxcGhwX2NvcmUuYzozMDg6IHdhcm5pbmc6 IEZ1bmN0aW9uIHBhcmFtZXRlciBvciBtZW1iZXIgJ2J1c19udW0nIG5vdCBkZXNjcmliZWQgaW4g J2dldF9zbG90X21hcHBpbmcnCiAgZHJpdmVycy9wY2kvaG90cGx1Zy9jcHFwaHBfY29yZS5jOjMw ODogd2FybmluZzogRnVuY3Rpb24gcGFyYW1ldGVyIG9yIG1lbWJlciAnZGV2X251bScgbm90IGRl c2NyaWJlZCBpbiAnZ2V0X3Nsb3RfbWFwcGluZycKICBkcml2ZXJzL3BjaS9ob3RwbHVnL2NwcXBo cF9jb3JlLmM6MzA4OiB3YXJuaW5nOiBGdW5jdGlvbiBwYXJhbWV0ZXIgb3IgbWVtYmVyICdzbG90 JyBub3QgZGVzY3JpYmVkIGluICdnZXRfc2xvdF9tYXBwaW5nJwoKICBkcml2ZXJzL3BjaS9ob3Rw bHVnL2NwcXBocF9jdHJsLmM6MTg4Nzogd2FybmluZzogRnVuY3Rpb24gcGFyYW1ldGVyIG9yIG1l bWJlciAndCcgbm90IGRlc2NyaWJlZCBpbiAnY3BxaHBfcHVzaGJ1dHRvbl90aHJlYWQnCiAgZHJp dmVycy9wY2kvaG90cGx1Zy9jcHFwaHBfY3RybC5jOjE4ODc6IHdhcm5pbmc6IEV4Y2VzcyBmdW5j dGlvbiBwYXJhbWV0ZXIgJ3Nsb3QnIGRlc2NyaXB0aW9uIGluICdjcHFocF9wdXNoYnV0dG9uX3Ro cmVhZCcKCiAgZHJpdmVycy9wY2kvaG90cGx1Zy9wY2llaHAuaDoxMTA6IHdhcm5pbmc6IEZ1bmN0 aW9uIHBhcmFtZXRlciBvciBtZW1iZXIgJ2luYmFuZF9wcmVzZW5jZV9kaXNhYmxlZCcgbm90IGRl c2NyaWJlZCBpbiAnY29udHJvbGxlcicKCiAgaW5jbHVkZS9saW51eC9wY2lfaG90cGx1Zy5oOjY0 OiB3YXJuaW5nOiBGdW5jdGlvbiBwYXJhbWV0ZXIgb3IgbWVtYmVyICdzbG90X2xpc3QnIG5vdCBk ZXNjcmliZWQgaW4gJ2hvdHBsdWdfc2xvdCcKICBpbmNsdWRlL2xpbnV4L3BjaV9ob3RwbHVnLmg6 NjQ6IHdhcm5pbmc6IEZ1bmN0aW9uIHBhcmFtZXRlciBvciBtZW1iZXIgJ3BjaV9zbG90JyBub3Qg ZGVzY3JpYmVkIGluICdob3RwbHVnX3Nsb3QnCgpObyBjaGFuZ2UgdG8gZnVuY3Rpb25hbGl0eSBp bnRlbmRlZC4KClNpZ25lZC1vZmYtYnk6IEtyenlzenRvZiBXaWxjennFhHNraSA8a3dAbGludXgu Y29tPgotLS0KIGRyaXZlcnMvcGNpL2hvdHBsdWcvY3BxcGhwX2NvcmUuYyB8IDcgKysrKy0tLQog ZHJpdmVycy9wY2kvaG90cGx1Zy9jcHFwaHBfY3RybC5jIHwgMiArLQogZHJpdmVycy9wY2kvaG90 cGx1Zy9wY2llaHAuaCAgICAgIHwgMyArKysKIGluY2x1ZGUvbGludXgvcGNpX2hvdHBsdWcuaCAg ICAgICB8IDIgKysKIDQgZmlsZXMgY2hhbmdlZCwgMTAgaW5zZXJ0aW9ucygrKSwgNCBkZWxldGlv bnMoLSkKCmRpZmYgLS1naXQgYS9kcml2ZXJzL3BjaS9ob3RwbHVnL2NwcXBocF9jb3JlLmMgYi9k cml2ZXJzL3BjaS9ob3RwbHVnL2NwcXBocF9jb3JlLmMKaW5kZXggYjhhYWNiNDFhODNjLi5mOTlh NzkyN2U1YTggMTAwNjQ0Ci0tLSBhL2RyaXZlcnMvcGNpL2hvdHBsdWcvY3BxcGhwX2NvcmUuYwor KysgYi9kcml2ZXJzL3BjaS9ob3RwbHVnL2NwcXBocF9jb3JlLmMKQEAgLTI5Niw5ICsyOTYsMTAg QEAgc3RhdGljIGludCBjdHJsX3Nsb3RfY2xlYW51cChzdHJ1Y3QgY29udHJvbGxlciAqY3RybCkK ICAqCiAgKiBXb24ndCB3b3JrIGZvciBtb3JlIHRoYW4gb25lIFBDSS1QQ0kgYnJpZGdlIGluIGEg c2xvdC4KICAqCi0gKiBAYnVzX251bSAtIGJ1cyBudW1iZXIgb2YgUENJIGRldmljZQotICogQGRl dl9udW0gLSBkZXZpY2UgbnVtYmVyIG9mIFBDSSBkZXZpY2UKLSAqIEBzbG90IC0gUG9pbnRlciB0 byB1OCB3aGVyZSBzbG90IG51bWJlciB3aWxsCWJlIHJldHVybmVkCisgKiBAYnVzOiBwb2ludGVy IHRvIHRoZSBQQ0kgYnVzIHN0cnVjdHVyZQorICogQGJ1c19udW06IGJ1cyBudW1iZXIgb2YgUENJ IGRldmljZQorICogQGRldl9udW06IGRldmljZSBudW1iZXIgb2YgUENJIGRldmljZQorICogQHNs b3Q6IFBvaW50ZXIgdG8gdTggd2hlcmUgc2xvdCBudW1iZXIgd2lsbAliZSByZXR1cm5lZAogICoK ICAqIE91dHB1dDoJU1VDQ0VTUyBvciBGQUlMVVJFCiAgKi8KZGlmZiAtLWdpdCBhL2RyaXZlcnMv cGNpL2hvdHBsdWcvY3BxcGhwX2N0cmwuYyBiL2RyaXZlcnMvcGNpL2hvdHBsdWcvY3BxcGhwX2N0 cmwuYwppbmRleCA2OGRlOTU4YTliZTguLmI4ODFjYzJiMDFjOCAxMDA2NDQKLS0tIGEvZHJpdmVy cy9wY2kvaG90cGx1Zy9jcHFwaHBfY3RybC5jCisrKyBiL2RyaXZlcnMvcGNpL2hvdHBsdWcvY3Bx cGhwX2N0cmwuYwpAQCAtMTg3Nyw3ICsxODc3LDcgQEAgc3RhdGljIHZvaWQgaW50ZXJydXB0X2V2 ZW50X2hhbmRsZXIoc3RydWN0IGNvbnRyb2xsZXIgKmN0cmwpCiAKIC8qKgogICogY3BxaHBfcHVz aGJ1dHRvbl90aHJlYWQgLSBoYW5kbGUgcHVzaGJ1dHRvbiBldmVudHMKLSAqIEBzbG90OiB0YXJn ZXQgc2xvdCAoc3RydWN0KQorICogQHQ6IHBvaW50ZXIgdG8gc3RydWN0IHRpbWVyX2xpc3Qgd2hp Y2ggaG9sZHMgYWxsIHRpbWVyIHJlbGF0ZWQgY2FsbGJhY2tzCiAgKgogICogU2NoZWR1bGVkIHBy b2NlZHVyZSB0byBoYW5kbGUgYmxvY2tpbmcgc3R1ZmYgZm9yIHRoZSBwdXNoYnV0dG9ucy4KICAq IEhhbmRsZXMgYWxsIHBlbmRpbmcgZXZlbnRzIGFuZCBleGl0cy4KZGlmZiAtLWdpdCBhL2RyaXZl cnMvcGNpL2hvdHBsdWcvcGNpZWhwLmggYi9kcml2ZXJzL3BjaS9ob3RwbHVnL3BjaWVocC5oCmlu ZGV4IDRmZDIwMGQ4YjBhOS4uYWI1N2MxMWFhNThhIDEwMDY0NAotLS0gYS9kcml2ZXJzL3BjaS9o b3RwbHVnL3BjaWVocC5oCisrKyBiL2RyaXZlcnMvcGNpL2hvdHBsdWcvcGNpZWhwLmgKQEAgLTQ3 LDYgKzQ3LDkgQEAgZXh0ZXJuIGludCBwY2llaHBfcG9sbF90aW1lOwogICogc3RydWN0IGNvbnRy b2xsZXIgLSBQQ0llIGhvdHBsdWcgY29udHJvbGxlcgogICogQHBjaWU6IHBvaW50ZXIgdG8gdGhl IGNvbnRyb2xsZXIncyBQQ0llIHBvcnQgc2VydmljZSBkZXZpY2UKICAqIEBzbG90X2NhcDogY2Fj aGVkIGNvcHkgb2YgdGhlIFNsb3QgQ2FwYWJpbGl0aWVzIHJlZ2lzdGVyCisgKiBAaW5iYW5kX3By ZXNlbmNlX2Rpc2FibGVkOiB3aGV0aGVyIEluLUJhbmQgUHJlc2VuY2UgRGV0ZWN0IERpc2FibGUg aXMKKyAqIHN1cHBvcnRlZCBieSB0aGUgY29udHJvbGxlciBhbmQgZGlzYWJsZWQgcGVyIHNwZWMg cmVjb21tZW5kYXRpb24KKyAqIChQQ0llIHI1LjAsIGFwcGVuZGl4IEkgaW1wbGVtZW50YXRpb24g bm90ZSkKICAqIEBzbG90X2N0cmw6IGNhY2hlZCBjb3B5IG9mIHRoZSBTbG90IENvbnRyb2wgcmVn aXN0ZXIKICAqIEBjdHJsX2xvY2s6IHNlcmlhbGl6ZXMgd3JpdGVzIHRvIHRoZSBTbG90IENvbnRy b2wgcmVnaXN0ZXIKICAqIEBjbWRfc3RhcnRlZDogamlmZmllcyB3aGVuIHRoZSBTbG90IENvbnRy b2wgcmVnaXN0ZXIgd2FzIGxhc3Qgd3JpdHRlbjsKZGlmZiAtLWdpdCBhL2luY2x1ZGUvbGludXgv cGNpX2hvdHBsdWcuaCBiL2luY2x1ZGUvbGludXgvcGNpX2hvdHBsdWcuaAppbmRleCBiNDgyZTQy ZDcxNTMuLjJkYWM0MzFkOTRhYyAxMDA2NDQKLS0tIGEvaW5jbHVkZS9saW51eC9wY2lfaG90cGx1 Zy5oCisrKyBiL2luY2x1ZGUvbGludXgvcGNpX2hvdHBsdWcuaApAQCAtNTAsNiArNTAsOCBAQCBz dHJ1Y3QgaG90cGx1Z19zbG90X29wcyB7CiAvKioKICAqIHN0cnVjdCBob3RwbHVnX3Nsb3QgLSB1 c2VkIHRvIHJlZ2lzdGVyIGEgcGh5c2ljYWwgc2xvdCB3aXRoIHRoZSBob3RwbHVnIHBjaSBjb3Jl CiAgKiBAb3BzOiBwb2ludGVyIHRvIHRoZSAmc3RydWN0IGhvdHBsdWdfc2xvdF9vcHMgdG8gYmUg dXNlZCBmb3IgdGhpcyBzbG90CisgKiBAc2xvdF9saXN0OiBpbnRlcm5hbCBsaXN0IHVzZWQgdG8g dHJhY2sgaG90cGx1ZyBQQ0kgc2xvdHMKKyAqIEBwY2lfc2xvdDogcmVwcmVzZW50cyBhIHBoeXNp Y2FsIHNsb3QKICAqIEBvd25lcjogVGhlIG1vZHVsZSBvd25lciBvZiB0aGlzIHN0cnVjdHVyZQog ICogQG1vZF9uYW1lOiBUaGUgbW9kdWxlIG5hbWUgKEtCVUlMRF9NT0ROQU1FKSBvZiB0aGlzIHN0 cnVjdHVyZQogICovCi0tIAoyLjMyLjAKCgpfX19fX19fX19fX19fX19fX19fX19fX19fX19fX19f X19fX19fX19fX19fX19fXwpsaW51eC1hcm0ta2VybmVsIG1haWxpbmcgbGlzdApsaW51eC1hcm0t a2VybmVsQGxpc3RzLmluZnJhZGVhZC5vcmcKaHR0cDovL2xpc3RzLmluZnJhZGVhZC5vcmcvbWFp bG1hbi9saXN0aW5mby9saW51eC1hcm0ta2VybmVsCg==