pty.c (24786B)
1// SPDX-License-Identifier: GPL-2.0 2/* 3 * Copyright (C) 1991, 1992 Linus Torvalds 4 * 5 * Added support for a Unix98-style ptmx device. 6 * -- C. Scott Ananian <cananian@alumni.princeton.edu>, 14-Jan-1998 7 * 8 */ 9 10#include <linux/module.h> 11#include <linux/errno.h> 12#include <linux/interrupt.h> 13#include <linux/tty.h> 14#include <linux/tty_flip.h> 15#include <linux/fcntl.h> 16#include <linux/sched/signal.h> 17#include <linux/string.h> 18#include <linux/major.h> 19#include <linux/mm.h> 20#include <linux/init.h> 21#include <linux/device.h> 22#include <linux/uaccess.h> 23#include <linux/bitops.h> 24#include <linux/devpts_fs.h> 25#include <linux/slab.h> 26#include <linux/mutex.h> 27#include <linux/poll.h> 28#include <linux/mount.h> 29#include <linux/file.h> 30#include <linux/ioctl.h> 31#include <linux/compat.h> 32#include "tty.h" 33 34#undef TTY_DEBUG_HANGUP 35#ifdef TTY_DEBUG_HANGUP 36# define tty_debug_hangup(tty, f, args...) tty_debug(tty, f, ##args) 37#else 38# define tty_debug_hangup(tty, f, args...) do {} while (0) 39#endif 40 41#ifdef CONFIG_UNIX98_PTYS 42static struct tty_driver *ptm_driver; 43static struct tty_driver *pts_driver; 44static DEFINE_MUTEX(devpts_mutex); 45#endif 46 47static void pty_close(struct tty_struct *tty, struct file *filp) 48{ 49 if (tty->driver->subtype == PTY_TYPE_MASTER) 50 WARN_ON(tty->count > 1); 51 else { 52 if (tty_io_error(tty)) 53 return; 54 if (tty->count > 2) 55 return; 56 } 57 set_bit(TTY_IO_ERROR, &tty->flags); 58 wake_up_interruptible(&tty->read_wait); 59 wake_up_interruptible(&tty->write_wait); 60 spin_lock_irq(&tty->ctrl.lock); 61 tty->ctrl.packet = false; 62 spin_unlock_irq(&tty->ctrl.lock); 63 /* Review - krefs on tty_link ?? */ 64 if (!tty->link) 65 return; 66 set_bit(TTY_OTHER_CLOSED, &tty->link->flags); 67 wake_up_interruptible(&tty->link->read_wait); 68 wake_up_interruptible(&tty->link->write_wait); 69 if (tty->driver->subtype == PTY_TYPE_MASTER) { 70 set_bit(TTY_OTHER_CLOSED, &tty->flags); 71#ifdef CONFIG_UNIX98_PTYS 72 if (tty->driver == ptm_driver) { 73 mutex_lock(&devpts_mutex); 74 if (tty->link->driver_data) 75 devpts_pty_kill(tty->link->driver_data); 76 mutex_unlock(&devpts_mutex); 77 } 78#endif 79 tty_vhangup(tty->link); 80 } 81} 82 83/* 84 * The unthrottle routine is called by the line discipline to signal 85 * that it can receive more characters. For PTY's, the TTY_THROTTLED 86 * flag is always set, to force the line discipline to always call the 87 * unthrottle routine when there are fewer than TTY_THRESHOLD_UNTHROTTLE 88 * characters in the queue. This is necessary since each time this 89 * happens, we need to wake up any sleeping processes that could be 90 * (1) trying to send data to the pty, or (2) waiting in wait_until_sent() 91 * for the pty buffer to be drained. 92 */ 93static void pty_unthrottle(struct tty_struct *tty) 94{ 95 tty_wakeup(tty->link); 96 set_bit(TTY_THROTTLED, &tty->flags); 97} 98 99/** 100 * pty_write - write to a pty 101 * @tty: the tty we write from 102 * @buf: kernel buffer of data 103 * @c: bytes to write 104 * 105 * Our "hardware" write method. Data is coming from the ldisc which 106 * may be in a non sleeping state. We simply throw this at the other 107 * end of the link as if we were an IRQ handler receiving stuff for 108 * the other side of the pty/tty pair. 109 */ 110 111static int pty_write(struct tty_struct *tty, const unsigned char *buf, int c) 112{ 113 struct tty_struct *to = tty->link; 114 unsigned long flags; 115 116 if (tty->flow.stopped) 117 return 0; 118 119 if (c > 0) { 120 spin_lock_irqsave(&to->port->lock, flags); 121 /* Stuff the data into the input queue of the other end */ 122 c = tty_insert_flip_string(to->port, buf, c); 123 spin_unlock_irqrestore(&to->port->lock, flags); 124 /* And shovel */ 125 if (c) 126 tty_flip_buffer_push(to->port); 127 } 128 return c; 129} 130 131/** 132 * pty_write_room - write space 133 * @tty: tty we are writing from 134 * 135 * Report how many bytes the ldisc can send into the queue for 136 * the other device. 137 */ 138 139static unsigned int pty_write_room(struct tty_struct *tty) 140{ 141 if (tty->flow.stopped) 142 return 0; 143 return tty_buffer_space_avail(tty->link->port); 144} 145 146/* Set the lock flag on a pty */ 147static int pty_set_lock(struct tty_struct *tty, int __user *arg) 148{ 149 int val; 150 151 if (get_user(val, arg)) 152 return -EFAULT; 153 if (val) 154 set_bit(TTY_PTY_LOCK, &tty->flags); 155 else 156 clear_bit(TTY_PTY_LOCK, &tty->flags); 157 return 0; 158} 159 160static int pty_get_lock(struct tty_struct *tty, int __user *arg) 161{ 162 int locked = test_bit(TTY_PTY_LOCK, &tty->flags); 163 164 return put_user(locked, arg); 165} 166 167/* Set the packet mode on a pty */ 168static int pty_set_pktmode(struct tty_struct *tty, int __user *arg) 169{ 170 int pktmode; 171 172 if (get_user(pktmode, arg)) 173 return -EFAULT; 174 175 spin_lock_irq(&tty->ctrl.lock); 176 if (pktmode) { 177 if (!tty->ctrl.packet) { 178 tty->link->ctrl.pktstatus = 0; 179 smp_mb(); 180 tty->ctrl.packet = true; 181 } 182 } else 183 tty->ctrl.packet = false; 184 spin_unlock_irq(&tty->ctrl.lock); 185 186 return 0; 187} 188 189/* Get the packet mode of a pty */ 190static int pty_get_pktmode(struct tty_struct *tty, int __user *arg) 191{ 192 int pktmode = tty->ctrl.packet; 193 194 return put_user(pktmode, arg); 195} 196 197/* Send a signal to the slave */ 198static int pty_signal(struct tty_struct *tty, int sig) 199{ 200 struct pid *pgrp; 201 202 if (sig != SIGINT && sig != SIGQUIT && sig != SIGTSTP) 203 return -EINVAL; 204 205 if (tty->link) { 206 pgrp = tty_get_pgrp(tty->link); 207 if (pgrp) 208 kill_pgrp(pgrp, sig, 1); 209 put_pid(pgrp); 210 } 211 return 0; 212} 213 214static void pty_flush_buffer(struct tty_struct *tty) 215{ 216 struct tty_struct *to = tty->link; 217 218 if (!to) 219 return; 220 221 tty_buffer_flush(to, NULL); 222 if (to->ctrl.packet) { 223 spin_lock_irq(&tty->ctrl.lock); 224 tty->ctrl.pktstatus |= TIOCPKT_FLUSHWRITE; 225 wake_up_interruptible(&to->read_wait); 226 spin_unlock_irq(&tty->ctrl.lock); 227 } 228} 229 230static int pty_open(struct tty_struct *tty, struct file *filp) 231{ 232 if (!tty || !tty->link) 233 return -ENODEV; 234 235 if (test_bit(TTY_OTHER_CLOSED, &tty->flags)) 236 goto out; 237 if (test_bit(TTY_PTY_LOCK, &tty->link->flags)) 238 goto out; 239 if (tty->driver->subtype == PTY_TYPE_SLAVE && tty->link->count != 1) 240 goto out; 241 242 clear_bit(TTY_IO_ERROR, &tty->flags); 243 clear_bit(TTY_OTHER_CLOSED, &tty->link->flags); 244 set_bit(TTY_THROTTLED, &tty->flags); 245 return 0; 246 247out: 248 set_bit(TTY_IO_ERROR, &tty->flags); 249 return -EIO; 250} 251 252static void pty_set_termios(struct tty_struct *tty, 253 struct ktermios *old_termios) 254{ 255 /* See if packet mode change of state. */ 256 if (tty->link && tty->link->ctrl.packet) { 257 int extproc = (old_termios->c_lflag & EXTPROC) | L_EXTPROC(tty); 258 int old_flow = ((old_termios->c_iflag & IXON) && 259 (old_termios->c_cc[VSTOP] == '\023') && 260 (old_termios->c_cc[VSTART] == '\021')); 261 int new_flow = (I_IXON(tty) && 262 STOP_CHAR(tty) == '\023' && 263 START_CHAR(tty) == '\021'); 264 if ((old_flow != new_flow) || extproc) { 265 spin_lock_irq(&tty->ctrl.lock); 266 if (old_flow != new_flow) { 267 tty->ctrl.pktstatus &= ~(TIOCPKT_DOSTOP | TIOCPKT_NOSTOP); 268 if (new_flow) 269 tty->ctrl.pktstatus |= TIOCPKT_DOSTOP; 270 else 271 tty->ctrl.pktstatus |= TIOCPKT_NOSTOP; 272 } 273 if (extproc) 274 tty->ctrl.pktstatus |= TIOCPKT_IOCTL; 275 spin_unlock_irq(&tty->ctrl.lock); 276 wake_up_interruptible(&tty->link->read_wait); 277 } 278 } 279 280 tty->termios.c_cflag &= ~(CSIZE | PARENB); 281 tty->termios.c_cflag |= (CS8 | CREAD); 282} 283 284/** 285 * pty_resize - resize event 286 * @tty: tty being resized 287 * @ws: window size being set. 288 * 289 * Update the termios variables and send the necessary signals to 290 * peform a terminal resize correctly 291 */ 292 293static int pty_resize(struct tty_struct *tty, struct winsize *ws) 294{ 295 struct pid *pgrp, *rpgrp; 296 struct tty_struct *pty = tty->link; 297 298 /* For a PTY we need to lock the tty side */ 299 mutex_lock(&tty->winsize_mutex); 300 if (!memcmp(ws, &tty->winsize, sizeof(*ws))) 301 goto done; 302 303 /* Signal the foreground process group of both ptys */ 304 pgrp = tty_get_pgrp(tty); 305 rpgrp = tty_get_pgrp(pty); 306 307 if (pgrp) 308 kill_pgrp(pgrp, SIGWINCH, 1); 309 if (rpgrp != pgrp && rpgrp) 310 kill_pgrp(rpgrp, SIGWINCH, 1); 311 312 put_pid(pgrp); 313 put_pid(rpgrp); 314 315 tty->winsize = *ws; 316 pty->winsize = *ws; /* Never used so will go away soon */ 317done: 318 mutex_unlock(&tty->winsize_mutex); 319 return 0; 320} 321 322/** 323 * pty_start - start() handler 324 * pty_stop - stop() handler 325 * @tty: tty being flow-controlled 326 * 327 * Propagates the TIOCPKT status to the master pty. 328 * 329 * NB: only the master pty can be in packet mode so only the slave 330 * needs start()/stop() handlers 331 */ 332static void pty_start(struct tty_struct *tty) 333{ 334 unsigned long flags; 335 336 if (tty->link && tty->link->ctrl.packet) { 337 spin_lock_irqsave(&tty->ctrl.lock, flags); 338 tty->ctrl.pktstatus &= ~TIOCPKT_STOP; 339 tty->ctrl.pktstatus |= TIOCPKT_START; 340 spin_unlock_irqrestore(&tty->ctrl.lock, flags); 341 wake_up_interruptible_poll(&tty->link->read_wait, EPOLLIN); 342 } 343} 344 345static void pty_stop(struct tty_struct *tty) 346{ 347 unsigned long flags; 348 349 if (tty->link && tty->link->ctrl.packet) { 350 spin_lock_irqsave(&tty->ctrl.lock, flags); 351 tty->ctrl.pktstatus &= ~TIOCPKT_START; 352 tty->ctrl.pktstatus |= TIOCPKT_STOP; 353 spin_unlock_irqrestore(&tty->ctrl.lock, flags); 354 wake_up_interruptible_poll(&tty->link->read_wait, EPOLLIN); 355 } 356} 357 358/** 359 * pty_common_install - set up the pty pair 360 * @driver: the pty driver 361 * @tty: the tty being instantiated 362 * @legacy: true if this is BSD style 363 * 364 * Perform the initial set up for the tty/pty pair. Called from the 365 * tty layer when the port is first opened. 366 * 367 * Locking: the caller must hold the tty_mutex 368 */ 369static int pty_common_install(struct tty_driver *driver, struct tty_struct *tty, 370 bool legacy) 371{ 372 struct tty_struct *o_tty; 373 struct tty_port *ports[2]; 374 int idx = tty->index; 375 int retval = -ENOMEM; 376 377 /* Opening the slave first has always returned -EIO */ 378 if (driver->subtype != PTY_TYPE_MASTER) 379 return -EIO; 380 381 ports[0] = kmalloc(sizeof **ports, GFP_KERNEL); 382 ports[1] = kmalloc(sizeof **ports, GFP_KERNEL); 383 if (!ports[0] || !ports[1]) 384 goto err; 385 if (!try_module_get(driver->other->owner)) { 386 /* This cannot in fact currently happen */ 387 goto err; 388 } 389 o_tty = alloc_tty_struct(driver->other, idx); 390 if (!o_tty) 391 goto err_put_module; 392 393 tty_set_lock_subclass(o_tty); 394 lockdep_set_subclass(&o_tty->termios_rwsem, TTY_LOCK_SLAVE); 395 396 if (legacy) { 397 /* We always use new tty termios data so we can do this 398 the easy way .. */ 399 tty_init_termios(tty); 400 tty_init_termios(o_tty); 401 402 driver->other->ttys[idx] = o_tty; 403 driver->ttys[idx] = tty; 404 } else { 405 memset(&tty->termios_locked, 0, sizeof(tty->termios_locked)); 406 tty->termios = driver->init_termios; 407 memset(&o_tty->termios_locked, 0, sizeof(tty->termios_locked)); 408 o_tty->termios = driver->other->init_termios; 409 } 410 411 /* 412 * Everything allocated ... set up the o_tty structure. 413 */ 414 tty_driver_kref_get(driver->other); 415 /* Establish the links in both directions */ 416 tty->link = o_tty; 417 o_tty->link = tty; 418 tty_port_init(ports[0]); 419 tty_port_init(ports[1]); 420 tty_buffer_set_limit(ports[0], 8192); 421 tty_buffer_set_limit(ports[1], 8192); 422 o_tty->port = ports[0]; 423 tty->port = ports[1]; 424 o_tty->port->itty = o_tty; 425 426 tty_buffer_set_lock_subclass(o_tty->port); 427 428 tty_driver_kref_get(driver); 429 tty->count++; 430 o_tty->count++; 431 return 0; 432 433err_put_module: 434 module_put(driver->other->owner); 435err: 436 kfree(ports[0]); 437 kfree(ports[1]); 438 return retval; 439} 440 441static void pty_cleanup(struct tty_struct *tty) 442{ 443 tty_port_put(tty->port); 444} 445 446/* Traditional BSD devices */ 447#ifdef CONFIG_LEGACY_PTYS 448 449static int pty_install(struct tty_driver *driver, struct tty_struct *tty) 450{ 451 return pty_common_install(driver, tty, true); 452} 453 454static void pty_remove(struct tty_driver *driver, struct tty_struct *tty) 455{ 456 struct tty_struct *pair = tty->link; 457 458 driver->ttys[tty->index] = NULL; 459 if (pair) 460 pair->driver->ttys[pair->index] = NULL; 461} 462 463static int pty_bsd_ioctl(struct tty_struct *tty, 464 unsigned int cmd, unsigned long arg) 465{ 466 switch (cmd) { 467 case TIOCSPTLCK: /* Set PT Lock (disallow slave open) */ 468 return pty_set_lock(tty, (int __user *) arg); 469 case TIOCGPTLCK: /* Get PT Lock status */ 470 return pty_get_lock(tty, (int __user *)arg); 471 case TIOCPKT: /* Set PT packet mode */ 472 return pty_set_pktmode(tty, (int __user *)arg); 473 case TIOCGPKT: /* Get PT packet mode */ 474 return pty_get_pktmode(tty, (int __user *)arg); 475 case TIOCSIG: /* Send signal to other side of pty */ 476 return pty_signal(tty, (int) arg); 477 case TIOCGPTN: /* TTY returns ENOTTY, but glibc expects EINVAL here */ 478 return -EINVAL; 479 } 480 return -ENOIOCTLCMD; 481} 482 483#ifdef CONFIG_COMPAT 484static long pty_bsd_compat_ioctl(struct tty_struct *tty, 485 unsigned int cmd, unsigned long arg) 486{ 487 /* 488 * PTY ioctls don't require any special translation between 32-bit and 489 * 64-bit userspace, they are already compatible. 490 */ 491 return pty_bsd_ioctl(tty, cmd, (unsigned long)compat_ptr(arg)); 492} 493#else 494#define pty_bsd_compat_ioctl NULL 495#endif 496 497static int legacy_count = CONFIG_LEGACY_PTY_COUNT; 498/* 499 * not really modular, but the easiest way to keep compat with existing 500 * bootargs behaviour is to continue using module_param here. 501 */ 502module_param(legacy_count, int, 0); 503 504/* 505 * The master side of a pty can do TIOCSPTLCK and thus 506 * has pty_bsd_ioctl. 507 */ 508static const struct tty_operations master_pty_ops_bsd = { 509 .install = pty_install, 510 .open = pty_open, 511 .close = pty_close, 512 .write = pty_write, 513 .write_room = pty_write_room, 514 .flush_buffer = pty_flush_buffer, 515 .unthrottle = pty_unthrottle, 516 .ioctl = pty_bsd_ioctl, 517 .compat_ioctl = pty_bsd_compat_ioctl, 518 .cleanup = pty_cleanup, 519 .resize = pty_resize, 520 .remove = pty_remove 521}; 522 523static const struct tty_operations slave_pty_ops_bsd = { 524 .install = pty_install, 525 .open = pty_open, 526 .close = pty_close, 527 .write = pty_write, 528 .write_room = pty_write_room, 529 .flush_buffer = pty_flush_buffer, 530 .unthrottle = pty_unthrottle, 531 .set_termios = pty_set_termios, 532 .cleanup = pty_cleanup, 533 .resize = pty_resize, 534 .start = pty_start, 535 .stop = pty_stop, 536 .remove = pty_remove 537}; 538 539static void __init legacy_pty_init(void) 540{ 541 struct tty_driver *pty_driver, *pty_slave_driver; 542 543 if (legacy_count <= 0) 544 return; 545 546 pty_driver = tty_alloc_driver(legacy_count, 547 TTY_DRIVER_RESET_TERMIOS | 548 TTY_DRIVER_REAL_RAW | 549 TTY_DRIVER_DYNAMIC_ALLOC); 550 if (IS_ERR(pty_driver)) 551 panic("Couldn't allocate pty driver"); 552 553 pty_slave_driver = tty_alloc_driver(legacy_count, 554 TTY_DRIVER_RESET_TERMIOS | 555 TTY_DRIVER_REAL_RAW | 556 TTY_DRIVER_DYNAMIC_ALLOC); 557 if (IS_ERR(pty_slave_driver)) 558 panic("Couldn't allocate pty slave driver"); 559 560 pty_driver->driver_name = "pty_master"; 561 pty_driver->name = "pty"; 562 pty_driver->major = PTY_MASTER_MAJOR; 563 pty_driver->minor_start = 0; 564 pty_driver->type = TTY_DRIVER_TYPE_PTY; 565 pty_driver->subtype = PTY_TYPE_MASTER; 566 pty_driver->init_termios = tty_std_termios; 567 pty_driver->init_termios.c_iflag = 0; 568 pty_driver->init_termios.c_oflag = 0; 569 pty_driver->init_termios.c_cflag = B38400 | CS8 | CREAD; 570 pty_driver->init_termios.c_lflag = 0; 571 pty_driver->init_termios.c_ispeed = 38400; 572 pty_driver->init_termios.c_ospeed = 38400; 573 pty_driver->other = pty_slave_driver; 574 tty_set_operations(pty_driver, &master_pty_ops_bsd); 575 576 pty_slave_driver->driver_name = "pty_slave"; 577 pty_slave_driver->name = "ttyp"; 578 pty_slave_driver->major = PTY_SLAVE_MAJOR; 579 pty_slave_driver->minor_start = 0; 580 pty_slave_driver->type = TTY_DRIVER_TYPE_PTY; 581 pty_slave_driver->subtype = PTY_TYPE_SLAVE; 582 pty_slave_driver->init_termios = tty_std_termios; 583 pty_slave_driver->init_termios.c_cflag = B38400 | CS8 | CREAD; 584 pty_slave_driver->init_termios.c_ispeed = 38400; 585 pty_slave_driver->init_termios.c_ospeed = 38400; 586 pty_slave_driver->other = pty_driver; 587 tty_set_operations(pty_slave_driver, &slave_pty_ops_bsd); 588 589 if (tty_register_driver(pty_driver)) 590 panic("Couldn't register pty driver"); 591 if (tty_register_driver(pty_slave_driver)) 592 panic("Couldn't register pty slave driver"); 593} 594#else 595static inline void legacy_pty_init(void) { } 596#endif 597 598/* Unix98 devices */ 599#ifdef CONFIG_UNIX98_PTYS 600static struct cdev ptmx_cdev; 601 602/** 603 * ptm_open_peer - open the peer of a pty 604 * @master: the open struct file of the ptmx device node 605 * @tty: the master of the pty being opened 606 * @flags: the flags for open 607 * 608 * Provide a race free way for userspace to open the slave end of a pty 609 * (where they have the master fd and cannot access or trust the mount 610 * namespace /dev/pts was mounted inside). 611 */ 612int ptm_open_peer(struct file *master, struct tty_struct *tty, int flags) 613{ 614 int fd; 615 struct file *filp; 616 int retval = -EINVAL; 617 struct path path; 618 619 if (tty->driver != ptm_driver) 620 return -EIO; 621 622 fd = get_unused_fd_flags(flags); 623 if (fd < 0) { 624 retval = fd; 625 goto err; 626 } 627 628 /* Compute the slave's path */ 629 path.mnt = devpts_mntget(master, tty->driver_data); 630 if (IS_ERR(path.mnt)) { 631 retval = PTR_ERR(path.mnt); 632 goto err_put; 633 } 634 path.dentry = tty->link->driver_data; 635 636 filp = dentry_open(&path, flags, current_cred()); 637 mntput(path.mnt); 638 if (IS_ERR(filp)) { 639 retval = PTR_ERR(filp); 640 goto err_put; 641 } 642 643 fd_install(fd, filp); 644 return fd; 645 646err_put: 647 put_unused_fd(fd); 648err: 649 return retval; 650} 651 652static int pty_unix98_ioctl(struct tty_struct *tty, 653 unsigned int cmd, unsigned long arg) 654{ 655 switch (cmd) { 656 case TIOCSPTLCK: /* Set PT Lock (disallow slave open) */ 657 return pty_set_lock(tty, (int __user *)arg); 658 case TIOCGPTLCK: /* Get PT Lock status */ 659 return pty_get_lock(tty, (int __user *)arg); 660 case TIOCPKT: /* Set PT packet mode */ 661 return pty_set_pktmode(tty, (int __user *)arg); 662 case TIOCGPKT: /* Get PT packet mode */ 663 return pty_get_pktmode(tty, (int __user *)arg); 664 case TIOCGPTN: /* Get PT Number */ 665 return put_user(tty->index, (unsigned int __user *)arg); 666 case TIOCSIG: /* Send signal to other side of pty */ 667 return pty_signal(tty, (int) arg); 668 } 669 670 return -ENOIOCTLCMD; 671} 672 673#ifdef CONFIG_COMPAT 674static long pty_unix98_compat_ioctl(struct tty_struct *tty, 675 unsigned int cmd, unsigned long arg) 676{ 677 /* 678 * PTY ioctls don't require any special translation between 32-bit and 679 * 64-bit userspace, they are already compatible. 680 */ 681 return pty_unix98_ioctl(tty, cmd, 682 cmd == TIOCSIG ? arg : (unsigned long)compat_ptr(arg)); 683} 684#else 685#define pty_unix98_compat_ioctl NULL 686#endif 687 688/** 689 * ptm_unix98_lookup - find a pty master 690 * @driver: ptm driver 691 * @file: unused 692 * @idx: tty index 693 * 694 * Look up a pty master device. Called under the tty_mutex for now. 695 * This provides our locking. 696 */ 697 698static struct tty_struct *ptm_unix98_lookup(struct tty_driver *driver, 699 struct file *file, int idx) 700{ 701 /* Master must be open via /dev/ptmx */ 702 return ERR_PTR(-EIO); 703} 704 705/** 706 * pts_unix98_lookup - find a pty slave 707 * @driver: pts driver 708 * @file: file pointer to tty 709 * @idx: tty index 710 * 711 * Look up a pty master device. Called under the tty_mutex for now. 712 * This provides our locking for the tty pointer. 713 */ 714 715static struct tty_struct *pts_unix98_lookup(struct tty_driver *driver, 716 struct file *file, int idx) 717{ 718 struct tty_struct *tty; 719 720 mutex_lock(&devpts_mutex); 721 tty = devpts_get_priv(file->f_path.dentry); 722 mutex_unlock(&devpts_mutex); 723 /* Master must be open before slave */ 724 if (!tty) 725 return ERR_PTR(-EIO); 726 return tty; 727} 728 729static int pty_unix98_install(struct tty_driver *driver, struct tty_struct *tty) 730{ 731 return pty_common_install(driver, tty, false); 732} 733 734/* this is called once with whichever end is closed last */ 735static void pty_unix98_remove(struct tty_driver *driver, struct tty_struct *tty) 736{ 737 struct pts_fs_info *fsi; 738 739 if (tty->driver->subtype == PTY_TYPE_MASTER) 740 fsi = tty->driver_data; 741 else 742 fsi = tty->link->driver_data; 743 744 if (fsi) { 745 devpts_kill_index(fsi, tty->index); 746 devpts_release(fsi); 747 } 748} 749 750static void pty_show_fdinfo(struct tty_struct *tty, struct seq_file *m) 751{ 752 seq_printf(m, "tty-index:\t%d\n", tty->index); 753} 754 755static const struct tty_operations ptm_unix98_ops = { 756 .lookup = ptm_unix98_lookup, 757 .install = pty_unix98_install, 758 .remove = pty_unix98_remove, 759 .open = pty_open, 760 .close = pty_close, 761 .write = pty_write, 762 .write_room = pty_write_room, 763 .flush_buffer = pty_flush_buffer, 764 .unthrottle = pty_unthrottle, 765 .ioctl = pty_unix98_ioctl, 766 .compat_ioctl = pty_unix98_compat_ioctl, 767 .resize = pty_resize, 768 .cleanup = pty_cleanup, 769 .show_fdinfo = pty_show_fdinfo, 770}; 771 772static const struct tty_operations pty_unix98_ops = { 773 .lookup = pts_unix98_lookup, 774 .install = pty_unix98_install, 775 .remove = pty_unix98_remove, 776 .open = pty_open, 777 .close = pty_close, 778 .write = pty_write, 779 .write_room = pty_write_room, 780 .flush_buffer = pty_flush_buffer, 781 .unthrottle = pty_unthrottle, 782 .set_termios = pty_set_termios, 783 .start = pty_start, 784 .stop = pty_stop, 785 .cleanup = pty_cleanup, 786}; 787 788/** 789 * ptmx_open - open a unix 98 pty master 790 * @inode: inode of device file 791 * @filp: file pointer to tty 792 * 793 * Allocate a unix98 pty master device from the ptmx driver. 794 * 795 * Locking: tty_mutex protects the init_dev work. tty->count should 796 * protect the rest. 797 * allocated_ptys_lock handles the list of free pty numbers 798 */ 799 800static int ptmx_open(struct inode *inode, struct file *filp) 801{ 802 struct pts_fs_info *fsi; 803 struct tty_struct *tty; 804 struct dentry *dentry; 805 int retval; 806 int index; 807 808 nonseekable_open(inode, filp); 809 810 /* We refuse fsnotify events on ptmx, since it's a shared resource */ 811 filp->f_mode |= FMODE_NONOTIFY; 812 813 retval = tty_alloc_file(filp); 814 if (retval) 815 return retval; 816 817 fsi = devpts_acquire(filp); 818 if (IS_ERR(fsi)) { 819 retval = PTR_ERR(fsi); 820 goto out_free_file; 821 } 822 823 /* find a device that is not in use. */ 824 mutex_lock(&devpts_mutex); 825 index = devpts_new_index(fsi); 826 mutex_unlock(&devpts_mutex); 827 828 retval = index; 829 if (index < 0) 830 goto out_put_fsi; 831 832 833 mutex_lock(&tty_mutex); 834 tty = tty_init_dev(ptm_driver, index); 835 /* The tty returned here is locked so we can safely 836 drop the mutex */ 837 mutex_unlock(&tty_mutex); 838 839 retval = PTR_ERR(tty); 840 if (IS_ERR(tty)) 841 goto out; 842 843 /* 844 * From here on out, the tty is "live", and the index and 845 * fsi will be killed/put by the tty_release() 846 */ 847 set_bit(TTY_PTY_LOCK, &tty->flags); /* LOCK THE SLAVE */ 848 tty->driver_data = fsi; 849 850 tty_add_file(tty, filp); 851 852 dentry = devpts_pty_new(fsi, index, tty->link); 853 if (IS_ERR(dentry)) { 854 retval = PTR_ERR(dentry); 855 goto err_release; 856 } 857 tty->link->driver_data = dentry; 858 859 retval = ptm_driver->ops->open(tty, filp); 860 if (retval) 861 goto err_release; 862 863 tty_debug_hangup(tty, "opening (count=%d)\n", tty->count); 864 865 tty_unlock(tty); 866 return 0; 867err_release: 868 tty_unlock(tty); 869 // This will also put-ref the fsi 870 tty_release(inode, filp); 871 return retval; 872out: 873 devpts_kill_index(fsi, index); 874out_put_fsi: 875 devpts_release(fsi); 876out_free_file: 877 tty_free_file(filp); 878 return retval; 879} 880 881static struct file_operations ptmx_fops __ro_after_init; 882 883static void __init unix98_pty_init(void) 884{ 885 ptm_driver = tty_alloc_driver(NR_UNIX98_PTY_MAX, 886 TTY_DRIVER_RESET_TERMIOS | 887 TTY_DRIVER_REAL_RAW | 888 TTY_DRIVER_DYNAMIC_DEV | 889 TTY_DRIVER_DEVPTS_MEM | 890 TTY_DRIVER_DYNAMIC_ALLOC); 891 if (IS_ERR(ptm_driver)) 892 panic("Couldn't allocate Unix98 ptm driver"); 893 pts_driver = tty_alloc_driver(NR_UNIX98_PTY_MAX, 894 TTY_DRIVER_RESET_TERMIOS | 895 TTY_DRIVER_REAL_RAW | 896 TTY_DRIVER_DYNAMIC_DEV | 897 TTY_DRIVER_DEVPTS_MEM | 898 TTY_DRIVER_DYNAMIC_ALLOC); 899 if (IS_ERR(pts_driver)) 900 panic("Couldn't allocate Unix98 pts driver"); 901 902 ptm_driver->driver_name = "pty_master"; 903 ptm_driver->name = "ptm"; 904 ptm_driver->major = UNIX98_PTY_MASTER_MAJOR; 905 ptm_driver->minor_start = 0; 906 ptm_driver->type = TTY_DRIVER_TYPE_PTY; 907 ptm_driver->subtype = PTY_TYPE_MASTER; 908 ptm_driver->init_termios = tty_std_termios; 909 ptm_driver->init_termios.c_iflag = 0; 910 ptm_driver->init_termios.c_oflag = 0; 911 ptm_driver->init_termios.c_cflag = B38400 | CS8 | CREAD; 912 ptm_driver->init_termios.c_lflag = 0; 913 ptm_driver->init_termios.c_ispeed = 38400; 914 ptm_driver->init_termios.c_ospeed = 38400; 915 ptm_driver->other = pts_driver; 916 tty_set_operations(ptm_driver, &ptm_unix98_ops); 917 918 pts_driver->driver_name = "pty_slave"; 919 pts_driver->name = "pts"; 920 pts_driver->major = UNIX98_PTY_SLAVE_MAJOR; 921 pts_driver->minor_start = 0; 922 pts_driver->type = TTY_DRIVER_TYPE_PTY; 923 pts_driver->subtype = PTY_TYPE_SLAVE; 924 pts_driver->init_termios = tty_std_termios; 925 pts_driver->init_termios.c_cflag = B38400 | CS8 | CREAD; 926 pts_driver->init_termios.c_ispeed = 38400; 927 pts_driver->init_termios.c_ospeed = 38400; 928 pts_driver->other = ptm_driver; 929 tty_set_operations(pts_driver, &pty_unix98_ops); 930 931 if (tty_register_driver(ptm_driver)) 932 panic("Couldn't register Unix98 ptm driver"); 933 if (tty_register_driver(pts_driver)) 934 panic("Couldn't register Unix98 pts driver"); 935 936 /* Now create the /dev/ptmx special device */ 937 tty_default_fops(&ptmx_fops); 938 ptmx_fops.open = ptmx_open; 939 940 cdev_init(&ptmx_cdev, &ptmx_fops); 941 if (cdev_add(&ptmx_cdev, MKDEV(TTYAUX_MAJOR, 2), 1) || 942 register_chrdev_region(MKDEV(TTYAUX_MAJOR, 2), 1, "/dev/ptmx") < 0) 943 panic("Couldn't register /dev/ptmx driver"); 944 device_create(tty_class, NULL, MKDEV(TTYAUX_MAJOR, 2), NULL, "ptmx"); 945} 946 947#else 948static inline void unix98_pty_init(void) { } 949#endif 950 951static int __init pty_init(void) 952{ 953 legacy_pty_init(); 954 unix98_pty_init(); 955 return 0; 956} 957device_initcall(pty_init);