From: Andrew Jeffery <andrew@aj.id.au>
To: linux-kernel@vger.kernel.org
Cc: Andrew Jeffery <andrew@aj.id.au>,
robh+dt@kernel.org, mark.rutland@arm.com, joel@jms.id.au,
gregkh@linuxfoundation.org, Eugene.Cho@dell.com,
a.amelkin@yadro.com, stewart@linux.ibm.com,
benh@kernel.crashing.org, openbmc@lists.ozlabs.org,
devicetree@vger.kernel.org, linux-arm-kernel@lists.infradead.org
Subject: [RFC PATCH 2/4] Documentation: ABI: Add sysfs-class-bmc documentation to testing
Date: Tue, 3 Jul 2018 17:04:11 +1000 [thread overview]
Message-ID: <20180703070413.28756-3-andrew@aj.id.au> (raw)
In-Reply-To: <20180703070413.28756-1-andrew@aj.id.au>
Signed-off-by: Andrew Jeffery <andrew@aj.id.au>
---
Documentation/ABI/testing/sysfs-class-bmc | 62 +++++++++++++++++++++++
1 file changed, 62 insertions(+)
create mode 100644 Documentation/ABI/testing/sysfs-class-bmc
diff --git a/Documentation/ABI/testing/sysfs-class-bmc b/Documentation/ABI/testing/sysfs-class-bmc
new file mode 100644
index 000000000000..9d42106b89f9
--- /dev/null
+++ b/Documentation/ABI/testing/sysfs-class-bmc
@@ -0,0 +1,62 @@
+This document defines the sysfs attributes common to the bmc device class. See
+Documentation/devicetree/bindings/misc/bmc-misc-ctrl.txt for exhaustive list of
+field definitions.
+
+What: /sys/class/bmc/<field>/label
+Date: July, 2018
+KernelVersion: v4.19
+Contact: openbmc@lists.ozlabs.org
+Description:
+ The name of the field of interest. Corresponds to the value of
+ <field> in the path
+Users: openbmc@lists.ozlabs.org
+
+What: /sys/class/bmc/<field>/value
+Date: July, 2018
+KernelVersion: v4.19
+Contact: openbmc@lists.ozlabs.org
+Description:
+ The value of the field of interest.
+
+ If the field is exposed from a read-modify-write register this
+ attribute will be RW, where writes will set the field to the
+ value written. Writing values that exceed the width of the
+ field will return an error.
+
+ If the field is exposed from a write-1-set/write-1-clear
+ register this attribute will be RO, and the attributes 'set'
+ and 'clear' will be present as write-only.
+Users: openbmc@lists.ozlabs.org
+
+What: /sys/class/bmc/<field>/mask
+Date: July, 2018
+KernelVersion: v4.19
+Contact: openbmc@lists.ozlabs.org
+Description:
+ The mask applied to the value read/written from the 'value'
+ attribute.
+Users: openbmc@lists.ozlabs.org
+
+What: /sys/class/bmc/<field>/set
+Users: openbmc@lists.ozlabs.org
+Date: July, 2018
+KernelVersion: v4.19
+Contact: openbmc@lists.ozlabs.org
+Description:
+ For fields backed by write-1-set/write-1-clear registers,
+ set bits in the value written will be set in hardware. Zero
+ values are ignored. Writing values that exceed the width of the
+ mask value will return an error.
+Users: openbmc@lists.ozlabs.org
+
+What: /sys/class/bmc/<field>/clear
+Users: openbmc@lists.ozlabs.org
+Date: July, 2018
+KernelVersion: v4.19
+Contact: openbmc@lists.ozlabs.org
+Description:
+ For fields backed by write-1-set/write-1-clear registers,
+ set bits in the value written will be cleared in hardware. Zero
+ values are ignored. Writing values that exceed the width of the
+ mask value will return an error.
+Users: openbmc@lists.ozlabs.org
--
2.17.1
next prev parent reply other threads:[~2018-07-03 7:04 UTC|newest]
Thread overview: 16+ messages / expand[flat|nested] mbox.gz Atom feed top
2018-07-03 7:04 [RFC PATCH 0/4] sysfs interface to miscellaneous BMC controls and fields Andrew Jeffery
2018-07-03 7:04 ` [RFC PATCH 1/4] dts: misc: Add bindings documentation for bmc-misc-ctrl Andrew Jeffery
2018-07-03 7:50 ` Greg KH
2018-07-03 14:16 ` Benjamin Herrenschmidt
2018-07-03 14:31 ` Greg KH
2018-07-03 15:39 ` Benjamin Herrenschmidt
2018-07-04 6:28 ` Andrew Jeffery
2018-07-03 7:04 ` Andrew Jeffery [this message]
2018-07-03 7:50 ` [RFC PATCH 2/4] Documentation: ABI: Add sysfs-class-bmc documentation to testing Greg KH
2018-07-04 6:29 ` Andrew Jeffery
2018-07-03 7:04 ` [RFC PATCH 3/4] misc: Add bmc-misc-ctrl Andrew Jeffery
2018-07-03 7:54 ` Greg KH
2018-07-04 7:18 ` Andrew Jeffery
2018-07-03 7:04 ` [RFC PATCH 4/4] dts: aspeed-g5: Add bmc-misc-ctrl nodes to devicetree Andrew Jeffery
2018-07-03 7:54 ` Greg KH
2018-07-04 6:29 ` Andrew Jeffery
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20180703070413.28756-3-andrew@aj.id.au \
--to=andrew@aj.id.au \
--cc=Eugene.Cho@dell.com \
--cc=a.amelkin@yadro.com \
--cc=benh@kernel.crashing.org \
--cc=devicetree@vger.kernel.org \
--cc=gregkh@linuxfoundation.org \
--cc=joel@jms.id.au \
--cc=linux-arm-kernel@lists.infradead.org \
--cc=linux-kernel@vger.kernel.org \
--cc=mark.rutland@arm.com \
--cc=openbmc@lists.ozlabs.org \
--cc=robh+dt@kernel.org \
--cc=stewart@linux.ibm.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).