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