Merge tag 'block-5.11-2021-01-10' of git://git.kernel.dk/linux-block
[linux/fpc-iii.git] / drivers / tty / tty_io.c
blob8034489337d75241b1a42d781839679446e83d82
1 // SPDX-License-Identifier: GPL-2.0
2 /*
3 * Copyright (C) 1991, 1992 Linus Torvalds
4 */
6 /*
7 * 'tty_io.c' gives an orthogonal feeling to tty's, be they consoles
8 * or rs-channels. It also implements echoing, cooked mode etc.
10 * Kill-line thanks to John T Kohl, who also corrected VMIN = VTIME = 0.
12 * Modified by Theodore Ts'o, 9/14/92, to dynamically allocate the
13 * tty_struct and tty_queue structures. Previously there was an array
14 * of 256 tty_struct's which was statically allocated, and the
15 * tty_queue structures were allocated at boot time. Both are now
16 * dynamically allocated only when the tty is open.
18 * Also restructured routines so that there is more of a separation
19 * between the high-level tty routines (tty_io.c and tty_ioctl.c) and
20 * the low-level tty routines (serial.c, pty.c, console.c). This
21 * makes for cleaner and more compact code. -TYT, 9/17/92
23 * Modified by Fred N. van Kempen, 01/29/93, to add line disciplines
24 * which can be dynamically activated and de-activated by the line
25 * discipline handling modules (like SLIP).
27 * NOTE: pay no attention to the line discipline code (yet); its
28 * interface is still subject to change in this version...
29 * -- TYT, 1/31/92
31 * Added functionality to the OPOST tty handling. No delays, but all
32 * other bits should be there.
33 * -- Nick Holloway <alfie@dcs.warwick.ac.uk>, 27th May 1993.
35 * Rewrote canonical mode and added more termios flags.
36 * -- julian@uhunix.uhcc.hawaii.edu (J. Cowley), 13Jan94
38 * Reorganized FASYNC support so mouse code can share it.
39 * -- ctm@ardi.com, 9Sep95
41 * New TIOCLINUX variants added.
42 * -- mj@k332.feld.cvut.cz, 19-Nov-95
44 * Restrict vt switching via ioctl()
45 * -- grif@cs.ucr.edu, 5-Dec-95
47 * Move console and virtual terminal code to more appropriate files,
48 * implement CONFIG_VT and generalize console device interface.
49 * -- Marko Kohtala <Marko.Kohtala@hut.fi>, March 97
51 * Rewrote tty_init_dev and tty_release_dev to eliminate races.
52 * -- Bill Hawes <whawes@star.net>, June 97
54 * Added devfs support.
55 * -- C. Scott Ananian <cananian@alumni.princeton.edu>, 13-Jan-1998
57 * Added support for a Unix98-style ptmx device.
58 * -- C. Scott Ananian <cananian@alumni.princeton.edu>, 14-Jan-1998
60 * Reduced memory usage for older ARM systems
61 * -- Russell King <rmk@arm.linux.org.uk>
63 * Move do_SAK() into process context. Less stack use in devfs functions.
64 * alloc_tty_struct() always uses kmalloc()
65 * -- Andrew Morton <andrewm@uow.edu.eu> 17Mar01
68 #include <linux/types.h>
69 #include <linux/major.h>
70 #include <linux/errno.h>
71 #include <linux/signal.h>
72 #include <linux/fcntl.h>
73 #include <linux/sched/signal.h>
74 #include <linux/sched/task.h>
75 #include <linux/interrupt.h>
76 #include <linux/tty.h>
77 #include <linux/tty_driver.h>
78 #include <linux/tty_flip.h>
79 #include <linux/devpts_fs.h>
80 #include <linux/file.h>
81 #include <linux/fdtable.h>
82 #include <linux/console.h>
83 #include <linux/timer.h>
84 #include <linux/ctype.h>
85 #include <linux/kd.h>
86 #include <linux/mm.h>
87 #include <linux/string.h>
88 #include <linux/slab.h>
89 #include <linux/poll.h>
90 #include <linux/ppp-ioctl.h>
91 #include <linux/proc_fs.h>
92 #include <linux/init.h>
93 #include <linux/module.h>
94 #include <linux/device.h>
95 #include <linux/wait.h>
96 #include <linux/bitops.h>
97 #include <linux/delay.h>
98 #include <linux/seq_file.h>
99 #include <linux/serial.h>
100 #include <linux/ratelimit.h>
101 #include <linux/compat.h>
103 #include <linux/uaccess.h>
105 #include <linux/kbd_kern.h>
106 #include <linux/vt_kern.h>
107 #include <linux/selection.h>
109 #include <linux/kmod.h>
110 #include <linux/nsproxy.h>
112 #undef TTY_DEBUG_HANGUP
113 #ifdef TTY_DEBUG_HANGUP
114 # define tty_debug_hangup(tty, f, args...) tty_debug(tty, f, ##args)
115 #else
116 # define tty_debug_hangup(tty, f, args...) do { } while (0)
117 #endif
119 #define TTY_PARANOIA_CHECK 1
120 #define CHECK_TTY_COUNT 1
122 struct ktermios tty_std_termios = { /* for the benefit of tty drivers */
123 .c_iflag = ICRNL | IXON,
124 .c_oflag = OPOST | ONLCR,
125 .c_cflag = B38400 | CS8 | CREAD | HUPCL,
126 .c_lflag = ISIG | ICANON | ECHO | ECHOE | ECHOK |
127 ECHOCTL | ECHOKE | IEXTEN,
128 .c_cc = INIT_C_CC,
129 .c_ispeed = 38400,
130 .c_ospeed = 38400,
131 /* .c_line = N_TTY, */
134 EXPORT_SYMBOL(tty_std_termios);
136 /* This list gets poked at by procfs and various bits of boot up code. This
137 could do with some rationalisation such as pulling the tty proc function
138 into this file */
140 LIST_HEAD(tty_drivers); /* linked list of tty drivers */
142 /* Mutex to protect creating and releasing a tty */
143 DEFINE_MUTEX(tty_mutex);
145 static ssize_t tty_read(struct file *, char __user *, size_t, loff_t *);
146 static ssize_t tty_write(struct file *, const char __user *, size_t, loff_t *);
147 ssize_t redirected_tty_write(struct file *, const char __user *,
148 size_t, loff_t *);
149 static __poll_t tty_poll(struct file *, poll_table *);
150 static int tty_open(struct inode *, struct file *);
151 long tty_ioctl(struct file *file, unsigned int cmd, unsigned long arg);
152 #ifdef CONFIG_COMPAT
153 static long tty_compat_ioctl(struct file *file, unsigned int cmd,
154 unsigned long arg);
155 #else
156 #define tty_compat_ioctl NULL
157 #endif
158 static int __tty_fasync(int fd, struct file *filp, int on);
159 static int tty_fasync(int fd, struct file *filp, int on);
160 static void release_tty(struct tty_struct *tty, int idx);
163 * free_tty_struct - free a disused tty
164 * @tty: tty struct to free
166 * Free the write buffers, tty queue and tty memory itself.
168 * Locking: none. Must be called after tty is definitely unused
171 static void free_tty_struct(struct tty_struct *tty)
173 tty_ldisc_deinit(tty);
174 put_device(tty->dev);
175 kfree(tty->write_buf);
176 tty->magic = 0xDEADDEAD;
177 kfree(tty);
180 static inline struct tty_struct *file_tty(struct file *file)
182 return ((struct tty_file_private *)file->private_data)->tty;
185 int tty_alloc_file(struct file *file)
187 struct tty_file_private *priv;
189 priv = kmalloc(sizeof(*priv), GFP_KERNEL);
190 if (!priv)
191 return -ENOMEM;
193 file->private_data = priv;
195 return 0;
198 /* Associate a new file with the tty structure */
199 void tty_add_file(struct tty_struct *tty, struct file *file)
201 struct tty_file_private *priv = file->private_data;
203 priv->tty = tty;
204 priv->file = file;
206 spin_lock(&tty->files_lock);
207 list_add(&priv->list, &tty->tty_files);
208 spin_unlock(&tty->files_lock);
212 * tty_free_file - free file->private_data
214 * This shall be used only for fail path handling when tty_add_file was not
215 * called yet.
217 void tty_free_file(struct file *file)
219 struct tty_file_private *priv = file->private_data;
221 file->private_data = NULL;
222 kfree(priv);
225 /* Delete file from its tty */
226 static void tty_del_file(struct file *file)
228 struct tty_file_private *priv = file->private_data;
229 struct tty_struct *tty = priv->tty;
231 spin_lock(&tty->files_lock);
232 list_del(&priv->list);
233 spin_unlock(&tty->files_lock);
234 tty_free_file(file);
238 * tty_name - return tty naming
239 * @tty: tty structure
241 * Convert a tty structure into a name. The name reflects the kernel
242 * naming policy and if udev is in use may not reflect user space
244 * Locking: none
247 const char *tty_name(const struct tty_struct *tty)
249 if (!tty) /* Hmm. NULL pointer. That's fun. */
250 return "NULL tty";
251 return tty->name;
254 EXPORT_SYMBOL(tty_name);
256 const char *tty_driver_name(const struct tty_struct *tty)
258 if (!tty || !tty->driver)
259 return "";
260 return tty->driver->name;
263 static int tty_paranoia_check(struct tty_struct *tty, struct inode *inode,
264 const char *routine)
266 #ifdef TTY_PARANOIA_CHECK
267 if (!tty) {
268 pr_warn("(%d:%d): %s: NULL tty\n",
269 imajor(inode), iminor(inode), routine);
270 return 1;
272 if (tty->magic != TTY_MAGIC) {
273 pr_warn("(%d:%d): %s: bad magic number\n",
274 imajor(inode), iminor(inode), routine);
275 return 1;
277 #endif
278 return 0;
281 /* Caller must hold tty_lock */
282 static int check_tty_count(struct tty_struct *tty, const char *routine)
284 #ifdef CHECK_TTY_COUNT
285 struct list_head *p;
286 int count = 0, kopen_count = 0;
288 spin_lock(&tty->files_lock);
289 list_for_each(p, &tty->tty_files) {
290 count++;
292 spin_unlock(&tty->files_lock);
293 if (tty->driver->type == TTY_DRIVER_TYPE_PTY &&
294 tty->driver->subtype == PTY_TYPE_SLAVE &&
295 tty->link && tty->link->count)
296 count++;
297 if (tty_port_kopened(tty->port))
298 kopen_count++;
299 if (tty->count != (count + kopen_count)) {
300 tty_warn(tty, "%s: tty->count(%d) != (#fd's(%d) + #kopen's(%d))\n",
301 routine, tty->count, count, kopen_count);
302 return (count + kopen_count);
304 #endif
305 return 0;
309 * get_tty_driver - find device of a tty
310 * @device: device identifier
311 * @index: returns the index of the tty
313 * This routine returns a tty driver structure, given a device number
314 * and also passes back the index number.
316 * Locking: caller must hold tty_mutex
319 static struct tty_driver *get_tty_driver(dev_t device, int *index)
321 struct tty_driver *p;
323 list_for_each_entry(p, &tty_drivers, tty_drivers) {
324 dev_t base = MKDEV(p->major, p->minor_start);
325 if (device < base || device >= base + p->num)
326 continue;
327 *index = device - base;
328 return tty_driver_kref_get(p);
330 return NULL;
334 * tty_dev_name_to_number - return dev_t for device name
335 * @name: user space name of device under /dev
336 * @number: pointer to dev_t that this function will populate
338 * This function converts device names like ttyS0 or ttyUSB1 into dev_t
339 * like (4, 64) or (188, 1). If no corresponding driver is registered then
340 * the function returns -ENODEV.
342 * Locking: this acquires tty_mutex to protect the tty_drivers list from
343 * being modified while we are traversing it, and makes sure to
344 * release it before exiting.
346 int tty_dev_name_to_number(const char *name, dev_t *number)
348 struct tty_driver *p;
349 int ret;
350 int index, prefix_length = 0;
351 const char *str;
353 for (str = name; *str && !isdigit(*str); str++)
356 if (!*str)
357 return -EINVAL;
359 ret = kstrtoint(str, 10, &index);
360 if (ret)
361 return ret;
363 prefix_length = str - name;
364 mutex_lock(&tty_mutex);
366 list_for_each_entry(p, &tty_drivers, tty_drivers)
367 if (prefix_length == strlen(p->name) && strncmp(name,
368 p->name, prefix_length) == 0) {
369 if (index < p->num) {
370 *number = MKDEV(p->major, p->minor_start + index);
371 goto out;
375 /* if here then driver wasn't found */
376 ret = -ENODEV;
377 out:
378 mutex_unlock(&tty_mutex);
379 return ret;
381 EXPORT_SYMBOL_GPL(tty_dev_name_to_number);
383 #ifdef CONFIG_CONSOLE_POLL
386 * tty_find_polling_driver - find device of a polled tty
387 * @name: name string to match
388 * @line: pointer to resulting tty line nr
390 * This routine returns a tty driver structure, given a name
391 * and the condition that the tty driver is capable of polled
392 * operation.
394 struct tty_driver *tty_find_polling_driver(char *name, int *line)
396 struct tty_driver *p, *res = NULL;
397 int tty_line = 0;
398 int len;
399 char *str, *stp;
401 for (str = name; *str; str++)
402 if ((*str >= '0' && *str <= '9') || *str == ',')
403 break;
404 if (!*str)
405 return NULL;
407 len = str - name;
408 tty_line = simple_strtoul(str, &str, 10);
410 mutex_lock(&tty_mutex);
411 /* Search through the tty devices to look for a match */
412 list_for_each_entry(p, &tty_drivers, tty_drivers) {
413 if (!len || strncmp(name, p->name, len) != 0)
414 continue;
415 stp = str;
416 if (*stp == ',')
417 stp++;
418 if (*stp == '\0')
419 stp = NULL;
421 if (tty_line >= 0 && tty_line < p->num && p->ops &&
422 p->ops->poll_init && !p->ops->poll_init(p, tty_line, stp)) {
423 res = tty_driver_kref_get(p);
424 *line = tty_line;
425 break;
428 mutex_unlock(&tty_mutex);
430 return res;
432 EXPORT_SYMBOL_GPL(tty_find_polling_driver);
433 #endif
435 static ssize_t hung_up_tty_read(struct file *file, char __user *buf,
436 size_t count, loff_t *ppos)
438 return 0;
441 static ssize_t hung_up_tty_write(struct file *file, const char __user *buf,
442 size_t count, loff_t *ppos)
444 return -EIO;
447 /* No kernel lock held - none needed ;) */
448 static __poll_t hung_up_tty_poll(struct file *filp, poll_table *wait)
450 return EPOLLIN | EPOLLOUT | EPOLLERR | EPOLLHUP | EPOLLRDNORM | EPOLLWRNORM;
453 static long hung_up_tty_ioctl(struct file *file, unsigned int cmd,
454 unsigned long arg)
456 return cmd == TIOCSPGRP ? -ENOTTY : -EIO;
459 static long hung_up_tty_compat_ioctl(struct file *file,
460 unsigned int cmd, unsigned long arg)
462 return cmd == TIOCSPGRP ? -ENOTTY : -EIO;
465 static int hung_up_tty_fasync(int fd, struct file *file, int on)
467 return -ENOTTY;
470 static void tty_show_fdinfo(struct seq_file *m, struct file *file)
472 struct tty_struct *tty = file_tty(file);
474 if (tty && tty->ops && tty->ops->show_fdinfo)
475 tty->ops->show_fdinfo(tty, m);
478 static const struct file_operations tty_fops = {
479 .llseek = no_llseek,
480 .read = tty_read,
481 .write = tty_write,
482 .poll = tty_poll,
483 .unlocked_ioctl = tty_ioctl,
484 .compat_ioctl = tty_compat_ioctl,
485 .open = tty_open,
486 .release = tty_release,
487 .fasync = tty_fasync,
488 .show_fdinfo = tty_show_fdinfo,
491 static const struct file_operations console_fops = {
492 .llseek = no_llseek,
493 .read = tty_read,
494 .write = redirected_tty_write,
495 .poll = tty_poll,
496 .unlocked_ioctl = tty_ioctl,
497 .compat_ioctl = tty_compat_ioctl,
498 .open = tty_open,
499 .release = tty_release,
500 .fasync = tty_fasync,
503 static const struct file_operations hung_up_tty_fops = {
504 .llseek = no_llseek,
505 .read = hung_up_tty_read,
506 .write = hung_up_tty_write,
507 .poll = hung_up_tty_poll,
508 .unlocked_ioctl = hung_up_tty_ioctl,
509 .compat_ioctl = hung_up_tty_compat_ioctl,
510 .release = tty_release,
511 .fasync = hung_up_tty_fasync,
514 static DEFINE_SPINLOCK(redirect_lock);
515 static struct file *redirect;
518 * tty_wakeup - request more data
519 * @tty: terminal
521 * Internal and external helper for wakeups of tty. This function
522 * informs the line discipline if present that the driver is ready
523 * to receive more output data.
526 void tty_wakeup(struct tty_struct *tty)
528 struct tty_ldisc *ld;
530 if (test_bit(TTY_DO_WRITE_WAKEUP, &tty->flags)) {
531 ld = tty_ldisc_ref(tty);
532 if (ld) {
533 if (ld->ops->write_wakeup)
534 ld->ops->write_wakeup(tty);
535 tty_ldisc_deref(ld);
538 wake_up_interruptible_poll(&tty->write_wait, EPOLLOUT);
541 EXPORT_SYMBOL_GPL(tty_wakeup);
544 * __tty_hangup - actual handler for hangup events
545 * @tty: tty device
546 * @exit_session: if non-zero, signal all foreground group processes
548 * This can be called by a "kworker" kernel thread. That is process
549 * synchronous but doesn't hold any locks, so we need to make sure we
550 * have the appropriate locks for what we're doing.
552 * The hangup event clears any pending redirections onto the hung up
553 * device. It ensures future writes will error and it does the needed
554 * line discipline hangup and signal delivery. The tty object itself
555 * remains intact.
557 * Locking:
558 * BTM
559 * redirect lock for undoing redirection
560 * file list lock for manipulating list of ttys
561 * tty_ldiscs_lock from called functions
562 * termios_rwsem resetting termios data
563 * tasklist_lock to walk task list for hangup event
564 * ->siglock to protect ->signal/->sighand
566 static void __tty_hangup(struct tty_struct *tty, int exit_session)
568 struct file *cons_filp = NULL;
569 struct file *filp, *f = NULL;
570 struct tty_file_private *priv;
571 int closecount = 0, n;
572 int refs;
574 if (!tty)
575 return;
578 spin_lock(&redirect_lock);
579 if (redirect && file_tty(redirect) == tty) {
580 f = redirect;
581 redirect = NULL;
583 spin_unlock(&redirect_lock);
585 tty_lock(tty);
587 if (test_bit(TTY_HUPPED, &tty->flags)) {
588 tty_unlock(tty);
589 return;
593 * Some console devices aren't actually hung up for technical and
594 * historical reasons, which can lead to indefinite interruptible
595 * sleep in n_tty_read(). The following explicitly tells
596 * n_tty_read() to abort readers.
598 set_bit(TTY_HUPPING, &tty->flags);
600 /* inuse_filps is protected by the single tty lock,
601 this really needs to change if we want to flush the
602 workqueue with the lock held */
603 check_tty_count(tty, "tty_hangup");
605 spin_lock(&tty->files_lock);
606 /* This breaks for file handles being sent over AF_UNIX sockets ? */
607 list_for_each_entry(priv, &tty->tty_files, list) {
608 filp = priv->file;
609 if (filp->f_op->write == redirected_tty_write)
610 cons_filp = filp;
611 if (filp->f_op->write != tty_write)
612 continue;
613 closecount++;
614 __tty_fasync(-1, filp, 0); /* can't block */
615 filp->f_op = &hung_up_tty_fops;
617 spin_unlock(&tty->files_lock);
619 refs = tty_signal_session_leader(tty, exit_session);
620 /* Account for the p->signal references we killed */
621 while (refs--)
622 tty_kref_put(tty);
624 tty_ldisc_hangup(tty, cons_filp != NULL);
626 spin_lock_irq(&tty->ctrl_lock);
627 clear_bit(TTY_THROTTLED, &tty->flags);
628 clear_bit(TTY_DO_WRITE_WAKEUP, &tty->flags);
629 put_pid(tty->session);
630 put_pid(tty->pgrp);
631 tty->session = NULL;
632 tty->pgrp = NULL;
633 tty->ctrl_status = 0;
634 spin_unlock_irq(&tty->ctrl_lock);
637 * If one of the devices matches a console pointer, we
638 * cannot just call hangup() because that will cause
639 * tty->count and state->count to go out of sync.
640 * So we just call close() the right number of times.
642 if (cons_filp) {
643 if (tty->ops->close)
644 for (n = 0; n < closecount; n++)
645 tty->ops->close(tty, cons_filp);
646 } else if (tty->ops->hangup)
647 tty->ops->hangup(tty);
649 * We don't want to have driver/ldisc interactions beyond the ones
650 * we did here. The driver layer expects no calls after ->hangup()
651 * from the ldisc side, which is now guaranteed.
653 set_bit(TTY_HUPPED, &tty->flags);
654 clear_bit(TTY_HUPPING, &tty->flags);
655 tty_unlock(tty);
657 if (f)
658 fput(f);
661 static void do_tty_hangup(struct work_struct *work)
663 struct tty_struct *tty =
664 container_of(work, struct tty_struct, hangup_work);
666 __tty_hangup(tty, 0);
670 * tty_hangup - trigger a hangup event
671 * @tty: tty to hangup
673 * A carrier loss (virtual or otherwise) has occurred on this like
674 * schedule a hangup sequence to run after this event.
677 void tty_hangup(struct tty_struct *tty)
679 tty_debug_hangup(tty, "hangup\n");
680 schedule_work(&tty->hangup_work);
683 EXPORT_SYMBOL(tty_hangup);
686 * tty_vhangup - process vhangup
687 * @tty: tty to hangup
689 * The user has asked via system call for the terminal to be hung up.
690 * We do this synchronously so that when the syscall returns the process
691 * is complete. That guarantee is necessary for security reasons.
694 void tty_vhangup(struct tty_struct *tty)
696 tty_debug_hangup(tty, "vhangup\n");
697 __tty_hangup(tty, 0);
700 EXPORT_SYMBOL(tty_vhangup);
704 * tty_vhangup_self - process vhangup for own ctty
706 * Perform a vhangup on the current controlling tty
709 void tty_vhangup_self(void)
711 struct tty_struct *tty;
713 tty = get_current_tty();
714 if (tty) {
715 tty_vhangup(tty);
716 tty_kref_put(tty);
721 * tty_vhangup_session - hangup session leader exit
722 * @tty: tty to hangup
724 * The session leader is exiting and hanging up its controlling terminal.
725 * Every process in the foreground process group is signalled SIGHUP.
727 * We do this synchronously so that when the syscall returns the process
728 * is complete. That guarantee is necessary for security reasons.
731 void tty_vhangup_session(struct tty_struct *tty)
733 tty_debug_hangup(tty, "session hangup\n");
734 __tty_hangup(tty, 1);
738 * tty_hung_up_p - was tty hung up
739 * @filp: file pointer of tty
741 * Return true if the tty has been subject to a vhangup or a carrier
742 * loss
745 int tty_hung_up_p(struct file *filp)
747 return (filp && filp->f_op == &hung_up_tty_fops);
750 EXPORT_SYMBOL(tty_hung_up_p);
753 * stop_tty - propagate flow control
754 * @tty: tty to stop
756 * Perform flow control to the driver. May be called
757 * on an already stopped device and will not re-call the driver
758 * method.
760 * This functionality is used by both the line disciplines for
761 * halting incoming flow and by the driver. It may therefore be
762 * called from any context, may be under the tty atomic_write_lock
763 * but not always.
765 * Locking:
766 * flow_lock
769 void __stop_tty(struct tty_struct *tty)
771 if (tty->stopped)
772 return;
773 tty->stopped = 1;
774 if (tty->ops->stop)
775 tty->ops->stop(tty);
778 void stop_tty(struct tty_struct *tty)
780 unsigned long flags;
782 spin_lock_irqsave(&tty->flow_lock, flags);
783 __stop_tty(tty);
784 spin_unlock_irqrestore(&tty->flow_lock, flags);
786 EXPORT_SYMBOL(stop_tty);
789 * start_tty - propagate flow control
790 * @tty: tty to start
792 * Start a tty that has been stopped if at all possible. If this
793 * tty was previous stopped and is now being started, the driver
794 * start method is invoked and the line discipline woken.
796 * Locking:
797 * flow_lock
800 void __start_tty(struct tty_struct *tty)
802 if (!tty->stopped || tty->flow_stopped)
803 return;
804 tty->stopped = 0;
805 if (tty->ops->start)
806 tty->ops->start(tty);
807 tty_wakeup(tty);
810 void start_tty(struct tty_struct *tty)
812 unsigned long flags;
814 spin_lock_irqsave(&tty->flow_lock, flags);
815 __start_tty(tty);
816 spin_unlock_irqrestore(&tty->flow_lock, flags);
818 EXPORT_SYMBOL(start_tty);
820 static void tty_update_time(struct timespec64 *time)
822 time64_t sec = ktime_get_real_seconds();
825 * We only care if the two values differ in anything other than the
826 * lower three bits (i.e every 8 seconds). If so, then we can update
827 * the time of the tty device, otherwise it could be construded as a
828 * security leak to let userspace know the exact timing of the tty.
830 if ((sec ^ time->tv_sec) & ~7)
831 time->tv_sec = sec;
835 * tty_read - read method for tty device files
836 * @file: pointer to tty file
837 * @buf: user buffer
838 * @count: size of user buffer
839 * @ppos: unused
841 * Perform the read system call function on this terminal device. Checks
842 * for hung up devices before calling the line discipline method.
844 * Locking:
845 * Locks the line discipline internally while needed. Multiple
846 * read calls may be outstanding in parallel.
849 static ssize_t tty_read(struct file *file, char __user *buf, size_t count,
850 loff_t *ppos)
852 int i;
853 struct inode *inode = file_inode(file);
854 struct tty_struct *tty = file_tty(file);
855 struct tty_ldisc *ld;
857 if (tty_paranoia_check(tty, inode, "tty_read"))
858 return -EIO;
859 if (!tty || tty_io_error(tty))
860 return -EIO;
862 /* We want to wait for the line discipline to sort out in this
863 situation */
864 ld = tty_ldisc_ref_wait(tty);
865 if (!ld)
866 return hung_up_tty_read(file, buf, count, ppos);
867 if (ld->ops->read)
868 i = ld->ops->read(tty, file, buf, count);
869 else
870 i = -EIO;
871 tty_ldisc_deref(ld);
873 if (i > 0)
874 tty_update_time(&inode->i_atime);
876 return i;
879 static void tty_write_unlock(struct tty_struct *tty)
881 mutex_unlock(&tty->atomic_write_lock);
882 wake_up_interruptible_poll(&tty->write_wait, EPOLLOUT);
885 static int tty_write_lock(struct tty_struct *tty, int ndelay)
887 if (!mutex_trylock(&tty->atomic_write_lock)) {
888 if (ndelay)
889 return -EAGAIN;
890 if (mutex_lock_interruptible(&tty->atomic_write_lock))
891 return -ERESTARTSYS;
893 return 0;
897 * Split writes up in sane blocksizes to avoid
898 * denial-of-service type attacks
900 static inline ssize_t do_tty_write(
901 ssize_t (*write)(struct tty_struct *, struct file *, const unsigned char *, size_t),
902 struct tty_struct *tty,
903 struct file *file,
904 const char __user *buf,
905 size_t count)
907 ssize_t ret, written = 0;
908 unsigned int chunk;
910 ret = tty_write_lock(tty, file->f_flags & O_NDELAY);
911 if (ret < 0)
912 return ret;
915 * We chunk up writes into a temporary buffer. This
916 * simplifies low-level drivers immensely, since they
917 * don't have locking issues and user mode accesses.
919 * But if TTY_NO_WRITE_SPLIT is set, we should use a
920 * big chunk-size..
922 * The default chunk-size is 2kB, because the NTTY
923 * layer has problems with bigger chunks. It will
924 * claim to be able to handle more characters than
925 * it actually does.
927 * FIXME: This can probably go away now except that 64K chunks
928 * are too likely to fail unless switched to vmalloc...
930 chunk = 2048;
931 if (test_bit(TTY_NO_WRITE_SPLIT, &tty->flags))
932 chunk = 65536;
933 if (count < chunk)
934 chunk = count;
936 /* write_buf/write_cnt is protected by the atomic_write_lock mutex */
937 if (tty->write_cnt < chunk) {
938 unsigned char *buf_chunk;
940 if (chunk < 1024)
941 chunk = 1024;
943 buf_chunk = kmalloc(chunk, GFP_KERNEL);
944 if (!buf_chunk) {
945 ret = -ENOMEM;
946 goto out;
948 kfree(tty->write_buf);
949 tty->write_cnt = chunk;
950 tty->write_buf = buf_chunk;
953 /* Do the write .. */
954 for (;;) {
955 size_t size = count;
956 if (size > chunk)
957 size = chunk;
958 ret = -EFAULT;
959 if (copy_from_user(tty->write_buf, buf, size))
960 break;
961 ret = write(tty, file, tty->write_buf, size);
962 if (ret <= 0)
963 break;
964 written += ret;
965 buf += ret;
966 count -= ret;
967 if (!count)
968 break;
969 ret = -ERESTARTSYS;
970 if (signal_pending(current))
971 break;
972 cond_resched();
974 if (written) {
975 tty_update_time(&file_inode(file)->i_mtime);
976 ret = written;
978 out:
979 tty_write_unlock(tty);
980 return ret;
984 * tty_write_message - write a message to a certain tty, not just the console.
985 * @tty: the destination tty_struct
986 * @msg: the message to write
988 * This is used for messages that need to be redirected to a specific tty.
989 * We don't put it into the syslog queue right now maybe in the future if
990 * really needed.
992 * We must still hold the BTM and test the CLOSING flag for the moment.
995 void tty_write_message(struct tty_struct *tty, char *msg)
997 if (tty) {
998 mutex_lock(&tty->atomic_write_lock);
999 tty_lock(tty);
1000 if (tty->ops->write && tty->count > 0)
1001 tty->ops->write(tty, msg, strlen(msg));
1002 tty_unlock(tty);
1003 tty_write_unlock(tty);
1005 return;
1010 * tty_write - write method for tty device file
1011 * @file: tty file pointer
1012 * @buf: user data to write
1013 * @count: bytes to write
1014 * @ppos: unused
1016 * Write data to a tty device via the line discipline.
1018 * Locking:
1019 * Locks the line discipline as required
1020 * Writes to the tty driver are serialized by the atomic_write_lock
1021 * and are then processed in chunks to the device. The line discipline
1022 * write method will not be invoked in parallel for each device.
1025 static ssize_t tty_write(struct file *file, const char __user *buf,
1026 size_t count, loff_t *ppos)
1028 struct tty_struct *tty = file_tty(file);
1029 struct tty_ldisc *ld;
1030 ssize_t ret;
1032 if (tty_paranoia_check(tty, file_inode(file), "tty_write"))
1033 return -EIO;
1034 if (!tty || !tty->ops->write || tty_io_error(tty))
1035 return -EIO;
1036 /* Short term debug to catch buggy drivers */
1037 if (tty->ops->write_room == NULL)
1038 tty_err(tty, "missing write_room method\n");
1039 ld = tty_ldisc_ref_wait(tty);
1040 if (!ld)
1041 return hung_up_tty_write(file, buf, count, ppos);
1042 if (!ld->ops->write)
1043 ret = -EIO;
1044 else
1045 ret = do_tty_write(ld->ops->write, tty, file, buf, count);
1046 tty_ldisc_deref(ld);
1047 return ret;
1050 ssize_t redirected_tty_write(struct file *file, const char __user *buf,
1051 size_t count, loff_t *ppos)
1053 struct file *p = NULL;
1055 spin_lock(&redirect_lock);
1056 if (redirect)
1057 p = get_file(redirect);
1058 spin_unlock(&redirect_lock);
1060 if (p) {
1061 ssize_t res;
1062 res = vfs_write(p, buf, count, &p->f_pos);
1063 fput(p);
1064 return res;
1066 return tty_write(file, buf, count, ppos);
1070 * tty_send_xchar - send priority character
1072 * Send a high priority character to the tty even if stopped
1074 * Locking: none for xchar method, write ordering for write method.
1077 int tty_send_xchar(struct tty_struct *tty, char ch)
1079 int was_stopped = tty->stopped;
1081 if (tty->ops->send_xchar) {
1082 down_read(&tty->termios_rwsem);
1083 tty->ops->send_xchar(tty, ch);
1084 up_read(&tty->termios_rwsem);
1085 return 0;
1088 if (tty_write_lock(tty, 0) < 0)
1089 return -ERESTARTSYS;
1091 down_read(&tty->termios_rwsem);
1092 if (was_stopped)
1093 start_tty(tty);
1094 tty->ops->write(tty, &ch, 1);
1095 if (was_stopped)
1096 stop_tty(tty);
1097 up_read(&tty->termios_rwsem);
1098 tty_write_unlock(tty);
1099 return 0;
1102 static char ptychar[] = "pqrstuvwxyzabcde";
1105 * pty_line_name - generate name for a pty
1106 * @driver: the tty driver in use
1107 * @index: the minor number
1108 * @p: output buffer of at least 6 bytes
1110 * Generate a name from a driver reference and write it to the output
1111 * buffer.
1113 * Locking: None
1115 static void pty_line_name(struct tty_driver *driver, int index, char *p)
1117 int i = index + driver->name_base;
1118 /* ->name is initialized to "ttyp", but "tty" is expected */
1119 sprintf(p, "%s%c%x",
1120 driver->subtype == PTY_TYPE_SLAVE ? "tty" : driver->name,
1121 ptychar[i >> 4 & 0xf], i & 0xf);
1125 * tty_line_name - generate name for a tty
1126 * @driver: the tty driver in use
1127 * @index: the minor number
1128 * @p: output buffer of at least 7 bytes
1130 * Generate a name from a driver reference and write it to the output
1131 * buffer.
1133 * Locking: None
1135 static ssize_t tty_line_name(struct tty_driver *driver, int index, char *p)
1137 if (driver->flags & TTY_DRIVER_UNNUMBERED_NODE)
1138 return sprintf(p, "%s", driver->name);
1139 else
1140 return sprintf(p, "%s%d", driver->name,
1141 index + driver->name_base);
1145 * tty_driver_lookup_tty() - find an existing tty, if any
1146 * @driver: the driver for the tty
1147 * @file: file object
1148 * @idx: the minor number
1150 * Return the tty, if found. If not found, return NULL or ERR_PTR() if the
1151 * driver lookup() method returns an error.
1153 * Locking: tty_mutex must be held. If the tty is found, bump the tty kref.
1155 static struct tty_struct *tty_driver_lookup_tty(struct tty_driver *driver,
1156 struct file *file, int idx)
1158 struct tty_struct *tty;
1160 if (driver->ops->lookup)
1161 if (!file)
1162 tty = ERR_PTR(-EIO);
1163 else
1164 tty = driver->ops->lookup(driver, file, idx);
1165 else
1166 tty = driver->ttys[idx];
1168 if (!IS_ERR(tty))
1169 tty_kref_get(tty);
1170 return tty;
1174 * tty_init_termios - helper for termios setup
1175 * @tty: the tty to set up
1177 * Initialise the termios structure for this tty. This runs under
1178 * the tty_mutex currently so we can be relaxed about ordering.
1181 void tty_init_termios(struct tty_struct *tty)
1183 struct ktermios *tp;
1184 int idx = tty->index;
1186 if (tty->driver->flags & TTY_DRIVER_RESET_TERMIOS)
1187 tty->termios = tty->driver->init_termios;
1188 else {
1189 /* Check for lazy saved data */
1190 tp = tty->driver->termios[idx];
1191 if (tp != NULL) {
1192 tty->termios = *tp;
1193 tty->termios.c_line = tty->driver->init_termios.c_line;
1194 } else
1195 tty->termios = tty->driver->init_termios;
1197 /* Compatibility until drivers always set this */
1198 tty->termios.c_ispeed = tty_termios_input_baud_rate(&tty->termios);
1199 tty->termios.c_ospeed = tty_termios_baud_rate(&tty->termios);
1201 EXPORT_SYMBOL_GPL(tty_init_termios);
1203 int tty_standard_install(struct tty_driver *driver, struct tty_struct *tty)
1205 tty_init_termios(tty);
1206 tty_driver_kref_get(driver);
1207 tty->count++;
1208 driver->ttys[tty->index] = tty;
1209 return 0;
1211 EXPORT_SYMBOL_GPL(tty_standard_install);
1214 * tty_driver_install_tty() - install a tty entry in the driver
1215 * @driver: the driver for the tty
1216 * @tty: the tty
1218 * Install a tty object into the driver tables. The tty->index field
1219 * will be set by the time this is called. This method is responsible
1220 * for ensuring any need additional structures are allocated and
1221 * configured.
1223 * Locking: tty_mutex for now
1225 static int tty_driver_install_tty(struct tty_driver *driver,
1226 struct tty_struct *tty)
1228 return driver->ops->install ? driver->ops->install(driver, tty) :
1229 tty_standard_install(driver, tty);
1233 * tty_driver_remove_tty() - remove a tty from the driver tables
1234 * @driver: the driver for the tty
1235 * @tty: tty to remove
1237 * Remvoe a tty object from the driver tables. The tty->index field
1238 * will be set by the time this is called.
1240 * Locking: tty_mutex for now
1242 static void tty_driver_remove_tty(struct tty_driver *driver, struct tty_struct *tty)
1244 if (driver->ops->remove)
1245 driver->ops->remove(driver, tty);
1246 else
1247 driver->ttys[tty->index] = NULL;
1251 * tty_reopen() - fast re-open of an open tty
1252 * @tty: the tty to open
1254 * Return 0 on success, -errno on error.
1255 * Re-opens on master ptys are not allowed and return -EIO.
1257 * Locking: Caller must hold tty_lock
1259 static int tty_reopen(struct tty_struct *tty)
1261 struct tty_driver *driver = tty->driver;
1262 struct tty_ldisc *ld;
1263 int retval = 0;
1265 if (driver->type == TTY_DRIVER_TYPE_PTY &&
1266 driver->subtype == PTY_TYPE_MASTER)
1267 return -EIO;
1269 if (!tty->count)
1270 return -EAGAIN;
1272 if (test_bit(TTY_EXCLUSIVE, &tty->flags) && !capable(CAP_SYS_ADMIN))
1273 return -EBUSY;
1275 ld = tty_ldisc_ref_wait(tty);
1276 if (ld) {
1277 tty_ldisc_deref(ld);
1278 } else {
1279 retval = tty_ldisc_lock(tty, 5 * HZ);
1280 if (retval)
1281 return retval;
1283 if (!tty->ldisc)
1284 retval = tty_ldisc_reinit(tty, tty->termios.c_line);
1285 tty_ldisc_unlock(tty);
1288 if (retval == 0)
1289 tty->count++;
1291 return retval;
1295 * tty_init_dev - initialise a tty device
1296 * @driver: tty driver we are opening a device on
1297 * @idx: device index
1299 * Prepare a tty device. This may not be a "new" clean device but
1300 * could also be an active device. The pty drivers require special
1301 * handling because of this.
1303 * Locking:
1304 * The function is called under the tty_mutex, which
1305 * protects us from the tty struct or driver itself going away.
1307 * On exit the tty device has the line discipline attached and
1308 * a reference count of 1. If a pair was created for pty/tty use
1309 * and the other was a pty master then it too has a reference count of 1.
1311 * WSH 06/09/97: Rewritten to remove races and properly clean up after a
1312 * failed open. The new code protects the open with a mutex, so it's
1313 * really quite straightforward. The mutex locking can probably be
1314 * relaxed for the (most common) case of reopening a tty.
1316 * Return: returned tty structure
1319 struct tty_struct *tty_init_dev(struct tty_driver *driver, int idx)
1321 struct tty_struct *tty;
1322 int retval;
1325 * First time open is complex, especially for PTY devices.
1326 * This code guarantees that either everything succeeds and the
1327 * TTY is ready for operation, or else the table slots are vacated
1328 * and the allocated memory released. (Except that the termios
1329 * may be retained.)
1332 if (!try_module_get(driver->owner))
1333 return ERR_PTR(-ENODEV);
1335 tty = alloc_tty_struct(driver, idx);
1336 if (!tty) {
1337 retval = -ENOMEM;
1338 goto err_module_put;
1341 tty_lock(tty);
1342 retval = tty_driver_install_tty(driver, tty);
1343 if (retval < 0)
1344 goto err_free_tty;
1346 if (!tty->port)
1347 tty->port = driver->ports[idx];
1349 if (WARN_RATELIMIT(!tty->port,
1350 "%s: %s driver does not set tty->port. This would crash the kernel. Fix the driver!\n",
1351 __func__, tty->driver->name)) {
1352 retval = -EINVAL;
1353 goto err_release_lock;
1356 retval = tty_ldisc_lock(tty, 5 * HZ);
1357 if (retval)
1358 goto err_release_lock;
1359 tty->port->itty = tty;
1362 * Structures all installed ... call the ldisc open routines.
1363 * If we fail here just call release_tty to clean up. No need
1364 * to decrement the use counts, as release_tty doesn't care.
1366 retval = tty_ldisc_setup(tty, tty->link);
1367 if (retval)
1368 goto err_release_tty;
1369 tty_ldisc_unlock(tty);
1370 /* Return the tty locked so that it cannot vanish under the caller */
1371 return tty;
1373 err_free_tty:
1374 tty_unlock(tty);
1375 free_tty_struct(tty);
1376 err_module_put:
1377 module_put(driver->owner);
1378 return ERR_PTR(retval);
1380 /* call the tty release_tty routine to clean out this slot */
1381 err_release_tty:
1382 tty_ldisc_unlock(tty);
1383 tty_info_ratelimited(tty, "ldisc open failed (%d), clearing slot %d\n",
1384 retval, idx);
1385 err_release_lock:
1386 tty_unlock(tty);
1387 release_tty(tty, idx);
1388 return ERR_PTR(retval);
1392 * tty_save_termios() - save tty termios data in driver table
1393 * @tty: tty whose termios data to save
1395 * Locking: Caller guarantees serialisation with tty_init_termios().
1397 void tty_save_termios(struct tty_struct *tty)
1399 struct ktermios *tp;
1400 int idx = tty->index;
1402 /* If the port is going to reset then it has no termios to save */
1403 if (tty->driver->flags & TTY_DRIVER_RESET_TERMIOS)
1404 return;
1406 /* Stash the termios data */
1407 tp = tty->driver->termios[idx];
1408 if (tp == NULL) {
1409 tp = kmalloc(sizeof(*tp), GFP_KERNEL);
1410 if (tp == NULL)
1411 return;
1412 tty->driver->termios[idx] = tp;
1414 *tp = tty->termios;
1416 EXPORT_SYMBOL_GPL(tty_save_termios);
1419 * tty_flush_works - flush all works of a tty/pty pair
1420 * @tty: tty device to flush works for (or either end of a pty pair)
1422 * Sync flush all works belonging to @tty (and the 'other' tty).
1424 static void tty_flush_works(struct tty_struct *tty)
1426 flush_work(&tty->SAK_work);
1427 flush_work(&tty->hangup_work);
1428 if (tty->link) {
1429 flush_work(&tty->link->SAK_work);
1430 flush_work(&tty->link->hangup_work);
1435 * release_one_tty - release tty structure memory
1436 * @work: work of tty we are obliterating
1438 * Releases memory associated with a tty structure, and clears out the
1439 * driver table slots. This function is called when a device is no longer
1440 * in use. It also gets called when setup of a device fails.
1442 * Locking:
1443 * takes the file list lock internally when working on the list
1444 * of ttys that the driver keeps.
1446 * This method gets called from a work queue so that the driver private
1447 * cleanup ops can sleep (needed for USB at least)
1449 static void release_one_tty(struct work_struct *work)
1451 struct tty_struct *tty =
1452 container_of(work, struct tty_struct, hangup_work);
1453 struct tty_driver *driver = tty->driver;
1454 struct module *owner = driver->owner;
1456 if (tty->ops->cleanup)
1457 tty->ops->cleanup(tty);
1459 tty->magic = 0;
1460 tty_driver_kref_put(driver);
1461 module_put(owner);
1463 spin_lock(&tty->files_lock);
1464 list_del_init(&tty->tty_files);
1465 spin_unlock(&tty->files_lock);
1467 put_pid(tty->pgrp);
1468 put_pid(tty->session);
1469 free_tty_struct(tty);
1472 static void queue_release_one_tty(struct kref *kref)
1474 struct tty_struct *tty = container_of(kref, struct tty_struct, kref);
1476 /* The hangup queue is now free so we can reuse it rather than
1477 waste a chunk of memory for each port */
1478 INIT_WORK(&tty->hangup_work, release_one_tty);
1479 schedule_work(&tty->hangup_work);
1483 * tty_kref_put - release a tty kref
1484 * @tty: tty device
1486 * Release a reference to a tty device and if need be let the kref
1487 * layer destruct the object for us
1490 void tty_kref_put(struct tty_struct *tty)
1492 if (tty)
1493 kref_put(&tty->kref, queue_release_one_tty);
1495 EXPORT_SYMBOL(tty_kref_put);
1498 * release_tty - release tty structure memory
1499 * @tty: tty device release
1500 * @idx: index of the tty device release
1502 * Release both @tty and a possible linked partner (think pty pair),
1503 * and decrement the refcount of the backing module.
1505 * Locking:
1506 * tty_mutex
1507 * takes the file list lock internally when working on the list
1508 * of ttys that the driver keeps.
1511 static void release_tty(struct tty_struct *tty, int idx)
1513 /* This should always be true but check for the moment */
1514 WARN_ON(tty->index != idx);
1515 WARN_ON(!mutex_is_locked(&tty_mutex));
1516 if (tty->ops->shutdown)
1517 tty->ops->shutdown(tty);
1518 tty_save_termios(tty);
1519 tty_driver_remove_tty(tty->driver, tty);
1520 if (tty->port)
1521 tty->port->itty = NULL;
1522 if (tty->link)
1523 tty->link->port->itty = NULL;
1524 if (tty->port)
1525 tty_buffer_cancel_work(tty->port);
1526 if (tty->link)
1527 tty_buffer_cancel_work(tty->link->port);
1529 tty_kref_put(tty->link);
1530 tty_kref_put(tty);
1534 * tty_release_checks - check a tty before real release
1535 * @tty: tty to check
1536 * @idx: index of the tty
1538 * Performs some paranoid checking before true release of the @tty.
1539 * This is a no-op unless TTY_PARANOIA_CHECK is defined.
1541 static int tty_release_checks(struct tty_struct *tty, int idx)
1543 #ifdef TTY_PARANOIA_CHECK
1544 if (idx < 0 || idx >= tty->driver->num) {
1545 tty_debug(tty, "bad idx %d\n", idx);
1546 return -1;
1549 /* not much to check for devpts */
1550 if (tty->driver->flags & TTY_DRIVER_DEVPTS_MEM)
1551 return 0;
1553 if (tty != tty->driver->ttys[idx]) {
1554 tty_debug(tty, "bad driver table[%d] = %p\n",
1555 idx, tty->driver->ttys[idx]);
1556 return -1;
1558 if (tty->driver->other) {
1559 struct tty_struct *o_tty = tty->link;
1561 if (o_tty != tty->driver->other->ttys[idx]) {
1562 tty_debug(tty, "bad other table[%d] = %p\n",
1563 idx, tty->driver->other->ttys[idx]);
1564 return -1;
1566 if (o_tty->link != tty) {
1567 tty_debug(tty, "bad link = %p\n", o_tty->link);
1568 return -1;
1571 #endif
1572 return 0;
1576 * tty_kclose - closes tty opened by tty_kopen
1577 * @tty: tty device
1579 * Performs the final steps to release and free a tty device. It is the
1580 * same as tty_release_struct except that it also resets TTY_PORT_KOPENED
1581 * flag on tty->port.
1583 void tty_kclose(struct tty_struct *tty)
1586 * Ask the line discipline code to release its structures
1588 tty_ldisc_release(tty);
1590 /* Wait for pending work before tty destruction commmences */
1591 tty_flush_works(tty);
1593 tty_debug_hangup(tty, "freeing structure\n");
1595 * The release_tty function takes care of the details of clearing
1596 * the slots and preserving the termios structure.
1598 mutex_lock(&tty_mutex);
1599 tty_port_set_kopened(tty->port, 0);
1600 release_tty(tty, tty->index);
1601 mutex_unlock(&tty_mutex);
1603 EXPORT_SYMBOL_GPL(tty_kclose);
1606 * tty_release_struct - release a tty struct
1607 * @tty: tty device
1608 * @idx: index of the tty
1610 * Performs the final steps to release and free a tty device. It is
1611 * roughly the reverse of tty_init_dev.
1613 void tty_release_struct(struct tty_struct *tty, int idx)
1616 * Ask the line discipline code to release its structures
1618 tty_ldisc_release(tty);
1620 /* Wait for pending work before tty destruction commmences */
1621 tty_flush_works(tty);
1623 tty_debug_hangup(tty, "freeing structure\n");
1625 * The release_tty function takes care of the details of clearing
1626 * the slots and preserving the termios structure.
1628 mutex_lock(&tty_mutex);
1629 release_tty(tty, idx);
1630 mutex_unlock(&tty_mutex);
1632 EXPORT_SYMBOL_GPL(tty_release_struct);
1635 * tty_release - vfs callback for close
1636 * @inode: inode of tty
1637 * @filp: file pointer for handle to tty
1639 * Called the last time each file handle is closed that references
1640 * this tty. There may however be several such references.
1642 * Locking:
1643 * Takes bkl. See tty_release_dev
1645 * Even releasing the tty structures is a tricky business.. We have
1646 * to be very careful that the structures are all released at the
1647 * same time, as interrupts might otherwise get the wrong pointers.
1649 * WSH 09/09/97: rewritten to avoid some nasty race conditions that could
1650 * lead to double frees or releasing memory still in use.
1653 int tty_release(struct inode *inode, struct file *filp)
1655 struct tty_struct *tty = file_tty(filp);
1656 struct tty_struct *o_tty = NULL;
1657 int do_sleep, final;
1658 int idx;
1659 long timeout = 0;
1660 int once = 1;
1662 if (tty_paranoia_check(tty, inode, __func__))
1663 return 0;
1665 tty_lock(tty);
1666 check_tty_count(tty, __func__);
1668 __tty_fasync(-1, filp, 0);
1670 idx = tty->index;
1671 if (tty->driver->type == TTY_DRIVER_TYPE_PTY &&
1672 tty->driver->subtype == PTY_TYPE_MASTER)
1673 o_tty = tty->link;
1675 if (tty_release_checks(tty, idx)) {
1676 tty_unlock(tty);
1677 return 0;
1680 tty_debug_hangup(tty, "releasing (count=%d)\n", tty->count);
1682 if (tty->ops->close)
1683 tty->ops->close(tty, filp);
1685 /* If tty is pty master, lock the slave pty (stable lock order) */
1686 tty_lock_slave(o_tty);
1689 * Sanity check: if tty->count is going to zero, there shouldn't be
1690 * any waiters on tty->read_wait or tty->write_wait. We test the
1691 * wait queues and kick everyone out _before_ actually starting to
1692 * close. This ensures that we won't block while releasing the tty
1693 * structure.
1695 * The test for the o_tty closing is necessary, since the master and
1696 * slave sides may close in any order. If the slave side closes out
1697 * first, its count will be one, since the master side holds an open.
1698 * Thus this test wouldn't be triggered at the time the slave closed,
1699 * so we do it now.
1701 while (1) {
1702 do_sleep = 0;
1704 if (tty->count <= 1) {
1705 if (waitqueue_active(&tty->read_wait)) {
1706 wake_up_poll(&tty->read_wait, EPOLLIN);
1707 do_sleep++;
1709 if (waitqueue_active(&tty->write_wait)) {
1710 wake_up_poll(&tty->write_wait, EPOLLOUT);
1711 do_sleep++;
1714 if (o_tty && o_tty->count <= 1) {
1715 if (waitqueue_active(&o_tty->read_wait)) {
1716 wake_up_poll(&o_tty->read_wait, EPOLLIN);
1717 do_sleep++;
1719 if (waitqueue_active(&o_tty->write_wait)) {
1720 wake_up_poll(&o_tty->write_wait, EPOLLOUT);
1721 do_sleep++;
1724 if (!do_sleep)
1725 break;
1727 if (once) {
1728 once = 0;
1729 tty_warn(tty, "read/write wait queue active!\n");
1731 schedule_timeout_killable(timeout);
1732 if (timeout < 120 * HZ)
1733 timeout = 2 * timeout + 1;
1734 else
1735 timeout = MAX_SCHEDULE_TIMEOUT;
1738 if (o_tty) {
1739 if (--o_tty->count < 0) {
1740 tty_warn(tty, "bad slave count (%d)\n", o_tty->count);
1741 o_tty->count = 0;
1744 if (--tty->count < 0) {
1745 tty_warn(tty, "bad tty->count (%d)\n", tty->count);
1746 tty->count = 0;
1750 * We've decremented tty->count, so we need to remove this file
1751 * descriptor off the tty->tty_files list; this serves two
1752 * purposes:
1753 * - check_tty_count sees the correct number of file descriptors
1754 * associated with this tty.
1755 * - do_tty_hangup no longer sees this file descriptor as
1756 * something that needs to be handled for hangups.
1758 tty_del_file(filp);
1761 * Perform some housekeeping before deciding whether to return.
1763 * If _either_ side is closing, make sure there aren't any
1764 * processes that still think tty or o_tty is their controlling
1765 * tty.
1767 if (!tty->count) {
1768 read_lock(&tasklist_lock);
1769 session_clear_tty(tty->session);
1770 if (o_tty)
1771 session_clear_tty(o_tty->session);
1772 read_unlock(&tasklist_lock);
1775 /* check whether both sides are closing ... */
1776 final = !tty->count && !(o_tty && o_tty->count);
1778 tty_unlock_slave(o_tty);
1779 tty_unlock(tty);
1781 /* At this point, the tty->count == 0 should ensure a dead tty
1782 cannot be re-opened by a racing opener */
1784 if (!final)
1785 return 0;
1787 tty_debug_hangup(tty, "final close\n");
1789 tty_release_struct(tty, idx);
1790 return 0;
1794 * tty_open_current_tty - get locked tty of current task
1795 * @device: device number
1796 * @filp: file pointer to tty
1797 * @return: locked tty of the current task iff @device is /dev/tty
1799 * Performs a re-open of the current task's controlling tty.
1801 * We cannot return driver and index like for the other nodes because
1802 * devpts will not work then. It expects inodes to be from devpts FS.
1804 static struct tty_struct *tty_open_current_tty(dev_t device, struct file *filp)
1806 struct tty_struct *tty;
1807 int retval;
1809 if (device != MKDEV(TTYAUX_MAJOR, 0))
1810 return NULL;
1812 tty = get_current_tty();
1813 if (!tty)
1814 return ERR_PTR(-ENXIO);
1816 filp->f_flags |= O_NONBLOCK; /* Don't let /dev/tty block */
1817 /* noctty = 1; */
1818 tty_lock(tty);
1819 tty_kref_put(tty); /* safe to drop the kref now */
1821 retval = tty_reopen(tty);
1822 if (retval < 0) {
1823 tty_unlock(tty);
1824 tty = ERR_PTR(retval);
1826 return tty;
1830 * tty_lookup_driver - lookup a tty driver for a given device file
1831 * @device: device number
1832 * @filp: file pointer to tty
1833 * @index: index for the device in the @return driver
1834 * @return: driver for this inode (with increased refcount)
1836 * If @return is not erroneous, the caller is responsible to decrement the
1837 * refcount by tty_driver_kref_put.
1839 * Locking: tty_mutex protects get_tty_driver
1841 static struct tty_driver *tty_lookup_driver(dev_t device, struct file *filp,
1842 int *index)
1844 struct tty_driver *driver = NULL;
1846 switch (device) {
1847 #ifdef CONFIG_VT
1848 case MKDEV(TTY_MAJOR, 0): {
1849 extern struct tty_driver *console_driver;
1850 driver = tty_driver_kref_get(console_driver);
1851 *index = fg_console;
1852 break;
1854 #endif
1855 case MKDEV(TTYAUX_MAJOR, 1): {
1856 struct tty_driver *console_driver = console_device(index);
1857 if (console_driver) {
1858 driver = tty_driver_kref_get(console_driver);
1859 if (driver && filp) {
1860 /* Don't let /dev/console block */
1861 filp->f_flags |= O_NONBLOCK;
1862 break;
1865 if (driver)
1866 tty_driver_kref_put(driver);
1867 return ERR_PTR(-ENODEV);
1869 default:
1870 driver = get_tty_driver(device, index);
1871 if (!driver)
1872 return ERR_PTR(-ENODEV);
1873 break;
1875 return driver;
1879 * tty_kopen - open a tty device for kernel
1880 * @device: dev_t of device to open
1882 * Opens tty exclusively for kernel. Performs the driver lookup,
1883 * makes sure it's not already opened and performs the first-time
1884 * tty initialization.
1886 * Returns the locked initialized &tty_struct
1888 * Claims the global tty_mutex to serialize:
1889 * - concurrent first-time tty initialization
1890 * - concurrent tty driver removal w/ lookup
1891 * - concurrent tty removal from driver table
1893 struct tty_struct *tty_kopen(dev_t device)
1895 struct tty_struct *tty;
1896 struct tty_driver *driver;
1897 int index = -1;
1899 mutex_lock(&tty_mutex);
1900 driver = tty_lookup_driver(device, NULL, &index);
1901 if (IS_ERR(driver)) {
1902 mutex_unlock(&tty_mutex);
1903 return ERR_CAST(driver);
1906 /* check whether we're reopening an existing tty */
1907 tty = tty_driver_lookup_tty(driver, NULL, index);
1908 if (IS_ERR(tty))
1909 goto out;
1911 if (tty) {
1912 /* drop kref from tty_driver_lookup_tty() */
1913 tty_kref_put(tty);
1914 tty = ERR_PTR(-EBUSY);
1915 } else { /* tty_init_dev returns tty with the tty_lock held */
1916 tty = tty_init_dev(driver, index);
1917 if (IS_ERR(tty))
1918 goto out;
1919 tty_port_set_kopened(tty->port, 1);
1921 out:
1922 mutex_unlock(&tty_mutex);
1923 tty_driver_kref_put(driver);
1924 return tty;
1926 EXPORT_SYMBOL_GPL(tty_kopen);
1929 * tty_open_by_driver - open a tty device
1930 * @device: dev_t of device to open
1931 * @filp: file pointer to tty
1933 * Performs the driver lookup, checks for a reopen, or otherwise
1934 * performs the first-time tty initialization.
1936 * Returns the locked initialized or re-opened &tty_struct
1938 * Claims the global tty_mutex to serialize:
1939 * - concurrent first-time tty initialization
1940 * - concurrent tty driver removal w/ lookup
1941 * - concurrent tty removal from driver table
1943 static struct tty_struct *tty_open_by_driver(dev_t device,
1944 struct file *filp)
1946 struct tty_struct *tty;
1947 struct tty_driver *driver = NULL;
1948 int index = -1;
1949 int retval;
1951 mutex_lock(&tty_mutex);
1952 driver = tty_lookup_driver(device, filp, &index);
1953 if (IS_ERR(driver)) {
1954 mutex_unlock(&tty_mutex);
1955 return ERR_CAST(driver);
1958 /* check whether we're reopening an existing tty */
1959 tty = tty_driver_lookup_tty(driver, filp, index);
1960 if (IS_ERR(tty)) {
1961 mutex_unlock(&tty_mutex);
1962 goto out;
1965 if (tty) {
1966 if (tty_port_kopened(tty->port)) {
1967 tty_kref_put(tty);
1968 mutex_unlock(&tty_mutex);
1969 tty = ERR_PTR(-EBUSY);
1970 goto out;
1972 mutex_unlock(&tty_mutex);
1973 retval = tty_lock_interruptible(tty);
1974 tty_kref_put(tty); /* drop kref from tty_driver_lookup_tty() */
1975 if (retval) {
1976 if (retval == -EINTR)
1977 retval = -ERESTARTSYS;
1978 tty = ERR_PTR(retval);
1979 goto out;
1981 retval = tty_reopen(tty);
1982 if (retval < 0) {
1983 tty_unlock(tty);
1984 tty = ERR_PTR(retval);
1986 } else { /* Returns with the tty_lock held for now */
1987 tty = tty_init_dev(driver, index);
1988 mutex_unlock(&tty_mutex);
1990 out:
1991 tty_driver_kref_put(driver);
1992 return tty;
1996 * tty_open - open a tty device
1997 * @inode: inode of device file
1998 * @filp: file pointer to tty
2000 * tty_open and tty_release keep up the tty count that contains the
2001 * number of opens done on a tty. We cannot use the inode-count, as
2002 * different inodes might point to the same tty.
2004 * Open-counting is needed for pty masters, as well as for keeping
2005 * track of serial lines: DTR is dropped when the last close happens.
2006 * (This is not done solely through tty->count, now. - Ted 1/27/92)
2008 * The termios state of a pty is reset on first open so that
2009 * settings don't persist across reuse.
2011 * Locking: tty_mutex protects tty, tty_lookup_driver and tty_init_dev.
2012 * tty->count should protect the rest.
2013 * ->siglock protects ->signal/->sighand
2015 * Note: the tty_unlock/lock cases without a ref are only safe due to
2016 * tty_mutex
2019 static int tty_open(struct inode *inode, struct file *filp)
2021 struct tty_struct *tty;
2022 int noctty, retval;
2023 dev_t device = inode->i_rdev;
2024 unsigned saved_flags = filp->f_flags;
2026 nonseekable_open(inode, filp);
2028 retry_open:
2029 retval = tty_alloc_file(filp);
2030 if (retval)
2031 return -ENOMEM;
2033 tty = tty_open_current_tty(device, filp);
2034 if (!tty)
2035 tty = tty_open_by_driver(device, filp);
2037 if (IS_ERR(tty)) {
2038 tty_free_file(filp);
2039 retval = PTR_ERR(tty);
2040 if (retval != -EAGAIN || signal_pending(current))
2041 return retval;
2042 schedule();
2043 goto retry_open;
2046 tty_add_file(tty, filp);
2048 check_tty_count(tty, __func__);
2049 tty_debug_hangup(tty, "opening (count=%d)\n", tty->count);
2051 if (tty->ops->open)
2052 retval = tty->ops->open(tty, filp);
2053 else
2054 retval = -ENODEV;
2055 filp->f_flags = saved_flags;
2057 if (retval) {
2058 tty_debug_hangup(tty, "open error %d, releasing\n", retval);
2060 tty_unlock(tty); /* need to call tty_release without BTM */
2061 tty_release(inode, filp);
2062 if (retval != -ERESTARTSYS)
2063 return retval;
2065 if (signal_pending(current))
2066 return retval;
2068 schedule();
2070 * Need to reset f_op in case a hangup happened.
2072 if (tty_hung_up_p(filp))
2073 filp->f_op = &tty_fops;
2074 goto retry_open;
2076 clear_bit(TTY_HUPPED, &tty->flags);
2078 noctty = (filp->f_flags & O_NOCTTY) ||
2079 (IS_ENABLED(CONFIG_VT) && device == MKDEV(TTY_MAJOR, 0)) ||
2080 device == MKDEV(TTYAUX_MAJOR, 1) ||
2081 (tty->driver->type == TTY_DRIVER_TYPE_PTY &&
2082 tty->driver->subtype == PTY_TYPE_MASTER);
2083 if (!noctty)
2084 tty_open_proc_set_tty(filp, tty);
2085 tty_unlock(tty);
2086 return 0;
2092 * tty_poll - check tty status
2093 * @filp: file being polled
2094 * @wait: poll wait structures to update
2096 * Call the line discipline polling method to obtain the poll
2097 * status of the device.
2099 * Locking: locks called line discipline but ldisc poll method
2100 * may be re-entered freely by other callers.
2103 static __poll_t tty_poll(struct file *filp, poll_table *wait)
2105 struct tty_struct *tty = file_tty(filp);
2106 struct tty_ldisc *ld;
2107 __poll_t ret = 0;
2109 if (tty_paranoia_check(tty, file_inode(filp), "tty_poll"))
2110 return 0;
2112 ld = tty_ldisc_ref_wait(tty);
2113 if (!ld)
2114 return hung_up_tty_poll(filp, wait);
2115 if (ld->ops->poll)
2116 ret = ld->ops->poll(tty, filp, wait);
2117 tty_ldisc_deref(ld);
2118 return ret;
2121 static int __tty_fasync(int fd, struct file *filp, int on)
2123 struct tty_struct *tty = file_tty(filp);
2124 unsigned long flags;
2125 int retval = 0;
2127 if (tty_paranoia_check(tty, file_inode(filp), "tty_fasync"))
2128 goto out;
2130 retval = fasync_helper(fd, filp, on, &tty->fasync);
2131 if (retval <= 0)
2132 goto out;
2134 if (on) {
2135 enum pid_type type;
2136 struct pid *pid;
2138 spin_lock_irqsave(&tty->ctrl_lock, flags);
2139 if (tty->pgrp) {
2140 pid = tty->pgrp;
2141 type = PIDTYPE_PGID;
2142 } else {
2143 pid = task_pid(current);
2144 type = PIDTYPE_TGID;
2146 get_pid(pid);
2147 spin_unlock_irqrestore(&tty->ctrl_lock, flags);
2148 __f_setown(filp, pid, type, 0);
2149 put_pid(pid);
2150 retval = 0;
2152 out:
2153 return retval;
2156 static int tty_fasync(int fd, struct file *filp, int on)
2158 struct tty_struct *tty = file_tty(filp);
2159 int retval = -ENOTTY;
2161 tty_lock(tty);
2162 if (!tty_hung_up_p(filp))
2163 retval = __tty_fasync(fd, filp, on);
2164 tty_unlock(tty);
2166 return retval;
2170 * tiocsti - fake input character
2171 * @tty: tty to fake input into
2172 * @p: pointer to character
2174 * Fake input to a tty device. Does the necessary locking and
2175 * input management.
2177 * FIXME: does not honour flow control ??
2179 * Locking:
2180 * Called functions take tty_ldiscs_lock
2181 * current->signal->tty check is safe without locks
2183 * FIXME: may race normal receive processing
2186 static int tiocsti(struct tty_struct *tty, char __user *p)
2188 char ch, mbz = 0;
2189 struct tty_ldisc *ld;
2191 if ((current->signal->tty != tty) && !capable(CAP_SYS_ADMIN))
2192 return -EPERM;
2193 if (get_user(ch, p))
2194 return -EFAULT;
2195 tty_audit_tiocsti(tty, ch);
2196 ld = tty_ldisc_ref_wait(tty);
2197 if (!ld)
2198 return -EIO;
2199 if (ld->ops->receive_buf)
2200 ld->ops->receive_buf(tty, &ch, &mbz, 1);
2201 tty_ldisc_deref(ld);
2202 return 0;
2206 * tiocgwinsz - implement window query ioctl
2207 * @tty: tty
2208 * @arg: user buffer for result
2210 * Copies the kernel idea of the window size into the user buffer.
2212 * Locking: tty->winsize_mutex is taken to ensure the winsize data
2213 * is consistent.
2216 static int tiocgwinsz(struct tty_struct *tty, struct winsize __user *arg)
2218 int err;
2220 mutex_lock(&tty->winsize_mutex);
2221 err = copy_to_user(arg, &tty->winsize, sizeof(*arg));
2222 mutex_unlock(&tty->winsize_mutex);
2224 return err ? -EFAULT: 0;
2228 * tty_do_resize - resize event
2229 * @tty: tty being resized
2230 * @ws: new dimensions
2232 * Update the termios variables and send the necessary signals to
2233 * peform a terminal resize correctly
2236 int tty_do_resize(struct tty_struct *tty, struct winsize *ws)
2238 struct pid *pgrp;
2240 /* Lock the tty */
2241 mutex_lock(&tty->winsize_mutex);
2242 if (!memcmp(ws, &tty->winsize, sizeof(*ws)))
2243 goto done;
2245 /* Signal the foreground process group */
2246 pgrp = tty_get_pgrp(tty);
2247 if (pgrp)
2248 kill_pgrp(pgrp, SIGWINCH, 1);
2249 put_pid(pgrp);
2251 tty->winsize = *ws;
2252 done:
2253 mutex_unlock(&tty->winsize_mutex);
2254 return 0;
2256 EXPORT_SYMBOL(tty_do_resize);
2259 * tiocswinsz - implement window size set ioctl
2260 * @tty: tty side of tty
2261 * @arg: user buffer for result
2263 * Copies the user idea of the window size to the kernel. Traditionally
2264 * this is just advisory information but for the Linux console it
2265 * actually has driver level meaning and triggers a VC resize.
2267 * Locking:
2268 * Driver dependent. The default do_resize method takes the
2269 * tty termios mutex and ctrl_lock. The console takes its own lock
2270 * then calls into the default method.
2273 static int tiocswinsz(struct tty_struct *tty, struct winsize __user *arg)
2275 struct winsize tmp_ws;
2276 if (copy_from_user(&tmp_ws, arg, sizeof(*arg)))
2277 return -EFAULT;
2279 if (tty->ops->resize)
2280 return tty->ops->resize(tty, &tmp_ws);
2281 else
2282 return tty_do_resize(tty, &tmp_ws);
2286 * tioccons - allow admin to move logical console
2287 * @file: the file to become console
2289 * Allow the administrator to move the redirected console device
2291 * Locking: uses redirect_lock to guard the redirect information
2294 static int tioccons(struct file *file)
2296 if (!capable(CAP_SYS_ADMIN))
2297 return -EPERM;
2298 if (file->f_op->write == redirected_tty_write) {
2299 struct file *f;
2300 spin_lock(&redirect_lock);
2301 f = redirect;
2302 redirect = NULL;
2303 spin_unlock(&redirect_lock);
2304 if (f)
2305 fput(f);
2306 return 0;
2308 spin_lock(&redirect_lock);
2309 if (redirect) {
2310 spin_unlock(&redirect_lock);
2311 return -EBUSY;
2313 redirect = get_file(file);
2314 spin_unlock(&redirect_lock);
2315 return 0;
2319 * tiocsetd - set line discipline
2320 * @tty: tty device
2321 * @p: pointer to user data
2323 * Set the line discipline according to user request.
2325 * Locking: see tty_set_ldisc, this function is just a helper
2328 static int tiocsetd(struct tty_struct *tty, int __user *p)
2330 int disc;
2331 int ret;
2333 if (get_user(disc, p))
2334 return -EFAULT;
2336 ret = tty_set_ldisc(tty, disc);
2338 return ret;
2342 * tiocgetd - get line discipline
2343 * @tty: tty device
2344 * @p: pointer to user data
2346 * Retrieves the line discipline id directly from the ldisc.
2348 * Locking: waits for ldisc reference (in case the line discipline
2349 * is changing or the tty is being hungup)
2352 static int tiocgetd(struct tty_struct *tty, int __user *p)
2354 struct tty_ldisc *ld;
2355 int ret;
2357 ld = tty_ldisc_ref_wait(tty);
2358 if (!ld)
2359 return -EIO;
2360 ret = put_user(ld->ops->num, p);
2361 tty_ldisc_deref(ld);
2362 return ret;
2366 * send_break - performed time break
2367 * @tty: device to break on
2368 * @duration: timeout in mS
2370 * Perform a timed break on hardware that lacks its own driver level
2371 * timed break functionality.
2373 * Locking:
2374 * atomic_write_lock serializes
2378 static int send_break(struct tty_struct *tty, unsigned int duration)
2380 int retval;
2382 if (tty->ops->break_ctl == NULL)
2383 return 0;
2385 if (tty->driver->flags & TTY_DRIVER_HARDWARE_BREAK)
2386 retval = tty->ops->break_ctl(tty, duration);
2387 else {
2388 /* Do the work ourselves */
2389 if (tty_write_lock(tty, 0) < 0)
2390 return -EINTR;
2391 retval = tty->ops->break_ctl(tty, -1);
2392 if (retval)
2393 goto out;
2394 if (!signal_pending(current))
2395 msleep_interruptible(duration);
2396 retval = tty->ops->break_ctl(tty, 0);
2397 out:
2398 tty_write_unlock(tty);
2399 if (signal_pending(current))
2400 retval = -EINTR;
2402 return retval;
2406 * tty_tiocmget - get modem status
2407 * @tty: tty device
2408 * @p: pointer to result
2410 * Obtain the modem status bits from the tty driver if the feature
2411 * is supported. Return -EINVAL if it is not available.
2413 * Locking: none (up to the driver)
2416 static int tty_tiocmget(struct tty_struct *tty, int __user *p)
2418 int retval = -EINVAL;
2420 if (tty->ops->tiocmget) {
2421 retval = tty->ops->tiocmget(tty);
2423 if (retval >= 0)
2424 retval = put_user(retval, p);
2426 return retval;
2430 * tty_tiocmset - set modem status
2431 * @tty: tty device
2432 * @cmd: command - clear bits, set bits or set all
2433 * @p: pointer to desired bits
2435 * Set the modem status bits from the tty driver if the feature
2436 * is supported. Return -EINVAL if it is not available.
2438 * Locking: none (up to the driver)
2441 static int tty_tiocmset(struct tty_struct *tty, unsigned int cmd,
2442 unsigned __user *p)
2444 int retval;
2445 unsigned int set, clear, val;
2447 if (tty->ops->tiocmset == NULL)
2448 return -EINVAL;
2450 retval = get_user(val, p);
2451 if (retval)
2452 return retval;
2453 set = clear = 0;
2454 switch (cmd) {
2455 case TIOCMBIS:
2456 set = val;
2457 break;
2458 case TIOCMBIC:
2459 clear = val;
2460 break;
2461 case TIOCMSET:
2462 set = val;
2463 clear = ~val;
2464 break;
2466 set &= TIOCM_DTR|TIOCM_RTS|TIOCM_OUT1|TIOCM_OUT2|TIOCM_LOOP;
2467 clear &= TIOCM_DTR|TIOCM_RTS|TIOCM_OUT1|TIOCM_OUT2|TIOCM_LOOP;
2468 return tty->ops->tiocmset(tty, set, clear);
2471 static int tty_tiocgicount(struct tty_struct *tty, void __user *arg)
2473 int retval = -EINVAL;
2474 struct serial_icounter_struct icount;
2475 memset(&icount, 0, sizeof(icount));
2476 if (tty->ops->get_icount)
2477 retval = tty->ops->get_icount(tty, &icount);
2478 if (retval != 0)
2479 return retval;
2480 if (copy_to_user(arg, &icount, sizeof(icount)))
2481 return -EFAULT;
2482 return 0;
2485 static int tty_tiocsserial(struct tty_struct *tty, struct serial_struct __user *ss)
2487 static DEFINE_RATELIMIT_STATE(depr_flags,
2488 DEFAULT_RATELIMIT_INTERVAL,
2489 DEFAULT_RATELIMIT_BURST);
2490 char comm[TASK_COMM_LEN];
2491 struct serial_struct v;
2492 int flags;
2494 if (copy_from_user(&v, ss, sizeof(*ss)))
2495 return -EFAULT;
2497 flags = v.flags & ASYNC_DEPRECATED;
2499 if (flags && __ratelimit(&depr_flags))
2500 pr_warn("%s: '%s' is using deprecated serial flags (with no effect): %.8x\n",
2501 __func__, get_task_comm(comm, current), flags);
2502 if (!tty->ops->set_serial)
2503 return -ENOTTY;
2504 return tty->ops->set_serial(tty, &v);
2507 static int tty_tiocgserial(struct tty_struct *tty, struct serial_struct __user *ss)
2509 struct serial_struct v;
2510 int err;
2512 memset(&v, 0, sizeof(v));
2513 if (!tty->ops->get_serial)
2514 return -ENOTTY;
2515 err = tty->ops->get_serial(tty, &v);
2516 if (!err && copy_to_user(ss, &v, sizeof(v)))
2517 err = -EFAULT;
2518 return err;
2522 * if pty, return the slave side (real_tty)
2523 * otherwise, return self
2525 static struct tty_struct *tty_pair_get_tty(struct tty_struct *tty)
2527 if (tty->driver->type == TTY_DRIVER_TYPE_PTY &&
2528 tty->driver->subtype == PTY_TYPE_MASTER)
2529 tty = tty->link;
2530 return tty;
2534 * Split this up, as gcc can choke on it otherwise..
2536 long tty_ioctl(struct file *file, unsigned int cmd, unsigned long arg)
2538 struct tty_struct *tty = file_tty(file);
2539 struct tty_struct *real_tty;
2540 void __user *p = (void __user *)arg;
2541 int retval;
2542 struct tty_ldisc *ld;
2544 if (tty_paranoia_check(tty, file_inode(file), "tty_ioctl"))
2545 return -EINVAL;
2547 real_tty = tty_pair_get_tty(tty);
2550 * Factor out some common prep work
2552 switch (cmd) {
2553 case TIOCSETD:
2554 case TIOCSBRK:
2555 case TIOCCBRK:
2556 case TCSBRK:
2557 case TCSBRKP:
2558 retval = tty_check_change(tty);
2559 if (retval)
2560 return retval;
2561 if (cmd != TIOCCBRK) {
2562 tty_wait_until_sent(tty, 0);
2563 if (signal_pending(current))
2564 return -EINTR;
2566 break;
2570 * Now do the stuff.
2572 switch (cmd) {
2573 case TIOCSTI:
2574 return tiocsti(tty, p);
2575 case TIOCGWINSZ:
2576 return tiocgwinsz(real_tty, p);
2577 case TIOCSWINSZ:
2578 return tiocswinsz(real_tty, p);
2579 case TIOCCONS:
2580 return real_tty != tty ? -EINVAL : tioccons(file);
2581 case TIOCEXCL:
2582 set_bit(TTY_EXCLUSIVE, &tty->flags);
2583 return 0;
2584 case TIOCNXCL:
2585 clear_bit(TTY_EXCLUSIVE, &tty->flags);
2586 return 0;
2587 case TIOCGEXCL:
2589 int excl = test_bit(TTY_EXCLUSIVE, &tty->flags);
2590 return put_user(excl, (int __user *)p);
2592 case TIOCGETD:
2593 return tiocgetd(tty, p);
2594 case TIOCSETD:
2595 return tiocsetd(tty, p);
2596 case TIOCVHANGUP:
2597 if (!capable(CAP_SYS_ADMIN))
2598 return -EPERM;
2599 tty_vhangup(tty);
2600 return 0;
2601 case TIOCGDEV:
2603 unsigned int ret = new_encode_dev(tty_devnum(real_tty));
2604 return put_user(ret, (unsigned int __user *)p);
2607 * Break handling
2609 case TIOCSBRK: /* Turn break on, unconditionally */
2610 if (tty->ops->break_ctl)
2611 return tty->ops->break_ctl(tty, -1);
2612 return 0;
2613 case TIOCCBRK: /* Turn break off, unconditionally */
2614 if (tty->ops->break_ctl)
2615 return tty->ops->break_ctl(tty, 0);
2616 return 0;
2617 case TCSBRK: /* SVID version: non-zero arg --> no break */
2618 /* non-zero arg means wait for all output data
2619 * to be sent (performed above) but don't send break.
2620 * This is used by the tcdrain() termios function.
2622 if (!arg)
2623 return send_break(tty, 250);
2624 return 0;
2625 case TCSBRKP: /* support for POSIX tcsendbreak() */
2626 return send_break(tty, arg ? arg*100 : 250);
2628 case TIOCMGET:
2629 return tty_tiocmget(tty, p);
2630 case TIOCMSET:
2631 case TIOCMBIC:
2632 case TIOCMBIS:
2633 return tty_tiocmset(tty, cmd, p);
2634 case TIOCGICOUNT:
2635 return tty_tiocgicount(tty, p);
2636 case TCFLSH:
2637 switch (arg) {
2638 case TCIFLUSH:
2639 case TCIOFLUSH:
2640 /* flush tty buffer and allow ldisc to process ioctl */
2641 tty_buffer_flush(tty, NULL);
2642 break;
2644 break;
2645 case TIOCSSERIAL:
2646 return tty_tiocsserial(tty, p);
2647 case TIOCGSERIAL:
2648 return tty_tiocgserial(tty, p);
2649 case TIOCGPTPEER:
2650 /* Special because the struct file is needed */
2651 return ptm_open_peer(file, tty, (int)arg);
2652 default:
2653 retval = tty_jobctrl_ioctl(tty, real_tty, file, cmd, arg);
2654 if (retval != -ENOIOCTLCMD)
2655 return retval;
2657 if (tty->ops->ioctl) {
2658 retval = tty->ops->ioctl(tty, cmd, arg);
2659 if (retval != -ENOIOCTLCMD)
2660 return retval;
2662 ld = tty_ldisc_ref_wait(tty);
2663 if (!ld)
2664 return hung_up_tty_ioctl(file, cmd, arg);
2665 retval = -EINVAL;
2666 if (ld->ops->ioctl) {
2667 retval = ld->ops->ioctl(tty, file, cmd, arg);
2668 if (retval == -ENOIOCTLCMD)
2669 retval = -ENOTTY;
2671 tty_ldisc_deref(ld);
2672 return retval;
2675 #ifdef CONFIG_COMPAT
2677 struct serial_struct32 {
2678 compat_int_t type;
2679 compat_int_t line;
2680 compat_uint_t port;
2681 compat_int_t irq;
2682 compat_int_t flags;
2683 compat_int_t xmit_fifo_size;
2684 compat_int_t custom_divisor;
2685 compat_int_t baud_base;
2686 unsigned short close_delay;
2687 char io_type;
2688 char reserved_char;
2689 compat_int_t hub6;
2690 unsigned short closing_wait; /* time to wait before closing */
2691 unsigned short closing_wait2; /* no longer used... */
2692 compat_uint_t iomem_base;
2693 unsigned short iomem_reg_shift;
2694 unsigned int port_high;
2695 /* compat_ulong_t iomap_base FIXME */
2696 compat_int_t reserved;
2699 static int compat_tty_tiocsserial(struct tty_struct *tty,
2700 struct serial_struct32 __user *ss)
2702 static DEFINE_RATELIMIT_STATE(depr_flags,
2703 DEFAULT_RATELIMIT_INTERVAL,
2704 DEFAULT_RATELIMIT_BURST);
2705 char comm[TASK_COMM_LEN];
2706 struct serial_struct32 v32;
2707 struct serial_struct v;
2708 int flags;
2710 if (copy_from_user(&v32, ss, sizeof(*ss)))
2711 return -EFAULT;
2713 memcpy(&v, &v32, offsetof(struct serial_struct32, iomem_base));
2714 v.iomem_base = compat_ptr(v32.iomem_base);
2715 v.iomem_reg_shift = v32.iomem_reg_shift;
2716 v.port_high = v32.port_high;
2717 v.iomap_base = 0;
2719 flags = v.flags & ASYNC_DEPRECATED;
2721 if (flags && __ratelimit(&depr_flags))
2722 pr_warn("%s: '%s' is using deprecated serial flags (with no effect): %.8x\n",
2723 __func__, get_task_comm(comm, current), flags);
2724 if (!tty->ops->set_serial)
2725 return -ENOTTY;
2726 return tty->ops->set_serial(tty, &v);
2729 static int compat_tty_tiocgserial(struct tty_struct *tty,
2730 struct serial_struct32 __user *ss)
2732 struct serial_struct32 v32;
2733 struct serial_struct v;
2734 int err;
2736 memset(&v, 0, sizeof(v));
2737 memset(&v32, 0, sizeof(v32));
2739 if (!tty->ops->get_serial)
2740 return -ENOTTY;
2741 err = tty->ops->get_serial(tty, &v);
2742 if (!err) {
2743 memcpy(&v32, &v, offsetof(struct serial_struct32, iomem_base));
2744 v32.iomem_base = (unsigned long)v.iomem_base >> 32 ?
2745 0xfffffff : ptr_to_compat(v.iomem_base);
2746 v32.iomem_reg_shift = v.iomem_reg_shift;
2747 v32.port_high = v.port_high;
2748 if (copy_to_user(ss, &v32, sizeof(v32)))
2749 err = -EFAULT;
2751 return err;
2753 static long tty_compat_ioctl(struct file *file, unsigned int cmd,
2754 unsigned long arg)
2756 struct tty_struct *tty = file_tty(file);
2757 struct tty_ldisc *ld;
2758 int retval = -ENOIOCTLCMD;
2760 switch (cmd) {
2761 case TIOCOUTQ:
2762 case TIOCSTI:
2763 case TIOCGWINSZ:
2764 case TIOCSWINSZ:
2765 case TIOCGEXCL:
2766 case TIOCGETD:
2767 case TIOCSETD:
2768 case TIOCGDEV:
2769 case TIOCMGET:
2770 case TIOCMSET:
2771 case TIOCMBIC:
2772 case TIOCMBIS:
2773 case TIOCGICOUNT:
2774 case TIOCGPGRP:
2775 case TIOCSPGRP:
2776 case TIOCGSID:
2777 case TIOCSERGETLSR:
2778 case TIOCGRS485:
2779 case TIOCSRS485:
2780 #ifdef TIOCGETP
2781 case TIOCGETP:
2782 case TIOCSETP:
2783 case TIOCSETN:
2784 #endif
2785 #ifdef TIOCGETC
2786 case TIOCGETC:
2787 case TIOCSETC:
2788 #endif
2789 #ifdef TIOCGLTC
2790 case TIOCGLTC:
2791 case TIOCSLTC:
2792 #endif
2793 case TCSETSF:
2794 case TCSETSW:
2795 case TCSETS:
2796 case TCGETS:
2797 #ifdef TCGETS2
2798 case TCGETS2:
2799 case TCSETSF2:
2800 case TCSETSW2:
2801 case TCSETS2:
2802 #endif
2803 case TCGETA:
2804 case TCSETAF:
2805 case TCSETAW:
2806 case TCSETA:
2807 case TIOCGLCKTRMIOS:
2808 case TIOCSLCKTRMIOS:
2809 #ifdef TCGETX
2810 case TCGETX:
2811 case TCSETX:
2812 case TCSETXW:
2813 case TCSETXF:
2814 #endif
2815 case TIOCGSOFTCAR:
2816 case TIOCSSOFTCAR:
2818 case PPPIOCGCHAN:
2819 case PPPIOCGUNIT:
2820 return tty_ioctl(file, cmd, (unsigned long)compat_ptr(arg));
2821 case TIOCCONS:
2822 case TIOCEXCL:
2823 case TIOCNXCL:
2824 case TIOCVHANGUP:
2825 case TIOCSBRK:
2826 case TIOCCBRK:
2827 case TCSBRK:
2828 case TCSBRKP:
2829 case TCFLSH:
2830 case TIOCGPTPEER:
2831 case TIOCNOTTY:
2832 case TIOCSCTTY:
2833 case TCXONC:
2834 case TIOCMIWAIT:
2835 case TIOCSERCONFIG:
2836 return tty_ioctl(file, cmd, arg);
2839 if (tty_paranoia_check(tty, file_inode(file), "tty_ioctl"))
2840 return -EINVAL;
2842 switch (cmd) {
2843 case TIOCSSERIAL:
2844 return compat_tty_tiocsserial(tty, compat_ptr(arg));
2845 case TIOCGSERIAL:
2846 return compat_tty_tiocgserial(tty, compat_ptr(arg));
2848 if (tty->ops->compat_ioctl) {
2849 retval = tty->ops->compat_ioctl(tty, cmd, arg);
2850 if (retval != -ENOIOCTLCMD)
2851 return retval;
2854 ld = tty_ldisc_ref_wait(tty);
2855 if (!ld)
2856 return hung_up_tty_compat_ioctl(file, cmd, arg);
2857 if (ld->ops->compat_ioctl)
2858 retval = ld->ops->compat_ioctl(tty, file, cmd, arg);
2859 if (retval == -ENOIOCTLCMD && ld->ops->ioctl)
2860 retval = ld->ops->ioctl(tty, file,
2861 (unsigned long)compat_ptr(cmd), arg);
2862 tty_ldisc_deref(ld);
2864 return retval;
2866 #endif
2868 static int this_tty(const void *t, struct file *file, unsigned fd)
2870 if (likely(file->f_op->read != tty_read))
2871 return 0;
2872 return file_tty(file) != t ? 0 : fd + 1;
2876 * This implements the "Secure Attention Key" --- the idea is to
2877 * prevent trojan horses by killing all processes associated with this
2878 * tty when the user hits the "Secure Attention Key". Required for
2879 * super-paranoid applications --- see the Orange Book for more details.
2881 * This code could be nicer; ideally it should send a HUP, wait a few
2882 * seconds, then send a INT, and then a KILL signal. But you then
2883 * have to coordinate with the init process, since all processes associated
2884 * with the current tty must be dead before the new getty is allowed
2885 * to spawn.
2887 * Now, if it would be correct ;-/ The current code has a nasty hole -
2888 * it doesn't catch files in flight. We may send the descriptor to ourselves
2889 * via AF_UNIX socket, close it and later fetch from socket. FIXME.
2891 * Nasty bug: do_SAK is being called in interrupt context. This can
2892 * deadlock. We punt it up to process context. AKPM - 16Mar2001
2894 void __do_SAK(struct tty_struct *tty)
2896 #ifdef TTY_SOFT_SAK
2897 tty_hangup(tty);
2898 #else
2899 struct task_struct *g, *p;
2900 struct pid *session;
2901 int i;
2902 unsigned long flags;
2904 if (!tty)
2905 return;
2907 spin_lock_irqsave(&tty->ctrl_lock, flags);
2908 session = get_pid(tty->session);
2909 spin_unlock_irqrestore(&tty->ctrl_lock, flags);
2911 tty_ldisc_flush(tty);
2913 tty_driver_flush_buffer(tty);
2915 read_lock(&tasklist_lock);
2916 /* Kill the entire session */
2917 do_each_pid_task(session, PIDTYPE_SID, p) {
2918 tty_notice(tty, "SAK: killed process %d (%s): by session\n",
2919 task_pid_nr(p), p->comm);
2920 group_send_sig_info(SIGKILL, SEND_SIG_PRIV, p, PIDTYPE_SID);
2921 } while_each_pid_task(session, PIDTYPE_SID, p);
2923 /* Now kill any processes that happen to have the tty open */
2924 do_each_thread(g, p) {
2925 if (p->signal->tty == tty) {
2926 tty_notice(tty, "SAK: killed process %d (%s): by controlling tty\n",
2927 task_pid_nr(p), p->comm);
2928 group_send_sig_info(SIGKILL, SEND_SIG_PRIV, p, PIDTYPE_SID);
2929 continue;
2931 task_lock(p);
2932 i = iterate_fd(p->files, 0, this_tty, tty);
2933 if (i != 0) {
2934 tty_notice(tty, "SAK: killed process %d (%s): by fd#%d\n",
2935 task_pid_nr(p), p->comm, i - 1);
2936 group_send_sig_info(SIGKILL, SEND_SIG_PRIV, p, PIDTYPE_SID);
2938 task_unlock(p);
2939 } while_each_thread(g, p);
2940 read_unlock(&tasklist_lock);
2941 put_pid(session);
2942 #endif
2945 static void do_SAK_work(struct work_struct *work)
2947 struct tty_struct *tty =
2948 container_of(work, struct tty_struct, SAK_work);
2949 __do_SAK(tty);
2953 * The tq handling here is a little racy - tty->SAK_work may already be queued.
2954 * Fortunately we don't need to worry, because if ->SAK_work is already queued,
2955 * the values which we write to it will be identical to the values which it
2956 * already has. --akpm
2958 void do_SAK(struct tty_struct *tty)
2960 if (!tty)
2961 return;
2962 schedule_work(&tty->SAK_work);
2965 EXPORT_SYMBOL(do_SAK);
2967 /* Must put_device() after it's unused! */
2968 static struct device *tty_get_device(struct tty_struct *tty)
2970 dev_t devt = tty_devnum(tty);
2971 return class_find_device_by_devt(tty_class, devt);
2976 * alloc_tty_struct
2978 * This subroutine allocates and initializes a tty structure.
2980 * Locking: none - tty in question is not exposed at this point
2983 struct tty_struct *alloc_tty_struct(struct tty_driver *driver, int idx)
2985 struct tty_struct *tty;
2987 tty = kzalloc(sizeof(*tty), GFP_KERNEL);
2988 if (!tty)
2989 return NULL;
2991 kref_init(&tty->kref);
2992 tty->magic = TTY_MAGIC;
2993 if (tty_ldisc_init(tty)) {
2994 kfree(tty);
2995 return NULL;
2997 tty->session = NULL;
2998 tty->pgrp = NULL;
2999 mutex_init(&tty->legacy_mutex);
3000 mutex_init(&tty->throttle_mutex);
3001 init_rwsem(&tty->termios_rwsem);
3002 mutex_init(&tty->winsize_mutex);
3003 init_ldsem(&tty->ldisc_sem);
3004 init_waitqueue_head(&tty->write_wait);
3005 init_waitqueue_head(&tty->read_wait);
3006 INIT_WORK(&tty->hangup_work, do_tty_hangup);
3007 mutex_init(&tty->atomic_write_lock);
3008 spin_lock_init(&tty->ctrl_lock);
3009 spin_lock_init(&tty->flow_lock);
3010 spin_lock_init(&tty->files_lock);
3011 INIT_LIST_HEAD(&tty->tty_files);
3012 INIT_WORK(&tty->SAK_work, do_SAK_work);
3014 tty->driver = driver;
3015 tty->ops = driver->ops;
3016 tty->index = idx;
3017 tty_line_name(driver, idx, tty->name);
3018 tty->dev = tty_get_device(tty);
3020 return tty;
3024 * tty_put_char - write one character to a tty
3025 * @tty: tty
3026 * @ch: character
3028 * Write one byte to the tty using the provided put_char method
3029 * if present. Returns the number of characters successfully output.
3031 * Note: the specific put_char operation in the driver layer may go
3032 * away soon. Don't call it directly, use this method
3035 int tty_put_char(struct tty_struct *tty, unsigned char ch)
3037 if (tty->ops->put_char)
3038 return tty->ops->put_char(tty, ch);
3039 return tty->ops->write(tty, &ch, 1);
3041 EXPORT_SYMBOL_GPL(tty_put_char);
3043 struct class *tty_class;
3045 static int tty_cdev_add(struct tty_driver *driver, dev_t dev,
3046 unsigned int index, unsigned int count)
3048 int err;
3050 /* init here, since reused cdevs cause crashes */
3051 driver->cdevs[index] = cdev_alloc();
3052 if (!driver->cdevs[index])
3053 return -ENOMEM;
3054 driver->cdevs[index]->ops = &tty_fops;
3055 driver->cdevs[index]->owner = driver->owner;
3056 err = cdev_add(driver->cdevs[index], dev, count);
3057 if (err)
3058 kobject_put(&driver->cdevs[index]->kobj);
3059 return err;
3063 * tty_register_device - register a tty device
3064 * @driver: the tty driver that describes the tty device
3065 * @index: the index in the tty driver for this tty device
3066 * @device: a struct device that is associated with this tty device.
3067 * This field is optional, if there is no known struct device
3068 * for this tty device it can be set to NULL safely.
3070 * Returns a pointer to the struct device for this tty device
3071 * (or ERR_PTR(-EFOO) on error).
3073 * This call is required to be made to register an individual tty device
3074 * if the tty driver's flags have the TTY_DRIVER_DYNAMIC_DEV bit set. If
3075 * that bit is not set, this function should not be called by a tty
3076 * driver.
3078 * Locking: ??
3081 struct device *tty_register_device(struct tty_driver *driver, unsigned index,
3082 struct device *device)
3084 return tty_register_device_attr(driver, index, device, NULL, NULL);
3086 EXPORT_SYMBOL(tty_register_device);
3088 static void tty_device_create_release(struct device *dev)
3090 dev_dbg(dev, "releasing...\n");
3091 kfree(dev);
3095 * tty_register_device_attr - register a tty device
3096 * @driver: the tty driver that describes the tty device
3097 * @index: the index in the tty driver for this tty device
3098 * @device: a struct device that is associated with this tty device.
3099 * This field is optional, if there is no known struct device
3100 * for this tty device it can be set to NULL safely.
3101 * @drvdata: Driver data to be set to device.
3102 * @attr_grp: Attribute group to be set on device.
3104 * Returns a pointer to the struct device for this tty device
3105 * (or ERR_PTR(-EFOO) on error).
3107 * This call is required to be made to register an individual tty device
3108 * if the tty driver's flags have the TTY_DRIVER_DYNAMIC_DEV bit set. If
3109 * that bit is not set, this function should not be called by a tty
3110 * driver.
3112 * Locking: ??
3114 struct device *tty_register_device_attr(struct tty_driver *driver,
3115 unsigned index, struct device *device,
3116 void *drvdata,
3117 const struct attribute_group **attr_grp)
3119 char name[64];
3120 dev_t devt = MKDEV(driver->major, driver->minor_start) + index;
3121 struct ktermios *tp;
3122 struct device *dev;
3123 int retval;
3125 if (index >= driver->num) {
3126 pr_err("%s: Attempt to register invalid tty line number (%d)\n",
3127 driver->name, index);
3128 return ERR_PTR(-EINVAL);
3131 if (driver->type == TTY_DRIVER_TYPE_PTY)
3132 pty_line_name(driver, index, name);
3133 else
3134 tty_line_name(driver, index, name);
3136 dev = kzalloc(sizeof(*dev), GFP_KERNEL);
3137 if (!dev)
3138 return ERR_PTR(-ENOMEM);
3140 dev->devt = devt;
3141 dev->class = tty_class;
3142 dev->parent = device;
3143 dev->release = tty_device_create_release;
3144 dev_set_name(dev, "%s", name);
3145 dev->groups = attr_grp;
3146 dev_set_drvdata(dev, drvdata);
3148 dev_set_uevent_suppress(dev, 1);
3150 retval = device_register(dev);
3151 if (retval)
3152 goto err_put;
3154 if (!(driver->flags & TTY_DRIVER_DYNAMIC_ALLOC)) {
3156 * Free any saved termios data so that the termios state is
3157 * reset when reusing a minor number.
3159 tp = driver->termios[index];
3160 if (tp) {
3161 driver->termios[index] = NULL;
3162 kfree(tp);
3165 retval = tty_cdev_add(driver, devt, index, 1);
3166 if (retval)
3167 goto err_del;
3170 dev_set_uevent_suppress(dev, 0);
3171 kobject_uevent(&dev->kobj, KOBJ_ADD);
3173 return dev;
3175 err_del:
3176 device_del(dev);
3177 err_put:
3178 put_device(dev);
3180 return ERR_PTR(retval);
3182 EXPORT_SYMBOL_GPL(tty_register_device_attr);
3185 * tty_unregister_device - unregister a tty device
3186 * @driver: the tty driver that describes the tty device
3187 * @index: the index in the tty driver for this tty device
3189 * If a tty device is registered with a call to tty_register_device() then
3190 * this function must be called when the tty device is gone.
3192 * Locking: ??
3195 void tty_unregister_device(struct tty_driver *driver, unsigned index)
3197 device_destroy(tty_class,
3198 MKDEV(driver->major, driver->minor_start) + index);
3199 if (!(driver->flags & TTY_DRIVER_DYNAMIC_ALLOC)) {
3200 cdev_del(driver->cdevs[index]);
3201 driver->cdevs[index] = NULL;
3204 EXPORT_SYMBOL(tty_unregister_device);
3207 * __tty_alloc_driver -- allocate tty driver
3208 * @lines: count of lines this driver can handle at most
3209 * @owner: module which is responsible for this driver
3210 * @flags: some of TTY_DRIVER_* flags, will be set in driver->flags
3212 * This should not be called directly, some of the provided macros should be
3213 * used instead. Use IS_ERR and friends on @retval.
3215 struct tty_driver *__tty_alloc_driver(unsigned int lines, struct module *owner,
3216 unsigned long flags)
3218 struct tty_driver *driver;
3219 unsigned int cdevs = 1;
3220 int err;
3222 if (!lines || (flags & TTY_DRIVER_UNNUMBERED_NODE && lines > 1))
3223 return ERR_PTR(-EINVAL);
3225 driver = kzalloc(sizeof(*driver), GFP_KERNEL);
3226 if (!driver)
3227 return ERR_PTR(-ENOMEM);
3229 kref_init(&driver->kref);
3230 driver->magic = TTY_DRIVER_MAGIC;
3231 driver->num = lines;
3232 driver->owner = owner;
3233 driver->flags = flags;
3235 if (!(flags & TTY_DRIVER_DEVPTS_MEM)) {
3236 driver->ttys = kcalloc(lines, sizeof(*driver->ttys),
3237 GFP_KERNEL);
3238 driver->termios = kcalloc(lines, sizeof(*driver->termios),
3239 GFP_KERNEL);
3240 if (!driver->ttys || !driver->termios) {
3241 err = -ENOMEM;
3242 goto err_free_all;
3246 if (!(flags & TTY_DRIVER_DYNAMIC_ALLOC)) {
3247 driver->ports = kcalloc(lines, sizeof(*driver->ports),
3248 GFP_KERNEL);
3249 if (!driver->ports) {
3250 err = -ENOMEM;
3251 goto err_free_all;
3253 cdevs = lines;
3256 driver->cdevs = kcalloc(cdevs, sizeof(*driver->cdevs), GFP_KERNEL);
3257 if (!driver->cdevs) {
3258 err = -ENOMEM;
3259 goto err_free_all;
3262 return driver;
3263 err_free_all:
3264 kfree(driver->ports);
3265 kfree(driver->ttys);
3266 kfree(driver->termios);
3267 kfree(driver->cdevs);
3268 kfree(driver);
3269 return ERR_PTR(err);
3271 EXPORT_SYMBOL(__tty_alloc_driver);
3273 static void destruct_tty_driver(struct kref *kref)
3275 struct tty_driver *driver = container_of(kref, struct tty_driver, kref);
3276 int i;
3277 struct ktermios *tp;
3279 if (driver->flags & TTY_DRIVER_INSTALLED) {
3280 for (i = 0; i < driver->num; i++) {
3281 tp = driver->termios[i];
3282 if (tp) {
3283 driver->termios[i] = NULL;
3284 kfree(tp);
3286 if (!(driver->flags & TTY_DRIVER_DYNAMIC_DEV))
3287 tty_unregister_device(driver, i);
3289 proc_tty_unregister_driver(driver);
3290 if (driver->flags & TTY_DRIVER_DYNAMIC_ALLOC)
3291 cdev_del(driver->cdevs[0]);
3293 kfree(driver->cdevs);
3294 kfree(driver->ports);
3295 kfree(driver->termios);
3296 kfree(driver->ttys);
3297 kfree(driver);
3300 void tty_driver_kref_put(struct tty_driver *driver)
3302 kref_put(&driver->kref, destruct_tty_driver);
3304 EXPORT_SYMBOL(tty_driver_kref_put);
3306 void tty_set_operations(struct tty_driver *driver,
3307 const struct tty_operations *op)
3309 driver->ops = op;
3311 EXPORT_SYMBOL(tty_set_operations);
3313 void put_tty_driver(struct tty_driver *d)
3315 tty_driver_kref_put(d);
3317 EXPORT_SYMBOL(put_tty_driver);
3320 * Called by a tty driver to register itself.
3322 int tty_register_driver(struct tty_driver *driver)
3324 int error;
3325 int i;
3326 dev_t dev;
3327 struct device *d;
3329 if (!driver->major) {
3330 error = alloc_chrdev_region(&dev, driver->minor_start,
3331 driver->num, driver->name);
3332 if (!error) {
3333 driver->major = MAJOR(dev);
3334 driver->minor_start = MINOR(dev);
3336 } else {
3337 dev = MKDEV(driver->major, driver->minor_start);
3338 error = register_chrdev_region(dev, driver->num, driver->name);
3340 if (error < 0)
3341 goto err;
3343 if (driver->flags & TTY_DRIVER_DYNAMIC_ALLOC) {
3344 error = tty_cdev_add(driver, dev, 0, driver->num);
3345 if (error)
3346 goto err_unreg_char;
3349 mutex_lock(&tty_mutex);
3350 list_add(&driver->tty_drivers, &tty_drivers);
3351 mutex_unlock(&tty_mutex);
3353 if (!(driver->flags & TTY_DRIVER_DYNAMIC_DEV)) {
3354 for (i = 0; i < driver->num; i++) {
3355 d = tty_register_device(driver, i, NULL);
3356 if (IS_ERR(d)) {
3357 error = PTR_ERR(d);
3358 goto err_unreg_devs;
3362 proc_tty_register_driver(driver);
3363 driver->flags |= TTY_DRIVER_INSTALLED;
3364 return 0;
3366 err_unreg_devs:
3367 for (i--; i >= 0; i--)
3368 tty_unregister_device(driver, i);
3370 mutex_lock(&tty_mutex);
3371 list_del(&driver->tty_drivers);
3372 mutex_unlock(&tty_mutex);
3374 err_unreg_char:
3375 unregister_chrdev_region(dev, driver->num);
3376 err:
3377 return error;
3379 EXPORT_SYMBOL(tty_register_driver);
3382 * Called by a tty driver to unregister itself.
3384 int tty_unregister_driver(struct tty_driver *driver)
3386 #if 0
3387 /* FIXME */
3388 if (driver->refcount)
3389 return -EBUSY;
3390 #endif
3391 unregister_chrdev_region(MKDEV(driver->major, driver->minor_start),
3392 driver->num);
3393 mutex_lock(&tty_mutex);
3394 list_del(&driver->tty_drivers);
3395 mutex_unlock(&tty_mutex);
3396 return 0;
3399 EXPORT_SYMBOL(tty_unregister_driver);
3401 dev_t tty_devnum(struct tty_struct *tty)
3403 return MKDEV(tty->driver->major, tty->driver->minor_start) + tty->index;
3405 EXPORT_SYMBOL(tty_devnum);
3407 void tty_default_fops(struct file_operations *fops)
3409 *fops = tty_fops;
3412 static char *tty_devnode(struct device *dev, umode_t *mode)
3414 if (!mode)
3415 return NULL;
3416 if (dev->devt == MKDEV(TTYAUX_MAJOR, 0) ||
3417 dev->devt == MKDEV(TTYAUX_MAJOR, 2))
3418 *mode = 0666;
3419 return NULL;
3422 static int __init tty_class_init(void)
3424 tty_class = class_create(THIS_MODULE, "tty");
3425 if (IS_ERR(tty_class))
3426 return PTR_ERR(tty_class);
3427 tty_class->devnode = tty_devnode;
3428 return 0;
3431 postcore_initcall(tty_class_init);
3433 /* 3/2004 jmc: why do these devices exist? */
3434 static struct cdev tty_cdev, console_cdev;
3436 static ssize_t show_cons_active(struct device *dev,
3437 struct device_attribute *attr, char *buf)
3439 struct console *cs[16];
3440 int i = 0;
3441 struct console *c;
3442 ssize_t count = 0;
3444 console_lock();
3445 for_each_console(c) {
3446 if (!c->device)
3447 continue;
3448 if (!c->write)
3449 continue;
3450 if ((c->flags & CON_ENABLED) == 0)
3451 continue;
3452 cs[i++] = c;
3453 if (i >= ARRAY_SIZE(cs))
3454 break;
3456 while (i--) {
3457 int index = cs[i]->index;
3458 struct tty_driver *drv = cs[i]->device(cs[i], &index);
3460 /* don't resolve tty0 as some programs depend on it */
3461 if (drv && (cs[i]->index > 0 || drv->major != TTY_MAJOR))
3462 count += tty_line_name(drv, index, buf + count);
3463 else
3464 count += sprintf(buf + count, "%s%d",
3465 cs[i]->name, cs[i]->index);
3467 count += sprintf(buf + count, "%c", i ? ' ':'\n');
3469 console_unlock();
3471 return count;
3473 static DEVICE_ATTR(active, S_IRUGO, show_cons_active, NULL);
3475 static struct attribute *cons_dev_attrs[] = {
3476 &dev_attr_active.attr,
3477 NULL
3480 ATTRIBUTE_GROUPS(cons_dev);
3482 static struct device *consdev;
3484 void console_sysfs_notify(void)
3486 if (consdev)
3487 sysfs_notify(&consdev->kobj, NULL, "active");
3491 * Ok, now we can initialize the rest of the tty devices and can count
3492 * on memory allocations, interrupts etc..
3494 int __init tty_init(void)
3496 tty_sysctl_init();
3497 cdev_init(&tty_cdev, &tty_fops);
3498 if (cdev_add(&tty_cdev, MKDEV(TTYAUX_MAJOR, 0), 1) ||
3499 register_chrdev_region(MKDEV(TTYAUX_MAJOR, 0), 1, "/dev/tty") < 0)
3500 panic("Couldn't register /dev/tty driver\n");
3501 device_create(tty_class, NULL, MKDEV(TTYAUX_MAJOR, 0), NULL, "tty");
3503 cdev_init(&console_cdev, &console_fops);
3504 if (cdev_add(&console_cdev, MKDEV(TTYAUX_MAJOR, 1), 1) ||
3505 register_chrdev_region(MKDEV(TTYAUX_MAJOR, 1), 1, "/dev/console") < 0)
3506 panic("Couldn't register /dev/console driver\n");
3507 consdev = device_create_with_groups(tty_class, NULL,
3508 MKDEV(TTYAUX_MAJOR, 1), NULL,
3509 cons_dev_groups, "console");
3510 if (IS_ERR(consdev))
3511 consdev = NULL;
3513 #ifdef CONFIG_VT
3514 vty_init(&console_fops);
3515 #endif
3516 return 0;