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