aboutsummaryrefslogtreecommitdiffstats
path: root/include/linux/tty.h
diff options
context:
space:
mode:
authorPeter Hurley <peter@hurleysoftware.com>2013-06-15 09:14:15 -0400
committerGreg Kroah-Hartman <gregkh@linuxfoundation.org>2013-07-23 19:42:59 -0400
commit24a89d1cb69b6c488cf16d98dd02e7820f62b40c (patch)
treee09745de8a63d9d8039495ed8b9bb79fbb334702 /include/linux/tty.h
parentda261e7fe7b0e23a0d4d46039d20dc60fa197b49 (diff)
tty: Make ldisc input flow control concurrency-friendly
Although line discipline receiving is single-producer/single-consumer, using tty->receive_room to manage flow control creates unnecessary critical regions requiring additional lock use. Instead, introduce the optional .receive_buf2() ldisc method which returns the # of bytes actually received. Serialization is guaranteed by the caller. In turn, the line discipline should schedule the buffer work item whenever space becomes available; ie., when there is room to receive data and receive_room() previously returned 0 (the buffer work item stops processing if receive_buf2() returns 0). Note the 'no room' state need not be atomic despite concurrent use by two threads because only the buffer work thread can set the state and only the read() thread can clear the state. Add n_tty_receive_buf2() as the receive_buf2() method for N_TTY. Provide a public helper function, tty_ldisc_receive_buf(), to use when directly accessing the receive_buf() methods. Line disciplines not using input flow control can continue to set tty->receive_room to a fixed value and only provide the receive_buf() method. Signed-off-by: Peter Hurley <peter@hurleysoftware.com> Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
Diffstat (limited to 'include/linux/tty.h')
-rw-r--r--include/linux/tty.h13
1 files changed, 13 insertions, 0 deletions
diff --git a/include/linux/tty.h b/include/linux/tty.h
index 7269daf7632b..8323ee4f95b9 100644
--- a/include/linux/tty.h
+++ b/include/linux/tty.h
@@ -557,6 +557,19 @@ extern void tty_ldisc_init(struct tty_struct *tty);
557extern void tty_ldisc_deinit(struct tty_struct *tty); 557extern void tty_ldisc_deinit(struct tty_struct *tty);
558extern void tty_ldisc_begin(void); 558extern void tty_ldisc_begin(void);
559 559
560static inline int tty_ldisc_receive_buf(struct tty_ldisc *ld, unsigned char *p,
561 char *f, int count)
562{
563 if (ld->ops->receive_buf2)
564 count = ld->ops->receive_buf2(ld->tty, p, f, count);
565 else {
566 count = min_t(int, count, ld->tty->receive_room);
567 if (count)
568 ld->ops->receive_buf(ld->tty, p, f, count);
569 }
570 return count;
571}
572
560 573
561/* n_tty.c */ 574/* n_tty.c */
562extern struct tty_ldisc_ops tty_ldisc_N_TTY; 575extern struct tty_ldisc_ops tty_ldisc_N_TTY;