xref: /linux/drivers/tty/n_tty.c (revision dec1c62e91ba268ab2a6e339d4d7a59287d5eba1)
1 // SPDX-License-Identifier: GPL-1.0+
2 /*
3  * n_tty.c --- implements the N_TTY line discipline.
4  *
5  * This code used to be in tty_io.c, but things are getting hairy
6  * enough that it made sense to split things off.  (The N_TTY
7  * processing has changed so much that it's hardly recognizable,
8  * anyway...)
9  *
10  * Note that the open routine for N_TTY is guaranteed never to return
11  * an error.  This is because Linux will fall back to setting a line
12  * to N_TTY if it can not switch to any other line discipline.
13  *
14  * Written by Theodore Ts'o, Copyright 1994.
15  *
16  * This file also contains code originally written by Linus Torvalds,
17  * Copyright 1991, 1992, 1993, and by Julian Cowley, Copyright 1994.
18  *
19  * Reduced memory usage for older ARM systems  - Russell King.
20  *
21  * 2000/01/20   Fixed SMP locking on put_tty_queue using bits of
22  *		the patch by Andrew J. Kroll <ag784@freenet.buffalo.edu>
23  *		who actually finally proved there really was a race.
24  *
25  * 2002/03/18   Implemented n_tty_wakeup to send SIGIO POLL_OUTs to
26  *		waiting writing processes-Sapan Bhatia <sapan@corewars.org>.
27  *		Also fixed a bug in BLOCKING mode where n_tty_write returns
28  *		EAGAIN
29  */
30 
31 #include <linux/types.h>
32 #include <linux/major.h>
33 #include <linux/errno.h>
34 #include <linux/signal.h>
35 #include <linux/fcntl.h>
36 #include <linux/sched.h>
37 #include <linux/interrupt.h>
38 #include <linux/tty.h>
39 #include <linux/timer.h>
40 #include <linux/ctype.h>
41 #include <linux/mm.h>
42 #include <linux/string.h>
43 #include <linux/slab.h>
44 #include <linux/poll.h>
45 #include <linux/bitops.h>
46 #include <linux/audit.h>
47 #include <linux/file.h>
48 #include <linux/uaccess.h>
49 #include <linux/module.h>
50 #include <linux/ratelimit.h>
51 #include <linux/vmalloc.h>
52 #include "tty.h"
53 
54 /*
55  * Until this number of characters is queued in the xmit buffer, select will
56  * return "we have room for writes".
57  */
58 #define WAKEUP_CHARS 256
59 
60 /*
61  * This defines the low- and high-watermarks for throttling and
62  * unthrottling the TTY driver.  These watermarks are used for
63  * controlling the space in the read buffer.
64  */
65 #define TTY_THRESHOLD_THROTTLE		128 /* now based on remaining room */
66 #define TTY_THRESHOLD_UNTHROTTLE	128
67 
68 /*
69  * Special byte codes used in the echo buffer to represent operations
70  * or special handling of characters.  Bytes in the echo buffer that
71  * are not part of such special blocks are treated as normal character
72  * codes.
73  */
74 #define ECHO_OP_START 0xff
75 #define ECHO_OP_MOVE_BACK_COL 0x80
76 #define ECHO_OP_SET_CANON_COL 0x81
77 #define ECHO_OP_ERASE_TAB 0x82
78 
79 #define ECHO_COMMIT_WATERMARK	256
80 #define ECHO_BLOCK		256
81 #define ECHO_DISCARD_WATERMARK	N_TTY_BUF_SIZE - (ECHO_BLOCK + 32)
82 
83 
84 #undef N_TTY_TRACE
85 #ifdef N_TTY_TRACE
86 # define n_tty_trace(f, args...)	trace_printk(f, ##args)
87 #else
88 # define n_tty_trace(f, args...)	no_printk(f, ##args)
89 #endif
90 
91 struct n_tty_data {
92 	/* producer-published */
93 	size_t read_head;
94 	size_t commit_head;
95 	size_t canon_head;
96 	size_t echo_head;
97 	size_t echo_commit;
98 	size_t echo_mark;
99 	DECLARE_BITMAP(char_map, 256);
100 
101 	/* private to n_tty_receive_overrun (single-threaded) */
102 	unsigned long overrun_time;
103 	int num_overrun;
104 
105 	/* non-atomic */
106 	bool no_room;
107 
108 	/* must hold exclusive termios_rwsem to reset these */
109 	unsigned char lnext:1, erasing:1, raw:1, real_raw:1, icanon:1;
110 	unsigned char push:1;
111 
112 	/* shared by producer and consumer */
113 	char read_buf[N_TTY_BUF_SIZE];
114 	DECLARE_BITMAP(read_flags, N_TTY_BUF_SIZE);
115 	unsigned char echo_buf[N_TTY_BUF_SIZE];
116 
117 	/* consumer-published */
118 	size_t read_tail;
119 	size_t line_start;
120 
121 	/* protected by output lock */
122 	unsigned int column;
123 	unsigned int canon_column;
124 	size_t echo_tail;
125 
126 	struct mutex atomic_read_lock;
127 	struct mutex output_lock;
128 };
129 
130 #define MASK(x) ((x) & (N_TTY_BUF_SIZE - 1))
131 
132 static inline size_t read_cnt(struct n_tty_data *ldata)
133 {
134 	return ldata->read_head - ldata->read_tail;
135 }
136 
137 static inline unsigned char read_buf(struct n_tty_data *ldata, size_t i)
138 {
139 	return ldata->read_buf[i & (N_TTY_BUF_SIZE - 1)];
140 }
141 
142 static inline unsigned char *read_buf_addr(struct n_tty_data *ldata, size_t i)
143 {
144 	return &ldata->read_buf[i & (N_TTY_BUF_SIZE - 1)];
145 }
146 
147 static inline unsigned char echo_buf(struct n_tty_data *ldata, size_t i)
148 {
149 	smp_rmb(); /* Matches smp_wmb() in add_echo_byte(). */
150 	return ldata->echo_buf[i & (N_TTY_BUF_SIZE - 1)];
151 }
152 
153 static inline unsigned char *echo_buf_addr(struct n_tty_data *ldata, size_t i)
154 {
155 	return &ldata->echo_buf[i & (N_TTY_BUF_SIZE - 1)];
156 }
157 
158 /* If we are not echoing the data, perhaps this is a secret so erase it */
159 static void zero_buffer(struct tty_struct *tty, u8 *buffer, int size)
160 {
161 	bool icanon = !!L_ICANON(tty);
162 	bool no_echo = !L_ECHO(tty);
163 
164 	if (icanon && no_echo)
165 		memset(buffer, 0x00, size);
166 }
167 
168 static void tty_copy(struct tty_struct *tty, void *to, size_t tail, size_t n)
169 {
170 	struct n_tty_data *ldata = tty->disc_data;
171 	size_t size = N_TTY_BUF_SIZE - tail;
172 	void *from = read_buf_addr(ldata, tail);
173 
174 	if (n > size) {
175 		tty_audit_add_data(tty, from, size);
176 		memcpy(to, from, size);
177 		zero_buffer(tty, from, size);
178 		to += size;
179 		n -= size;
180 		from = ldata->read_buf;
181 	}
182 
183 	tty_audit_add_data(tty, from, n);
184 	memcpy(to, from, n);
185 	zero_buffer(tty, from, n);
186 }
187 
188 /**
189  * n_tty_kick_worker - start input worker (if required)
190  * @tty: terminal
191  *
192  * Re-schedules the flip buffer work if it may have stopped.
193  *
194  * Locking:
195  *  * Caller holds exclusive %termios_rwsem, or
196  *  * n_tty_read()/consumer path:
197  *	holds non-exclusive %termios_rwsem
198  */
199 static void n_tty_kick_worker(struct tty_struct *tty)
200 {
201 	struct n_tty_data *ldata = tty->disc_data;
202 
203 	/* Did the input worker stop? Restart it */
204 	if (unlikely(ldata->no_room)) {
205 		ldata->no_room = 0;
206 
207 		WARN_RATELIMIT(tty->port->itty == NULL,
208 				"scheduling with invalid itty\n");
209 		/* see if ldisc has been killed - if so, this means that
210 		 * even though the ldisc has been halted and ->buf.work
211 		 * cancelled, ->buf.work is about to be rescheduled
212 		 */
213 		WARN_RATELIMIT(test_bit(TTY_LDISC_HALTED, &tty->flags),
214 			       "scheduling buffer work for halted ldisc\n");
215 		tty_buffer_restart_work(tty->port);
216 	}
217 }
218 
219 static ssize_t chars_in_buffer(struct tty_struct *tty)
220 {
221 	struct n_tty_data *ldata = tty->disc_data;
222 	ssize_t n = 0;
223 
224 	if (!ldata->icanon)
225 		n = ldata->commit_head - ldata->read_tail;
226 	else
227 		n = ldata->canon_head - ldata->read_tail;
228 	return n;
229 }
230 
231 /**
232  * n_tty_write_wakeup	-	asynchronous I/O notifier
233  * @tty: tty device
234  *
235  * Required for the ptys, serial driver etc. since processes that attach
236  * themselves to the master and rely on ASYNC IO must be woken up.
237  */
238 static void n_tty_write_wakeup(struct tty_struct *tty)
239 {
240 	clear_bit(TTY_DO_WRITE_WAKEUP, &tty->flags);
241 	kill_fasync(&tty->fasync, SIGIO, POLL_OUT);
242 }
243 
244 static void n_tty_check_throttle(struct tty_struct *tty)
245 {
246 	struct n_tty_data *ldata = tty->disc_data;
247 
248 	/*
249 	 * Check the remaining room for the input canonicalization
250 	 * mode.  We don't want to throttle the driver if we're in
251 	 * canonical mode and don't have a newline yet!
252 	 */
253 	if (ldata->icanon && ldata->canon_head == ldata->read_tail)
254 		return;
255 
256 	while (1) {
257 		int throttled;
258 		tty_set_flow_change(tty, TTY_THROTTLE_SAFE);
259 		if (N_TTY_BUF_SIZE - read_cnt(ldata) >= TTY_THRESHOLD_THROTTLE)
260 			break;
261 		throttled = tty_throttle_safe(tty);
262 		if (!throttled)
263 			break;
264 	}
265 	__tty_set_flow_change(tty, 0);
266 }
267 
268 static void n_tty_check_unthrottle(struct tty_struct *tty)
269 {
270 	if (tty->driver->type == TTY_DRIVER_TYPE_PTY) {
271 		if (chars_in_buffer(tty) > TTY_THRESHOLD_UNTHROTTLE)
272 			return;
273 		n_tty_kick_worker(tty);
274 		tty_wakeup(tty->link);
275 		return;
276 	}
277 
278 	/* If there is enough space in the read buffer now, let the
279 	 * low-level driver know. We use chars_in_buffer() to
280 	 * check the buffer, as it now knows about canonical mode.
281 	 * Otherwise, if the driver is throttled and the line is
282 	 * longer than TTY_THRESHOLD_UNTHROTTLE in canonical mode,
283 	 * we won't get any more characters.
284 	 */
285 
286 	while (1) {
287 		int unthrottled;
288 		tty_set_flow_change(tty, TTY_UNTHROTTLE_SAFE);
289 		if (chars_in_buffer(tty) > TTY_THRESHOLD_UNTHROTTLE)
290 			break;
291 		n_tty_kick_worker(tty);
292 		unthrottled = tty_unthrottle_safe(tty);
293 		if (!unthrottled)
294 			break;
295 	}
296 	__tty_set_flow_change(tty, 0);
297 }
298 
299 /**
300  * put_tty_queue		-	add character to tty
301  * @c: character
302  * @ldata: n_tty data
303  *
304  * Add a character to the tty read_buf queue.
305  *
306  * Locking:
307  *  * n_tty_receive_buf()/producer path:
308  *	caller holds non-exclusive %termios_rwsem
309  */
310 static inline void put_tty_queue(unsigned char c, struct n_tty_data *ldata)
311 {
312 	*read_buf_addr(ldata, ldata->read_head) = c;
313 	ldata->read_head++;
314 }
315 
316 /**
317  * reset_buffer_flags	-	reset buffer state
318  * @ldata: line disc data to reset
319  *
320  * Reset the read buffer counters and clear the flags. Called from
321  * n_tty_open() and n_tty_flush_buffer().
322  *
323  * Locking:
324  *  * caller holds exclusive %termios_rwsem, or
325  *  * (locking is not required)
326  */
327 static void reset_buffer_flags(struct n_tty_data *ldata)
328 {
329 	ldata->read_head = ldata->canon_head = ldata->read_tail = 0;
330 	ldata->commit_head = 0;
331 	ldata->line_start = 0;
332 
333 	ldata->erasing = 0;
334 	bitmap_zero(ldata->read_flags, N_TTY_BUF_SIZE);
335 	ldata->push = 0;
336 }
337 
338 static void n_tty_packet_mode_flush(struct tty_struct *tty)
339 {
340 	unsigned long flags;
341 
342 	if (tty->link->ctrl.packet) {
343 		spin_lock_irqsave(&tty->ctrl.lock, flags);
344 		tty->ctrl.pktstatus |= TIOCPKT_FLUSHREAD;
345 		spin_unlock_irqrestore(&tty->ctrl.lock, flags);
346 		wake_up_interruptible(&tty->link->read_wait);
347 	}
348 }
349 
350 /**
351  * n_tty_flush_buffer	-	clean input queue
352  * @tty: terminal device
353  *
354  * Flush the input buffer. Called when the tty layer wants the buffer flushed
355  * (eg at hangup) or when the %N_TTY line discipline internally has to clean
356  * the pending queue (for example some signals).
357  *
358  * Holds %termios_rwsem to exclude producer/consumer while buffer indices are
359  * reset.
360  *
361  * Locking: %ctrl.lock, exclusive %termios_rwsem
362  */
363 static void n_tty_flush_buffer(struct tty_struct *tty)
364 {
365 	down_write(&tty->termios_rwsem);
366 	reset_buffer_flags(tty->disc_data);
367 	n_tty_kick_worker(tty);
368 
369 	if (tty->link)
370 		n_tty_packet_mode_flush(tty);
371 	up_write(&tty->termios_rwsem);
372 }
373 
374 /**
375  * is_utf8_continuation	-	utf8 multibyte check
376  * @c: byte to check
377  *
378  * Returns: true if the utf8 character @c is a multibyte continuation
379  * character. We use this to correctly compute the on-screen size of the
380  * character when printing.
381  */
382 static inline int is_utf8_continuation(unsigned char c)
383 {
384 	return (c & 0xc0) == 0x80;
385 }
386 
387 /**
388  * is_continuation	-	multibyte check
389  * @c: byte to check
390  * @tty: terminal device
391  *
392  * Returns: true if the utf8 character @c is a multibyte continuation character
393  * and the terminal is in unicode mode.
394  */
395 static inline int is_continuation(unsigned char c, struct tty_struct *tty)
396 {
397 	return I_IUTF8(tty) && is_utf8_continuation(c);
398 }
399 
400 /**
401  * do_output_char	-	output one character
402  * @c: character (or partial unicode symbol)
403  * @tty: terminal device
404  * @space: space available in tty driver write buffer
405  *
406  * This is a helper function that handles one output character (including
407  * special characters like TAB, CR, LF, etc.), doing OPOST processing and
408  * putting the results in the tty driver's write buffer.
409  *
410  * Note that Linux currently ignores TABDLY, CRDLY, VTDLY, FFDLY and NLDLY.
411  * They simply aren't relevant in the world today. If you ever need them, add
412  * them here.
413  *
414  * Returns: the number of bytes of buffer space used or -1 if no space left.
415  *
416  * Locking: should be called under the %output_lock to protect the column state
417  * and space left in the buffer.
418  */
419 static int do_output_char(unsigned char c, struct tty_struct *tty, int space)
420 {
421 	struct n_tty_data *ldata = tty->disc_data;
422 	int	spaces;
423 
424 	if (!space)
425 		return -1;
426 
427 	switch (c) {
428 	case '\n':
429 		if (O_ONLRET(tty))
430 			ldata->column = 0;
431 		if (O_ONLCR(tty)) {
432 			if (space < 2)
433 				return -1;
434 			ldata->canon_column = ldata->column = 0;
435 			tty->ops->write(tty, "\r\n", 2);
436 			return 2;
437 		}
438 		ldata->canon_column = ldata->column;
439 		break;
440 	case '\r':
441 		if (O_ONOCR(tty) && ldata->column == 0)
442 			return 0;
443 		if (O_OCRNL(tty)) {
444 			c = '\n';
445 			if (O_ONLRET(tty))
446 				ldata->canon_column = ldata->column = 0;
447 			break;
448 		}
449 		ldata->canon_column = ldata->column = 0;
450 		break;
451 	case '\t':
452 		spaces = 8 - (ldata->column & 7);
453 		if (O_TABDLY(tty) == XTABS) {
454 			if (space < spaces)
455 				return -1;
456 			ldata->column += spaces;
457 			tty->ops->write(tty, "        ", spaces);
458 			return spaces;
459 		}
460 		ldata->column += spaces;
461 		break;
462 	case '\b':
463 		if (ldata->column > 0)
464 			ldata->column--;
465 		break;
466 	default:
467 		if (!iscntrl(c)) {
468 			if (O_OLCUC(tty))
469 				c = toupper(c);
470 			if (!is_continuation(c, tty))
471 				ldata->column++;
472 		}
473 		break;
474 	}
475 
476 	tty_put_char(tty, c);
477 	return 1;
478 }
479 
480 /**
481  * process_output	-	output post processor
482  * @c: character (or partial unicode symbol)
483  * @tty: terminal device
484  *
485  * Output one character with OPOST processing.
486  *
487  * Returns: -1 when the output device is full and the character must be
488  * retried.
489  *
490  * Locking: %output_lock to protect column state and space left (also, this is
491  *called from n_tty_write() under the tty layer write lock).
492  */
493 static int process_output(unsigned char c, struct tty_struct *tty)
494 {
495 	struct n_tty_data *ldata = tty->disc_data;
496 	int	space, retval;
497 
498 	mutex_lock(&ldata->output_lock);
499 
500 	space = tty_write_room(tty);
501 	retval = do_output_char(c, tty, space);
502 
503 	mutex_unlock(&ldata->output_lock);
504 	if (retval < 0)
505 		return -1;
506 	else
507 		return 0;
508 }
509 
510 /**
511  * process_output_block	-	block post processor
512  * @tty: terminal device
513  * @buf: character buffer
514  * @nr: number of bytes to output
515  *
516  * Output a block of characters with OPOST processing.
517  *
518  * This path is used to speed up block console writes, among other things when
519  * processing blocks of output data. It handles only the simple cases normally
520  * found and helps to generate blocks of symbols for the console driver and
521  * thus improve performance.
522  *
523  * Returns: the number of characters output.
524  *
525  * Locking: %output_lock to protect column state and space left (also, this is
526  * called from n_tty_write() under the tty layer write lock).
527  */
528 static ssize_t process_output_block(struct tty_struct *tty,
529 				    const unsigned char *buf, unsigned int nr)
530 {
531 	struct n_tty_data *ldata = tty->disc_data;
532 	int	space;
533 	int	i;
534 	const unsigned char *cp;
535 
536 	mutex_lock(&ldata->output_lock);
537 
538 	space = tty_write_room(tty);
539 	if (space <= 0) {
540 		mutex_unlock(&ldata->output_lock);
541 		return space;
542 	}
543 	if (nr > space)
544 		nr = space;
545 
546 	for (i = 0, cp = buf; i < nr; i++, cp++) {
547 		unsigned char c = *cp;
548 
549 		switch (c) {
550 		case '\n':
551 			if (O_ONLRET(tty))
552 				ldata->column = 0;
553 			if (O_ONLCR(tty))
554 				goto break_out;
555 			ldata->canon_column = ldata->column;
556 			break;
557 		case '\r':
558 			if (O_ONOCR(tty) && ldata->column == 0)
559 				goto break_out;
560 			if (O_OCRNL(tty))
561 				goto break_out;
562 			ldata->canon_column = ldata->column = 0;
563 			break;
564 		case '\t':
565 			goto break_out;
566 		case '\b':
567 			if (ldata->column > 0)
568 				ldata->column--;
569 			break;
570 		default:
571 			if (!iscntrl(c)) {
572 				if (O_OLCUC(tty))
573 					goto break_out;
574 				if (!is_continuation(c, tty))
575 					ldata->column++;
576 			}
577 			break;
578 		}
579 	}
580 break_out:
581 	i = tty->ops->write(tty, buf, i);
582 
583 	mutex_unlock(&ldata->output_lock);
584 	return i;
585 }
586 
587 /**
588  * __process_echoes	-	write pending echo characters
589  * @tty: terminal device
590  *
591  * Write previously buffered echo (and other ldisc-generated) characters to the
592  * tty.
593  *
594  * Characters generated by the ldisc (including echoes) need to be buffered
595  * because the driver's write buffer can fill during heavy program output.
596  * Echoing straight to the driver will often fail under these conditions,
597  * causing lost characters and resulting mismatches of ldisc state information.
598  *
599  * Since the ldisc state must represent the characters actually sent to the
600  * driver at the time of the write, operations like certain changes in column
601  * state are also saved in the buffer and executed here.
602  *
603  * A circular fifo buffer is used so that the most recent characters are
604  * prioritized. Also, when control characters are echoed with a prefixed "^",
605  * the pair is treated atomically and thus not separated.
606  *
607  * Locking: callers must hold %output_lock.
608  */
609 static size_t __process_echoes(struct tty_struct *tty)
610 {
611 	struct n_tty_data *ldata = tty->disc_data;
612 	int	space, old_space;
613 	size_t tail;
614 	unsigned char c;
615 
616 	old_space = space = tty_write_room(tty);
617 
618 	tail = ldata->echo_tail;
619 	while (MASK(ldata->echo_commit) != MASK(tail)) {
620 		c = echo_buf(ldata, tail);
621 		if (c == ECHO_OP_START) {
622 			unsigned char op;
623 			int no_space_left = 0;
624 
625 			/*
626 			 * Since add_echo_byte() is called without holding
627 			 * output_lock, we might see only portion of multi-byte
628 			 * operation.
629 			 */
630 			if (MASK(ldata->echo_commit) == MASK(tail + 1))
631 				goto not_yet_stored;
632 			/*
633 			 * If the buffer byte is the start of a multi-byte
634 			 * operation, get the next byte, which is either the
635 			 * op code or a control character value.
636 			 */
637 			op = echo_buf(ldata, tail + 1);
638 
639 			switch (op) {
640 			case ECHO_OP_ERASE_TAB: {
641 				unsigned int num_chars, num_bs;
642 
643 				if (MASK(ldata->echo_commit) == MASK(tail + 2))
644 					goto not_yet_stored;
645 				num_chars = echo_buf(ldata, tail + 2);
646 
647 				/*
648 				 * Determine how many columns to go back
649 				 * in order to erase the tab.
650 				 * This depends on the number of columns
651 				 * used by other characters within the tab
652 				 * area.  If this (modulo 8) count is from
653 				 * the start of input rather than from a
654 				 * previous tab, we offset by canon column.
655 				 * Otherwise, tab spacing is normal.
656 				 */
657 				if (!(num_chars & 0x80))
658 					num_chars += ldata->canon_column;
659 				num_bs = 8 - (num_chars & 7);
660 
661 				if (num_bs > space) {
662 					no_space_left = 1;
663 					break;
664 				}
665 				space -= num_bs;
666 				while (num_bs--) {
667 					tty_put_char(tty, '\b');
668 					if (ldata->column > 0)
669 						ldata->column--;
670 				}
671 				tail += 3;
672 				break;
673 			}
674 			case ECHO_OP_SET_CANON_COL:
675 				ldata->canon_column = ldata->column;
676 				tail += 2;
677 				break;
678 
679 			case ECHO_OP_MOVE_BACK_COL:
680 				if (ldata->column > 0)
681 					ldata->column--;
682 				tail += 2;
683 				break;
684 
685 			case ECHO_OP_START:
686 				/* This is an escaped echo op start code */
687 				if (!space) {
688 					no_space_left = 1;
689 					break;
690 				}
691 				tty_put_char(tty, ECHO_OP_START);
692 				ldata->column++;
693 				space--;
694 				tail += 2;
695 				break;
696 
697 			default:
698 				/*
699 				 * If the op is not a special byte code,
700 				 * it is a ctrl char tagged to be echoed
701 				 * as "^X" (where X is the letter
702 				 * representing the control char).
703 				 * Note that we must ensure there is
704 				 * enough space for the whole ctrl pair.
705 				 *
706 				 */
707 				if (space < 2) {
708 					no_space_left = 1;
709 					break;
710 				}
711 				tty_put_char(tty, '^');
712 				tty_put_char(tty, op ^ 0100);
713 				ldata->column += 2;
714 				space -= 2;
715 				tail += 2;
716 			}
717 
718 			if (no_space_left)
719 				break;
720 		} else {
721 			if (O_OPOST(tty)) {
722 				int retval = do_output_char(c, tty, space);
723 				if (retval < 0)
724 					break;
725 				space -= retval;
726 			} else {
727 				if (!space)
728 					break;
729 				tty_put_char(tty, c);
730 				space -= 1;
731 			}
732 			tail += 1;
733 		}
734 	}
735 
736 	/* If the echo buffer is nearly full (so that the possibility exists
737 	 * of echo overrun before the next commit), then discard enough
738 	 * data at the tail to prevent a subsequent overrun */
739 	while (ldata->echo_commit > tail &&
740 	       ldata->echo_commit - tail >= ECHO_DISCARD_WATERMARK) {
741 		if (echo_buf(ldata, tail) == ECHO_OP_START) {
742 			if (echo_buf(ldata, tail + 1) == ECHO_OP_ERASE_TAB)
743 				tail += 3;
744 			else
745 				tail += 2;
746 		} else
747 			tail++;
748 	}
749 
750  not_yet_stored:
751 	ldata->echo_tail = tail;
752 	return old_space - space;
753 }
754 
755 static void commit_echoes(struct tty_struct *tty)
756 {
757 	struct n_tty_data *ldata = tty->disc_data;
758 	size_t nr, old, echoed;
759 	size_t head;
760 
761 	mutex_lock(&ldata->output_lock);
762 	head = ldata->echo_head;
763 	ldata->echo_mark = head;
764 	old = ldata->echo_commit - ldata->echo_tail;
765 
766 	/* Process committed echoes if the accumulated # of bytes
767 	 * is over the threshold (and try again each time another
768 	 * block is accumulated) */
769 	nr = head - ldata->echo_tail;
770 	if (nr < ECHO_COMMIT_WATERMARK ||
771 	    (nr % ECHO_BLOCK > old % ECHO_BLOCK)) {
772 		mutex_unlock(&ldata->output_lock);
773 		return;
774 	}
775 
776 	ldata->echo_commit = head;
777 	echoed = __process_echoes(tty);
778 	mutex_unlock(&ldata->output_lock);
779 
780 	if (echoed && tty->ops->flush_chars)
781 		tty->ops->flush_chars(tty);
782 }
783 
784 static void process_echoes(struct tty_struct *tty)
785 {
786 	struct n_tty_data *ldata = tty->disc_data;
787 	size_t echoed;
788 
789 	if (ldata->echo_mark == ldata->echo_tail)
790 		return;
791 
792 	mutex_lock(&ldata->output_lock);
793 	ldata->echo_commit = ldata->echo_mark;
794 	echoed = __process_echoes(tty);
795 	mutex_unlock(&ldata->output_lock);
796 
797 	if (echoed && tty->ops->flush_chars)
798 		tty->ops->flush_chars(tty);
799 }
800 
801 /* NB: echo_mark and echo_head should be equivalent here */
802 static void flush_echoes(struct tty_struct *tty)
803 {
804 	struct n_tty_data *ldata = tty->disc_data;
805 
806 	if ((!L_ECHO(tty) && !L_ECHONL(tty)) ||
807 	    ldata->echo_commit == ldata->echo_head)
808 		return;
809 
810 	mutex_lock(&ldata->output_lock);
811 	ldata->echo_commit = ldata->echo_head;
812 	__process_echoes(tty);
813 	mutex_unlock(&ldata->output_lock);
814 }
815 
816 /**
817  * add_echo_byte	-	add a byte to the echo buffer
818  * @c: unicode byte to echo
819  * @ldata: n_tty data
820  *
821  * Add a character or operation byte to the echo buffer.
822  */
823 static inline void add_echo_byte(unsigned char c, struct n_tty_data *ldata)
824 {
825 	*echo_buf_addr(ldata, ldata->echo_head) = c;
826 	smp_wmb(); /* Matches smp_rmb() in echo_buf(). */
827 	ldata->echo_head++;
828 }
829 
830 /**
831  * echo_move_back_col	-	add operation to move back a column
832  * @ldata: n_tty data
833  *
834  * Add an operation to the echo buffer to move back one column.
835  */
836 static void echo_move_back_col(struct n_tty_data *ldata)
837 {
838 	add_echo_byte(ECHO_OP_START, ldata);
839 	add_echo_byte(ECHO_OP_MOVE_BACK_COL, ldata);
840 }
841 
842 /**
843  * echo_set_canon_col	-	add operation to set the canon column
844  * @ldata: n_tty data
845  *
846  * Add an operation to the echo buffer to set the canon column to the current
847  * column.
848  */
849 static void echo_set_canon_col(struct n_tty_data *ldata)
850 {
851 	add_echo_byte(ECHO_OP_START, ldata);
852 	add_echo_byte(ECHO_OP_SET_CANON_COL, ldata);
853 }
854 
855 /**
856  * echo_erase_tab	-	add operation to erase a tab
857  * @num_chars: number of character columns already used
858  * @after_tab: true if num_chars starts after a previous tab
859  * @ldata: n_tty data
860  *
861  * Add an operation to the echo buffer to erase a tab.
862  *
863  * Called by the eraser function, which knows how many character columns have
864  * been used since either a previous tab or the start of input. This
865  * information will be used later, along with canon column (if applicable), to
866  * go back the correct number of columns.
867  */
868 static void echo_erase_tab(unsigned int num_chars, int after_tab,
869 			   struct n_tty_data *ldata)
870 {
871 	add_echo_byte(ECHO_OP_START, ldata);
872 	add_echo_byte(ECHO_OP_ERASE_TAB, ldata);
873 
874 	/* We only need to know this modulo 8 (tab spacing) */
875 	num_chars &= 7;
876 
877 	/* Set the high bit as a flag if num_chars is after a previous tab */
878 	if (after_tab)
879 		num_chars |= 0x80;
880 
881 	add_echo_byte(num_chars, ldata);
882 }
883 
884 /**
885  * echo_char_raw	-	echo a character raw
886  * @c: unicode byte to echo
887  * @ldata: line disc data
888  *
889  * Echo user input back onto the screen. This must be called only when
890  * L_ECHO(tty) is true. Called from the &tty_driver.receive_buf() path.
891  *
892  * This variant does not treat control characters specially.
893  */
894 static void echo_char_raw(unsigned char c, struct n_tty_data *ldata)
895 {
896 	if (c == ECHO_OP_START) {
897 		add_echo_byte(ECHO_OP_START, ldata);
898 		add_echo_byte(ECHO_OP_START, ldata);
899 	} else {
900 		add_echo_byte(c, ldata);
901 	}
902 }
903 
904 /**
905  * echo_char		-	echo a character
906  * @c: unicode byte to echo
907  * @tty: terminal device
908  *
909  * Echo user input back onto the screen. This must be called only when
910  * L_ECHO(tty) is true. Called from the &tty_driver.receive_buf() path.
911  *
912  * This variant tags control characters to be echoed as "^X" (where X is the
913  * letter representing the control char).
914  */
915 static void echo_char(unsigned char c, struct tty_struct *tty)
916 {
917 	struct n_tty_data *ldata = tty->disc_data;
918 
919 	if (c == ECHO_OP_START) {
920 		add_echo_byte(ECHO_OP_START, ldata);
921 		add_echo_byte(ECHO_OP_START, ldata);
922 	} else {
923 		if (L_ECHOCTL(tty) && iscntrl(c) && c != '\t')
924 			add_echo_byte(ECHO_OP_START, ldata);
925 		add_echo_byte(c, ldata);
926 	}
927 }
928 
929 /**
930  * finish_erasing	-	complete erase
931  * @ldata: n_tty data
932  */
933 static inline void finish_erasing(struct n_tty_data *ldata)
934 {
935 	if (ldata->erasing) {
936 		echo_char_raw('/', ldata);
937 		ldata->erasing = 0;
938 	}
939 }
940 
941 /**
942  * eraser		-	handle erase function
943  * @c: character input
944  * @tty: terminal device
945  *
946  * Perform erase and necessary output when an erase character is present in the
947  * stream from the driver layer. Handles the complexities of UTF-8 multibyte
948  * symbols.
949  *
950  * Locking: n_tty_receive_buf()/producer path:
951  *	caller holds non-exclusive %termios_rwsem
952  */
953 static void eraser(unsigned char c, struct tty_struct *tty)
954 {
955 	struct n_tty_data *ldata = tty->disc_data;
956 	enum { ERASE, WERASE, KILL } kill_type;
957 	size_t head;
958 	size_t cnt;
959 	int seen_alnums;
960 
961 	if (ldata->read_head == ldata->canon_head) {
962 		/* process_output('\a', tty); */ /* what do you think? */
963 		return;
964 	}
965 	if (c == ERASE_CHAR(tty))
966 		kill_type = ERASE;
967 	else if (c == WERASE_CHAR(tty))
968 		kill_type = WERASE;
969 	else {
970 		if (!L_ECHO(tty)) {
971 			ldata->read_head = ldata->canon_head;
972 			return;
973 		}
974 		if (!L_ECHOK(tty) || !L_ECHOKE(tty) || !L_ECHOE(tty)) {
975 			ldata->read_head = ldata->canon_head;
976 			finish_erasing(ldata);
977 			echo_char(KILL_CHAR(tty), tty);
978 			/* Add a newline if ECHOK is on and ECHOKE is off. */
979 			if (L_ECHOK(tty))
980 				echo_char_raw('\n', ldata);
981 			return;
982 		}
983 		kill_type = KILL;
984 	}
985 
986 	seen_alnums = 0;
987 	while (MASK(ldata->read_head) != MASK(ldata->canon_head)) {
988 		head = ldata->read_head;
989 
990 		/* erase a single possibly multibyte character */
991 		do {
992 			head--;
993 			c = read_buf(ldata, head);
994 		} while (is_continuation(c, tty) &&
995 			 MASK(head) != MASK(ldata->canon_head));
996 
997 		/* do not partially erase */
998 		if (is_continuation(c, tty))
999 			break;
1000 
1001 		if (kill_type == WERASE) {
1002 			/* Equivalent to BSD's ALTWERASE. */
1003 			if (isalnum(c) || c == '_')
1004 				seen_alnums++;
1005 			else if (seen_alnums)
1006 				break;
1007 		}
1008 		cnt = ldata->read_head - head;
1009 		ldata->read_head = head;
1010 		if (L_ECHO(tty)) {
1011 			if (L_ECHOPRT(tty)) {
1012 				if (!ldata->erasing) {
1013 					echo_char_raw('\\', ldata);
1014 					ldata->erasing = 1;
1015 				}
1016 				/* if cnt > 1, output a multi-byte character */
1017 				echo_char(c, tty);
1018 				while (--cnt > 0) {
1019 					head++;
1020 					echo_char_raw(read_buf(ldata, head), ldata);
1021 					echo_move_back_col(ldata);
1022 				}
1023 			} else if (kill_type == ERASE && !L_ECHOE(tty)) {
1024 				echo_char(ERASE_CHAR(tty), tty);
1025 			} else if (c == '\t') {
1026 				unsigned int num_chars = 0;
1027 				int after_tab = 0;
1028 				size_t tail = ldata->read_head;
1029 
1030 				/*
1031 				 * Count the columns used for characters
1032 				 * since the start of input or after a
1033 				 * previous tab.
1034 				 * This info is used to go back the correct
1035 				 * number of columns.
1036 				 */
1037 				while (MASK(tail) != MASK(ldata->canon_head)) {
1038 					tail--;
1039 					c = read_buf(ldata, tail);
1040 					if (c == '\t') {
1041 						after_tab = 1;
1042 						break;
1043 					} else if (iscntrl(c)) {
1044 						if (L_ECHOCTL(tty))
1045 							num_chars += 2;
1046 					} else if (!is_continuation(c, tty)) {
1047 						num_chars++;
1048 					}
1049 				}
1050 				echo_erase_tab(num_chars, after_tab, ldata);
1051 			} else {
1052 				if (iscntrl(c) && L_ECHOCTL(tty)) {
1053 					echo_char_raw('\b', ldata);
1054 					echo_char_raw(' ', ldata);
1055 					echo_char_raw('\b', ldata);
1056 				}
1057 				if (!iscntrl(c) || L_ECHOCTL(tty)) {
1058 					echo_char_raw('\b', ldata);
1059 					echo_char_raw(' ', ldata);
1060 					echo_char_raw('\b', ldata);
1061 				}
1062 			}
1063 		}
1064 		if (kill_type == ERASE)
1065 			break;
1066 	}
1067 	if (ldata->read_head == ldata->canon_head && L_ECHO(tty))
1068 		finish_erasing(ldata);
1069 }
1070 
1071 
1072 static void __isig(int sig, struct tty_struct *tty)
1073 {
1074 	struct pid *tty_pgrp = tty_get_pgrp(tty);
1075 	if (tty_pgrp) {
1076 		kill_pgrp(tty_pgrp, sig, 1);
1077 		put_pid(tty_pgrp);
1078 	}
1079 }
1080 
1081 /**
1082  * isig			-	handle the ISIG optio
1083  * @sig: signal
1084  * @tty: terminal
1085  *
1086  * Called when a signal is being sent due to terminal input. Called from the
1087  * &tty_driver.receive_buf() path, so serialized.
1088  *
1089  * Performs input and output flush if !NOFLSH. In this context, the echo
1090  * buffer is 'output'. The signal is processed first to alert any current
1091  * readers or writers to discontinue and exit their i/o loops.
1092  *
1093  * Locking: %ctrl.lock
1094  */
1095 static void isig(int sig, struct tty_struct *tty)
1096 {
1097 	struct n_tty_data *ldata = tty->disc_data;
1098 
1099 	if (L_NOFLSH(tty)) {
1100 		/* signal only */
1101 		__isig(sig, tty);
1102 
1103 	} else { /* signal and flush */
1104 		up_read(&tty->termios_rwsem);
1105 		down_write(&tty->termios_rwsem);
1106 
1107 		__isig(sig, tty);
1108 
1109 		/* clear echo buffer */
1110 		mutex_lock(&ldata->output_lock);
1111 		ldata->echo_head = ldata->echo_tail = 0;
1112 		ldata->echo_mark = ldata->echo_commit = 0;
1113 		mutex_unlock(&ldata->output_lock);
1114 
1115 		/* clear output buffer */
1116 		tty_driver_flush_buffer(tty);
1117 
1118 		/* clear input buffer */
1119 		reset_buffer_flags(tty->disc_data);
1120 
1121 		/* notify pty master of flush */
1122 		if (tty->link)
1123 			n_tty_packet_mode_flush(tty);
1124 
1125 		up_write(&tty->termios_rwsem);
1126 		down_read(&tty->termios_rwsem);
1127 	}
1128 }
1129 
1130 /**
1131  * n_tty_receive_break	-	handle break
1132  * @tty: terminal
1133  *
1134  * An RS232 break event has been hit in the incoming bitstream. This can cause
1135  * a variety of events depending upon the termios settings.
1136  *
1137  * Locking: n_tty_receive_buf()/producer path:
1138  *	caller holds non-exclusive termios_rwsem
1139  *
1140  * Note: may get exclusive %termios_rwsem if flushing input buffer
1141  */
1142 static void n_tty_receive_break(struct tty_struct *tty)
1143 {
1144 	struct n_tty_data *ldata = tty->disc_data;
1145 
1146 	if (I_IGNBRK(tty))
1147 		return;
1148 	if (I_BRKINT(tty)) {
1149 		isig(SIGINT, tty);
1150 		return;
1151 	}
1152 	if (I_PARMRK(tty)) {
1153 		put_tty_queue('\377', ldata);
1154 		put_tty_queue('\0', ldata);
1155 	}
1156 	put_tty_queue('\0', ldata);
1157 }
1158 
1159 /**
1160  * n_tty_receive_overrun	-	handle overrun reporting
1161  * @tty: terminal
1162  *
1163  * Data arrived faster than we could process it. While the tty driver has
1164  * flagged this the bits that were missed are gone forever.
1165  *
1166  * Called from the receive_buf path so single threaded. Does not need locking
1167  * as num_overrun and overrun_time are function private.
1168  */
1169 static void n_tty_receive_overrun(struct tty_struct *tty)
1170 {
1171 	struct n_tty_data *ldata = tty->disc_data;
1172 
1173 	ldata->num_overrun++;
1174 	if (time_after(jiffies, ldata->overrun_time + HZ) ||
1175 			time_after(ldata->overrun_time, jiffies)) {
1176 		tty_warn(tty, "%d input overrun(s)\n", ldata->num_overrun);
1177 		ldata->overrun_time = jiffies;
1178 		ldata->num_overrun = 0;
1179 	}
1180 }
1181 
1182 /**
1183  * n_tty_receive_parity_error	-	error notifier
1184  * @tty: terminal device
1185  * @c: character
1186  *
1187  * Process a parity error and queue the right data to indicate the error case
1188  * if necessary.
1189  *
1190  * Locking: n_tty_receive_buf()/producer path:
1191  * 	caller holds non-exclusive %termios_rwsem
1192  */
1193 static void n_tty_receive_parity_error(struct tty_struct *tty, unsigned char c)
1194 {
1195 	struct n_tty_data *ldata = tty->disc_data;
1196 
1197 	if (I_INPCK(tty)) {
1198 		if (I_IGNPAR(tty))
1199 			return;
1200 		if (I_PARMRK(tty)) {
1201 			put_tty_queue('\377', ldata);
1202 			put_tty_queue('\0', ldata);
1203 			put_tty_queue(c, ldata);
1204 		} else
1205 			put_tty_queue('\0', ldata);
1206 	} else
1207 		put_tty_queue(c, ldata);
1208 }
1209 
1210 static void
1211 n_tty_receive_signal_char(struct tty_struct *tty, int signal, unsigned char c)
1212 {
1213 	isig(signal, tty);
1214 	if (I_IXON(tty))
1215 		start_tty(tty);
1216 	if (L_ECHO(tty)) {
1217 		echo_char(c, tty);
1218 		commit_echoes(tty);
1219 	} else
1220 		process_echoes(tty);
1221 }
1222 
1223 static bool n_tty_is_char_flow_ctrl(struct tty_struct *tty, unsigned char c)
1224 {
1225 	return c == START_CHAR(tty) || c == STOP_CHAR(tty);
1226 }
1227 
1228 /* Returns true if c is consumed as flow-control character */
1229 static bool n_tty_receive_char_flow_ctrl(struct tty_struct *tty, unsigned char c)
1230 {
1231 	if (!n_tty_is_char_flow_ctrl(tty, c))
1232 		return false;
1233 
1234 	if (c == START_CHAR(tty)) {
1235 		start_tty(tty);
1236 		process_echoes(tty);
1237 		return true;
1238 	}
1239 
1240 	/* STOP_CHAR */
1241 	stop_tty(tty);
1242 	return true;
1243 }
1244 
1245 static void n_tty_receive_char_special(struct tty_struct *tty, unsigned char c)
1246 {
1247 	struct n_tty_data *ldata = tty->disc_data;
1248 
1249 	if (I_IXON(tty) && n_tty_receive_char_flow_ctrl(tty, c))
1250 		return;
1251 
1252 	if (L_ISIG(tty)) {
1253 		if (c == INTR_CHAR(tty)) {
1254 			n_tty_receive_signal_char(tty, SIGINT, c);
1255 			return;
1256 		} else if (c == QUIT_CHAR(tty)) {
1257 			n_tty_receive_signal_char(tty, SIGQUIT, c);
1258 			return;
1259 		} else if (c == SUSP_CHAR(tty)) {
1260 			n_tty_receive_signal_char(tty, SIGTSTP, c);
1261 			return;
1262 		}
1263 	}
1264 
1265 	if (tty->flow.stopped && !tty->flow.tco_stopped && I_IXON(tty) && I_IXANY(tty)) {
1266 		start_tty(tty);
1267 		process_echoes(tty);
1268 	}
1269 
1270 	if (c == '\r') {
1271 		if (I_IGNCR(tty))
1272 			return;
1273 		if (I_ICRNL(tty))
1274 			c = '\n';
1275 	} else if (c == '\n' && I_INLCR(tty))
1276 		c = '\r';
1277 
1278 	if (ldata->icanon) {
1279 		if (c == ERASE_CHAR(tty) || c == KILL_CHAR(tty) ||
1280 		    (c == WERASE_CHAR(tty) && L_IEXTEN(tty))) {
1281 			eraser(c, tty);
1282 			commit_echoes(tty);
1283 			return;
1284 		}
1285 		if (c == LNEXT_CHAR(tty) && L_IEXTEN(tty)) {
1286 			ldata->lnext = 1;
1287 			if (L_ECHO(tty)) {
1288 				finish_erasing(ldata);
1289 				if (L_ECHOCTL(tty)) {
1290 					echo_char_raw('^', ldata);
1291 					echo_char_raw('\b', ldata);
1292 					commit_echoes(tty);
1293 				}
1294 			}
1295 			return;
1296 		}
1297 		if (c == REPRINT_CHAR(tty) && L_ECHO(tty) && L_IEXTEN(tty)) {
1298 			size_t tail = ldata->canon_head;
1299 
1300 			finish_erasing(ldata);
1301 			echo_char(c, tty);
1302 			echo_char_raw('\n', ldata);
1303 			while (MASK(tail) != MASK(ldata->read_head)) {
1304 				echo_char(read_buf(ldata, tail), tty);
1305 				tail++;
1306 			}
1307 			commit_echoes(tty);
1308 			return;
1309 		}
1310 		if (c == '\n') {
1311 			if (L_ECHO(tty) || L_ECHONL(tty)) {
1312 				echo_char_raw('\n', ldata);
1313 				commit_echoes(tty);
1314 			}
1315 			goto handle_newline;
1316 		}
1317 		if (c == EOF_CHAR(tty)) {
1318 			c = __DISABLED_CHAR;
1319 			goto handle_newline;
1320 		}
1321 		if ((c == EOL_CHAR(tty)) ||
1322 		    (c == EOL2_CHAR(tty) && L_IEXTEN(tty))) {
1323 			/*
1324 			 * XXX are EOL_CHAR and EOL2_CHAR echoed?!?
1325 			 */
1326 			if (L_ECHO(tty)) {
1327 				/* Record the column of first canon char. */
1328 				if (ldata->canon_head == ldata->read_head)
1329 					echo_set_canon_col(ldata);
1330 				echo_char(c, tty);
1331 				commit_echoes(tty);
1332 			}
1333 			/*
1334 			 * XXX does PARMRK doubling happen for
1335 			 * EOL_CHAR and EOL2_CHAR?
1336 			 */
1337 			if (c == (unsigned char) '\377' && I_PARMRK(tty))
1338 				put_tty_queue(c, ldata);
1339 
1340 handle_newline:
1341 			set_bit(ldata->read_head & (N_TTY_BUF_SIZE - 1), ldata->read_flags);
1342 			put_tty_queue(c, ldata);
1343 			smp_store_release(&ldata->canon_head, ldata->read_head);
1344 			kill_fasync(&tty->fasync, SIGIO, POLL_IN);
1345 			wake_up_interruptible_poll(&tty->read_wait, EPOLLIN | EPOLLRDNORM);
1346 			return;
1347 		}
1348 	}
1349 
1350 	if (L_ECHO(tty)) {
1351 		finish_erasing(ldata);
1352 		if (c == '\n')
1353 			echo_char_raw('\n', ldata);
1354 		else {
1355 			/* Record the column of first canon char. */
1356 			if (ldata->canon_head == ldata->read_head)
1357 				echo_set_canon_col(ldata);
1358 			echo_char(c, tty);
1359 		}
1360 		commit_echoes(tty);
1361 	}
1362 
1363 	/* PARMRK doubling check */
1364 	if (c == (unsigned char) '\377' && I_PARMRK(tty))
1365 		put_tty_queue(c, ldata);
1366 
1367 	put_tty_queue(c, ldata);
1368 }
1369 
1370 /**
1371  * n_tty_receive_char	-	perform processing
1372  * @tty: terminal device
1373  * @c: character
1374  *
1375  * Process an individual character of input received from the driver.  This is
1376  * serialized with respect to itself by the rules for the driver above.
1377  *
1378  * Locking: n_tty_receive_buf()/producer path:
1379  *	caller holds non-exclusive %termios_rwsem
1380  *	publishes canon_head if canonical mode is active
1381  */
1382 static void n_tty_receive_char(struct tty_struct *tty, unsigned char c)
1383 {
1384 	struct n_tty_data *ldata = tty->disc_data;
1385 
1386 	if (tty->flow.stopped && !tty->flow.tco_stopped && I_IXON(tty) && I_IXANY(tty)) {
1387 		start_tty(tty);
1388 		process_echoes(tty);
1389 	}
1390 	if (L_ECHO(tty)) {
1391 		finish_erasing(ldata);
1392 		/* Record the column of first canon char. */
1393 		if (ldata->canon_head == ldata->read_head)
1394 			echo_set_canon_col(ldata);
1395 		echo_char(c, tty);
1396 		commit_echoes(tty);
1397 	}
1398 	/* PARMRK doubling check */
1399 	if (c == (unsigned char) '\377' && I_PARMRK(tty))
1400 		put_tty_queue(c, ldata);
1401 	put_tty_queue(c, ldata);
1402 }
1403 
1404 static void n_tty_receive_char_closing(struct tty_struct *tty, unsigned char c)
1405 {
1406 	if (I_ISTRIP(tty))
1407 		c &= 0x7f;
1408 	if (I_IUCLC(tty) && L_IEXTEN(tty))
1409 		c = tolower(c);
1410 
1411 	if (I_IXON(tty)) {
1412 		if (c == STOP_CHAR(tty))
1413 			stop_tty(tty);
1414 		else if (c == START_CHAR(tty) ||
1415 			 (tty->flow.stopped && !tty->flow.tco_stopped && I_IXANY(tty) &&
1416 			  c != INTR_CHAR(tty) && c != QUIT_CHAR(tty) &&
1417 			  c != SUSP_CHAR(tty))) {
1418 			start_tty(tty);
1419 			process_echoes(tty);
1420 		}
1421 	}
1422 }
1423 
1424 static void
1425 n_tty_receive_char_flagged(struct tty_struct *tty, unsigned char c, char flag)
1426 {
1427 	switch (flag) {
1428 	case TTY_BREAK:
1429 		n_tty_receive_break(tty);
1430 		break;
1431 	case TTY_PARITY:
1432 	case TTY_FRAME:
1433 		n_tty_receive_parity_error(tty, c);
1434 		break;
1435 	case TTY_OVERRUN:
1436 		n_tty_receive_overrun(tty);
1437 		break;
1438 	default:
1439 		tty_err(tty, "unknown flag %d\n", flag);
1440 		break;
1441 	}
1442 }
1443 
1444 static void
1445 n_tty_receive_char_lnext(struct tty_struct *tty, unsigned char c, char flag)
1446 {
1447 	struct n_tty_data *ldata = tty->disc_data;
1448 
1449 	ldata->lnext = 0;
1450 	if (likely(flag == TTY_NORMAL)) {
1451 		if (I_ISTRIP(tty))
1452 			c &= 0x7f;
1453 		if (I_IUCLC(tty) && L_IEXTEN(tty))
1454 			c = tolower(c);
1455 		n_tty_receive_char(tty, c);
1456 	} else
1457 		n_tty_receive_char_flagged(tty, c, flag);
1458 }
1459 
1460 static void
1461 n_tty_receive_buf_real_raw(struct tty_struct *tty, const unsigned char *cp,
1462 			   const char *fp, int count)
1463 {
1464 	struct n_tty_data *ldata = tty->disc_data;
1465 	size_t n, head;
1466 
1467 	head = ldata->read_head & (N_TTY_BUF_SIZE - 1);
1468 	n = min_t(size_t, count, N_TTY_BUF_SIZE - head);
1469 	memcpy(read_buf_addr(ldata, head), cp, n);
1470 	ldata->read_head += n;
1471 	cp += n;
1472 	count -= n;
1473 
1474 	head = ldata->read_head & (N_TTY_BUF_SIZE - 1);
1475 	n = min_t(size_t, count, N_TTY_BUF_SIZE - head);
1476 	memcpy(read_buf_addr(ldata, head), cp, n);
1477 	ldata->read_head += n;
1478 }
1479 
1480 static void
1481 n_tty_receive_buf_raw(struct tty_struct *tty, const unsigned char *cp,
1482 		      const char *fp, int count)
1483 {
1484 	struct n_tty_data *ldata = tty->disc_data;
1485 	char flag = TTY_NORMAL;
1486 
1487 	while (count--) {
1488 		if (fp)
1489 			flag = *fp++;
1490 		if (likely(flag == TTY_NORMAL))
1491 			put_tty_queue(*cp++, ldata);
1492 		else
1493 			n_tty_receive_char_flagged(tty, *cp++, flag);
1494 	}
1495 }
1496 
1497 static void
1498 n_tty_receive_buf_closing(struct tty_struct *tty, const unsigned char *cp,
1499 			  const char *fp, int count)
1500 {
1501 	char flag = TTY_NORMAL;
1502 
1503 	while (count--) {
1504 		if (fp)
1505 			flag = *fp++;
1506 		if (likely(flag == TTY_NORMAL))
1507 			n_tty_receive_char_closing(tty, *cp++);
1508 	}
1509 }
1510 
1511 static void n_tty_receive_buf_standard(struct tty_struct *tty,
1512 		const unsigned char *cp, const char *fp, int count)
1513 {
1514 	struct n_tty_data *ldata = tty->disc_data;
1515 	char flag = TTY_NORMAL;
1516 
1517 	while (count--) {
1518 		unsigned char c = *cp++;
1519 
1520 		if (fp)
1521 			flag = *fp++;
1522 
1523 		if (ldata->lnext) {
1524 			n_tty_receive_char_lnext(tty, c, flag);
1525 			continue;
1526 		}
1527 
1528 		if (unlikely(flag != TTY_NORMAL)) {
1529 			n_tty_receive_char_flagged(tty, c, flag);
1530 			continue;
1531 		}
1532 
1533 		if (I_ISTRIP(tty))
1534 			c &= 0x7f;
1535 		if (I_IUCLC(tty) && L_IEXTEN(tty))
1536 			c = tolower(c);
1537 		if (L_EXTPROC(tty)) {
1538 			put_tty_queue(c, ldata);
1539 			continue;
1540 		}
1541 
1542 		if (test_bit(c, ldata->char_map))
1543 			n_tty_receive_char_special(tty, c);
1544 		else
1545 			n_tty_receive_char(tty, c);
1546 	}
1547 }
1548 
1549 static void __receive_buf(struct tty_struct *tty, const unsigned char *cp,
1550 			  const char *fp, int count)
1551 {
1552 	struct n_tty_data *ldata = tty->disc_data;
1553 	bool preops = I_ISTRIP(tty) || (I_IUCLC(tty) && L_IEXTEN(tty));
1554 
1555 	if (ldata->real_raw)
1556 		n_tty_receive_buf_real_raw(tty, cp, fp, count);
1557 	else if (ldata->raw || (L_EXTPROC(tty) && !preops))
1558 		n_tty_receive_buf_raw(tty, cp, fp, count);
1559 	else if (tty->closing && !L_EXTPROC(tty))
1560 		n_tty_receive_buf_closing(tty, cp, fp, count);
1561 	else {
1562 		n_tty_receive_buf_standard(tty, cp, fp, count);
1563 
1564 		flush_echoes(tty);
1565 		if (tty->ops->flush_chars)
1566 			tty->ops->flush_chars(tty);
1567 	}
1568 
1569 	if (ldata->icanon && !L_EXTPROC(tty))
1570 		return;
1571 
1572 	/* publish read_head to consumer */
1573 	smp_store_release(&ldata->commit_head, ldata->read_head);
1574 
1575 	if (read_cnt(ldata)) {
1576 		kill_fasync(&tty->fasync, SIGIO, POLL_IN);
1577 		wake_up_interruptible_poll(&tty->read_wait, EPOLLIN | EPOLLRDNORM);
1578 	}
1579 }
1580 
1581 /**
1582  * n_tty_receive_buf_common	-	process input
1583  * @tty: device to receive input
1584  * @cp: input chars
1585  * @fp: flags for each char (if %NULL, all chars are %TTY_NORMAL)
1586  * @count: number of input chars in @cp
1587  * @flow: enable flow control
1588  *
1589  * Called by the terminal driver when a block of characters has been received.
1590  * This function must be called from soft contexts not from interrupt context.
1591  * The driver is responsible for making calls one at a time and in order (or
1592  * using flush_to_ldisc()).
1593  *
1594  * Returns: the # of input chars from @cp which were processed.
1595  *
1596  * In canonical mode, the maximum line length is 4096 chars (including the line
1597  * termination char); lines longer than 4096 chars are truncated. After 4095
1598  * chars, input data is still processed but not stored. Overflow processing
1599  * ensures the tty can always receive more input until at least one line can be
1600  * read.
1601  *
1602  * In non-canonical mode, the read buffer will only accept 4095 chars; this
1603  * provides the necessary space for a newline char if the input mode is
1604  * switched to canonical.
1605  *
1606  * Note it is possible for the read buffer to _contain_ 4096 chars in
1607  * non-canonical mode: the read buffer could already contain the maximum canon
1608  * line of 4096 chars when the mode is switched to non-canonical.
1609  *
1610  * Locking: n_tty_receive_buf()/producer path:
1611  *	claims non-exclusive %termios_rwsem
1612  *	publishes commit_head or canon_head
1613  */
1614 static int
1615 n_tty_receive_buf_common(struct tty_struct *tty, const unsigned char *cp,
1616 			 const char *fp, int count, int flow)
1617 {
1618 	struct n_tty_data *ldata = tty->disc_data;
1619 	int room, n, rcvd = 0, overflow;
1620 
1621 	down_read(&tty->termios_rwsem);
1622 
1623 	do {
1624 		/*
1625 		 * When PARMRK is set, each input char may take up to 3 chars
1626 		 * in the read buf; reduce the buffer space avail by 3x
1627 		 *
1628 		 * If we are doing input canonicalization, and there are no
1629 		 * pending newlines, let characters through without limit, so
1630 		 * that erase characters will be handled.  Other excess
1631 		 * characters will be beeped.
1632 		 *
1633 		 * paired with store in *_copy_from_read_buf() -- guarantees
1634 		 * the consumer has loaded the data in read_buf up to the new
1635 		 * read_tail (so this producer will not overwrite unread data)
1636 		 */
1637 		size_t tail = smp_load_acquire(&ldata->read_tail);
1638 
1639 		room = N_TTY_BUF_SIZE - (ldata->read_head - tail);
1640 		if (I_PARMRK(tty))
1641 			room = (room + 2) / 3;
1642 		room--;
1643 		if (room <= 0) {
1644 			overflow = ldata->icanon && ldata->canon_head == tail;
1645 			if (overflow && room < 0)
1646 				ldata->read_head--;
1647 			room = overflow;
1648 			ldata->no_room = flow && !room;
1649 		} else
1650 			overflow = 0;
1651 
1652 		n = min(count, room);
1653 		if (!n)
1654 			break;
1655 
1656 		/* ignore parity errors if handling overflow */
1657 		if (!overflow || !fp || *fp != TTY_PARITY)
1658 			__receive_buf(tty, cp, fp, n);
1659 
1660 		cp += n;
1661 		if (fp)
1662 			fp += n;
1663 		count -= n;
1664 		rcvd += n;
1665 	} while (!test_bit(TTY_LDISC_CHANGING, &tty->flags));
1666 
1667 	tty->receive_room = room;
1668 
1669 	/* Unthrottle if handling overflow on pty */
1670 	if (tty->driver->type == TTY_DRIVER_TYPE_PTY) {
1671 		if (overflow) {
1672 			tty_set_flow_change(tty, TTY_UNTHROTTLE_SAFE);
1673 			tty_unthrottle_safe(tty);
1674 			__tty_set_flow_change(tty, 0);
1675 		}
1676 	} else
1677 		n_tty_check_throttle(tty);
1678 
1679 	up_read(&tty->termios_rwsem);
1680 
1681 	return rcvd;
1682 }
1683 
1684 static void n_tty_receive_buf(struct tty_struct *tty, const unsigned char *cp,
1685 			      const char *fp, int count)
1686 {
1687 	n_tty_receive_buf_common(tty, cp, fp, count, 0);
1688 }
1689 
1690 static int n_tty_receive_buf2(struct tty_struct *tty, const unsigned char *cp,
1691 			      const char *fp, int count)
1692 {
1693 	return n_tty_receive_buf_common(tty, cp, fp, count, 1);
1694 }
1695 
1696 /**
1697  * n_tty_set_termios	-	termios data changed
1698  * @tty: terminal
1699  * @old: previous data
1700  *
1701  * Called by the tty layer when the user changes termios flags so that the line
1702  * discipline can plan ahead. This function cannot sleep and is protected from
1703  * re-entry by the tty layer. The user is guaranteed that this function will
1704  * not be re-entered or in progress when the ldisc is closed.
1705  *
1706  * Locking: Caller holds @tty->termios_rwsem
1707  */
1708 static void n_tty_set_termios(struct tty_struct *tty, struct ktermios *old)
1709 {
1710 	struct n_tty_data *ldata = tty->disc_data;
1711 
1712 	if (!old || (old->c_lflag ^ tty->termios.c_lflag) & (ICANON | EXTPROC)) {
1713 		bitmap_zero(ldata->read_flags, N_TTY_BUF_SIZE);
1714 		ldata->line_start = ldata->read_tail;
1715 		if (!L_ICANON(tty) || !read_cnt(ldata)) {
1716 			ldata->canon_head = ldata->read_tail;
1717 			ldata->push = 0;
1718 		} else {
1719 			set_bit((ldata->read_head - 1) & (N_TTY_BUF_SIZE - 1),
1720 				ldata->read_flags);
1721 			ldata->canon_head = ldata->read_head;
1722 			ldata->push = 1;
1723 		}
1724 		ldata->commit_head = ldata->read_head;
1725 		ldata->erasing = 0;
1726 		ldata->lnext = 0;
1727 	}
1728 
1729 	ldata->icanon = (L_ICANON(tty) != 0);
1730 
1731 	if (I_ISTRIP(tty) || I_IUCLC(tty) || I_IGNCR(tty) ||
1732 	    I_ICRNL(tty) || I_INLCR(tty) || L_ICANON(tty) ||
1733 	    I_IXON(tty) || L_ISIG(tty) || L_ECHO(tty) ||
1734 	    I_PARMRK(tty)) {
1735 		bitmap_zero(ldata->char_map, 256);
1736 
1737 		if (I_IGNCR(tty) || I_ICRNL(tty))
1738 			set_bit('\r', ldata->char_map);
1739 		if (I_INLCR(tty))
1740 			set_bit('\n', ldata->char_map);
1741 
1742 		if (L_ICANON(tty)) {
1743 			set_bit(ERASE_CHAR(tty), ldata->char_map);
1744 			set_bit(KILL_CHAR(tty), ldata->char_map);
1745 			set_bit(EOF_CHAR(tty), ldata->char_map);
1746 			set_bit('\n', ldata->char_map);
1747 			set_bit(EOL_CHAR(tty), ldata->char_map);
1748 			if (L_IEXTEN(tty)) {
1749 				set_bit(WERASE_CHAR(tty), ldata->char_map);
1750 				set_bit(LNEXT_CHAR(tty), ldata->char_map);
1751 				set_bit(EOL2_CHAR(tty), ldata->char_map);
1752 				if (L_ECHO(tty))
1753 					set_bit(REPRINT_CHAR(tty),
1754 						ldata->char_map);
1755 			}
1756 		}
1757 		if (I_IXON(tty)) {
1758 			set_bit(START_CHAR(tty), ldata->char_map);
1759 			set_bit(STOP_CHAR(tty), ldata->char_map);
1760 		}
1761 		if (L_ISIG(tty)) {
1762 			set_bit(INTR_CHAR(tty), ldata->char_map);
1763 			set_bit(QUIT_CHAR(tty), ldata->char_map);
1764 			set_bit(SUSP_CHAR(tty), ldata->char_map);
1765 		}
1766 		clear_bit(__DISABLED_CHAR, ldata->char_map);
1767 		ldata->raw = 0;
1768 		ldata->real_raw = 0;
1769 	} else {
1770 		ldata->raw = 1;
1771 		if ((I_IGNBRK(tty) || (!I_BRKINT(tty) && !I_PARMRK(tty))) &&
1772 		    (I_IGNPAR(tty) || !I_INPCK(tty)) &&
1773 		    (tty->driver->flags & TTY_DRIVER_REAL_RAW))
1774 			ldata->real_raw = 1;
1775 		else
1776 			ldata->real_raw = 0;
1777 	}
1778 	/*
1779 	 * Fix tty hang when I_IXON(tty) is cleared, but the tty
1780 	 * been stopped by STOP_CHAR(tty) before it.
1781 	 */
1782 	if (!I_IXON(tty) && old && (old->c_iflag & IXON) && !tty->flow.tco_stopped) {
1783 		start_tty(tty);
1784 		process_echoes(tty);
1785 	}
1786 
1787 	/* The termios change make the tty ready for I/O */
1788 	wake_up_interruptible(&tty->write_wait);
1789 	wake_up_interruptible(&tty->read_wait);
1790 }
1791 
1792 /**
1793  * n_tty_close		-	close the ldisc for this tty
1794  * @tty: device
1795  *
1796  * Called from the terminal layer when this line discipline is being shut down,
1797  * either because of a close or becsuse of a discipline change. The function
1798  * will not be called while other ldisc methods are in progress.
1799  */
1800 static void n_tty_close(struct tty_struct *tty)
1801 {
1802 	struct n_tty_data *ldata = tty->disc_data;
1803 
1804 	if (tty->link)
1805 		n_tty_packet_mode_flush(tty);
1806 
1807 	down_write(&tty->termios_rwsem);
1808 	vfree(ldata);
1809 	tty->disc_data = NULL;
1810 	up_write(&tty->termios_rwsem);
1811 }
1812 
1813 /**
1814  * n_tty_open		-	open an ldisc
1815  * @tty: terminal to open
1816  *
1817  * Called when this line discipline is being attached to the terminal device.
1818  * Can sleep. Called serialized so that no other events will occur in parallel.
1819  * No further open will occur until a close.
1820  */
1821 static int n_tty_open(struct tty_struct *tty)
1822 {
1823 	struct n_tty_data *ldata;
1824 
1825 	/* Currently a malloc failure here can panic */
1826 	ldata = vzalloc(sizeof(*ldata));
1827 	if (!ldata)
1828 		return -ENOMEM;
1829 
1830 	ldata->overrun_time = jiffies;
1831 	mutex_init(&ldata->atomic_read_lock);
1832 	mutex_init(&ldata->output_lock);
1833 
1834 	tty->disc_data = ldata;
1835 	tty->closing = 0;
1836 	/* indicate buffer work may resume */
1837 	clear_bit(TTY_LDISC_HALTED, &tty->flags);
1838 	n_tty_set_termios(tty, NULL);
1839 	tty_unthrottle(tty);
1840 	return 0;
1841 }
1842 
1843 static inline int input_available_p(struct tty_struct *tty, int poll)
1844 {
1845 	struct n_tty_data *ldata = tty->disc_data;
1846 	int amt = poll && !TIME_CHAR(tty) && MIN_CHAR(tty) ? MIN_CHAR(tty) : 1;
1847 
1848 	if (ldata->icanon && !L_EXTPROC(tty))
1849 		return ldata->canon_head != ldata->read_tail;
1850 	else
1851 		return ldata->commit_head - ldata->read_tail >= amt;
1852 }
1853 
1854 /**
1855  * copy_from_read_buf	-	copy read data directly
1856  * @tty: terminal device
1857  * @kbp: data
1858  * @nr: size of data
1859  *
1860  * Helper function to speed up n_tty_read(). It is only called when %ICANON is
1861  * off; it copies characters straight from the tty queue.
1862  *
1863  * Returns: true if it successfully copied data, but there is still more data
1864  * to be had.
1865  *
1866  * Locking:
1867  *  * called under the @ldata->atomic_read_lock sem
1868  *  * n_tty_read()/consumer path:
1869  *		caller holds non-exclusive %termios_rwsem;
1870  *		read_tail published
1871  */
1872 static bool copy_from_read_buf(struct tty_struct *tty,
1873 				      unsigned char **kbp,
1874 				      size_t *nr)
1875 
1876 {
1877 	struct n_tty_data *ldata = tty->disc_data;
1878 	size_t n;
1879 	bool is_eof;
1880 	size_t head = smp_load_acquire(&ldata->commit_head);
1881 	size_t tail = ldata->read_tail & (N_TTY_BUF_SIZE - 1);
1882 
1883 	n = min(head - ldata->read_tail, N_TTY_BUF_SIZE - tail);
1884 	n = min(*nr, n);
1885 	if (n) {
1886 		unsigned char *from = read_buf_addr(ldata, tail);
1887 		memcpy(*kbp, from, n);
1888 		is_eof = n == 1 && *from == EOF_CHAR(tty);
1889 		tty_audit_add_data(tty, from, n);
1890 		zero_buffer(tty, from, n);
1891 		smp_store_release(&ldata->read_tail, ldata->read_tail + n);
1892 		/* Turn single EOF into zero-length read */
1893 		if (L_EXTPROC(tty) && ldata->icanon && is_eof &&
1894 		    (head == ldata->read_tail))
1895 			return false;
1896 		*kbp += n;
1897 		*nr -= n;
1898 
1899 		/* If we have more to copy, let the caller know */
1900 		return head != ldata->read_tail;
1901 	}
1902 	return false;
1903 }
1904 
1905 /**
1906  * canon_copy_from_read_buf	-	copy read data in canonical mode
1907  * @tty: terminal device
1908  * @kbp: data
1909  * @nr: size of data
1910  *
1911  * Helper function for n_tty_read(). It is only called when %ICANON is on; it
1912  * copies one line of input up to and including the line-delimiting character
1913  * into the result buffer.
1914  *
1915  * Note: When termios is changed from non-canonical to canonical mode and the
1916  * read buffer contains data, n_tty_set_termios() simulates an EOF push (as if
1917  * C-d were input) _without_ the %DISABLED_CHAR in the buffer. This causes data
1918  * already processed as input to be immediately available as input although a
1919  * newline has not been received.
1920  *
1921  * Locking:
1922  *  * called under the %atomic_read_lock mutex
1923  *  * n_tty_read()/consumer path:
1924  *	caller holds non-exclusive %termios_rwsem;
1925  *	read_tail published
1926  */
1927 static bool canon_copy_from_read_buf(struct tty_struct *tty,
1928 				     unsigned char **kbp,
1929 				     size_t *nr)
1930 {
1931 	struct n_tty_data *ldata = tty->disc_data;
1932 	size_t n, size, more, c;
1933 	size_t eol;
1934 	size_t tail, canon_head;
1935 	int found = 0;
1936 
1937 	/* N.B. avoid overrun if nr == 0 */
1938 	if (!*nr)
1939 		return false;
1940 
1941 	canon_head = smp_load_acquire(&ldata->canon_head);
1942 	n = min(*nr, canon_head - ldata->read_tail);
1943 
1944 	tail = ldata->read_tail & (N_TTY_BUF_SIZE - 1);
1945 	size = min_t(size_t, tail + n, N_TTY_BUF_SIZE);
1946 
1947 	n_tty_trace("%s: nr:%zu tail:%zu n:%zu size:%zu\n",
1948 		    __func__, *nr, tail, n, size);
1949 
1950 	eol = find_next_bit(ldata->read_flags, size, tail);
1951 	more = n - (size - tail);
1952 	if (eol == N_TTY_BUF_SIZE && more) {
1953 		/* scan wrapped without finding set bit */
1954 		eol = find_first_bit(ldata->read_flags, more);
1955 		found = eol != more;
1956 	} else
1957 		found = eol != size;
1958 
1959 	n = eol - tail;
1960 	if (n > N_TTY_BUF_SIZE)
1961 		n += N_TTY_BUF_SIZE;
1962 	c = n + found;
1963 
1964 	if (!found || read_buf(ldata, eol) != __DISABLED_CHAR)
1965 		n = c;
1966 
1967 	n_tty_trace("%s: eol:%zu found:%d n:%zu c:%zu tail:%zu more:%zu\n",
1968 		    __func__, eol, found, n, c, tail, more);
1969 
1970 	tty_copy(tty, *kbp, tail, n);
1971 	*kbp += n;
1972 	*nr -= n;
1973 
1974 	if (found)
1975 		clear_bit(eol, ldata->read_flags);
1976 	smp_store_release(&ldata->read_tail, ldata->read_tail + c);
1977 
1978 	if (found) {
1979 		if (!ldata->push)
1980 			ldata->line_start = ldata->read_tail;
1981 		else
1982 			ldata->push = 0;
1983 		tty_audit_push();
1984 		return false;
1985 	}
1986 
1987 	/* No EOL found - do a continuation retry if there is more data */
1988 	return ldata->read_tail != canon_head;
1989 }
1990 
1991 /*
1992  * If we finished a read at the exact location of an
1993  * EOF (special EOL character that's a __DISABLED_CHAR)
1994  * in the stream, silently eat the EOF.
1995  */
1996 static void canon_skip_eof(struct tty_struct *tty)
1997 {
1998 	struct n_tty_data *ldata = tty->disc_data;
1999 	size_t tail, canon_head;
2000 
2001 	canon_head = smp_load_acquire(&ldata->canon_head);
2002 	tail = ldata->read_tail;
2003 
2004 	// No data?
2005 	if (tail == canon_head)
2006 		return;
2007 
2008 	// See if the tail position is EOF in the circular buffer
2009 	tail &= (N_TTY_BUF_SIZE - 1);
2010 	if (!test_bit(tail, ldata->read_flags))
2011 		return;
2012 	if (read_buf(ldata, tail) != __DISABLED_CHAR)
2013 		return;
2014 
2015 	// Clear the EOL bit, skip the EOF char.
2016 	clear_bit(tail, ldata->read_flags);
2017 	smp_store_release(&ldata->read_tail, ldata->read_tail + 1);
2018 }
2019 
2020 /**
2021  * job_control		-	check job control
2022  * @tty: tty
2023  * @file: file handle
2024  *
2025  * Perform job control management checks on this @file/@tty descriptor and if
2026  * appropriate send any needed signals and return a negative error code if
2027  * action should be taken.
2028  *
2029  * Locking:
2030  *  * redirected write test is safe
2031  *  * current->signal->tty check is safe
2032  *  * ctrl.lock to safely reference @tty->ctrl.pgrp
2033  */
2034 static int job_control(struct tty_struct *tty, struct file *file)
2035 {
2036 	/* Job control check -- must be done at start and after
2037 	   every sleep (POSIX.1 7.1.1.4). */
2038 	/* NOTE: not yet done after every sleep pending a thorough
2039 	   check of the logic of this change. -- jlc */
2040 	/* don't stop on /dev/console */
2041 	if (file->f_op->write_iter == redirected_tty_write)
2042 		return 0;
2043 
2044 	return __tty_check_change(tty, SIGTTIN);
2045 }
2046 
2047 
2048 /**
2049  * n_tty_read		-	read function for tty
2050  * @tty: tty device
2051  * @file: file object
2052  * @kbuf: kernelspace buffer pointer
2053  * @nr: size of I/O
2054  * @cookie: if non-%NULL, this is a continuation read
2055  * @offset: where to continue reading from (unused in n_tty)
2056  *
2057  * Perform reads for the line discipline. We are guaranteed that the line
2058  * discipline will not be closed under us but we may get multiple parallel
2059  * readers and must handle this ourselves. We may also get a hangup. Always
2060  * called in user context, may sleep.
2061  *
2062  * This code must be sure never to sleep through a hangup.
2063  *
2064  * Locking: n_tty_read()/consumer path:
2065  *	claims non-exclusive termios_rwsem;
2066  *	publishes read_tail
2067  */
2068 static ssize_t n_tty_read(struct tty_struct *tty, struct file *file,
2069 			  unsigned char *kbuf, size_t nr,
2070 			  void **cookie, unsigned long offset)
2071 {
2072 	struct n_tty_data *ldata = tty->disc_data;
2073 	unsigned char *kb = kbuf;
2074 	DEFINE_WAIT_FUNC(wait, woken_wake_function);
2075 	int c;
2076 	int minimum, time;
2077 	ssize_t retval = 0;
2078 	long timeout;
2079 	bool packet;
2080 	size_t tail;
2081 
2082 	/*
2083 	 * Is this a continuation of a read started earler?
2084 	 *
2085 	 * If so, we still hold the atomic_read_lock and the
2086 	 * termios_rwsem, and can just continue to copy data.
2087 	 */
2088 	if (*cookie) {
2089 		if (ldata->icanon && !L_EXTPROC(tty)) {
2090 			/*
2091 			 * If we have filled the user buffer, see
2092 			 * if we should skip an EOF character before
2093 			 * releasing the lock and returning done.
2094 			 */
2095 			if (!nr)
2096 				canon_skip_eof(tty);
2097 			else if (canon_copy_from_read_buf(tty, &kb, &nr))
2098 				return kb - kbuf;
2099 		} else {
2100 			if (copy_from_read_buf(tty, &kb, &nr))
2101 				return kb - kbuf;
2102 		}
2103 
2104 		/* No more data - release locks and stop retries */
2105 		n_tty_kick_worker(tty);
2106 		n_tty_check_unthrottle(tty);
2107 		up_read(&tty->termios_rwsem);
2108 		mutex_unlock(&ldata->atomic_read_lock);
2109 		*cookie = NULL;
2110 		return kb - kbuf;
2111 	}
2112 
2113 	c = job_control(tty, file);
2114 	if (c < 0)
2115 		return c;
2116 
2117 	/*
2118 	 *	Internal serialization of reads.
2119 	 */
2120 	if (file->f_flags & O_NONBLOCK) {
2121 		if (!mutex_trylock(&ldata->atomic_read_lock))
2122 			return -EAGAIN;
2123 	} else {
2124 		if (mutex_lock_interruptible(&ldata->atomic_read_lock))
2125 			return -ERESTARTSYS;
2126 	}
2127 
2128 	down_read(&tty->termios_rwsem);
2129 
2130 	minimum = time = 0;
2131 	timeout = MAX_SCHEDULE_TIMEOUT;
2132 	if (!ldata->icanon) {
2133 		minimum = MIN_CHAR(tty);
2134 		if (minimum) {
2135 			time = (HZ / 10) * TIME_CHAR(tty);
2136 		} else {
2137 			timeout = (HZ / 10) * TIME_CHAR(tty);
2138 			minimum = 1;
2139 		}
2140 	}
2141 
2142 	packet = tty->ctrl.packet;
2143 	tail = ldata->read_tail;
2144 
2145 	add_wait_queue(&tty->read_wait, &wait);
2146 	while (nr) {
2147 		/* First test for status change. */
2148 		if (packet && tty->link->ctrl.pktstatus) {
2149 			unsigned char cs;
2150 			if (kb != kbuf)
2151 				break;
2152 			spin_lock_irq(&tty->link->ctrl.lock);
2153 			cs = tty->link->ctrl.pktstatus;
2154 			tty->link->ctrl.pktstatus = 0;
2155 			spin_unlock_irq(&tty->link->ctrl.lock);
2156 			*kb++ = cs;
2157 			nr--;
2158 			break;
2159 		}
2160 
2161 		if (!input_available_p(tty, 0)) {
2162 			up_read(&tty->termios_rwsem);
2163 			tty_buffer_flush_work(tty->port);
2164 			down_read(&tty->termios_rwsem);
2165 			if (!input_available_p(tty, 0)) {
2166 				if (test_bit(TTY_OTHER_CLOSED, &tty->flags)) {
2167 					retval = -EIO;
2168 					break;
2169 				}
2170 				if (tty_hung_up_p(file))
2171 					break;
2172 				/*
2173 				 * Abort readers for ttys which never actually
2174 				 * get hung up.  See __tty_hangup().
2175 				 */
2176 				if (test_bit(TTY_HUPPING, &tty->flags))
2177 					break;
2178 				if (!timeout)
2179 					break;
2180 				if (tty_io_nonblock(tty, file)) {
2181 					retval = -EAGAIN;
2182 					break;
2183 				}
2184 				if (signal_pending(current)) {
2185 					retval = -ERESTARTSYS;
2186 					break;
2187 				}
2188 				up_read(&tty->termios_rwsem);
2189 
2190 				timeout = wait_woken(&wait, TASK_INTERRUPTIBLE,
2191 						timeout);
2192 
2193 				down_read(&tty->termios_rwsem);
2194 				continue;
2195 			}
2196 		}
2197 
2198 		if (ldata->icanon && !L_EXTPROC(tty)) {
2199 			if (canon_copy_from_read_buf(tty, &kb, &nr))
2200 				goto more_to_be_read;
2201 		} else {
2202 			/* Deal with packet mode. */
2203 			if (packet && kb == kbuf) {
2204 				*kb++ = TIOCPKT_DATA;
2205 				nr--;
2206 			}
2207 
2208 			/*
2209 			 * Copy data, and if there is more to be had
2210 			 * and we have nothing more to wait for, then
2211 			 * let's mark us for retries.
2212 			 *
2213 			 * NOTE! We return here with both the termios_sem
2214 			 * and atomic_read_lock still held, the retries
2215 			 * will release them when done.
2216 			 */
2217 			if (copy_from_read_buf(tty, &kb, &nr) && kb - kbuf >= minimum) {
2218 more_to_be_read:
2219 				remove_wait_queue(&tty->read_wait, &wait);
2220 				*cookie = cookie;
2221 				return kb - kbuf;
2222 			}
2223 		}
2224 
2225 		n_tty_check_unthrottle(tty);
2226 
2227 		if (kb - kbuf >= minimum)
2228 			break;
2229 		if (time)
2230 			timeout = time;
2231 	}
2232 	if (tail != ldata->read_tail)
2233 		n_tty_kick_worker(tty);
2234 	up_read(&tty->termios_rwsem);
2235 
2236 	remove_wait_queue(&tty->read_wait, &wait);
2237 	mutex_unlock(&ldata->atomic_read_lock);
2238 
2239 	if (kb - kbuf)
2240 		retval = kb - kbuf;
2241 
2242 	return retval;
2243 }
2244 
2245 /**
2246  * n_tty_write		-	write function for tty
2247  * @tty: tty device
2248  * @file: file object
2249  * @buf: userspace buffer pointer
2250  * @nr: size of I/O
2251  *
2252  * Write function of the terminal device. This is serialized with respect to
2253  * other write callers but not to termios changes, reads and other such events.
2254  * Since the receive code will echo characters, thus calling driver write
2255  * methods, the %output_lock is used in the output processing functions called
2256  * here as well as in the echo processing function to protect the column state
2257  * and space left in the buffer.
2258  *
2259  * This code must be sure never to sleep through a hangup.
2260  *
2261  * Locking: output_lock to protect column state and space left
2262  *	 (note that the process_output*() functions take this lock themselves)
2263  */
2264 
2265 static ssize_t n_tty_write(struct tty_struct *tty, struct file *file,
2266 			   const unsigned char *buf, size_t nr)
2267 {
2268 	const unsigned char *b = buf;
2269 	DEFINE_WAIT_FUNC(wait, woken_wake_function);
2270 	int c;
2271 	ssize_t retval = 0;
2272 
2273 	/* Job control check -- must be done at start (POSIX.1 7.1.1.4). */
2274 	if (L_TOSTOP(tty) && file->f_op->write_iter != redirected_tty_write) {
2275 		retval = tty_check_change(tty);
2276 		if (retval)
2277 			return retval;
2278 	}
2279 
2280 	down_read(&tty->termios_rwsem);
2281 
2282 	/* Write out any echoed characters that are still pending */
2283 	process_echoes(tty);
2284 
2285 	add_wait_queue(&tty->write_wait, &wait);
2286 	while (1) {
2287 		if (signal_pending(current)) {
2288 			retval = -ERESTARTSYS;
2289 			break;
2290 		}
2291 		if (tty_hung_up_p(file) || (tty->link && !tty->link->count)) {
2292 			retval = -EIO;
2293 			break;
2294 		}
2295 		if (O_OPOST(tty)) {
2296 			while (nr > 0) {
2297 				ssize_t num = process_output_block(tty, b, nr);
2298 				if (num < 0) {
2299 					if (num == -EAGAIN)
2300 						break;
2301 					retval = num;
2302 					goto break_out;
2303 				}
2304 				b += num;
2305 				nr -= num;
2306 				if (nr == 0)
2307 					break;
2308 				c = *b;
2309 				if (process_output(c, tty) < 0)
2310 					break;
2311 				b++; nr--;
2312 			}
2313 			if (tty->ops->flush_chars)
2314 				tty->ops->flush_chars(tty);
2315 		} else {
2316 			struct n_tty_data *ldata = tty->disc_data;
2317 
2318 			while (nr > 0) {
2319 				mutex_lock(&ldata->output_lock);
2320 				c = tty->ops->write(tty, b, nr);
2321 				mutex_unlock(&ldata->output_lock);
2322 				if (c < 0) {
2323 					retval = c;
2324 					goto break_out;
2325 				}
2326 				if (!c)
2327 					break;
2328 				b += c;
2329 				nr -= c;
2330 			}
2331 		}
2332 		if (!nr)
2333 			break;
2334 		if (tty_io_nonblock(tty, file)) {
2335 			retval = -EAGAIN;
2336 			break;
2337 		}
2338 		up_read(&tty->termios_rwsem);
2339 
2340 		wait_woken(&wait, TASK_INTERRUPTIBLE, MAX_SCHEDULE_TIMEOUT);
2341 
2342 		down_read(&tty->termios_rwsem);
2343 	}
2344 break_out:
2345 	remove_wait_queue(&tty->write_wait, &wait);
2346 	if (nr && tty->fasync)
2347 		set_bit(TTY_DO_WRITE_WAKEUP, &tty->flags);
2348 	up_read(&tty->termios_rwsem);
2349 	return (b - buf) ? b - buf : retval;
2350 }
2351 
2352 /**
2353  * n_tty_poll		-	poll method for N_TTY
2354  * @tty: terminal device
2355  * @file: file accessing it
2356  * @wait: poll table
2357  *
2358  * Called when the line discipline is asked to poll() for data or for special
2359  * events. This code is not serialized with respect to other events save
2360  * open/close.
2361  *
2362  * This code must be sure never to sleep through a hangup.
2363  *
2364  * Locking: called without the kernel lock held -- fine.
2365  */
2366 static __poll_t n_tty_poll(struct tty_struct *tty, struct file *file,
2367 							poll_table *wait)
2368 {
2369 	__poll_t mask = 0;
2370 
2371 	poll_wait(file, &tty->read_wait, wait);
2372 	poll_wait(file, &tty->write_wait, wait);
2373 	if (input_available_p(tty, 1))
2374 		mask |= EPOLLIN | EPOLLRDNORM;
2375 	else {
2376 		tty_buffer_flush_work(tty->port);
2377 		if (input_available_p(tty, 1))
2378 			mask |= EPOLLIN | EPOLLRDNORM;
2379 	}
2380 	if (tty->ctrl.packet && tty->link->ctrl.pktstatus)
2381 		mask |= EPOLLPRI | EPOLLIN | EPOLLRDNORM;
2382 	if (test_bit(TTY_OTHER_CLOSED, &tty->flags))
2383 		mask |= EPOLLHUP;
2384 	if (tty_hung_up_p(file))
2385 		mask |= EPOLLHUP;
2386 	if (tty->ops->write && !tty_is_writelocked(tty) &&
2387 			tty_chars_in_buffer(tty) < WAKEUP_CHARS &&
2388 			tty_write_room(tty) > 0)
2389 		mask |= EPOLLOUT | EPOLLWRNORM;
2390 	return mask;
2391 }
2392 
2393 static unsigned long inq_canon(struct n_tty_data *ldata)
2394 {
2395 	size_t nr, head, tail;
2396 
2397 	if (ldata->canon_head == ldata->read_tail)
2398 		return 0;
2399 	head = ldata->canon_head;
2400 	tail = ldata->read_tail;
2401 	nr = head - tail;
2402 	/* Skip EOF-chars.. */
2403 	while (MASK(head) != MASK(tail)) {
2404 		if (test_bit(tail & (N_TTY_BUF_SIZE - 1), ldata->read_flags) &&
2405 		    read_buf(ldata, tail) == __DISABLED_CHAR)
2406 			nr--;
2407 		tail++;
2408 	}
2409 	return nr;
2410 }
2411 
2412 static int n_tty_ioctl(struct tty_struct *tty, unsigned int cmd,
2413 		       unsigned long arg)
2414 {
2415 	struct n_tty_data *ldata = tty->disc_data;
2416 	int retval;
2417 
2418 	switch (cmd) {
2419 	case TIOCOUTQ:
2420 		return put_user(tty_chars_in_buffer(tty), (int __user *) arg);
2421 	case TIOCINQ:
2422 		down_write(&tty->termios_rwsem);
2423 		if (L_ICANON(tty) && !L_EXTPROC(tty))
2424 			retval = inq_canon(ldata);
2425 		else
2426 			retval = read_cnt(ldata);
2427 		up_write(&tty->termios_rwsem);
2428 		return put_user(retval, (unsigned int __user *) arg);
2429 	default:
2430 		return n_tty_ioctl_helper(tty, cmd, arg);
2431 	}
2432 }
2433 
2434 static struct tty_ldisc_ops n_tty_ops = {
2435 	.owner		 = THIS_MODULE,
2436 	.num		 = N_TTY,
2437 	.name            = "n_tty",
2438 	.open            = n_tty_open,
2439 	.close           = n_tty_close,
2440 	.flush_buffer    = n_tty_flush_buffer,
2441 	.read            = n_tty_read,
2442 	.write           = n_tty_write,
2443 	.ioctl           = n_tty_ioctl,
2444 	.set_termios     = n_tty_set_termios,
2445 	.poll            = n_tty_poll,
2446 	.receive_buf     = n_tty_receive_buf,
2447 	.write_wakeup    = n_tty_write_wakeup,
2448 	.receive_buf2	 = n_tty_receive_buf2,
2449 };
2450 
2451 /**
2452  *	n_tty_inherit_ops	-	inherit N_TTY methods
2453  *	@ops: struct tty_ldisc_ops where to save N_TTY methods
2454  *
2455  *	Enables a 'subclass' line discipline to 'inherit' N_TTY methods.
2456  */
2457 
2458 void n_tty_inherit_ops(struct tty_ldisc_ops *ops)
2459 {
2460 	*ops = n_tty_ops;
2461 	ops->owner = NULL;
2462 }
2463 EXPORT_SYMBOL_GPL(n_tty_inherit_ops);
2464 
2465 void __init n_tty_init(void)
2466 {
2467 	tty_register_ldisc(&n_tty_ops);
2468 }
2469