netdev - [PATCH net-next v1 2/2] Documentation: ABI: document MDIO bus debugfs files

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [<thread-prev] [thread-next>] [day] [month] [year] [list]

Message-Id: <20200714142213.21365-2-marek.behun@nic.cz>
Date:   Tue, 14 Jul 2020 16:22:13 +0200
From:   Marek Behún <marek.behun@....cz>
To:     netdev@...r.kernel.org
Cc:     Russell King <linux@...linux.org.uk>,
        "David S . Miller" <davem@...emloft.net>,
        Andrew Lunn <andrew@...n.ch>,
        Marek Behún <marek.behun@....cz>
Subject: [PATCH net-next v1 2/2] Documentation: ABI: document MDIO bus debugfs files

This adds the documentation for debugfs files residing in
/sys/kernel/debug/mdio_bus. These files are created when
CONFIG_MDIO_BUS_DEBUGFS option is enabled.

Signed-off-by: Marek Behún <marek.behun@....cz>
---
 Documentation/ABI/testing/debugfs-mdio_bus | 29 ++++++++++++++++++++++
 1 file changed, 29 insertions(+)
 create mode 100644 Documentation/ABI/testing/debugfs-mdio_bus

diff --git a/Documentation/ABI/testing/debugfs-mdio_bus b/Documentation/ABI/testing/debugfs-mdio_bus
new file mode 100644
index 000000000000..4cd60869c896
--- /dev/null
+++ b/Documentation/ABI/testing/debugfs-mdio_bus
@@ -0,0 +1,29 @@
+What:		/sys/kernel/debug/mdio_bus/<MDIO_BUS>/addr
+Date:		July 2020
+KernelVersion:	5.9
+Contact:	Marek Behún <marek.behun@....cz>
+Description:	(RW) Address of the PHY device on the MDIO bus which should be
+		read from/written to when accessing the "val" file in this
+		directory.
+		Format: %u
+
+What:		/sys/kernel/debug/mdio_bus/<MDIO_BUS>/reg
+Date:		July 2020
+KernelVersion:	5.9
+Contact:	Marek Behún <marek.behun@....cz>
+Description:	(RW) Register number of the PHY device selected by the "addr"
+		file in this directory, which should be read from/written to
+		when accessing the "val" file in this directory.
+		To access Clause 45 register do a bitwise or with MII_ADDR_C45
+		(=0x40000000).
+		Format: %u
+
+What:		/sys/kernel/debug/mdio_bus/<MDIO_BUS>/val
+Date:		July 2020
+KernelVersion:	5.9
+Contact:	Marek Behún <marek.behun@....cz>
+Description:	(RW) Value of the register specified by the "reg" file of the
+		PHY device specified by the "addr" file in this directory.
+		Reading/writing this file calls directly function
+		mdiobus_read/mdiobus_write with arguments from these files.
+		Format: 0x%04x
-- 
2.26.2