From patchwork Thu Apr 20 23:32:24 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Armin Wolf X-Patchwork-Id: 86093 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a59:b0ea:0:b0:3b6:4342:cba0 with SMTP id b10csp693048vqo; Thu, 20 Apr 2023 16:41:30 -0700 (PDT) X-Google-Smtp-Source: AKy350bYHg3IBpDb23uzofyRklYgf2fNRanDTrHnigkNmT4J6h0dVrrleX33kRxowaNc3Ab/xgbs X-Received: by 2002:a17:902:d50f:b0:19e:b6b0:6b3 with SMTP id b15-20020a170902d50f00b0019eb6b006b3mr3765620plg.15.1682034090627; Thu, 20 Apr 2023 16:41:30 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1682034090; cv=none; d=google.com; s=arc-20160816; b=jbnw5lk5+RElowfPHzQjuOz6d28HA9yX9Poqn4XVYI/nbf88WTeWQCOivJ4PMe+Y/0 Ptd6TR1jJOn7PTC7yGzAD2LIBpQZUE85WjxZRa/0wLlW/nP+2sNrQ2RBFW8vcoA+hOzX rDaoXeSKxlkQC1JfMVNjfjnQnxdR0xUtcMu48leNsmCaXrxspJODzxIl4RYb3LpXvSP5 VibAzbuqZoiRYuRqJjbazPf+i6Etgg1dHLOkVYQAkPQNcAQBuA9ACEo6L+cb7WkqNy9C ra4yi9mgwAQbiegZUmTI5rPKR71tExuou57mWYMqnSNTbj0z/mz3SS89lB+mvYx/0UM4 t6vg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:ui-outboundreport:content-transfer-encoding :mime-version:references:in-reply-to:message-id:date:subject:cc:to :from:dkim-signature; bh=UCSxNiqLzk6k+R9JuBBXWEt+gpk7Q0GoHEthkz1iPNY=; b=R0nWYwHrjbpqIHF+tIZpH69sLNTjS+kfPuvgNIGb8Puyav0Rrtgn//czB0XqLVUWCl s6bgT/d40s/CsydAU7MD1/uPHSOopbH9MweChFAZcAEhlaC1+gOx+2USh+WsMuT4fpjX +zlvfkXEcKU2/Bjlp9otLUcx+dnwidXH4QsLsLqV7YDKI7UF0f9cMEeKxj/yB0mt6VPU vW1DDkLrcme4OBH7Z0Es1tlqaWoWgXelWpkeZA+4Yj3yUrLXAmp97l8w5kOtjsKXtfUb PCYbcRg744pazDJjcNhIFBEKUp1eMTknJ5o4+NmgZwDpixrGG06Zl5kDzVxlj332+C0z MR1w== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@gmx.de header.s=s31663417 header.b=c0dstfSu; 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=gmx.de Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id cm1-20020a17090afa0100b002343565e8b4si5472304pjb.122.2023.04.20.16.41.15; Thu, 20 Apr 2023 16:41:30 -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=@gmx.de header.s=s31663417 header.b=c0dstfSu; 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=gmx.de Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S233209AbjDTXcu (ORCPT + 99 others); Thu, 20 Apr 2023 19:32:50 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:59896 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S233140AbjDTXcp (ORCPT ); Thu, 20 Apr 2023 19:32:45 -0400 Received: from mout.gmx.net (mout.gmx.net [212.227.17.22]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id C919A2107; Thu, 20 Apr 2023 16:32:43 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=gmx.de; s=s31663417; t=1682033553; i=w_armin@gmx.de; bh=lBlH3Nqi1jLnfe9btNEPKUJFG01pfHUJIbiEyZ5yxSg=; h=X-UI-Sender-Class:From:To:Cc:Subject:Date:In-Reply-To:References; b=c0dstfSuk4NeeOx1PQgcJfY3VxSaByKAjVTuitnvV7nedovVGBsyMaBwQY9IyEK27 h+OGdS0ZxNRM4etWsP43VE7yOXII5jn/u7+r1gSDGZOCRjdPZJx/ptBFn0xP1nL0qm xDbqlY3tTIUMphz2X8x+/BEPcKgen5zMy3jl96LLvaC8ewdoGDhIE/JtysdB/o1YDr dRIKVo5+rRq9NfOQ2ccWvvgR6SfgCHuC48GlE4VubTFCf1EvNCOZkBcelCqtbLhXEF R3rSWckSE+Ocd0Rhg+BQHqDUhWhPb26qswwlc5GPEi/ZfUo80+tevfBbT2oXF26mhG urlWuqKHdFeJA== X-UI-Sender-Class: 724b4f7f-cbec-4199-ad4e-598c01a50d3a Received: from esprimo-mx.users.agdsn.de ([141.30.226.129]) by mail.gmx.net (mrgmx105 [212.227.17.168]) with ESMTPSA (Nemesis) id 1MyKHc-1qEkG43U20-00yisi; Fri, 21 Apr 2023 01:32:32 +0200 From: Armin Wolf To: hdegoede@redhat.com, markgross@kernel.org Cc: corbet@lwn.net, linux-doc@vger.kernel.org, platform-driver-x86@vger.kernel.org, linux-kernel@vger.kernel.org Subject: [PATCH 2/4] platform/x86: wmi: Mark GUID-based WMI interface as deprecated Date: Fri, 21 Apr 2023 01:32:24 +0200 Message-Id: <20230420233226.14561-3-W_Armin@gmx.de> X-Mailer: git-send-email 2.30.2 In-Reply-To: <20230420233226.14561-1-W_Armin@gmx.de> References: <20230420233226.14561-1-W_Armin@gmx.de> MIME-Version: 1.0 X-Provags-ID: V03:K1:RBUmnkT160ZlZvaFUSraNtW7l69Wx+0qemSgMJs8biaVxgGN68p QpYwBC6DA0o1Bk64jCsHOAhMTjQBgNJfAtQG+Oc/CmMA3lOXJUEenEZKhPySv9V4FVRgBul D04LYeET509qXW/AAHJj/+uEIPZNrDeyeWeJWDj+E6Jzk4vkUZSQhoU008oqqsvMkhc56wr Pm1o81a3rv2yenqpngztQ== UI-OutboundReport: notjunk:1;M01:P0:RXLP46U4J1w=;7sV2VB/mGCtehhbbtZGn6u/bpZB t2MXkbH+SeKrLEFhQQOnBHLHhgxokCerpiHsVA/nVnpRtxvn3/eDRcD2QNKbK9IylMUdTco1d lhxfcfQet5dbWKJT8F/FB8p0cyFtXt+oMPqXZ+0J+bP+yiaU32iKv+Fgqsrh1WFqF5ygTp9pw QcoGJC6L15EKqDR9TZFVDjDNvmqpAI9xBD5whtc8F8HjJ81MsxHFA9sfRx8XgmOUewiKE6jwo /VofFt2T5DfJNqJVsb0Gr8ZWqW9c+/2TAWWqid5e7X28VEjK5POx8adrpFecHZXpLCV7aOYuS OfKfX5JB3yW86UK191Ymb24OJAuvasjaeeO+CX6GdZEe8vstoMnWikoYYjzVKGA5iVFL1SXS5 EN2K4b86YGqFLaDIwuZlywaTspP6bedWG8zPcKXeqxpVo9h5KuI3cZ7T4sqQLwS/M9zFfBhJz Bos+S1dYnupyVzHRnbpItGUCCdAKsc7Fa1QfC7iajLfsQizTvS/Y8k2msy8QsSshm1lKmbdxX N5ZtPW5rnfR91/XYgq5UIXwUOnruVS93lCreoT0eyrLOaL9InjvBeHqn068iPfb7kjmtsdVGp yISmA7KiaiXQ/GxQaoTVlDWuSsRbZRIsEsPAFNuOCQ4rJOcmm4cITKiHV9MV4qaIACDtyucyO mrSS2LmxrePUEEMQ9jcQta7U9Zbk8KGQWG+G1KyB5WxOFS8j5Wf038twQ/0IN3yXTFX5dHcHF 4HgFxiknS5SdaY8ZJ7UAemW2XsYQKtUBpn6wdJFaez7O7iDP72a54IsypfxnkMOuQrBF4FcMP zz9UsSRHC1gpKynDKZ1UTZDH84V0czT3+9npeMm9MJCva/2d4mv8lQJ0fKfgX4O0dA1sfqbFb i95iMat9+cDY9Hn5H9XBS1Yj7tmgD2IUDmQXuUlVId3znyIqC8mh6kIrMedYDQFKzTVdSf9zl MZRnnFMkAQH+WlpaqGTz6SsB13Y= X-Spam-Status: No, score=-2.8 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,FREEMAIL_FROM,RCVD_IN_DNSWL_LOW, RCVD_IN_MSPIKE_H2,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 X-getmail-retrieved-from-mailbox: =?utf-8?q?INBOX?= X-GMAIL-THRID: =?utf-8?q?1763740578523818770?= X-GMAIL-MSGID: =?utf-8?q?1763740578523818770?= The WMI driver core supports a more mordern bus-based interface for interacting with WMI devices. The older GUID-based interface depends on each WMI GUID and notification id being unique on a given system, which turned out is not the case. Mark the older interface as deprecated since new WMI drivers should use the bus-based interface to avoid this issues. Signed-off-by: Armin Wolf --- drivers/platform/x86/wmi.c | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) -- 2.30.2 diff --git a/drivers/platform/x86/wmi.c b/drivers/platform/x86/wmi.c index e4b41dca70c7..ae654487718e 100644 --- a/drivers/platform/x86/wmi.c +++ b/drivers/platform/x86/wmi.c @@ -264,7 +264,7 @@ int set_required_buffer_size(struct wmi_device *wdev, u64 length) EXPORT_SYMBOL_GPL(set_required_buffer_size); /** - * wmi_evaluate_method - Evaluate a WMI method + * wmi_evaluate_method - Evaluate a WMI method (deprecated) * @guid_string: 36 char string of the form fa50ff2b-f2e8-45de-83fa-65417f2f49ba * @instance: Instance index * @method_id: Method ID to call @@ -457,7 +457,7 @@ union acpi_object *wmidev_block_query(struct wmi_device *wdev, u8 instance) EXPORT_SYMBOL_GPL(wmidev_block_query); /** - * wmi_set_block - Write to a WMI block + * wmi_set_block - Write to a WMI block (deprecated) * @guid_string: 36 char string of the form fa50ff2b-f2e8-45de-83fa-65417f2f49ba * @instance: Instance index * @in: Buffer containing new values for the data block @@ -568,7 +568,7 @@ static void wmi_notify_debug(u32 value, void *context) } /** - * wmi_install_notify_handler - Register handler for WMI events + * wmi_install_notify_handler - Register handler for WMI events (deprecated) * @guid: 36 char string of the form fa50ff2b-f2e8-45de-83fa-65417f2f49ba * @handler: Function to handle notifications * @data: Data to be returned to handler when event is fired @@ -614,7 +614,7 @@ acpi_status wmi_install_notify_handler(const char *guid, EXPORT_SYMBOL_GPL(wmi_install_notify_handler); /** - * wmi_remove_notify_handler - Unregister handler for WMI events + * wmi_remove_notify_handler - Unregister handler for WMI events (deprecated) * @guid: 36 char string of the form fa50ff2b-f2e8-45de-83fa-65417f2f49ba * * Unregister handler for events sent to the ACPI-WMI mapper device. @@ -661,7 +661,7 @@ acpi_status wmi_remove_notify_handler(const char *guid) EXPORT_SYMBOL_GPL(wmi_remove_notify_handler); /** - * wmi_get_event_data - Get WMI data associated with an event + * wmi_get_event_data - Get WMI data associated with an event (deprecated) * * @event: Event to find * @out: Buffer to hold event data @@ -700,7 +700,7 @@ bool wmi_has_guid(const char *guid_string) EXPORT_SYMBOL_GPL(wmi_has_guid); /** - * wmi_get_acpi_device_uid() - Get _UID name of ACPI device that defines GUID + * wmi_get_acpi_device_uid() - Get _UID name of ACPI device that defines GUID (deprecated) * @guid_string: 36 char string of the form fa50ff2b-f2e8-45de-83fa-65417f2f49ba * * Find the _UID of ACPI device associated with this WMI GUID.