Received: by 2002:a05:7412:cfc7:b0:fc:a2b0:25d7 with SMTP id by7csp1087285rdb; Mon, 19 Feb 2024 04:03:51 -0800 (PST) X-Forwarded-Encrypted: i=3; AJvYcCXbweHgDFo4NopO1uPfbhK3c8H8zDdgZfbtaGtvVBHij69lkptasRU4xlQ/Umfb/eRQ/9VdBYxf9zvY7HziaUuHdV+SUYb8msZSP1iesA== X-Google-Smtp-Source: AGHT+IHxjCI0K/DHBF3lIYXki724epN4mhwhtRSd3Fw3hTB7zYwTxBJ6sISDDudYD4/QxiDRZenM X-Received: by 2002:a05:6a00:10c3:b0:6dd:d1fa:ff17 with SMTP id d3-20020a056a0010c300b006ddd1faff17mr14831826pfu.32.1708344231473; Mon, 19 Feb 2024 04:03:51 -0800 (PST) ARC-Seal: i=2; a=rsa-sha256; t=1708344231; cv=pass; d=google.com; s=arc-20160816; b=UGvvSoCSEMxd9429OB9sInwKTjqKt3WGmhcwaDSF1aLT+Oc3rk4L30lS64EfwqhYa8 WcIJHy+Wh7W9MawfebakFC1wsv42mxj6R4ovGn969CVw4KzYnSXWMLJ4bk/fXtTc1RB6 UJI/7HhBobt8ZAU+ao1Xx8o/Ch7t4sFDoaHQ0j/FivvxphQcx+Ptzt2cmOG63CRixLMS qpwzVExRz6kiLQ5jWLWs5J5Q63N3HrV9gsKMpCK4h1wnQ9kS5lw4Ct4d/kfwpvjJAuNG pur6fj4+dXnQnT1cjSTxZ4zXoCvY+0tdRau+BTTxO5SbhrJQweiXRFAAEz46cKdHtFNL IcmA== ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=ui-outboundreport:content-transfer-encoding:mime-version :list-unsubscribe:list-subscribe:list-id:precedence:references :in-reply-to:message-id:date:subject:cc:to:from:dkim-signature; bh=qHfzr9Z6AbrLnleJ2vRO1YVBS5jWB6XYcpAOq7kcFsM=; fh=53tDE54uAbGWTgaegrI/oOrsTh38Ao2IXD0IrA5mCUE=; b=cQn4Gksfwn6PTfucqzc+92j26dR80hWRbe9TNZ2vN3tJISJeUSLiDWRImpesN5RH+1 onzBGA+FVR+LRWIxiSKhwaVS4v/2854WxB0l0AjWq8W94zPfAIpz8F25wfvcnYdjJGqv mYpoxKDkSyB6jxotoIF9N43RBtcN30MNr+6B/jui8BDENC8/xVLuQXArwvjqm1k7Hl+T ojT/Ni5iriMVKlVPoZMBkUG7FrkeYD6+mpmrMtSg361YocBjMkYsXP2gMLv0U/uNG7h7 lnGjCIKBeMyeE8uXcyTkRol1KnH29nvhPKTjdRSJFbG6TI6JxAM27LRZL4pwVwixX5lQ fWoQ==; dara=google.com ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@gmx.de header.s=s31663417 header.b=EmTgCLO2; arc=pass (i=1 spf=pass spfdomain=gmx.de dkim=pass dkdomain=gmx.de dmarc=pass fromdomain=gmx.de); spf=pass (google.com: domain of linux-kernel+bounces-71266-linux.lists.archive=gmail.com@vger.kernel.org designates 139.178.88.99 as permitted sender) smtp.mailfrom="linux-kernel+bounces-71266-linux.lists.archive=gmail.com@vger.kernel.org"; dmarc=pass (p=QUARANTINE sp=QUARANTINE dis=NONE) header.from=gmx.de Return-Path: Received: from sv.mirrors.kernel.org (sv.mirrors.kernel.org. [139.178.88.99]) by mx.google.com with ESMTPS id ka3-20020a056a00938300b006e3eda25108si2840711pfb.321.2024.02.19.04.03.51 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 19 Feb 2024 04:03:51 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel+bounces-71266-linux.lists.archive=gmail.com@vger.kernel.org designates 139.178.88.99 as permitted sender) client-ip=139.178.88.99; Authentication-Results: mx.google.com; dkim=pass header.i=@gmx.de header.s=s31663417 header.b=EmTgCLO2; arc=pass (i=1 spf=pass spfdomain=gmx.de dkim=pass dkdomain=gmx.de dmarc=pass fromdomain=gmx.de); spf=pass (google.com: domain of linux-kernel+bounces-71266-linux.lists.archive=gmail.com@vger.kernel.org designates 139.178.88.99 as permitted sender) smtp.mailfrom="linux-kernel+bounces-71266-linux.lists.archive=gmail.com@vger.kernel.org"; dmarc=pass (p=QUARANTINE sp=QUARANTINE dis=NONE) header.from=gmx.de Received: from smtp.subspace.kernel.org (wormhole.subspace.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by sv.mirrors.kernel.org (Postfix) with ESMTPS id 6502D283A4C for ; Mon, 19 Feb 2024 12:00:31 +0000 (UTC) Received: from localhost.localdomain (localhost.localdomain [127.0.0.1]) by smtp.subspace.kernel.org (Postfix) with ESMTP id B54BB31A89; Mon, 19 Feb 2024 11:59:43 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmx.de header.i=w_armin@gmx.de header.b="EmTgCLO2" Received: from mout.gmx.net (mout.gmx.net [212.227.17.20]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id C614B2E405; Mon, 19 Feb 2024 11:59:40 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=212.227.17.20 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1708343982; cv=none; b=hmA4X9xA/50UX0vQ0si7+IyIuCPOhRV1WD7kLSHklRxDdCkAbJ/ZW3sI8/pjnST30tQrvGVobobTHcHylnvBsuW7dcvXYO8mnjrw8FUGvrXX4ZguW97JfqpOM3GXrOaLQyMvPz9faQ4CQ3PbuAQqyZTqAYP4F4UuBewS0dKNDos= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1708343982; c=relaxed/simple; bh=qHfzr9Z6AbrLnleJ2vRO1YVBS5jWB6XYcpAOq7kcFsM=; h=From:To:Cc:Subject:Date:Message-Id:In-Reply-To:References: MIME-Version; b=N7nr46yG16C1YEDo5GqpdVXMYp0iG4YPiAPV219dydC6doPCtlbGuUSqCGtyED//KcXmCJaWa8ZewthdAYokoJSL8n+DIDALtXYTd04OmQexkswD6VW8wGaYRvQA1H318RKGxSAAzLY7hDiAPHcyJKuXbbYfUHZKWXQI4cqdSi0= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=quarantine dis=none) header.from=gmx.de; spf=pass smtp.mailfrom=gmx.de; dkim=pass (2048-bit key) header.d=gmx.de header.i=w_armin@gmx.de header.b=EmTgCLO2; arc=none smtp.client-ip=212.227.17.20 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=quarantine dis=none) header.from=gmx.de Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmx.de DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=gmx.de; s=s31663417; t=1708343971; x=1708948771; i=w_armin@gmx.de; bh=qHfzr9Z6AbrLnleJ2vRO1YVBS5jWB6XYcpAOq7kcFsM=; h=X-UI-Sender-Class:From:To:Cc:Subject:Date:In-Reply-To: References; b=EmTgCLO2wSkDlsTcGb7KzGMNJBIjQJA7HdTi8wQZlcl2x2ZlyWZHqh2nTRE+9nHa duLFAjlPMpSnAz5eT5XKuHKOKB2oyXADJ2cQxPSGvDCSkkb74fGOyE7MOVADf/Jmm r3K3sb6MBkW6lfA5xlP8cTRXYHR7KbD3At/wmM9/6X3zXHFthYAcPDlBOP6xd1vKd oQlCeEw+tztsFCHcFavp1AMJa4wh+SjGRNPByzdcl+5Tfblf6QmQ0neEa9h+8lVR1 S/JqGwY0YANiJ5b3UrrDpFHEywR3/nW5erG6dDdQfnkyi7oMkufdfuDV/JnYTn/60 HQFG15unTEhPPlyy1w== X-UI-Sender-Class: 724b4f7f-cbec-4199-ad4e-598c01a50d3a Received: from mx-amd-b650.users.agdsn.de ([141.30.226.129]) by mail.gmx.net (mrgmx104 [212.227.17.168]) with ESMTPSA (Nemesis) id 1N17UQ-1qvnXl2og6-012XiL; Mon, 19 Feb 2024 12:59:31 +0100 From: Armin Wolf To: corentin.chary@gmail.com, luke@ljones.dev Cc: hdegoede@redhat.com, ilpo.jarvinen@linux.intel.com, platform-driver-x86@vger.kernel.org, linux-kernel@vger.kernel.org Subject: [PATCH v2 4/5] platform/x86: wmi: Update documentation regarding _WED Date: Mon, 19 Feb 2024 12:59:18 +0100 Message-Id: <20240219115919.16526-5-W_Armin@gmx.de> X-Mailer: git-send-email 2.39.2 In-Reply-To: <20240219115919.16526-1-W_Armin@gmx.de> References: <20240219115919.16526-1-W_Armin@gmx.de> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-Provags-ID: V03:K1:HVa15Z2LrHiydE7egWuwmvdECI1Tv1ZQ4wpN3HEd4/nYZH066wW 6rSrrp1W7tjcnHIFkdtKe1fK1O2U0hrxiukCjwvvFX5RsyR742wCAH81sE/atj1I+FtCWG8 5pCq3lvrnfiGk1QzXXaPl8b0MaZqe+uhXBz4R6AugdZixXijUl1v37OCbLAfFGUnIrvvEyJ Ier5ZaABptv+RqAwnD0MA== X-Spam-Flag: NO UI-OutboundReport: notjunk:1;M01:P0:hkUeSe5q1/k=;jg/Rfqe6pDRd5XWkin84hm86CfJ /EHlUVVNaQOTFfJTVPcgDK9MYH7yLhR5n/H3Ho6et9/euvbQNBq0op72oMmyxmcNnzyWJ9afE EcP8mUtazAH3WAtCT75dpP47HHHtb31VKQY/2qfeflVIYYXIZ8CiL1wp2Uxyz1E/uCIH8YqhT fK0L/vm2Nzxm7Qben1bwMMBeuFrMQcf09eQ1c6IwpOxY9PGjk58kd2mMGx0JZS5nYhtFnnEIX hfGNLAZQkc5nsI6qXKIEoyG79DmAcg0ZPsFeQw0yg1l/Og/iKcAFGRHePQjpuqZBrE+0XWIYE i5MueCxE5mkB6VXZG1lFxPOClRZc0dmcn0k84TQPe2NMvcdi8/72jKjjHejsVoB2RtVlqO13N gxF6jCpKQ07h9zsqwQtpjyR34eDE+J2dAkfiJFT/cgc9LCJbIJ5RbjpPSIn+yYgGeFy3eo2J1 mpDdwgleJ+UMYcZ3bpiYqmmQdEANFn+SIoP8gEm+bWgBa2GAKlj13sALw2wsgiMDUpE3ajI+o iqw+kqxqV8P0Jm3+1NW+tzm0ru1Gmnf//Kk65z1n4pOMSOOwIYB65DGr5mDbk0KZqSq3uGx/e Sy7vOSJIHm1MNF+UFNsMUAnnNP1ORM4zLozedPKJ9yf9ZVnNKSQeSEvRHXvrLyzOR9BpdPtm3 X/eGU1aXTEqZlRmzi47nEJIE1OJv7npeY3tnM2uYXl7uRExbZF0uPkqzW5bsGgm7SpHDHNPgl Tg5sES+L3JJo/KhfEX38MkQYxIXSNTR6weuvsLOHgst9DeP5z4RjNn/Q8DnHB9EPUxMG9OQrd heqt/6eMzvqpuNriGw8jgIF0RbZrGELSeG1atJspnRDac= Update the WMI ACPI interface documentation to include the fact that _WED should be evaluated every time an ACPI notification is received. Signed-off-by: Armin Wolf =2D-- Documentation/wmi/acpi-interface.rst | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/Documentation/wmi/acpi-interface.rst b/Documentation/wmi/acpi= -interface.rst index d31af0ed9c08..06fb7fcf4413 100644 =2D-- a/Documentation/wmi/acpi-interface.rst +++ b/Documentation/wmi/acpi-interface.rst @@ -93,4 +93,7 @@ _WED ACPI method ---------------- Used to retrieve additional WMI event data, its single parameter is a int= eger -holding the notification ID of the event. +holding the notification ID of the event. This method should be evaluated= every +time an ACPI notification is received, since some ACPI implementations us= e a +queue to store WMI event data items. This queue will overflow after a cou= ple +of WMI events are received without retrieving the associated WMI event da= ta. =2D- 2.39.2