linux-kernel - [PATCH v2 3/4] tty: documentation: abi: add ttyvs null modem driver sysfs nodes

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]

Date:   Sat, 15 Feb 2020 23:21:08 +0530
From:   Rishi Gupta <gupt21@...il.com>
To:     gregkh@...uxfoundation.org, robh+dt@...nel.org
Cc:     jslaby@...e.com, linux-serial@...r.kernel.org,
        linux-kernel@...r.kernel.org, Rishi Gupta <gupt21@...il.com>
Subject: [PATCH v2 3/4] tty: documentation: abi: add ttyvs null modem driver sysfs nodes

The ttyvs driver exposes sysfs file called event to emulate
various serial port events. This commit document this file.
User space application writes various codes to this file.

Signed-off-by: Rishi Gupta <gupt21@...il.com>
---
Changes in v2:
- Updated path to /sys/class/tty/ttyvsN/event
- Used Documentation/ABI/testing/sysfs-tty, previously new file was created

 Documentation/ABI/testing/sysfs-tty | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/Documentation/ABI/testing/sysfs-tty b/Documentation/ABI/testing/sysfs-tty
index 9eb3c2b..c6002c5 100644
--- a/Documentation/ABI/testing/sysfs-tty
+++ b/Documentation/ABI/testing/sysfs-tty
@@ -154,3 +154,18 @@ Description:
 		 device specification. For example, when user sets 7bytes on
 		 16550A, which has 1/4/8/14 bytes trigger, the RX trigger is
 		 automatically changed to 4 bytes.
+
+What:		/sys/class/tty/ttyvsN/event
+Date:		February 2020
+Contact:	Rishi Gupta <gupt21@...il.com>
+Description:
+		The ttyvs driver will emulate serial port event; parity error,
+		framing error, overrun error, asserting/de-asserting break
+		condition and ring indication when user space application
+		writes an event code on this sysfs file.
+
+		Write 1 to emulate framing error, write 2 for parity error,
+		write 3 for overrun error, write 4 to set ring indication,
+		write 5 to clear ring indication, write 6 to emulate a break
+		condition detected, write 7 to emulate a faulty cable and
+		write 8 to remove faulty cable condition.
-- 
2.7.4