Skip to contentSkip to conversation

kill TTY_DONT_FLIP

RFC PATCH In review Paul Fulghum 2 participants 3 messages Jun 22, 2006 – Jun 23, 2006

Subsystems (6)
lore
Share & tools
lore
#0 lore raw

RFC PATCH 1/1 kill TTY_DONT_FLIP

Kill TTY_DONT_FLIP flag, which is set in n_tty read_chan(). This flag is only used by the N_TTY line discipline. It was added in the 2.1.X development series. Its original purpose seems to be protecting the N_TTY read buffer state (tty->read_tail, etc) from conflicting access by read_chan (reads from N_TTY read buffer) and the flip buffer code (writes to N_TTY read buffer via n_tty_receive_buf).

The spin lock tty->read_lock was subsequently added to protect the N_TTY read buffer. After reviewing the tty code, I see no other state that is protected by TTY_DONT_FLIP.

The current implementation of TTY_DONT_FLIP does not ensure mutual exclusion of the code in question on
an SMP machine. Some drivers which feed the line discipline directly do not honor this flag anyways and contain comments like 'FIXME: what to do with TTY_DONT_FLIP?'

My understanding is that TTY_DONT_FLIP is a leftover currently serving no useful purpose and should be eliminated as in this patch. I've been running the patch on an SMP machine while exercising multiple serial ports with no problems.

include/linux/tty.h +0 -1
@@ -260,7 +260,6 @@ struct tty_struct {
 #define TTY_DO_WRITE_WAKEUP 	5	/* Call write_wakeup after queuing new */
 #define TTY_PUSH 		6	/* n_tty private */
 #define TTY_CLOSING 		7	/* ->close() in progress */
-#define TTY_DONT_FLIP 		8	/* Defer buffer flip */
 #define TTY_LDISC 		9	/* Line discipline attached */
 #define TTY_HW_COOK_OUT 	14	/* Hardware can do output cooking */
 #define TTY_HW_COOK_IN 		15	/* Hardware can do input cooking */
drivers/char/n_tty.c +1 -5
@@ -1132,7 +1132,7 @@ static inline int input_available_p(stru
  *	buffer, and once to drain the space from the (physical) beginning of
  *	the buffer to head pointer.
  *
- *	Called under the tty->atomic_read_lock sem and with TTY_DONT_FLIP set
+ *	Called under the tty->atomic_read_lock sem
  *
  */
  
@@ -1271,7 +1271,6 @@ do_it_again:
 	}
 
 	add_wait_queue(&tty->read_wait, &wait);
-	set_bit(TTY_DONT_FLIP, &tty->flags);
 	while (nr) {
 		/* First test for status change. */
 		if (tty->packet && tty->link->ctrl_status) {
@@ -1315,9 +1314,7 @@ do_it_again:
 				break;
 			}
 			n_tty_set_room(tty);
-			clear_bit(TTY_DONT_FLIP, &tty->flags);
 			timeout = schedule_timeout(timeout);
-			set_bit(TTY_DONT_FLIP, &tty->flags);
 			continue;
 		}
 		__set_current_state(TASK_RUNNING);
@@ -1394,7 +1391,6 @@ do_it_again:
 		if (time)
 			timeout = time;
 	}
-	clear_bit(TTY_DONT_FLIP, &tty->flags);
 	mutex_unlock(&tty->atomic_read_lock);
 	remove_wait_queue(&tty->read_wait, &wait);
 
drivers/char/tty_io.c +2 -13
@@ -784,11 +784,8 @@ restart:
 	}
 
 	clear_bit(TTY_LDISC, &tty->flags);
-	clear_bit(TTY_DONT_FLIP, &tty->flags);
-	if (o_tty) {
+	if (o_tty)
 		clear_bit(TTY_LDISC, &o_tty->flags);
-		clear_bit(TTY_DONT_FLIP, &o_tty->flags);
-	}
 	spin_unlock_irqrestore(&tty_ldisc_lock, flags);
 
 	/*
@@ -1955,7 +1952,6 @@ static void release_dev(struct file * fi
 	 * race with the set_ldisc code path.
 	 */
 	clear_bit(TTY_LDISC, &tty->flags);
-	clear_bit(TTY_DONT_FLIP, &tty->flags);
 	cancel_delayed_work(&tty->buf.work);
 
 	/*
@@ -2785,13 +2781,6 @@ static void flush_to_ldisc(void *private
 	if (disc == NULL)	/*  !TTY_LDISC */
 		return;
 
-	if (test_bit(TTY_DONT_FLIP, &tty->flags)) {
-		/*
-		 * Do it after the next timer tick:
-		 */
-		schedule_delayed_work(&tty->buf.work, 1);
-		goto out;
-	}
 	spin_lock_irqsave(&tty->buf.lock, flags);
 	while((tbuf = tty->buf.head) != NULL) {
 		while ((count = tbuf->commit - tbuf->read) != 0) {
@@ -2810,7 +2799,7 @@ static void flush_to_ldisc(void *private
 		tty_buffer_free(tty, tbuf);
 	}
 	spin_unlock_irqrestore(&tty->buf.lock, flags);
-out:
+
 	tty_ldisc_deref(disc);
 }
 
drivers/char/pty.c +1 -1
@@ -101,7 +101,7 @@ static void pty_unthrottle(struct tty_st
  *
  * FIXME: Our pty_write method is called with our ldisc lock held but
  * not our partners. We can't just take the other one blindly without
- * risking deadlocks.  There is also the small matter of TTY_DONT_FLIP
+ * risking deadlocks.
  */
 static int pty_write(struct tty_struct * tty, const unsigned char *buf, int count)
 {
drivers/char/mxser.c +0 -1
@@ -953,7 +953,6 @@ static int mxser_open(struct tty_struct 
 
 	info->session = current->signal->session;
 	info->pgrp = process_group(current);
-	clear_bit(TTY_DONT_FLIP, &tty->flags);
 
 	//status = mxser_get_msr(info->base, 0, info->port);
 	//mxser_check_modem_status(info, status);
drivers/serial/crisv10.c +0 -6
@@ -2573,12 +2573,6 @@ static void flush_to_flip_buffer(struct 
 
 	DFLIP(
 	  if (1) {
-
-		  if (test_bit(TTY_DONT_FLIP, &tty->flags)) {
-			  DEBUG_LOG(info->line, "*** TTY_DONT_FLIP set flip.count %i ***\n", tty->flip.count);
-			  DEBUG_LOG(info->line, "*** recv_cnt %i\n", info->recv_cnt);
-		  } else {
-		  }
 		  DEBUG_LOG(info->line, "*** rxtot %i\n", info->icount.rx);
 		  DEBUG_LOG(info->line, "ldisc %lu\n", tty->ldisc.chars_in_buffer(tty));
 		  DEBUG_LOG(info->line, "room  %lu\n", tty->ldisc.receive_room(tty));
drivers/serial/jsm/jsm_tty.c +0 -7
@@ -589,13 +589,6 @@ void jsm_input(struct jsm_channel *ch)
 	ld = tty_ldisc_ref(tp);
 
 	/*
-	 * If the DONT_FLIP flag is on, don't flush our buffer, and act
-	 * like the ld doesn't have any space to put the data right now.
-	 */
-	if (test_bit(TTY_DONT_FLIP, &tp->flags))
-		len = 0;
-
-	/*
 	 * If we were unable to get a reference to the ld,
 	 * don't flush our buffer, and act like the ld doesn't
 	 * have any space to put the data right now.
drivers/usb/serial/ir-usb.c +1 -2
@@ -453,8 +453,7 @@ static void ir_read_bulk_callback (struc
 			tty = port->tty;
 
 			/*
-			 *	FIXME: must not do this in IRQ context,
-			 *	must honour TTY_DONT_FLIP
+			 *	FIXME: must not do this in IRQ context
 			 */
 			tty->ldisc.receive_buf(
 				tty,
net/bluetooth/rfcomm/tty.c +2 -6
@@ -480,12 +480,8 @@ static void rfcomm_dev_data_ready(struct
 
 	BT_DBG("dlc %p tty %p len %d", dlc, tty, skb->len);
 
-	if (test_bit(TTY_DONT_FLIP, &tty->flags)) {
-		tty_buffer_request_room(tty, skb->len);
-		tty_insert_flip_string(tty, skb->data, skb->len);
-		tty_flip_buffer_push(tty);
-	} else
-		tty->ldisc.receive_buf(tty, skb->data, NULL, skb->len);
+	tty_insert_flip_string(tty, skb->data, skb->len);
+	tty_flip_buffer_push(tty);
 
 	kfree_skb(skb);
 }
#1 lore raw

Ar Iau, 2006-06-22 am 14:02 -0500, ysgrifennodd Paul Fulghum:

Quoted 8 lines

Kill TTY_DONT_FLIP flag, which is set in n_tty read_chan(). This flag is only used by the N_TTY line discipline. It was added in the 2.1.X development series. Its original purpose seems to be protecting the N_TTY read buffer state (tty->read_tail, etc) from conflicting access by read_chan (reads from N_TTY read buffer) and the flip buffer code (writes to N_TTY read buffer via n_tty_receive_buf).

Quoted 4 lines

The spin lock tty->read_lock was subsequently added to protect the N_TTY read buffer. After reviewing the tty code, I see no other state that is protected by TTY_DONT_FLIP.

Looks good to me on a first review.

Alan

#2 lore raw
Quoted 1 line · Alan Cox

Looks good to me on a first review.

I looked at the paths taken by n_tty_receive_buf() for how they would effect read_chan():

* tty state (put_tty_queue,eraser,finish_erasing,etc)
* read wakeups
* start_tty/stop_tty
* put_char/opost

everything looks OK without TTY_DONT_FLIP

2.0.X relied on the BKL (and dinosaurs roamed the Earth)

2.1.X introduced TTY_DONT_FLIP to prevent read_chan and n_tty_receive_buf from executing at the same time.

2.2.15 added tty->read_lock around the N_TTY read buffer, which is the only thing needing protection in this context.

The usual progression to finer grained locking. This looks like a safe removal.

The review also revealed a spot in reset_buffer_flags() where tty->read_lock needs to be extended around modifications of canon_head, canon_data, and read_flags. I'll make a patch for that.

Signature · 2 lines
Paul Fulghum
Microgate Systems, Ltd.