瀏覽代碼

tty: docs: serial/tty, add to ldisc methods

A small addition to the ldisc method descriptions.

Signed-off-by: Tilman Schmidt <tilman@imap.cc>
Signed-off-by: Randy Dunlap <randy.dunlap@oracle.com>
Acked-by: Alan Cox <alan@linux.intel.com>
Signed-off-by: Greg Kroah-Hartman <gregkh@suse.de>
Tilman Schmidt 15 年之前
父節點
當前提交
7e11a0fb3b
共有 1 個文件被更改,包括 7 次插入2 次删除
  1. 7 2
      Documentation/serial/tty.txt

+ 7 - 2
Documentation/serial/tty.txt

@@ -42,7 +42,8 @@ TTY side interfaces:
 open()		-	Called when the line discipline is attached to
 open()		-	Called when the line discipline is attached to
 			the terminal. No other call into the line
 			the terminal. No other call into the line
 			discipline for this tty will occur until it
 			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
 close()		-	This is called on a terminal when the line
 			discipline is being unplugged. At the point of
 			discipline is being unplugged. At the point of
@@ -52,7 +53,7 @@ close()		-	This is called on a terminal when the line
 hangup()	-	Called when the tty line is hung up.
 hangup()	-	Called when the tty line is hung up.
 			The line discipline should cease I/O to the tty.
 			The line discipline should cease I/O to the tty.
 			No further calls into the ldisc code will occur.
 			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
 write()		-	A process is writing data through the line
 			discipline.  Multiple write calls are serialized
 			discipline.  Multiple write calls are serialized
@@ -83,6 +84,10 @@ ioctl()		-	Called when an ioctl is handed to the tty layer
 			that might be for the ldisc. Multiple ioctl calls
 			that might be for the ldisc. Multiple ioctl calls
 			may occur in parallel. May sleep. 
 			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:
 Driver Side Interfaces:
 
 
 receive_buf()	-	Hand buffers of bytes from the driver to the ldisc
 receive_buf()	-	Hand buffers of bytes from the driver to the ldisc