Linux Audio

Check our new training course

Loading...
v6.8
   1// SPDX-License-Identifier: GPL-2.0
   2/*
   3 *  Copyright (C) 1991, 1992  Linus Torvalds
   4 */
   5
   6/*
   7 * 'tty_io.c' gives an orthogonal feeling to tty's, be they consoles
   8 * or rs-channels. It also implements echoing, cooked mode etc.
   9 *
  10 * Kill-line thanks to John T Kohl, who also corrected VMIN = VTIME = 0.
  11 *
  12 * Modified by Theodore Ts'o, 9/14/92, to dynamically allocate the
  13 * tty_struct and tty_queue structures.  Previously there was an array
  14 * of 256 tty_struct's which was statically allocated, and the
  15 * tty_queue structures were allocated at boot time.  Both are now
  16 * dynamically allocated only when the tty is open.
  17 *
  18 * Also restructured routines so that there is more of a separation
  19 * between the high-level tty routines (tty_io.c and tty_ioctl.c) and
  20 * the low-level tty routines (serial.c, pty.c, console.c).  This
  21 * makes for cleaner and more compact code.  -TYT, 9/17/92
  22 *
  23 * Modified by Fred N. van Kempen, 01/29/93, to add line disciplines
  24 * which can be dynamically activated and de-activated by the line
  25 * discipline handling modules (like SLIP).
  26 *
  27 * NOTE: pay no attention to the line discipline code (yet); its
  28 * interface is still subject to change in this version...
  29 * -- TYT, 1/31/92
  30 *
  31 * Added functionality to the OPOST tty handling.  No delays, but all
  32 * other bits should be there.
  33 *	-- Nick Holloway <alfie@dcs.warwick.ac.uk>, 27th May 1993.
  34 *
  35 * Rewrote canonical mode and added more termios flags.
  36 *	-- julian@uhunix.uhcc.hawaii.edu (J. Cowley), 13Jan94
  37 *
  38 * Reorganized FASYNC support so mouse code can share it.
  39 *	-- ctm@ardi.com, 9Sep95
  40 *
  41 * New TIOCLINUX variants added.
  42 *	-- mj@k332.feld.cvut.cz, 19-Nov-95
  43 *
  44 * Restrict vt switching via ioctl()
  45 *      -- grif@cs.ucr.edu, 5-Dec-95
  46 *
  47 * Move console and virtual terminal code to more appropriate files,
  48 * implement CONFIG_VT and generalize console device interface.
  49 *	-- Marko Kohtala <Marko.Kohtala@hut.fi>, March 97
  50 *
  51 * Rewrote tty_init_dev and tty_release_dev to eliminate races.
  52 *	-- Bill Hawes <whawes@star.net>, June 97
  53 *
  54 * Added devfs support.
  55 *      -- C. Scott Ananian <cananian@alumni.princeton.edu>, 13-Jan-1998
  56 *
  57 * Added support for a Unix98-style ptmx device.
  58 *      -- C. Scott Ananian <cananian@alumni.princeton.edu>, 14-Jan-1998
  59 *
  60 * Reduced memory usage for older ARM systems
  61 *      -- Russell King <rmk@arm.linux.org.uk>
  62 *
  63 * Move do_SAK() into process context.  Less stack use in devfs functions.
  64 * alloc_tty_struct() always uses kmalloc()
  65 *			 -- Andrew Morton <andrewm@uow.edu.eu> 17Mar01
  66 */
  67
  68#include <linux/types.h>
  69#include <linux/major.h>
  70#include <linux/errno.h>
  71#include <linux/signal.h>
  72#include <linux/fcntl.h>
  73#include <linux/sched/signal.h>
  74#include <linux/sched/task.h>
  75#include <linux/interrupt.h>
  76#include <linux/tty.h>
  77#include <linux/tty_driver.h>
  78#include <linux/tty_flip.h>
  79#include <linux/devpts_fs.h>
  80#include <linux/file.h>
  81#include <linux/fdtable.h>
  82#include <linux/console.h>
  83#include <linux/timer.h>
  84#include <linux/ctype.h>
  85#include <linux/kd.h>
  86#include <linux/mm.h>
  87#include <linux/string.h>
  88#include <linux/slab.h>
  89#include <linux/poll.h>
  90#include <linux/ppp-ioctl.h>
  91#include <linux/proc_fs.h>
  92#include <linux/init.h>
  93#include <linux/module.h>
  94#include <linux/device.h>
  95#include <linux/wait.h>
  96#include <linux/bitops.h>
  97#include <linux/delay.h>
  98#include <linux/seq_file.h>
  99#include <linux/serial.h>
 100#include <linux/ratelimit.h>
 101#include <linux/compat.h>
 
 102#include <linux/uaccess.h>
 103#include <linux/termios_internal.h>
 104#include <linux/fs.h>
 105
 106#include <linux/kbd_kern.h>
 107#include <linux/vt_kern.h>
 108#include <linux/selection.h>
 109
 110#include <linux/kmod.h>
 111#include <linux/nsproxy.h>
 112#include "tty.h"
 113
 114#undef TTY_DEBUG_HANGUP
 115#ifdef TTY_DEBUG_HANGUP
 116# define tty_debug_hangup(tty, f, args...)	tty_debug(tty, f, ##args)
 117#else
 118# define tty_debug_hangup(tty, f, args...)	do { } while (0)
 119#endif
 120
 121#define TTY_PARANOIA_CHECK 1
 122#define CHECK_TTY_COUNT 1
 123
 124struct ktermios tty_std_termios = {	/* for the benefit of tty drivers  */
 125	.c_iflag = ICRNL | IXON,
 126	.c_oflag = OPOST | ONLCR,
 127	.c_cflag = B38400 | CS8 | CREAD | HUPCL,
 128	.c_lflag = ISIG | ICANON | ECHO | ECHOE | ECHOK |
 129		   ECHOCTL | ECHOKE | IEXTEN,
 130	.c_cc = INIT_C_CC,
 131	.c_ispeed = 38400,
 132	.c_ospeed = 38400,
 133	/* .c_line = N_TTY, */
 134};
 
 135EXPORT_SYMBOL(tty_std_termios);
 136
 137/* This list gets poked at by procfs and various bits of boot up code. This
 138 * could do with some rationalisation such as pulling the tty proc function
 139 * into this file.
 140 */
 141
 142LIST_HEAD(tty_drivers);			/* linked list of tty drivers */
 143
 144/* Mutex to protect creating and releasing a tty */
 145DEFINE_MUTEX(tty_mutex);
 146
 147static ssize_t tty_read(struct kiocb *, struct iov_iter *);
 148static ssize_t tty_write(struct kiocb *, struct iov_iter *);
 
 
 149static __poll_t tty_poll(struct file *, poll_table *);
 150static int tty_open(struct inode *, struct file *);
 
 151#ifdef CONFIG_COMPAT
 152static long tty_compat_ioctl(struct file *file, unsigned int cmd,
 153				unsigned long arg);
 154#else
 155#define tty_compat_ioctl NULL
 156#endif
 157static int __tty_fasync(int fd, struct file *filp, int on);
 158static int tty_fasync(int fd, struct file *filp, int on);
 159static void release_tty(struct tty_struct *tty, int idx);
 160
 161/**
 162 * free_tty_struct - free a disused tty
 163 * @tty: tty struct to free
 164 *
 165 * Free the write buffers, tty queue and tty memory itself.
 166 *
 167 * Locking: none. Must be called after tty is definitely unused
 168 */
 
 169static void free_tty_struct(struct tty_struct *tty)
 170{
 171	tty_ldisc_deinit(tty);
 172	put_device(tty->dev);
 173	kvfree(tty->write_buf);
 
 174	kfree(tty);
 175}
 176
 177static inline struct tty_struct *file_tty(struct file *file)
 178{
 179	return ((struct tty_file_private *)file->private_data)->tty;
 180}
 181
 182int tty_alloc_file(struct file *file)
 183{
 184	struct tty_file_private *priv;
 185
 186	priv = kmalloc(sizeof(*priv), GFP_KERNEL);
 187	if (!priv)
 188		return -ENOMEM;
 189
 190	file->private_data = priv;
 191
 192	return 0;
 193}
 194
 195/* Associate a new file with the tty structure */
 196void tty_add_file(struct tty_struct *tty, struct file *file)
 197{
 198	struct tty_file_private *priv = file->private_data;
 199
 200	priv->tty = tty;
 201	priv->file = file;
 202
 203	spin_lock(&tty->files_lock);
 204	list_add(&priv->list, &tty->tty_files);
 205	spin_unlock(&tty->files_lock);
 206}
 207
 208/**
 209 * tty_free_file - free file->private_data
 210 * @file: to free private_data of
 211 *
 212 * This shall be used only for fail path handling when tty_add_file was not
 213 * called yet.
 214 */
 215void tty_free_file(struct file *file)
 216{
 217	struct tty_file_private *priv = file->private_data;
 218
 219	file->private_data = NULL;
 220	kfree(priv);
 221}
 222
 223/* Delete file from its tty */
 224static void tty_del_file(struct file *file)
 225{
 226	struct tty_file_private *priv = file->private_data;
 227	struct tty_struct *tty = priv->tty;
 228
 229	spin_lock(&tty->files_lock);
 230	list_del(&priv->list);
 231	spin_unlock(&tty->files_lock);
 232	tty_free_file(file);
 233}
 234
 235/**
 236 * tty_name - return tty naming
 237 * @tty: tty structure
 238 *
 239 * Convert a tty structure into a name. The name reflects the kernel naming
 240 * policy and if udev is in use may not reflect user space
 241 *
 242 * Locking: none
 243 */
 
 244const char *tty_name(const struct tty_struct *tty)
 245{
 246	if (!tty) /* Hmm.  NULL pointer.  That's fun. */
 247		return "NULL tty";
 248	return tty->name;
 249}
 
 250EXPORT_SYMBOL(tty_name);
 251
 252const char *tty_driver_name(const struct tty_struct *tty)
 253{
 254	if (!tty || !tty->driver)
 255		return "";
 256	return tty->driver->name;
 257}
 258
 259static int tty_paranoia_check(struct tty_struct *tty, struct inode *inode,
 260			      const char *routine)
 261{
 262#ifdef TTY_PARANOIA_CHECK
 263	if (!tty) {
 264		pr_warn("(%d:%d): %s: NULL tty\n",
 265			imajor(inode), iminor(inode), routine);
 266		return 1;
 267	}
 
 
 
 
 
 268#endif
 269	return 0;
 270}
 271
 272/* Caller must hold tty_lock */
 273static void check_tty_count(struct tty_struct *tty, const char *routine)
 274{
 275#ifdef CHECK_TTY_COUNT
 276	struct list_head *p;
 277	int count = 0, kopen_count = 0;
 278
 279	spin_lock(&tty->files_lock);
 280	list_for_each(p, &tty->tty_files) {
 281		count++;
 282	}
 283	spin_unlock(&tty->files_lock);
 284	if (tty->driver->type == TTY_DRIVER_TYPE_PTY &&
 285	    tty->driver->subtype == PTY_TYPE_SLAVE &&
 286	    tty->link && tty->link->count)
 287		count++;
 288	if (tty_port_kopened(tty->port))
 289		kopen_count++;
 290	if (tty->count != (count + kopen_count)) {
 291		tty_warn(tty, "%s: tty->count(%d) != (#fd's(%d) + #kopen's(%d))\n",
 292			 routine, tty->count, count, kopen_count);
 
 293	}
 294#endif
 
 295}
 296
 297/**
 298 * get_tty_driver - find device of a tty
 299 * @device: device identifier
 300 * @index: returns the index of the tty
 301 *
 302 * This routine returns a tty driver structure, given a device number and also
 303 * passes back the index number.
 304 *
 305 * Locking: caller must hold tty_mutex
 306 */
 
 307static struct tty_driver *get_tty_driver(dev_t device, int *index)
 308{
 309	struct tty_driver *p;
 310
 311	list_for_each_entry(p, &tty_drivers, tty_drivers) {
 312		dev_t base = MKDEV(p->major, p->minor_start);
 313
 314		if (device < base || device >= base + p->num)
 315			continue;
 316		*index = device - base;
 317		return tty_driver_kref_get(p);
 318	}
 319	return NULL;
 320}
 321
 322/**
 323 * tty_dev_name_to_number - return dev_t for device name
 324 * @name: user space name of device under /dev
 325 * @number: pointer to dev_t that this function will populate
 326 *
 327 * This function converts device names like ttyS0 or ttyUSB1 into dev_t like
 328 * (4, 64) or (188, 1). If no corresponding driver is registered then the
 329 * function returns -%ENODEV.
 330 *
 331 * Locking: this acquires tty_mutex to protect the tty_drivers list from
 332 *	being modified while we are traversing it, and makes sure to
 333 *	release it before exiting.
 334 */
 335int tty_dev_name_to_number(const char *name, dev_t *number)
 336{
 337	struct tty_driver *p;
 338	int ret;
 339	int index, prefix_length = 0;
 340	const char *str;
 341
 342	for (str = name; *str && !isdigit(*str); str++)
 343		;
 344
 345	if (!*str)
 346		return -EINVAL;
 347
 348	ret = kstrtoint(str, 10, &index);
 349	if (ret)
 350		return ret;
 351
 352	prefix_length = str - name;
 353	mutex_lock(&tty_mutex);
 354
 355	list_for_each_entry(p, &tty_drivers, tty_drivers)
 356		if (prefix_length == strlen(p->name) && strncmp(name,
 357					p->name, prefix_length) == 0) {
 358			if (index < p->num) {
 359				*number = MKDEV(p->major, p->minor_start + index);
 360				goto out;
 361			}
 362		}
 363
 364	/* if here then driver wasn't found */
 365	ret = -ENODEV;
 366out:
 367	mutex_unlock(&tty_mutex);
 368	return ret;
 369}
 370EXPORT_SYMBOL_GPL(tty_dev_name_to_number);
 371
 372#ifdef CONFIG_CONSOLE_POLL
 373
 374/**
 375 * tty_find_polling_driver - find device of a polled tty
 376 * @name: name string to match
 377 * @line: pointer to resulting tty line nr
 378 *
 379 * This routine returns a tty driver structure, given a name and the condition
 380 * that the tty driver is capable of polled operation.
 
 381 */
 382struct tty_driver *tty_find_polling_driver(char *name, int *line)
 383{
 384	struct tty_driver *p, *res = NULL;
 385	int tty_line = 0;
 386	int len;
 387	char *str, *stp;
 388
 389	for (str = name; *str; str++)
 390		if ((*str >= '0' && *str <= '9') || *str == ',')
 391			break;
 392	if (!*str)
 393		return NULL;
 394
 395	len = str - name;
 396	tty_line = simple_strtoul(str, &str, 10);
 397
 398	mutex_lock(&tty_mutex);
 399	/* Search through the tty devices to look for a match */
 400	list_for_each_entry(p, &tty_drivers, tty_drivers) {
 401		if (!len || strncmp(name, p->name, len) != 0)
 402			continue;
 403		stp = str;
 404		if (*stp == ',')
 405			stp++;
 406		if (*stp == '\0')
 407			stp = NULL;
 408
 409		if (tty_line >= 0 && tty_line < p->num && p->ops &&
 410		    p->ops->poll_init && !p->ops->poll_init(p, tty_line, stp)) {
 411			res = tty_driver_kref_get(p);
 412			*line = tty_line;
 413			break;
 414		}
 415	}
 416	mutex_unlock(&tty_mutex);
 417
 418	return res;
 419}
 420EXPORT_SYMBOL_GPL(tty_find_polling_driver);
 421#endif
 422
 423static ssize_t hung_up_tty_read(struct kiocb *iocb, struct iov_iter *to)
 
 424{
 425	return 0;
 426}
 427
 428static ssize_t hung_up_tty_write(struct kiocb *iocb, struct iov_iter *from)
 
 429{
 430	return -EIO;
 431}
 432
 433/* No kernel lock held - none needed ;) */
 434static __poll_t hung_up_tty_poll(struct file *filp, poll_table *wait)
 435{
 436	return EPOLLIN | EPOLLOUT | EPOLLERR | EPOLLHUP | EPOLLRDNORM | EPOLLWRNORM;
 437}
 438
 439static long hung_up_tty_ioctl(struct file *file, unsigned int cmd,
 440		unsigned long arg)
 441{
 442	return cmd == TIOCSPGRP ? -ENOTTY : -EIO;
 443}
 444
 445static long hung_up_tty_compat_ioctl(struct file *file,
 446				     unsigned int cmd, unsigned long arg)
 447{
 448	return cmd == TIOCSPGRP ? -ENOTTY : -EIO;
 449}
 450
 451static int hung_up_tty_fasync(int fd, struct file *file, int on)
 452{
 453	return -ENOTTY;
 454}
 455
 456static void tty_show_fdinfo(struct seq_file *m, struct file *file)
 457{
 458	struct tty_struct *tty = file_tty(file);
 459
 460	if (tty && tty->ops && tty->ops->show_fdinfo)
 461		tty->ops->show_fdinfo(tty, m);
 462}
 463
 464static const struct file_operations tty_fops = {
 465	.llseek		= no_llseek,
 466	.read_iter	= tty_read,
 467	.write_iter	= tty_write,
 468	.splice_read	= copy_splice_read,
 469	.splice_write	= iter_file_splice_write,
 470	.poll		= tty_poll,
 471	.unlocked_ioctl	= tty_ioctl,
 472	.compat_ioctl	= tty_compat_ioctl,
 473	.open		= tty_open,
 474	.release	= tty_release,
 475	.fasync		= tty_fasync,
 476	.show_fdinfo	= tty_show_fdinfo,
 477};
 478
 479static const struct file_operations console_fops = {
 480	.llseek		= no_llseek,
 481	.read_iter	= tty_read,
 482	.write_iter	= redirected_tty_write,
 483	.splice_read	= copy_splice_read,
 484	.splice_write	= iter_file_splice_write,
 485	.poll		= tty_poll,
 486	.unlocked_ioctl	= tty_ioctl,
 487	.compat_ioctl	= tty_compat_ioctl,
 488	.open		= tty_open,
 489	.release	= tty_release,
 490	.fasync		= tty_fasync,
 491};
 492
 493static const struct file_operations hung_up_tty_fops = {
 494	.llseek		= no_llseek,
 495	.read_iter	= hung_up_tty_read,
 496	.write_iter	= hung_up_tty_write,
 497	.poll		= hung_up_tty_poll,
 498	.unlocked_ioctl	= hung_up_tty_ioctl,
 499	.compat_ioctl	= hung_up_tty_compat_ioctl,
 500	.release	= tty_release,
 501	.fasync		= hung_up_tty_fasync,
 502};
 503
 504static DEFINE_SPINLOCK(redirect_lock);
 505static struct file *redirect;
 506
 
 
 507/**
 508 * tty_wakeup - request more data
 509 * @tty: terminal
 510 *
 511 * Internal and external helper for wakeups of tty. This function informs the
 512 * line discipline if present that the driver is ready to receive more output
 513 * data.
 514 */
 
 515void tty_wakeup(struct tty_struct *tty)
 516{
 517	struct tty_ldisc *ld;
 518
 519	if (test_bit(TTY_DO_WRITE_WAKEUP, &tty->flags)) {
 520		ld = tty_ldisc_ref(tty);
 521		if (ld) {
 522			if (ld->ops->write_wakeup)
 523				ld->ops->write_wakeup(tty);
 524			tty_ldisc_deref(ld);
 525		}
 526	}
 527	wake_up_interruptible_poll(&tty->write_wait, EPOLLOUT);
 528}
 529EXPORT_SYMBOL_GPL(tty_wakeup);
 530
 531/**
 532 * tty_release_redirect - Release a redirect on a pty if present
 533 * @tty: tty device
 534 *
 535 * This is available to the pty code so if the master closes, if the slave is a
 536 * redirect it can release the redirect.
 537 */
 538static struct file *tty_release_redirect(struct tty_struct *tty)
 539{
 540	struct file *f = NULL;
 541
 542	spin_lock(&redirect_lock);
 543	if (redirect && file_tty(redirect) == tty) {
 544		f = redirect;
 545		redirect = NULL;
 546	}
 547	spin_unlock(&redirect_lock);
 548
 549	return f;
 550}
 551
 552/**
 553 * __tty_hangup - actual handler for hangup events
 554 * @tty: tty device
 555 * @exit_session: if non-zero, signal all foreground group processes
 556 *
 557 * This can be called by a "kworker" kernel thread. That is process synchronous
 558 * but doesn't hold any locks, so we need to make sure we have the appropriate
 559 * locks for what we're doing.
 560 *
 561 * The hangup event clears any pending redirections onto the hung up device. It
 562 * ensures future writes will error and it does the needed line discipline
 563 * hangup and signal delivery. The tty object itself remains intact.
 564 *
 565 * Locking:
 566 *  * BTM
 567 *
 568 *   * redirect lock for undoing redirection
 569 *   * file list lock for manipulating list of ttys
 570 *   * tty_ldiscs_lock from called functions
 571 *   * termios_rwsem resetting termios data
 572 *   * tasklist_lock to walk task list for hangup event
 573 *
 574 *    * ->siglock to protect ->signal/->sighand
 575 *
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 576 */
 577static void __tty_hangup(struct tty_struct *tty, int exit_session)
 578{
 579	struct file *cons_filp = NULL;
 580	struct file *filp, *f;
 581	struct tty_file_private *priv;
 582	int    closecount = 0, n;
 583	int refs;
 584
 585	if (!tty)
 586		return;
 587
 588	f = tty_release_redirect(tty);
 
 
 
 
 
 
 589
 590	tty_lock(tty);
 591
 592	if (test_bit(TTY_HUPPED, &tty->flags)) {
 593		tty_unlock(tty);
 594		return;
 595	}
 596
 597	/*
 598	 * Some console devices aren't actually hung up for technical and
 599	 * historical reasons, which can lead to indefinite interruptible
 600	 * sleep in n_tty_read().  The following explicitly tells
 601	 * n_tty_read() to abort readers.
 602	 */
 603	set_bit(TTY_HUPPING, &tty->flags);
 604
 605	/* inuse_filps is protected by the single tty lock,
 606	 * this really needs to change if we want to flush the
 607	 * workqueue with the lock held.
 608	 */
 609	check_tty_count(tty, "tty_hangup");
 610
 611	spin_lock(&tty->files_lock);
 612	/* This breaks for file handles being sent over AF_UNIX sockets ? */
 613	list_for_each_entry(priv, &tty->tty_files, list) {
 614		filp = priv->file;
 615		if (filp->f_op->write_iter == redirected_tty_write)
 616			cons_filp = filp;
 617		if (filp->f_op->write_iter != tty_write)
 618			continue;
 619		closecount++;
 620		__tty_fasync(-1, filp, 0);	/* can't block */
 621		filp->f_op = &hung_up_tty_fops;
 622	}
 623	spin_unlock(&tty->files_lock);
 624
 625	refs = tty_signal_session_leader(tty, exit_session);
 626	/* Account for the p->signal references we killed */
 627	while (refs--)
 628		tty_kref_put(tty);
 629
 630	tty_ldisc_hangup(tty, cons_filp != NULL);
 631
 632	spin_lock_irq(&tty->ctrl.lock);
 633	clear_bit(TTY_THROTTLED, &tty->flags);
 634	clear_bit(TTY_DO_WRITE_WAKEUP, &tty->flags);
 635	put_pid(tty->ctrl.session);
 636	put_pid(tty->ctrl.pgrp);
 637	tty->ctrl.session = NULL;
 638	tty->ctrl.pgrp = NULL;
 639	tty->ctrl.pktstatus = 0;
 640	spin_unlock_irq(&tty->ctrl.lock);
 641
 642	/*
 643	 * If one of the devices matches a console pointer, we
 644	 * cannot just call hangup() because that will cause
 645	 * tty->count and state->count to go out of sync.
 646	 * So we just call close() the right number of times.
 647	 */
 648	if (cons_filp) {
 649		if (tty->ops->close)
 650			for (n = 0; n < closecount; n++)
 651				tty->ops->close(tty, cons_filp);
 652	} else if (tty->ops->hangup)
 653		tty->ops->hangup(tty);
 654	/*
 655	 * We don't want to have driver/ldisc interactions beyond the ones
 656	 * we did here. The driver layer expects no calls after ->hangup()
 657	 * from the ldisc side, which is now guaranteed.
 658	 */
 659	set_bit(TTY_HUPPED, &tty->flags);
 660	clear_bit(TTY_HUPPING, &tty->flags);
 661	tty_unlock(tty);
 662
 663	if (f)
 664		fput(f);
 665}
 666
 667static void do_tty_hangup(struct work_struct *work)
 668{
 669	struct tty_struct *tty =
 670		container_of(work, struct tty_struct, hangup_work);
 671
 672	__tty_hangup(tty, 0);
 673}
 674
 675/**
 676 * tty_hangup - trigger a hangup event
 677 * @tty: tty to hangup
 678 *
 679 * A carrier loss (virtual or otherwise) has occurred on @tty. Schedule a
 680 * hangup sequence to run after this event.
 681 */
 
 682void tty_hangup(struct tty_struct *tty)
 683{
 684	tty_debug_hangup(tty, "hangup\n");
 685	schedule_work(&tty->hangup_work);
 686}
 
 687EXPORT_SYMBOL(tty_hangup);
 688
 689/**
 690 * tty_vhangup - process vhangup
 691 * @tty: tty to hangup
 692 *
 693 * The user has asked via system call for the terminal to be hung up. We do
 694 * this synchronously so that when the syscall returns the process is complete.
 695 * That guarantee is necessary for security reasons.
 696 */
 
 697void tty_vhangup(struct tty_struct *tty)
 698{
 699	tty_debug_hangup(tty, "vhangup\n");
 700	__tty_hangup(tty, 0);
 701}
 
 702EXPORT_SYMBOL(tty_vhangup);
 703
 704
 705/**
 706 * tty_vhangup_self - process vhangup for own ctty
 707 *
 708 * Perform a vhangup on the current controlling tty
 709 */
 
 710void tty_vhangup_self(void)
 711{
 712	struct tty_struct *tty;
 713
 714	tty = get_current_tty();
 715	if (tty) {
 716		tty_vhangup(tty);
 717		tty_kref_put(tty);
 718	}
 719}
 720
 721/**
 722 * tty_vhangup_session - hangup session leader exit
 723 * @tty: tty to hangup
 724 *
 725 * The session leader is exiting and hanging up its controlling terminal.
 726 * Every process in the foreground process group is signalled %SIGHUP.
 727 *
 728 * We do this synchronously so that when the syscall returns the process is
 729 * complete. That guarantee is necessary for security reasons.
 730 */
 
 731void tty_vhangup_session(struct tty_struct *tty)
 732{
 733	tty_debug_hangup(tty, "session hangup\n");
 734	__tty_hangup(tty, 1);
 735}
 736
 737/**
 738 * tty_hung_up_p - was tty hung up
 739 * @filp: file pointer of tty
 740 *
 741 * Return: true if the tty has been subject to a vhangup or a carrier loss
 
 742 */
 
 743int tty_hung_up_p(struct file *filp)
 744{
 745	return (filp && filp->f_op == &hung_up_tty_fops);
 746}
 
 747EXPORT_SYMBOL(tty_hung_up_p);
 748
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 749void __stop_tty(struct tty_struct *tty)
 750{
 751	if (tty->flow.stopped)
 752		return;
 753	tty->flow.stopped = true;
 754	if (tty->ops->stop)
 755		tty->ops->stop(tty);
 756}
 757
 758/**
 759 * stop_tty - propagate flow control
 760 * @tty: tty to stop
 761 *
 762 * Perform flow control to the driver. May be called on an already stopped
 763 * device and will not re-call the &tty_driver->stop() method.
 764 *
 765 * This functionality is used by both the line disciplines for halting incoming
 766 * flow and by the driver. It may therefore be called from any context, may be
 767 * under the tty %atomic_write_lock but not always.
 768 *
 769 * Locking:
 770 *	flow.lock
 771 */
 772void stop_tty(struct tty_struct *tty)
 773{
 774	unsigned long flags;
 775
 776	spin_lock_irqsave(&tty->flow.lock, flags);
 777	__stop_tty(tty);
 778	spin_unlock_irqrestore(&tty->flow.lock, flags);
 779}
 780EXPORT_SYMBOL(stop_tty);
 781
 
 
 
 
 
 
 
 
 
 
 
 
 782void __start_tty(struct tty_struct *tty)
 783{
 784	if (!tty->flow.stopped || tty->flow.tco_stopped)
 785		return;
 786	tty->flow.stopped = false;
 787	if (tty->ops->start)
 788		tty->ops->start(tty);
 789	tty_wakeup(tty);
 790}
 791
 792/**
 793 * start_tty - propagate flow control
 794 * @tty: tty to start
 795 *
 796 * Start a tty that has been stopped if at all possible. If @tty was previously
 797 * stopped and is now being started, the &tty_driver->start() method is invoked
 798 * and the line discipline woken.
 799 *
 800 * Locking:
 801 *	flow.lock
 802 */
 803void start_tty(struct tty_struct *tty)
 804{
 805	unsigned long flags;
 806
 807	spin_lock_irqsave(&tty->flow.lock, flags);
 808	__start_tty(tty);
 809	spin_unlock_irqrestore(&tty->flow.lock, flags);
 810}
 811EXPORT_SYMBOL(start_tty);
 812
 813static void tty_update_time(struct tty_struct *tty, bool mtime)
 814{
 815	time64_t sec = ktime_get_real_seconds();
 816	struct tty_file_private *priv;
 817
 818	spin_lock(&tty->files_lock);
 819	list_for_each_entry(priv, &tty->tty_files, list) {
 820		struct inode *inode = file_inode(priv->file);
 821		struct timespec64 time = mtime ? inode_get_mtime(inode) : inode_get_atime(inode);
 822
 823		/*
 824		 * We only care if the two values differ in anything other than the
 825		 * lower three bits (i.e every 8 seconds).  If so, then we can update
 826		 * the time of the tty device, otherwise it could be construded as a
 827		 * security leak to let userspace know the exact timing of the tty.
 828		 */
 829		if ((sec ^ time.tv_sec) & ~7) {
 830			if (mtime)
 831				inode_set_mtime(inode, sec, 0);
 832			else
 833				inode_set_atime(inode, sec, 0);
 834		}
 835	}
 836	spin_unlock(&tty->files_lock);
 837}
 838
 839/*
 840 * Iterate on the ldisc ->read() function until we've gotten all
 841 * the data the ldisc has for us.
 842 *
 843 * The "cookie" is something that the ldisc read function can fill
 844 * in to let us know that there is more data to be had.
 845 *
 846 * We promise to continue to call the ldisc until it stops returning
 847 * data or clears the cookie. The cookie may be something that the
 848 * ldisc maintains state for and needs to free.
 849 */
 850static ssize_t iterate_tty_read(struct tty_ldisc *ld, struct tty_struct *tty,
 851				struct file *file, struct iov_iter *to)
 852{
 853	void *cookie = NULL;
 854	unsigned long offset = 0;
 855	ssize_t retval = 0;
 856	size_t copied, count = iov_iter_count(to);
 857	u8 kernel_buf[64];
 858
 859	do {
 860		ssize_t size = min(count, sizeof(kernel_buf));
 861
 862		size = ld->ops->read(tty, file, kernel_buf, size, &cookie, offset);
 863		if (!size)
 864			break;
 865
 866		if (size < 0) {
 867			/* Did we have an earlier error (ie -EFAULT)? */
 868			if (retval)
 869				break;
 870			retval = size;
 871
 872			/*
 873			 * -EOVERFLOW means we didn't have enough space
 874			 * for a whole packet, and we shouldn't return
 875			 * a partial result.
 876			 */
 877			if (retval == -EOVERFLOW)
 878				offset = 0;
 879			break;
 880		}
 881
 882		copied = copy_to_iter(kernel_buf, size, to);
 883		offset += copied;
 884		count -= copied;
 885
 886		/*
 887		 * If the user copy failed, we still need to do another ->read()
 888		 * call if we had a cookie to let the ldisc clear up.
 889		 *
 890		 * But make sure size is zeroed.
 891		 */
 892		if (unlikely(copied != size)) {
 893			count = 0;
 894			retval = -EFAULT;
 895		}
 896	} while (cookie);
 897
 898	/* We always clear tty buffer in case they contained passwords */
 899	memzero_explicit(kernel_buf, sizeof(kernel_buf));
 900	return offset ? offset : retval;
 901}
 902
 903
 904/**
 905 * tty_read - read method for tty device files
 906 * @iocb: kernel I/O control block
 907 * @to: destination for the data read
 
 
 908 *
 909 * Perform the read system call function on this terminal device. Checks
 910 * for hung up devices before calling the line discipline method.
 911 *
 912 * Locking:
 913 *	Locks the line discipline internally while needed. Multiple read calls
 914 *	may be outstanding in parallel.
 915 */
 916static ssize_t tty_read(struct kiocb *iocb, struct iov_iter *to)
 
 
 917{
 918	struct file *file = iocb->ki_filp;
 919	struct inode *inode = file_inode(file);
 920	struct tty_struct *tty = file_tty(file);
 921	struct tty_ldisc *ld;
 922	ssize_t ret;
 923
 924	if (tty_paranoia_check(tty, inode, "tty_read"))
 925		return -EIO;
 926	if (!tty || tty_io_error(tty))
 927		return -EIO;
 928
 929	/* We want to wait for the line discipline to sort out in this
 930	 * situation.
 931	 */
 932	ld = tty_ldisc_ref_wait(tty);
 933	if (!ld)
 934		return hung_up_tty_read(iocb, to);
 935	ret = -EIO;
 936	if (ld->ops->read)
 937		ret = iterate_tty_read(ld, tty, file, to);
 
 
 938	tty_ldisc_deref(ld);
 939
 940	if (ret > 0)
 941		tty_update_time(tty, false);
 942
 943	return ret;
 944}
 945
 946void tty_write_unlock(struct tty_struct *tty)
 947{
 948	mutex_unlock(&tty->atomic_write_lock);
 949	wake_up_interruptible_poll(&tty->write_wait, EPOLLOUT);
 950}
 951
 952int tty_write_lock(struct tty_struct *tty, bool ndelay)
 953{
 954	if (!mutex_trylock(&tty->atomic_write_lock)) {
 955		if (ndelay)
 956			return -EAGAIN;
 957		if (mutex_lock_interruptible(&tty->atomic_write_lock))
 958			return -ERESTARTSYS;
 959	}
 960	return 0;
 961}
 962
 963/*
 964 * Split writes up in sane blocksizes to avoid
 965 * denial-of-service type attacks
 966 */
 967static ssize_t iterate_tty_write(struct tty_ldisc *ld, struct tty_struct *tty,
 968				 struct file *file, struct iov_iter *from)
 
 
 
 
 969{
 970	size_t chunk, count = iov_iter_count(from);
 971	ssize_t ret, written = 0;
 
 972
 973	ret = tty_write_lock(tty, file->f_flags & O_NDELAY);
 974	if (ret < 0)
 975		return ret;
 976
 977	/*
 978	 * We chunk up writes into a temporary buffer. This
 979	 * simplifies low-level drivers immensely, since they
 980	 * don't have locking issues and user mode accesses.
 981	 *
 982	 * But if TTY_NO_WRITE_SPLIT is set, we should use a
 983	 * big chunk-size..
 984	 *
 985	 * The default chunk-size is 2kB, because the NTTY
 986	 * layer has problems with bigger chunks. It will
 987	 * claim to be able to handle more characters than
 988	 * it actually does.
 
 
 
 989	 */
 990	chunk = 2048;
 991	if (test_bit(TTY_NO_WRITE_SPLIT, &tty->flags))
 992		chunk = 65536;
 993	if (count < chunk)
 994		chunk = count;
 995
 996	/* write_buf/write_cnt is protected by the atomic_write_lock mutex */
 997	if (tty->write_cnt < chunk) {
 998		u8 *buf_chunk;
 999
1000		if (chunk < 1024)
1001			chunk = 1024;
1002
1003		buf_chunk = kvmalloc(chunk, GFP_KERNEL | __GFP_RETRY_MAYFAIL);
1004		if (!buf_chunk) {
1005			ret = -ENOMEM;
1006			goto out;
1007		}
1008		kvfree(tty->write_buf);
1009		tty->write_cnt = chunk;
1010		tty->write_buf = buf_chunk;
1011	}
1012
1013	/* Do the write .. */
1014	for (;;) {
1015		size_t size = min(chunk, count);
1016
 
1017		ret = -EFAULT;
1018		if (copy_from_iter(tty->write_buf, size, from) != size)
1019			break;
1020
1021		ret = ld->ops->write(tty, file, tty->write_buf, size);
1022		if (ret <= 0)
1023			break;
1024
1025		written += ret;
1026		if (ret > size)
1027			break;
1028
1029		/* FIXME! Have Al check this! */
1030		if (ret != size)
1031			iov_iter_revert(from, size-ret);
1032
1033		count -= ret;
1034		if (!count)
1035			break;
1036		ret = -ERESTARTSYS;
1037		if (signal_pending(current))
1038			break;
1039		cond_resched();
1040	}
1041	if (written) {
1042		tty_update_time(tty, true);
1043		ret = written;
1044	}
1045out:
1046	tty_write_unlock(tty);
1047	return ret;
1048}
1049
1050#ifdef CONFIG_PRINT_QUOTA_WARNING
1051/**
1052 * tty_write_message - write a message to a certain tty, not just the console.
1053 * @tty: the destination tty_struct
1054 * @msg: the message to write
1055 *
1056 * This is used for messages that need to be redirected to a specific tty. We
1057 * don't put it into the syslog queue right now maybe in the future if really
1058 * needed.
1059 *
1060 * We must still hold the BTM and test the CLOSING flag for the moment.
1061 *
1062 * This function is DEPRECATED, do not use in new code.
1063 */
 
1064void tty_write_message(struct tty_struct *tty, char *msg)
1065{
1066	if (tty) {
1067		mutex_lock(&tty->atomic_write_lock);
1068		tty_lock(tty);
1069		if (tty->ops->write && tty->count > 0)
1070			tty->ops->write(tty, msg, strlen(msg));
1071		tty_unlock(tty);
1072		tty_write_unlock(tty);
1073	}
 
1074}
1075#endif
1076
1077static ssize_t file_tty_write(struct file *file, struct kiocb *iocb, struct iov_iter *from)
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1078{
1079	struct tty_struct *tty = file_tty(file);
1080	struct tty_ldisc *ld;
1081	ssize_t ret;
1082
1083	if (tty_paranoia_check(tty, file_inode(file), "tty_write"))
1084		return -EIO;
1085	if (!tty || !tty->ops->write ||	tty_io_error(tty))
1086		return -EIO;
1087	/* Short term debug to catch buggy drivers */
1088	if (tty->ops->write_room == NULL)
1089		tty_err(tty, "missing write_room method\n");
1090	ld = tty_ldisc_ref_wait(tty);
1091	if (!ld)
1092		return hung_up_tty_write(iocb, from);
1093	if (!ld->ops->write)
1094		ret = -EIO;
1095	else
1096		ret = iterate_tty_write(ld, tty, file, from);
1097	tty_ldisc_deref(ld);
1098	return ret;
1099}
1100
1101/**
1102 * tty_write - write method for tty device file
1103 * @iocb: kernel I/O control block
1104 * @from: iov_iter with data to write
1105 *
1106 * Write data to a tty device via the line discipline.
1107 *
1108 * Locking:
1109 *	Locks the line discipline as required
1110 *	Writes to the tty driver are serialized by the atomic_write_lock
1111 *	and are then processed in chunks to the device. The line
1112 *	discipline write method will not be invoked in parallel for
1113 *	each device.
1114 */
1115static ssize_t tty_write(struct kiocb *iocb, struct iov_iter *from)
1116{
1117	return file_tty_write(iocb->ki_filp, iocb, from);
1118}
1119
1120ssize_t redirected_tty_write(struct kiocb *iocb, struct iov_iter *iter)
1121{
1122	struct file *p = NULL;
1123
1124	spin_lock(&redirect_lock);
1125	if (redirect)
1126		p = get_file(redirect);
1127	spin_unlock(&redirect_lock);
1128
1129	/*
1130	 * We know the redirected tty is just another tty, we can
1131	 * call file_tty_write() directly with that file pointer.
1132	 */
1133	if (p) {
1134		ssize_t res;
1135
1136		res = file_tty_write(p, iocb, iter);
1137		fput(p);
1138		return res;
1139	}
1140	return tty_write(iocb, iter);
1141}
1142
1143/**
1144 * tty_send_xchar - send priority character
1145 * @tty: the tty to send to
1146 * @ch: xchar to send
1147 *
1148 * Send a high priority character to the tty even if stopped.
1149 *
1150 * Locking: none for xchar method, write ordering for write method.
1151 */
1152int tty_send_xchar(struct tty_struct *tty, u8 ch)
 
1153{
1154	bool was_stopped = tty->flow.stopped;
1155
1156	if (tty->ops->send_xchar) {
1157		down_read(&tty->termios_rwsem);
1158		tty->ops->send_xchar(tty, ch);
1159		up_read(&tty->termios_rwsem);
1160		return 0;
1161	}
1162
1163	if (tty_write_lock(tty, false) < 0)
1164		return -ERESTARTSYS;
1165
1166	down_read(&tty->termios_rwsem);
1167	if (was_stopped)
1168		start_tty(tty);
1169	tty->ops->write(tty, &ch, 1);
1170	if (was_stopped)
1171		stop_tty(tty);
1172	up_read(&tty->termios_rwsem);
1173	tty_write_unlock(tty);
1174	return 0;
1175}
1176
 
 
1177/**
1178 * pty_line_name - generate name for a pty
1179 * @driver: the tty driver in use
1180 * @index: the minor number
1181 * @p: output buffer of at least 6 bytes
1182 *
1183 * Generate a name from a @driver reference and write it to the output buffer
1184 * @p.
1185 *
1186 * Locking: None
1187 */
1188static void pty_line_name(struct tty_driver *driver, int index, char *p)
1189{
1190	static const char ptychar[] = "pqrstuvwxyzabcde";
1191	int i = index + driver->name_base;
1192	/* ->name is initialized to "ttyp", but "tty" is expected */
1193	sprintf(p, "%s%c%x",
1194		driver->subtype == PTY_TYPE_SLAVE ? "tty" : driver->name,
1195		ptychar[i >> 4 & 0xf], i & 0xf);
1196}
1197
1198/**
1199 * tty_line_name - generate name for a tty
1200 * @driver: the tty driver in use
1201 * @index: the minor number
1202 * @p: output buffer of at least 7 bytes
1203 *
1204 * Generate a name from a @driver reference and write it to the output buffer
1205 * @p.
1206 *
1207 * Locking: None
1208 */
1209static ssize_t tty_line_name(struct tty_driver *driver, int index, char *p)
1210{
1211	if (driver->flags & TTY_DRIVER_UNNUMBERED_NODE)
1212		return sprintf(p, "%s", driver->name);
1213	else
1214		return sprintf(p, "%s%d", driver->name,
1215			       index + driver->name_base);
1216}
1217
1218/**
1219 * tty_driver_lookup_tty() - find an existing tty, if any
1220 * @driver: the driver for the tty
1221 * @file: file object
1222 * @idx: the minor number
1223 *
1224 * Return: the tty, if found. If not found, return %NULL or ERR_PTR() if the
1225 * driver lookup() method returns an error.
1226 *
1227 * Locking: tty_mutex must be held. If the tty is found, bump the tty kref.
1228 */
1229static struct tty_struct *tty_driver_lookup_tty(struct tty_driver *driver,
1230		struct file *file, int idx)
1231{
1232	struct tty_struct *tty;
1233
1234	if (driver->ops->lookup) {
1235		if (!file)
1236			tty = ERR_PTR(-EIO);
1237		else
1238			tty = driver->ops->lookup(driver, file, idx);
1239	} else {
1240		if (idx >= driver->num)
1241			return ERR_PTR(-EINVAL);
1242		tty = driver->ttys[idx];
1243	}
1244	if (!IS_ERR(tty))
1245		tty_kref_get(tty);
1246	return tty;
1247}
1248
1249/**
1250 * tty_init_termios - helper for termios setup
1251 * @tty: the tty to set up
1252 *
1253 * Initialise the termios structure for this tty. This runs under the
1254 * %tty_mutex currently so we can be relaxed about ordering.
1255 */
 
1256void tty_init_termios(struct tty_struct *tty)
1257{
1258	struct ktermios *tp;
1259	int idx = tty->index;
1260
1261	if (tty->driver->flags & TTY_DRIVER_RESET_TERMIOS)
1262		tty->termios = tty->driver->init_termios;
1263	else {
1264		/* Check for lazy saved data */
1265		tp = tty->driver->termios[idx];
1266		if (tp != NULL) {
1267			tty->termios = *tp;
1268			tty->termios.c_line  = tty->driver->init_termios.c_line;
1269		} else
1270			tty->termios = tty->driver->init_termios;
1271	}
1272	/* Compatibility until drivers always set this */
1273	tty->termios.c_ispeed = tty_termios_input_baud_rate(&tty->termios);
1274	tty->termios.c_ospeed = tty_termios_baud_rate(&tty->termios);
1275}
1276EXPORT_SYMBOL_GPL(tty_init_termios);
1277
1278/**
1279 * tty_standard_install - usual tty->ops->install
1280 * @driver: the driver for the tty
1281 * @tty: the tty
1282 *
1283 * If the @driver overrides @tty->ops->install, it still can call this function
1284 * to perform the standard install operations.
1285 */
1286int tty_standard_install(struct tty_driver *driver, struct tty_struct *tty)
1287{
1288	tty_init_termios(tty);
1289	tty_driver_kref_get(driver);
1290	tty->count++;
1291	driver->ttys[tty->index] = tty;
1292	return 0;
1293}
1294EXPORT_SYMBOL_GPL(tty_standard_install);
1295
1296/**
1297 * tty_driver_install_tty() - install a tty entry in the driver
1298 * @driver: the driver for the tty
1299 * @tty: the tty
1300 *
1301 * Install a tty object into the driver tables. The @tty->index field will be
1302 * set by the time this is called. This method is responsible for ensuring any
1303 * need additional structures are allocated and configured.
 
1304 *
1305 * Locking: tty_mutex for now
1306 */
1307static int tty_driver_install_tty(struct tty_driver *driver,
1308						struct tty_struct *tty)
1309{
1310	return driver->ops->install ? driver->ops->install(driver, tty) :
1311		tty_standard_install(driver, tty);
1312}
1313
1314/**
1315 * tty_driver_remove_tty() - remove a tty from the driver tables
1316 * @driver: the driver for the tty
1317 * @tty: tty to remove
1318 *
1319 * Remove a tty object from the driver tables. The tty->index field will be set
1320 * by the time this is called.
1321 *
1322 * Locking: tty_mutex for now
1323 */
1324static void tty_driver_remove_tty(struct tty_driver *driver, struct tty_struct *tty)
1325{
1326	if (driver->ops->remove)
1327		driver->ops->remove(driver, tty);
1328	else
1329		driver->ttys[tty->index] = NULL;
1330}
1331
1332/**
1333 * tty_reopen() - fast re-open of an open tty
1334 * @tty: the tty to open
1335 *
1336 * Re-opens on master ptys are not allowed and return -%EIO.
 
1337 *
1338 * Locking: Caller must hold tty_lock
1339 * Return: 0 on success, -errno on error.
1340 */
1341static int tty_reopen(struct tty_struct *tty)
1342{
1343	struct tty_driver *driver = tty->driver;
1344	struct tty_ldisc *ld;
1345	int retval = 0;
1346
1347	if (driver->type == TTY_DRIVER_TYPE_PTY &&
1348	    driver->subtype == PTY_TYPE_MASTER)
1349		return -EIO;
1350
1351	if (!tty->count)
1352		return -EAGAIN;
1353
1354	if (test_bit(TTY_EXCLUSIVE, &tty->flags) && !capable(CAP_SYS_ADMIN))
1355		return -EBUSY;
1356
1357	ld = tty_ldisc_ref_wait(tty);
1358	if (ld) {
1359		tty_ldisc_deref(ld);
1360	} else {
1361		retval = tty_ldisc_lock(tty, 5 * HZ);
1362		if (retval)
1363			return retval;
1364
1365		if (!tty->ldisc)
1366			retval = tty_ldisc_reinit(tty, tty->termios.c_line);
1367		tty_ldisc_unlock(tty);
1368	}
1369
1370	if (retval == 0)
1371		tty->count++;
1372
1373	return retval;
1374}
1375
1376/**
1377 * tty_init_dev - initialise a tty device
1378 * @driver: tty driver we are opening a device on
1379 * @idx: device index
1380 *
1381 * Prepare a tty device. This may not be a "new" clean device but could also be
1382 * an active device. The pty drivers require special handling because of this.
1383 *
1384 * Locking:
1385 *	The function is called under the tty_mutex, which protects us from the
1386 *	tty struct or driver itself going away.
1387 *
1388 * On exit the tty device has the line discipline attached and a reference
1389 * count of 1. If a pair was created for pty/tty use and the other was a pty
1390 * master then it too has a reference count of 1.
1391 *
1392 * WSH 06/09/97: Rewritten to remove races and properly clean up after a failed
1393 * open. The new code protects the open with a mutex, so it's really quite
1394 * straightforward. The mutex locking can probably be relaxed for the (most
1395 * common) case of reopening a tty.
1396 *
1397 * Return: new tty structure
1398 */
 
1399struct tty_struct *tty_init_dev(struct tty_driver *driver, int idx)
1400{
1401	struct tty_struct *tty;
1402	int retval;
1403
1404	/*
1405	 * First time open is complex, especially for PTY devices.
1406	 * This code guarantees that either everything succeeds and the
1407	 * TTY is ready for operation, or else the table slots are vacated
1408	 * and the allocated memory released.  (Except that the termios
1409	 * may be retained.)
1410	 */
1411
1412	if (!try_module_get(driver->owner))
1413		return ERR_PTR(-ENODEV);
1414
1415	tty = alloc_tty_struct(driver, idx);
1416	if (!tty) {
1417		retval = -ENOMEM;
1418		goto err_module_put;
1419	}
1420
1421	tty_lock(tty);
1422	retval = tty_driver_install_tty(driver, tty);
1423	if (retval < 0)
1424		goto err_free_tty;
1425
1426	if (!tty->port)
1427		tty->port = driver->ports[idx];
1428
1429	if (WARN_RATELIMIT(!tty->port,
1430			"%s: %s driver does not set tty->port. This would crash the kernel. Fix the driver!\n",
1431			__func__, tty->driver->name)) {
1432		retval = -EINVAL;
1433		goto err_release_lock;
1434	}
1435
1436	retval = tty_ldisc_lock(tty, 5 * HZ);
1437	if (retval)
1438		goto err_release_lock;
1439	tty->port->itty = tty;
1440
1441	/*
1442	 * Structures all installed ... call the ldisc open routines.
1443	 * If we fail here just call release_tty to clean up.  No need
1444	 * to decrement the use counts, as release_tty doesn't care.
1445	 */
1446	retval = tty_ldisc_setup(tty, tty->link);
1447	if (retval)
1448		goto err_release_tty;
1449	tty_ldisc_unlock(tty);
1450	/* Return the tty locked so that it cannot vanish under the caller */
1451	return tty;
1452
1453err_free_tty:
1454	tty_unlock(tty);
1455	free_tty_struct(tty);
1456err_module_put:
1457	module_put(driver->owner);
1458	return ERR_PTR(retval);
1459
1460	/* call the tty release_tty routine to clean out this slot */
1461err_release_tty:
1462	tty_ldisc_unlock(tty);
1463	tty_info_ratelimited(tty, "ldisc open failed (%d), clearing slot %d\n",
1464			     retval, idx);
1465err_release_lock:
1466	tty_unlock(tty);
1467	release_tty(tty, idx);
1468	return ERR_PTR(retval);
1469}
1470
1471/**
1472 * tty_save_termios() - save tty termios data in driver table
1473 * @tty: tty whose termios data to save
1474 *
1475 * Locking: Caller guarantees serialisation with tty_init_termios().
1476 */
1477void tty_save_termios(struct tty_struct *tty)
1478{
1479	struct ktermios *tp;
1480	int idx = tty->index;
1481
1482	/* If the port is going to reset then it has no termios to save */
1483	if (tty->driver->flags & TTY_DRIVER_RESET_TERMIOS)
1484		return;
1485
1486	/* Stash the termios data */
1487	tp = tty->driver->termios[idx];
1488	if (tp == NULL) {
1489		tp = kmalloc(sizeof(*tp), GFP_KERNEL);
1490		if (tp == NULL)
1491			return;
1492		tty->driver->termios[idx] = tp;
1493	}
1494	*tp = tty->termios;
1495}
1496EXPORT_SYMBOL_GPL(tty_save_termios);
1497
1498/**
1499 * tty_flush_works - flush all works of a tty/pty pair
1500 * @tty: tty device to flush works for (or either end of a pty pair)
1501 *
1502 * Sync flush all works belonging to @tty (and the 'other' tty).
1503 */
1504static void tty_flush_works(struct tty_struct *tty)
1505{
1506	flush_work(&tty->SAK_work);
1507	flush_work(&tty->hangup_work);
1508	if (tty->link) {
1509		flush_work(&tty->link->SAK_work);
1510		flush_work(&tty->link->hangup_work);
1511	}
1512}
1513
1514/**
1515 * release_one_tty - release tty structure memory
1516 * @work: work of tty we are obliterating
1517 *
1518 * Releases memory associated with a tty structure, and clears out the
1519 * driver table slots. This function is called when a device is no longer
1520 * in use. It also gets called when setup of a device fails.
1521 *
1522 * Locking:
1523 *	takes the file list lock internally when working on the list of ttys
1524 *	that the driver keeps.
1525 *
1526 * This method gets called from a work queue so that the driver private
1527 * cleanup ops can sleep (needed for USB at least)
1528 */
1529static void release_one_tty(struct work_struct *work)
1530{
1531	struct tty_struct *tty =
1532		container_of(work, struct tty_struct, hangup_work);
1533	struct tty_driver *driver = tty->driver;
1534	struct module *owner = driver->owner;
1535
1536	if (tty->ops->cleanup)
1537		tty->ops->cleanup(tty);
1538
 
1539	tty_driver_kref_put(driver);
1540	module_put(owner);
1541
1542	spin_lock(&tty->files_lock);
1543	list_del_init(&tty->tty_files);
1544	spin_unlock(&tty->files_lock);
1545
1546	put_pid(tty->ctrl.pgrp);
1547	put_pid(tty->ctrl.session);
1548	free_tty_struct(tty);
1549}
1550
1551static void queue_release_one_tty(struct kref *kref)
1552{
1553	struct tty_struct *tty = container_of(kref, struct tty_struct, kref);
1554
1555	/* The hangup queue is now free so we can reuse it rather than
1556	 *  waste a chunk of memory for each port.
1557	 */
1558	INIT_WORK(&tty->hangup_work, release_one_tty);
1559	schedule_work(&tty->hangup_work);
1560}
1561
1562/**
1563 * tty_kref_put - release a tty kref
1564 * @tty: tty device
1565 *
1566 * Release a reference to the @tty device and if need be let the kref layer
1567 * destruct the object for us.
1568 */
 
1569void tty_kref_put(struct tty_struct *tty)
1570{
1571	if (tty)
1572		kref_put(&tty->kref, queue_release_one_tty);
1573}
1574EXPORT_SYMBOL(tty_kref_put);
1575
1576/**
1577 * release_tty - release tty structure memory
1578 * @tty: tty device release
1579 * @idx: index of the tty device release
1580 *
1581 * Release both @tty and a possible linked partner (think pty pair),
1582 * and decrement the refcount of the backing module.
 
 
 
 
 
1583 *
1584 * Locking:
1585 *	tty_mutex
1586 *	takes the file list lock internally when working on the list of ttys
1587 *	that the driver keeps.
1588 */
1589static void release_tty(struct tty_struct *tty, int idx)
1590{
1591	/* This should always be true but check for the moment */
1592	WARN_ON(tty->index != idx);
1593	WARN_ON(!mutex_is_locked(&tty_mutex));
1594	if (tty->ops->shutdown)
1595		tty->ops->shutdown(tty);
1596	tty_save_termios(tty);
1597	tty_driver_remove_tty(tty->driver, tty);
1598	if (tty->port)
1599		tty->port->itty = NULL;
1600	if (tty->link)
1601		tty->link->port->itty = NULL;
1602	if (tty->port)
1603		tty_buffer_cancel_work(tty->port);
1604	if (tty->link)
1605		tty_buffer_cancel_work(tty->link->port);
1606
1607	tty_kref_put(tty->link);
1608	tty_kref_put(tty);
1609}
1610
1611/**
1612 * tty_release_checks - check a tty before real release
1613 * @tty: tty to check
1614 * @idx: index of the tty
 
1615 *
1616 * Performs some paranoid checking before true release of the @tty. This is a
1617 * no-op unless %TTY_PARANOIA_CHECK is defined.
1618 */
1619static int tty_release_checks(struct tty_struct *tty, int idx)
1620{
1621#ifdef TTY_PARANOIA_CHECK
1622	if (idx < 0 || idx >= tty->driver->num) {
1623		tty_debug(tty, "bad idx %d\n", idx);
1624		return -1;
1625	}
1626
1627	/* not much to check for devpts */
1628	if (tty->driver->flags & TTY_DRIVER_DEVPTS_MEM)
1629		return 0;
1630
1631	if (tty != tty->driver->ttys[idx]) {
1632		tty_debug(tty, "bad driver table[%d] = %p\n",
1633			  idx, tty->driver->ttys[idx]);
1634		return -1;
1635	}
1636	if (tty->driver->other) {
1637		struct tty_struct *o_tty = tty->link;
1638
1639		if (o_tty != tty->driver->other->ttys[idx]) {
1640			tty_debug(tty, "bad other table[%d] = %p\n",
1641				  idx, tty->driver->other->ttys[idx]);
1642			return -1;
1643		}
1644		if (o_tty->link != tty) {
1645			tty_debug(tty, "bad link = %p\n", o_tty->link);
1646			return -1;
1647		}
1648	}
1649#endif
1650	return 0;
1651}
1652
1653/**
1654 * tty_kclose - closes tty opened by tty_kopen
1655 * @tty: tty device
1656 *
1657 * Performs the final steps to release and free a tty device. It is the same as
1658 * tty_release_struct() except that it also resets %TTY_PORT_KOPENED flag on
1659 * @tty->port.
1660 */
1661void tty_kclose(struct tty_struct *tty)
1662{
1663	/*
1664	 * Ask the line discipline code to release its structures
1665	 */
1666	tty_ldisc_release(tty);
1667
1668	/* Wait for pending work before tty destruction commences */
1669	tty_flush_works(tty);
1670
1671	tty_debug_hangup(tty, "freeing structure\n");
1672	/*
1673	 * The release_tty function takes care of the details of clearing
1674	 * the slots and preserving the termios structure.
1675	 */
1676	mutex_lock(&tty_mutex);
1677	tty_port_set_kopened(tty->port, 0);
1678	release_tty(tty, tty->index);
1679	mutex_unlock(&tty_mutex);
1680}
1681EXPORT_SYMBOL_GPL(tty_kclose);
1682
1683/**
1684 * tty_release_struct - release a tty struct
1685 * @tty: tty device
1686 * @idx: index of the tty
1687 *
1688 * Performs the final steps to release and free a tty device. It is roughly the
1689 * reverse of tty_init_dev().
1690 */
1691void tty_release_struct(struct tty_struct *tty, int idx)
1692{
1693	/*
1694	 * Ask the line discipline code to release its structures
1695	 */
1696	tty_ldisc_release(tty);
1697
1698	/* Wait for pending work before tty destruction commmences */
1699	tty_flush_works(tty);
1700
1701	tty_debug_hangup(tty, "freeing structure\n");
1702	/*
1703	 * The release_tty function takes care of the details of clearing
1704	 * the slots and preserving the termios structure.
1705	 */
1706	mutex_lock(&tty_mutex);
1707	release_tty(tty, idx);
1708	mutex_unlock(&tty_mutex);
1709}
1710EXPORT_SYMBOL_GPL(tty_release_struct);
1711
1712/**
1713 * tty_release - vfs callback for close
1714 * @inode: inode of tty
1715 * @filp: file pointer for handle to tty
1716 *
1717 * Called the last time each file handle is closed that references this tty.
1718 * There may however be several such references.
1719 *
1720 * Locking:
1721 *	Takes BKL. See tty_release_dev().
1722 *
1723 * Even releasing the tty structures is a tricky business. We have to be very
1724 * careful that the structures are all released at the same time, as interrupts
1725 * might otherwise get the wrong pointers.
1726 *
1727 * WSH 09/09/97: rewritten to avoid some nasty race conditions that could
1728 * lead to double frees or releasing memory still in use.
1729 */
 
1730int tty_release(struct inode *inode, struct file *filp)
1731{
1732	struct tty_struct *tty = file_tty(filp);
1733	struct tty_struct *o_tty = NULL;
1734	int	do_sleep, final;
1735	int	idx;
1736	long	timeout = 0;
1737	int	once = 1;
1738
1739	if (tty_paranoia_check(tty, inode, __func__))
1740		return 0;
1741
1742	tty_lock(tty);
1743	check_tty_count(tty, __func__);
1744
1745	__tty_fasync(-1, filp, 0);
1746
1747	idx = tty->index;
1748	if (tty->driver->type == TTY_DRIVER_TYPE_PTY &&
1749	    tty->driver->subtype == PTY_TYPE_MASTER)
1750		o_tty = tty->link;
1751
1752	if (tty_release_checks(tty, idx)) {
1753		tty_unlock(tty);
1754		return 0;
1755	}
1756
1757	tty_debug_hangup(tty, "releasing (count=%d)\n", tty->count);
1758
1759	if (tty->ops->close)
1760		tty->ops->close(tty, filp);
1761
1762	/* If tty is pty master, lock the slave pty (stable lock order) */
1763	tty_lock_slave(o_tty);
1764
1765	/*
1766	 * Sanity check: if tty->count is going to zero, there shouldn't be
1767	 * any waiters on tty->read_wait or tty->write_wait.  We test the
1768	 * wait queues and kick everyone out _before_ actually starting to
1769	 * close.  This ensures that we won't block while releasing the tty
1770	 * structure.
1771	 *
1772	 * The test for the o_tty closing is necessary, since the master and
1773	 * slave sides may close in any order.  If the slave side closes out
1774	 * first, its count will be one, since the master side holds an open.
1775	 * Thus this test wouldn't be triggered at the time the slave closed,
1776	 * so we do it now.
1777	 */
1778	while (1) {
1779		do_sleep = 0;
1780
1781		if (tty->count <= 1) {
1782			if (waitqueue_active(&tty->read_wait)) {
1783				wake_up_poll(&tty->read_wait, EPOLLIN);
1784				do_sleep++;
1785			}
1786			if (waitqueue_active(&tty->write_wait)) {
1787				wake_up_poll(&tty->write_wait, EPOLLOUT);
1788				do_sleep++;
1789			}
1790		}
1791		if (o_tty && o_tty->count <= 1) {
1792			if (waitqueue_active(&o_tty->read_wait)) {
1793				wake_up_poll(&o_tty->read_wait, EPOLLIN);
1794				do_sleep++;
1795			}
1796			if (waitqueue_active(&o_tty->write_wait)) {
1797				wake_up_poll(&o_tty->write_wait, EPOLLOUT);
1798				do_sleep++;
1799			}
1800		}
1801		if (!do_sleep)
1802			break;
1803
1804		if (once) {
1805			once = 0;
1806			tty_warn(tty, "read/write wait queue active!\n");
1807		}
1808		schedule_timeout_killable(timeout);
1809		if (timeout < 120 * HZ)
1810			timeout = 2 * timeout + 1;
1811		else
1812			timeout = MAX_SCHEDULE_TIMEOUT;
1813	}
1814
1815	if (o_tty) {
1816		if (--o_tty->count < 0) {
1817			tty_warn(tty, "bad slave count (%d)\n", o_tty->count);
1818			o_tty->count = 0;
1819		}
1820	}
1821	if (--tty->count < 0) {
1822		tty_warn(tty, "bad tty->count (%d)\n", tty->count);
1823		tty->count = 0;
1824	}
1825
1826	/*
1827	 * We've decremented tty->count, so we need to remove this file
1828	 * descriptor off the tty->tty_files list; this serves two
1829	 * purposes:
1830	 *  - check_tty_count sees the correct number of file descriptors
1831	 *    associated with this tty.
1832	 *  - do_tty_hangup no longer sees this file descriptor as
1833	 *    something that needs to be handled for hangups.
1834	 */
1835	tty_del_file(filp);
1836
1837	/*
1838	 * Perform some housekeeping before deciding whether to return.
1839	 *
1840	 * If _either_ side is closing, make sure there aren't any
1841	 * processes that still think tty or o_tty is their controlling
1842	 * tty.
1843	 */
1844	if (!tty->count) {
1845		read_lock(&tasklist_lock);
1846		session_clear_tty(tty->ctrl.session);
1847		if (o_tty)
1848			session_clear_tty(o_tty->ctrl.session);
1849		read_unlock(&tasklist_lock);
1850	}
1851
1852	/* check whether both sides are closing ... */
1853	final = !tty->count && !(o_tty && o_tty->count);
1854
1855	tty_unlock_slave(o_tty);
1856	tty_unlock(tty);
1857
1858	/* At this point, the tty->count == 0 should ensure a dead tty
1859	 * cannot be re-opened by a racing opener.
1860	 */
1861
1862	if (!final)
1863		return 0;
1864
1865	tty_debug_hangup(tty, "final close\n");
1866
1867	tty_release_struct(tty, idx);
1868	return 0;
1869}
1870
1871/**
1872 * tty_open_current_tty - get locked tty of current task
1873 * @device: device number
1874 * @filp: file pointer to tty
1875 * @return: locked tty of the current task iff @device is /dev/tty
1876 *
1877 * Performs a re-open of the current task's controlling tty.
1878 *
1879 * We cannot return driver and index like for the other nodes because devpts
1880 * will not work then. It expects inodes to be from devpts FS.
1881 */
1882static struct tty_struct *tty_open_current_tty(dev_t device, struct file *filp)
1883{
1884	struct tty_struct *tty;
1885	int retval;
1886
1887	if (device != MKDEV(TTYAUX_MAJOR, 0))
1888		return NULL;
1889
1890	tty = get_current_tty();
1891	if (!tty)
1892		return ERR_PTR(-ENXIO);
1893
1894	filp->f_flags |= O_NONBLOCK; /* Don't let /dev/tty block */
1895	/* noctty = 1; */
1896	tty_lock(tty);
1897	tty_kref_put(tty);	/* safe to drop the kref now */
1898
1899	retval = tty_reopen(tty);
1900	if (retval < 0) {
1901		tty_unlock(tty);
1902		tty = ERR_PTR(retval);
1903	}
1904	return tty;
1905}
1906
1907/**
1908 * tty_lookup_driver - lookup a tty driver for a given device file
1909 * @device: device number
1910 * @filp: file pointer to tty
1911 * @index: index for the device in the @return driver
1912 *
1913 * If returned value is not erroneous, the caller is responsible to decrement
1914 * the refcount by tty_driver_kref_put().
1915 *
1916 * Locking: %tty_mutex protects get_tty_driver()
 
1917 *
1918 * Return: driver for this inode (with increased refcount)
1919 */
1920static struct tty_driver *tty_lookup_driver(dev_t device, struct file *filp,
1921		int *index)
1922{
1923	struct tty_driver *driver = NULL;
1924
1925	switch (device) {
1926#ifdef CONFIG_VT
1927	case MKDEV(TTY_MAJOR, 0): {
1928		extern struct tty_driver *console_driver;
1929
1930		driver = tty_driver_kref_get(console_driver);
1931		*index = fg_console;
1932		break;
1933	}
1934#endif
1935	case MKDEV(TTYAUX_MAJOR, 1): {
1936		struct tty_driver *console_driver = console_device(index);
1937
1938		if (console_driver) {
1939			driver = tty_driver_kref_get(console_driver);
1940			if (driver && filp) {
1941				/* Don't let /dev/console block */
1942				filp->f_flags |= O_NONBLOCK;
1943				break;
1944			}
1945		}
1946		if (driver)
1947			tty_driver_kref_put(driver);
1948		return ERR_PTR(-ENODEV);
1949	}
1950	default:
1951		driver = get_tty_driver(device, index);
1952		if (!driver)
1953			return ERR_PTR(-ENODEV);
1954		break;
1955	}
1956	return driver;
1957}
1958
1959static struct tty_struct *tty_kopen(dev_t device, int shared)
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1960{
1961	struct tty_struct *tty;
1962	struct tty_driver *driver;
1963	int index = -1;
1964
1965	mutex_lock(&tty_mutex);
1966	driver = tty_lookup_driver(device, NULL, &index);
1967	if (IS_ERR(driver)) {
1968		mutex_unlock(&tty_mutex);
1969		return ERR_CAST(driver);
1970	}
1971
1972	/* check whether we're reopening an existing tty */
1973	tty = tty_driver_lookup_tty(driver, NULL, index);
1974	if (IS_ERR(tty) || shared)
1975		goto out;
1976
1977	if (tty) {
1978		/* drop kref from tty_driver_lookup_tty() */
1979		tty_kref_put(tty);
1980		tty = ERR_PTR(-EBUSY);
1981	} else { /* tty_init_dev returns tty with the tty_lock held */
1982		tty = tty_init_dev(driver, index);
1983		if (IS_ERR(tty))
1984			goto out;
1985		tty_port_set_kopened(tty->port, 1);
1986	}
1987out:
1988	mutex_unlock(&tty_mutex);
1989	tty_driver_kref_put(driver);
1990	return tty;
1991}
 
1992
1993/**
1994 * tty_kopen_exclusive - open a tty device for kernel
1995 * @device: dev_t of device to open
1996 *
1997 * Opens tty exclusively for kernel. Performs the driver lookup, makes sure
1998 * it's not already opened and performs the first-time tty initialization.
1999 *
2000 * Claims the global %tty_mutex to serialize:
2001 *  * concurrent first-time tty initialization
2002 *  * concurrent tty driver removal w/ lookup
2003 *  * concurrent tty removal from driver table
2004 *
2005 * Return: the locked initialized &tty_struct
2006 */
2007struct tty_struct *tty_kopen_exclusive(dev_t device)
2008{
2009	return tty_kopen(device, 0);
2010}
2011EXPORT_SYMBOL_GPL(tty_kopen_exclusive);
2012
2013/**
2014 * tty_kopen_shared - open a tty device for shared in-kernel use
2015 * @device: dev_t of device to open
2016 *
2017 * Opens an already existing tty for in-kernel use. Compared to
2018 * tty_kopen_exclusive() above it doesn't ensure to be the only user.
2019 *
2020 * Locking: identical to tty_kopen() above.
2021 */
2022struct tty_struct *tty_kopen_shared(dev_t device)
2023{
2024	return tty_kopen(device, 1);
2025}
2026EXPORT_SYMBOL_GPL(tty_kopen_shared);
2027
2028/**
2029 * tty_open_by_driver - open a tty device
2030 * @device: dev_t of device to open
2031 * @filp: file pointer to tty
2032 *
2033 * Performs the driver lookup, checks for a reopen, or otherwise performs the
2034 * first-time tty initialization.
2035 *
 
 
2036 *
2037 * Claims the global tty_mutex to serialize:
2038 *  * concurrent first-time tty initialization
2039 *  * concurrent tty driver removal w/ lookup
2040 *  * concurrent tty removal from driver table
2041 *
2042 * Return: the locked initialized or re-opened &tty_struct
 
 
 
2043 */
2044static struct tty_struct *tty_open_by_driver(dev_t device,
2045					     struct file *filp)
2046{
2047	struct tty_struct *tty;
2048	struct tty_driver *driver = NULL;
2049	int index = -1;
2050	int retval;
2051
2052	mutex_lock(&tty_mutex);
2053	driver = tty_lookup_driver(device, filp, &index);
2054	if (IS_ERR(driver)) {
2055		mutex_unlock(&tty_mutex);
2056		return ERR_CAST(driver);
2057	}
2058
2059	/* check whether we're reopening an existing tty */
2060	tty = tty_driver_lookup_tty(driver, filp, index);
2061	if (IS_ERR(tty)) {
2062		mutex_unlock(&tty_mutex);
2063		goto out;
2064	}
2065
2066	if (tty) {
2067		if (tty_port_kopened(tty->port)) {
2068			tty_kref_put(tty);
2069			mutex_unlock(&tty_mutex);
2070			tty = ERR_PTR(-EBUSY);
2071			goto out;
2072		}
2073		mutex_unlock(&tty_mutex);
2074		retval = tty_lock_interruptible(tty);
2075		tty_kref_put(tty);  /* drop kref from tty_driver_lookup_tty() */
2076		if (retval) {
2077			if (retval == -EINTR)
2078				retval = -ERESTARTSYS;
2079			tty = ERR_PTR(retval);
2080			goto out;
2081		}
2082		retval = tty_reopen(tty);
2083		if (retval < 0) {
2084			tty_unlock(tty);
2085			tty = ERR_PTR(retval);
2086		}
2087	} else { /* Returns with the tty_lock held for now */
2088		tty = tty_init_dev(driver, index);
2089		mutex_unlock(&tty_mutex);
2090	}
2091out:
2092	tty_driver_kref_put(driver);
2093	return tty;
2094}
2095
2096/**
2097 * tty_open - open a tty device
2098 * @inode: inode of device file
2099 * @filp: file pointer to tty
2100 *
2101 * tty_open() and tty_release() keep up the tty count that contains the number
2102 * of opens done on a tty. We cannot use the inode-count, as different inodes
2103 * might point to the same tty.
2104 *
2105 * Open-counting is needed for pty masters, as well as for keeping track of
2106 * serial lines: DTR is dropped when the last close happens.
2107 * (This is not done solely through tty->count, now.  - Ted 1/27/92)
2108 *
2109 * The termios state of a pty is reset on the first open so that settings don't
2110 * persist across reuse.
2111 *
2112 * Locking:
2113 *  * %tty_mutex protects tty, tty_lookup_driver() and tty_init_dev().
2114 *  * @tty->count should protect the rest.
2115 *  * ->siglock protects ->signal/->sighand
2116 *
2117 * Note: the tty_unlock/lock cases without a ref are only safe due to %tty_mutex
 
2118 */
 
2119static int tty_open(struct inode *inode, struct file *filp)
2120{
2121	struct tty_struct *tty;
2122	int noctty, retval;
2123	dev_t device = inode->i_rdev;
2124	unsigned saved_flags = filp->f_flags;
2125
2126	nonseekable_open(inode, filp);
2127
2128retry_open:
2129	retval = tty_alloc_file(filp);
2130	if (retval)
2131		return -ENOMEM;
2132
2133	tty = tty_open_current_tty(device, filp);
2134	if (!tty)
2135		tty = tty_open_by_driver(device, filp);
2136
2137	if (IS_ERR(tty)) {
2138		tty_free_file(filp);
2139		retval = PTR_ERR(tty);
2140		if (retval != -EAGAIN || signal_pending(current))
2141			return retval;
2142		schedule();
2143		goto retry_open;
2144	}
2145
2146	tty_add_file(tty, filp);
2147
2148	check_tty_count(tty, __func__);
2149	tty_debug_hangup(tty, "opening (count=%d)\n", tty->count);
2150
2151	if (tty->ops->open)
2152		retval = tty->ops->open(tty, filp);
2153	else
2154		retval = -ENODEV;
2155	filp->f_flags = saved_flags;
2156
2157	if (retval) {
2158		tty_debug_hangup(tty, "open error %d, releasing\n", retval);
2159
2160		tty_unlock(tty); /* need to call tty_release without BTM */
2161		tty_release(inode, filp);
2162		if (retval != -ERESTARTSYS)
2163			return retval;
2164
2165		if (signal_pending(current))
2166			return retval;
2167
2168		schedule();
2169		/*
2170		 * Need to reset f_op in case a hangup happened.
2171		 */
2172		if (tty_hung_up_p(filp))
2173			filp->f_op = &tty_fops;
2174		goto retry_open;
2175	}
2176	clear_bit(TTY_HUPPED, &tty->flags);
2177
2178	noctty = (filp->f_flags & O_NOCTTY) ||
2179		 (IS_ENABLED(CONFIG_VT) && device == MKDEV(TTY_MAJOR, 0)) ||
2180		 device == MKDEV(TTYAUX_MAJOR, 1) ||
2181		 (tty->driver->type == TTY_DRIVER_TYPE_PTY &&
2182		  tty->driver->subtype == PTY_TYPE_MASTER);
2183	if (!noctty)
2184		tty_open_proc_set_tty(filp, tty);
2185	tty_unlock(tty);
2186	return 0;
2187}
2188
2189
 
2190/**
2191 * tty_poll - check tty status
2192 * @filp: file being polled
2193 * @wait: poll wait structures to update
2194 *
2195 * Call the line discipline polling method to obtain the poll status of the
2196 * device.
2197 *
2198 * Locking: locks called line discipline but ldisc poll method may be
2199 * re-entered freely by other callers.
2200 */
 
2201static __poll_t tty_poll(struct file *filp, poll_table *wait)
2202{
2203	struct tty_struct *tty = file_tty(filp);
2204	struct tty_ldisc *ld;
2205	__poll_t ret = 0;
2206
2207	if (tty_paranoia_check(tty, file_inode(filp), "tty_poll"))
2208		return 0;
2209
2210	ld = tty_ldisc_ref_wait(tty);
2211	if (!ld)
2212		return hung_up_tty_poll(filp, wait);
2213	if (ld->ops->poll)
2214		ret = ld->ops->poll(tty, filp, wait);
2215	tty_ldisc_deref(ld);
2216	return ret;
2217}
2218
2219static int __tty_fasync(int fd, struct file *filp, int on)
2220{
2221	struct tty_struct *tty = file_tty(filp);
2222	unsigned long flags;
2223	int retval = 0;
2224
2225	if (tty_paranoia_check(tty, file_inode(filp), "tty_fasync"))
2226		goto out;
2227
2228	retval = fasync_helper(fd, filp, on, &tty->fasync);
2229	if (retval <= 0)
2230		goto out;
2231
2232	if (on) {
2233		enum pid_type type;
2234		struct pid *pid;
2235
2236		spin_lock_irqsave(&tty->ctrl.lock, flags);
2237		if (tty->ctrl.pgrp) {
2238			pid = tty->ctrl.pgrp;
2239			type = PIDTYPE_PGID;
2240		} else {
2241			pid = task_pid(current);
2242			type = PIDTYPE_TGID;
2243		}
2244		get_pid(pid);
2245		spin_unlock_irqrestore(&tty->ctrl.lock, flags);
2246		__f_setown(filp, pid, type, 0);
2247		put_pid(pid);
2248		retval = 0;
2249	}
2250out:
2251	return retval;
2252}
2253
2254static int tty_fasync(int fd, struct file *filp, int on)
2255{
2256	struct tty_struct *tty = file_tty(filp);
2257	int retval = -ENOTTY;
2258
2259	tty_lock(tty);
2260	if (!tty_hung_up_p(filp))
2261		retval = __tty_fasync(fd, filp, on);
2262	tty_unlock(tty);
2263
2264	return retval;
2265}
2266
2267static bool tty_legacy_tiocsti __read_mostly = IS_ENABLED(CONFIG_LEGACY_TIOCSTI);
2268/**
2269 * tiocsti - fake input character
2270 * @tty: tty to fake input into
2271 * @p: pointer to character
 
 
 
2272 *
2273 * Fake input to a tty device. Does the necessary locking and input management.
2274 *
2275 * FIXME: does not honour flow control ??
 
 
2276 *
2277 * Locking:
2278 *  * Called functions take tty_ldiscs_lock
2279 *  * current->signal->tty check is safe without locks
2280 */
2281static int tiocsti(struct tty_struct *tty, u8 __user *p)
 
2282{
 
2283	struct tty_ldisc *ld;
2284	u8 ch;
2285
2286	if (!tty_legacy_tiocsti && !capable(CAP_SYS_ADMIN))
2287		return -EIO;
2288
2289	if ((current->signal->tty != tty) && !capable(CAP_SYS_ADMIN))
2290		return -EPERM;
2291	if (get_user(ch, p))
2292		return -EFAULT;
2293	tty_audit_tiocsti(tty, ch);
2294	ld = tty_ldisc_ref_wait(tty);
2295	if (!ld)
2296		return -EIO;
2297	tty_buffer_lock_exclusive(tty->port);
2298	if (ld->ops->receive_buf)
2299		ld->ops->receive_buf(tty, &ch, NULL, 1);
2300	tty_buffer_unlock_exclusive(tty->port);
2301	tty_ldisc_deref(ld);
2302	return 0;
2303}
2304
2305/**
2306 * tiocgwinsz - implement window query ioctl
2307 * @tty: tty
2308 * @arg: user buffer for result
2309 *
2310 * Copies the kernel idea of the window size into the user buffer.
2311 *
2312 * Locking: @tty->winsize_mutex is taken to ensure the winsize data is
2313 * consistent.
2314 */
 
2315static int tiocgwinsz(struct tty_struct *tty, struct winsize __user *arg)
2316{
2317	int err;
2318
2319	mutex_lock(&tty->winsize_mutex);
2320	err = copy_to_user(arg, &tty->winsize, sizeof(*arg));
2321	mutex_unlock(&tty->winsize_mutex);
2322
2323	return err ? -EFAULT : 0;
2324}
2325
2326/**
2327 * tty_do_resize - resize event
2328 * @tty: tty being resized
2329 * @ws: new dimensions
 
2330 *
2331 * Update the termios variables and send the necessary signals to peform a
2332 * terminal resize correctly.
2333 */
 
2334int tty_do_resize(struct tty_struct *tty, struct winsize *ws)
2335{
2336	struct pid *pgrp;
2337
2338	/* Lock the tty */
2339	mutex_lock(&tty->winsize_mutex);
2340	if (!memcmp(ws, &tty->winsize, sizeof(*ws)))
2341		goto done;
2342
2343	/* Signal the foreground process group */
2344	pgrp = tty_get_pgrp(tty);
2345	if (pgrp)
2346		kill_pgrp(pgrp, SIGWINCH, 1);
2347	put_pid(pgrp);
2348
2349	tty->winsize = *ws;
2350done:
2351	mutex_unlock(&tty->winsize_mutex);
2352	return 0;
2353}
2354EXPORT_SYMBOL(tty_do_resize);
2355
2356/**
2357 * tiocswinsz - implement window size set ioctl
2358 * @tty: tty side of tty
2359 * @arg: user buffer for result
2360 *
2361 * Copies the user idea of the window size to the kernel. Traditionally this is
2362 * just advisory information but for the Linux console it actually has driver
2363 * level meaning and triggers a VC resize.
2364 *
2365 * Locking:
2366 *	Driver dependent. The default do_resize method takes the tty termios
2367 *	mutex and ctrl.lock. The console takes its own lock then calls into the
2368 *	default method.
2369 */
 
2370static int tiocswinsz(struct tty_struct *tty, struct winsize __user *arg)
2371{
2372	struct winsize tmp_ws;
2373
2374	if (copy_from_user(&tmp_ws, arg, sizeof(*arg)))
2375		return -EFAULT;
2376
2377	if (tty->ops->resize)
2378		return tty->ops->resize(tty, &tmp_ws);
2379	else
2380		return tty_do_resize(tty, &tmp_ws);
2381}
2382
2383/**
2384 * tioccons - allow admin to move logical console
2385 * @file: the file to become console
2386 *
2387 * Allow the administrator to move the redirected console device.
2388 *
2389 * Locking: uses redirect_lock to guard the redirect information
2390 */
 
2391static int tioccons(struct file *file)
2392{
2393	if (!capable(CAP_SYS_ADMIN))
2394		return -EPERM;
2395	if (file->f_op->write_iter == redirected_tty_write) {
2396		struct file *f;
2397
2398		spin_lock(&redirect_lock);
2399		f = redirect;
2400		redirect = NULL;
2401		spin_unlock(&redirect_lock);
2402		if (f)
2403			fput(f);
2404		return 0;
2405	}
2406	if (file->f_op->write_iter != tty_write)
2407		return -ENOTTY;
2408	if (!(file->f_mode & FMODE_WRITE))
2409		return -EBADF;
2410	if (!(file->f_mode & FMODE_CAN_WRITE))
2411		return -EINVAL;
2412	spin_lock(&redirect_lock);
2413	if (redirect) {
2414		spin_unlock(&redirect_lock);
2415		return -EBUSY;
2416	}
2417	redirect = get_file(file);
2418	spin_unlock(&redirect_lock);
2419	return 0;
2420}
2421
2422/**
2423 * tiocsetd - set line discipline
2424 * @tty: tty device
2425 * @p: pointer to user data
2426 *
2427 * Set the line discipline according to user request.
2428 *
2429 * Locking: see tty_set_ldisc(), this function is just a helper
2430 */
 
2431static int tiocsetd(struct tty_struct *tty, int __user *p)
2432{
2433	int disc;
2434	int ret;
2435
2436	if (get_user(disc, p))
2437		return -EFAULT;
2438
2439	ret = tty_set_ldisc(tty, disc);
2440
2441	return ret;
2442}
2443
2444/**
2445 * tiocgetd - get line discipline
2446 * @tty: tty device
2447 * @p: pointer to user data
2448 *
2449 * Retrieves the line discipline id directly from the ldisc.
2450 *
2451 * Locking: waits for ldisc reference (in case the line discipline is changing
2452 * or the @tty is being hungup)
2453 */
 
2454static int tiocgetd(struct tty_struct *tty, int __user *p)
2455{
2456	struct tty_ldisc *ld;
2457	int ret;
2458
2459	ld = tty_ldisc_ref_wait(tty);
2460	if (!ld)
2461		return -EIO;
2462	ret = put_user(ld->ops->num, p);
2463	tty_ldisc_deref(ld);
2464	return ret;
2465}
2466
2467/**
2468 * send_break - performed time break
2469 * @tty: device to break on
2470 * @duration: timeout in mS
2471 *
2472 * Perform a timed break on hardware that lacks its own driver level timed
2473 * break functionality.
 
 
 
2474 *
2475 * Locking:
2476 *	@tty->atomic_write_lock serializes
2477 */
 
2478static int send_break(struct tty_struct *tty, unsigned int duration)
2479{
2480	int retval;
2481
2482	if (tty->ops->break_ctl == NULL)
2483		return 0;
2484
2485	if (tty->driver->flags & TTY_DRIVER_HARDWARE_BREAK)
2486		return tty->ops->break_ctl(tty, duration);
2487
2488	/* Do the work ourselves */
2489	if (tty_write_lock(tty, false) < 0)
2490		return -EINTR;
2491
2492	retval = tty->ops->break_ctl(tty, -1);
2493	if (!retval) {
2494		msleep_interruptible(duration);
 
2495		retval = tty->ops->break_ctl(tty, 0);
2496	} else if (retval == -EOPNOTSUPP) {
2497		/* some drivers can tell only dynamically */
2498		retval = 0;
 
2499	}
2500	tty_write_unlock(tty);
2501
2502	if (signal_pending(current))
2503		retval = -EINTR;
2504
2505	return retval;
2506}
2507
2508/**
2509 * tty_get_tiocm - get tiocm status register
2510 * @tty: tty device
2511 *
2512 * Obtain the modem status bits from the tty driver if the feature
2513 * is supported.
2514 */
2515int tty_get_tiocm(struct tty_struct *tty)
2516{
2517	int retval = -ENOTTY;
2518
2519	if (tty->ops->tiocmget)
2520		retval = tty->ops->tiocmget(tty);
2521
2522	return retval;
2523}
2524EXPORT_SYMBOL_GPL(tty_get_tiocm);
2525
2526/**
2527 * tty_tiocmget - get modem status
2528 * @tty: tty device
2529 * @p: pointer to result
 
2530 *
2531 * Obtain the modem status bits from the tty driver if the feature is
2532 * supported. Return -%ENOTTY if it is not available.
2533 *
2534 * Locking: none (up to the driver)
2535 */
 
2536static int tty_tiocmget(struct tty_struct *tty, int __user *p)
2537{
2538	int retval;
2539
2540	retval = tty_get_tiocm(tty);
2541	if (retval >= 0)
2542		retval = put_user(retval, p);
2543
 
 
 
2544	return retval;
2545}
2546
2547/**
2548 * tty_tiocmset - set modem status
2549 * @tty: tty device
2550 * @cmd: command - clear bits, set bits or set all
2551 * @p: pointer to desired bits
2552 *
2553 * Set the modem status bits from the tty driver if the feature
2554 * is supported. Return -%ENOTTY if it is not available.
2555 *
2556 * Locking: none (up to the driver)
2557 */
 
2558static int tty_tiocmset(struct tty_struct *tty, unsigned int cmd,
2559	     unsigned __user *p)
2560{
2561	int retval;
2562	unsigned int set, clear, val;
2563
2564	if (tty->ops->tiocmset == NULL)
2565		return -ENOTTY;
2566
2567	retval = get_user(val, p);
2568	if (retval)
2569		return retval;
2570	set = clear = 0;
2571	switch (cmd) {
2572	case TIOCMBIS:
2573		set = val;
2574		break;
2575	case TIOCMBIC:
2576		clear = val;
2577		break;
2578	case TIOCMSET:
2579		set = val;
2580		clear = ~val;
2581		break;
2582	}
2583	set &= TIOCM_DTR|TIOCM_RTS|TIOCM_OUT1|TIOCM_OUT2|TIOCM_LOOP;
2584	clear &= TIOCM_DTR|TIOCM_RTS|TIOCM_OUT1|TIOCM_OUT2|TIOCM_LOOP;
2585	return tty->ops->tiocmset(tty, set, clear);
2586}
2587
2588/**
2589 * tty_get_icount - get tty statistics
2590 * @tty: tty device
2591 * @icount: output parameter
2592 *
2593 * Gets a copy of the @tty's icount statistics.
2594 *
2595 * Locking: none (up to the driver)
2596 */
2597int tty_get_icount(struct tty_struct *tty,
2598		   struct serial_icounter_struct *icount)
2599{
2600	memset(icount, 0, sizeof(*icount));
2601
2602	if (tty->ops->get_icount)
2603		return tty->ops->get_icount(tty, icount);
2604	else
2605		return -ENOTTY;
2606}
2607EXPORT_SYMBOL_GPL(tty_get_icount);
2608
2609static int tty_tiocgicount(struct tty_struct *tty, void __user *arg)
2610{
 
2611	struct serial_icounter_struct icount;
2612	int retval;
2613
2614	retval = tty_get_icount(tty, &icount);
2615	if (retval != 0)
2616		return retval;
2617
2618	if (copy_to_user(arg, &icount, sizeof(icount)))
2619		return -EFAULT;
2620	return 0;
2621}
2622
2623static int tty_set_serial(struct tty_struct *tty, struct serial_struct *ss)
2624{
 
 
 
2625	char comm[TASK_COMM_LEN];
 
2626	int flags;
2627
2628	flags = ss->flags & ASYNC_DEPRECATED;
 
2629
2630	if (flags)
2631		pr_warn_ratelimited("%s: '%s' is using deprecated serial flags (with no effect): %.8x\n",
2632				__func__, get_task_comm(comm, current), flags);
2633
 
 
 
2634	if (!tty->ops->set_serial)
2635		return -ENOTTY;
2636
2637	return tty->ops->set_serial(tty, ss);
2638}
2639
2640static int tty_tiocsserial(struct tty_struct *tty, struct serial_struct __user *ss)
2641{
2642	struct serial_struct v;
2643
2644	if (copy_from_user(&v, ss, sizeof(*ss)))
2645		return -EFAULT;
2646
2647	return tty_set_serial(tty, &v);
2648}
2649
2650static int tty_tiocgserial(struct tty_struct *tty, struct serial_struct __user *ss)
2651{
2652	struct serial_struct v;
2653	int err;
2654
2655	memset(&v, 0, sizeof(v));
2656	if (!tty->ops->get_serial)
2657		return -ENOTTY;
2658	err = tty->ops->get_serial(tty, &v);
2659	if (!err && copy_to_user(ss, &v, sizeof(v)))
2660		err = -EFAULT;
2661	return err;
2662}
2663
2664/*
2665 * if pty, return the slave side (real_tty)
2666 * otherwise, return self
2667 */
2668static struct tty_struct *tty_pair_get_tty(struct tty_struct *tty)
2669{
2670	if (tty->driver->type == TTY_DRIVER_TYPE_PTY &&
2671	    tty->driver->subtype == PTY_TYPE_MASTER)
2672		tty = tty->link;
2673	return tty;
2674}
2675
2676/*
2677 * Split this up, as gcc can choke on it otherwise..
2678 */
2679long tty_ioctl(struct file *file, unsigned int cmd, unsigned long arg)
2680{
2681	struct tty_struct *tty = file_tty(file);
2682	struct tty_struct *real_tty;
2683	void __user *p = (void __user *)arg;
2684	int retval;
2685	struct tty_ldisc *ld;
2686
2687	if (tty_paranoia_check(tty, file_inode(file), "tty_ioctl"))
2688		return -EINVAL;
2689
2690	real_tty = tty_pair_get_tty(tty);
2691
2692	/*
2693	 * Factor out some common prep work
2694	 */
2695	switch (cmd) {
2696	case TIOCSETD:
2697	case TIOCSBRK:
2698	case TIOCCBRK:
2699	case TCSBRK:
2700	case TCSBRKP:
2701		retval = tty_check_change(tty);
2702		if (retval)
2703			return retval;
2704		if (cmd != TIOCCBRK) {
2705			tty_wait_until_sent(tty, 0);
2706			if (signal_pending(current))
2707				return -EINTR;
2708		}
2709		break;
2710	}
2711
2712	/*
2713	 *	Now do the stuff.
2714	 */
2715	switch (cmd) {
2716	case TIOCSTI:
2717		return tiocsti(tty, p);
2718	case TIOCGWINSZ:
2719		return tiocgwinsz(real_tty, p);
2720	case TIOCSWINSZ:
2721		return tiocswinsz(real_tty, p);
2722	case TIOCCONS:
2723		return real_tty != tty ? -EINVAL : tioccons(file);
2724	case TIOCEXCL:
2725		set_bit(TTY_EXCLUSIVE, &tty->flags);
2726		return 0;
2727	case TIOCNXCL:
2728		clear_bit(TTY_EXCLUSIVE, &tty->flags);
2729		return 0;
2730	case TIOCGEXCL:
2731	{
2732		int excl = test_bit(TTY_EXCLUSIVE, &tty->flags);
2733
2734		return put_user(excl, (int __user *)p);
2735	}
2736	case TIOCGETD:
2737		return tiocgetd(tty, p);
2738	case TIOCSETD:
2739		return tiocsetd(tty, p);
2740	case TIOCVHANGUP:
2741		if (!capable(CAP_SYS_ADMIN))
2742			return -EPERM;
2743		tty_vhangup(tty);
2744		return 0;
2745	case TIOCGDEV:
2746	{
2747		unsigned int ret = new_encode_dev(tty_devnum(real_tty));
2748
2749		return put_user(ret, (unsigned int __user *)p);
2750	}
2751	/*
2752	 * Break handling
2753	 */
2754	case TIOCSBRK:	/* Turn break on, unconditionally */
2755		if (tty->ops->break_ctl)
2756			return tty->ops->break_ctl(tty, -1);
2757		return 0;
2758	case TIOCCBRK:	/* Turn break off, unconditionally */
2759		if (tty->ops->break_ctl)
2760			return tty->ops->break_ctl(tty, 0);
2761		return 0;
2762	case TCSBRK:   /* SVID version: non-zero arg --> no break */
2763		/* non-zero arg means wait for all output data
2764		 * to be sent (performed above) but don't send break.
2765		 * This is used by the tcdrain() termios function.
2766		 */
2767		if (!arg)
2768			return send_break(tty, 250);
2769		return 0;
2770	case TCSBRKP:	/* support for POSIX tcsendbreak() */
2771		return send_break(tty, arg ? arg*100 : 250);
2772
2773	case TIOCMGET:
2774		return tty_tiocmget(tty, p);
2775	case TIOCMSET:
2776	case TIOCMBIC:
2777	case TIOCMBIS:
2778		return tty_tiocmset(tty, cmd, p);
2779	case TIOCGICOUNT:
2780		return tty_tiocgicount(tty, p);
2781	case TCFLSH:
2782		switch (arg) {
2783		case TCIFLUSH:
2784		case TCIOFLUSH:
2785		/* flush tty buffer and allow ldisc to process ioctl */
2786			tty_buffer_flush(tty, NULL);
2787			break;
2788		}
2789		break;
2790	case TIOCSSERIAL:
2791		return tty_tiocsserial(tty, p);
2792	case TIOCGSERIAL:
2793		return tty_tiocgserial(tty, p);
2794	case TIOCGPTPEER:
2795		/* Special because the struct file is needed */
2796		return ptm_open_peer(file, tty, (int)arg);
2797	default:
2798		retval = tty_jobctrl_ioctl(tty, real_tty, file, cmd, arg);
2799		if (retval != -ENOIOCTLCMD)
2800			return retval;
2801	}
2802	if (tty->ops->ioctl) {
2803		retval = tty->ops->ioctl(tty, cmd, arg);
2804		if (retval != -ENOIOCTLCMD)
2805			return retval;
2806	}
2807	ld = tty_ldisc_ref_wait(tty);
2808	if (!ld)
2809		return hung_up_tty_ioctl(file, cmd, arg);
2810	retval = -EINVAL;
2811	if (ld->ops->ioctl) {
2812		retval = ld->ops->ioctl(tty, cmd, arg);
2813		if (retval == -ENOIOCTLCMD)
2814			retval = -ENOTTY;
2815	}
2816	tty_ldisc_deref(ld);
2817	return retval;
2818}
2819
2820#ifdef CONFIG_COMPAT
2821
2822struct serial_struct32 {
2823	compat_int_t    type;
2824	compat_int_t    line;
2825	compat_uint_t   port;
2826	compat_int_t    irq;
2827	compat_int_t    flags;
2828	compat_int_t    xmit_fifo_size;
2829	compat_int_t    custom_divisor;
2830	compat_int_t    baud_base;
2831	unsigned short  close_delay;
2832	char    io_type;
2833	char    reserved_char;
2834	compat_int_t    hub6;
2835	unsigned short  closing_wait; /* time to wait before closing */
2836	unsigned short  closing_wait2; /* no longer used... */
2837	compat_uint_t   iomem_base;
2838	unsigned short  iomem_reg_shift;
2839	unsigned int    port_high;
2840	/* compat_ulong_t  iomap_base FIXME */
2841	compat_int_t    reserved;
2842};
2843
2844static int compat_tty_tiocsserial(struct tty_struct *tty,
2845		struct serial_struct32 __user *ss)
2846{
 
 
 
 
2847	struct serial_struct32 v32;
2848	struct serial_struct v;
 
2849
2850	if (copy_from_user(&v32, ss, sizeof(*ss)))
2851		return -EFAULT;
2852
2853	memcpy(&v, &v32, offsetof(struct serial_struct32, iomem_base));
2854	v.iomem_base = compat_ptr(v32.iomem_base);
2855	v.iomem_reg_shift = v32.iomem_reg_shift;
2856	v.port_high = v32.port_high;
2857	v.iomap_base = 0;
2858
2859	return tty_set_serial(tty, &v);
 
 
 
 
 
 
 
2860}
2861
2862static int compat_tty_tiocgserial(struct tty_struct *tty,
2863			struct serial_struct32 __user *ss)
2864{
2865	struct serial_struct32 v32;
2866	struct serial_struct v;
2867	int err;
2868
2869	memset(&v, 0, sizeof(v));
2870	memset(&v32, 0, sizeof(v32));
2871
2872	if (!tty->ops->get_serial)
2873		return -ENOTTY;
2874	err = tty->ops->get_serial(tty, &v);
2875	if (!err) {
2876		memcpy(&v32, &v, offsetof(struct serial_struct32, iomem_base));
2877		v32.iomem_base = (unsigned long)v.iomem_base >> 32 ?
2878			0xfffffff : ptr_to_compat(v.iomem_base);
2879		v32.iomem_reg_shift = v.iomem_reg_shift;
2880		v32.port_high = v.port_high;
2881		if (copy_to_user(ss, &v32, sizeof(v32)))
2882			err = -EFAULT;
2883	}
2884	return err;
2885}
2886static long tty_compat_ioctl(struct file *file, unsigned int cmd,
2887				unsigned long arg)
2888{
2889	struct tty_struct *tty = file_tty(file);
2890	struct tty_ldisc *ld;
2891	int retval = -ENOIOCTLCMD;
2892
2893	switch (cmd) {
2894	case TIOCOUTQ:
2895	case TIOCSTI:
2896	case TIOCGWINSZ:
2897	case TIOCSWINSZ:
2898	case TIOCGEXCL:
2899	case TIOCGETD:
2900	case TIOCSETD:
2901	case TIOCGDEV:
2902	case TIOCMGET:
2903	case TIOCMSET:
2904	case TIOCMBIC:
2905	case TIOCMBIS:
2906	case TIOCGICOUNT:
2907	case TIOCGPGRP:
2908	case TIOCSPGRP:
2909	case TIOCGSID:
2910	case TIOCSERGETLSR:
2911	case TIOCGRS485:
2912	case TIOCSRS485:
2913#ifdef TIOCGETP
2914	case TIOCGETP:
2915	case TIOCSETP:
2916	case TIOCSETN:
2917#endif
2918#ifdef TIOCGETC
2919	case TIOCGETC:
2920	case TIOCSETC:
2921#endif
2922#ifdef TIOCGLTC
2923	case TIOCGLTC:
2924	case TIOCSLTC:
2925#endif
2926	case TCSETSF:
2927	case TCSETSW:
2928	case TCSETS:
2929	case TCGETS:
2930#ifdef TCGETS2
2931	case TCGETS2:
2932	case TCSETSF2:
2933	case TCSETSW2:
2934	case TCSETS2:
2935#endif
2936	case TCGETA:
2937	case TCSETAF:
2938	case TCSETAW:
2939	case TCSETA:
2940	case TIOCGLCKTRMIOS:
2941	case TIOCSLCKTRMIOS:
2942#ifdef TCGETX
2943	case TCGETX:
2944	case TCSETX:
2945	case TCSETXW:
2946	case TCSETXF:
2947#endif
2948	case TIOCGSOFTCAR:
2949	case TIOCSSOFTCAR:
2950
2951	case PPPIOCGCHAN:
2952	case PPPIOCGUNIT:
2953		return tty_ioctl(file, cmd, (unsigned long)compat_ptr(arg));
2954	case TIOCCONS:
2955	case TIOCEXCL:
2956	case TIOCNXCL:
2957	case TIOCVHANGUP:
2958	case TIOCSBRK:
2959	case TIOCCBRK:
2960	case TCSBRK:
2961	case TCSBRKP:
2962	case TCFLSH:
2963	case TIOCGPTPEER:
2964	case TIOCNOTTY:
2965	case TIOCSCTTY:
2966	case TCXONC:
2967	case TIOCMIWAIT:
2968	case TIOCSERCONFIG:
2969		return tty_ioctl(file, cmd, arg);
2970	}
2971
2972	if (tty_paranoia_check(tty, file_inode(file), "tty_ioctl"))
2973		return -EINVAL;
2974
2975	switch (cmd) {
2976	case TIOCSSERIAL:
2977		return compat_tty_tiocsserial(tty, compat_ptr(arg));
2978	case TIOCGSERIAL:
2979		return compat_tty_tiocgserial(tty, compat_ptr(arg));
2980	}
2981	if (tty->ops->compat_ioctl) {
2982		retval = tty->ops->compat_ioctl(tty, cmd, arg);
2983		if (retval != -ENOIOCTLCMD)
2984			return retval;
2985	}
2986
2987	ld = tty_ldisc_ref_wait(tty);
2988	if (!ld)
2989		return hung_up_tty_compat_ioctl(file, cmd, arg);
2990	if (ld->ops->compat_ioctl)
2991		retval = ld->ops->compat_ioctl(tty, cmd, arg);
2992	if (retval == -ENOIOCTLCMD && ld->ops->ioctl)
2993		retval = ld->ops->ioctl(tty, (unsigned long)compat_ptr(cmd),
2994				arg);
2995	tty_ldisc_deref(ld);
2996
2997	return retval;
2998}
2999#endif
3000
3001static int this_tty(const void *t, struct file *file, unsigned fd)
3002{
3003	if (likely(file->f_op->read_iter != tty_read))
3004		return 0;
3005	return file_tty(file) != t ? 0 : fd + 1;
3006}
3007
3008/*
3009 * This implements the "Secure Attention Key" ---  the idea is to
3010 * prevent trojan horses by killing all processes associated with this
3011 * tty when the user hits the "Secure Attention Key".  Required for
3012 * super-paranoid applications --- see the Orange Book for more details.
3013 *
3014 * This code could be nicer; ideally it should send a HUP, wait a few
3015 * seconds, then send a INT, and then a KILL signal.  But you then
3016 * have to coordinate with the init process, since all processes associated
3017 * with the current tty must be dead before the new getty is allowed
3018 * to spawn.
3019 *
3020 * Now, if it would be correct ;-/ The current code has a nasty hole -
3021 * it doesn't catch files in flight. We may send the descriptor to ourselves
3022 * via AF_UNIX socket, close it and later fetch from socket. FIXME.
3023 *
3024 * Nasty bug: do_SAK is being called in interrupt context.  This can
3025 * deadlock.  We punt it up to process context.  AKPM - 16Mar2001
3026 */
3027void __do_SAK(struct tty_struct *tty)
3028{
 
 
 
3029	struct task_struct *g, *p;
3030	struct pid *session;
3031	int i;
3032	unsigned long flags;
3033
3034	spin_lock_irqsave(&tty->ctrl.lock, flags);
3035	session = get_pid(tty->ctrl.session);
3036	spin_unlock_irqrestore(&tty->ctrl.lock, flags);
3037
3038	tty_ldisc_flush(tty);
3039
3040	tty_driver_flush_buffer(tty);
3041
3042	read_lock(&tasklist_lock);
3043	/* Kill the entire session */
3044	do_each_pid_task(session, PIDTYPE_SID, p) {
3045		tty_notice(tty, "SAK: killed process %d (%s): by session\n",
3046			   task_pid_nr(p), p->comm);
3047		group_send_sig_info(SIGKILL, SEND_SIG_PRIV, p, PIDTYPE_SID);
3048	} while_each_pid_task(session, PIDTYPE_SID, p);
3049
3050	/* Now kill any processes that happen to have the tty open */
3051	for_each_process_thread(g, p) {
3052		if (p->signal->tty == tty) {
3053			tty_notice(tty, "SAK: killed process %d (%s): by controlling tty\n",
3054				   task_pid_nr(p), p->comm);
3055			group_send_sig_info(SIGKILL, SEND_SIG_PRIV, p,
3056					PIDTYPE_SID);
3057			continue;
3058		}
3059		task_lock(p);
3060		i = iterate_fd(p->files, 0, this_tty, tty);
3061		if (i != 0) {
3062			tty_notice(tty, "SAK: killed process %d (%s): by fd#%d\n",
3063				   task_pid_nr(p), p->comm, i - 1);
3064			group_send_sig_info(SIGKILL, SEND_SIG_PRIV, p,
3065					PIDTYPE_SID);
3066		}
3067		task_unlock(p);
3068	}
3069	read_unlock(&tasklist_lock);
3070	put_pid(session);
3071}
3072
3073static void do_SAK_work(struct work_struct *work)
3074{
3075	struct tty_struct *tty =
3076		container_of(work, struct tty_struct, SAK_work);
3077	__do_SAK(tty);
3078}
3079
3080/*
3081 * The tq handling here is a little racy - tty->SAK_work may already be queued.
3082 * Fortunately we don't need to worry, because if ->SAK_work is already queued,
3083 * the values which we write to it will be identical to the values which it
3084 * already has. --akpm
3085 */
3086void do_SAK(struct tty_struct *tty)
3087{
3088	if (!tty)
3089		return;
3090	schedule_work(&tty->SAK_work);
3091}
 
3092EXPORT_SYMBOL(do_SAK);
3093
3094/* Must put_device() after it's unused! */
3095static struct device *tty_get_device(struct tty_struct *tty)
3096{
3097	dev_t devt = tty_devnum(tty);
3098
3099	return class_find_device_by_devt(&tty_class, devt);
3100}
3101
3102
3103/**
3104 * alloc_tty_struct - allocate a new tty
3105 * @driver: driver which will handle the returned tty
3106 * @idx: minor of the tty
3107 *
3108 * This subroutine allocates and initializes a tty structure.
3109 *
3110 * Locking: none - @tty in question is not exposed at this point
3111 */
 
3112struct tty_struct *alloc_tty_struct(struct tty_driver *driver, int idx)
3113{
3114	struct tty_struct *tty;
3115
3116	tty = kzalloc(sizeof(*tty), GFP_KERNEL_ACCOUNT);
3117	if (!tty)
3118		return NULL;
3119
3120	kref_init(&tty->kref);
 
3121	if (tty_ldisc_init(tty)) {
3122		kfree(tty);
3123		return NULL;
3124	}
3125	tty->ctrl.session = NULL;
3126	tty->ctrl.pgrp = NULL;
3127	mutex_init(&tty->legacy_mutex);
3128	mutex_init(&tty->throttle_mutex);
3129	init_rwsem(&tty->termios_rwsem);
3130	mutex_init(&tty->winsize_mutex);
3131	init_ldsem(&tty->ldisc_sem);
3132	init_waitqueue_head(&tty->write_wait);
3133	init_waitqueue_head(&tty->read_wait);
3134	INIT_WORK(&tty->hangup_work, do_tty_hangup);
3135	mutex_init(&tty->atomic_write_lock);
3136	spin_lock_init(&tty->ctrl.lock);
3137	spin_lock_init(&tty->flow.lock);
3138	spin_lock_init(&tty->files_lock);
3139	INIT_LIST_HEAD(&tty->tty_files);
3140	INIT_WORK(&tty->SAK_work, do_SAK_work);
3141
3142	tty->driver = driver;
3143	tty->ops = driver->ops;
3144	tty->index = idx;
3145	tty_line_name(driver, idx, tty->name);
3146	tty->dev = tty_get_device(tty);
3147
3148	return tty;
3149}
3150
3151/**
3152 * tty_put_char - write one character to a tty
3153 * @tty: tty
3154 * @ch: character to write
3155 *
3156 * Write one byte to the @tty using the provided @tty->ops->put_char() method
3157 * if present.
3158 *
3159 * Note: the specific put_char operation in the driver layer may go
3160 * away soon. Don't call it directly, use this method
3161 *
3162 * Return: the number of characters successfully output.
 
3163 */
3164int tty_put_char(struct tty_struct *tty, u8 ch)
 
3165{
3166	if (tty->ops->put_char)
3167		return tty->ops->put_char(tty, ch);
3168	return tty->ops->write(tty, &ch, 1);
3169}
3170EXPORT_SYMBOL_GPL(tty_put_char);
3171
 
 
3172static int tty_cdev_add(struct tty_driver *driver, dev_t dev,
3173		unsigned int index, unsigned int count)
3174{
3175	int err;
3176
3177	/* init here, since reused cdevs cause crashes */
3178	driver->cdevs[index] = cdev_alloc();
3179	if (!driver->cdevs[index])
3180		return -ENOMEM;
3181	driver->cdevs[index]->ops = &tty_fops;
3182	driver->cdevs[index]->owner = driver->owner;
3183	err = cdev_add(driver->cdevs[index], dev, count);
3184	if (err)
3185		kobject_put(&driver->cdevs[index]->kobj);
3186	return err;
3187}
3188
3189/**
3190 * tty_register_device - register a tty device
3191 * @driver: the tty driver that describes the tty device
3192 * @index: the index in the tty driver for this tty device
3193 * @device: a struct device that is associated with this tty device.
3194 *	This field is optional, if there is no known struct device
3195 *	for this tty device it can be set to NULL safely.
3196 *
3197 * This call is required to be made to register an individual tty device
3198 * if the tty driver's flags have the %TTY_DRIVER_DYNAMIC_DEV bit set.  If
3199 * that bit is not set, this function should not be called by a tty
3200 * driver.
3201 *
3202 * Locking: ??
 
3203 *
3204 * Return: A pointer to the struct device for this tty device (or
3205 * ERR_PTR(-EFOO) on error).
3206 */
 
3207struct device *tty_register_device(struct tty_driver *driver, unsigned index,
3208				   struct device *device)
3209{
3210	return tty_register_device_attr(driver, index, device, NULL, NULL);
3211}
3212EXPORT_SYMBOL(tty_register_device);
3213
3214static void tty_device_create_release(struct device *dev)
3215{
3216	dev_dbg(dev, "releasing...\n");
3217	kfree(dev);
3218}
3219
3220/**
3221 * tty_register_device_attr - register a tty device
3222 * @driver: the tty driver that describes the tty device
3223 * @index: the index in the tty driver for this tty device
3224 * @device: a struct device that is associated with this tty device.
3225 *	This field is optional, if there is no known struct device
3226 *	for this tty device it can be set to %NULL safely.
3227 * @drvdata: Driver data to be set to device.
3228 * @attr_grp: Attribute group to be set on device.
3229 *
3230 * This call is required to be made to register an individual tty device if the
3231 * tty driver's flags have the %TTY_DRIVER_DYNAMIC_DEV bit set. If that bit is
3232 * not set, this function should not be called by a tty driver.
3233 *
3234 * Locking: ??
 
 
3235 *
3236 * Return: A pointer to the struct device for this tty device (or
3237 * ERR_PTR(-EFOO) on error).
3238 */
3239struct device *tty_register_device_attr(struct tty_driver *driver,
3240				   unsigned index, struct device *device,
3241				   void *drvdata,
3242				   const struct attribute_group **attr_grp)
3243{
3244	char name[64];
3245	dev_t devt = MKDEV(driver->major, driver->minor_start) + index;
3246	struct ktermios *tp;
3247	struct device *dev;
3248	int retval;
3249
3250	if (index >= driver->num) {
3251		pr_err("%s: Attempt to register invalid tty line number (%d)\n",
3252		       driver->name, index);
3253		return ERR_PTR(-EINVAL);
3254	}
3255
3256	if (driver->type == TTY_DRIVER_TYPE_PTY)
3257		pty_line_name(driver, index, name);
3258	else
3259		tty_line_name(driver, index, name);
3260
3261	dev = kzalloc(sizeof(*dev), GFP_KERNEL);
3262	if (!dev)
3263		return ERR_PTR(-ENOMEM);
3264
3265	dev->devt = devt;
3266	dev->class = &tty_class;
3267	dev->parent = device;
3268	dev->release = tty_device_create_release;
3269	dev_set_name(dev, "%s", name);
3270	dev->groups = attr_grp;
3271	dev_set_drvdata(dev, drvdata);
3272
3273	dev_set_uevent_suppress(dev, 1);
3274
3275	retval = device_register(dev);
3276	if (retval)
3277		goto err_put;
3278
3279	if (!(driver->flags & TTY_DRIVER_DYNAMIC_ALLOC)) {
3280		/*
3281		 * Free any saved termios data so that the termios state is
3282		 * reset when reusing a minor number.
3283		 */
3284		tp = driver->termios[index];
3285		if (tp) {
3286			driver->termios[index] = NULL;
3287			kfree(tp);
3288		}
3289
3290		retval = tty_cdev_add(driver, devt, index, 1);
3291		if (retval)
3292			goto err_del;
3293	}
3294
3295	dev_set_uevent_suppress(dev, 0);
3296	kobject_uevent(&dev->kobj, KOBJ_ADD);
3297
3298	return dev;
3299
3300err_del:
3301	device_del(dev);
3302err_put:
3303	put_device(dev);
3304
3305	return ERR_PTR(retval);
3306}
3307EXPORT_SYMBOL_GPL(tty_register_device_attr);
3308
3309/**
3310 * tty_unregister_device - unregister a tty device
3311 * @driver: the tty driver that describes the tty device
3312 * @index: the index in the tty driver for this tty device
3313 *
3314 * If a tty device is registered with a call to tty_register_device() then
3315 * this function must be called when the tty device is gone.
3316 *
3317 * Locking: ??
3318 */
 
3319void tty_unregister_device(struct tty_driver *driver, unsigned index)
3320{
3321	device_destroy(&tty_class, MKDEV(driver->major, driver->minor_start) + index);
 
3322	if (!(driver->flags & TTY_DRIVER_DYNAMIC_ALLOC)) {
3323		cdev_del(driver->cdevs[index]);
3324		driver->cdevs[index] = NULL;
3325	}
3326}
3327EXPORT_SYMBOL(tty_unregister_device);
3328
3329/**
3330 * __tty_alloc_driver - allocate tty driver
3331 * @lines: count of lines this driver can handle at most
3332 * @owner: module which is responsible for this driver
3333 * @flags: some of %TTY_DRIVER_ flags, will be set in driver->flags
3334 *
3335 * This should not be called directly, some of the provided macros should be
3336 * used instead. Use IS_ERR() and friends on @retval.
3337 */
3338struct tty_driver *__tty_alloc_driver(unsigned int lines, struct module *owner,
3339		unsigned long flags)
3340{
3341	struct tty_driver *driver;
3342	unsigned int cdevs = 1;
3343	int err;
3344
3345	if (!lines || (flags & TTY_DRIVER_UNNUMBERED_NODE && lines > 1))
3346		return ERR_PTR(-EINVAL);
3347
3348	driver = kzalloc(sizeof(*driver), GFP_KERNEL);
3349	if (!driver)
3350		return ERR_PTR(-ENOMEM);
3351
3352	kref_init(&driver->kref);
 
3353	driver->num = lines;
3354	driver->owner = owner;
3355	driver->flags = flags;
3356
3357	if (!(flags & TTY_DRIVER_DEVPTS_MEM)) {
3358		driver->ttys = kcalloc(lines, sizeof(*driver->ttys),
3359				GFP_KERNEL);
3360		driver->termios = kcalloc(lines, sizeof(*driver->termios),
3361				GFP_KERNEL);
3362		if (!driver->ttys || !driver->termios) {
3363			err = -ENOMEM;
3364			goto err_free_all;
3365		}
3366	}
3367
3368	if (!(flags & TTY_DRIVER_DYNAMIC_ALLOC)) {
3369		driver->ports = kcalloc(lines, sizeof(*driver->ports),
3370				GFP_KERNEL);
3371		if (!driver->ports) {
3372			err = -ENOMEM;
3373			goto err_free_all;
3374		}
3375		cdevs = lines;
3376	}
3377
3378	driver->cdevs = kcalloc(cdevs, sizeof(*driver->cdevs), GFP_KERNEL);
3379	if (!driver->cdevs) {
3380		err = -ENOMEM;
3381		goto err_free_all;
3382	}
3383
3384	return driver;
3385err_free_all:
3386	kfree(driver->ports);
3387	kfree(driver->ttys);
3388	kfree(driver->termios);
3389	kfree(driver->cdevs);
3390	kfree(driver);
3391	return ERR_PTR(err);
3392}
3393EXPORT_SYMBOL(__tty_alloc_driver);
3394
3395static void destruct_tty_driver(struct kref *kref)
3396{
3397	struct tty_driver *driver = container_of(kref, struct tty_driver, kref);
3398	int i;
3399	struct ktermios *tp;
3400
3401	if (driver->flags & TTY_DRIVER_INSTALLED) {
3402		for (i = 0; i < driver->num; i++) {
3403			tp = driver->termios[i];
3404			if (tp) {
3405				driver->termios[i] = NULL;
3406				kfree(tp);
3407			}
3408			if (!(driver->flags & TTY_DRIVER_DYNAMIC_DEV))
3409				tty_unregister_device(driver, i);
3410		}
3411		proc_tty_unregister_driver(driver);
3412		if (driver->flags & TTY_DRIVER_DYNAMIC_ALLOC)
3413			cdev_del(driver->cdevs[0]);
3414	}
3415	kfree(driver->cdevs);
3416	kfree(driver->ports);
3417	kfree(driver->termios);
3418	kfree(driver->ttys);
3419	kfree(driver);
3420}
3421
3422/**
3423 * tty_driver_kref_put - drop a reference to a tty driver
3424 * @driver: driver of which to drop the reference
3425 *
3426 * The final put will destroy and free up the driver.
3427 */
3428void tty_driver_kref_put(struct tty_driver *driver)
3429{
3430	kref_put(&driver->kref, destruct_tty_driver);
3431}
3432EXPORT_SYMBOL(tty_driver_kref_put);
3433
3434/**
3435 * tty_register_driver - register a tty driver
3436 * @driver: driver to register
3437 *
 
 
 
 
 
 
 
 
 
 
3438 * Called by a tty driver to register itself.
3439 */
3440int tty_register_driver(struct tty_driver *driver)
3441{
3442	int error;
3443	int i;
3444	dev_t dev;
3445	struct device *d;
3446
3447	if (!driver->major) {
3448		error = alloc_chrdev_region(&dev, driver->minor_start,
3449						driver->num, driver->name);
3450		if (!error) {
3451			driver->major = MAJOR(dev);
3452			driver->minor_start = MINOR(dev);
3453		}
3454	} else {
3455		dev = MKDEV(driver->major, driver->minor_start);
3456		error = register_chrdev_region(dev, driver->num, driver->name);
3457	}
3458	if (error < 0)
3459		goto err;
3460
3461	if (driver->flags & TTY_DRIVER_DYNAMIC_ALLOC) {
3462		error = tty_cdev_add(driver, dev, 0, driver->num);
3463		if (error)
3464			goto err_unreg_char;
3465	}
3466
3467	mutex_lock(&tty_mutex);
3468	list_add(&driver->tty_drivers, &tty_drivers);
3469	mutex_unlock(&tty_mutex);
3470
3471	if (!(driver->flags & TTY_DRIVER_DYNAMIC_DEV)) {
3472		for (i = 0; i < driver->num; i++) {
3473			d = tty_register_device(driver, i, NULL);
3474			if (IS_ERR(d)) {
3475				error = PTR_ERR(d);
3476				goto err_unreg_devs;
3477			}
3478		}
3479	}
3480	proc_tty_register_driver(driver);
3481	driver->flags |= TTY_DRIVER_INSTALLED;
3482	return 0;
3483
3484err_unreg_devs:
3485	for (i--; i >= 0; i--)
3486		tty_unregister_device(driver, i);
3487
3488	mutex_lock(&tty_mutex);
3489	list_del(&driver->tty_drivers);
3490	mutex_unlock(&tty_mutex);
3491
3492err_unreg_char:
3493	unregister_chrdev_region(dev, driver->num);
3494err:
3495	return error;
3496}
3497EXPORT_SYMBOL(tty_register_driver);
3498
3499/**
3500 * tty_unregister_driver - unregister a tty driver
3501 * @driver: driver to unregister
3502 *
3503 * Called by a tty driver to unregister itself.
3504 */
3505void tty_unregister_driver(struct tty_driver *driver)
3506{
 
 
 
 
 
3507	unregister_chrdev_region(MKDEV(driver->major, driver->minor_start),
3508				driver->num);
3509	mutex_lock(&tty_mutex);
3510	list_del(&driver->tty_drivers);
3511	mutex_unlock(&tty_mutex);
 
3512}
 
3513EXPORT_SYMBOL(tty_unregister_driver);
3514
3515dev_t tty_devnum(struct tty_struct *tty)
3516{
3517	return MKDEV(tty->driver->major, tty->driver->minor_start) + tty->index;
3518}
3519EXPORT_SYMBOL(tty_devnum);
3520
3521void tty_default_fops(struct file_operations *fops)
3522{
3523	*fops = tty_fops;
3524}
3525
3526static char *tty_devnode(const struct device *dev, umode_t *mode)
3527{
3528	if (!mode)
3529		return NULL;
3530	if (dev->devt == MKDEV(TTYAUX_MAJOR, 0) ||
3531	    dev->devt == MKDEV(TTYAUX_MAJOR, 2))
3532		*mode = 0666;
3533	return NULL;
3534}
3535
3536const struct class tty_class = {
3537	.name		= "tty",
3538	.devnode	= tty_devnode,
3539};
3540
3541static int __init tty_class_init(void)
3542{
3543	return class_register(&tty_class);
 
 
 
 
3544}
3545
3546postcore_initcall(tty_class_init);
3547
3548/* 3/2004 jmc: why do these devices exist? */
3549static struct cdev tty_cdev, console_cdev;
3550
3551static ssize_t show_cons_active(struct device *dev,
3552				struct device_attribute *attr, char *buf)
3553{
3554	struct console *cs[16];
3555	int i = 0;
3556	struct console *c;
3557	ssize_t count = 0;
3558
3559	/*
3560	 * Hold the console_list_lock to guarantee that no consoles are
3561	 * unregistered until all console processing is complete.
3562	 * This also allows safe traversal of the console list and
3563	 * race-free reading of @flags.
3564	 */
3565	console_list_lock();
3566
3567	for_each_console(c) {
3568		if (!c->device)
3569			continue;
3570		if (!c->write)
3571			continue;
3572		if ((c->flags & CON_ENABLED) == 0)
3573			continue;
3574		cs[i++] = c;
3575		if (i >= ARRAY_SIZE(cs))
3576			break;
3577	}
3578
3579	/*
3580	 * Take console_lock to serialize device() callback with
3581	 * other console operations. For example, fg_console is
3582	 * modified under console_lock when switching vt.
3583	 */
3584	console_lock();
3585	while (i--) {
3586		int index = cs[i]->index;
3587		struct tty_driver *drv = cs[i]->device(cs[i], &index);
3588
3589		/* don't resolve tty0 as some programs depend on it */
3590		if (drv && (cs[i]->index > 0 || drv->major != TTY_MAJOR))
3591			count += tty_line_name(drv, index, buf + count);
3592		else
3593			count += sprintf(buf + count, "%s%d",
3594					 cs[i]->name, cs[i]->index);
3595
3596		count += sprintf(buf + count, "%c", i ? ' ':'\n');
3597	}
3598	console_unlock();
3599
3600	console_list_unlock();
3601
3602	return count;
3603}
3604static DEVICE_ATTR(active, S_IRUGO, show_cons_active, NULL);
3605
3606static struct attribute *cons_dev_attrs[] = {
3607	&dev_attr_active.attr,
3608	NULL
3609};
3610
3611ATTRIBUTE_GROUPS(cons_dev);
3612
3613static struct device *consdev;
3614
3615void console_sysfs_notify(void)
3616{
3617	if (consdev)
3618		sysfs_notify(&consdev->kobj, NULL, "active");
3619}
3620
3621static struct ctl_table tty_table[] = {
3622	{
3623		.procname	= "legacy_tiocsti",
3624		.data		= &tty_legacy_tiocsti,
3625		.maxlen		= sizeof(tty_legacy_tiocsti),
3626		.mode		= 0644,
3627		.proc_handler	= proc_dobool,
3628	},
3629	{
3630		.procname	= "ldisc_autoload",
3631		.data		= &tty_ldisc_autoload,
3632		.maxlen		= sizeof(tty_ldisc_autoload),
3633		.mode		= 0644,
3634		.proc_handler	= proc_dointvec,
3635		.extra1		= SYSCTL_ZERO,
3636		.extra2		= SYSCTL_ONE,
3637	},
3638};
3639
3640/*
3641 * Ok, now we can initialize the rest of the tty devices and can count
3642 * on memory allocations, interrupts etc..
3643 */
3644int __init tty_init(void)
3645{
3646	register_sysctl_init("dev/tty", tty_table);
3647	cdev_init(&tty_cdev, &tty_fops);
3648	if (cdev_add(&tty_cdev, MKDEV(TTYAUX_MAJOR, 0), 1) ||
3649	    register_chrdev_region(MKDEV(TTYAUX_MAJOR, 0), 1, "/dev/tty") < 0)
3650		panic("Couldn't register /dev/tty driver\n");
3651	device_create(&tty_class, NULL, MKDEV(TTYAUX_MAJOR, 0), NULL, "tty");
3652
3653	cdev_init(&console_cdev, &console_fops);
3654	if (cdev_add(&console_cdev, MKDEV(TTYAUX_MAJOR, 1), 1) ||
3655	    register_chrdev_region(MKDEV(TTYAUX_MAJOR, 1), 1, "/dev/console") < 0)
3656		panic("Couldn't register /dev/console driver\n");
3657	consdev = device_create_with_groups(&tty_class, NULL,
3658					    MKDEV(TTYAUX_MAJOR, 1), NULL,
3659					    cons_dev_groups, "console");
3660	if (IS_ERR(consdev))
3661		consdev = NULL;
3662
3663#ifdef CONFIG_VT
3664	vty_init(&console_fops);
3665#endif
3666	return 0;
3667}
v5.9
   1// SPDX-License-Identifier: GPL-2.0
   2/*
   3 *  Copyright (C) 1991, 1992  Linus Torvalds
   4 */
   5
   6/*
   7 * 'tty_io.c' gives an orthogonal feeling to tty's, be they consoles
   8 * or rs-channels. It also implements echoing, cooked mode etc.
   9 *
  10 * Kill-line thanks to John T Kohl, who also corrected VMIN = VTIME = 0.
  11 *
  12 * Modified by Theodore Ts'o, 9/14/92, to dynamically allocate the
  13 * tty_struct and tty_queue structures.  Previously there was an array
  14 * of 256 tty_struct's which was statically allocated, and the
  15 * tty_queue structures were allocated at boot time.  Both are now
  16 * dynamically allocated only when the tty is open.
  17 *
  18 * Also restructured routines so that there is more of a separation
  19 * between the high-level tty routines (tty_io.c and tty_ioctl.c) and
  20 * the low-level tty routines (serial.c, pty.c, console.c).  This
  21 * makes for cleaner and more compact code.  -TYT, 9/17/92
  22 *
  23 * Modified by Fred N. van Kempen, 01/29/93, to add line disciplines
  24 * which can be dynamically activated and de-activated by the line
  25 * discipline handling modules (like SLIP).
  26 *
  27 * NOTE: pay no attention to the line discipline code (yet); its
  28 * interface is still subject to change in this version...
  29 * -- TYT, 1/31/92
  30 *
  31 * Added functionality to the OPOST tty handling.  No delays, but all
  32 * other bits should be there.
  33 *	-- Nick Holloway <alfie@dcs.warwick.ac.uk>, 27th May 1993.
  34 *
  35 * Rewrote canonical mode and added more termios flags.
  36 * 	-- julian@uhunix.uhcc.hawaii.edu (J. Cowley), 13Jan94
  37 *
  38 * Reorganized FASYNC support so mouse code can share it.
  39 *	-- ctm@ardi.com, 9Sep95
  40 *
  41 * New TIOCLINUX variants added.
  42 *	-- mj@k332.feld.cvut.cz, 19-Nov-95
  43 *
  44 * Restrict vt switching via ioctl()
  45 *      -- grif@cs.ucr.edu, 5-Dec-95
  46 *
  47 * Move console and virtual terminal code to more appropriate files,
  48 * implement CONFIG_VT and generalize console device interface.
  49 *	-- Marko Kohtala <Marko.Kohtala@hut.fi>, March 97
  50 *
  51 * Rewrote tty_init_dev and tty_release_dev to eliminate races.
  52 *	-- Bill Hawes <whawes@star.net>, June 97
  53 *
  54 * Added devfs support.
  55 *      -- C. Scott Ananian <cananian@alumni.princeton.edu>, 13-Jan-1998
  56 *
  57 * Added support for a Unix98-style ptmx device.
  58 *      -- C. Scott Ananian <cananian@alumni.princeton.edu>, 14-Jan-1998
  59 *
  60 * Reduced memory usage for older ARM systems
  61 *      -- Russell King <rmk@arm.linux.org.uk>
  62 *
  63 * Move do_SAK() into process context.  Less stack use in devfs functions.
  64 * alloc_tty_struct() always uses kmalloc()
  65 *			 -- Andrew Morton <andrewm@uow.edu.eu> 17Mar01
  66 */
  67
  68#include <linux/types.h>
  69#include <linux/major.h>
  70#include <linux/errno.h>
  71#include <linux/signal.h>
  72#include <linux/fcntl.h>
  73#include <linux/sched/signal.h>
  74#include <linux/sched/task.h>
  75#include <linux/interrupt.h>
  76#include <linux/tty.h>
  77#include <linux/tty_driver.h>
  78#include <linux/tty_flip.h>
  79#include <linux/devpts_fs.h>
  80#include <linux/file.h>
  81#include <linux/fdtable.h>
  82#include <linux/console.h>
  83#include <linux/timer.h>
  84#include <linux/ctype.h>
  85#include <linux/kd.h>
  86#include <linux/mm.h>
  87#include <linux/string.h>
  88#include <linux/slab.h>
  89#include <linux/poll.h>
  90#include <linux/ppp-ioctl.h>
  91#include <linux/proc_fs.h>
  92#include <linux/init.h>
  93#include <linux/module.h>
  94#include <linux/device.h>
  95#include <linux/wait.h>
  96#include <linux/bitops.h>
  97#include <linux/delay.h>
  98#include <linux/seq_file.h>
  99#include <linux/serial.h>
 100#include <linux/ratelimit.h>
 101#include <linux/compat.h>
 102
 103#include <linux/uaccess.h>
 
 
 104
 105#include <linux/kbd_kern.h>
 106#include <linux/vt_kern.h>
 107#include <linux/selection.h>
 108
 109#include <linux/kmod.h>
 110#include <linux/nsproxy.h>
 
 111
 112#undef TTY_DEBUG_HANGUP
 113#ifdef TTY_DEBUG_HANGUP
 114# define tty_debug_hangup(tty, f, args...)	tty_debug(tty, f, ##args)
 115#else
 116# define tty_debug_hangup(tty, f, args...)	do { } while (0)
 117#endif
 118
 119#define TTY_PARANOIA_CHECK 1
 120#define CHECK_TTY_COUNT 1
 121
 122struct ktermios tty_std_termios = {	/* for the benefit of tty drivers  */
 123	.c_iflag = ICRNL | IXON,
 124	.c_oflag = OPOST | ONLCR,
 125	.c_cflag = B38400 | CS8 | CREAD | HUPCL,
 126	.c_lflag = ISIG | ICANON | ECHO | ECHOE | ECHOK |
 127		   ECHOCTL | ECHOKE | IEXTEN,
 128	.c_cc = INIT_C_CC,
 129	.c_ispeed = 38400,
 130	.c_ospeed = 38400,
 131	/* .c_line = N_TTY, */
 132};
 133
 134EXPORT_SYMBOL(tty_std_termios);
 135
 136/* This list gets poked at by procfs and various bits of boot up code. This
 137   could do with some rationalisation such as pulling the tty proc function
 138   into this file */
 
 139
 140LIST_HEAD(tty_drivers);			/* linked list of tty drivers */
 141
 142/* Mutex to protect creating and releasing a tty */
 143DEFINE_MUTEX(tty_mutex);
 144
 145static ssize_t tty_read(struct file *, char __user *, size_t, loff_t *);
 146static ssize_t tty_write(struct file *, const char __user *, size_t, loff_t *);
 147ssize_t redirected_tty_write(struct file *, const char __user *,
 148							size_t, loff_t *);
 149static __poll_t tty_poll(struct file *, poll_table *);
 150static int tty_open(struct inode *, struct file *);
 151long tty_ioctl(struct file *file, unsigned int cmd, unsigned long arg);
 152#ifdef CONFIG_COMPAT
 153static long tty_compat_ioctl(struct file *file, unsigned int cmd,
 154				unsigned long arg);
 155#else
 156#define tty_compat_ioctl NULL
 157#endif
 158static int __tty_fasync(int fd, struct file *filp, int on);
 159static int tty_fasync(int fd, struct file *filp, int on);
 160static void release_tty(struct tty_struct *tty, int idx);
 161
 162/**
 163 *	free_tty_struct		-	free a disused tty
 164 *	@tty: tty struct to free
 165 *
 166 *	Free the write buffers, tty queue and tty memory itself.
 167 *
 168 *	Locking: none. Must be called after tty is definitely unused
 169 */
 170
 171static void free_tty_struct(struct tty_struct *tty)
 172{
 173	tty_ldisc_deinit(tty);
 174	put_device(tty->dev);
 175	kfree(tty->write_buf);
 176	tty->magic = 0xDEADDEAD;
 177	kfree(tty);
 178}
 179
 180static inline struct tty_struct *file_tty(struct file *file)
 181{
 182	return ((struct tty_file_private *)file->private_data)->tty;
 183}
 184
 185int tty_alloc_file(struct file *file)
 186{
 187	struct tty_file_private *priv;
 188
 189	priv = kmalloc(sizeof(*priv), GFP_KERNEL);
 190	if (!priv)
 191		return -ENOMEM;
 192
 193	file->private_data = priv;
 194
 195	return 0;
 196}
 197
 198/* Associate a new file with the tty structure */
 199void tty_add_file(struct tty_struct *tty, struct file *file)
 200{
 201	struct tty_file_private *priv = file->private_data;
 202
 203	priv->tty = tty;
 204	priv->file = file;
 205
 206	spin_lock(&tty->files_lock);
 207	list_add(&priv->list, &tty->tty_files);
 208	spin_unlock(&tty->files_lock);
 209}
 210
 211/**
 212 * tty_free_file - free file->private_data
 
 213 *
 214 * This shall be used only for fail path handling when tty_add_file was not
 215 * called yet.
 216 */
 217void tty_free_file(struct file *file)
 218{
 219	struct tty_file_private *priv = file->private_data;
 220
 221	file->private_data = NULL;
 222	kfree(priv);
 223}
 224
 225/* Delete file from its tty */
 226static void tty_del_file(struct file *file)
 227{
 228	struct tty_file_private *priv = file->private_data;
 229	struct tty_struct *tty = priv->tty;
 230
 231	spin_lock(&tty->files_lock);
 232	list_del(&priv->list);
 233	spin_unlock(&tty->files_lock);
 234	tty_free_file(file);
 235}
 236
 237/**
 238 *	tty_name	-	return tty naming
 239 *	@tty: tty structure
 240 *
 241 *	Convert a tty structure into a name. The name reflects the kernel
 242 *	naming policy and if udev is in use may not reflect user space
 243 *
 244 *	Locking: none
 245 */
 246
 247const char *tty_name(const struct tty_struct *tty)
 248{
 249	if (!tty) /* Hmm.  NULL pointer.  That's fun. */
 250		return "NULL tty";
 251	return tty->name;
 252}
 253
 254EXPORT_SYMBOL(tty_name);
 255
 256const char *tty_driver_name(const struct tty_struct *tty)
 257{
 258	if (!tty || !tty->driver)
 259		return "";
 260	return tty->driver->name;
 261}
 262
 263static int tty_paranoia_check(struct tty_struct *tty, struct inode *inode,
 264			      const char *routine)
 265{
 266#ifdef TTY_PARANOIA_CHECK
 267	if (!tty) {
 268		pr_warn("(%d:%d): %s: NULL tty\n",
 269			imajor(inode), iminor(inode), routine);
 270		return 1;
 271	}
 272	if (tty->magic != TTY_MAGIC) {
 273		pr_warn("(%d:%d): %s: bad magic number\n",
 274			imajor(inode), iminor(inode), routine);
 275		return 1;
 276	}
 277#endif
 278	return 0;
 279}
 280
 281/* Caller must hold tty_lock */
 282static int check_tty_count(struct tty_struct *tty, const char *routine)
 283{
 284#ifdef CHECK_TTY_COUNT
 285	struct list_head *p;
 286	int count = 0, kopen_count = 0;
 287
 288	spin_lock(&tty->files_lock);
 289	list_for_each(p, &tty->tty_files) {
 290		count++;
 291	}
 292	spin_unlock(&tty->files_lock);
 293	if (tty->driver->type == TTY_DRIVER_TYPE_PTY &&
 294	    tty->driver->subtype == PTY_TYPE_SLAVE &&
 295	    tty->link && tty->link->count)
 296		count++;
 297	if (tty_port_kopened(tty->port))
 298		kopen_count++;
 299	if (tty->count != (count + kopen_count)) {
 300		tty_warn(tty, "%s: tty->count(%d) != (#fd's(%d) + #kopen's(%d))\n",
 301			 routine, tty->count, count, kopen_count);
 302		return (count + kopen_count);
 303	}
 304#endif
 305	return 0;
 306}
 307
 308/**
 309 *	get_tty_driver		-	find device of a tty
 310 *	@dev_t: device identifier
 311 *	@index: returns the index of the tty
 312 *
 313 *	This routine returns a tty driver structure, given a device number
 314 *	and also passes back the index number.
 315 *
 316 *	Locking: caller must hold tty_mutex
 317 */
 318
 319static struct tty_driver *get_tty_driver(dev_t device, int *index)
 320{
 321	struct tty_driver *p;
 322
 323	list_for_each_entry(p, &tty_drivers, tty_drivers) {
 324		dev_t base = MKDEV(p->major, p->minor_start);
 
 325		if (device < base || device >= base + p->num)
 326			continue;
 327		*index = device - base;
 328		return tty_driver_kref_get(p);
 329	}
 330	return NULL;
 331}
 332
 333/**
 334 *	tty_dev_name_to_number	-	return dev_t for device name
 335 *	@name: user space name of device under /dev
 336 *	@number: pointer to dev_t that this function will populate
 337 *
 338 *	This function converts device names like ttyS0 or ttyUSB1 into dev_t
 339 *	like (4, 64) or (188, 1). If no corresponding driver is registered then
 340 *	the function returns -ENODEV.
 341 *
 342 *	Locking: this acquires tty_mutex to protect the tty_drivers list from
 343 *		being modified while we are traversing it, and makes sure to
 344 *		release it before exiting.
 345 */
 346int tty_dev_name_to_number(const char *name, dev_t *number)
 347{
 348	struct tty_driver *p;
 349	int ret;
 350	int index, prefix_length = 0;
 351	const char *str;
 352
 353	for (str = name; *str && !isdigit(*str); str++)
 354		;
 355
 356	if (!*str)
 357		return -EINVAL;
 358
 359	ret = kstrtoint(str, 10, &index);
 360	if (ret)
 361		return ret;
 362
 363	prefix_length = str - name;
 364	mutex_lock(&tty_mutex);
 365
 366	list_for_each_entry(p, &tty_drivers, tty_drivers)
 367		if (prefix_length == strlen(p->name) && strncmp(name,
 368					p->name, prefix_length) == 0) {
 369			if (index < p->num) {
 370				*number = MKDEV(p->major, p->minor_start + index);
 371				goto out;
 372			}
 373		}
 374
 375	/* if here then driver wasn't found */
 376	ret = -ENODEV;
 377out:
 378	mutex_unlock(&tty_mutex);
 379	return ret;
 380}
 381EXPORT_SYMBOL_GPL(tty_dev_name_to_number);
 382
 383#ifdef CONFIG_CONSOLE_POLL
 384
 385/**
 386 *	tty_find_polling_driver	-	find device of a polled tty
 387 *	@name: name string to match
 388 *	@line: pointer to resulting tty line nr
 389 *
 390 *	This routine returns a tty driver structure, given a name
 391 *	and the condition that the tty driver is capable of polled
 392 *	operation.
 393 */
 394struct tty_driver *tty_find_polling_driver(char *name, int *line)
 395{
 396	struct tty_driver *p, *res = NULL;
 397	int tty_line = 0;
 398	int len;
 399	char *str, *stp;
 400
 401	for (str = name; *str; str++)
 402		if ((*str >= '0' && *str <= '9') || *str == ',')
 403			break;
 404	if (!*str)
 405		return NULL;
 406
 407	len = str - name;
 408	tty_line = simple_strtoul(str, &str, 10);
 409
 410	mutex_lock(&tty_mutex);
 411	/* Search through the tty devices to look for a match */
 412	list_for_each_entry(p, &tty_drivers, tty_drivers) {
 413		if (!len || strncmp(name, p->name, len) != 0)
 414			continue;
 415		stp = str;
 416		if (*stp == ',')
 417			stp++;
 418		if (*stp == '\0')
 419			stp = NULL;
 420
 421		if (tty_line >= 0 && tty_line < p->num && p->ops &&
 422		    p->ops->poll_init && !p->ops->poll_init(p, tty_line, stp)) {
 423			res = tty_driver_kref_get(p);
 424			*line = tty_line;
 425			break;
 426		}
 427	}
 428	mutex_unlock(&tty_mutex);
 429
 430	return res;
 431}
 432EXPORT_SYMBOL_GPL(tty_find_polling_driver);
 433#endif
 434
 435static ssize_t hung_up_tty_read(struct file *file, char __user *buf,
 436				size_t count, loff_t *ppos)
 437{
 438	return 0;
 439}
 440
 441static ssize_t hung_up_tty_write(struct file *file, const char __user *buf,
 442				 size_t count, loff_t *ppos)
 443{
 444	return -EIO;
 445}
 446
 447/* No kernel lock held - none needed ;) */
 448static __poll_t hung_up_tty_poll(struct file *filp, poll_table *wait)
 449{
 450	return EPOLLIN | EPOLLOUT | EPOLLERR | EPOLLHUP | EPOLLRDNORM | EPOLLWRNORM;
 451}
 452
 453static long hung_up_tty_ioctl(struct file *file, unsigned int cmd,
 454		unsigned long arg)
 455{
 456	return cmd == TIOCSPGRP ? -ENOTTY : -EIO;
 457}
 458
 459static long hung_up_tty_compat_ioctl(struct file *file,
 460				     unsigned int cmd, unsigned long arg)
 461{
 462	return cmd == TIOCSPGRP ? -ENOTTY : -EIO;
 463}
 464
 465static int hung_up_tty_fasync(int fd, struct file *file, int on)
 466{
 467	return -ENOTTY;
 468}
 469
 470static void tty_show_fdinfo(struct seq_file *m, struct file *file)
 471{
 472	struct tty_struct *tty = file_tty(file);
 473
 474	if (tty && tty->ops && tty->ops->show_fdinfo)
 475		tty->ops->show_fdinfo(tty, m);
 476}
 477
 478static const struct file_operations tty_fops = {
 479	.llseek		= no_llseek,
 480	.read		= tty_read,
 481	.write		= tty_write,
 
 
 482	.poll		= tty_poll,
 483	.unlocked_ioctl	= tty_ioctl,
 484	.compat_ioctl	= tty_compat_ioctl,
 485	.open		= tty_open,
 486	.release	= tty_release,
 487	.fasync		= tty_fasync,
 488	.show_fdinfo	= tty_show_fdinfo,
 489};
 490
 491static const struct file_operations console_fops = {
 492	.llseek		= no_llseek,
 493	.read		= tty_read,
 494	.write		= redirected_tty_write,
 
 
 495	.poll		= tty_poll,
 496	.unlocked_ioctl	= tty_ioctl,
 497	.compat_ioctl	= tty_compat_ioctl,
 498	.open		= tty_open,
 499	.release	= tty_release,
 500	.fasync		= tty_fasync,
 501};
 502
 503static const struct file_operations hung_up_tty_fops = {
 504	.llseek		= no_llseek,
 505	.read		= hung_up_tty_read,
 506	.write		= hung_up_tty_write,
 507	.poll		= hung_up_tty_poll,
 508	.unlocked_ioctl	= hung_up_tty_ioctl,
 509	.compat_ioctl	= hung_up_tty_compat_ioctl,
 510	.release	= tty_release,
 511	.fasync		= hung_up_tty_fasync,
 512};
 513
 514static DEFINE_SPINLOCK(redirect_lock);
 515static struct file *redirect;
 516
 517extern void tty_sysctl_init(void);
 518
 519/**
 520 *	tty_wakeup	-	request more data
 521 *	@tty: terminal
 522 *
 523 *	Internal and external helper for wakeups of tty. This function
 524 *	informs the line discipline if present that the driver is ready
 525 *	to receive more output data.
 526 */
 527
 528void tty_wakeup(struct tty_struct *tty)
 529{
 530	struct tty_ldisc *ld;
 531
 532	if (test_bit(TTY_DO_WRITE_WAKEUP, &tty->flags)) {
 533		ld = tty_ldisc_ref(tty);
 534		if (ld) {
 535			if (ld->ops->write_wakeup)
 536				ld->ops->write_wakeup(tty);
 537			tty_ldisc_deref(ld);
 538		}
 539	}
 540	wake_up_interruptible_poll(&tty->write_wait, EPOLLOUT);
 541}
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 542
 543EXPORT_SYMBOL_GPL(tty_wakeup);
 
 544
 545/**
 546 *	__tty_hangup		-	actual handler for hangup events
 547 *	@work: tty device
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 548 *
 549 *	This can be called by a "kworker" kernel thread.  That is process
 550 *	synchronous but doesn't hold any locks, so we need to make sure we
 551 *	have the appropriate locks for what we're doing.
 552 *
 553 *	The hangup event clears any pending redirections onto the hung up
 554 *	device. It ensures future writes will error and it does the needed
 555 *	line discipline hangup and signal delivery. The tty object itself
 556 *	remains intact.
 557 *
 558 *	Locking:
 559 *		BTM
 560 *		  redirect lock for undoing redirection
 561 *		  file list lock for manipulating list of ttys
 562 *		  tty_ldiscs_lock from called functions
 563 *		  termios_rwsem resetting termios data
 564 *		  tasklist_lock to walk task list for hangup event
 565 *		    ->siglock to protect ->signal/->sighand
 566 */
 567static void __tty_hangup(struct tty_struct *tty, int exit_session)
 568{
 569	struct file *cons_filp = NULL;
 570	struct file *filp, *f = NULL;
 571	struct tty_file_private *priv;
 572	int    closecount = 0, n;
 573	int refs;
 574
 575	if (!tty)
 576		return;
 577
 578
 579	spin_lock(&redirect_lock);
 580	if (redirect && file_tty(redirect) == tty) {
 581		f = redirect;
 582		redirect = NULL;
 583	}
 584	spin_unlock(&redirect_lock);
 585
 586	tty_lock(tty);
 587
 588	if (test_bit(TTY_HUPPED, &tty->flags)) {
 589		tty_unlock(tty);
 590		return;
 591	}
 592
 593	/*
 594	 * Some console devices aren't actually hung up for technical and
 595	 * historical reasons, which can lead to indefinite interruptible
 596	 * sleep in n_tty_read().  The following explicitly tells
 597	 * n_tty_read() to abort readers.
 598	 */
 599	set_bit(TTY_HUPPING, &tty->flags);
 600
 601	/* inuse_filps is protected by the single tty lock,
 602	   this really needs to change if we want to flush the
 603	   workqueue with the lock held */
 
 604	check_tty_count(tty, "tty_hangup");
 605
 606	spin_lock(&tty->files_lock);
 607	/* This breaks for file handles being sent over AF_UNIX sockets ? */
 608	list_for_each_entry(priv, &tty->tty_files, list) {
 609		filp = priv->file;
 610		if (filp->f_op->write == redirected_tty_write)
 611			cons_filp = filp;
 612		if (filp->f_op->write != tty_write)
 613			continue;
 614		closecount++;
 615		__tty_fasync(-1, filp, 0);	/* can't block */
 616		filp->f_op = &hung_up_tty_fops;
 617	}
 618	spin_unlock(&tty->files_lock);
 619
 620	refs = tty_signal_session_leader(tty, exit_session);
 621	/* Account for the p->signal references we killed */
 622	while (refs--)
 623		tty_kref_put(tty);
 624
 625	tty_ldisc_hangup(tty, cons_filp != NULL);
 626
 627	spin_lock_irq(&tty->ctrl_lock);
 628	clear_bit(TTY_THROTTLED, &tty->flags);
 629	clear_bit(TTY_DO_WRITE_WAKEUP, &tty->flags);
 630	put_pid(tty->session);
 631	put_pid(tty->pgrp);
 632	tty->session = NULL;
 633	tty->pgrp = NULL;
 634	tty->ctrl_status = 0;
 635	spin_unlock_irq(&tty->ctrl_lock);
 636
 637	/*
 638	 * If one of the devices matches a console pointer, we
 639	 * cannot just call hangup() because that will cause
 640	 * tty->count and state->count to go out of sync.
 641	 * So we just call close() the right number of times.
 642	 */
 643	if (cons_filp) {
 644		if (tty->ops->close)
 645			for (n = 0; n < closecount; n++)
 646				tty->ops->close(tty, cons_filp);
 647	} else if (tty->ops->hangup)
 648		tty->ops->hangup(tty);
 649	/*
 650	 * We don't want to have driver/ldisc interactions beyond the ones
 651	 * we did here. The driver layer expects no calls after ->hangup()
 652	 * from the ldisc side, which is now guaranteed.
 653	 */
 654	set_bit(TTY_HUPPED, &tty->flags);
 655	clear_bit(TTY_HUPPING, &tty->flags);
 656	tty_unlock(tty);
 657
 658	if (f)
 659		fput(f);
 660}
 661
 662static void do_tty_hangup(struct work_struct *work)
 663{
 664	struct tty_struct *tty =
 665		container_of(work, struct tty_struct, hangup_work);
 666
 667	__tty_hangup(tty, 0);
 668}
 669
 670/**
 671 *	tty_hangup		-	trigger a hangup event
 672 *	@tty: tty to hangup
 673 *
 674 *	A carrier loss (virtual or otherwise) has occurred on this like
 675 *	schedule a hangup sequence to run after this event.
 676 */
 677
 678void tty_hangup(struct tty_struct *tty)
 679{
 680	tty_debug_hangup(tty, "hangup\n");
 681	schedule_work(&tty->hangup_work);
 682}
 683
 684EXPORT_SYMBOL(tty_hangup);
 685
 686/**
 687 *	tty_vhangup		-	process vhangup
 688 *	@tty: tty to hangup
 689 *
 690 *	The user has asked via system call for the terminal to be hung up.
 691 *	We do this synchronously so that when the syscall returns the process
 692 *	is complete. That guarantee is necessary for security reasons.
 693 */
 694
 695void tty_vhangup(struct tty_struct *tty)
 696{
 697	tty_debug_hangup(tty, "vhangup\n");
 698	__tty_hangup(tty, 0);
 699}
 700
 701EXPORT_SYMBOL(tty_vhangup);
 702
 703
 704/**
 705 *	tty_vhangup_self	-	process vhangup for own ctty
 706 *
 707 *	Perform a vhangup on the current controlling tty
 708 */
 709
 710void tty_vhangup_self(void)
 711{
 712	struct tty_struct *tty;
 713
 714	tty = get_current_tty();
 715	if (tty) {
 716		tty_vhangup(tty);
 717		tty_kref_put(tty);
 718	}
 719}
 720
 721/**
 722 *	tty_vhangup_session		-	hangup session leader exit
 723 *	@tty: tty to hangup
 724 *
 725 *	The session leader is exiting and hanging up its controlling terminal.
 726 *	Every process in the foreground process group is signalled SIGHUP.
 727 *
 728 *	We do this synchronously so that when the syscall returns the process
 729 *	is complete. That guarantee is necessary for security reasons.
 730 */
 731
 732void tty_vhangup_session(struct tty_struct *tty)
 733{
 734	tty_debug_hangup(tty, "session hangup\n");
 735	__tty_hangup(tty, 1);
 736}
 737
 738/**
 739 *	tty_hung_up_p		-	was tty hung up
 740 *	@filp: file pointer of tty
 741 *
 742 *	Return true if the tty has been subject to a vhangup or a carrier
 743 *	loss
 744 */
 745
 746int tty_hung_up_p(struct file *filp)
 747{
 748	return (filp && filp->f_op == &hung_up_tty_fops);
 749}
 750
 751EXPORT_SYMBOL(tty_hung_up_p);
 752
 753/**
 754 *	stop_tty	-	propagate flow control
 755 *	@tty: tty to stop
 756 *
 757 *	Perform flow control to the driver. May be called
 758 *	on an already stopped device and will not re-call the driver
 759 *	method.
 760 *
 761 *	This functionality is used by both the line disciplines for
 762 *	halting incoming flow and by the driver. It may therefore be
 763 *	called from any context, may be under the tty atomic_write_lock
 764 *	but not always.
 765 *
 766 *	Locking:
 767 *		flow_lock
 768 */
 769
 770void __stop_tty(struct tty_struct *tty)
 771{
 772	if (tty->stopped)
 773		return;
 774	tty->stopped = 1;
 775	if (tty->ops->stop)
 776		tty->ops->stop(tty);
 777}
 778
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 779void stop_tty(struct tty_struct *tty)
 780{
 781	unsigned long flags;
 782
 783	spin_lock_irqsave(&tty->flow_lock, flags);
 784	__stop_tty(tty);
 785	spin_unlock_irqrestore(&tty->flow_lock, flags);
 786}
 787EXPORT_SYMBOL(stop_tty);
 788
 789/**
 790 *	start_tty	-	propagate flow control
 791 *	@tty: tty to start
 792 *
 793 *	Start a tty that has been stopped if at all possible. If this
 794 *	tty was previous stopped and is now being started, the driver
 795 *	start method is invoked and the line discipline woken.
 796 *
 797 *	Locking:
 798 *		flow_lock
 799 */
 800
 801void __start_tty(struct tty_struct *tty)
 802{
 803	if (!tty->stopped || tty->flow_stopped)
 804		return;
 805	tty->stopped = 0;
 806	if (tty->ops->start)
 807		tty->ops->start(tty);
 808	tty_wakeup(tty);
 809}
 810
 
 
 
 
 
 
 
 
 
 
 
 811void start_tty(struct tty_struct *tty)
 812{
 813	unsigned long flags;
 814
 815	spin_lock_irqsave(&tty->flow_lock, flags);
 816	__start_tty(tty);
 817	spin_unlock_irqrestore(&tty->flow_lock, flags);
 818}
 819EXPORT_SYMBOL(start_tty);
 820
 821static void tty_update_time(struct timespec64 *time)
 822{
 823	time64_t sec = ktime_get_real_seconds();
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 824
 825	/*
 826	 * We only care if the two values differ in anything other than the
 827	 * lower three bits (i.e every 8 seconds).  If so, then we can update
 828	 * the time of the tty device, otherwise it could be construded as a
 829	 * security leak to let userspace know the exact timing of the tty.
 830	 */
 831	if ((sec ^ time->tv_sec) & ~7)
 832		time->tv_sec = sec;
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 833}
 834
 
 835/**
 836 *	tty_read	-	read method for tty device files
 837 *	@file: pointer to tty file
 838 *	@buf: user buffer
 839 *	@count: size of user buffer
 840 *	@ppos: unused
 841 *
 842 *	Perform the read system call function on this terminal device. Checks
 843 *	for hung up devices before calling the line discipline method.
 844 *
 845 *	Locking:
 846 *		Locks the line discipline internally while needed. Multiple
 847 *	read calls may be outstanding in parallel.
 848 */
 849
 850static ssize_t tty_read(struct file *file, char __user *buf, size_t count,
 851			loff_t *ppos)
 852{
 853	int i;
 854	struct inode *inode = file_inode(file);
 855	struct tty_struct *tty = file_tty(file);
 856	struct tty_ldisc *ld;
 
 857
 858	if (tty_paranoia_check(tty, inode, "tty_read"))
 859		return -EIO;
 860	if (!tty || tty_io_error(tty))
 861		return -EIO;
 862
 863	/* We want to wait for the line discipline to sort out in this
 864	   situation */
 
 865	ld = tty_ldisc_ref_wait(tty);
 866	if (!ld)
 867		return hung_up_tty_read(file, buf, count, ppos);
 
 868	if (ld->ops->read)
 869		i = ld->ops->read(tty, file, buf, count);
 870	else
 871		i = -EIO;
 872	tty_ldisc_deref(ld);
 873
 874	if (i > 0)
 875		tty_update_time(&inode->i_atime);
 876
 877	return i;
 878}
 879
 880static void tty_write_unlock(struct tty_struct *tty)
 881{
 882	mutex_unlock(&tty->atomic_write_lock);
 883	wake_up_interruptible_poll(&tty->write_wait, EPOLLOUT);
 884}
 885
 886static int tty_write_lock(struct tty_struct *tty, int ndelay)
 887{
 888	if (!mutex_trylock(&tty->atomic_write_lock)) {
 889		if (ndelay)
 890			return -EAGAIN;
 891		if (mutex_lock_interruptible(&tty->atomic_write_lock))
 892			return -ERESTARTSYS;
 893	}
 894	return 0;
 895}
 896
 897/*
 898 * Split writes up in sane blocksizes to avoid
 899 * denial-of-service type attacks
 900 */
 901static inline ssize_t do_tty_write(
 902	ssize_t (*write)(struct tty_struct *, struct file *, const unsigned char *, size_t),
 903	struct tty_struct *tty,
 904	struct file *file,
 905	const char __user *buf,
 906	size_t count)
 907{
 
 908	ssize_t ret, written = 0;
 909	unsigned int chunk;
 910
 911	ret = tty_write_lock(tty, file->f_flags & O_NDELAY);
 912	if (ret < 0)
 913		return ret;
 914
 915	/*
 916	 * We chunk up writes into a temporary buffer. This
 917	 * simplifies low-level drivers immensely, since they
 918	 * don't have locking issues and user mode accesses.
 919	 *
 920	 * But if TTY_NO_WRITE_SPLIT is set, we should use a
 921	 * big chunk-size..
 922	 *
 923	 * The default chunk-size is 2kB, because the NTTY
 924	 * layer has problems with bigger chunks. It will
 925	 * claim to be able to handle more characters than
 926	 * it actually does.
 927	 *
 928	 * FIXME: This can probably go away now except that 64K chunks
 929	 * are too likely to fail unless switched to vmalloc...
 930	 */
 931	chunk = 2048;
 932	if (test_bit(TTY_NO_WRITE_SPLIT, &tty->flags))
 933		chunk = 65536;
 934	if (count < chunk)
 935		chunk = count;
 936
 937	/* write_buf/write_cnt is protected by the atomic_write_lock mutex */
 938	if (tty->write_cnt < chunk) {
 939		unsigned char *buf_chunk;
 940
 941		if (chunk < 1024)
 942			chunk = 1024;
 943
 944		buf_chunk = kmalloc(chunk, GFP_KERNEL);
 945		if (!buf_chunk) {
 946			ret = -ENOMEM;
 947			goto out;
 948		}
 949		kfree(tty->write_buf);
 950		tty->write_cnt = chunk;
 951		tty->write_buf = buf_chunk;
 952	}
 953
 954	/* Do the write .. */
 955	for (;;) {
 956		size_t size = count;
 957		if (size > chunk)
 958			size = chunk;
 959		ret = -EFAULT;
 960		if (copy_from_user(tty->write_buf, buf, size))
 961			break;
 962		ret = write(tty, file, tty->write_buf, size);
 
 963		if (ret <= 0)
 964			break;
 
 965		written += ret;
 966		buf += ret;
 
 
 
 
 
 
 967		count -= ret;
 968		if (!count)
 969			break;
 970		ret = -ERESTARTSYS;
 971		if (signal_pending(current))
 972			break;
 973		cond_resched();
 974	}
 975	if (written) {
 976		tty_update_time(&file_inode(file)->i_mtime);
 977		ret = written;
 978	}
 979out:
 980	tty_write_unlock(tty);
 981	return ret;
 982}
 983
 
 984/**
 985 * tty_write_message - write a message to a certain tty, not just the console.
 986 * @tty: the destination tty_struct
 987 * @msg: the message to write
 988 *
 989 * This is used for messages that need to be redirected to a specific tty.
 990 * We don't put it into the syslog queue right now maybe in the future if
 991 * really needed.
 992 *
 993 * We must still hold the BTM and test the CLOSING flag for the moment.
 
 
 994 */
 995
 996void tty_write_message(struct tty_struct *tty, char *msg)
 997{
 998	if (tty) {
 999		mutex_lock(&tty->atomic_write_lock);
1000		tty_lock(tty);
1001		if (tty->ops->write && tty->count > 0)
1002			tty->ops->write(tty, msg, strlen(msg));
1003		tty_unlock(tty);
1004		tty_write_unlock(tty);
1005	}
1006	return;
1007}
 
1008
1009
1010/**
1011 *	tty_write		-	write method for tty device file
1012 *	@file: tty file pointer
1013 *	@buf: user data to write
1014 *	@count: bytes to write
1015 *	@ppos: unused
1016 *
1017 *	Write data to a tty device via the line discipline.
1018 *
1019 *	Locking:
1020 *		Locks the line discipline as required
1021 *		Writes to the tty driver are serialized by the atomic_write_lock
1022 *	and are then processed in chunks to the device. The line discipline
1023 *	write method will not be invoked in parallel for each device.
1024 */
1025
1026static ssize_t tty_write(struct file *file, const char __user *buf,
1027						size_t count, loff_t *ppos)
1028{
1029	struct tty_struct *tty = file_tty(file);
1030 	struct tty_ldisc *ld;
1031	ssize_t ret;
1032
1033	if (tty_paranoia_check(tty, file_inode(file), "tty_write"))
1034		return -EIO;
1035	if (!tty || !tty->ops->write ||	tty_io_error(tty))
1036			return -EIO;
1037	/* Short term debug to catch buggy drivers */
1038	if (tty->ops->write_room == NULL)
1039		tty_err(tty, "missing write_room method\n");
1040	ld = tty_ldisc_ref_wait(tty);
1041	if (!ld)
1042		return hung_up_tty_write(file, buf, count, ppos);
1043	if (!ld->ops->write)
1044		ret = -EIO;
1045	else
1046		ret = do_tty_write(ld->ops->write, tty, file, buf, count);
1047	tty_ldisc_deref(ld);
1048	return ret;
1049}
1050
1051ssize_t redirected_tty_write(struct file *file, const char __user *buf,
1052						size_t count, loff_t *ppos)
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1053{
1054	struct file *p = NULL;
1055
1056	spin_lock(&redirect_lock);
1057	if (redirect)
1058		p = get_file(redirect);
1059	spin_unlock(&redirect_lock);
1060
 
 
 
 
1061	if (p) {
1062		ssize_t res;
1063		res = vfs_write(p, buf, count, &p->f_pos);
 
1064		fput(p);
1065		return res;
1066	}
1067	return tty_write(file, buf, count, ppos);
1068}
1069
1070/**
1071 *	tty_send_xchar	-	send priority character
 
 
1072 *
1073 *	Send a high priority character to the tty even if stopped
1074 *
1075 *	Locking: none for xchar method, write ordering for write method.
1076 */
1077
1078int tty_send_xchar(struct tty_struct *tty, char ch)
1079{
1080	int	was_stopped = tty->stopped;
1081
1082	if (tty->ops->send_xchar) {
1083		down_read(&tty->termios_rwsem);
1084		tty->ops->send_xchar(tty, ch);
1085		up_read(&tty->termios_rwsem);
1086		return 0;
1087	}
1088
1089	if (tty_write_lock(tty, 0) < 0)
1090		return -ERESTARTSYS;
1091
1092	down_read(&tty->termios_rwsem);
1093	if (was_stopped)
1094		start_tty(tty);
1095	tty->ops->write(tty, &ch, 1);
1096	if (was_stopped)
1097		stop_tty(tty);
1098	up_read(&tty->termios_rwsem);
1099	tty_write_unlock(tty);
1100	return 0;
1101}
1102
1103static char ptychar[] = "pqrstuvwxyzabcde";
1104
1105/**
1106 *	pty_line_name	-	generate name for a pty
1107 *	@driver: the tty driver in use
1108 *	@index: the minor number
1109 *	@p: output buffer of at least 6 bytes
1110 *
1111 *	Generate a name from a driver reference and write it to the output
1112 *	buffer.
1113 *
1114 *	Locking: None
1115 */
1116static void pty_line_name(struct tty_driver *driver, int index, char *p)
1117{
 
1118	int i = index + driver->name_base;
1119	/* ->name is initialized to "ttyp", but "tty" is expected */
1120	sprintf(p, "%s%c%x",
1121		driver->subtype == PTY_TYPE_SLAVE ? "tty" : driver->name,
1122		ptychar[i >> 4 & 0xf], i & 0xf);
1123}
1124
1125/**
1126 *	tty_line_name	-	generate name for a tty
1127 *	@driver: the tty driver in use
1128 *	@index: the minor number
1129 *	@p: output buffer of at least 7 bytes
1130 *
1131 *	Generate a name from a driver reference and write it to the output
1132 *	buffer.
1133 *
1134 *	Locking: None
1135 */
1136static ssize_t tty_line_name(struct tty_driver *driver, int index, char *p)
1137{
1138	if (driver->flags & TTY_DRIVER_UNNUMBERED_NODE)
1139		return sprintf(p, "%s", driver->name);
1140	else
1141		return sprintf(p, "%s%d", driver->name,
1142			       index + driver->name_base);
1143}
1144
1145/**
1146 *	tty_driver_lookup_tty() - find an existing tty, if any
1147 *	@driver: the driver for the tty
1148 *	@idx:	 the minor number
 
1149 *
1150 *	Return the tty, if found. If not found, return NULL or ERR_PTR() if the
1151 *	driver lookup() method returns an error.
1152 *
1153 *	Locking: tty_mutex must be held. If the tty is found, bump the tty kref.
1154 */
1155static struct tty_struct *tty_driver_lookup_tty(struct tty_driver *driver,
1156		struct file *file, int idx)
1157{
1158	struct tty_struct *tty;
1159
1160	if (driver->ops->lookup)
1161		if (!file)
1162			tty = ERR_PTR(-EIO);
1163		else
1164			tty = driver->ops->lookup(driver, file, idx);
1165	else
 
 
1166		tty = driver->ttys[idx];
1167
1168	if (!IS_ERR(tty))
1169		tty_kref_get(tty);
1170	return tty;
1171}
1172
1173/**
1174 *	tty_init_termios	-  helper for termios setup
1175 *	@tty: the tty to set up
1176 *
1177 *	Initialise the termios structure for this tty. This runs under
1178 *	the tty_mutex currently so we can be relaxed about ordering.
1179 */
1180
1181void tty_init_termios(struct tty_struct *tty)
1182{
1183	struct ktermios *tp;
1184	int idx = tty->index;
1185
1186	if (tty->driver->flags & TTY_DRIVER_RESET_TERMIOS)
1187		tty->termios = tty->driver->init_termios;
1188	else {
1189		/* Check for lazy saved data */
1190		tp = tty->driver->termios[idx];
1191		if (tp != NULL) {
1192			tty->termios = *tp;
1193			tty->termios.c_line  = tty->driver->init_termios.c_line;
1194		} else
1195			tty->termios = tty->driver->init_termios;
1196	}
1197	/* Compatibility until drivers always set this */
1198	tty->termios.c_ispeed = tty_termios_input_baud_rate(&tty->termios);
1199	tty->termios.c_ospeed = tty_termios_baud_rate(&tty->termios);
1200}
1201EXPORT_SYMBOL_GPL(tty_init_termios);
1202
 
 
 
 
 
 
 
 
1203int tty_standard_install(struct tty_driver *driver, struct tty_struct *tty)
1204{
1205	tty_init_termios(tty);
1206	tty_driver_kref_get(driver);
1207	tty->count++;
1208	driver->ttys[tty->index] = tty;
1209	return 0;
1210}
1211EXPORT_SYMBOL_GPL(tty_standard_install);
1212
1213/**
1214 *	tty_driver_install_tty() - install a tty entry in the driver
1215 *	@driver: the driver for the tty
1216 *	@tty: the tty
1217 *
1218 *	Install a tty object into the driver tables. The tty->index field
1219 *	will be set by the time this is called. This method is responsible
1220 *	for ensuring any need additional structures are allocated and
1221 *	configured.
1222 *
1223 *	Locking: tty_mutex for now
1224 */
1225static int tty_driver_install_tty(struct tty_driver *driver,
1226						struct tty_struct *tty)
1227{
1228	return driver->ops->install ? driver->ops->install(driver, tty) :
1229		tty_standard_install(driver, tty);
1230}
1231
1232/**
1233 *	tty_driver_remove_tty() - remove a tty from the driver tables
1234 *	@driver: the driver for the tty
1235 *	@idx:	 the minor number
1236 *
1237 *	Remvoe a tty object from the driver tables. The tty->index field
1238 *	will be set by the time this is called.
1239 *
1240 *	Locking: tty_mutex for now
1241 */
1242static void tty_driver_remove_tty(struct tty_driver *driver, struct tty_struct *tty)
1243{
1244	if (driver->ops->remove)
1245		driver->ops->remove(driver, tty);
1246	else
1247		driver->ttys[tty->index] = NULL;
1248}
1249
1250/*
1251 * 	tty_reopen()	- fast re-open of an open tty
1252 * 	@tty	- the tty to open
1253 *
1254 *	Return 0 on success, -errno on error.
1255 *	Re-opens on master ptys are not allowed and return -EIO.
1256 *
1257 *	Locking: Caller must hold tty_lock
 
1258 */
1259static int tty_reopen(struct tty_struct *tty)
1260{
1261	struct tty_driver *driver = tty->driver;
1262	struct tty_ldisc *ld;
1263	int retval = 0;
1264
1265	if (driver->type == TTY_DRIVER_TYPE_PTY &&
1266	    driver->subtype == PTY_TYPE_MASTER)
1267		return -EIO;
1268
1269	if (!tty->count)
1270		return -EAGAIN;
1271
1272	if (test_bit(TTY_EXCLUSIVE, &tty->flags) && !capable(CAP_SYS_ADMIN))
1273		return -EBUSY;
1274
1275	ld = tty_ldisc_ref_wait(tty);
1276	if (ld) {
1277		tty_ldisc_deref(ld);
1278	} else {
1279		retval = tty_ldisc_lock(tty, 5 * HZ);
1280		if (retval)
1281			return retval;
1282
1283		if (!tty->ldisc)
1284			retval = tty_ldisc_reinit(tty, tty->termios.c_line);
1285		tty_ldisc_unlock(tty);
1286	}
1287
1288	if (retval == 0)
1289		tty->count++;
1290
1291	return retval;
1292}
1293
1294/**
1295 *	tty_init_dev		-	initialise a tty device
1296 *	@driver: tty driver we are opening a device on
1297 *	@idx: device index
1298 *	@ret_tty: returned tty structure
1299 *
1300 *	Prepare a tty device. This may not be a "new" clean device but
1301 *	could also be an active device. The pty drivers require special
1302 *	handling because of this.
1303 *
1304 *	Locking:
1305 *		The function is called under the tty_mutex, which
1306 *	protects us from the tty struct or driver itself going away.
1307 *
1308 *	On exit the tty device has the line discipline attached and
1309 *	a reference count of 1. If a pair was created for pty/tty use
1310 *	and the other was a pty master then it too has a reference count of 1.
1311 *
1312 * WSH 06/09/97: Rewritten to remove races and properly clean up after a
1313 * failed open.  The new code protects the open with a mutex, so it's
1314 * really quite straightforward.  The mutex locking can probably be
1315 * relaxed for the (most common) case of reopening a tty.
1316 */
1317
1318struct tty_struct *tty_init_dev(struct tty_driver *driver, int idx)
1319{
1320	struct tty_struct *tty;
1321	int retval;
1322
1323	/*
1324	 * First time open is complex, especially for PTY devices.
1325	 * This code guarantees that either everything succeeds and the
1326	 * TTY is ready for operation, or else the table slots are vacated
1327	 * and the allocated memory released.  (Except that the termios
1328	 * may be retained.)
1329	 */
1330
1331	if (!try_module_get(driver->owner))
1332		return ERR_PTR(-ENODEV);
1333
1334	tty = alloc_tty_struct(driver, idx);
1335	if (!tty) {
1336		retval = -ENOMEM;
1337		goto err_module_put;
1338	}
1339
1340	tty_lock(tty);
1341	retval = tty_driver_install_tty(driver, tty);
1342	if (retval < 0)
1343		goto err_free_tty;
1344
1345	if (!tty->port)
1346		tty->port = driver->ports[idx];
1347
1348	if (WARN_RATELIMIT(!tty->port,
1349			"%s: %s driver does not set tty->port. This would crash the kernel. Fix the driver!\n",
1350			__func__, tty->driver->name)) {
1351		retval = -EINVAL;
1352		goto err_release_lock;
1353	}
1354
1355	retval = tty_ldisc_lock(tty, 5 * HZ);
1356	if (retval)
1357		goto err_release_lock;
1358	tty->port->itty = tty;
1359
1360	/*
1361	 * Structures all installed ... call the ldisc open routines.
1362	 * If we fail here just call release_tty to clean up.  No need
1363	 * to decrement the use counts, as release_tty doesn't care.
1364	 */
1365	retval = tty_ldisc_setup(tty, tty->link);
1366	if (retval)
1367		goto err_release_tty;
1368	tty_ldisc_unlock(tty);
1369	/* Return the tty locked so that it cannot vanish under the caller */
1370	return tty;
1371
1372err_free_tty:
1373	tty_unlock(tty);
1374	free_tty_struct(tty);
1375err_module_put:
1376	module_put(driver->owner);
1377	return ERR_PTR(retval);
1378
1379	/* call the tty release_tty routine to clean out this slot */
1380err_release_tty:
1381	tty_ldisc_unlock(tty);
1382	tty_info_ratelimited(tty, "ldisc open failed (%d), clearing slot %d\n",
1383			     retval, idx);
1384err_release_lock:
1385	tty_unlock(tty);
1386	release_tty(tty, idx);
1387	return ERR_PTR(retval);
1388}
1389
1390/**
1391 * tty_save_termios() - save tty termios data in driver table
1392 * @tty: tty whose termios data to save
1393 *
1394 * Locking: Caller guarantees serialisation with tty_init_termios().
1395 */
1396void tty_save_termios(struct tty_struct *tty)
1397{
1398	struct ktermios *tp;
1399	int idx = tty->index;
1400
1401	/* If the port is going to reset then it has no termios to save */
1402	if (tty->driver->flags & TTY_DRIVER_RESET_TERMIOS)
1403		return;
1404
1405	/* Stash the termios data */
1406	tp = tty->driver->termios[idx];
1407	if (tp == NULL) {
1408		tp = kmalloc(sizeof(*tp), GFP_KERNEL);
1409		if (tp == NULL)
1410			return;
1411		tty->driver->termios[idx] = tp;
1412	}
1413	*tp = tty->termios;
1414}
1415EXPORT_SYMBOL_GPL(tty_save_termios);
1416
1417/**
1418 *	tty_flush_works		-	flush all works of a tty/pty pair
1419 *	@tty: tty device to flush works for (or either end of a pty pair)
1420 *
1421 *	Sync flush all works belonging to @tty (and the 'other' tty).
1422 */
1423static void tty_flush_works(struct tty_struct *tty)
1424{
1425	flush_work(&tty->SAK_work);
1426	flush_work(&tty->hangup_work);
1427	if (tty->link) {
1428		flush_work(&tty->link->SAK_work);
1429		flush_work(&tty->link->hangup_work);
1430	}
1431}
1432
1433/**
1434 *	release_one_tty		-	release tty structure memory
1435 *	@kref: kref of tty we are obliterating
1436 *
1437 *	Releases memory associated with a tty structure, and clears out the
1438 *	driver table slots. This function is called when a device is no longer
1439 *	in use. It also gets called when setup of a device fails.
1440 *
1441 *	Locking:
1442 *		takes the file list lock internally when working on the list
1443 *	of ttys that the driver keeps.
1444 *
1445 *	This method gets called from a work queue so that the driver private
1446 *	cleanup ops can sleep (needed for USB at least)
1447 */
1448static void release_one_tty(struct work_struct *work)
1449{
1450	struct tty_struct *tty =
1451		container_of(work, struct tty_struct, hangup_work);
1452	struct tty_driver *driver = tty->driver;
1453	struct module *owner = driver->owner;
1454
1455	if (tty->ops->cleanup)
1456		tty->ops->cleanup(tty);
1457
1458	tty->magic = 0;
1459	tty_driver_kref_put(driver);
1460	module_put(owner);
1461
1462	spin_lock(&tty->files_lock);
1463	list_del_init(&tty->tty_files);
1464	spin_unlock(&tty->files_lock);
1465
1466	put_pid(tty->pgrp);
1467	put_pid(tty->session);
1468	free_tty_struct(tty);
1469}
1470
1471static void queue_release_one_tty(struct kref *kref)
1472{
1473	struct tty_struct *tty = container_of(kref, struct tty_struct, kref);
1474
1475	/* The hangup queue is now free so we can reuse it rather than
1476	   waste a chunk of memory for each port */
 
1477	INIT_WORK(&tty->hangup_work, release_one_tty);
1478	schedule_work(&tty->hangup_work);
1479}
1480
1481/**
1482 *	tty_kref_put		-	release a tty kref
1483 *	@tty: tty device
1484 *
1485 *	Release a reference to a tty device and if need be let the kref
1486 *	layer destruct the object for us
1487 */
1488
1489void tty_kref_put(struct tty_struct *tty)
1490{
1491	if (tty)
1492		kref_put(&tty->kref, queue_release_one_tty);
1493}
1494EXPORT_SYMBOL(tty_kref_put);
1495
1496/**
1497 *	release_tty		-	release tty structure memory
 
 
1498 *
1499 *	Release both @tty and a possible linked partner (think pty pair),
1500 *	and decrement the refcount of the backing module.
1501 *
1502 *	Locking:
1503 *		tty_mutex
1504 *		takes the file list lock internally when working on the list
1505 *	of ttys that the driver keeps.
1506 *
 
 
 
 
1507 */
1508static void release_tty(struct tty_struct *tty, int idx)
1509{
1510	/* This should always be true but check for the moment */
1511	WARN_ON(tty->index != idx);
1512	WARN_ON(!mutex_is_locked(&tty_mutex));
1513	if (tty->ops->shutdown)
1514		tty->ops->shutdown(tty);
1515	tty_save_termios(tty);
1516	tty_driver_remove_tty(tty->driver, tty);
1517	tty->port->itty = NULL;
 
1518	if (tty->link)
1519		tty->link->port->itty = NULL;
1520	tty_buffer_cancel_work(tty->port);
 
1521	if (tty->link)
1522		tty_buffer_cancel_work(tty->link->port);
1523
1524	tty_kref_put(tty->link);
1525	tty_kref_put(tty);
1526}
1527
1528/**
1529 *	tty_release_checks - check a tty before real release
1530 *	@tty: tty to check
1531 *	@o_tty: link of @tty (if any)
1532 *	@idx: index of the tty
1533 *
1534 *	Performs some paranoid checking before true release of the @tty.
1535 *	This is a no-op unless TTY_PARANOIA_CHECK is defined.
1536 */
1537static int tty_release_checks(struct tty_struct *tty, int idx)
1538{
1539#ifdef TTY_PARANOIA_CHECK
1540	if (idx < 0 || idx >= tty->driver->num) {
1541		tty_debug(tty, "bad idx %d\n", idx);
1542		return -1;
1543	}
1544
1545	/* not much to check for devpts */
1546	if (tty->driver->flags & TTY_DRIVER_DEVPTS_MEM)
1547		return 0;
1548
1549	if (tty != tty->driver->ttys[idx]) {
1550		tty_debug(tty, "bad driver table[%d] = %p\n",
1551			  idx, tty->driver->ttys[idx]);
1552		return -1;
1553	}
1554	if (tty->driver->other) {
1555		struct tty_struct *o_tty = tty->link;
1556
1557		if (o_tty != tty->driver->other->ttys[idx]) {
1558			tty_debug(tty, "bad other table[%d] = %p\n",
1559				  idx, tty->driver->other->ttys[idx]);
1560			return -1;
1561		}
1562		if (o_tty->link != tty) {
1563			tty_debug(tty, "bad link = %p\n", o_tty->link);
1564			return -1;
1565		}
1566	}
1567#endif
1568	return 0;
1569}
1570
1571/**
1572 *      tty_kclose      -       closes tty opened by tty_kopen
1573 *      @tty: tty device
1574 *
1575 *      Performs the final steps to release and free a tty device. It is the
1576 *      same as tty_release_struct except that it also resets TTY_PORT_KOPENED
1577 *      flag on tty->port.
1578 */
1579void tty_kclose(struct tty_struct *tty)
1580{
1581	/*
1582	 * Ask the line discipline code to release its structures
1583	 */
1584	tty_ldisc_release(tty);
1585
1586	/* Wait for pending work before tty destruction commmences */
1587	tty_flush_works(tty);
1588
1589	tty_debug_hangup(tty, "freeing structure\n");
1590	/*
1591	 * The release_tty function takes care of the details of clearing
1592	 * the slots and preserving the termios structure.
1593	 */
1594	mutex_lock(&tty_mutex);
1595	tty_port_set_kopened(tty->port, 0);
1596	release_tty(tty, tty->index);
1597	mutex_unlock(&tty_mutex);
1598}
1599EXPORT_SYMBOL_GPL(tty_kclose);
1600
1601/**
1602 *	tty_release_struct	-	release a tty struct
1603 *	@tty: tty device
1604 *	@idx: index of the tty
1605 *
1606 *	Performs the final steps to release and free a tty device. It is
1607 *	roughly the reverse of tty_init_dev.
1608 */
1609void tty_release_struct(struct tty_struct *tty, int idx)
1610{
1611	/*
1612	 * Ask the line discipline code to release its structures
1613	 */
1614	tty_ldisc_release(tty);
1615
1616	/* Wait for pending work before tty destruction commmences */
1617	tty_flush_works(tty);
1618
1619	tty_debug_hangup(tty, "freeing structure\n");
1620	/*
1621	 * The release_tty function takes care of the details of clearing
1622	 * the slots and preserving the termios structure.
1623	 */
1624	mutex_lock(&tty_mutex);
1625	release_tty(tty, idx);
1626	mutex_unlock(&tty_mutex);
1627}
1628EXPORT_SYMBOL_GPL(tty_release_struct);
1629
1630/**
1631 *	tty_release		-	vfs callback for close
1632 *	@inode: inode of tty
1633 *	@filp: file pointer for handle to tty
1634 *
1635 *	Called the last time each file handle is closed that references
1636 *	this tty. There may however be several such references.
1637 *
1638 *	Locking:
1639 *		Takes bkl. See tty_release_dev
1640 *
1641 * Even releasing the tty structures is a tricky business.. We have
1642 * to be very careful that the structures are all released at the
1643 * same time, as interrupts might otherwise get the wrong pointers.
1644 *
1645 * WSH 09/09/97: rewritten to avoid some nasty race conditions that could
1646 * lead to double frees or releasing memory still in use.
1647 */
1648
1649int tty_release(struct inode *inode, struct file *filp)
1650{
1651	struct tty_struct *tty = file_tty(filp);
1652	struct tty_struct *o_tty = NULL;
1653	int	do_sleep, final;
1654	int	idx;
1655	long	timeout = 0;
1656	int	once = 1;
1657
1658	if (tty_paranoia_check(tty, inode, __func__))
1659		return 0;
1660
1661	tty_lock(tty);
1662	check_tty_count(tty, __func__);
1663
1664	__tty_fasync(-1, filp, 0);
1665
1666	idx = tty->index;
1667	if (tty->driver->type == TTY_DRIVER_TYPE_PTY &&
1668	    tty->driver->subtype == PTY_TYPE_MASTER)
1669		o_tty = tty->link;
1670
1671	if (tty_release_checks(tty, idx)) {
1672		tty_unlock(tty);
1673		return 0;
1674	}
1675
1676	tty_debug_hangup(tty, "releasing (count=%d)\n", tty->count);
1677
1678	if (tty->ops->close)
1679		tty->ops->close(tty, filp);
1680
1681	/* If tty is pty master, lock the slave pty (stable lock order) */
1682	tty_lock_slave(o_tty);
1683
1684	/*
1685	 * Sanity check: if tty->count is going to zero, there shouldn't be
1686	 * any waiters on tty->read_wait or tty->write_wait.  We test the
1687	 * wait queues and kick everyone out _before_ actually starting to
1688	 * close.  This ensures that we won't block while releasing the tty
1689	 * structure.
1690	 *
1691	 * The test for the o_tty closing is necessary, since the master and
1692	 * slave sides may close in any order.  If the slave side closes out
1693	 * first, its count will be one, since the master side holds an open.
1694	 * Thus this test wouldn't be triggered at the time the slave closed,
1695	 * so we do it now.
1696	 */
1697	while (1) {
1698		do_sleep = 0;
1699
1700		if (tty->count <= 1) {
1701			if (waitqueue_active(&tty->read_wait)) {
1702				wake_up_poll(&tty->read_wait, EPOLLIN);
1703				do_sleep++;
1704			}
1705			if (waitqueue_active(&tty->write_wait)) {
1706				wake_up_poll(&tty->write_wait, EPOLLOUT);
1707				do_sleep++;
1708			}
1709		}
1710		if (o_tty && o_tty->count <= 1) {
1711			if (waitqueue_active(&o_tty->read_wait)) {
1712				wake_up_poll(&o_tty->read_wait, EPOLLIN);
1713				do_sleep++;
1714			}
1715			if (waitqueue_active(&o_tty->write_wait)) {
1716				wake_up_poll(&o_tty->write_wait, EPOLLOUT);
1717				do_sleep++;
1718			}
1719		}
1720		if (!do_sleep)
1721			break;
1722
1723		if (once) {
1724			once = 0;
1725			tty_warn(tty, "read/write wait queue active!\n");
1726		}
1727		schedule_timeout_killable(timeout);
1728		if (timeout < 120 * HZ)
1729			timeout = 2 * timeout + 1;
1730		else
1731			timeout = MAX_SCHEDULE_TIMEOUT;
1732	}
1733
1734	if (o_tty) {
1735		if (--o_tty->count < 0) {
1736			tty_warn(tty, "bad slave count (%d)\n", o_tty->count);
1737			o_tty->count = 0;
1738		}
1739	}
1740	if (--tty->count < 0) {
1741		tty_warn(tty, "bad tty->count (%d)\n", tty->count);
1742		tty->count = 0;
1743	}
1744
1745	/*
1746	 * We've decremented tty->count, so we need to remove this file
1747	 * descriptor off the tty->tty_files list; this serves two
1748	 * purposes:
1749	 *  - check_tty_count sees the correct number of file descriptors
1750	 *    associated with this tty.
1751	 *  - do_tty_hangup no longer sees this file descriptor as
1752	 *    something that needs to be handled for hangups.
1753	 */
1754	tty_del_file(filp);
1755
1756	/*
1757	 * Perform some housekeeping before deciding whether to return.
1758	 *
1759	 * If _either_ side is closing, make sure there aren't any
1760	 * processes that still think tty or o_tty is their controlling
1761	 * tty.
1762	 */
1763	if (!tty->count) {
1764		read_lock(&tasklist_lock);
1765		session_clear_tty(tty->session);
1766		if (o_tty)
1767			session_clear_tty(o_tty->session);
1768		read_unlock(&tasklist_lock);
1769	}
1770
1771	/* check whether both sides are closing ... */
1772	final = !tty->count && !(o_tty && o_tty->count);
1773
1774	tty_unlock_slave(o_tty);
1775	tty_unlock(tty);
1776
1777	/* At this point, the tty->count == 0 should ensure a dead tty
1778	   cannot be re-opened by a racing opener */
 
1779
1780	if (!final)
1781		return 0;
1782
1783	tty_debug_hangup(tty, "final close\n");
1784
1785	tty_release_struct(tty, idx);
1786	return 0;
1787}
1788
1789/**
1790 *	tty_open_current_tty - get locked tty of current task
1791 *	@device: device number
1792 *	@filp: file pointer to tty
1793 *	@return: locked tty of the current task iff @device is /dev/tty
1794 *
1795 *	Performs a re-open of the current task's controlling tty.
1796 *
1797 *	We cannot return driver and index like for the other nodes because
1798 *	devpts will not work then. It expects inodes to be from devpts FS.
1799 */
1800static struct tty_struct *tty_open_current_tty(dev_t device, struct file *filp)
1801{
1802	struct tty_struct *tty;
1803	int retval;
1804
1805	if (device != MKDEV(TTYAUX_MAJOR, 0))
1806		return NULL;
1807
1808	tty = get_current_tty();
1809	if (!tty)
1810		return ERR_PTR(-ENXIO);
1811
1812	filp->f_flags |= O_NONBLOCK; /* Don't let /dev/tty block */
1813	/* noctty = 1; */
1814	tty_lock(tty);
1815	tty_kref_put(tty);	/* safe to drop the kref now */
1816
1817	retval = tty_reopen(tty);
1818	if (retval < 0) {
1819		tty_unlock(tty);
1820		tty = ERR_PTR(retval);
1821	}
1822	return tty;
1823}
1824
1825/**
1826 *	tty_lookup_driver - lookup a tty driver for a given device file
1827 *	@device: device number
1828 *	@filp: file pointer to tty
1829 *	@index: index for the device in the @return driver
1830 *	@return: driver for this inode (with increased refcount)
 
 
1831 *
1832 * 	If @return is not erroneous, the caller is responsible to decrement the
1833 * 	refcount by tty_driver_kref_put.
1834 *
1835 *	Locking: tty_mutex protects get_tty_driver
1836 */
1837static struct tty_driver *tty_lookup_driver(dev_t device, struct file *filp,
1838		int *index)
1839{
1840	struct tty_driver *driver = NULL;
1841
1842	switch (device) {
1843#ifdef CONFIG_VT
1844	case MKDEV(TTY_MAJOR, 0): {
1845		extern struct tty_driver *console_driver;
 
1846		driver = tty_driver_kref_get(console_driver);
1847		*index = fg_console;
1848		break;
1849	}
1850#endif
1851	case MKDEV(TTYAUX_MAJOR, 1): {
1852		struct tty_driver *console_driver = console_device(index);
 
1853		if (console_driver) {
1854			driver = tty_driver_kref_get(console_driver);
1855			if (driver && filp) {
1856				/* Don't let /dev/console block */
1857				filp->f_flags |= O_NONBLOCK;
1858				break;
1859			}
1860		}
1861		if (driver)
1862			tty_driver_kref_put(driver);
1863		return ERR_PTR(-ENODEV);
1864	}
1865	default:
1866		driver = get_tty_driver(device, index);
1867		if (!driver)
1868			return ERR_PTR(-ENODEV);
1869		break;
1870	}
1871	return driver;
1872}
1873
1874/**
1875 *	tty_kopen	-	open a tty device for kernel
1876 *	@device: dev_t of device to open
1877 *
1878 *	Opens tty exclusively for kernel. Performs the driver lookup,
1879 *	makes sure it's not already opened and performs the first-time
1880 *	tty initialization.
1881 *
1882 *	Returns the locked initialized &tty_struct
1883 *
1884 *	Claims the global tty_mutex to serialize:
1885 *	  - concurrent first-time tty initialization
1886 *	  - concurrent tty driver removal w/ lookup
1887 *	  - concurrent tty removal from driver table
1888 */
1889struct tty_struct *tty_kopen(dev_t device)
1890{
1891	struct tty_struct *tty;
1892	struct tty_driver *driver;
1893	int index = -1;
1894
1895	mutex_lock(&tty_mutex);
1896	driver = tty_lookup_driver(device, NULL, &index);
1897	if (IS_ERR(driver)) {
1898		mutex_unlock(&tty_mutex);
1899		return ERR_CAST(driver);
1900	}
1901
1902	/* check whether we're reopening an existing tty */
1903	tty = tty_driver_lookup_tty(driver, NULL, index);
1904	if (IS_ERR(tty))
1905		goto out;
1906
1907	if (tty) {
1908		/* drop kref from tty_driver_lookup_tty() */
1909		tty_kref_put(tty);
1910		tty = ERR_PTR(-EBUSY);
1911	} else { /* tty_init_dev returns tty with the tty_lock held */
1912		tty = tty_init_dev(driver, index);
1913		if (IS_ERR(tty))
1914			goto out;
1915		tty_port_set_kopened(tty->port, 1);
1916	}
1917out:
1918	mutex_unlock(&tty_mutex);
1919	tty_driver_kref_put(driver);
1920	return tty;
1921}
1922EXPORT_SYMBOL_GPL(tty_kopen);
1923
1924/**
1925 *	tty_open_by_driver	-	open a tty device
1926 *	@device: dev_t of device to open
1927 *	@filp: file pointer to tty
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1928 *
1929 *	Performs the driver lookup, checks for a reopen, or otherwise
1930 *	performs the first-time tty initialization.
1931 *
1932 *	Returns the locked initialized or re-opened &tty_struct
 
 
 
1933 *
1934 *	Claims the global tty_mutex to serialize:
1935 *	  - concurrent first-time tty initialization
1936 *	  - concurrent tty driver removal w/ lookup
1937 *	  - concurrent tty removal from driver table
1938 */
1939static struct tty_struct *tty_open_by_driver(dev_t device,
1940					     struct file *filp)
1941{
1942	struct tty_struct *tty;
1943	struct tty_driver *driver = NULL;
1944	int index = -1;
1945	int retval;
1946
1947	mutex_lock(&tty_mutex);
1948	driver = tty_lookup_driver(device, filp, &index);
1949	if (IS_ERR(driver)) {
1950		mutex_unlock(&tty_mutex);
1951		return ERR_CAST(driver);
1952	}
1953
1954	/* check whether we're reopening an existing tty */
1955	tty = tty_driver_lookup_tty(driver, filp, index);
1956	if (IS_ERR(tty)) {
1957		mutex_unlock(&tty_mutex);
1958		goto out;
1959	}
1960
1961	if (tty) {
1962		if (tty_port_kopened(tty->port)) {
1963			tty_kref_put(tty);
1964			mutex_unlock(&tty_mutex);
1965			tty = ERR_PTR(-EBUSY);
1966			goto out;
1967		}
1968		mutex_unlock(&tty_mutex);
1969		retval = tty_lock_interruptible(tty);
1970		tty_kref_put(tty);  /* drop kref from tty_driver_lookup_tty() */
1971		if (retval) {
1972			if (retval == -EINTR)
1973				retval = -ERESTARTSYS;
1974			tty = ERR_PTR(retval);
1975			goto out;
1976		}
1977		retval = tty_reopen(tty);
1978		if (retval < 0) {
1979			tty_unlock(tty);
1980			tty = ERR_PTR(retval);
1981		}
1982	} else { /* Returns with the tty_lock held for now */
1983		tty = tty_init_dev(driver, index);
1984		mutex_unlock(&tty_mutex);
1985	}
1986out:
1987	tty_driver_kref_put(driver);
1988	return tty;
1989}
1990
1991/**
1992 *	tty_open		-	open a tty device
1993 *	@inode: inode of device file
1994 *	@filp: file pointer to tty
1995 *
1996 *	tty_open and tty_release keep up the tty count that contains the
1997 *	number of opens done on a tty. We cannot use the inode-count, as
1998 *	different inodes might point to the same tty.
1999 *
2000 *	Open-counting is needed for pty masters, as well as for keeping
2001 *	track of serial lines: DTR is dropped when the last close happens.
2002 *	(This is not done solely through tty->count, now.  - Ted 1/27/92)
2003 *
2004 *	The termios state of a pty is reset on first open so that
2005 *	settings don't persist across reuse.
2006 *
2007 *	Locking: tty_mutex protects tty, tty_lookup_driver and tty_init_dev.
2008 *		 tty->count should protect the rest.
2009 *		 ->siglock protects ->signal/->sighand
 
2010 *
2011 *	Note: the tty_unlock/lock cases without a ref are only safe due to
2012 *	tty_mutex
2013 */
2014
2015static int tty_open(struct inode *inode, struct file *filp)
2016{
2017	struct tty_struct *tty;
2018	int noctty, retval;
2019	dev_t device = inode->i_rdev;
2020	unsigned saved_flags = filp->f_flags;
2021
2022	nonseekable_open(inode, filp);
2023
2024retry_open:
2025	retval = tty_alloc_file(filp);
2026	if (retval)
2027		return -ENOMEM;
2028
2029	tty = tty_open_current_tty(device, filp);
2030	if (!tty)
2031		tty = tty_open_by_driver(device, filp);
2032
2033	if (IS_ERR(tty)) {
2034		tty_free_file(filp);
2035		retval = PTR_ERR(tty);
2036		if (retval != -EAGAIN || signal_pending(current))
2037			return retval;
2038		schedule();
2039		goto retry_open;
2040	}
2041
2042	tty_add_file(tty, filp);
2043
2044	check_tty_count(tty, __func__);
2045	tty_debug_hangup(tty, "opening (count=%d)\n", tty->count);
2046
2047	if (tty->ops->open)
2048		retval = tty->ops->open(tty, filp);
2049	else
2050		retval = -ENODEV;
2051	filp->f_flags = saved_flags;
2052
2053	if (retval) {
2054		tty_debug_hangup(tty, "open error %d, releasing\n", retval);
2055
2056		tty_unlock(tty); /* need to call tty_release without BTM */
2057		tty_release(inode, filp);
2058		if (retval != -ERESTARTSYS)
2059			return retval;
2060
2061		if (signal_pending(current))
2062			return retval;
2063
2064		schedule();
2065		/*
2066		 * Need to reset f_op in case a hangup happened.
2067		 */
2068		if (tty_hung_up_p(filp))
2069			filp->f_op = &tty_fops;
2070		goto retry_open;
2071	}
2072	clear_bit(TTY_HUPPED, &tty->flags);
2073
2074	noctty = (filp->f_flags & O_NOCTTY) ||
2075		 (IS_ENABLED(CONFIG_VT) && device == MKDEV(TTY_MAJOR, 0)) ||
2076		 device == MKDEV(TTYAUX_MAJOR, 1) ||
2077		 (tty->driver->type == TTY_DRIVER_TYPE_PTY &&
2078		  tty->driver->subtype == PTY_TYPE_MASTER);
2079	if (!noctty)
2080		tty_open_proc_set_tty(filp, tty);
2081	tty_unlock(tty);
2082	return 0;
2083}
2084
2085
2086
2087/**
2088 *	tty_poll	-	check tty status
2089 *	@filp: file being polled
2090 *	@wait: poll wait structures to update
2091 *
2092 *	Call the line discipline polling method to obtain the poll
2093 *	status of the device.
2094 *
2095 *	Locking: locks called line discipline but ldisc poll method
2096 *	may be re-entered freely by other callers.
2097 */
2098
2099static __poll_t tty_poll(struct file *filp, poll_table *wait)
2100{
2101	struct tty_struct *tty = file_tty(filp);
2102	struct tty_ldisc *ld;
2103	__poll_t ret = 0;
2104
2105	if (tty_paranoia_check(tty, file_inode(filp), "tty_poll"))
2106		return 0;
2107
2108	ld = tty_ldisc_ref_wait(tty);
2109	if (!ld)
2110		return hung_up_tty_poll(filp, wait);
2111	if (ld->ops->poll)
2112		ret = ld->ops->poll(tty, filp, wait);
2113	tty_ldisc_deref(ld);
2114	return ret;
2115}
2116
2117static int __tty_fasync(int fd, struct file *filp, int on)
2118{
2119	struct tty_struct *tty = file_tty(filp);
2120	unsigned long flags;
2121	int retval = 0;
2122
2123	if (tty_paranoia_check(tty, file_inode(filp), "tty_fasync"))
2124		goto out;
2125
2126	retval = fasync_helper(fd, filp, on, &tty->fasync);
2127	if (retval <= 0)
2128		goto out;
2129
2130	if (on) {
2131		enum pid_type type;
2132		struct pid *pid;
2133
2134		spin_lock_irqsave(&tty->ctrl_lock, flags);
2135		if (tty->pgrp) {
2136			pid = tty->pgrp;
2137			type = PIDTYPE_PGID;
2138		} else {
2139			pid = task_pid(current);
2140			type = PIDTYPE_TGID;
2141		}
2142		get_pid(pid);
2143		spin_unlock_irqrestore(&tty->ctrl_lock, flags);
2144		__f_setown(filp, pid, type, 0);
2145		put_pid(pid);
2146		retval = 0;
2147	}
2148out:
2149	return retval;
2150}
2151
2152static int tty_fasync(int fd, struct file *filp, int on)
2153{
2154	struct tty_struct *tty = file_tty(filp);
2155	int retval = -ENOTTY;
2156
2157	tty_lock(tty);
2158	if (!tty_hung_up_p(filp))
2159		retval = __tty_fasync(fd, filp, on);
2160	tty_unlock(tty);
2161
2162	return retval;
2163}
2164
 
2165/**
2166 *	tiocsti			-	fake input character
2167 *	@tty: tty to fake input into
2168 *	@p: pointer to character
2169 *
2170 *	Fake input to a tty device. Does the necessary locking and
2171 *	input management.
2172 *
2173 *	FIXME: does not honour flow control ??
2174 *
2175 *	Locking:
2176 *		Called functions take tty_ldiscs_lock
2177 *		current->signal->tty check is safe without locks
2178 *
2179 *	FIXME: may race normal receive processing
 
 
2180 */
2181
2182static int tiocsti(struct tty_struct *tty, char __user *p)
2183{
2184	char ch, mbz = 0;
2185	struct tty_ldisc *ld;
 
 
 
 
2186
2187	if ((current->signal->tty != tty) && !capable(CAP_SYS_ADMIN))
2188		return -EPERM;
2189	if (get_user(ch, p))
2190		return -EFAULT;
2191	tty_audit_tiocsti(tty, ch);
2192	ld = tty_ldisc_ref_wait(tty);
2193	if (!ld)
2194		return -EIO;
 
2195	if (ld->ops->receive_buf)
2196		ld->ops->receive_buf(tty, &ch, &mbz, 1);
 
2197	tty_ldisc_deref(ld);
2198	return 0;
2199}
2200
2201/**
2202 *	tiocgwinsz		-	implement window query ioctl
2203 *	@tty; tty
2204 *	@arg: user buffer for result
2205 *
2206 *	Copies the kernel idea of the window size into the user buffer.
2207 *
2208 *	Locking: tty->winsize_mutex is taken to ensure the winsize data
2209 *		is consistent.
2210 */
2211
2212static int tiocgwinsz(struct tty_struct *tty, struct winsize __user *arg)
2213{
2214	int err;
2215
2216	mutex_lock(&tty->winsize_mutex);
2217	err = copy_to_user(arg, &tty->winsize, sizeof(*arg));
2218	mutex_unlock(&tty->winsize_mutex);
2219
2220	return err ? -EFAULT: 0;
2221}
2222
2223/**
2224 *	tty_do_resize		-	resize event
2225 *	@tty: tty being resized
2226 *	@rows: rows (character)
2227 *	@cols: cols (character)
2228 *
2229 *	Update the termios variables and send the necessary signals to
2230 *	peform a terminal resize correctly
2231 */
2232
2233int tty_do_resize(struct tty_struct *tty, struct winsize *ws)
2234{
2235	struct pid *pgrp;
2236
2237	/* Lock the tty */
2238	mutex_lock(&tty->winsize_mutex);
2239	if (!memcmp(ws, &tty->winsize, sizeof(*ws)))
2240		goto done;
2241
2242	/* Signal the foreground process group */
2243	pgrp = tty_get_pgrp(tty);
2244	if (pgrp)
2245		kill_pgrp(pgrp, SIGWINCH, 1);
2246	put_pid(pgrp);
2247
2248	tty->winsize = *ws;
2249done:
2250	mutex_unlock(&tty->winsize_mutex);
2251	return 0;
2252}
2253EXPORT_SYMBOL(tty_do_resize);
2254
2255/**
2256 *	tiocswinsz		-	implement window size set ioctl
2257 *	@tty; tty side of tty
2258 *	@arg: user buffer for result
2259 *
2260 *	Copies the user idea of the window size to the kernel. Traditionally
2261 *	this is just advisory information but for the Linux console it
2262 *	actually has driver level meaning and triggers a VC resize.
2263 *
2264 *	Locking:
2265 *		Driver dependent. The default do_resize method takes the
2266 *	tty termios mutex and ctrl_lock. The console takes its own lock
2267 *	then calls into the default method.
2268 */
2269
2270static int tiocswinsz(struct tty_struct *tty, struct winsize __user *arg)
2271{
2272	struct winsize tmp_ws;
 
2273	if (copy_from_user(&tmp_ws, arg, sizeof(*arg)))
2274		return -EFAULT;
2275
2276	if (tty->ops->resize)
2277		return tty->ops->resize(tty, &tmp_ws);
2278	else
2279		return tty_do_resize(tty, &tmp_ws);
2280}
2281
2282/**
2283 *	tioccons	-	allow admin to move logical console
2284 *	@file: the file to become console
2285 *
2286 *	Allow the administrator to move the redirected console device
2287 *
2288 *	Locking: uses redirect_lock to guard the redirect information
2289 */
2290
2291static int tioccons(struct file *file)
2292{
2293	if (!capable(CAP_SYS_ADMIN))
2294		return -EPERM;
2295	if (file->f_op->write == redirected_tty_write) {
2296		struct file *f;
 
2297		spin_lock(&redirect_lock);
2298		f = redirect;
2299		redirect = NULL;
2300		spin_unlock(&redirect_lock);
2301		if (f)
2302			fput(f);
2303		return 0;
2304	}
 
 
 
 
 
 
2305	spin_lock(&redirect_lock);
2306	if (redirect) {
2307		spin_unlock(&redirect_lock);
2308		return -EBUSY;
2309	}
2310	redirect = get_file(file);
2311	spin_unlock(&redirect_lock);
2312	return 0;
2313}
2314
2315/**
2316 *	tiocsetd	-	set line discipline
2317 *	@tty: tty device
2318 *	@p: pointer to user data
2319 *
2320 *	Set the line discipline according to user request.
2321 *
2322 *	Locking: see tty_set_ldisc, this function is just a helper
2323 */
2324
2325static int tiocsetd(struct tty_struct *tty, int __user *p)
2326{
2327	int disc;
2328	int ret;
2329
2330	if (get_user(disc, p))
2331		return -EFAULT;
2332
2333	ret = tty_set_ldisc(tty, disc);
2334
2335	return ret;
2336}
2337
2338/**
2339 *	tiocgetd	-	get line discipline
2340 *	@tty: tty device
2341 *	@p: pointer to user data
2342 *
2343 *	Retrieves the line discipline id directly from the ldisc.
2344 *
2345 *	Locking: waits for ldisc reference (in case the line discipline
2346 *		is changing or the tty is being hungup)
2347 */
2348
2349static int tiocgetd(struct tty_struct *tty, int __user *p)
2350{
2351	struct tty_ldisc *ld;
2352	int ret;
2353
2354	ld = tty_ldisc_ref_wait(tty);
2355	if (!ld)
2356		return -EIO;
2357	ret = put_user(ld->ops->num, p);
2358	tty_ldisc_deref(ld);
2359	return ret;
2360}
2361
2362/**
2363 *	send_break	-	performed time break
2364 *	@tty: device to break on
2365 *	@duration: timeout in mS
2366 *
2367 *	Perform a timed break on hardware that lacks its own driver level
2368 *	timed break functionality.
2369 *
2370 *	Locking:
2371 *		atomic_write_lock serializes
2372 *
 
 
2373 */
2374
2375static int send_break(struct tty_struct *tty, unsigned int duration)
2376{
2377	int retval;
2378
2379	if (tty->ops->break_ctl == NULL)
2380		return 0;
2381
2382	if (tty->driver->flags & TTY_DRIVER_HARDWARE_BREAK)
2383		retval = tty->ops->break_ctl(tty, duration);
2384	else {
2385		/* Do the work ourselves */
2386		if (tty_write_lock(tty, 0) < 0)
2387			return -EINTR;
2388		retval = tty->ops->break_ctl(tty, -1);
2389		if (retval)
2390			goto out;
2391		if (!signal_pending(current))
2392			msleep_interruptible(duration);
2393		retval = tty->ops->break_ctl(tty, 0);
2394out:
2395		tty_write_unlock(tty);
2396		if (signal_pending(current))
2397			retval = -EINTR;
2398	}
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
2399	return retval;
2400}
 
2401
2402/**
2403 *	tty_tiocmget		-	get modem status
2404 *	@tty: tty device
2405 *	@file: user file pointer
2406 *	@p: pointer to result
2407 *
2408 *	Obtain the modem status bits from the tty driver if the feature
2409 *	is supported. Return -EINVAL if it is not available.
2410 *
2411 *	Locking: none (up to the driver)
2412 */
2413
2414static int tty_tiocmget(struct tty_struct *tty, int __user *p)
2415{
2416	int retval = -EINVAL;
2417
2418	if (tty->ops->tiocmget) {
2419		retval = tty->ops->tiocmget(tty);
 
2420
2421		if (retval >= 0)
2422			retval = put_user(retval, p);
2423	}
2424	return retval;
2425}
2426
2427/**
2428 *	tty_tiocmset		-	set modem status
2429 *	@tty: tty device
2430 *	@cmd: command - clear bits, set bits or set all
2431 *	@p: pointer to desired bits
2432 *
2433 *	Set the modem status bits from the tty driver if the feature
2434 *	is supported. Return -EINVAL if it is not available.
2435 *
2436 *	Locking: none (up to the driver)
2437 */
2438
2439static int tty_tiocmset(struct tty_struct *tty, unsigned int cmd,
2440	     unsigned __user *p)
2441{
2442	int retval;
2443	unsigned int set, clear, val;
2444
2445	if (tty->ops->tiocmset == NULL)
2446		return -EINVAL;
2447
2448	retval = get_user(val, p);
2449	if (retval)
2450		return retval;
2451	set = clear = 0;
2452	switch (cmd) {
2453	case TIOCMBIS:
2454		set = val;
2455		break;
2456	case TIOCMBIC:
2457		clear = val;
2458		break;
2459	case TIOCMSET:
2460		set = val;
2461		clear = ~val;
2462		break;
2463	}
2464	set &= TIOCM_DTR|TIOCM_RTS|TIOCM_OUT1|TIOCM_OUT2|TIOCM_LOOP;
2465	clear &= TIOCM_DTR|TIOCM_RTS|TIOCM_OUT1|TIOCM_OUT2|TIOCM_LOOP;
2466	return tty->ops->tiocmset(tty, set, clear);
2467}
2468
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
2469static int tty_tiocgicount(struct tty_struct *tty, void __user *arg)
2470{
2471	int retval = -EINVAL;
2472	struct serial_icounter_struct icount;
2473	memset(&icount, 0, sizeof(icount));
2474	if (tty->ops->get_icount)
2475		retval = tty->ops->get_icount(tty, &icount);
2476	if (retval != 0)
2477		return retval;
 
2478	if (copy_to_user(arg, &icount, sizeof(icount)))
2479		return -EFAULT;
2480	return 0;
2481}
2482
2483static int tty_tiocsserial(struct tty_struct *tty, struct serial_struct __user *ss)
2484{
2485	static DEFINE_RATELIMIT_STATE(depr_flags,
2486			DEFAULT_RATELIMIT_INTERVAL,
2487			DEFAULT_RATELIMIT_BURST);
2488	char comm[TASK_COMM_LEN];
2489	struct serial_struct v;
2490	int flags;
2491
2492	if (copy_from_user(&v, ss, sizeof(*ss)))
2493		return -EFAULT;
2494
2495	flags = v.flags & ASYNC_DEPRECATED;
 
 
2496
2497	if (flags && __ratelimit(&depr_flags))
2498		pr_warn("%s: '%s' is using deprecated serial flags (with no effect): %.8x\n",
2499			__func__, get_task_comm(comm, current), flags);
2500	if (!tty->ops->set_serial)
2501		return -ENOTTY;
2502	return tty->ops->set_serial(tty, &v);
 
 
 
 
 
 
 
 
 
 
 
2503}
2504
2505static int tty_tiocgserial(struct tty_struct *tty, struct serial_struct __user *ss)
2506{
2507	struct serial_struct v;
2508	int err;
2509
2510	memset(&v, 0, sizeof(v));
2511	if (!tty->ops->get_serial)
2512		return -ENOTTY;
2513	err = tty->ops->get_serial(tty, &v);
2514	if (!err && copy_to_user(ss, &v, sizeof(v)))
2515		err = -EFAULT;
2516	return err;
2517}
2518
2519/*
2520 * if pty, return the slave side (real_tty)
2521 * otherwise, return self
2522 */
2523static struct tty_struct *tty_pair_get_tty(struct tty_struct *tty)
2524{
2525	if (tty->driver->type == TTY_DRIVER_TYPE_PTY &&
2526	    tty->driver->subtype == PTY_TYPE_MASTER)
2527		tty = tty->link;
2528	return tty;
2529}
2530
2531/*
2532 * Split this up, as gcc can choke on it otherwise..
2533 */
2534long tty_ioctl(struct file *file, unsigned int cmd, unsigned long arg)
2535{
2536	struct tty_struct *tty = file_tty(file);
2537	struct tty_struct *real_tty;
2538	void __user *p = (void __user *)arg;
2539	int retval;
2540	struct tty_ldisc *ld;
2541
2542	if (tty_paranoia_check(tty, file_inode(file), "tty_ioctl"))
2543		return -EINVAL;
2544
2545	real_tty = tty_pair_get_tty(tty);
2546
2547	/*
2548	 * Factor out some common prep work
2549	 */
2550	switch (cmd) {
2551	case TIOCSETD:
2552	case TIOCSBRK:
2553	case TIOCCBRK:
2554	case TCSBRK:
2555	case TCSBRKP:
2556		retval = tty_check_change(tty);
2557		if (retval)
2558			return retval;
2559		if (cmd != TIOCCBRK) {
2560			tty_wait_until_sent(tty, 0);
2561			if (signal_pending(current))
2562				return -EINTR;
2563		}
2564		break;
2565	}
2566
2567	/*
2568	 *	Now do the stuff.
2569	 */
2570	switch (cmd) {
2571	case TIOCSTI:
2572		return tiocsti(tty, p);
2573	case TIOCGWINSZ:
2574		return tiocgwinsz(real_tty, p);
2575	case TIOCSWINSZ:
2576		return tiocswinsz(real_tty, p);
2577	case TIOCCONS:
2578		return real_tty != tty ? -EINVAL : tioccons(file);
2579	case TIOCEXCL:
2580		set_bit(TTY_EXCLUSIVE, &tty->flags);
2581		return 0;
2582	case TIOCNXCL:
2583		clear_bit(TTY_EXCLUSIVE, &tty->flags);
2584		return 0;
2585	case TIOCGEXCL:
2586	{
2587		int excl = test_bit(TTY_EXCLUSIVE, &tty->flags);
 
2588		return put_user(excl, (int __user *)p);
2589	}
2590	case TIOCGETD:
2591		return tiocgetd(tty, p);
2592	case TIOCSETD:
2593		return tiocsetd(tty, p);
2594	case TIOCVHANGUP:
2595		if (!capable(CAP_SYS_ADMIN))
2596			return -EPERM;
2597		tty_vhangup(tty);
2598		return 0;
2599	case TIOCGDEV:
2600	{
2601		unsigned int ret = new_encode_dev(tty_devnum(real_tty));
 
2602		return put_user(ret, (unsigned int __user *)p);
2603	}
2604	/*
2605	 * Break handling
2606	 */
2607	case TIOCSBRK:	/* Turn break on, unconditionally */
2608		if (tty->ops->break_ctl)
2609			return tty->ops->break_ctl(tty, -1);
2610		return 0;
2611	case TIOCCBRK:	/* Turn break off, unconditionally */
2612		if (tty->ops->break_ctl)
2613			return tty->ops->break_ctl(tty, 0);
2614		return 0;
2615	case TCSBRK:   /* SVID version: non-zero arg --> no break */
2616		/* non-zero arg means wait for all output data
2617		 * to be sent (performed above) but don't send break.
2618		 * This is used by the tcdrain() termios function.
2619		 */
2620		if (!arg)
2621			return send_break(tty, 250);
2622		return 0;
2623	case TCSBRKP:	/* support for POSIX tcsendbreak() */
2624		return send_break(tty, arg ? arg*100 : 250);
2625
2626	case TIOCMGET:
2627		return tty_tiocmget(tty, p);
2628	case TIOCMSET:
2629	case TIOCMBIC:
2630	case TIOCMBIS:
2631		return tty_tiocmset(tty, cmd, p);
2632	case TIOCGICOUNT:
2633		return tty_tiocgicount(tty, p);
2634	case TCFLSH:
2635		switch (arg) {
2636		case TCIFLUSH:
2637		case TCIOFLUSH:
2638		/* flush tty buffer and allow ldisc to process ioctl */
2639			tty_buffer_flush(tty, NULL);
2640			break;
2641		}
2642		break;
2643	case TIOCSSERIAL:
2644		return tty_tiocsserial(tty, p);
2645	case TIOCGSERIAL:
2646		return tty_tiocgserial(tty, p);
2647	case TIOCGPTPEER:
2648		/* Special because the struct file is needed */
2649		return ptm_open_peer(file, tty, (int)arg);
2650	default:
2651		retval = tty_jobctrl_ioctl(tty, real_tty, file, cmd, arg);
2652		if (retval != -ENOIOCTLCMD)
2653			return retval;
2654	}
2655	if (tty->ops->ioctl) {
2656		retval = tty->ops->ioctl(tty, cmd, arg);
2657		if (retval != -ENOIOCTLCMD)
2658			return retval;
2659	}
2660	ld = tty_ldisc_ref_wait(tty);
2661	if (!ld)
2662		return hung_up_tty_ioctl(file, cmd, arg);
2663	retval = -EINVAL;
2664	if (ld->ops->ioctl) {
2665		retval = ld->ops->ioctl(tty, file, cmd, arg);
2666		if (retval == -ENOIOCTLCMD)
2667			retval = -ENOTTY;
2668	}
2669	tty_ldisc_deref(ld);
2670	return retval;
2671}
2672
2673#ifdef CONFIG_COMPAT
2674
2675struct serial_struct32 {
2676	compat_int_t    type;
2677	compat_int_t    line;
2678	compat_uint_t   port;
2679	compat_int_t    irq;
2680	compat_int_t    flags;
2681	compat_int_t    xmit_fifo_size;
2682	compat_int_t    custom_divisor;
2683	compat_int_t    baud_base;
2684	unsigned short  close_delay;
2685	char    io_type;
2686	char    reserved_char;
2687	compat_int_t    hub6;
2688	unsigned short  closing_wait; /* time to wait before closing */
2689	unsigned short  closing_wait2; /* no longer used... */
2690	compat_uint_t   iomem_base;
2691	unsigned short  iomem_reg_shift;
2692	unsigned int    port_high;
2693	/* compat_ulong_t  iomap_base FIXME */
2694	compat_int_t    reserved;
2695};
2696
2697static int compat_tty_tiocsserial(struct tty_struct *tty,
2698		struct serial_struct32 __user *ss)
2699{
2700	static DEFINE_RATELIMIT_STATE(depr_flags,
2701			DEFAULT_RATELIMIT_INTERVAL,
2702			DEFAULT_RATELIMIT_BURST);
2703	char comm[TASK_COMM_LEN];
2704	struct serial_struct32 v32;
2705	struct serial_struct v;
2706	int flags;
2707
2708	if (copy_from_user(&v32, ss, sizeof(*ss)))
2709		return -EFAULT;
2710
2711	memcpy(&v, &v32, offsetof(struct serial_struct32, iomem_base));
2712	v.iomem_base = compat_ptr(v32.iomem_base);
2713	v.iomem_reg_shift = v32.iomem_reg_shift;
2714	v.port_high = v32.port_high;
2715	v.iomap_base = 0;
2716
2717	flags = v.flags & ASYNC_DEPRECATED;
2718
2719	if (flags && __ratelimit(&depr_flags))
2720		pr_warn("%s: '%s' is using deprecated serial flags (with no effect): %.8x\n",
2721			__func__, get_task_comm(comm, current), flags);
2722	if (!tty->ops->set_serial)
2723		return -ENOTTY;
2724	return tty->ops->set_serial(tty, &v);
2725}
2726
2727static int compat_tty_tiocgserial(struct tty_struct *tty,
2728			struct serial_struct32 __user *ss)
2729{
2730	struct serial_struct32 v32;
2731	struct serial_struct v;
2732	int err;
2733
2734	memset(&v, 0, sizeof(v));
2735	memset(&v32, 0, sizeof(v32));
2736
2737	if (!tty->ops->get_serial)
2738		return -ENOTTY;
2739	err = tty->ops->get_serial(tty, &v);
2740	if (!err) {
2741		memcpy(&v32, &v, offsetof(struct serial_struct32, iomem_base));
2742		v32.iomem_base = (unsigned long)v.iomem_base >> 32 ?
2743			0xfffffff : ptr_to_compat(v.iomem_base);
2744		v32.iomem_reg_shift = v.iomem_reg_shift;
2745		v32.port_high = v.port_high;
2746		if (copy_to_user(ss, &v32, sizeof(v32)))
2747			err = -EFAULT;
2748	}
2749	return err;
2750}
2751static long tty_compat_ioctl(struct file *file, unsigned int cmd,
2752				unsigned long arg)
2753{
2754	struct tty_struct *tty = file_tty(file);
2755	struct tty_ldisc *ld;
2756	int retval = -ENOIOCTLCMD;
2757
2758	switch (cmd) {
2759	case TIOCOUTQ:
2760	case TIOCSTI:
2761	case TIOCGWINSZ:
2762	case TIOCSWINSZ:
2763	case TIOCGEXCL:
2764	case TIOCGETD:
2765	case TIOCSETD:
2766	case TIOCGDEV:
2767	case TIOCMGET:
2768	case TIOCMSET:
2769	case TIOCMBIC:
2770	case TIOCMBIS:
2771	case TIOCGICOUNT:
2772	case TIOCGPGRP:
2773	case TIOCSPGRP:
2774	case TIOCGSID:
2775	case TIOCSERGETLSR:
2776	case TIOCGRS485:
2777	case TIOCSRS485:
2778#ifdef TIOCGETP
2779	case TIOCGETP:
2780	case TIOCSETP:
2781	case TIOCSETN:
2782#endif
2783#ifdef TIOCGETC
2784	case TIOCGETC:
2785	case TIOCSETC:
2786#endif
2787#ifdef TIOCGLTC
2788	case TIOCGLTC:
2789	case TIOCSLTC:
2790#endif
2791	case TCSETSF:
2792	case TCSETSW:
2793	case TCSETS:
2794	case TCGETS:
2795#ifdef TCGETS2
2796	case TCGETS2:
2797	case TCSETSF2:
2798	case TCSETSW2:
2799	case TCSETS2:
2800#endif
2801	case TCGETA:
2802	case TCSETAF:
2803	case TCSETAW:
2804	case TCSETA:
2805	case TIOCGLCKTRMIOS:
2806	case TIOCSLCKTRMIOS:
2807#ifdef TCGETX
2808	case TCGETX:
2809	case TCSETX:
2810	case TCSETXW:
2811	case TCSETXF:
2812#endif
2813	case TIOCGSOFTCAR:
2814	case TIOCSSOFTCAR:
2815
2816	case PPPIOCGCHAN:
2817	case PPPIOCGUNIT:
2818		return tty_ioctl(file, cmd, (unsigned long)compat_ptr(arg));
2819	case TIOCCONS:
2820	case TIOCEXCL:
2821	case TIOCNXCL:
2822	case TIOCVHANGUP:
2823	case TIOCSBRK:
2824	case TIOCCBRK:
2825	case TCSBRK:
2826	case TCSBRKP:
2827	case TCFLSH:
2828	case TIOCGPTPEER:
2829	case TIOCNOTTY:
2830	case TIOCSCTTY:
2831	case TCXONC:
2832	case TIOCMIWAIT:
2833	case TIOCSERCONFIG:
2834		return tty_ioctl(file, cmd, arg);
2835	}
2836
2837	if (tty_paranoia_check(tty, file_inode(file), "tty_ioctl"))
2838		return -EINVAL;
2839
2840	switch (cmd) {
2841	case TIOCSSERIAL:
2842		return compat_tty_tiocsserial(tty, compat_ptr(arg));
2843	case TIOCGSERIAL:
2844		return compat_tty_tiocgserial(tty, compat_ptr(arg));
2845	}
2846	if (tty->ops->compat_ioctl) {
2847		retval = tty->ops->compat_ioctl(tty, cmd, arg);
2848		if (retval != -ENOIOCTLCMD)
2849			return retval;
2850	}
2851
2852	ld = tty_ldisc_ref_wait(tty);
2853	if (!ld)
2854		return hung_up_tty_compat_ioctl(file, cmd, arg);
2855	if (ld->ops->compat_ioctl)
2856		retval = ld->ops->compat_ioctl(tty, file, cmd, arg);
2857	if (retval == -ENOIOCTLCMD && ld->ops->ioctl)
2858		retval = ld->ops->ioctl(tty, file,
2859				(unsigned long)compat_ptr(cmd), arg);
2860	tty_ldisc_deref(ld);
2861
2862	return retval;
2863}
2864#endif
2865
2866static int this_tty(const void *t, struct file *file, unsigned fd)
2867{
2868	if (likely(file->f_op->read != tty_read))
2869		return 0;
2870	return file_tty(file) != t ? 0 : fd + 1;
2871}
2872	
2873/*
2874 * This implements the "Secure Attention Key" ---  the idea is to
2875 * prevent trojan horses by killing all processes associated with this
2876 * tty when the user hits the "Secure Attention Key".  Required for
2877 * super-paranoid applications --- see the Orange Book for more details.
2878 *
2879 * This code could be nicer; ideally it should send a HUP, wait a few
2880 * seconds, then send a INT, and then a KILL signal.  But you then
2881 * have to coordinate with the init process, since all processes associated
2882 * with the current tty must be dead before the new getty is allowed
2883 * to spawn.
2884 *
2885 * Now, if it would be correct ;-/ The current code has a nasty hole -
2886 * it doesn't catch files in flight. We may send the descriptor to ourselves
2887 * via AF_UNIX socket, close it and later fetch from socket. FIXME.
2888 *
2889 * Nasty bug: do_SAK is being called in interrupt context.  This can
2890 * deadlock.  We punt it up to process context.  AKPM - 16Mar2001
2891 */
2892void __do_SAK(struct tty_struct *tty)
2893{
2894#ifdef TTY_SOFT_SAK
2895	tty_hangup(tty);
2896#else
2897	struct task_struct *g, *p;
2898	struct pid *session;
2899	int		i;
 
2900
2901	if (!tty)
2902		return;
2903	session = tty->session;
2904
2905	tty_ldisc_flush(tty);
2906
2907	tty_driver_flush_buffer(tty);
2908
2909	read_lock(&tasklist_lock);
2910	/* Kill the entire session */
2911	do_each_pid_task(session, PIDTYPE_SID, p) {
2912		tty_notice(tty, "SAK: killed process %d (%s): by session\n",
2913			   task_pid_nr(p), p->comm);
2914		group_send_sig_info(SIGKILL, SEND_SIG_PRIV, p, PIDTYPE_SID);
2915	} while_each_pid_task(session, PIDTYPE_SID, p);
2916
2917	/* Now kill any processes that happen to have the tty open */
2918	do_each_thread(g, p) {
2919		if (p->signal->tty == tty) {
2920			tty_notice(tty, "SAK: killed process %d (%s): by controlling tty\n",
2921				   task_pid_nr(p), p->comm);
2922			group_send_sig_info(SIGKILL, SEND_SIG_PRIV, p, PIDTYPE_SID);
 
2923			continue;
2924		}
2925		task_lock(p);
2926		i = iterate_fd(p->files, 0, this_tty, tty);
2927		if (i != 0) {
2928			tty_notice(tty, "SAK: killed process %d (%s): by fd#%d\n",
2929				   task_pid_nr(p), p->comm, i - 1);
2930			group_send_sig_info(SIGKILL, SEND_SIG_PRIV, p, PIDTYPE_SID);
 
2931		}
2932		task_unlock(p);
2933	} while_each_thread(g, p);
2934	read_unlock(&tasklist_lock);
2935#endif
2936}
2937
2938static void do_SAK_work(struct work_struct *work)
2939{
2940	struct tty_struct *tty =
2941		container_of(work, struct tty_struct, SAK_work);
2942	__do_SAK(tty);
2943}
2944
2945/*
2946 * The tq handling here is a little racy - tty->SAK_work may already be queued.
2947 * Fortunately we don't need to worry, because if ->SAK_work is already queued,
2948 * the values which we write to it will be identical to the values which it
2949 * already has. --akpm
2950 */
2951void do_SAK(struct tty_struct *tty)
2952{
2953	if (!tty)
2954		return;
2955	schedule_work(&tty->SAK_work);
2956}
2957
2958EXPORT_SYMBOL(do_SAK);
2959
2960/* Must put_device() after it's unused! */
2961static struct device *tty_get_device(struct tty_struct *tty)
2962{
2963	dev_t devt = tty_devnum(tty);
2964	return class_find_device_by_devt(tty_class, devt);
 
2965}
2966
2967
2968/**
2969 *	alloc_tty_struct
 
 
2970 *
2971 *	This subroutine allocates and initializes a tty structure.
2972 *
2973 *	Locking: none - tty in question is not exposed at this point
2974 */
2975
2976struct tty_struct *alloc_tty_struct(struct tty_driver *driver, int idx)
2977{
2978	struct tty_struct *tty;
2979
2980	tty = kzalloc(sizeof(*tty), GFP_KERNEL);
2981	if (!tty)
2982		return NULL;
2983
2984	kref_init(&tty->kref);
2985	tty->magic = TTY_MAGIC;
2986	if (tty_ldisc_init(tty)) {
2987		kfree(tty);
2988		return NULL;
2989	}
2990	tty->session = NULL;
2991	tty->pgrp = NULL;
2992	mutex_init(&tty->legacy_mutex);
2993	mutex_init(&tty->throttle_mutex);
2994	init_rwsem(&tty->termios_rwsem);
2995	mutex_init(&tty->winsize_mutex);
2996	init_ldsem(&tty->ldisc_sem);
2997	init_waitqueue_head(&tty->write_wait);
2998	init_waitqueue_head(&tty->read_wait);
2999	INIT_WORK(&tty->hangup_work, do_tty_hangup);
3000	mutex_init(&tty->atomic_write_lock);
3001	spin_lock_init(&tty->ctrl_lock);
3002	spin_lock_init(&tty->flow_lock);
3003	spin_lock_init(&tty->files_lock);
3004	INIT_LIST_HEAD(&tty->tty_files);
3005	INIT_WORK(&tty->SAK_work, do_SAK_work);
3006
3007	tty->driver = driver;
3008	tty->ops = driver->ops;
3009	tty->index = idx;
3010	tty_line_name(driver, idx, tty->name);
3011	tty->dev = tty_get_device(tty);
3012
3013	return tty;
3014}
3015
3016/**
3017 *	tty_put_char	-	write one character to a tty
3018 *	@tty: tty
3019 *	@ch: character
 
 
 
3020 *
3021 *	Write one byte to the tty using the provided put_char method
3022 *	if present. Returns the number of characters successfully output.
3023 *
3024 *	Note: the specific put_char operation in the driver layer may go
3025 *	away soon. Don't call it directly, use this method
3026 */
3027
3028int tty_put_char(struct tty_struct *tty, unsigned char ch)
3029{
3030	if (tty->ops->put_char)
3031		return tty->ops->put_char(tty, ch);
3032	return tty->ops->write(tty, &ch, 1);
3033}
3034EXPORT_SYMBOL_GPL(tty_put_char);
3035
3036struct class *tty_class;
3037
3038static int tty_cdev_add(struct tty_driver *driver, dev_t dev,
3039		unsigned int index, unsigned int count)
3040{
3041	int err;
3042
3043	/* init here, since reused cdevs cause crashes */
3044	driver->cdevs[index] = cdev_alloc();
3045	if (!driver->cdevs[index])
3046		return -ENOMEM;
3047	driver->cdevs[index]->ops = &tty_fops;
3048	driver->cdevs[index]->owner = driver->owner;
3049	err = cdev_add(driver->cdevs[index], dev, count);
3050	if (err)
3051		kobject_put(&driver->cdevs[index]->kobj);
3052	return err;
3053}
3054
3055/**
3056 *	tty_register_device - register a tty device
3057 *	@driver: the tty driver that describes the tty device
3058 *	@index: the index in the tty driver for this tty device
3059 *	@device: a struct device that is associated with this tty device.
3060 *		This field is optional, if there is no known struct device
3061 *		for this tty device it can be set to NULL safely.
3062 *
3063 *	Returns a pointer to the struct device for this tty device
3064 *	(or ERR_PTR(-EFOO) on error).
3065 *
3066 *	This call is required to be made to register an individual tty device
3067 *	if the tty driver's flags have the TTY_DRIVER_DYNAMIC_DEV bit set.  If
3068 *	that bit is not set, this function should not be called by a tty
3069 *	driver.
3070 *
3071 *	Locking: ??
 
3072 */
3073
3074struct device *tty_register_device(struct tty_driver *driver, unsigned index,
3075				   struct device *device)
3076{
3077	return tty_register_device_attr(driver, index, device, NULL, NULL);
3078}
3079EXPORT_SYMBOL(tty_register_device);
3080
3081static void tty_device_create_release(struct device *dev)
3082{
3083	dev_dbg(dev, "releasing...\n");
3084	kfree(dev);
3085}
3086
3087/**
3088 *	tty_register_device_attr - register a tty device
3089 *	@driver: the tty driver that describes the tty device
3090 *	@index: the index in the tty driver for this tty device
3091 *	@device: a struct device that is associated with this tty device.
3092 *		This field is optional, if there is no known struct device
3093 *		for this tty device it can be set to NULL safely.
3094 *	@drvdata: Driver data to be set to device.
3095 *	@attr_grp: Attribute group to be set on device.
3096 *
3097 *	Returns a pointer to the struct device for this tty device
3098 *	(or ERR_PTR(-EFOO) on error).
3099 *
3100 *	This call is required to be made to register an individual tty device
3101 *	if the tty driver's flags have the TTY_DRIVER_DYNAMIC_DEV bit set.  If
3102 *	that bit is not set, this function should not be called by a tty
3103 *	driver.
3104 *
3105 *	Locking: ??
 
3106 */
3107struct device *tty_register_device_attr(struct tty_driver *driver,
3108				   unsigned index, struct device *device,
3109				   void *drvdata,
3110				   const struct attribute_group **attr_grp)
3111{
3112	char name[64];
3113	dev_t devt = MKDEV(driver->major, driver->minor_start) + index;
3114	struct ktermios *tp;
3115	struct device *dev;
3116	int retval;
3117
3118	if (index >= driver->num) {
3119		pr_err("%s: Attempt to register invalid tty line number (%d)\n",
3120		       driver->name, index);
3121		return ERR_PTR(-EINVAL);
3122	}
3123
3124	if (driver->type == TTY_DRIVER_TYPE_PTY)
3125		pty_line_name(driver, index, name);
3126	else
3127		tty_line_name(driver, index, name);
3128
3129	dev = kzalloc(sizeof(*dev), GFP_KERNEL);
3130	if (!dev)
3131		return ERR_PTR(-ENOMEM);
3132
3133	dev->devt = devt;
3134	dev->class = tty_class;
3135	dev->parent = device;
3136	dev->release = tty_device_create_release;
3137	dev_set_name(dev, "%s", name);
3138	dev->groups = attr_grp;
3139	dev_set_drvdata(dev, drvdata);
3140
3141	dev_set_uevent_suppress(dev, 1);
3142
3143	retval = device_register(dev);
3144	if (retval)
3145		goto err_put;
3146
3147	if (!(driver->flags & TTY_DRIVER_DYNAMIC_ALLOC)) {
3148		/*
3149		 * Free any saved termios data so that the termios state is
3150		 * reset when reusing a minor number.
3151		 */
3152		tp = driver->termios[index];
3153		if (tp) {
3154			driver->termios[index] = NULL;
3155			kfree(tp);
3156		}
3157
3158		retval = tty_cdev_add(driver, devt, index, 1);
3159		if (retval)
3160			goto err_del;
3161	}
3162
3163	dev_set_uevent_suppress(dev, 0);
3164	kobject_uevent(&dev->kobj, KOBJ_ADD);
3165
3166	return dev;
3167
3168err_del:
3169	device_del(dev);
3170err_put:
3171	put_device(dev);
3172
3173	return ERR_PTR(retval);
3174}
3175EXPORT_SYMBOL_GPL(tty_register_device_attr);
3176
3177/**
3178 * 	tty_unregister_device - unregister a tty device
3179 * 	@driver: the tty driver that describes the tty device
3180 * 	@index: the index in the tty driver for this tty device
3181 *
3182 * 	If a tty device is registered with a call to tty_register_device() then
3183 *	this function must be called when the tty device is gone.
3184 *
3185 *	Locking: ??
3186 */
3187
3188void tty_unregister_device(struct tty_driver *driver, unsigned index)
3189{
3190	device_destroy(tty_class,
3191		MKDEV(driver->major, driver->minor_start) + index);
3192	if (!(driver->flags & TTY_DRIVER_DYNAMIC_ALLOC)) {
3193		cdev_del(driver->cdevs[index]);
3194		driver->cdevs[index] = NULL;
3195	}
3196}
3197EXPORT_SYMBOL(tty_unregister_device);
3198
3199/**
3200 * __tty_alloc_driver -- allocate tty driver
3201 * @lines: count of lines this driver can handle at most
3202 * @owner: module which is responsible for this driver
3203 * @flags: some of TTY_DRIVER_* flags, will be set in driver->flags
3204 *
3205 * This should not be called directly, some of the provided macros should be
3206 * used instead. Use IS_ERR and friends on @retval.
3207 */
3208struct tty_driver *__tty_alloc_driver(unsigned int lines, struct module *owner,
3209		unsigned long flags)
3210{
3211	struct tty_driver *driver;
3212	unsigned int cdevs = 1;
3213	int err;
3214
3215	if (!lines || (flags & TTY_DRIVER_UNNUMBERED_NODE && lines > 1))
3216		return ERR_PTR(-EINVAL);
3217
3218	driver = kzalloc(sizeof(*driver), GFP_KERNEL);
3219	if (!driver)
3220		return ERR_PTR(-ENOMEM);
3221
3222	kref_init(&driver->kref);
3223	driver->magic = TTY_DRIVER_MAGIC;
3224	driver->num = lines;
3225	driver->owner = owner;
3226	driver->flags = flags;
3227
3228	if (!(flags & TTY_DRIVER_DEVPTS_MEM)) {
3229		driver->ttys = kcalloc(lines, sizeof(*driver->ttys),
3230				GFP_KERNEL);
3231		driver->termios = kcalloc(lines, sizeof(*driver->termios),
3232				GFP_KERNEL);
3233		if (!driver->ttys || !driver->termios) {
3234			err = -ENOMEM;
3235			goto err_free_all;
3236		}
3237	}
3238
3239	if (!(flags & TTY_DRIVER_DYNAMIC_ALLOC)) {
3240		driver->ports = kcalloc(lines, sizeof(*driver->ports),
3241				GFP_KERNEL);
3242		if (!driver->ports) {
3243			err = -ENOMEM;
3244			goto err_free_all;
3245		}
3246		cdevs = lines;
3247	}
3248
3249	driver->cdevs = kcalloc(cdevs, sizeof(*driver->cdevs), GFP_KERNEL);
3250	if (!driver->cdevs) {
3251		err = -ENOMEM;
3252		goto err_free_all;
3253	}
3254
3255	return driver;
3256err_free_all:
3257	kfree(driver->ports);
3258	kfree(driver->ttys);
3259	kfree(driver->termios);
3260	kfree(driver->cdevs);
3261	kfree(driver);
3262	return ERR_PTR(err);
3263}
3264EXPORT_SYMBOL(__tty_alloc_driver);
3265
3266static void destruct_tty_driver(struct kref *kref)
3267{
3268	struct tty_driver *driver = container_of(kref, struct tty_driver, kref);
3269	int i;
3270	struct ktermios *tp;
3271
3272	if (driver->flags & TTY_DRIVER_INSTALLED) {
3273		for (i = 0; i < driver->num; i++) {
3274			tp = driver->termios[i];
3275			if (tp) {
3276				driver->termios[i] = NULL;
3277				kfree(tp);
3278			}
3279			if (!(driver->flags & TTY_DRIVER_DYNAMIC_DEV))
3280				tty_unregister_device(driver, i);
3281		}
3282		proc_tty_unregister_driver(driver);
3283		if (driver->flags & TTY_DRIVER_DYNAMIC_ALLOC)
3284			cdev_del(driver->cdevs[0]);
3285	}
3286	kfree(driver->cdevs);
3287	kfree(driver->ports);
3288	kfree(driver->termios);
3289	kfree(driver->ttys);
3290	kfree(driver);
3291}
3292
 
 
 
 
 
 
3293void tty_driver_kref_put(struct tty_driver *driver)
3294{
3295	kref_put(&driver->kref, destruct_tty_driver);
3296}
3297EXPORT_SYMBOL(tty_driver_kref_put);
3298
3299void tty_set_operations(struct tty_driver *driver,
3300			const struct tty_operations *op)
3301{
3302	driver->ops = op;
3303};
3304EXPORT_SYMBOL(tty_set_operations);
3305
3306void put_tty_driver(struct tty_driver *d)
3307{
3308	tty_driver_kref_put(d);
3309}
3310EXPORT_SYMBOL(put_tty_driver);
3311
3312/*
3313 * Called by a tty driver to register itself.
3314 */
3315int tty_register_driver(struct tty_driver *driver)
3316{
3317	int error;
3318	int i;
3319	dev_t dev;
3320	struct device *d;
3321
3322	if (!driver->major) {
3323		error = alloc_chrdev_region(&dev, driver->minor_start,
3324						driver->num, driver->name);
3325		if (!error) {
3326			driver->major = MAJOR(dev);
3327			driver->minor_start = MINOR(dev);
3328		}
3329	} else {
3330		dev = MKDEV(driver->major, driver->minor_start);
3331		error = register_chrdev_region(dev, driver->num, driver->name);
3332	}
3333	if (error < 0)
3334		goto err;
3335
3336	if (driver->flags & TTY_DRIVER_DYNAMIC_ALLOC) {
3337		error = tty_cdev_add(driver, dev, 0, driver->num);
3338		if (error)
3339			goto err_unreg_char;
3340	}
3341
3342	mutex_lock(&tty_mutex);
3343	list_add(&driver->tty_drivers, &tty_drivers);
3344	mutex_unlock(&tty_mutex);
3345
3346	if (!(driver->flags & TTY_DRIVER_DYNAMIC_DEV)) {
3347		for (i = 0; i < driver->num; i++) {
3348			d = tty_register_device(driver, i, NULL);
3349			if (IS_ERR(d)) {
3350				error = PTR_ERR(d);
3351				goto err_unreg_devs;
3352			}
3353		}
3354	}
3355	proc_tty_register_driver(driver);
3356	driver->flags |= TTY_DRIVER_INSTALLED;
3357	return 0;
3358
3359err_unreg_devs:
3360	for (i--; i >= 0; i--)
3361		tty_unregister_device(driver, i);
3362
3363	mutex_lock(&tty_mutex);
3364	list_del(&driver->tty_drivers);
3365	mutex_unlock(&tty_mutex);
3366
3367err_unreg_char:
3368	unregister_chrdev_region(dev, driver->num);
3369err:
3370	return error;
3371}
3372EXPORT_SYMBOL(tty_register_driver);
3373
3374/*
 
 
 
3375 * Called by a tty driver to unregister itself.
3376 */
3377int tty_unregister_driver(struct tty_driver *driver)
3378{
3379#if 0
3380	/* FIXME */
3381	if (driver->refcount)
3382		return -EBUSY;
3383#endif
3384	unregister_chrdev_region(MKDEV(driver->major, driver->minor_start),
3385				driver->num);
3386	mutex_lock(&tty_mutex);
3387	list_del(&driver->tty_drivers);
3388	mutex_unlock(&tty_mutex);
3389	return 0;
3390}
3391
3392EXPORT_SYMBOL(tty_unregister_driver);
3393
3394dev_t tty_devnum(struct tty_struct *tty)
3395{
3396	return MKDEV(tty->driver->major, tty->driver->minor_start) + tty->index;
3397}
3398EXPORT_SYMBOL(tty_devnum);
3399
3400void tty_default_fops(struct file_operations *fops)
3401{
3402	*fops = tty_fops;
3403}
3404
3405static char *tty_devnode(struct device *dev, umode_t *mode)
3406{
3407	if (!mode)
3408		return NULL;
3409	if (dev->devt == MKDEV(TTYAUX_MAJOR, 0) ||
3410	    dev->devt == MKDEV(TTYAUX_MAJOR, 2))
3411		*mode = 0666;
3412	return NULL;
3413}
3414
 
 
 
 
 
3415static int __init tty_class_init(void)
3416{
3417	tty_class = class_create(THIS_MODULE, "tty");
3418	if (IS_ERR(tty_class))
3419		return PTR_ERR(tty_class);
3420	tty_class->devnode = tty_devnode;
3421	return 0;
3422}
3423
3424postcore_initcall(tty_class_init);
3425
3426/* 3/2004 jmc: why do these devices exist? */
3427static struct cdev tty_cdev, console_cdev;
3428
3429static ssize_t show_cons_active(struct device *dev,
3430				struct device_attribute *attr, char *buf)
3431{
3432	struct console *cs[16];
3433	int i = 0;
3434	struct console *c;
3435	ssize_t count = 0;
3436
3437	console_lock();
 
 
 
 
 
 
 
3438	for_each_console(c) {
3439		if (!c->device)
3440			continue;
3441		if (!c->write)
3442			continue;
3443		if ((c->flags & CON_ENABLED) == 0)
3444			continue;
3445		cs[i++] = c;
3446		if (i >= ARRAY_SIZE(cs))
3447			break;
3448	}
 
 
 
 
 
 
 
3449	while (i--) {
3450		int index = cs[i]->index;
3451		struct tty_driver *drv = cs[i]->device(cs[i], &index);
3452
3453		/* don't resolve tty0 as some programs depend on it */
3454		if (drv && (cs[i]->index > 0 || drv->major != TTY_MAJOR))
3455			count += tty_line_name(drv, index, buf + count);
3456		else
3457			count += sprintf(buf + count, "%s%d",
3458					 cs[i]->name, cs[i]->index);
3459
3460		count += sprintf(buf + count, "%c", i ? ' ':'\n');
3461	}
3462	console_unlock();
3463
 
 
3464	return count;
3465}
3466static DEVICE_ATTR(active, S_IRUGO, show_cons_active, NULL);
3467
3468static struct attribute *cons_dev_attrs[] = {
3469	&dev_attr_active.attr,
3470	NULL
3471};
3472
3473ATTRIBUTE_GROUPS(cons_dev);
3474
3475static struct device *consdev;
3476
3477void console_sysfs_notify(void)
3478{
3479	if (consdev)
3480		sysfs_notify(&consdev->kobj, NULL, "active");
3481}
3482
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
3483/*
3484 * Ok, now we can initialize the rest of the tty devices and can count
3485 * on memory allocations, interrupts etc..
3486 */
3487int __init tty_init(void)
3488{
3489	tty_sysctl_init();
3490	cdev_init(&tty_cdev, &tty_fops);
3491	if (cdev_add(&tty_cdev, MKDEV(TTYAUX_MAJOR, 0), 1) ||
3492	    register_chrdev_region(MKDEV(TTYAUX_MAJOR, 0), 1, "/dev/tty") < 0)
3493		panic("Couldn't register /dev/tty driver\n");
3494	device_create(tty_class, NULL, MKDEV(TTYAUX_MAJOR, 0), NULL, "tty");
3495
3496	cdev_init(&console_cdev, &console_fops);
3497	if (cdev_add(&console_cdev, MKDEV(TTYAUX_MAJOR, 1), 1) ||
3498	    register_chrdev_region(MKDEV(TTYAUX_MAJOR, 1), 1, "/dev/console") < 0)
3499		panic("Couldn't register /dev/console driver\n");
3500	consdev = device_create_with_groups(tty_class, NULL,
3501					    MKDEV(TTYAUX_MAJOR, 1), NULL,
3502					    cons_dev_groups, "console");
3503	if (IS_ERR(consdev))
3504		consdev = NULL;
3505
3506#ifdef CONFIG_VT
3507	vty_init(&console_fops);
3508#endif
3509	return 0;
3510}
3511