Linux Audio

Check our new training course

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