From patchwork Tue Feb 13 18:54:10 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Aishwarya Pant X-Patchwork-Id: 10217309 X-Patchwork-Delegate: rjw@sisk.pl Return-Path: Received: from mail.wl.linuxfoundation.org (pdx-wl-mail.web.codeaurora.org [172.30.200.125]) by pdx-korg-patchwork.web.codeaurora.org (Postfix) with ESMTP id C9078601C2 for ; Tue, 13 Feb 2018 18:54:34 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id B863C28D33 for ; Tue, 13 Feb 2018 18:54:34 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id AD00928D92; Tue, 13 Feb 2018 18:54:34 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on pdx-wl-mail.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-6.8 required=2.0 tests=BAYES_00, DKIM_ADSP_CUSTOM_MED, DKIM_SIGNED,FREEMAIL_FROM,RCVD_IN_DNSWL_HI,T_DKIM_INVALID autolearn=unavailable version=3.3.1 Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 616AF28D33 for ; Tue, 13 Feb 2018 18:54:34 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S965610AbeBMSyU (ORCPT ); Tue, 13 Feb 2018 13:54:20 -0500 Received: from mail-it0-f65.google.com ([209.85.214.65]:55397 "EHLO mail-it0-f65.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S965598AbeBMSyR (ORCPT ); Tue, 13 Feb 2018 13:54:17 -0500 Received: by mail-it0-f65.google.com with SMTP id b66so12306072itd.5; Tue, 13 Feb 2018 10:54:16 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=date:from:to:cc:subject:message-id:mime-version:content-disposition :content-transfer-encoding:user-agent; bh=rsg17EXKjztZT7jzMlPl0xLfdwVXGTjmW2yYpmTB9MI=; b=uTBiyvIuGaRi7XeDs8EwD32A8LDJGxe29HzTZX31x5Q/+LCb4gS1agpAIYwzbCg4hg THTjrRgUtVfQ3nzRSSqjIHRu0hJt0qRt/RfmbDpYg+7AwiaTm2seds/SVBhY2E3I4pXr DQ6uWgKwW4R9MQH14pwvftTN3xSDXe6psmPp4fnr6EMYpgIwj7bJLmfWWPB3aaugIt4M 0hFkbGG6ZHnU+fgYLQp6JOLV0O14aE1w3TVDBJ2AZYOzSpOUzr0fgRDPhilM80bJ1pWH Tmh0/7n+rxqJXpQAZuf1oB88s+jDwyMXgMJIho8zaCL5QbgIEKrDzFbSdSszdj/43QHX y08Q== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:date:from:to:cc:subject:message-id:mime-version :content-disposition:content-transfer-encoding:user-agent; bh=rsg17EXKjztZT7jzMlPl0xLfdwVXGTjmW2yYpmTB9MI=; b=BpIWiW5MIGTlcDffD+i3AWOcNvlGAIuZGk/6AlpVsU3oomLVEESa9si6DBBCoaRmnV urgKOiN8Pnl3wwsuU7GBvqBgGwjOZ9HLwweZvfRru0H2K2oeFBuVuLP0ZgtlMwl9qImJ +D/XfyHdWHBZa3eFY3frfnBO0ocX8InZqmwon3b96C0DtQGbl9piwCvh6MeesdQ9wWMr l0ZZ26vvUIWSYQdlgd2ZaSP20mS7aTP/PMqaVrNSmTe2K9sb64WbK19G6Oc0l4PjGtDI jpuIqozIHJU99iAW0Qul/bzMHIkLHdhkrR+8vkH4c/y7fjIVwzgWOv+O1vgYrcn0+2Mt eT1g== X-Gm-Message-State: APf1xPDHoSOBy53ugrqh2BGTKCIHkTPf17MaX+uvvs+1AqehdujzIIJV evZXkwZqcSFlxKaw3Xzn7PI= X-Google-Smtp-Source: AH8x224hZOeearA1J38fPELT1V8sEXPByJKj0U1LIXSdkf7usHrYiYJa/iqQS6FwFytKYNZa6pc70A== X-Received: by 10.36.81.85 with SMTP id s82mr3018243ita.75.1518548056070; Tue, 13 Feb 2018 10:54:16 -0800 (PST) Received: from mordor.localdomain ([49.205.217.191]) by smtp.gmail.com with ESMTPSA id b3sm6189645itc.35.2018.02.13.10.54.13 (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256); Tue, 13 Feb 2018 10:54:15 -0800 (PST) Date: Wed, 14 Feb 2018 00:24:10 +0530 From: Aishwarya Pant To: "Rafael J. Wysocki" , Len Brown , linux-acpi@vger.kernel.org, linux-kernel@vger.kernel.org, Jonathan Corbet , Greg KH Cc: Julia Lawall Subject: [PATCH] acpi: device_sysfs: update sysfs documentation Message-ID: <20180213185410.GA27234@mordor.localdomain> MIME-Version: 1.0 Content-Disposition: inline User-Agent: Mutt/1.9.3 (2018-01-21) Sender: linux-acpi-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-acpi@vger.kernel.org X-Virus-Scanned: ClamAV using ClamSMTP Add documentation for two attributes - status and hrv in Documentation/ABI/testing/sysfs-bus-acpi. Compiled from git logs and the ACPI specification. Signed-off-by: Aishwarya Pant --- Documentation/ABI/testing/sysfs-bus-acpi | 36 ++++++++++++++++++++++++++++++++ 1 file changed, 36 insertions(+) diff --git a/Documentation/ABI/testing/sysfs-bus-acpi b/Documentation/ABI/testing/sysfs-bus-acpi index 7fa9cbc75344..89feb01d1d0d 100644 --- a/Documentation/ABI/testing/sysfs-bus-acpi +++ b/Documentation/ABI/testing/sysfs-bus-acpi @@ -56,3 +56,39 @@ Description: Writing 1 to this attribute will trigger hot removal of this device object. This file exists for every device object that has _EJ0 method. + +What: /sys/bus/acpi/devices/.../status +Date: Jan, 2014 +Contact: Rafael J. Wysocki +Description: + (RO) Displays the ACPI device status - enabled, disabled or + functioning or present, if the method _STA is present. + + Return value is an integer containing a device status bitmap: + + Bit [0] – Set if the device is present. + Bit [1] – Set if the device is enabled and decoding its + resources. + Bit [2] – Set if the device should be shown in the UI. + Bit [3] – Set if the device is functioning properly (cleared if + device failed its diagnostics). + Bit [4] – Set if the battery is present. + Bits [31:5] – Reserved (must be cleared) + + If bit [0] is cleared, then bit 1 must also be cleared (a device + that is not present cannot be enabled). + + Bit 0 can be clear (not present) with bit [3] set (device is + functional). This case is used to indicate a valid device for + which no device driver should be loaded. + + More special cases are covered in the ACPI specification. + +What: /sys/bus/acpi/devices/.../hrv +Date: Apr, 2016 +Contact: Rafael J. Wysocki +Description: + (RO) Allows users to read the hardware version of non-PCI + hardware, if the _HRV control method is present. It is most + useful for non-PCI devices because lspci can list the hardware + version for PCI devices.