From patchwork Wed Jul 11 05:31:20 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Andrew Jeffery X-Patchwork-Id: 10518803 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 6F1196032C for ; Wed, 11 Jul 2018 05:32:34 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 5E08E28E93 for ; Wed, 11 Jul 2018 05:32:34 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 51B5C28EB8; Wed, 11 Jul 2018 05:32: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=-2.9 required=2.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,MAILING_LIST_MULTI autolearn=unavailable version=3.3.1 Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) (using TLSv1.2 with cipher AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.wl.linuxfoundation.org (Postfix) with ESMTPS id D1C7028E93 for ; Wed, 11 Jul 2018 05:32:33 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=bombadil.20170209; h=Sender: Content-Transfer-Encoding:Content-Type:MIME-Version:Cc:List-Subscribe: List-Help:List-Post:List-Archive:List-Unsubscribe:List-Id:References: In-Reply-To:Message-Id:Date:Subject:To:From:Reply-To:Content-ID: Content-Description:Resent-Date:Resent-From:Resent-Sender:Resent-To:Resent-Cc :Resent-Message-ID:List-Owner; bh=fMrBrw5eGRAcJEhL3xJZQM565uKxeo6/UIfIwKsFZ1Q=; b=eNKfwd8Px713WLPOz+VVjVfDJO xleivPuyAWj3tkrvPwUVzolezBnQYSSBb1iJjkARdllFaCeyRyVh/3CiLf73oPtBcn6FiB/40gkxM rxhBY4q5P6VqUevDLzvrXjZ5h+MRY1VQ7MsmRYc++gFyFXPZYXnQxxHdqRUAhq7RoYZ1iWv12hm3J fjpfAItOY3Ll3B4M66fpOw/5ulN9QraDtQj7sfVYB5W6z4MWiFsea3tkAwwG6H9skwQofAaNJeKNo hCHAFOtj9kEwrrl+aVJyvKWIOfQzMt0kQCE6Z9ynhae3EAxFwok63ajcurTKAEJXW4WYE8ufc/fcF kIsSxICQ==; Received: from localhost ([127.0.0.1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.90_1 #2 (Red Hat Linux)) id 1fd7jr-0003cJ-74; Wed, 11 Jul 2018 05:32:31 +0000 Received: from out1-smtp.messagingengine.com ([66.111.4.25]) by bombadil.infradead.org with esmtps (Exim 4.90_1 #2 (Red Hat Linux)) id 1fd7jn-0003Zs-2D for linux-arm-kernel@lists.infradead.org; Wed, 11 Jul 2018 05:32:28 +0000 Received: from compute4.internal (compute4.nyi.internal [10.202.2.44]) by mailout.nyi.internal (Postfix) with ESMTP id 013E621BBE; Wed, 11 Jul 2018 01:32:21 -0400 (EDT) Received: from mailfrontend1 ([10.202.2.162]) by compute4.internal (MEProxy); Wed, 11 Jul 2018 01:32:21 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=aj.id.au; h=cc :date:from:in-reply-to:message-id:references:subject:to :x-me-sender:x-me-sender:x-sasl-enc; s=fm3; bh=OMzzKkzvJhU26U+FL wTI6IoolzQTUk0Pg5+SGKYtbdc=; b=gUcOAmON0FQS70uL3J+CzNCeu+9Jd8u+y q/jjf19ZQn3xvUb8M61l7wam5suPOYENWhK8XiVf4tSVfKfvm7d4kVsCAl1YFfOO Rx6t9uvxss2VeqxX4+QUwrTFR1weJ/qD4bqEWHOGLQsE7Jv7RJvto6hG5VgnT4Sd 24KFtIJeSMDXkmTmrAqhCYPf5bMY+GHT/sWoYpIZruBvFpA9xEvvr2hHVvOAK7Hl iInKOrRqe4+SLLw2lPUAZ23nSu4KKRZXmVnGWjQyzHm15UJKgOwM61ywxZbVyE+L WH6t+ycTJWWs3MH2QQ7g9SR4iLWzyfjbLwKBOLu39rBX8P58RUBuQ== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:date:from:in-reply-to:message-id :references:subject:to:x-me-sender:x-me-sender:x-sasl-enc; s= fm3; bh=OMzzKkzvJhU26U+FLwTI6IoolzQTUk0Pg5+SGKYtbdc=; b=b/9yt1yh +IH+pV/x/MNuiYfIwf6maGjUhmm8lds6OQstb1KCgCMh5xVpeN5tKHGtCpeRD6xv wI1XV6hHF4Q/umKO2E2p64q2pX8/lpI6O8nUlnmo1uCdizTt8T4FiSQDga/JFxQ3 R4yXCLdiGG4Azi5GRgaHiCYM/JBxHB5KVdPTwYondTFkk6bpO3qeJygINCsn34ga nrMq5DzOZH8XEEKZJ4qgfZfWUgEIf3WdlD0iaEV2CnGdroQZBHgDvMpWQt5r4/Sd xkzhG3rjHv/umFev4LF4TXIHyUQqj5eFBSHuSE5SryTsMUYV5amb2IiFW1OGBD1H qc/5QBAEjCyGyg== X-ME-Proxy: X-ME-Sender: Received: from localhost.localdomain (ppp118-210-173-37.bras2.adl6.internode.on.net [118.210.173.37]) by mail.messagingengine.com (Postfix) with ESMTPA id 604BDE45C9; Wed, 11 Jul 2018 01:32:16 -0400 (EDT) From: Andrew Jeffery To: linux-kernel@vger.kernel.org Subject: [RFC PATCH v2 2/4] Documentation: ABI: Add sysfs-devices-platform-field to testing Date: Wed, 11 Jul 2018 15:01:20 +0930 Message-Id: <20180711053122.30773-3-andrew@aj.id.au> X-Mailer: git-send-email 2.17.1 In-Reply-To: <20180711053122.30773-1-andrew@aj.id.au> References: <20180711053122.30773-1-andrew@aj.id.au> X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20180710_223227_279111_E7F64D9C X-CRM114-Status: GOOD ( 13.72 ) X-BeenThere: linux-arm-kernel@lists.infradead.org X-Mailman-Version: 2.1.21 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: mark.rutland@arm.com, devicetree@vger.kernel.org, Andrew Jeffery , gregkh@linuxfoundation.org, Eugene.Cho@dell.com, a.amelkin@yadro.com, robh+dt@kernel.org, joel@jms.id.au, stewart@linux.ibm.com, benh@kernel.crashing.org, openbmc@lists.ozlabs.org, linux-arm-kernel@lists.infradead.org MIME-Version: 1.0 Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+patchwork-linux-arm=patchwork.kernel.org@lists.infradead.org X-Virus-Scanned: ClamAV using ClamSMTP "Fields" expose control of hardware directly to userspace where appropriate. Examples of expected use are single bit switches or other small masks of registers where the range of values is entirely policy driven and the field is not part of a larger, coherent design. These fields can be from read-only, read-write or write-1-set/write-1-clear register sets. Using fields to control the behaviour of hardware local to the kernel exposing them is likely incorrect. The use-case motivating the fields feature is for Baseboard Management Controllers (BMCs) to expose policy controls for booting and running their host systems. Signed-off-by: Andrew Jeffery --- Since RFC v1: * Describe a 'type' attribute that determines the behaviour of the remaining attributes * Rework paths to point through /sys/devices/platform * Add a description to the commit message .../ABI/testing/sysfs-devices-platform-field | 95 +++++++++++++++++++ MAINTAINERS | 1 + 2 files changed, 96 insertions(+) create mode 100644 Documentation/ABI/testing/sysfs-devices-platform-field diff --git a/Documentation/ABI/testing/sysfs-devices-platform-field b/Documentation/ABI/testing/sysfs-devices-platform-field new file mode 100644 index 000000000000..216481d8bc99 --- /dev/null +++ b/Documentation/ABI/testing/sysfs-devices-platform-field @@ -0,0 +1,95 @@ +This document defines the sysfs attributes provided by the bmc-misc-ctrl +driver. See Documentation/devicetree/bindings/misc/bmc-misc-ctrl.txt for +exhaustive list of field definitions. + +What: /sys/devices/platform/...//