treewide: remove redundant IS_ERR() before error code check
[linux/fpc-iii.git] / drivers / tty / tty_io.c
bloba1453fe1086217d6a4e137a73fe954acee44676c
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 * @dev_t: 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;
517 extern void tty_sysctl_init(void);
520 * tty_wakeup - request more data
521 * @tty: terminal
523 * Internal and external helper for wakeups of tty. This function
524 * informs the line discipline if present that the driver is ready
525 * to receive more output data.
528 void tty_wakeup(struct tty_struct *tty)
530 struct tty_ldisc *ld;
532 if (test_bit(TTY_DO_WRITE_WAKEUP, &tty->flags)) {
533 ld = tty_ldisc_ref(tty);
534 if (ld) {
535 if (ld->ops->write_wakeup)
536 ld->ops->write_wakeup(tty);
537 tty_ldisc_deref(ld);
540 wake_up_interruptible_poll(&tty->write_wait, EPOLLOUT);
543 EXPORT_SYMBOL_GPL(tty_wakeup);
546 * __tty_hangup - actual handler for hangup events
547 * @work: tty device
549 * This can be called by a "kworker" kernel thread. That is process
550 * synchronous but doesn't hold any locks, so we need to make sure we
551 * have the appropriate locks for what we're doing.
553 * The hangup event clears any pending redirections onto the hung up
554 * device. It ensures future writes will error and it does the needed
555 * line discipline hangup and signal delivery. The tty object itself
556 * remains intact.
558 * Locking:
559 * BTM
560 * redirect lock for undoing redirection
561 * file list lock for manipulating list of ttys
562 * tty_ldiscs_lock from called functions
563 * termios_rwsem resetting termios data
564 * tasklist_lock to walk task list for hangup event
565 * ->siglock to protect ->signal/->sighand
567 static void __tty_hangup(struct tty_struct *tty, int exit_session)
569 struct file *cons_filp = NULL;
570 struct file *filp, *f = NULL;
571 struct tty_file_private *priv;
572 int closecount = 0, n;
573 int refs;
575 if (!tty)
576 return;
579 spin_lock(&redirect_lock);
580 if (redirect && file_tty(redirect) == tty) {
581 f = redirect;
582 redirect = NULL;
584 spin_unlock(&redirect_lock);
586 tty_lock(tty);
588 if (test_bit(TTY_HUPPED, &tty->flags)) {
589 tty_unlock(tty);
590 return;
594 * Some console devices aren't actually hung up for technical and
595 * historical reasons, which can lead to indefinite interruptible
596 * sleep in n_tty_read(). The following explicitly tells
597 * n_tty_read() to abort readers.
599 set_bit(TTY_HUPPING, &tty->flags);
601 /* inuse_filps is protected by the single tty lock,
602 this really needs to change if we want to flush the
603 workqueue with the lock held */
604 check_tty_count(tty, "tty_hangup");
606 spin_lock(&tty->files_lock);
607 /* This breaks for file handles being sent over AF_UNIX sockets ? */
608 list_for_each_entry(priv, &tty->tty_files, list) {
609 filp = priv->file;
610 if (filp->f_op->write == redirected_tty_write)
611 cons_filp = filp;
612 if (filp->f_op->write != tty_write)
613 continue;
614 closecount++;
615 __tty_fasync(-1, filp, 0); /* can't block */
616 filp->f_op = &hung_up_tty_fops;
618 spin_unlock(&tty->files_lock);
620 refs = tty_signal_session_leader(tty, exit_session);
621 /* Account for the p->signal references we killed */
622 while (refs--)
623 tty_kref_put(tty);
625 tty_ldisc_hangup(tty, cons_filp != NULL);
627 spin_lock_irq(&tty->ctrl_lock);
628 clear_bit(TTY_THROTTLED, &tty->flags);
629 clear_bit(TTY_DO_WRITE_WAKEUP, &tty->flags);
630 put_pid(tty->session);
631 put_pid(tty->pgrp);
632 tty->session = NULL;
633 tty->pgrp = NULL;
634 tty->ctrl_status = 0;
635 spin_unlock_irq(&tty->ctrl_lock);
638 * If one of the devices matches a console pointer, we
639 * cannot just call hangup() because that will cause
640 * tty->count and state->count to go out of sync.
641 * So we just call close() the right number of times.
643 if (cons_filp) {
644 if (tty->ops->close)
645 for (n = 0; n < closecount; n++)
646 tty->ops->close(tty, cons_filp);
647 } else if (tty->ops->hangup)
648 tty->ops->hangup(tty);
650 * We don't want to have driver/ldisc interactions beyond the ones
651 * we did here. The driver layer expects no calls after ->hangup()
652 * from the ldisc side, which is now guaranteed.
654 set_bit(TTY_HUPPED, &tty->flags);
655 clear_bit(TTY_HUPPING, &tty->flags);
656 tty_unlock(tty);
658 if (f)
659 fput(f);
662 static void do_tty_hangup(struct work_struct *work)
664 struct tty_struct *tty =
665 container_of(work, struct tty_struct, hangup_work);
667 __tty_hangup(tty, 0);
671 * tty_hangup - trigger a hangup event
672 * @tty: tty to hangup
674 * A carrier loss (virtual or otherwise) has occurred on this like
675 * schedule a hangup sequence to run after this event.
678 void tty_hangup(struct tty_struct *tty)
680 tty_debug_hangup(tty, "hangup\n");
681 schedule_work(&tty->hangup_work);
684 EXPORT_SYMBOL(tty_hangup);
687 * tty_vhangup - process vhangup
688 * @tty: tty to hangup
690 * The user has asked via system call for the terminal to be hung up.
691 * We do this synchronously so that when the syscall returns the process
692 * is complete. That guarantee is necessary for security reasons.
695 void tty_vhangup(struct tty_struct *tty)
697 tty_debug_hangup(tty, "vhangup\n");
698 __tty_hangup(tty, 0);
701 EXPORT_SYMBOL(tty_vhangup);
705 * tty_vhangup_self - process vhangup for own ctty
707 * Perform a vhangup on the current controlling tty
710 void tty_vhangup_self(void)
712 struct tty_struct *tty;
714 tty = get_current_tty();
715 if (tty) {
716 tty_vhangup(tty);
717 tty_kref_put(tty);
722 * tty_vhangup_session - hangup session leader exit
723 * @tty: tty to hangup
725 * The session leader is exiting and hanging up its controlling terminal.
726 * Every process in the foreground process group is signalled SIGHUP.
728 * We do this synchronously so that when the syscall returns the process
729 * is complete. That guarantee is necessary for security reasons.
732 void tty_vhangup_session(struct tty_struct *tty)
734 tty_debug_hangup(tty, "session hangup\n");
735 __tty_hangup(tty, 1);
739 * tty_hung_up_p - was tty hung up
740 * @filp: file pointer of tty
742 * Return true if the tty has been subject to a vhangup or a carrier
743 * loss
746 int tty_hung_up_p(struct file *filp)
748 return (filp && filp->f_op == &hung_up_tty_fops);
751 EXPORT_SYMBOL(tty_hung_up_p);
754 * stop_tty - propagate flow control
755 * @tty: tty to stop
757 * Perform flow control to the driver. May be called
758 * on an already stopped device and will not re-call the driver
759 * method.
761 * This functionality is used by both the line disciplines for
762 * halting incoming flow and by the driver. It may therefore be
763 * called from any context, may be under the tty atomic_write_lock
764 * but not always.
766 * Locking:
767 * flow_lock
770 void __stop_tty(struct tty_struct *tty)
772 if (tty->stopped)
773 return;
774 tty->stopped = 1;
775 if (tty->ops->stop)
776 tty->ops->stop(tty);
779 void stop_tty(struct tty_struct *tty)
781 unsigned long flags;
783 spin_lock_irqsave(&tty->flow_lock, flags);
784 __stop_tty(tty);
785 spin_unlock_irqrestore(&tty->flow_lock, flags);
787 EXPORT_SYMBOL(stop_tty);
790 * start_tty - propagate flow control
791 * @tty: tty to start
793 * Start a tty that has been stopped if at all possible. If this
794 * tty was previous stopped and is now being started, the driver
795 * start method is invoked and the line discipline woken.
797 * Locking:
798 * flow_lock
801 void __start_tty(struct tty_struct *tty)
803 if (!tty->stopped || tty->flow_stopped)
804 return;
805 tty->stopped = 0;
806 if (tty->ops->start)
807 tty->ops->start(tty);
808 tty_wakeup(tty);
811 void start_tty(struct tty_struct *tty)
813 unsigned long flags;
815 spin_lock_irqsave(&tty->flow_lock, flags);
816 __start_tty(tty);
817 spin_unlock_irqrestore(&tty->flow_lock, flags);
819 EXPORT_SYMBOL(start_tty);
821 static void tty_update_time(struct timespec64 *time)
823 time64_t sec = ktime_get_real_seconds();
826 * We only care if the two values differ in anything other than the
827 * lower three bits (i.e every 8 seconds). If so, then we can update
828 * the time of the tty device, otherwise it could be construded as a
829 * security leak to let userspace know the exact timing of the tty.
831 if ((sec ^ time->tv_sec) & ~7)
832 time->tv_sec = sec;
836 * tty_read - read method for tty device files
837 * @file: pointer to tty file
838 * @buf: user buffer
839 * @count: size of user buffer
840 * @ppos: unused
842 * Perform the read system call function on this terminal device. Checks
843 * for hung up devices before calling the line discipline method.
845 * Locking:
846 * Locks the line discipline internally while needed. Multiple
847 * read calls may be outstanding in parallel.
850 static ssize_t tty_read(struct file *file, char __user *buf, size_t count,
851 loff_t *ppos)
853 int i;
854 struct inode *inode = file_inode(file);
855 struct tty_struct *tty = file_tty(file);
856 struct tty_ldisc *ld;
858 if (tty_paranoia_check(tty, inode, "tty_read"))
859 return -EIO;
860 if (!tty || tty_io_error(tty))
861 return -EIO;
863 /* We want to wait for the line discipline to sort out in this
864 situation */
865 ld = tty_ldisc_ref_wait(tty);
866 if (!ld)
867 return hung_up_tty_read(file, buf, count, ppos);
868 if (ld->ops->read)
869 i = ld->ops->read(tty, file, buf, count);
870 else
871 i = -EIO;
872 tty_ldisc_deref(ld);
874 if (i > 0)
875 tty_update_time(&inode->i_atime);
877 return i;
880 static void tty_write_unlock(struct tty_struct *tty)
882 mutex_unlock(&tty->atomic_write_lock);
883 wake_up_interruptible_poll(&tty->write_wait, EPOLLOUT);
886 static int tty_write_lock(struct tty_struct *tty, int ndelay)
888 if (!mutex_trylock(&tty->atomic_write_lock)) {
889 if (ndelay)
890 return -EAGAIN;
891 if (mutex_lock_interruptible(&tty->atomic_write_lock))
892 return -ERESTARTSYS;
894 return 0;
898 * Split writes up in sane blocksizes to avoid
899 * denial-of-service type attacks
901 static inline ssize_t do_tty_write(
902 ssize_t (*write)(struct tty_struct *, struct file *, const unsigned char *, size_t),
903 struct tty_struct *tty,
904 struct file *file,
905 const char __user *buf,
906 size_t count)
908 ssize_t ret, written = 0;
909 unsigned int chunk;
911 ret = tty_write_lock(tty, file->f_flags & O_NDELAY);
912 if (ret < 0)
913 return ret;
916 * We chunk up writes into a temporary buffer. This
917 * simplifies low-level drivers immensely, since they
918 * don't have locking issues and user mode accesses.
920 * But if TTY_NO_WRITE_SPLIT is set, we should use a
921 * big chunk-size..
923 * The default chunk-size is 2kB, because the NTTY
924 * layer has problems with bigger chunks. It will
925 * claim to be able to handle more characters than
926 * it actually does.
928 * FIXME: This can probably go away now except that 64K chunks
929 * are too likely to fail unless switched to vmalloc...
931 chunk = 2048;
932 if (test_bit(TTY_NO_WRITE_SPLIT, &tty->flags))
933 chunk = 65536;
934 if (count < chunk)
935 chunk = count;
937 /* write_buf/write_cnt is protected by the atomic_write_lock mutex */
938 if (tty->write_cnt < chunk) {
939 unsigned char *buf_chunk;
941 if (chunk < 1024)
942 chunk = 1024;
944 buf_chunk = kmalloc(chunk, GFP_KERNEL);
945 if (!buf_chunk) {
946 ret = -ENOMEM;
947 goto out;
949 kfree(tty->write_buf);
950 tty->write_cnt = chunk;
951 tty->write_buf = buf_chunk;
954 /* Do the write .. */
955 for (;;) {
956 size_t size = count;
957 if (size > chunk)
958 size = chunk;
959 ret = -EFAULT;
960 if (copy_from_user(tty->write_buf, buf, size))
961 break;
962 ret = write(tty, file, tty->write_buf, size);
963 if (ret <= 0)
964 break;
965 written += ret;
966 buf += ret;
967 count -= ret;
968 if (!count)
969 break;
970 ret = -ERESTARTSYS;
971 if (signal_pending(current))
972 break;
973 cond_resched();
975 if (written) {
976 tty_update_time(&file_inode(file)->i_mtime);
977 ret = written;
979 out:
980 tty_write_unlock(tty);
981 return ret;
985 * tty_write_message - write a message to a certain tty, not just the console.
986 * @tty: the destination tty_struct
987 * @msg: the message to write
989 * This is used for messages that need to be redirected to a specific tty.
990 * We don't put it into the syslog queue right now maybe in the future if
991 * really needed.
993 * We must still hold the BTM and test the CLOSING flag for the moment.
996 void tty_write_message(struct tty_struct *tty, char *msg)
998 if (tty) {
999 mutex_lock(&tty->atomic_write_lock);
1000 tty_lock(tty);
1001 if (tty->ops->write && tty->count > 0)
1002 tty->ops->write(tty, msg, strlen(msg));
1003 tty_unlock(tty);
1004 tty_write_unlock(tty);
1006 return;
1011 * tty_write - write method for tty device file
1012 * @file: tty file pointer
1013 * @buf: user data to write
1014 * @count: bytes to write
1015 * @ppos: unused
1017 * Write data to a tty device via the line discipline.
1019 * Locking:
1020 * Locks the line discipline as required
1021 * Writes to the tty driver are serialized by the atomic_write_lock
1022 * and are then processed in chunks to the device. The line discipline
1023 * write method will not be invoked in parallel for each device.
1026 static ssize_t tty_write(struct file *file, const char __user *buf,
1027 size_t count, loff_t *ppos)
1029 struct tty_struct *tty = file_tty(file);
1030 struct tty_ldisc *ld;
1031 ssize_t ret;
1033 if (tty_paranoia_check(tty, file_inode(file), "tty_write"))
1034 return -EIO;
1035 if (!tty || !tty->ops->write || tty_io_error(tty))
1036 return -EIO;
1037 /* Short term debug to catch buggy drivers */
1038 if (tty->ops->write_room == NULL)
1039 tty_err(tty, "missing write_room method\n");
1040 ld = tty_ldisc_ref_wait(tty);
1041 if (!ld)
1042 return hung_up_tty_write(file, buf, count, ppos);
1043 if (!ld->ops->write)
1044 ret = -EIO;
1045 else
1046 ret = do_tty_write(ld->ops->write, tty, file, buf, count);
1047 tty_ldisc_deref(ld);
1048 return ret;
1051 ssize_t redirected_tty_write(struct file *file, const char __user *buf,
1052 size_t count, loff_t *ppos)
1054 struct file *p = NULL;
1056 spin_lock(&redirect_lock);
1057 if (redirect)
1058 p = get_file(redirect);
1059 spin_unlock(&redirect_lock);
1061 if (p) {
1062 ssize_t res;
1063 res = vfs_write(p, buf, count, &p->f_pos);
1064 fput(p);
1065 return res;
1067 return tty_write(file, buf, count, ppos);
1071 * tty_send_xchar - send priority character
1073 * Send a high priority character to the tty even if stopped
1075 * Locking: none for xchar method, write ordering for write method.
1078 int tty_send_xchar(struct tty_struct *tty, char ch)
1080 int was_stopped = tty->stopped;
1082 if (tty->ops->send_xchar) {
1083 down_read(&tty->termios_rwsem);
1084 tty->ops->send_xchar(tty, ch);
1085 up_read(&tty->termios_rwsem);
1086 return 0;
1089 if (tty_write_lock(tty, 0) < 0)
1090 return -ERESTARTSYS;
1092 down_read(&tty->termios_rwsem);
1093 if (was_stopped)
1094 start_tty(tty);
1095 tty->ops->write(tty, &ch, 1);
1096 if (was_stopped)
1097 stop_tty(tty);
1098 up_read(&tty->termios_rwsem);
1099 tty_write_unlock(tty);
1100 return 0;
1103 static char ptychar[] = "pqrstuvwxyzabcde";
1106 * pty_line_name - generate name for a pty
1107 * @driver: the tty driver in use
1108 * @index: the minor number
1109 * @p: output buffer of at least 6 bytes
1111 * Generate a name from a driver reference and write it to the output
1112 * buffer.
1114 * Locking: None
1116 static void pty_line_name(struct tty_driver *driver, int index, char *p)
1118 int i = index + driver->name_base;
1119 /* ->name is initialized to "ttyp", but "tty" is expected */
1120 sprintf(p, "%s%c%x",
1121 driver->subtype == PTY_TYPE_SLAVE ? "tty" : driver->name,
1122 ptychar[i >> 4 & 0xf], i & 0xf);
1126 * tty_line_name - generate name for a tty
1127 * @driver: the tty driver in use
1128 * @index: the minor number
1129 * @p: output buffer of at least 7 bytes
1131 * Generate a name from a driver reference and write it to the output
1132 * buffer.
1134 * Locking: None
1136 static ssize_t tty_line_name(struct tty_driver *driver, int index, char *p)
1138 if (driver->flags & TTY_DRIVER_UNNUMBERED_NODE)
1139 return sprintf(p, "%s", driver->name);
1140 else
1141 return sprintf(p, "%s%d", driver->name,
1142 index + driver->name_base);
1146 * tty_driver_lookup_tty() - find an existing tty, if any
1147 * @driver: the driver for the tty
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 * @idx: the minor number
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
1298 * @ret_tty: returned tty structure
1300 * Prepare a tty device. This may not be a "new" clean device but
1301 * could also be an active device. The pty drivers require special
1302 * handling because of this.
1304 * Locking:
1305 * The function is called under the tty_mutex, which
1306 * protects us from the tty struct or driver itself going away.
1308 * On exit the tty device has the line discipline attached and
1309 * a reference count of 1. If a pair was created for pty/tty use
1310 * and the other was a pty master then it too has a reference count of 1.
1312 * WSH 06/09/97: Rewritten to remove races and properly clean up after a
1313 * failed open. The new code protects the open with a mutex, so it's
1314 * really quite straightforward. The mutex locking can probably be
1315 * relaxed for the (most common) case of reopening a tty.
1318 struct tty_struct *tty_init_dev(struct tty_driver *driver, int idx)
1320 struct tty_struct *tty;
1321 int retval;
1324 * First time open is complex, especially for PTY devices.
1325 * This code guarantees that either everything succeeds and the
1326 * TTY is ready for operation, or else the table slots are vacated
1327 * and the allocated memory released. (Except that the termios
1328 * may be retained.)
1331 if (!try_module_get(driver->owner))
1332 return ERR_PTR(-ENODEV);
1334 tty = alloc_tty_struct(driver, idx);
1335 if (!tty) {
1336 retval = -ENOMEM;
1337 goto err_module_put;
1340 tty_lock(tty);
1341 retval = tty_driver_install_tty(driver, tty);
1342 if (retval < 0)
1343 goto err_free_tty;
1345 if (!tty->port)
1346 tty->port = driver->ports[idx];
1348 if (WARN_RATELIMIT(!tty->port,
1349 "%s: %s driver does not set tty->port. This would crash the kernel. Fix the driver!\n",
1350 __func__, tty->driver->name)) {
1351 retval = -EINVAL;
1352 goto err_release_lock;
1355 retval = tty_ldisc_lock(tty, 5 * HZ);
1356 if (retval)
1357 goto err_release_lock;
1358 tty->port->itty = tty;
1361 * Structures all installed ... call the ldisc open routines.
1362 * If we fail here just call release_tty to clean up. No need
1363 * to decrement the use counts, as release_tty doesn't care.
1365 retval = tty_ldisc_setup(tty, tty->link);
1366 if (retval)
1367 goto err_release_tty;
1368 tty_ldisc_unlock(tty);
1369 /* Return the tty locked so that it cannot vanish under the caller */
1370 return tty;
1372 err_free_tty:
1373 tty_unlock(tty);
1374 free_tty_struct(tty);
1375 err_module_put:
1376 module_put(driver->owner);
1377 return ERR_PTR(retval);
1379 /* call the tty release_tty routine to clean out this slot */
1380 err_release_tty:
1381 tty_ldisc_unlock(tty);
1382 tty_info_ratelimited(tty, "ldisc open failed (%d), clearing slot %d\n",
1383 retval, idx);
1384 err_release_lock:
1385 tty_unlock(tty);
1386 release_tty(tty, idx);
1387 return ERR_PTR(retval);
1391 * tty_save_termios() - save tty termios data in driver table
1392 * @tty: tty whose termios data to save
1394 * Locking: Caller guarantees serialisation with tty_init_termios().
1396 void tty_save_termios(struct tty_struct *tty)
1398 struct ktermios *tp;
1399 int idx = tty->index;
1401 /* If the port is going to reset then it has no termios to save */
1402 if (tty->driver->flags & TTY_DRIVER_RESET_TERMIOS)
1403 return;
1405 /* Stash the termios data */
1406 tp = tty->driver->termios[idx];
1407 if (tp == NULL) {
1408 tp = kmalloc(sizeof(struct ktermios), GFP_KERNEL);
1409 if (tp == NULL)
1410 return;
1411 tty->driver->termios[idx] = tp;
1413 *tp = tty->termios;
1415 EXPORT_SYMBOL_GPL(tty_save_termios);
1418 * tty_flush_works - flush all works of a tty/pty pair
1419 * @tty: tty device to flush works for (or either end of a pty pair)
1421 * Sync flush all works belonging to @tty (and the 'other' tty).
1423 static void tty_flush_works(struct tty_struct *tty)
1425 flush_work(&tty->SAK_work);
1426 flush_work(&tty->hangup_work);
1427 if (tty->link) {
1428 flush_work(&tty->link->SAK_work);
1429 flush_work(&tty->link->hangup_work);
1434 * release_one_tty - release tty structure memory
1435 * @kref: kref of tty we are obliterating
1437 * Releases memory associated with a tty structure, and clears out the
1438 * driver table slots. This function is called when a device is no longer
1439 * in use. It also gets called when setup of a device fails.
1441 * Locking:
1442 * takes the file list lock internally when working on the list
1443 * of ttys that the driver keeps.
1445 * This method gets called from a work queue so that the driver private
1446 * cleanup ops can sleep (needed for USB at least)
1448 static void release_one_tty(struct work_struct *work)
1450 struct tty_struct *tty =
1451 container_of(work, struct tty_struct, hangup_work);
1452 struct tty_driver *driver = tty->driver;
1453 struct module *owner = driver->owner;
1455 if (tty->ops->cleanup)
1456 tty->ops->cleanup(tty);
1458 tty->magic = 0;
1459 tty_driver_kref_put(driver);
1460 module_put(owner);
1462 spin_lock(&tty->files_lock);
1463 list_del_init(&tty->tty_files);
1464 spin_unlock(&tty->files_lock);
1466 put_pid(tty->pgrp);
1467 put_pid(tty->session);
1468 free_tty_struct(tty);
1471 static void queue_release_one_tty(struct kref *kref)
1473 struct tty_struct *tty = container_of(kref, struct tty_struct, kref);
1475 /* The hangup queue is now free so we can reuse it rather than
1476 waste a chunk of memory for each port */
1477 INIT_WORK(&tty->hangup_work, release_one_tty);
1478 schedule_work(&tty->hangup_work);
1482 * tty_kref_put - release a tty kref
1483 * @tty: tty device
1485 * Release a reference to a tty device and if need be let the kref
1486 * layer destruct the object for us
1489 void tty_kref_put(struct tty_struct *tty)
1491 if (tty)
1492 kref_put(&tty->kref, queue_release_one_tty);
1494 EXPORT_SYMBOL(tty_kref_put);
1497 * release_tty - release tty structure memory
1499 * Release both @tty and a possible linked partner (think pty pair),
1500 * and decrement the refcount of the backing module.
1502 * Locking:
1503 * tty_mutex
1504 * takes the file list lock internally when working on the list
1505 * of ttys that the driver keeps.
1508 static void release_tty(struct tty_struct *tty, int idx)
1510 /* This should always be true but check for the moment */
1511 WARN_ON(tty->index != idx);
1512 WARN_ON(!mutex_is_locked(&tty_mutex));
1513 if (tty->ops->shutdown)
1514 tty->ops->shutdown(tty);
1515 tty_save_termios(tty);
1516 tty_driver_remove_tty(tty->driver, tty);
1517 tty->port->itty = NULL;
1518 if (tty->link)
1519 tty->link->port->itty = NULL;
1520 tty_buffer_cancel_work(tty->port);
1521 if (tty->link)
1522 tty_buffer_cancel_work(tty->link->port);
1524 tty_kref_put(tty->link);
1525 tty_kref_put(tty);
1529 * tty_release_checks - check a tty before real release
1530 * @tty: tty to check
1531 * @o_tty: link of @tty (if any)
1532 * @idx: index of the tty
1534 * Performs some paranoid checking before true release of the @tty.
1535 * This is a no-op unless TTY_PARANOIA_CHECK is defined.
1537 static int tty_release_checks(struct tty_struct *tty, int idx)
1539 #ifdef TTY_PARANOIA_CHECK
1540 if (idx < 0 || idx >= tty->driver->num) {
1541 tty_debug(tty, "bad idx %d\n", idx);
1542 return -1;
1545 /* not much to check for devpts */
1546 if (tty->driver->flags & TTY_DRIVER_DEVPTS_MEM)
1547 return 0;
1549 if (tty != tty->driver->ttys[idx]) {
1550 tty_debug(tty, "bad driver table[%d] = %p\n",
1551 idx, tty->driver->ttys[idx]);
1552 return -1;
1554 if (tty->driver->other) {
1555 struct tty_struct *o_tty = tty->link;
1557 if (o_tty != tty->driver->other->ttys[idx]) {
1558 tty_debug(tty, "bad other table[%d] = %p\n",
1559 idx, tty->driver->other->ttys[idx]);
1560 return -1;
1562 if (o_tty->link != tty) {
1563 tty_debug(tty, "bad link = %p\n", o_tty->link);
1564 return -1;
1567 #endif
1568 return 0;
1572 * tty_kclose - closes tty opened by tty_kopen
1573 * @tty: tty device
1575 * Performs the final steps to release and free a tty device. It is the
1576 * same as tty_release_struct except that it also resets TTY_PORT_KOPENED
1577 * flag on tty->port.
1579 void tty_kclose(struct tty_struct *tty)
1582 * Ask the line discipline code to release its structures
1584 tty_ldisc_release(tty);
1586 /* Wait for pending work before tty destruction commmences */
1587 tty_flush_works(tty);
1589 tty_debug_hangup(tty, "freeing structure\n");
1591 * The release_tty function takes care of the details of clearing
1592 * the slots and preserving the termios structure. The tty_unlock_pair
1593 * should be safe as we keep a kref while the tty is locked (so the
1594 * unlock never unlocks a freed tty).
1596 mutex_lock(&tty_mutex);
1597 tty_port_set_kopened(tty->port, 0);
1598 release_tty(tty, tty->index);
1599 mutex_unlock(&tty_mutex);
1601 EXPORT_SYMBOL_GPL(tty_kclose);
1604 * tty_release_struct - release a tty struct
1605 * @tty: tty device
1606 * @idx: index of the tty
1608 * Performs the final steps to release and free a tty device. It is
1609 * roughly the reverse of tty_init_dev.
1611 void tty_release_struct(struct tty_struct *tty, int idx)
1614 * Ask the line discipline code to release its structures
1616 tty_ldisc_release(tty);
1618 /* Wait for pending work before tty destruction commmences */
1619 tty_flush_works(tty);
1621 tty_debug_hangup(tty, "freeing structure\n");
1623 * The release_tty function takes care of the details of clearing
1624 * the slots and preserving the termios structure. The tty_unlock_pair
1625 * should be safe as we keep a kref while the tty is locked (so the
1626 * unlock never unlocks a freed tty).
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 * @rows: rows (character)
2231 * @cols: cols (character)
2233 * Update the termios variables and send the necessary signals to
2234 * peform a terminal resize correctly
2237 int tty_do_resize(struct tty_struct *tty, struct winsize *ws)
2239 struct pid *pgrp;
2241 /* Lock the tty */
2242 mutex_lock(&tty->winsize_mutex);
2243 if (!memcmp(ws, &tty->winsize, sizeof(*ws)))
2244 goto done;
2246 /* Signal the foreground process group */
2247 pgrp = tty_get_pgrp(tty);
2248 if (pgrp)
2249 kill_pgrp(pgrp, SIGWINCH, 1);
2250 put_pid(pgrp);
2252 tty->winsize = *ws;
2253 done:
2254 mutex_unlock(&tty->winsize_mutex);
2255 return 0;
2257 EXPORT_SYMBOL(tty_do_resize);
2260 * tiocswinsz - implement window size set ioctl
2261 * @tty; tty side of tty
2262 * @arg: user buffer for result
2264 * Copies the user idea of the window size to the kernel. Traditionally
2265 * this is just advisory information but for the Linux console it
2266 * actually has driver level meaning and triggers a VC resize.
2268 * Locking:
2269 * Driver dependent. The default do_resize method takes the
2270 * tty termios mutex and ctrl_lock. The console takes its own lock
2271 * then calls into the default method.
2274 static int tiocswinsz(struct tty_struct *tty, struct winsize __user *arg)
2276 struct winsize tmp_ws;
2277 if (copy_from_user(&tmp_ws, arg, sizeof(*arg)))
2278 return -EFAULT;
2280 if (tty->ops->resize)
2281 return tty->ops->resize(tty, &tmp_ws);
2282 else
2283 return tty_do_resize(tty, &tmp_ws);
2287 * tioccons - allow admin to move logical console
2288 * @file: the file to become console
2290 * Allow the administrator to move the redirected console device
2292 * Locking: uses redirect_lock to guard the redirect information
2295 static int tioccons(struct file *file)
2297 if (!capable(CAP_SYS_ADMIN))
2298 return -EPERM;
2299 if (file->f_op->write == redirected_tty_write) {
2300 struct file *f;
2301 spin_lock(&redirect_lock);
2302 f = redirect;
2303 redirect = NULL;
2304 spin_unlock(&redirect_lock);
2305 if (f)
2306 fput(f);
2307 return 0;
2309 spin_lock(&redirect_lock);
2310 if (redirect) {
2311 spin_unlock(&redirect_lock);
2312 return -EBUSY;
2314 redirect = get_file(file);
2315 spin_unlock(&redirect_lock);
2316 return 0;
2320 * tiocsetd - set line discipline
2321 * @tty: tty device
2322 * @p: pointer to user data
2324 * Set the line discipline according to user request.
2326 * Locking: see tty_set_ldisc, this function is just a helper
2329 static int tiocsetd(struct tty_struct *tty, int __user *p)
2331 int disc;
2332 int ret;
2334 if (get_user(disc, p))
2335 return -EFAULT;
2337 ret = tty_set_ldisc(tty, disc);
2339 return ret;
2343 * tiocgetd - get line discipline
2344 * @tty: tty device
2345 * @p: pointer to user data
2347 * Retrieves the line discipline id directly from the ldisc.
2349 * Locking: waits for ldisc reference (in case the line discipline
2350 * is changing or the tty is being hungup)
2353 static int tiocgetd(struct tty_struct *tty, int __user *p)
2355 struct tty_ldisc *ld;
2356 int ret;
2358 ld = tty_ldisc_ref_wait(tty);
2359 if (!ld)
2360 return -EIO;
2361 ret = put_user(ld->ops->num, p);
2362 tty_ldisc_deref(ld);
2363 return ret;
2367 * send_break - performed time break
2368 * @tty: device to break on
2369 * @duration: timeout in mS
2371 * Perform a timed break on hardware that lacks its own driver level
2372 * timed break functionality.
2374 * Locking:
2375 * atomic_write_lock serializes
2379 static int send_break(struct tty_struct *tty, unsigned int duration)
2381 int retval;
2383 if (tty->ops->break_ctl == NULL)
2384 return 0;
2386 if (tty->driver->flags & TTY_DRIVER_HARDWARE_BREAK)
2387 retval = tty->ops->break_ctl(tty, duration);
2388 else {
2389 /* Do the work ourselves */
2390 if (tty_write_lock(tty, 0) < 0)
2391 return -EINTR;
2392 retval = tty->ops->break_ctl(tty, -1);
2393 if (retval)
2394 goto out;
2395 if (!signal_pending(current))
2396 msleep_interruptible(duration);
2397 retval = tty->ops->break_ctl(tty, 0);
2398 out:
2399 tty_write_unlock(tty);
2400 if (signal_pending(current))
2401 retval = -EINTR;
2403 return retval;
2407 * tty_tiocmget - get modem status
2408 * @tty: tty device
2409 * @file: user file pointer
2410 * @p: pointer to result
2412 * Obtain the modem status bits from the tty driver if the feature
2413 * is supported. Return -EINVAL if it is not available.
2415 * Locking: none (up to the driver)
2418 static int tty_tiocmget(struct tty_struct *tty, int __user *p)
2420 int retval = -EINVAL;
2422 if (tty->ops->tiocmget) {
2423 retval = tty->ops->tiocmget(tty);
2425 if (retval >= 0)
2426 retval = put_user(retval, p);
2428 return retval;
2432 * tty_tiocmset - set modem status
2433 * @tty: tty device
2434 * @cmd: command - clear bits, set bits or set all
2435 * @p: pointer to desired bits
2437 * Set the modem status bits from the tty driver if the feature
2438 * is supported. Return -EINVAL if it is not available.
2440 * Locking: none (up to the driver)
2443 static int tty_tiocmset(struct tty_struct *tty, unsigned int cmd,
2444 unsigned __user *p)
2446 int retval;
2447 unsigned int set, clear, val;
2449 if (tty->ops->tiocmset == NULL)
2450 return -EINVAL;
2452 retval = get_user(val, p);
2453 if (retval)
2454 return retval;
2455 set = clear = 0;
2456 switch (cmd) {
2457 case TIOCMBIS:
2458 set = val;
2459 break;
2460 case TIOCMBIC:
2461 clear = val;
2462 break;
2463 case TIOCMSET:
2464 set = val;
2465 clear = ~val;
2466 break;
2468 set &= TIOCM_DTR|TIOCM_RTS|TIOCM_OUT1|TIOCM_OUT2|TIOCM_LOOP;
2469 clear &= TIOCM_DTR|TIOCM_RTS|TIOCM_OUT1|TIOCM_OUT2|TIOCM_LOOP;
2470 return tty->ops->tiocmset(tty, set, clear);
2473 static int tty_tiocgicount(struct tty_struct *tty, void __user *arg)
2475 int retval = -EINVAL;
2476 struct serial_icounter_struct icount;
2477 memset(&icount, 0, sizeof(icount));
2478 if (tty->ops->get_icount)
2479 retval = tty->ops->get_icount(tty, &icount);
2480 if (retval != 0)
2481 return retval;
2482 if (copy_to_user(arg, &icount, sizeof(icount)))
2483 return -EFAULT;
2484 return 0;
2487 static int tty_tiocsserial(struct tty_struct *tty, struct serial_struct __user *ss)
2489 static DEFINE_RATELIMIT_STATE(depr_flags,
2490 DEFAULT_RATELIMIT_INTERVAL,
2491 DEFAULT_RATELIMIT_BURST);
2492 char comm[TASK_COMM_LEN];
2493 struct serial_struct v;
2494 int flags;
2496 if (copy_from_user(&v, ss, sizeof(struct serial_struct)))
2497 return -EFAULT;
2499 flags = v.flags & ASYNC_DEPRECATED;
2501 if (flags && __ratelimit(&depr_flags))
2502 pr_warn("%s: '%s' is using deprecated serial flags (with no effect): %.8x\n",
2503 __func__, get_task_comm(comm, current), flags);
2504 if (!tty->ops->set_serial)
2505 return -ENOTTY;
2506 return tty->ops->set_serial(tty, &v);
2509 static int tty_tiocgserial(struct tty_struct *tty, struct serial_struct __user *ss)
2511 struct serial_struct v;
2512 int err;
2514 memset(&v, 0, sizeof(struct serial_struct));
2515 if (!tty->ops->get_serial)
2516 return -ENOTTY;
2517 err = tty->ops->get_serial(tty, &v);
2518 if (!err && copy_to_user(ss, &v, sizeof(struct serial_struct)))
2519 err = -EFAULT;
2520 return err;
2524 * if pty, return the slave side (real_tty)
2525 * otherwise, return self
2527 static struct tty_struct *tty_pair_get_tty(struct tty_struct *tty)
2529 if (tty->driver->type == TTY_DRIVER_TYPE_PTY &&
2530 tty->driver->subtype == PTY_TYPE_MASTER)
2531 tty = tty->link;
2532 return tty;
2536 * Split this up, as gcc can choke on it otherwise..
2538 long tty_ioctl(struct file *file, unsigned int cmd, unsigned long arg)
2540 struct tty_struct *tty = file_tty(file);
2541 struct tty_struct *real_tty;
2542 void __user *p = (void __user *)arg;
2543 int retval;
2544 struct tty_ldisc *ld;
2546 if (tty_paranoia_check(tty, file_inode(file), "tty_ioctl"))
2547 return -EINVAL;
2549 real_tty = tty_pair_get_tty(tty);
2552 * Factor out some common prep work
2554 switch (cmd) {
2555 case TIOCSETD:
2556 case TIOCSBRK:
2557 case TIOCCBRK:
2558 case TCSBRK:
2559 case TCSBRKP:
2560 retval = tty_check_change(tty);
2561 if (retval)
2562 return retval;
2563 if (cmd != TIOCCBRK) {
2564 tty_wait_until_sent(tty, 0);
2565 if (signal_pending(current))
2566 return -EINTR;
2568 break;
2572 * Now do the stuff.
2574 switch (cmd) {
2575 case TIOCSTI:
2576 return tiocsti(tty, p);
2577 case TIOCGWINSZ:
2578 return tiocgwinsz(real_tty, p);
2579 case TIOCSWINSZ:
2580 return tiocswinsz(real_tty, p);
2581 case TIOCCONS:
2582 return real_tty != tty ? -EINVAL : tioccons(file);
2583 case TIOCEXCL:
2584 set_bit(TTY_EXCLUSIVE, &tty->flags);
2585 return 0;
2586 case TIOCNXCL:
2587 clear_bit(TTY_EXCLUSIVE, &tty->flags);
2588 return 0;
2589 case TIOCGEXCL:
2591 int excl = test_bit(TTY_EXCLUSIVE, &tty->flags);
2592 return put_user(excl, (int __user *)p);
2594 case TIOCGETD:
2595 return tiocgetd(tty, p);
2596 case TIOCSETD:
2597 return tiocsetd(tty, p);
2598 case TIOCVHANGUP:
2599 if (!capable(CAP_SYS_ADMIN))
2600 return -EPERM;
2601 tty_vhangup(tty);
2602 return 0;
2603 case TIOCGDEV:
2605 unsigned int ret = new_encode_dev(tty_devnum(real_tty));
2606 return put_user(ret, (unsigned int __user *)p);
2609 * Break handling
2611 case TIOCSBRK: /* Turn break on, unconditionally */
2612 if (tty->ops->break_ctl)
2613 return tty->ops->break_ctl(tty, -1);
2614 return 0;
2615 case TIOCCBRK: /* Turn break off, unconditionally */
2616 if (tty->ops->break_ctl)
2617 return tty->ops->break_ctl(tty, 0);
2618 return 0;
2619 case TCSBRK: /* SVID version: non-zero arg --> no break */
2620 /* non-zero arg means wait for all output data
2621 * to be sent (performed above) but don't send break.
2622 * This is used by the tcdrain() termios function.
2624 if (!arg)
2625 return send_break(tty, 250);
2626 return 0;
2627 case TCSBRKP: /* support for POSIX tcsendbreak() */
2628 return send_break(tty, arg ? arg*100 : 250);
2630 case TIOCMGET:
2631 return tty_tiocmget(tty, p);
2632 case TIOCMSET:
2633 case TIOCMBIC:
2634 case TIOCMBIS:
2635 return tty_tiocmset(tty, cmd, p);
2636 case TIOCGICOUNT:
2637 return tty_tiocgicount(tty, p);
2638 case TCFLSH:
2639 switch (arg) {
2640 case TCIFLUSH:
2641 case TCIOFLUSH:
2642 /* flush tty buffer and allow ldisc to process ioctl */
2643 tty_buffer_flush(tty, NULL);
2644 break;
2646 break;
2647 case TIOCSSERIAL:
2648 return tty_tiocsserial(tty, p);
2649 case TIOCGSERIAL:
2650 return tty_tiocgserial(tty, p);
2651 case TIOCGPTPEER:
2652 /* Special because the struct file is needed */
2653 return ptm_open_peer(file, tty, (int)arg);
2654 default:
2655 retval = tty_jobctrl_ioctl(tty, real_tty, file, cmd, arg);
2656 if (retval != -ENOIOCTLCMD)
2657 return retval;
2659 if (tty->ops->ioctl) {
2660 retval = tty->ops->ioctl(tty, cmd, arg);
2661 if (retval != -ENOIOCTLCMD)
2662 return retval;
2664 ld = tty_ldisc_ref_wait(tty);
2665 if (!ld)
2666 return hung_up_tty_ioctl(file, cmd, arg);
2667 retval = -EINVAL;
2668 if (ld->ops->ioctl) {
2669 retval = ld->ops->ioctl(tty, file, cmd, arg);
2670 if (retval == -ENOIOCTLCMD)
2671 retval = -ENOTTY;
2673 tty_ldisc_deref(ld);
2674 return retval;
2677 #ifdef CONFIG_COMPAT
2679 struct serial_struct32 {
2680 compat_int_t type;
2681 compat_int_t line;
2682 compat_uint_t port;
2683 compat_int_t irq;
2684 compat_int_t flags;
2685 compat_int_t xmit_fifo_size;
2686 compat_int_t custom_divisor;
2687 compat_int_t baud_base;
2688 unsigned short close_delay;
2689 char io_type;
2690 char reserved_char[1];
2691 compat_int_t hub6;
2692 unsigned short closing_wait; /* time to wait before closing */
2693 unsigned short closing_wait2; /* no longer used... */
2694 compat_uint_t iomem_base;
2695 unsigned short iomem_reg_shift;
2696 unsigned int port_high;
2697 /* compat_ulong_t iomap_base FIXME */
2698 compat_int_t reserved[1];
2701 static int compat_tty_tiocsserial(struct tty_struct *tty,
2702 struct serial_struct32 __user *ss)
2704 static DEFINE_RATELIMIT_STATE(depr_flags,
2705 DEFAULT_RATELIMIT_INTERVAL,
2706 DEFAULT_RATELIMIT_BURST);
2707 char comm[TASK_COMM_LEN];
2708 struct serial_struct32 v32;
2709 struct serial_struct v;
2710 int flags;
2712 if (copy_from_user(&v32, ss, sizeof(struct serial_struct32)))
2713 return -EFAULT;
2715 memcpy(&v, &v32, offsetof(struct serial_struct32, iomem_base));
2716 v.iomem_base = compat_ptr(v32.iomem_base);
2717 v.iomem_reg_shift = v32.iomem_reg_shift;
2718 v.port_high = v32.port_high;
2719 v.iomap_base = 0;
2721 flags = v.flags & ASYNC_DEPRECATED;
2723 if (flags && __ratelimit(&depr_flags))
2724 pr_warn("%s: '%s' is using deprecated serial flags (with no effect): %.8x\n",
2725 __func__, get_task_comm(comm, current), flags);
2726 if (!tty->ops->set_serial)
2727 return -ENOTTY;
2728 return tty->ops->set_serial(tty, &v);
2731 static int compat_tty_tiocgserial(struct tty_struct *tty,
2732 struct serial_struct32 __user *ss)
2734 struct serial_struct32 v32;
2735 struct serial_struct v;
2736 int err;
2737 memset(&v, 0, sizeof(struct serial_struct));
2739 if (!tty->ops->set_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(struct serial_struct32)))
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;
2903 if (!tty)
2904 return;
2905 session = tty->session;
2907 tty_ldisc_flush(tty);
2909 tty_driver_flush_buffer(tty);
2911 read_lock(&tasklist_lock);
2912 /* Kill the entire session */
2913 do_each_pid_task(session, PIDTYPE_SID, p) {
2914 tty_notice(tty, "SAK: killed process %d (%s): by session\n",
2915 task_pid_nr(p), p->comm);
2916 group_send_sig_info(SIGKILL, SEND_SIG_PRIV, p, PIDTYPE_SID);
2917 } while_each_pid_task(session, PIDTYPE_SID, p);
2919 /* Now kill any processes that happen to have the tty open */
2920 do_each_thread(g, p) {
2921 if (p->signal->tty == tty) {
2922 tty_notice(tty, "SAK: killed process %d (%s): by controlling tty\n",
2923 task_pid_nr(p), p->comm);
2924 group_send_sig_info(SIGKILL, SEND_SIG_PRIV, p, PIDTYPE_SID);
2925 continue;
2927 task_lock(p);
2928 i = iterate_fd(p->files, 0, this_tty, tty);
2929 if (i != 0) {
2930 tty_notice(tty, "SAK: killed process %d (%s): by fd#%d\n",
2931 task_pid_nr(p), p->comm, i - 1);
2932 group_send_sig_info(SIGKILL, SEND_SIG_PRIV, p, PIDTYPE_SID);
2934 task_unlock(p);
2935 } while_each_thread(g, p);
2936 read_unlock(&tasklist_lock);
2937 #endif
2940 static void do_SAK_work(struct work_struct *work)
2942 struct tty_struct *tty =
2943 container_of(work, struct tty_struct, SAK_work);
2944 __do_SAK(tty);
2948 * The tq handling here is a little racy - tty->SAK_work may already be queued.
2949 * Fortunately we don't need to worry, because if ->SAK_work is already queued,
2950 * the values which we write to it will be identical to the values which it
2951 * already has. --akpm
2953 void do_SAK(struct tty_struct *tty)
2955 if (!tty)
2956 return;
2957 schedule_work(&tty->SAK_work);
2960 EXPORT_SYMBOL(do_SAK);
2962 /* Must put_device() after it's unused! */
2963 static struct device *tty_get_device(struct tty_struct *tty)
2965 dev_t devt = tty_devnum(tty);
2966 return class_find_device_by_devt(tty_class, devt);
2971 * alloc_tty_struct
2973 * This subroutine allocates and initializes a tty structure.
2975 * Locking: none - tty in question is not exposed at this point
2978 struct tty_struct *alloc_tty_struct(struct tty_driver *driver, int idx)
2980 struct tty_struct *tty;
2982 tty = kzalloc(sizeof(*tty), GFP_KERNEL);
2983 if (!tty)
2984 return NULL;
2986 kref_init(&tty->kref);
2987 tty->magic = TTY_MAGIC;
2988 if (tty_ldisc_init(tty)) {
2989 kfree(tty);
2990 return NULL;
2992 tty->session = NULL;
2993 tty->pgrp = NULL;
2994 mutex_init(&tty->legacy_mutex);
2995 mutex_init(&tty->throttle_mutex);
2996 init_rwsem(&tty->termios_rwsem);
2997 mutex_init(&tty->winsize_mutex);
2998 init_ldsem(&tty->ldisc_sem);
2999 init_waitqueue_head(&tty->write_wait);
3000 init_waitqueue_head(&tty->read_wait);
3001 INIT_WORK(&tty->hangup_work, do_tty_hangup);
3002 mutex_init(&tty->atomic_write_lock);
3003 spin_lock_init(&tty->ctrl_lock);
3004 spin_lock_init(&tty->flow_lock);
3005 spin_lock_init(&tty->files_lock);
3006 INIT_LIST_HEAD(&tty->tty_files);
3007 INIT_WORK(&tty->SAK_work, do_SAK_work);
3009 tty->driver = driver;
3010 tty->ops = driver->ops;
3011 tty->index = idx;
3012 tty_line_name(driver, idx, tty->name);
3013 tty->dev = tty_get_device(tty);
3015 return tty;
3019 * tty_put_char - write one character to a tty
3020 * @tty: tty
3021 * @ch: character
3023 * Write one byte to the tty using the provided put_char method
3024 * if present. Returns the number of characters successfully output.
3026 * Note: the specific put_char operation in the driver layer may go
3027 * away soon. Don't call it directly, use this method
3030 int tty_put_char(struct tty_struct *tty, unsigned char ch)
3032 if (tty->ops->put_char)
3033 return tty->ops->put_char(tty, ch);
3034 return tty->ops->write(tty, &ch, 1);
3036 EXPORT_SYMBOL_GPL(tty_put_char);
3038 struct class *tty_class;
3040 static int tty_cdev_add(struct tty_driver *driver, dev_t dev,
3041 unsigned int index, unsigned int count)
3043 int err;
3045 /* init here, since reused cdevs cause crashes */
3046 driver->cdevs[index] = cdev_alloc();
3047 if (!driver->cdevs[index])
3048 return -ENOMEM;
3049 driver->cdevs[index]->ops = &tty_fops;
3050 driver->cdevs[index]->owner = driver->owner;
3051 err = cdev_add(driver->cdevs[index], dev, count);
3052 if (err)
3053 kobject_put(&driver->cdevs[index]->kobj);
3054 return err;
3058 * tty_register_device - register a tty device
3059 * @driver: the tty driver that describes the tty device
3060 * @index: the index in the tty driver for this tty device
3061 * @device: a struct device that is associated with this tty device.
3062 * This field is optional, if there is no known struct device
3063 * for this tty device it can be set to NULL safely.
3065 * Returns a pointer to the struct device for this tty device
3066 * (or ERR_PTR(-EFOO) on error).
3068 * This call is required to be made to register an individual tty device
3069 * if the tty driver's flags have the TTY_DRIVER_DYNAMIC_DEV bit set. If
3070 * that bit is not set, this function should not be called by a tty
3071 * driver.
3073 * Locking: ??
3076 struct device *tty_register_device(struct tty_driver *driver, unsigned index,
3077 struct device *device)
3079 return tty_register_device_attr(driver, index, device, NULL, NULL);
3081 EXPORT_SYMBOL(tty_register_device);
3083 static void tty_device_create_release(struct device *dev)
3085 dev_dbg(dev, "releasing...\n");
3086 kfree(dev);
3090 * tty_register_device_attr - register a tty device
3091 * @driver: the tty driver that describes the tty device
3092 * @index: the index in the tty driver for this tty device
3093 * @device: a struct device that is associated with this tty device.
3094 * This field is optional, if there is no known struct device
3095 * for this tty device it can be set to NULL safely.
3096 * @drvdata: Driver data to be set to device.
3097 * @attr_grp: Attribute group to be set on device.
3099 * Returns a pointer to the struct device for this tty device
3100 * (or ERR_PTR(-EFOO) on error).
3102 * This call is required to be made to register an individual tty device
3103 * if the tty driver's flags have the TTY_DRIVER_DYNAMIC_DEV bit set. If
3104 * that bit is not set, this function should not be called by a tty
3105 * driver.
3107 * Locking: ??
3109 struct device *tty_register_device_attr(struct tty_driver *driver,
3110 unsigned index, struct device *device,
3111 void *drvdata,
3112 const struct attribute_group **attr_grp)
3114 char name[64];
3115 dev_t devt = MKDEV(driver->major, driver->minor_start) + index;
3116 struct ktermios *tp;
3117 struct device *dev;
3118 int retval;
3120 if (index >= driver->num) {
3121 pr_err("%s: Attempt to register invalid tty line number (%d)\n",
3122 driver->name, index);
3123 return ERR_PTR(-EINVAL);
3126 if (driver->type == TTY_DRIVER_TYPE_PTY)
3127 pty_line_name(driver, index, name);
3128 else
3129 tty_line_name(driver, index, name);
3131 dev = kzalloc(sizeof(*dev), GFP_KERNEL);
3132 if (!dev)
3133 return ERR_PTR(-ENOMEM);
3135 dev->devt = devt;
3136 dev->class = tty_class;
3137 dev->parent = device;
3138 dev->release = tty_device_create_release;
3139 dev_set_name(dev, "%s", name);
3140 dev->groups = attr_grp;
3141 dev_set_drvdata(dev, drvdata);
3143 dev_set_uevent_suppress(dev, 1);
3145 retval = device_register(dev);
3146 if (retval)
3147 goto err_put;
3149 if (!(driver->flags & TTY_DRIVER_DYNAMIC_ALLOC)) {
3151 * Free any saved termios data so that the termios state is
3152 * reset when reusing a minor number.
3154 tp = driver->termios[index];
3155 if (tp) {
3156 driver->termios[index] = NULL;
3157 kfree(tp);
3160 retval = tty_cdev_add(driver, devt, index, 1);
3161 if (retval)
3162 goto err_del;
3165 dev_set_uevent_suppress(dev, 0);
3166 kobject_uevent(&dev->kobj, KOBJ_ADD);
3168 return dev;
3170 err_del:
3171 device_del(dev);
3172 err_put:
3173 put_device(dev);
3175 return ERR_PTR(retval);
3177 EXPORT_SYMBOL_GPL(tty_register_device_attr);
3180 * tty_unregister_device - unregister a tty device
3181 * @driver: the tty driver that describes the tty device
3182 * @index: the index in the tty driver for this tty device
3184 * If a tty device is registered with a call to tty_register_device() then
3185 * this function must be called when the tty device is gone.
3187 * Locking: ??
3190 void tty_unregister_device(struct tty_driver *driver, unsigned index)
3192 device_destroy(tty_class,
3193 MKDEV(driver->major, driver->minor_start) + index);
3194 if (!(driver->flags & TTY_DRIVER_DYNAMIC_ALLOC)) {
3195 cdev_del(driver->cdevs[index]);
3196 driver->cdevs[index] = NULL;
3199 EXPORT_SYMBOL(tty_unregister_device);
3202 * __tty_alloc_driver -- allocate tty driver
3203 * @lines: count of lines this driver can handle at most
3204 * @owner: module which is responsible for this driver
3205 * @flags: some of TTY_DRIVER_* flags, will be set in driver->flags
3207 * This should not be called directly, some of the provided macros should be
3208 * used instead. Use IS_ERR and friends on @retval.
3210 struct tty_driver *__tty_alloc_driver(unsigned int lines, struct module *owner,
3211 unsigned long flags)
3213 struct tty_driver *driver;
3214 unsigned int cdevs = 1;
3215 int err;
3217 if (!lines || (flags & TTY_DRIVER_UNNUMBERED_NODE && lines > 1))
3218 return ERR_PTR(-EINVAL);
3220 driver = kzalloc(sizeof(struct tty_driver), GFP_KERNEL);
3221 if (!driver)
3222 return ERR_PTR(-ENOMEM);
3224 kref_init(&driver->kref);
3225 driver->magic = TTY_DRIVER_MAGIC;
3226 driver->num = lines;
3227 driver->owner = owner;
3228 driver->flags = flags;
3230 if (!(flags & TTY_DRIVER_DEVPTS_MEM)) {
3231 driver->ttys = kcalloc(lines, sizeof(*driver->ttys),
3232 GFP_KERNEL);
3233 driver->termios = kcalloc(lines, sizeof(*driver->termios),
3234 GFP_KERNEL);
3235 if (!driver->ttys || !driver->termios) {
3236 err = -ENOMEM;
3237 goto err_free_all;
3241 if (!(flags & TTY_DRIVER_DYNAMIC_ALLOC)) {
3242 driver->ports = kcalloc(lines, sizeof(*driver->ports),
3243 GFP_KERNEL);
3244 if (!driver->ports) {
3245 err = -ENOMEM;
3246 goto err_free_all;
3248 cdevs = lines;
3251 driver->cdevs = kcalloc(cdevs, sizeof(*driver->cdevs), GFP_KERNEL);
3252 if (!driver->cdevs) {
3253 err = -ENOMEM;
3254 goto err_free_all;
3257 return driver;
3258 err_free_all:
3259 kfree(driver->ports);
3260 kfree(driver->ttys);
3261 kfree(driver->termios);
3262 kfree(driver->cdevs);
3263 kfree(driver);
3264 return ERR_PTR(err);
3266 EXPORT_SYMBOL(__tty_alloc_driver);
3268 static void destruct_tty_driver(struct kref *kref)
3270 struct tty_driver *driver = container_of(kref, struct tty_driver, kref);
3271 int i;
3272 struct ktermios *tp;
3274 if (driver->flags & TTY_DRIVER_INSTALLED) {
3275 for (i = 0; i < driver->num; i++) {
3276 tp = driver->termios[i];
3277 if (tp) {
3278 driver->termios[i] = NULL;
3279 kfree(tp);
3281 if (!(driver->flags & TTY_DRIVER_DYNAMIC_DEV))
3282 tty_unregister_device(driver, i);
3284 proc_tty_unregister_driver(driver);
3285 if (driver->flags & TTY_DRIVER_DYNAMIC_ALLOC)
3286 cdev_del(driver->cdevs[0]);
3288 kfree(driver->cdevs);
3289 kfree(driver->ports);
3290 kfree(driver->termios);
3291 kfree(driver->ttys);
3292 kfree(driver);
3295 void tty_driver_kref_put(struct tty_driver *driver)
3297 kref_put(&driver->kref, destruct_tty_driver);
3299 EXPORT_SYMBOL(tty_driver_kref_put);
3301 void tty_set_operations(struct tty_driver *driver,
3302 const struct tty_operations *op)
3304 driver->ops = op;
3306 EXPORT_SYMBOL(tty_set_operations);
3308 void put_tty_driver(struct tty_driver *d)
3310 tty_driver_kref_put(d);
3312 EXPORT_SYMBOL(put_tty_driver);
3315 * Called by a tty driver to register itself.
3317 int tty_register_driver(struct tty_driver *driver)
3319 int error;
3320 int i;
3321 dev_t dev;
3322 struct device *d;
3324 if (!driver->major) {
3325 error = alloc_chrdev_region(&dev, driver->minor_start,
3326 driver->num, driver->name);
3327 if (!error) {
3328 driver->major = MAJOR(dev);
3329 driver->minor_start = MINOR(dev);
3331 } else {
3332 dev = MKDEV(driver->major, driver->minor_start);
3333 error = register_chrdev_region(dev, driver->num, driver->name);
3335 if (error < 0)
3336 goto err;
3338 if (driver->flags & TTY_DRIVER_DYNAMIC_ALLOC) {
3339 error = tty_cdev_add(driver, dev, 0, driver->num);
3340 if (error)
3341 goto err_unreg_char;
3344 mutex_lock(&tty_mutex);
3345 list_add(&driver->tty_drivers, &tty_drivers);
3346 mutex_unlock(&tty_mutex);
3348 if (!(driver->flags & TTY_DRIVER_DYNAMIC_DEV)) {
3349 for (i = 0; i < driver->num; i++) {
3350 d = tty_register_device(driver, i, NULL);
3351 if (IS_ERR(d)) {
3352 error = PTR_ERR(d);
3353 goto err_unreg_devs;
3357 proc_tty_register_driver(driver);
3358 driver->flags |= TTY_DRIVER_INSTALLED;
3359 return 0;
3361 err_unreg_devs:
3362 for (i--; i >= 0; i--)
3363 tty_unregister_device(driver, i);
3365 mutex_lock(&tty_mutex);
3366 list_del(&driver->tty_drivers);
3367 mutex_unlock(&tty_mutex);
3369 err_unreg_char:
3370 unregister_chrdev_region(dev, driver->num);
3371 err:
3372 return error;
3374 EXPORT_SYMBOL(tty_register_driver);
3377 * Called by a tty driver to unregister itself.
3379 int tty_unregister_driver(struct tty_driver *driver)
3381 #if 0
3382 /* FIXME */
3383 if (driver->refcount)
3384 return -EBUSY;
3385 #endif
3386 unregister_chrdev_region(MKDEV(driver->major, driver->minor_start),
3387 driver->num);
3388 mutex_lock(&tty_mutex);
3389 list_del(&driver->tty_drivers);
3390 mutex_unlock(&tty_mutex);
3391 return 0;
3394 EXPORT_SYMBOL(tty_unregister_driver);
3396 dev_t tty_devnum(struct tty_struct *tty)
3398 return MKDEV(tty->driver->major, tty->driver->minor_start) + tty->index;
3400 EXPORT_SYMBOL(tty_devnum);
3402 void tty_default_fops(struct file_operations *fops)
3404 *fops = tty_fops;
3407 static char *tty_devnode(struct device *dev, umode_t *mode)
3409 if (!mode)
3410 return NULL;
3411 if (dev->devt == MKDEV(TTYAUX_MAJOR, 0) ||
3412 dev->devt == MKDEV(TTYAUX_MAJOR, 2))
3413 *mode = 0666;
3414 return NULL;
3417 static int __init tty_class_init(void)
3419 tty_class = class_create(THIS_MODULE, "tty");
3420 if (IS_ERR(tty_class))
3421 return PTR_ERR(tty_class);
3422 tty_class->devnode = tty_devnode;
3423 return 0;
3426 postcore_initcall(tty_class_init);
3428 /* 3/2004 jmc: why do these devices exist? */
3429 static struct cdev tty_cdev, console_cdev;
3431 static ssize_t show_cons_active(struct device *dev,
3432 struct device_attribute *attr, char *buf)
3434 struct console *cs[16];
3435 int i = 0;
3436 struct console *c;
3437 ssize_t count = 0;
3439 console_lock();
3440 for_each_console(c) {
3441 if (!c->device)
3442 continue;
3443 if (!c->write)
3444 continue;
3445 if ((c->flags & CON_ENABLED) == 0)
3446 continue;
3447 cs[i++] = c;
3448 if (i >= ARRAY_SIZE(cs))
3449 break;
3451 while (i--) {
3452 int index = cs[i]->index;
3453 struct tty_driver *drv = cs[i]->device(cs[i], &index);
3455 /* don't resolve tty0 as some programs depend on it */
3456 if (drv && (cs[i]->index > 0 || drv->major != TTY_MAJOR))
3457 count += tty_line_name(drv, index, buf + count);
3458 else
3459 count += sprintf(buf + count, "%s%d",
3460 cs[i]->name, cs[i]->index);
3462 count += sprintf(buf + count, "%c", i ? ' ':'\n');
3464 console_unlock();
3466 return count;
3468 static DEVICE_ATTR(active, S_IRUGO, show_cons_active, NULL);
3470 static struct attribute *cons_dev_attrs[] = {
3471 &dev_attr_active.attr,
3472 NULL
3475 ATTRIBUTE_GROUPS(cons_dev);
3477 static struct device *consdev;
3479 void console_sysfs_notify(void)
3481 if (consdev)
3482 sysfs_notify(&consdev->kobj, NULL, "active");
3486 * Ok, now we can initialize the rest of the tty devices and can count
3487 * on memory allocations, interrupts etc..
3489 int __init tty_init(void)
3491 tty_sysctl_init();
3492 cdev_init(&tty_cdev, &tty_fops);
3493 if (cdev_add(&tty_cdev, MKDEV(TTYAUX_MAJOR, 0), 1) ||
3494 register_chrdev_region(MKDEV(TTYAUX_MAJOR, 0), 1, "/dev/tty") < 0)
3495 panic("Couldn't register /dev/tty driver\n");
3496 device_create(tty_class, NULL, MKDEV(TTYAUX_MAJOR, 0), NULL, "tty");
3498 cdev_init(&console_cdev, &console_fops);
3499 if (cdev_add(&console_cdev, MKDEV(TTYAUX_MAJOR, 1), 1) ||
3500 register_chrdev_region(MKDEV(TTYAUX_MAJOR, 1), 1, "/dev/console") < 0)
3501 panic("Couldn't register /dev/console driver\n");
3502 consdev = device_create_with_groups(tty_class, NULL,
3503 MKDEV(TTYAUX_MAJOR, 1), NULL,
3504 cons_dev_groups, "console");
3505 if (IS_ERR(consdev))
3506 consdev = NULL;
3508 #ifdef CONFIG_VT
3509 vty_init(&console_fops);
3510 #endif
3511 return 0;