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 119 struct 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 131 EXPORT_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 137 LIST_HEAD(tty_drivers); /* linked list of tty drivers */ 138 139 /* Mutex to protect creating and releasing a tty */ 140 DEFINE_MUTEX(tty_mutex); 141 142 static ssize_t tty_read(struct file *, char __user *, size_t, loff_t *); 143 static ssize_t tty_write(struct file *, const char __user *, size_t, loff_t *); 144 ssize_t redirected_tty_write(struct file *, const char __user *, 145 size_t, loff_t *); 146 static unsigned int tty_poll(struct file *, poll_table *); 147 static int tty_open(struct inode *, struct file *); 148 long tty_ioctl(struct file *file, unsigned int cmd, unsigned long arg); 149 #ifdef CONFIG_COMPAT 150 static long tty_compat_ioctl(struct file *file, unsigned int cmd, 151 unsigned long arg); 152 #else 153 #define tty_compat_ioctl NULL 154 #endif 155 static int __tty_fasync(int fd, struct file *filp, int on); 156 static int tty_fasync(int fd, struct file *filp, int on); 157 static 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 168 static 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 177 static inline struct tty_struct *file_tty(struct file *file) 178 { 179 return ((struct tty_file_private *)file->private_data)->tty; 180 } 181 182 int 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 */ 196 void 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 */ 214 void 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 */ 223 static 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 244 const 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 251 EXPORT_SYMBOL(tty_name); 252 253 const char *tty_driver_name(const struct tty_struct *tty) 254 { 255 if (!tty || !tty->driver) 256 return ""; 257 return tty->driver->name; 258 } 259 260 static 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 */ 279 static 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 316 static 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 */ 343 int 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; 374 out: 375 mutex_unlock(&tty_mutex); 376 return ret; 377 } 378 EXPORT_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 */ 391 struct 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 } 429 EXPORT_SYMBOL_GPL(tty_find_polling_driver); 430 #endif 431 432 static 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 438 static 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 ;) */ 445 static unsigned int hung_up_tty_poll(struct file *filp, poll_table *wait) 446 { 447 return POLLIN | POLLOUT | POLLERR | POLLHUP | POLLRDNORM | POLLWRNORM; 448 } 449 450 static long hung_up_tty_ioctl(struct file *file, unsigned int cmd, 451 unsigned long arg) 452 { 453 return cmd == TIOCSPGRP ? -ENOTTY : -EIO; 454 } 455 456 static 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 462 static int hung_up_tty_fasync(int fd, struct file *file, int on) 463 { 464 return -ENOTTY; 465 } 466 467 static 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 475 static 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 488 static 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 500 static 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 511 static DEFINE_SPINLOCK(redirect_lock); 512 static 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 523 void 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 538 EXPORT_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 */ 562 static 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 648 static 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 664 void tty_hangup(struct tty_struct *tty) 665 { 666 tty_debug_hangup(tty, "hangup\n"); 667 schedule_work(&tty->hangup_work); 668 } 669 670 EXPORT_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 681 void tty_vhangup(struct tty_struct *tty) 682 { 683 tty_debug_hangup(tty, "vhangup\n"); 684 __tty_hangup(tty, 0); 685 } 686 687 EXPORT_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 696 void 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 718 void 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 732 int tty_hung_up_p(struct file *filp) 733 { 734 return (filp && filp->f_op == &hung_up_tty_fops); 735 } 736 737 EXPORT_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 756 void __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 765 void 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 } 773 EXPORT_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 787 void __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 797 void 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 } 805 EXPORT_SYMBOL(start_tty); 806 807 static 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 836 static 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 866 static 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 872 static 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 */ 887 static 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 } 965 out: 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 982 void 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 1012 static 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 1037 ssize_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 1064 int 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 1089 static 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 */ 1102 static 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 */ 1122 static 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 */ 1141 static 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 1167 void 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 } 1187 EXPORT_SYMBOL_GPL(tty_init_termios); 1188 1189 int 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 } 1197 EXPORT_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 */ 1211 static 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 */ 1228 static 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 */ 1245 static 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 1291 struct 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 1338 err_free_tty: 1339 tty_unlock(tty); 1340 free_tty_struct(tty); 1341 err_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 */ 1346 err_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 1354 static 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 */ 1380 static 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 */ 1405 static 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 1428 static 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 1446 void tty_kref_put(struct tty_struct *tty) 1447 { 1448 if (tty) 1449 kref_put(&tty->kref, queue_release_one_tty); 1450 } 1451 EXPORT_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 */ 1465 static 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 */ 1492 static 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 */ 1534 void 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 } 1556 EXPORT_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 */ 1566 void 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 } 1587 EXPORT_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 1608 int 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 */ 1759 static 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 */ 1796 static 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 */ 1846 struct 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 } 1874 out: 1875 mutex_unlock(&tty_mutex); 1876 tty_driver_kref_put(driver); 1877 return tty; 1878 } 1879 EXPORT_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 */ 1897 static 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 } 1944 out: 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 1973 static 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 1982 retry_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 2057 static 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 2075 static 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 } 2106 out: 2107 return retval; 2108 } 2109 2110 static 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 2140 static 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 2169 static 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 2190 int 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; 2206 done: 2207 mutex_unlock(&tty->winsize_mutex); 2208 return 0; 2209 } 2210 EXPORT_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 2227 static 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 2248 static 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 2284 static 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 2310 static 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 2334 static 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 2360 static 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); 2379 out: 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 2399 static 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 2424 static 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 2454 static 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 2468 static 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 */ 2490 static 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 */ 2501 long 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 2646 static 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 2675 static 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 */ 2701 void __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 2747 static 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 */ 2760 void do_SAK(struct tty_struct *tty) 2761 { 2762 if (!tty) 2763 return; 2764 schedule_work(&tty->SAK_work); 2765 } 2766 2767 EXPORT_SYMBOL(do_SAK); 2768 2769 static 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! */ 2776 static 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 2791 struct 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 2840 int 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 } 2846 EXPORT_SYMBOL_GPL(tty_put_char); 2847 2848 struct class *tty_class; 2849 2850 static 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 2886 struct 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 } 2891 EXPORT_SYMBOL(tty_register_device); 2892 2893 static 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 */ 2919 struct 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 2980 err_del: 2981 device_del(dev); 2982 err_put: 2983 put_device(dev); 2984 2985 return ERR_PTR(retval); 2986 } 2987 EXPORT_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 3000 void 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 } 3009 EXPORT_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 */ 3020 struct 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; 3068 err_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 } 3076 EXPORT_SYMBOL(__tty_alloc_driver); 3077 3078 static 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 3105 void tty_driver_kref_put(struct tty_driver *driver) 3106 { 3107 kref_put(&driver->kref, destruct_tty_driver); 3108 } 3109 EXPORT_SYMBOL(tty_driver_kref_put); 3110 3111 void tty_set_operations(struct tty_driver *driver, 3112 const struct tty_operations *op) 3113 { 3114 driver->ops = op; 3115 }; 3116 EXPORT_SYMBOL(tty_set_operations); 3117 3118 void put_tty_driver(struct tty_driver *d) 3119 { 3120 tty_driver_kref_put(d); 3121 } 3122 EXPORT_SYMBOL(put_tty_driver); 3123 3124 /* 3125 * Called by a tty driver to register itself. 3126 */ 3127 int 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 3171 err_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 3179 err_unreg_char: 3180 unregister_chrdev_region(dev, driver->num); 3181 err: 3182 return error; 3183 } 3184 EXPORT_SYMBOL(tty_register_driver); 3185 3186 /* 3187 * Called by a tty driver to unregister itself. 3188 */ 3189 int 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 3204 EXPORT_SYMBOL(tty_unregister_driver); 3205 3206 dev_t tty_devnum(struct tty_struct *tty) 3207 { 3208 return MKDEV(tty->driver->major, tty->driver->minor_start) + tty->index; 3209 } 3210 EXPORT_SYMBOL(tty_devnum); 3211 3212 void tty_default_fops(struct file_operations *fops) 3213 { 3214 *fops = tty_fops; 3215 } 3216 3217 static 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 3227 static 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 3236 postcore_initcall(tty_class_init); 3237 3238 /* 3/2004 jmc: why do these devices exist? */ 3239 static struct cdev tty_cdev, console_cdev; 3240 3241 static 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 } 3278 static DEVICE_ATTR(active, S_IRUGO, show_cons_active, NULL); 3279 3280 static struct attribute *cons_dev_attrs[] = { 3281 &dev_attr_active.attr, 3282 NULL 3283 }; 3284 3285 ATTRIBUTE_GROUPS(cons_dev); 3286 3287 static struct device *consdev; 3288 3289 void 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 */ 3299 int __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