rdunlap at xenotime
Nov 4, 2009, 4:04 PM
Post #1 of 2
(30 views)
Permalink
|
|
[PATCH 7/8] docs: serial/tty, add to ldisc methods
|
|
From: Tilman Schmidt <tilman[at]imap.cc>
Subject: Doc: update serial/tty.txt ldisc methods
A small addition to the ldisc method descriptions.
Impact: Documentation
Signed-off-by: Tilman Schmidt <tilman[at]imap.cc>
Signed-off-by: Randy Dunlap <randy.dunlap[at]oracle.com>
Cc: Greg Kroah-Hartman <gregkh[at]suse.de>
---
Documentation/serial/tty.txt | 9 +++++++--
1 file changed, 7 insertions(+), 2 deletions(-)
--- lnx-2632-rc6.orig/Documentation/serial/tty.txt
+++ lnx-2632-rc6/Documentation/serial/tty.txt
@@ -42,7 +42,8 @@ TTY side interfaces:
open() - Called when the line discipline is attached to
the terminal. No other call into the line
discipline for this tty will occur until it
- completes successfully. Can sleep.
+ completes successfully. Returning an error will
+ prevent the ldisc from being attached. Can sleep.
close() - This is called on a terminal when the line
discipline is being unplugged. At the point of
@@ -52,7 +53,7 @@ close() - This is called on a terminal
hangup() - Called when the tty line is hung up.
The line discipline should cease I/O to the tty.
No further calls into the ldisc code will occur.
- Can sleep.
+ The return value is ignored. Can sleep.
write() - A process is writing data through the line
discipline. Multiple write calls are serialized
@@ -83,6 +84,10 @@ ioctl() - Called when an ioctl is hande
that might be for the ldisc. Multiple ioctl calls
may occur in parallel. May sleep.
+compat_ioctl() - Called when a 32 bit ioctl is handed to the tty layer
+ that might be for the ldisc. Multiple ioctl calls
+ may occur in parallel. May sleep.
+
Driver Side Interfaces:
receive_buf() - Hand buffers of bytes from the driver to the ldisc
--
--
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo[at]vger.kernel.org
More majordomo info at http://vger.kernel.org/majordomo-info.html
Please read the FAQ at http://www.tux.org/lkml/
|
