]> Git Repo - linux.git/blob - drivers/tty/tty_io.c
Merge tag 'pci-v4.14-changes' of git://git.kernel.org/pub/scm/linux/kernel/git/helgaa...
[linux.git] / drivers / tty / tty_io.c
1 /*
2  *  Copyright (C) 1991, 1992  Linus Torvalds
3  */
4
5 /*
6  * 'tty_io.c' gives an orthogonal feeling to tty's, be they consoles
7  * or rs-channels. It also implements echoing, cooked mode etc.
8  *
9  * Kill-line thanks to John T Kohl, who also corrected VMIN = VTIME = 0.
10  *
11  * Modified by Theodore Ts'o, 9/14/92, to dynamically allocate the
12  * tty_struct and tty_queue structures.  Previously there was an array
13  * of 256 tty_struct's which was statically allocated, and the
14  * tty_queue structures were allocated at boot time.  Both are now
15  * dynamically allocated only when the tty is open.
16  *
17  * Also restructured routines so that there is more of a separation
18  * between the high-level tty routines (tty_io.c and tty_ioctl.c) and
19  * the low-level tty routines (serial.c, pty.c, console.c).  This
20  * makes for cleaner and more compact code.  -TYT, 9/17/92
21  *
22  * Modified by Fred N. van Kempen, 01/29/93, to add line disciplines
23  * which can be dynamically activated and de-activated by the line
24  * discipline handling modules (like SLIP).
25  *
26  * NOTE: pay no attention to the line discipline code (yet); its
27  * interface is still subject to change in this version...
28  * -- TYT, 1/31/92
29  *
30  * Added functionality to the OPOST tty handling.  No delays, but all
31  * other bits should be there.
32  *      -- Nick Holloway <[email protected]>, 27th May 1993.
33  *
34  * Rewrote canonical mode and added more termios flags.
35  *      -- [email protected] (J. Cowley), 13Jan94
36  *
37  * Reorganized FASYNC support so mouse code can share it.
38  *      -- [email protected], 9Sep95
39  *
40  * New TIOCLINUX variants added.
41  *      -- [email protected], 19-Nov-95
42  *
43  * Restrict vt switching via ioctl()
44  *      -- [email protected], 5-Dec-95
45  *
46  * Move console and virtual terminal code to more appropriate files,
47  * implement CONFIG_VT and generalize console device interface.
48  *      -- Marko Kohtala <[email protected]>, March 97
49  *
50  * Rewrote tty_init_dev and tty_release_dev to eliminate races.
51  *      -- Bill Hawes <[email protected]>, June 97
52  *
53  * Added devfs support.
54  *      -- C. Scott Ananian <[email protected]>, 13-Jan-1998
55  *
56  * Added support for a Unix98-style ptmx device.
57  *      -- C. Scott Ananian <[email protected]>, 14-Jan-1998
58  *
59  * Reduced memory usage for older ARM systems
60  *      -- Russell King <[email protected]>
61  *
62  * Move do_SAK() into process context.  Less stack use in devfs functions.
63  * alloc_tty_struct() always uses kmalloc()
64  *                       -- Andrew Morton <[email protected]> 17Mar01
65  */
66
67 #include <linux/types.h>
68 #include <linux/major.h>
69 #include <linux/errno.h>
70 #include <linux/signal.h>
71 #include <linux/fcntl.h>
72 #include <linux/sched/signal.h>
73 #include <linux/sched/task.h>
74 #include <linux/interrupt.h>
75 #include <linux/tty.h>
76 #include <linux/tty_driver.h>
77 #include <linux/tty_flip.h>
78 #include <linux/devpts_fs.h>
79 #include <linux/file.h>
80 #include <linux/fdtable.h>
81 #include <linux/console.h>
82 #include <linux/timer.h>
83 #include <linux/ctype.h>
84 #include <linux/kd.h>
85 #include <linux/mm.h>
86 #include <linux/string.h>
87 #include <linux/slab.h>
88 #include <linux/poll.h>
89 #include <linux/proc_fs.h>
90 #include <linux/init.h>
91 #include <linux/module.h>
92 #include <linux/device.h>
93 #include <linux/wait.h>
94 #include <linux/bitops.h>
95 #include <linux/delay.h>
96 #include <linux/seq_file.h>
97 #include <linux/serial.h>
98 #include <linux/ratelimit.h>
99
100 #include <linux/uaccess.h>
101
102 #include <linux/kbd_kern.h>
103 #include <linux/vt_kern.h>
104 #include <linux/selection.h>
105
106 #include <linux/kmod.h>
107 #include <linux/nsproxy.h>
108
109 #undef TTY_DEBUG_HANGUP
110 #ifdef TTY_DEBUG_HANGUP
111 # define tty_debug_hangup(tty, f, args...)      tty_debug(tty, f, ##args)
112 #else
113 # define tty_debug_hangup(tty, f, args...)      do { } while (0)
114 #endif
115
116 #define TTY_PARANOIA_CHECK 1
117 #define CHECK_TTY_COUNT 1
118
119 struct ktermios tty_std_termios = {     /* for the benefit of tty drivers  */
120         .c_iflag = ICRNL | IXON,
121         .c_oflag = OPOST | ONLCR,
122         .c_cflag = B38400 | CS8 | CREAD | HUPCL,
123         .c_lflag = ISIG | ICANON | ECHO | ECHOE | ECHOK |
124                    ECHOCTL | ECHOKE | IEXTEN,
125         .c_cc = INIT_C_CC,
126         .c_ispeed = 38400,
127         .c_ospeed = 38400,
128         /* .c_line = N_TTY, */
129 };
130
131 EXPORT_SYMBOL(tty_std_termios);
132
133 /* This list gets poked at by procfs and various bits of boot up code. This
134    could do with some rationalisation such as pulling the tty proc function
135    into this file */
136
137 LIST_HEAD(tty_drivers);                 /* linked list of tty drivers */
138
139 /* Mutex to protect creating and releasing a tty */
140 DEFINE_MUTEX(tty_mutex);
141
142 static ssize_t tty_read(struct file *, char __user *, size_t, loff_t *);
143 static ssize_t tty_write(struct file *, const char __user *, size_t, loff_t *);
144 ssize_t redirected_tty_write(struct file *, const char __user *,
145                                                         size_t, loff_t *);
146 static unsigned int tty_poll(struct file *, poll_table *);
147 static int tty_open(struct inode *, struct file *);
148 long tty_ioctl(struct file *file, unsigned int cmd, unsigned long arg);
149 #ifdef CONFIG_COMPAT
150 static long tty_compat_ioctl(struct file *file, unsigned int cmd,
151                                 unsigned long arg);
152 #else
153 #define tty_compat_ioctl NULL
154 #endif
155 static int __tty_fasync(int fd, struct file *filp, int on);
156 static int tty_fasync(int fd, struct file *filp, int on);
157 static void release_tty(struct tty_struct *tty, int idx);
158
159 /**
160  *      free_tty_struct         -       free a disused tty
161  *      @tty: tty struct to free
162  *
163  *      Free the write buffers, tty queue and tty memory itself.
164  *
165  *      Locking: none. Must be called after tty is definitely unused
166  */
167
168 static void free_tty_struct(struct tty_struct *tty)
169 {
170         tty_ldisc_deinit(tty);
171         put_device(tty->dev);
172         kfree(tty->write_buf);
173         tty->magic = 0xDEADDEAD;
174         kfree(tty);
175 }
176
177 static inline struct tty_struct *file_tty(struct file *file)
178 {
179         return ((struct tty_file_private *)file->private_data)->tty;
180 }
181
182 int tty_alloc_file(struct file *file)
183 {
184         struct tty_file_private *priv;
185
186         priv = kmalloc(sizeof(*priv), GFP_KERNEL);
187         if (!priv)
188                 return -ENOMEM;
189
190         file->private_data = priv;
191
192         return 0;
193 }
194
195 /* Associate a new file with the tty structure */
196 void tty_add_file(struct tty_struct *tty, struct file *file)
197 {
198         struct tty_file_private *priv = file->private_data;
199
200         priv->tty = tty;
201         priv->file = file;
202
203         spin_lock(&tty->files_lock);
204         list_add(&priv->list, &tty->tty_files);
205         spin_unlock(&tty->files_lock);
206 }
207
208 /**
209  * tty_free_file - free file->private_data
210  *
211  * This shall be used only for fail path handling when tty_add_file was not
212  * called yet.
213  */
214 void tty_free_file(struct file *file)
215 {
216         struct tty_file_private *priv = file->private_data;
217
218         file->private_data = NULL;
219         kfree(priv);
220 }
221
222 /* Delete file from its tty */
223 static void tty_del_file(struct file *file)
224 {
225         struct tty_file_private *priv = file->private_data;
226         struct tty_struct *tty = priv->tty;
227
228         spin_lock(&tty->files_lock);
229         list_del(&priv->list);
230         spin_unlock(&tty->files_lock);
231         tty_free_file(file);
232 }
233
234 /**
235  *      tty_name        -       return tty naming
236  *      @tty: tty structure
237  *
238  *      Convert a tty structure into a name. The name reflects the kernel
239  *      naming policy and if udev is in use may not reflect user space
240  *
241  *      Locking: none
242  */
243
244 const char *tty_name(const struct tty_struct *tty)
245 {
246         if (!tty) /* Hmm.  NULL pointer.  That's fun. */
247                 return "NULL tty";
248         return tty->name;
249 }
250
251 EXPORT_SYMBOL(tty_name);
252
253 const char *tty_driver_name(const struct tty_struct *tty)
254 {
255         if (!tty || !tty->driver)
256                 return "";
257         return tty->driver->name;
258 }
259
260 static int tty_paranoia_check(struct tty_struct *tty, struct inode *inode,
261                               const char *routine)
262 {
263 #ifdef TTY_PARANOIA_CHECK
264         if (!tty) {
265                 pr_warn("(%d:%d): %s: NULL tty\n",
266                         imajor(inode), iminor(inode), routine);
267                 return 1;
268         }
269         if (tty->magic != TTY_MAGIC) {
270                 pr_warn("(%d:%d): %s: bad magic number\n",
271                         imajor(inode), iminor(inode), routine);
272                 return 1;
273         }
274 #endif
275         return 0;
276 }
277
278 /* Caller must hold tty_lock */
279 static int check_tty_count(struct tty_struct *tty, const char *routine)
280 {
281 #ifdef CHECK_TTY_COUNT
282         struct list_head *p;
283         int count = 0, kopen_count = 0;
284
285         spin_lock(&tty->files_lock);
286         list_for_each(p, &tty->tty_files) {
287                 count++;
288         }
289         spin_unlock(&tty->files_lock);
290         if (tty->driver->type == TTY_DRIVER_TYPE_PTY &&
291             tty->driver->subtype == PTY_TYPE_SLAVE &&
292             tty->link && tty->link->count)
293                 count++;
294         if (tty_port_kopened(tty->port))
295                 kopen_count++;
296         if (tty->count != (count + kopen_count)) {
297                 tty_warn(tty, "%s: tty->count(%d) != (#fd's(%d) + #kopen's(%d))\n",
298                          routine, tty->count, count, kopen_count);
299                 return (count + kopen_count);
300         }
301 #endif
302         return 0;
303 }
304
305 /**
306  *      get_tty_driver          -       find device of a tty
307  *      @dev_t: device identifier
308  *      @index: returns the index of the tty
309  *
310  *      This routine returns a tty driver structure, given a device number
311  *      and also passes back the index number.
312  *
313  *      Locking: caller must hold tty_mutex
314  */
315
316 static struct tty_driver *get_tty_driver(dev_t device, int *index)
317 {
318         struct tty_driver *p;
319
320         list_for_each_entry(p, &tty_drivers, tty_drivers) {
321                 dev_t base = MKDEV(p->major, p->minor_start);
322                 if (device < base || device >= base + p->num)
323                         continue;
324                 *index = device - base;
325                 return tty_driver_kref_get(p);
326         }
327         return NULL;
328 }
329
330 /**
331  *      tty_dev_name_to_number  -       return dev_t for device name
332  *      @name: user space name of device under /dev
333  *      @number: pointer to dev_t that this function will populate
334  *
335  *      This function converts device names like ttyS0 or ttyUSB1 into dev_t
336  *      like (4, 64) or (188, 1). If no corresponding driver is registered then
337  *      the function returns -ENODEV.
338  *
339  *      Locking: this acquires tty_mutex to protect the tty_drivers list from
340  *              being modified while we are traversing it, and makes sure to
341  *              release it before exiting.
342  */
343 int tty_dev_name_to_number(const char *name, dev_t *number)
344 {
345         struct tty_driver *p;
346         int ret;
347         int index, prefix_length = 0;
348         const char *str;
349
350         for (str = name; *str && !isdigit(*str); str++)
351                 ;
352
353         if (!*str)
354                 return -EINVAL;
355
356         ret = kstrtoint(str, 10, &index);
357         if (ret)
358                 return ret;
359
360         prefix_length = str - name;
361         mutex_lock(&tty_mutex);
362
363         list_for_each_entry(p, &tty_drivers, tty_drivers)
364                 if (prefix_length == strlen(p->name) && strncmp(name,
365                                         p->name, prefix_length) == 0) {
366                         if (index < p->num) {
367                                 *number = MKDEV(p->major, p->minor_start + index);
368                                 goto out;
369                         }
370                 }
371
372         /* if here then driver wasn't found */
373         ret = -ENODEV;
374 out:
375         mutex_unlock(&tty_mutex);
376         return ret;
377 }
378 EXPORT_SYMBOL_GPL(tty_dev_name_to_number);
379
380 #ifdef CONFIG_CONSOLE_POLL
381
382 /**
383  *      tty_find_polling_driver -       find device of a polled tty
384  *      @name: name string to match
385  *      @line: pointer to resulting tty line nr
386  *
387  *      This routine returns a tty driver structure, given a name
388  *      and the condition that the tty driver is capable of polled
389  *      operation.
390  */
391 struct tty_driver *tty_find_polling_driver(char *name, int *line)
392 {
393         struct tty_driver *p, *res = NULL;
394         int tty_line = 0;
395         int len;
396         char *str, *stp;
397
398         for (str = name; *str; str++)
399                 if ((*str >= '0' && *str <= '9') || *str == ',')
400                         break;
401         if (!*str)
402                 return NULL;
403
404         len = str - name;
405         tty_line = simple_strtoul(str, &str, 10);
406
407         mutex_lock(&tty_mutex);
408         /* Search through the tty devices to look for a match */
409         list_for_each_entry(p, &tty_drivers, tty_drivers) {
410                 if (strncmp(name, p->name, len) != 0)
411                         continue;
412                 stp = str;
413                 if (*stp == ',')
414                         stp++;
415                 if (*stp == '\0')
416                         stp = NULL;
417
418                 if (tty_line >= 0 && tty_line < p->num && p->ops &&
419                     p->ops->poll_init && !p->ops->poll_init(p, tty_line, stp)) {
420                         res = tty_driver_kref_get(p);
421                         *line = tty_line;
422                         break;
423                 }
424         }
425         mutex_unlock(&tty_mutex);
426
427         return res;
428 }
429 EXPORT_SYMBOL_GPL(tty_find_polling_driver);
430 #endif
431
432 static ssize_t hung_up_tty_read(struct file *file, char __user *buf,
433                                 size_t count, loff_t *ppos)
434 {
435         return 0;
436 }
437
438 static ssize_t hung_up_tty_write(struct file *file, const char __user *buf,
439                                  size_t count, loff_t *ppos)
440 {
441         return -EIO;
442 }
443
444 /* No kernel lock held - none needed ;) */
445 static unsigned int hung_up_tty_poll(struct file *filp, poll_table *wait)
446 {
447         return POLLIN | POLLOUT | POLLERR | POLLHUP | POLLRDNORM | POLLWRNORM;
448 }
449
450 static long hung_up_tty_ioctl(struct file *file, unsigned int cmd,
451                 unsigned long arg)
452 {
453         return cmd == TIOCSPGRP ? -ENOTTY : -EIO;
454 }
455
456 static long hung_up_tty_compat_ioctl(struct file *file,
457                                      unsigned int cmd, unsigned long arg)
458 {
459         return cmd == TIOCSPGRP ? -ENOTTY : -EIO;
460 }
461
462 static int hung_up_tty_fasync(int fd, struct file *file, int on)
463 {
464         return -ENOTTY;
465 }
466
467 static void tty_show_fdinfo(struct seq_file *m, struct file *file)
468 {
469         struct tty_struct *tty = file_tty(file);
470
471         if (tty && tty->ops && tty->ops->show_fdinfo)
472                 tty->ops->show_fdinfo(tty, m);
473 }
474
475 static const struct file_operations tty_fops = {
476         .llseek         = no_llseek,
477         .read           = tty_read,
478         .write          = tty_write,
479         .poll           = tty_poll,
480         .unlocked_ioctl = tty_ioctl,
481         .compat_ioctl   = tty_compat_ioctl,
482         .open           = tty_open,
483         .release        = tty_release,
484         .fasync         = tty_fasync,
485         .show_fdinfo    = tty_show_fdinfo,
486 };
487
488 static const struct file_operations console_fops = {
489         .llseek         = no_llseek,
490         .read           = tty_read,
491         .write          = redirected_tty_write,
492         .poll           = tty_poll,
493         .unlocked_ioctl = tty_ioctl,
494         .compat_ioctl   = tty_compat_ioctl,
495         .open           = tty_open,
496         .release        = tty_release,
497         .fasync         = tty_fasync,
498 };
499
500 static const struct file_operations hung_up_tty_fops = {
501         .llseek         = no_llseek,
502         .read           = hung_up_tty_read,
503         .write          = hung_up_tty_write,
504         .poll           = hung_up_tty_poll,
505         .unlocked_ioctl = hung_up_tty_ioctl,
506         .compat_ioctl   = hung_up_tty_compat_ioctl,
507         .release        = tty_release,
508         .fasync         = hung_up_tty_fasync,
509 };
510
511 static DEFINE_SPINLOCK(redirect_lock);
512 static struct file *redirect;
513
514 /**
515  *      tty_wakeup      -       request more data
516  *      @tty: terminal
517  *
518  *      Internal and external helper for wakeups of tty. This function
519  *      informs the line discipline if present that the driver is ready
520  *      to receive more output data.
521  */
522
523 void tty_wakeup(struct tty_struct *tty)
524 {
525         struct tty_ldisc *ld;
526
527         if (test_bit(TTY_DO_WRITE_WAKEUP, &tty->flags)) {
528                 ld = tty_ldisc_ref(tty);
529                 if (ld) {
530                         if (ld->ops->write_wakeup)
531                                 ld->ops->write_wakeup(tty);
532                         tty_ldisc_deref(ld);
533                 }
534         }
535         wake_up_interruptible_poll(&tty->write_wait, POLLOUT);
536 }
537
538 EXPORT_SYMBOL_GPL(tty_wakeup);
539
540 /**
541  *      __tty_hangup            -       actual handler for hangup events
542  *      @work: tty device
543  *
544  *      This can be called by a "kworker" kernel thread.  That is process
545  *      synchronous but doesn't hold any locks, so we need to make sure we
546  *      have the appropriate locks for what we're doing.
547  *
548  *      The hangup event clears any pending redirections onto the hung up
549  *      device. It ensures future writes will error and it does the needed
550  *      line discipline hangup and signal delivery. The tty object itself
551  *      remains intact.
552  *
553  *      Locking:
554  *              BTM
555  *                redirect lock for undoing redirection
556  *                file list lock for manipulating list of ttys
557  *                tty_ldiscs_lock from called functions
558  *                termios_rwsem resetting termios data
559  *                tasklist_lock to walk task list for hangup event
560  *                  ->siglock to protect ->signal/->sighand
561  */
562 static void __tty_hangup(struct tty_struct *tty, int exit_session)
563 {
564         struct file *cons_filp = NULL;
565         struct file *filp, *f = NULL;
566         struct tty_file_private *priv;
567         int    closecount = 0, n;
568         int refs;
569
570         if (!tty)
571                 return;
572
573
574         spin_lock(&redirect_lock);
575         if (redirect && file_tty(redirect) == tty) {
576                 f = redirect;
577                 redirect = NULL;
578         }
579         spin_unlock(&redirect_lock);
580
581         tty_lock(tty);
582
583         if (test_bit(TTY_HUPPED, &tty->flags)) {
584                 tty_unlock(tty);
585                 return;
586         }
587
588         /* inuse_filps is protected by the single tty lock,
589            this really needs to change if we want to flush the
590            workqueue with the lock held */
591         check_tty_count(tty, "tty_hangup");
592
593         spin_lock(&tty->files_lock);
594         /* This breaks for file handles being sent over AF_UNIX sockets ? */
595         list_for_each_entry(priv, &tty->tty_files, list) {
596                 filp = priv->file;
597                 if (filp->f_op->write == redirected_tty_write)
598                         cons_filp = filp;
599                 if (filp->f_op->write != tty_write)
600                         continue;
601                 closecount++;
602                 __tty_fasync(-1, filp, 0);      /* can't block */
603                 filp->f_op = &hung_up_tty_fops;
604         }
605         spin_unlock(&tty->files_lock);
606
607         refs = tty_signal_session_leader(tty, exit_session);
608         /* Account for the p->signal references we killed */
609         while (refs--)
610                 tty_kref_put(tty);
611
612         tty_ldisc_hangup(tty, cons_filp != NULL);
613
614         spin_lock_irq(&tty->ctrl_lock);
615         clear_bit(TTY_THROTTLED, &tty->flags);
616         clear_bit(TTY_DO_WRITE_WAKEUP, &tty->flags);
617         put_pid(tty->session);
618         put_pid(tty->pgrp);
619         tty->session = NULL;
620         tty->pgrp = NULL;
621         tty->ctrl_status = 0;
622         spin_unlock_irq(&tty->ctrl_lock);
623
624         /*
625          * If one of the devices matches a console pointer, we
626          * cannot just call hangup() because that will cause
627          * tty->count and state->count to go out of sync.
628          * So we just call close() the right number of times.
629          */
630         if (cons_filp) {
631                 if (tty->ops->close)
632                         for (n = 0; n < closecount; n++)
633                                 tty->ops->close(tty, cons_filp);
634         } else if (tty->ops->hangup)
635                 tty->ops->hangup(tty);
636         /*
637          * We don't want to have driver/ldisc interactions beyond the ones
638          * we did here. The driver layer expects no calls after ->hangup()
639          * from the ldisc side, which is now guaranteed.
640          */
641         set_bit(TTY_HUPPED, &tty->flags);
642         tty_unlock(tty);
643
644         if (f)
645                 fput(f);
646 }
647
648 static void do_tty_hangup(struct work_struct *work)
649 {
650         struct tty_struct *tty =
651                 container_of(work, struct tty_struct, hangup_work);
652
653         __tty_hangup(tty, 0);
654 }
655
656 /**
657  *      tty_hangup              -       trigger a hangup event
658  *      @tty: tty to hangup
659  *
660  *      A carrier loss (virtual or otherwise) has occurred on this like
661  *      schedule a hangup sequence to run after this event.
662  */
663
664 void tty_hangup(struct tty_struct *tty)
665 {
666         tty_debug_hangup(tty, "hangup\n");
667         schedule_work(&tty->hangup_work);
668 }
669
670 EXPORT_SYMBOL(tty_hangup);
671
672 /**
673  *      tty_vhangup             -       process vhangup
674  *      @tty: tty to hangup
675  *
676  *      The user has asked via system call for the terminal to be hung up.
677  *      We do this synchronously so that when the syscall returns the process
678  *      is complete. That guarantee is necessary for security reasons.
679  */
680
681 void tty_vhangup(struct tty_struct *tty)
682 {
683         tty_debug_hangup(tty, "vhangup\n");
684         __tty_hangup(tty, 0);
685 }
686
687 EXPORT_SYMBOL(tty_vhangup);
688
689
690 /**
691  *      tty_vhangup_self        -       process vhangup for own ctty
692  *
693  *      Perform a vhangup on the current controlling tty
694  */
695
696 void tty_vhangup_self(void)
697 {
698         struct tty_struct *tty;
699
700         tty = get_current_tty();
701         if (tty) {
702                 tty_vhangup(tty);
703                 tty_kref_put(tty);
704         }
705 }
706
707 /**
708  *      tty_vhangup_session             -       hangup session leader exit
709  *      @tty: tty to hangup
710  *
711  *      The session leader is exiting and hanging up its controlling terminal.
712  *      Every process in the foreground process group is signalled SIGHUP.
713  *
714  *      We do this synchronously so that when the syscall returns the process
715  *      is complete. That guarantee is necessary for security reasons.
716  */
717
718 void tty_vhangup_session(struct tty_struct *tty)
719 {
720         tty_debug_hangup(tty, "session hangup\n");
721         __tty_hangup(tty, 1);
722 }
723
724 /**
725  *      tty_hung_up_p           -       was tty hung up
726  *      @filp: file pointer of tty
727  *
728  *      Return true if the tty has been subject to a vhangup or a carrier
729  *      loss
730  */
731
732 int tty_hung_up_p(struct file *filp)
733 {
734         return (filp && filp->f_op == &hung_up_tty_fops);
735 }
736
737 EXPORT_SYMBOL(tty_hung_up_p);
738
739 /**
740  *      stop_tty        -       propagate flow control
741  *      @tty: tty to stop
742  *
743  *      Perform flow control to the driver. May be called
744  *      on an already stopped device and will not re-call the driver
745  *      method.
746  *
747  *      This functionality is used by both the line disciplines for
748  *      halting incoming flow and by the driver. It may therefore be
749  *      called from any context, may be under the tty atomic_write_lock
750  *      but not always.
751  *
752  *      Locking:
753  *              flow_lock
754  */
755
756 void __stop_tty(struct tty_struct *tty)
757 {
758         if (tty->stopped)
759                 return;
760         tty->stopped = 1;
761         if (tty->ops->stop)
762                 tty->ops->stop(tty);
763 }
764
765 void stop_tty(struct tty_struct *tty)
766 {
767         unsigned long flags;
768
769         spin_lock_irqsave(&tty->flow_lock, flags);
770         __stop_tty(tty);
771         spin_unlock_irqrestore(&tty->flow_lock, flags);
772 }
773 EXPORT_SYMBOL(stop_tty);
774
775 /**
776  *      start_tty       -       propagate flow control
777  *      @tty: tty to start
778  *
779  *      Start a tty that has been stopped if at all possible. If this
780  *      tty was previous stopped and is now being started, the driver
781  *      start method is invoked and the line discipline woken.
782  *
783  *      Locking:
784  *              flow_lock
785  */
786
787 void __start_tty(struct tty_struct *tty)
788 {
789         if (!tty->stopped || tty->flow_stopped)
790                 return;
791         tty->stopped = 0;
792         if (tty->ops->start)
793                 tty->ops->start(tty);
794         tty_wakeup(tty);
795 }
796
797 void start_tty(struct tty_struct *tty)
798 {
799         unsigned long flags;
800
801         spin_lock_irqsave(&tty->flow_lock, flags);
802         __start_tty(tty);
803         spin_unlock_irqrestore(&tty->flow_lock, flags);
804 }
805 EXPORT_SYMBOL(start_tty);
806
807 static void tty_update_time(struct timespec *time)
808 {
809         unsigned long sec = get_seconds();
810
811         /*
812          * We only care if the two values differ in anything other than the
813          * lower three bits (i.e every 8 seconds).  If so, then we can update
814          * the time of the tty device, otherwise it could be construded as a
815          * security leak to let userspace know the exact timing of the tty.
816          */
817         if ((sec ^ time->tv_sec) & ~7)
818                 time->tv_sec = sec;
819 }
820
821 /**
822  *      tty_read        -       read method for tty device files
823  *      @file: pointer to tty file
824  *      @buf: user buffer
825  *      @count: size of user buffer
826  *      @ppos: unused
827  *
828  *      Perform the read system call function on this terminal device. Checks
829  *      for hung up devices before calling the line discipline method.
830  *
831  *      Locking:
832  *              Locks the line discipline internally while needed. Multiple
833  *      read calls may be outstanding in parallel.
834  */
835
836 static ssize_t tty_read(struct file *file, char __user *buf, size_t count,
837                         loff_t *ppos)
838 {
839         int i;
840         struct inode *inode = file_inode(file);
841         struct tty_struct *tty = file_tty(file);
842         struct tty_ldisc *ld;
843
844         if (tty_paranoia_check(tty, inode, "tty_read"))
845                 return -EIO;
846         if (!tty || tty_io_error(tty))
847                 return -EIO;
848
849         /* We want to wait for the line discipline to sort out in this
850            situation */
851         ld = tty_ldisc_ref_wait(tty);
852         if (!ld)
853                 return hung_up_tty_read(file, buf, count, ppos);
854         if (ld->ops->read)
855                 i = ld->ops->read(tty, file, buf, count);
856         else
857                 i = -EIO;
858         tty_ldisc_deref(ld);
859
860         if (i > 0)
861                 tty_update_time(&inode->i_atime);
862
863         return i;
864 }
865
866 static void tty_write_unlock(struct tty_struct *tty)
867 {
868         mutex_unlock(&tty->atomic_write_lock);
869         wake_up_interruptible_poll(&tty->write_wait, POLLOUT);
870 }
871
872 static int tty_write_lock(struct tty_struct *tty, int ndelay)
873 {
874         if (!mutex_trylock(&tty->atomic_write_lock)) {
875                 if (ndelay)
876                         return -EAGAIN;
877                 if (mutex_lock_interruptible(&tty->atomic_write_lock))
878                         return -ERESTARTSYS;
879         }
880         return 0;
881 }
882
883 /*
884  * Split writes up in sane blocksizes to avoid
885  * denial-of-service type attacks
886  */
887 static inline ssize_t do_tty_write(
888         ssize_t (*write)(struct tty_struct *, struct file *, const unsigned char *, size_t),
889         struct tty_struct *tty,
890         struct file *file,
891         const char __user *buf,
892         size_t count)
893 {
894         ssize_t ret, written = 0;
895         unsigned int chunk;
896
897         ret = tty_write_lock(tty, file->f_flags & O_NDELAY);
898         if (ret < 0)
899                 return ret;
900
901         /*
902          * We chunk up writes into a temporary buffer. This
903          * simplifies low-level drivers immensely, since they
904          * don't have locking issues and user mode accesses.
905          *
906          * But if TTY_NO_WRITE_SPLIT is set, we should use a
907          * big chunk-size..
908          *
909          * The default chunk-size is 2kB, because the NTTY
910          * layer has problems with bigger chunks. It will
911          * claim to be able to handle more characters than
912          * it actually does.
913          *
914          * FIXME: This can probably go away now except that 64K chunks
915          * are too likely to fail unless switched to vmalloc...
916          */
917         chunk = 2048;
918         if (test_bit(TTY_NO_WRITE_SPLIT, &tty->flags))
919                 chunk = 65536;
920         if (count < chunk)
921                 chunk = count;
922
923         /* write_buf/write_cnt is protected by the atomic_write_lock mutex */
924         if (tty->write_cnt < chunk) {
925                 unsigned char *buf_chunk;
926
927                 if (chunk < 1024)
928                         chunk = 1024;
929
930                 buf_chunk = kmalloc(chunk, GFP_KERNEL);
931                 if (!buf_chunk) {
932                         ret = -ENOMEM;
933                         goto out;
934                 }
935                 kfree(tty->write_buf);
936                 tty->write_cnt = chunk;
937                 tty->write_buf = buf_chunk;
938         }
939
940         /* Do the write .. */
941         for (;;) {
942                 size_t size = count;
943                 if (size > chunk)
944                         size = chunk;
945                 ret = -EFAULT;
946                 if (copy_from_user(tty->write_buf, buf, size))
947                         break;
948                 ret = write(tty, file, tty->write_buf, size);
949                 if (ret <= 0)
950                         break;
951                 written += ret;
952                 buf += ret;
953                 count -= ret;
954                 if (!count)
955                         break;
956                 ret = -ERESTARTSYS;
957                 if (signal_pending(current))
958                         break;
959                 cond_resched();
960         }
961         if (written) {
962                 tty_update_time(&file_inode(file)->i_mtime);
963                 ret = written;
964         }
965 out:
966         tty_write_unlock(tty);
967         return ret;
968 }
969
970 /**
971  * tty_write_message - write a message to a certain tty, not just the console.
972  * @tty: the destination tty_struct
973  * @msg: the message to write
974  *
975  * This is used for messages that need to be redirected to a specific tty.
976  * We don't put it into the syslog queue right now maybe in the future if
977  * really needed.
978  *
979  * We must still hold the BTM and test the CLOSING flag for the moment.
980  */
981
982 void tty_write_message(struct tty_struct *tty, char *msg)
983 {
984         if (tty) {
985                 mutex_lock(&tty->atomic_write_lock);
986                 tty_lock(tty);
987                 if (tty->ops->write && tty->count > 0)
988                         tty->ops->write(tty, msg, strlen(msg));
989                 tty_unlock(tty);
990                 tty_write_unlock(tty);
991         }
992         return;
993 }
994
995
996 /**
997  *      tty_write               -       write method for tty device file
998  *      @file: tty file pointer
999  *      @buf: user data to write
1000  *      @count: bytes to write
1001  *      @ppos: unused
1002  *
1003  *      Write data to a tty device via the line discipline.
1004  *
1005  *      Locking:
1006  *              Locks the line discipline as required
1007  *              Writes to the tty driver are serialized by the atomic_write_lock
1008  *      and are then processed in chunks to the device. The line discipline
1009  *      write method will not be invoked in parallel for each device.
1010  */
1011
1012 static ssize_t tty_write(struct file *file, const char __user *buf,
1013                                                 size_t count, loff_t *ppos)
1014 {
1015         struct tty_struct *tty = file_tty(file);
1016         struct tty_ldisc *ld;
1017         ssize_t ret;
1018
1019         if (tty_paranoia_check(tty, file_inode(file), "tty_write"))
1020                 return -EIO;
1021         if (!tty || !tty->ops->write || tty_io_error(tty))
1022                         return -EIO;
1023         /* Short term debug to catch buggy drivers */
1024         if (tty->ops->write_room == NULL)
1025                 tty_err(tty, "missing write_room method\n");
1026         ld = tty_ldisc_ref_wait(tty);
1027         if (!ld)
1028                 return hung_up_tty_write(file, buf, count, ppos);
1029         if (!ld->ops->write)
1030                 ret = -EIO;
1031         else
1032                 ret = do_tty_write(ld->ops->write, tty, file, buf, count);
1033         tty_ldisc_deref(ld);
1034         return ret;
1035 }
1036
1037 ssize_t redirected_tty_write(struct file *file, const char __user *buf,
1038                                                 size_t count, loff_t *ppos)
1039 {
1040         struct file *p = NULL;
1041
1042         spin_lock(&redirect_lock);
1043         if (redirect)
1044                 p = get_file(redirect);
1045         spin_unlock(&redirect_lock);
1046
1047         if (p) {
1048                 ssize_t res;
1049                 res = vfs_write(p, buf, count, &p->f_pos);
1050                 fput(p);
1051                 return res;
1052         }
1053         return tty_write(file, buf, count, ppos);
1054 }
1055
1056 /**
1057  *      tty_send_xchar  -       send priority character
1058  *
1059  *      Send a high priority character to the tty even if stopped
1060  *
1061  *      Locking: none for xchar method, write ordering for write method.
1062  */
1063
1064 int tty_send_xchar(struct tty_struct *tty, char ch)
1065 {
1066         int     was_stopped = tty->stopped;
1067
1068         if (tty->ops->send_xchar) {
1069                 down_read(&tty->termios_rwsem);
1070                 tty->ops->send_xchar(tty, ch);
1071                 up_read(&tty->termios_rwsem);
1072                 return 0;
1073         }
1074
1075         if (tty_write_lock(tty, 0) < 0)
1076                 return -ERESTARTSYS;
1077
1078         down_read(&tty->termios_rwsem);
1079         if (was_stopped)
1080                 start_tty(tty);
1081         tty->ops->write(tty, &ch, 1);
1082         if (was_stopped)
1083                 stop_tty(tty);
1084         up_read(&tty->termios_rwsem);
1085         tty_write_unlock(tty);
1086         return 0;
1087 }
1088
1089 static char ptychar[] = "pqrstuvwxyzabcde";
1090
1091 /**
1092  *      pty_line_name   -       generate name for a pty
1093  *      @driver: the tty driver in use
1094  *      @index: the minor number
1095  *      @p: output buffer of at least 6 bytes
1096  *
1097  *      Generate a name from a driver reference and write it to the output
1098  *      buffer.
1099  *
1100  *      Locking: None
1101  */
1102 static void pty_line_name(struct tty_driver *driver, int index, char *p)
1103 {
1104         int i = index + driver->name_base;
1105         /* ->name is initialized to "ttyp", but "tty" is expected */
1106         sprintf(p, "%s%c%x",
1107                 driver->subtype == PTY_TYPE_SLAVE ? "tty" : driver->name,
1108                 ptychar[i >> 4 & 0xf], i & 0xf);
1109 }
1110
1111 /**
1112  *      tty_line_name   -       generate name for a tty
1113  *      @driver: the tty driver in use
1114  *      @index: the minor number
1115  *      @p: output buffer of at least 7 bytes
1116  *
1117  *      Generate a name from a driver reference and write it to the output
1118  *      buffer.
1119  *
1120  *      Locking: None
1121  */
1122 static ssize_t tty_line_name(struct tty_driver *driver, int index, char *p)
1123 {
1124         if (driver->flags & TTY_DRIVER_UNNUMBERED_NODE)
1125                 return sprintf(p, "%s", driver->name);
1126         else
1127                 return sprintf(p, "%s%d", driver->name,
1128                                index + driver->name_base);
1129 }
1130
1131 /**
1132  *      tty_driver_lookup_tty() - find an existing tty, if any
1133  *      @driver: the driver for the tty
1134  *      @idx:    the minor number
1135  *
1136  *      Return the tty, if found. If not found, return NULL or ERR_PTR() if the
1137  *      driver lookup() method returns an error.
1138  *
1139  *      Locking: tty_mutex must be held. If the tty is found, bump the tty kref.
1140  */
1141 static struct tty_struct *tty_driver_lookup_tty(struct tty_driver *driver,
1142                 struct file *file, int idx)
1143 {
1144         struct tty_struct *tty;
1145
1146         if (driver->ops->lookup)
1147                 if (!file)
1148                         tty = ERR_PTR(-EIO);
1149                 else
1150                         tty = driver->ops->lookup(driver, file, idx);
1151         else
1152                 tty = driver->ttys[idx];
1153
1154         if (!IS_ERR(tty))
1155                 tty_kref_get(tty);
1156         return tty;
1157 }
1158
1159 /**
1160  *      tty_init_termios        -  helper for termios setup
1161  *      @tty: the tty to set up
1162  *
1163  *      Initialise the termios structures for this tty. Thus runs under
1164  *      the tty_mutex currently so we can be relaxed about ordering.
1165  */
1166
1167 void tty_init_termios(struct tty_struct *tty)
1168 {
1169         struct ktermios *tp;
1170         int idx = tty->index;
1171
1172         if (tty->driver->flags & TTY_DRIVER_RESET_TERMIOS)
1173                 tty->termios = tty->driver->init_termios;
1174         else {
1175                 /* Check for lazy saved data */
1176                 tp = tty->driver->termios[idx];
1177                 if (tp != NULL) {
1178                         tty->termios = *tp;
1179                         tty->termios.c_line  = tty->driver->init_termios.c_line;
1180                 } else
1181                         tty->termios = tty->driver->init_termios;
1182         }
1183         /* Compatibility until drivers always set this */
1184         tty->termios.c_ispeed = tty_termios_input_baud_rate(&tty->termios);
1185         tty->termios.c_ospeed = tty_termios_baud_rate(&tty->termios);
1186 }
1187 EXPORT_SYMBOL_GPL(tty_init_termios);
1188
1189 int tty_standard_install(struct tty_driver *driver, struct tty_struct *tty)
1190 {
1191         tty_init_termios(tty);
1192         tty_driver_kref_get(driver);
1193         tty->count++;
1194         driver->ttys[tty->index] = tty;
1195         return 0;
1196 }
1197 EXPORT_SYMBOL_GPL(tty_standard_install);
1198
1199 /**
1200  *      tty_driver_install_tty() - install a tty entry in the driver
1201  *      @driver: the driver for the tty
1202  *      @tty: the tty
1203  *
1204  *      Install a tty object into the driver tables. The tty->index field
1205  *      will be set by the time this is called. This method is responsible
1206  *      for ensuring any need additional structures are allocated and
1207  *      configured.
1208  *
1209  *      Locking: tty_mutex for now
1210  */
1211 static int tty_driver_install_tty(struct tty_driver *driver,
1212                                                 struct tty_struct *tty)
1213 {
1214         return driver->ops->install ? driver->ops->install(driver, tty) :
1215                 tty_standard_install(driver, tty);
1216 }
1217
1218 /**
1219  *      tty_driver_remove_tty() - remove a tty from the driver tables
1220  *      @driver: the driver for the tty
1221  *      @idx:    the minor number
1222  *
1223  *      Remvoe a tty object from the driver tables. The tty->index field
1224  *      will be set by the time this is called.
1225  *
1226  *      Locking: tty_mutex for now
1227  */
1228 static void tty_driver_remove_tty(struct tty_driver *driver, struct tty_struct *tty)
1229 {
1230         if (driver->ops->remove)
1231                 driver->ops->remove(driver, tty);
1232         else
1233                 driver->ttys[tty->index] = NULL;
1234 }
1235
1236 /*
1237  *      tty_reopen()    - fast re-open of an open tty
1238  *      @tty    - the tty to open
1239  *
1240  *      Return 0 on success, -errno on error.
1241  *      Re-opens on master ptys are not allowed and return -EIO.
1242  *
1243  *      Locking: Caller must hold tty_lock
1244  */
1245 static int tty_reopen(struct tty_struct *tty)
1246 {
1247         struct tty_driver *driver = tty->driver;
1248
1249         if (driver->type == TTY_DRIVER_TYPE_PTY &&
1250             driver->subtype == PTY_TYPE_MASTER)
1251                 return -EIO;
1252
1253         if (!tty->count)
1254                 return -EAGAIN;
1255
1256         if (test_bit(TTY_EXCLUSIVE, &tty->flags) && !capable(CAP_SYS_ADMIN))
1257                 return -EBUSY;
1258
1259         tty->count++;
1260
1261         if (!tty->ldisc)
1262                 return tty_ldisc_reinit(tty, tty->termios.c_line);
1263
1264         return 0;
1265 }
1266
1267 /**
1268  *      tty_init_dev            -       initialise a tty device
1269  *      @driver: tty driver we are opening a device on
1270  *      @idx: device index
1271  *      @ret_tty: returned tty structure
1272  *
1273  *      Prepare a tty device. This may not be a "new" clean device but
1274  *      could also be an active device. The pty drivers require special
1275  *      handling because of this.
1276  *
1277  *      Locking:
1278  *              The function is called under the tty_mutex, which
1279  *      protects us from the tty struct or driver itself going away.
1280  *
1281  *      On exit the tty device has the line discipline attached and
1282  *      a reference count of 1. If a pair was created for pty/tty use
1283  *      and the other was a pty master then it too has a reference count of 1.
1284  *
1285  * WSH 06/09/97: Rewritten to remove races and properly clean up after a
1286  * failed open.  The new code protects the open with a mutex, so it's
1287  * really quite straightforward.  The mutex locking can probably be
1288  * relaxed for the (most common) case of reopening a tty.
1289  */
1290
1291 struct tty_struct *tty_init_dev(struct tty_driver *driver, int idx)
1292 {
1293         struct tty_struct *tty;
1294         int retval;
1295
1296         /*
1297          * First time open is complex, especially for PTY devices.
1298          * This code guarantees that either everything succeeds and the
1299          * TTY is ready for operation, or else the table slots are vacated
1300          * and the allocated memory released.  (Except that the termios
1301          * may be retained.)
1302          */
1303
1304         if (!try_module_get(driver->owner))
1305                 return ERR_PTR(-ENODEV);
1306
1307         tty = alloc_tty_struct(driver, idx);
1308         if (!tty) {
1309                 retval = -ENOMEM;
1310                 goto err_module_put;
1311         }
1312
1313         tty_lock(tty);
1314         retval = tty_driver_install_tty(driver, tty);
1315         if (retval < 0)
1316                 goto err_free_tty;
1317
1318         if (!tty->port)
1319                 tty->port = driver->ports[idx];
1320
1321         WARN_RATELIMIT(!tty->port,
1322                         "%s: %s driver does not set tty->port. This will crash the kernel later. Fix the driver!\n",
1323                         __func__, tty->driver->name);
1324
1325         tty->port->itty = tty;
1326
1327         /*
1328          * Structures all installed ... call the ldisc open routines.
1329          * If we fail here just call release_tty to clean up.  No need
1330          * to decrement the use counts, as release_tty doesn't care.
1331          */
1332         retval = tty_ldisc_setup(tty, tty->link);
1333         if (retval)
1334                 goto err_release_tty;
1335         /* Return the tty locked so that it cannot vanish under the caller */
1336         return tty;
1337
1338 err_free_tty:
1339         tty_unlock(tty);
1340         free_tty_struct(tty);
1341 err_module_put:
1342         module_put(driver->owner);
1343         return ERR_PTR(retval);
1344
1345         /* call the tty release_tty routine to clean out this slot */
1346 err_release_tty:
1347         tty_unlock(tty);
1348         tty_info_ratelimited(tty, "ldisc open failed (%d), clearing slot %d\n",
1349                              retval, idx);
1350         release_tty(tty, idx);
1351         return ERR_PTR(retval);
1352 }
1353
1354 static void tty_free_termios(struct tty_struct *tty)
1355 {
1356         struct ktermios *tp;
1357         int idx = tty->index;
1358
1359         /* If the port is going to reset then it has no termios to save */
1360         if (tty->driver->flags & TTY_DRIVER_RESET_TERMIOS)
1361                 return;
1362
1363         /* Stash the termios data */
1364         tp = tty->driver->termios[idx];
1365         if (tp == NULL) {
1366                 tp = kmalloc(sizeof(struct ktermios), GFP_KERNEL);
1367                 if (tp == NULL)
1368                         return;
1369                 tty->driver->termios[idx] = tp;
1370         }
1371         *tp = tty->termios;
1372 }
1373
1374 /**
1375  *      tty_flush_works         -       flush all works of a tty/pty pair
1376  *      @tty: tty device to flush works for (or either end of a pty pair)
1377  *
1378  *      Sync flush all works belonging to @tty (and the 'other' tty).
1379  */
1380 static void tty_flush_works(struct tty_struct *tty)
1381 {
1382         flush_work(&tty->SAK_work);
1383         flush_work(&tty->hangup_work);
1384         if (tty->link) {
1385                 flush_work(&tty->link->SAK_work);
1386                 flush_work(&tty->link->hangup_work);
1387         }
1388 }
1389
1390 /**
1391  *      release_one_tty         -       release tty structure memory
1392  *      @kref: kref of tty we are obliterating
1393  *
1394  *      Releases memory associated with a tty structure, and clears out the
1395  *      driver table slots. This function is called when a device is no longer
1396  *      in use. It also gets called when setup of a device fails.
1397  *
1398  *      Locking:
1399  *              takes the file list lock internally when working on the list
1400  *      of ttys that the driver keeps.
1401  *
1402  *      This method gets called from a work queue so that the driver private
1403  *      cleanup ops can sleep (needed for USB at least)
1404  */
1405 static void release_one_tty(struct work_struct *work)
1406 {
1407         struct tty_struct *tty =
1408                 container_of(work, struct tty_struct, hangup_work);
1409         struct tty_driver *driver = tty->driver;
1410         struct module *owner = driver->owner;
1411
1412         if (tty->ops->cleanup)
1413                 tty->ops->cleanup(tty);
1414
1415         tty->magic = 0;
1416         tty_driver_kref_put(driver);
1417         module_put(owner);
1418
1419         spin_lock(&tty->files_lock);
1420         list_del_init(&tty->tty_files);
1421         spin_unlock(&tty->files_lock);
1422
1423         put_pid(tty->pgrp);
1424         put_pid(tty->session);
1425         free_tty_struct(tty);
1426 }
1427
1428 static void queue_release_one_tty(struct kref *kref)
1429 {
1430         struct tty_struct *tty = container_of(kref, struct tty_struct, kref);
1431
1432         /* The hangup queue is now free so we can reuse it rather than
1433            waste a chunk of memory for each port */
1434         INIT_WORK(&tty->hangup_work, release_one_tty);
1435         schedule_work(&tty->hangup_work);
1436 }
1437
1438 /**
1439  *      tty_kref_put            -       release a tty kref
1440  *      @tty: tty device
1441  *
1442  *      Release a reference to a tty device and if need be let the kref
1443  *      layer destruct the object for us
1444  */
1445
1446 void tty_kref_put(struct tty_struct *tty)
1447 {
1448         if (tty)
1449                 kref_put(&tty->kref, queue_release_one_tty);
1450 }
1451 EXPORT_SYMBOL(tty_kref_put);
1452
1453 /**
1454  *      release_tty             -       release tty structure memory
1455  *
1456  *      Release both @tty and a possible linked partner (think pty pair),
1457  *      and decrement the refcount of the backing module.
1458  *
1459  *      Locking:
1460  *              tty_mutex
1461  *              takes the file list lock internally when working on the list
1462  *      of ttys that the driver keeps.
1463  *
1464  */
1465 static void release_tty(struct tty_struct *tty, int idx)
1466 {
1467         /* This should always be true but check for the moment */
1468         WARN_ON(tty->index != idx);
1469         WARN_ON(!mutex_is_locked(&tty_mutex));
1470         if (tty->ops->shutdown)
1471                 tty->ops->shutdown(tty);
1472         tty_free_termios(tty);
1473         tty_driver_remove_tty(tty->driver, tty);
1474         tty->port->itty = NULL;
1475         if (tty->link)
1476                 tty->link->port->itty = NULL;
1477         tty_buffer_cancel_work(tty->port);
1478
1479         tty_kref_put(tty->link);
1480         tty_kref_put(tty);
1481 }
1482
1483 /**
1484  *      tty_release_checks - check a tty before real release
1485  *      @tty: tty to check
1486  *      @o_tty: link of @tty (if any)
1487  *      @idx: index of the tty
1488  *
1489  *      Performs some paranoid checking before true release of the @tty.
1490  *      This is a no-op unless TTY_PARANOIA_CHECK is defined.
1491  */
1492 static int tty_release_checks(struct tty_struct *tty, int idx)
1493 {
1494 #ifdef TTY_PARANOIA_CHECK
1495         if (idx < 0 || idx >= tty->driver->num) {
1496                 tty_debug(tty, "bad idx %d\n", idx);
1497                 return -1;
1498         }
1499
1500         /* not much to check for devpts */
1501         if (tty->driver->flags & TTY_DRIVER_DEVPTS_MEM)
1502                 return 0;
1503
1504         if (tty != tty->driver->ttys[idx]) {
1505                 tty_debug(tty, "bad driver table[%d] = %p\n",
1506                           idx, tty->driver->ttys[idx]);
1507                 return -1;
1508         }
1509         if (tty->driver->other) {
1510                 struct tty_struct *o_tty = tty->link;
1511
1512                 if (o_tty != tty->driver->other->ttys[idx]) {
1513                         tty_debug(tty, "bad other table[%d] = %p\n",
1514                                   idx, tty->driver->other->ttys[idx]);
1515                         return -1;
1516                 }
1517                 if (o_tty->link != tty) {
1518                         tty_debug(tty, "bad link = %p\n", o_tty->link);
1519                         return -1;
1520                 }
1521         }
1522 #endif
1523         return 0;
1524 }
1525
1526 /**
1527  *      tty_kclose      -       closes tty opened by tty_kopen
1528  *      @tty: tty device
1529  *
1530  *      Performs the final steps to release and free a tty device. It is the
1531  *      same as tty_release_struct except that it also resets TTY_PORT_KOPENED
1532  *      flag on tty->port.
1533  */
1534 void tty_kclose(struct tty_struct *tty)
1535 {
1536         /*
1537          * Ask the line discipline code to release its structures
1538          */
1539         tty_ldisc_release(tty);
1540
1541         /* Wait for pending work before tty destruction commmences */
1542         tty_flush_works(tty);
1543
1544         tty_debug_hangup(tty, "freeing structure\n");
1545         /*
1546          * The release_tty function takes care of the details of clearing
1547          * the slots and preserving the termios structure. The tty_unlock_pair
1548          * should be safe as we keep a kref while the tty is locked (so the
1549          * unlock never unlocks a freed tty).
1550          */
1551         mutex_lock(&tty_mutex);
1552         tty_port_set_kopened(tty->port, 0);
1553         release_tty(tty, tty->index);
1554         mutex_unlock(&tty_mutex);
1555 }
1556 EXPORT_SYMBOL_GPL(tty_kclose);
1557
1558 /**
1559  *      tty_release_struct      -       release a tty struct
1560  *      @tty: tty device
1561  *      @idx: index of the tty
1562  *
1563  *      Performs the final steps to release and free a tty device. It is
1564  *      roughly the reverse of tty_init_dev.
1565  */
1566 void tty_release_struct(struct tty_struct *tty, int idx)
1567 {
1568         /*
1569          * Ask the line discipline code to release its structures
1570          */
1571         tty_ldisc_release(tty);
1572
1573         /* Wait for pending work before tty destruction commmences */
1574         tty_flush_works(tty);
1575
1576         tty_debug_hangup(tty, "freeing structure\n");
1577         /*
1578          * The release_tty function takes care of the details of clearing
1579          * the slots and preserving the termios structure. The tty_unlock_pair
1580          * should be safe as we keep a kref while the tty is locked (so the
1581          * unlock never unlocks a freed tty).
1582          */
1583         mutex_lock(&tty_mutex);
1584         release_tty(tty, idx);
1585         mutex_unlock(&tty_mutex);
1586 }
1587 EXPORT_SYMBOL_GPL(tty_release_struct);
1588
1589 /**
1590  *      tty_release             -       vfs callback for close
1591  *      @inode: inode of tty
1592  *      @filp: file pointer for handle to tty
1593  *
1594  *      Called the last time each file handle is closed that references
1595  *      this tty. There may however be several such references.
1596  *
1597  *      Locking:
1598  *              Takes bkl. See tty_release_dev
1599  *
1600  * Even releasing the tty structures is a tricky business.. We have
1601  * to be very careful that the structures are all released at the
1602  * same time, as interrupts might otherwise get the wrong pointers.
1603  *
1604  * WSH 09/09/97: rewritten to avoid some nasty race conditions that could
1605  * lead to double frees or releasing memory still in use.
1606  */
1607
1608 int tty_release(struct inode *inode, struct file *filp)
1609 {
1610         struct tty_struct *tty = file_tty(filp);
1611         struct tty_struct *o_tty = NULL;
1612         int     do_sleep, final;
1613         int     idx;
1614         long    timeout = 0;
1615         int     once = 1;
1616
1617         if (tty_paranoia_check(tty, inode, __func__))
1618                 return 0;
1619
1620         tty_lock(tty);
1621         check_tty_count(tty, __func__);
1622
1623         __tty_fasync(-1, filp, 0);
1624
1625         idx = tty->index;
1626         if (tty->driver->type == TTY_DRIVER_TYPE_PTY &&
1627             tty->driver->subtype == PTY_TYPE_MASTER)
1628                 o_tty = tty->link;
1629
1630         if (tty_release_checks(tty, idx)) {
1631                 tty_unlock(tty);
1632                 return 0;
1633         }
1634
1635         tty_debug_hangup(tty, "releasing (count=%d)\n", tty->count);
1636
1637         if (tty->ops->close)
1638                 tty->ops->close(tty, filp);
1639
1640         /* If tty is pty master, lock the slave pty (stable lock order) */
1641         tty_lock_slave(o_tty);
1642
1643         /*
1644          * Sanity check: if tty->count is going to zero, there shouldn't be
1645          * any waiters on tty->read_wait or tty->write_wait.  We test the
1646          * wait queues and kick everyone out _before_ actually starting to
1647          * close.  This ensures that we won't block while releasing the tty
1648          * structure.
1649          *
1650          * The test for the o_tty closing is necessary, since the master and
1651          * slave sides may close in any order.  If the slave side closes out
1652          * first, its count will be one, since the master side holds an open.
1653          * Thus this test wouldn't be triggered at the time the slave closed,
1654          * so we do it now.
1655          */
1656         while (1) {
1657                 do_sleep = 0;
1658
1659                 if (tty->count <= 1) {
1660                         if (waitqueue_active(&tty->read_wait)) {
1661                                 wake_up_poll(&tty->read_wait, POLLIN);
1662                                 do_sleep++;
1663                         }
1664                         if (waitqueue_active(&tty->write_wait)) {
1665                                 wake_up_poll(&tty->write_wait, POLLOUT);
1666                                 do_sleep++;
1667                         }
1668                 }
1669                 if (o_tty && o_tty->count <= 1) {
1670                         if (waitqueue_active(&o_tty->read_wait)) {
1671                                 wake_up_poll(&o_tty->read_wait, POLLIN);
1672                                 do_sleep++;
1673                         }
1674                         if (waitqueue_active(&o_tty->write_wait)) {
1675                                 wake_up_poll(&o_tty->write_wait, POLLOUT);
1676                                 do_sleep++;
1677                         }
1678                 }
1679                 if (!do_sleep)
1680                         break;
1681
1682                 if (once) {
1683                         once = 0;
1684                         tty_warn(tty, "read/write wait queue active!\n");
1685                 }
1686                 schedule_timeout_killable(timeout);
1687                 if (timeout < 120 * HZ)
1688                         timeout = 2 * timeout + 1;
1689                 else
1690                         timeout = MAX_SCHEDULE_TIMEOUT;
1691         }
1692
1693         if (o_tty) {
1694                 if (--o_tty->count < 0) {
1695                         tty_warn(tty, "bad slave count (%d)\n", o_tty->count);
1696                         o_tty->count = 0;
1697                 }
1698         }
1699         if (--tty->count < 0) {
1700                 tty_warn(tty, "bad tty->count (%d)\n", tty->count);
1701                 tty->count = 0;
1702         }
1703
1704         /*
1705          * We've decremented tty->count, so we need to remove this file
1706          * descriptor off the tty->tty_files list; this serves two
1707          * purposes:
1708          *  - check_tty_count sees the correct number of file descriptors
1709          *    associated with this tty.
1710          *  - do_tty_hangup no longer sees this file descriptor as
1711          *    something that needs to be handled for hangups.
1712          */
1713         tty_del_file(filp);
1714
1715         /*
1716          * Perform some housekeeping before deciding whether to return.
1717          *
1718          * If _either_ side is closing, make sure there aren't any
1719          * processes that still think tty or o_tty is their controlling
1720          * tty.
1721          */
1722         if (!tty->count) {
1723                 read_lock(&tasklist_lock);
1724                 session_clear_tty(tty->session);
1725                 if (o_tty)
1726                         session_clear_tty(o_tty->session);
1727                 read_unlock(&tasklist_lock);
1728         }
1729
1730         /* check whether both sides are closing ... */
1731         final = !tty->count && !(o_tty && o_tty->count);
1732
1733         tty_unlock_slave(o_tty);
1734         tty_unlock(tty);
1735
1736         /* At this point, the tty->count == 0 should ensure a dead tty
1737            cannot be re-opened by a racing opener */
1738
1739         if (!final)
1740                 return 0;
1741
1742         tty_debug_hangup(tty, "final close\n");
1743
1744         tty_release_struct(tty, idx);
1745         return 0;
1746 }
1747
1748 /**
1749  *      tty_open_current_tty - get locked tty of current task
1750  *      @device: device number
1751  *      @filp: file pointer to tty
1752  *      @return: locked tty of the current task iff @device is /dev/tty
1753  *
1754  *      Performs a re-open of the current task's controlling tty.
1755  *
1756  *      We cannot return driver and index like for the other nodes because
1757  *      devpts will not work then. It expects inodes to be from devpts FS.
1758  */
1759 static struct tty_struct *tty_open_current_tty(dev_t device, struct file *filp)
1760 {
1761         struct tty_struct *tty;
1762         int retval;
1763
1764         if (device != MKDEV(TTYAUX_MAJOR, 0))
1765                 return NULL;
1766
1767         tty = get_current_tty();
1768         if (!tty)
1769                 return ERR_PTR(-ENXIO);
1770
1771         filp->f_flags |= O_NONBLOCK; /* Don't let /dev/tty block */
1772         /* noctty = 1; */
1773         tty_lock(tty);
1774         tty_kref_put(tty);      /* safe to drop the kref now */
1775
1776         retval = tty_reopen(tty);
1777         if (retval < 0) {
1778                 tty_unlock(tty);
1779                 tty = ERR_PTR(retval);
1780         }
1781         return tty;
1782 }
1783
1784 /**
1785  *      tty_lookup_driver - lookup a tty driver for a given device file
1786  *      @device: device number
1787  *      @filp: file pointer to tty
1788  *      @index: index for the device in the @return driver
1789  *      @return: driver for this inode (with increased refcount)
1790  *
1791  *      If @return is not erroneous, the caller is responsible to decrement the
1792  *      refcount by tty_driver_kref_put.
1793  *
1794  *      Locking: tty_mutex protects get_tty_driver
1795  */
1796 static struct tty_driver *tty_lookup_driver(dev_t device, struct file *filp,
1797                 int *index)
1798 {
1799         struct tty_driver *driver;
1800
1801         switch (device) {
1802 #ifdef CONFIG_VT
1803         case MKDEV(TTY_MAJOR, 0): {
1804                 extern struct tty_driver *console_driver;
1805                 driver = tty_driver_kref_get(console_driver);
1806                 *index = fg_console;
1807                 break;
1808         }
1809 #endif
1810         case MKDEV(TTYAUX_MAJOR, 1): {
1811                 struct tty_driver *console_driver = console_device(index);
1812                 if (console_driver) {
1813                         driver = tty_driver_kref_get(console_driver);
1814                         if (driver && filp) {
1815                                 /* Don't let /dev/console block */
1816                                 filp->f_flags |= O_NONBLOCK;
1817                                 break;
1818                         }
1819                 }
1820                 return ERR_PTR(-ENODEV);
1821         }
1822         default:
1823                 driver = get_tty_driver(device, index);
1824                 if (!driver)
1825                         return ERR_PTR(-ENODEV);
1826                 break;
1827         }
1828         return driver;
1829 }
1830
1831 /**
1832  *      tty_kopen       -       open a tty device for kernel
1833  *      @device: dev_t of device to open
1834  *
1835  *      Opens tty exclusively for kernel. Performs the driver lookup,
1836  *      makes sure it's not already opened and performs the first-time
1837  *      tty initialization.
1838  *
1839  *      Returns the locked initialized &tty_struct
1840  *
1841  *      Claims the global tty_mutex to serialize:
1842  *        - concurrent first-time tty initialization
1843  *        - concurrent tty driver removal w/ lookup
1844  *        - concurrent tty removal from driver table
1845  */
1846 struct tty_struct *tty_kopen(dev_t device)
1847 {
1848         struct tty_struct *tty;
1849         struct tty_driver *driver = NULL;
1850         int index = -1;
1851
1852         mutex_lock(&tty_mutex);
1853         driver = tty_lookup_driver(device, NULL, &index);
1854         if (IS_ERR(driver)) {
1855                 mutex_unlock(&tty_mutex);
1856                 return ERR_CAST(driver);
1857         }
1858
1859         /* check whether we're reopening an existing tty */
1860         tty = tty_driver_lookup_tty(driver, NULL, index);
1861         if (IS_ERR(tty))
1862                 goto out;
1863
1864         if (tty) {
1865                 /* drop kref from tty_driver_lookup_tty() */
1866                 tty_kref_put(tty);
1867                 tty = ERR_PTR(-EBUSY);
1868         } else { /* tty_init_dev returns tty with the tty_lock held */
1869                 tty = tty_init_dev(driver, index);
1870                 if (IS_ERR(tty))
1871                         goto out;
1872                 tty_port_set_kopened(tty->port, 1);
1873         }
1874 out:
1875         mutex_unlock(&tty_mutex);
1876         tty_driver_kref_put(driver);
1877         return tty;
1878 }
1879 EXPORT_SYMBOL_GPL(tty_kopen);
1880
1881 /**
1882  *      tty_open_by_driver      -       open a tty device
1883  *      @device: dev_t of device to open
1884  *      @inode: inode of device file
1885  *      @filp: file pointer to tty
1886  *
1887  *      Performs the driver lookup, checks for a reopen, or otherwise
1888  *      performs the first-time tty initialization.
1889  *
1890  *      Returns the locked initialized or re-opened &tty_struct
1891  *
1892  *      Claims the global tty_mutex to serialize:
1893  *        - concurrent first-time tty initialization
1894  *        - concurrent tty driver removal w/ lookup
1895  *        - concurrent tty removal from driver table
1896  */
1897 static struct tty_struct *tty_open_by_driver(dev_t device, struct inode *inode,
1898                                              struct file *filp)
1899 {
1900         struct tty_struct *tty;
1901         struct tty_driver *driver = NULL;
1902         int index = -1;
1903         int retval;
1904
1905         mutex_lock(&tty_mutex);
1906         driver = tty_lookup_driver(device, filp, &index);
1907         if (IS_ERR(driver)) {
1908                 mutex_unlock(&tty_mutex);
1909                 return ERR_CAST(driver);
1910         }
1911
1912         /* check whether we're reopening an existing tty */
1913         tty = tty_driver_lookup_tty(driver, filp, index);
1914         if (IS_ERR(tty)) {
1915                 mutex_unlock(&tty_mutex);
1916                 goto out;
1917         }
1918
1919         if (tty) {
1920                 if (tty_port_kopened(tty->port)) {
1921                         tty_kref_put(tty);
1922                         mutex_unlock(&tty_mutex);
1923                         tty = ERR_PTR(-EBUSY);
1924                         goto out;
1925                 }
1926                 mutex_unlock(&tty_mutex);
1927                 retval = tty_lock_interruptible(tty);
1928                 tty_kref_put(tty);  /* drop kref from tty_driver_lookup_tty() */
1929                 if (retval) {
1930                         if (retval == -EINTR)
1931                                 retval = -ERESTARTSYS;
1932                         tty = ERR_PTR(retval);
1933                         goto out;
1934                 }
1935                 retval = tty_reopen(tty);
1936                 if (retval < 0) {
1937                         tty_unlock(tty);
1938                         tty = ERR_PTR(retval);
1939                 }
1940         } else { /* Returns with the tty_lock held for now */
1941                 tty = tty_init_dev(driver, index);
1942                 mutex_unlock(&tty_mutex);
1943         }
1944 out:
1945         tty_driver_kref_put(driver);
1946         return tty;
1947 }
1948
1949 /**
1950  *      tty_open                -       open a tty device
1951  *      @inode: inode of device file
1952  *      @filp: file pointer to tty
1953  *
1954  *      tty_open and tty_release keep up the tty count that contains the
1955  *      number of opens done on a tty. We cannot use the inode-count, as
1956  *      different inodes might point to the same tty.
1957  *
1958  *      Open-counting is needed for pty masters, as well as for keeping
1959  *      track of serial lines: DTR is dropped when the last close happens.
1960  *      (This is not done solely through tty->count, now.  - Ted 1/27/92)
1961  *
1962  *      The termios state of a pty is reset on first open so that
1963  *      settings don't persist across reuse.
1964  *
1965  *      Locking: tty_mutex protects tty, tty_lookup_driver and tty_init_dev.
1966  *               tty->count should protect the rest.
1967  *               ->siglock protects ->signal/->sighand
1968  *
1969  *      Note: the tty_unlock/lock cases without a ref are only safe due to
1970  *      tty_mutex
1971  */
1972
1973 static int tty_open(struct inode *inode, struct file *filp)
1974 {
1975         struct tty_struct *tty;
1976         int noctty, retval;
1977         dev_t device = inode->i_rdev;
1978         unsigned saved_flags = filp->f_flags;
1979
1980         nonseekable_open(inode, filp);
1981
1982 retry_open:
1983         retval = tty_alloc_file(filp);
1984         if (retval)
1985                 return -ENOMEM;
1986
1987         tty = tty_open_current_tty(device, filp);
1988         if (!tty)
1989                 tty = tty_open_by_driver(device, inode, filp);
1990
1991         if (IS_ERR(tty)) {
1992                 tty_free_file(filp);
1993                 retval = PTR_ERR(tty);
1994                 if (retval != -EAGAIN || signal_pending(current))
1995                         return retval;
1996                 schedule();
1997                 goto retry_open;
1998         }
1999
2000         tty_add_file(tty, filp);
2001
2002         check_tty_count(tty, __func__);
2003         tty_debug_hangup(tty, "opening (count=%d)\n", tty->count);
2004
2005         if (tty->ops->open)
2006                 retval = tty->ops->open(tty, filp);
2007         else
2008                 retval = -ENODEV;
2009         filp->f_flags = saved_flags;
2010
2011         if (retval) {
2012                 tty_debug_hangup(tty, "open error %d, releasing\n", retval);
2013
2014                 tty_unlock(tty); /* need to call tty_release without BTM */
2015                 tty_release(inode, filp);
2016                 if (retval != -ERESTARTSYS)
2017                         return retval;
2018
2019                 if (signal_pending(current))
2020                         return retval;
2021
2022                 schedule();
2023                 /*
2024                  * Need to reset f_op in case a hangup happened.
2025                  */
2026                 if (tty_hung_up_p(filp))
2027                         filp->f_op = &tty_fops;
2028                 goto retry_open;
2029         }
2030         clear_bit(TTY_HUPPED, &tty->flags);
2031
2032         noctty = (filp->f_flags & O_NOCTTY) ||
2033                  (IS_ENABLED(CONFIG_VT) && device == MKDEV(TTY_MAJOR, 0)) ||
2034                  device == MKDEV(TTYAUX_MAJOR, 1) ||
2035                  (tty->driver->type == TTY_DRIVER_TYPE_PTY &&
2036                   tty->driver->subtype == PTY_TYPE_MASTER);
2037         if (!noctty)
2038                 tty_open_proc_set_tty(filp, tty);
2039         tty_unlock(tty);
2040         return 0;
2041 }
2042
2043
2044
2045 /**
2046  *      tty_poll        -       check tty status
2047  *      @filp: file being polled
2048  *      @wait: poll wait structures to update
2049  *
2050  *      Call the line discipline polling method to obtain the poll
2051  *      status of the device.
2052  *
2053  *      Locking: locks called line discipline but ldisc poll method
2054  *      may be re-entered freely by other callers.
2055  */
2056
2057 static unsigned int tty_poll(struct file *filp, poll_table *wait)
2058 {
2059         struct tty_struct *tty = file_tty(filp);
2060         struct tty_ldisc *ld;
2061         int ret = 0;
2062
2063         if (tty_paranoia_check(tty, file_inode(filp), "tty_poll"))
2064                 return 0;
2065
2066         ld = tty_ldisc_ref_wait(tty);
2067         if (!ld)
2068                 return hung_up_tty_poll(filp, wait);
2069         if (ld->ops->poll)
2070                 ret = ld->ops->poll(tty, filp, wait);
2071         tty_ldisc_deref(ld);
2072         return ret;
2073 }
2074
2075 static int __tty_fasync(int fd, struct file *filp, int on)
2076 {
2077         struct tty_struct *tty = file_tty(filp);
2078         unsigned long flags;
2079         int retval = 0;
2080
2081         if (tty_paranoia_check(tty, file_inode(filp), "tty_fasync"))
2082                 goto out;
2083
2084         retval = fasync_helper(fd, filp, on, &tty->fasync);
2085         if (retval <= 0)
2086                 goto out;
2087
2088         if (on) {
2089                 enum pid_type type;
2090                 struct pid *pid;
2091
2092                 spin_lock_irqsave(&tty->ctrl_lock, flags);
2093                 if (tty->pgrp) {
2094                         pid = tty->pgrp;
2095                         type = PIDTYPE_PGID;
2096                 } else {
2097                         pid = task_pid(current);
2098                         type = PIDTYPE_PID;
2099                 }
2100                 get_pid(pid);
2101                 spin_unlock_irqrestore(&tty->ctrl_lock, flags);
2102                 __f_setown(filp, pid, type, 0);
2103                 put_pid(pid);
2104                 retval = 0;
2105         }
2106 out:
2107         return retval;
2108 }
2109
2110 static int tty_fasync(int fd, struct file *filp, int on)
2111 {
2112         struct tty_struct *tty = file_tty(filp);
2113         int retval = -ENOTTY;
2114
2115         tty_lock(tty);
2116         if (!tty_hung_up_p(filp))
2117                 retval = __tty_fasync(fd, filp, on);
2118         tty_unlock(tty);
2119
2120         return retval;
2121 }
2122
2123 /**
2124  *      tiocsti                 -       fake input character
2125  *      @tty: tty to fake input into
2126  *      @p: pointer to character
2127  *
2128  *      Fake input to a tty device. Does the necessary locking and
2129  *      input management.
2130  *
2131  *      FIXME: does not honour flow control ??
2132  *
2133  *      Locking:
2134  *              Called functions take tty_ldiscs_lock
2135  *              current->signal->tty check is safe without locks
2136  *
2137  *      FIXME: may race normal receive processing
2138  */
2139
2140 static int tiocsti(struct tty_struct *tty, char __user *p)
2141 {
2142         char ch, mbz = 0;
2143         struct tty_ldisc *ld;
2144
2145         if ((current->signal->tty != tty) && !capable(CAP_SYS_ADMIN))
2146                 return -EPERM;
2147         if (get_user(ch, p))
2148                 return -EFAULT;
2149         tty_audit_tiocsti(tty, ch);
2150         ld = tty_ldisc_ref_wait(tty);
2151         if (!ld)
2152                 return -EIO;
2153         ld->ops->receive_buf(tty, &ch, &mbz, 1);
2154         tty_ldisc_deref(ld);
2155         return 0;
2156 }
2157
2158 /**
2159  *      tiocgwinsz              -       implement window query ioctl
2160  *      @tty; tty
2161  *      @arg: user buffer for result
2162  *
2163  *      Copies the kernel idea of the window size into the user buffer.
2164  *
2165  *      Locking: tty->winsize_mutex is taken to ensure the winsize data
2166  *              is consistent.
2167  */
2168
2169 static int tiocgwinsz(struct tty_struct *tty, struct winsize __user *arg)
2170 {
2171         int err;
2172
2173         mutex_lock(&tty->winsize_mutex);
2174         err = copy_to_user(arg, &tty->winsize, sizeof(*arg));
2175         mutex_unlock(&tty->winsize_mutex);
2176
2177         return err ? -EFAULT: 0;
2178 }
2179
2180 /**
2181  *      tty_do_resize           -       resize event
2182  *      @tty: tty being resized
2183  *      @rows: rows (character)
2184  *      @cols: cols (character)
2185  *
2186  *      Update the termios variables and send the necessary signals to
2187  *      peform a terminal resize correctly
2188  */
2189
2190 int tty_do_resize(struct tty_struct *tty, struct winsize *ws)
2191 {
2192         struct pid *pgrp;
2193
2194         /* Lock the tty */
2195         mutex_lock(&tty->winsize_mutex);
2196         if (!memcmp(ws, &tty->winsize, sizeof(*ws)))
2197                 goto done;
2198
2199         /* Signal the foreground process group */
2200         pgrp = tty_get_pgrp(tty);
2201         if (pgrp)
2202                 kill_pgrp(pgrp, SIGWINCH, 1);
2203         put_pid(pgrp);
2204
2205         tty->winsize = *ws;
2206 done:
2207         mutex_unlock(&tty->winsize_mutex);
2208         return 0;
2209 }
2210 EXPORT_SYMBOL(tty_do_resize);
2211
2212 /**
2213  *      tiocswinsz              -       implement window size set ioctl
2214  *      @tty; tty side of tty
2215  *      @arg: user buffer for result
2216  *
2217  *      Copies the user idea of the window size to the kernel. Traditionally
2218  *      this is just advisory information but for the Linux console it
2219  *      actually has driver level meaning and triggers a VC resize.
2220  *
2221  *      Locking:
2222  *              Driver dependent. The default do_resize method takes the
2223  *      tty termios mutex and ctrl_lock. The console takes its own lock
2224  *      then calls into the default method.
2225  */
2226
2227 static int tiocswinsz(struct tty_struct *tty, struct winsize __user *arg)
2228 {
2229         struct winsize tmp_ws;
2230         if (copy_from_user(&tmp_ws, arg, sizeof(*arg)))
2231                 return -EFAULT;
2232
2233         if (tty->ops->resize)
2234                 return tty->ops->resize(tty, &tmp_ws);
2235         else
2236                 return tty_do_resize(tty, &tmp_ws);
2237 }
2238
2239 /**
2240  *      tioccons        -       allow admin to move logical console
2241  *      @file: the file to become console
2242  *
2243  *      Allow the administrator to move the redirected console device
2244  *
2245  *      Locking: uses redirect_lock to guard the redirect information
2246  */
2247
2248 static int tioccons(struct file *file)
2249 {
2250         if (!capable(CAP_SYS_ADMIN))
2251                 return -EPERM;
2252         if (file->f_op->write == redirected_tty_write) {
2253                 struct file *f;
2254                 spin_lock(&redirect_lock);
2255                 f = redirect;
2256                 redirect = NULL;
2257                 spin_unlock(&redirect_lock);
2258                 if (f)
2259                         fput(f);
2260                 return 0;
2261         }
2262         spin_lock(&redirect_lock);
2263         if (redirect) {
2264                 spin_unlock(&redirect_lock);
2265                 return -EBUSY;
2266         }
2267         redirect = get_file(file);
2268         spin_unlock(&redirect_lock);
2269         return 0;
2270 }
2271
2272 /**
2273  *      fionbio         -       non blocking ioctl
2274  *      @file: file to set blocking value
2275  *      @p: user parameter
2276  *
2277  *      Historical tty interfaces had a blocking control ioctl before
2278  *      the generic functionality existed. This piece of history is preserved
2279  *      in the expected tty API of posix OS's.
2280  *
2281  *      Locking: none, the open file handle ensures it won't go away.
2282  */
2283
2284 static int fionbio(struct file *file, int __user *p)
2285 {
2286         int nonblock;
2287
2288         if (get_user(nonblock, p))
2289                 return -EFAULT;
2290
2291         spin_lock(&file->f_lock);
2292         if (nonblock)
2293                 file->f_flags |= O_NONBLOCK;
2294         else
2295                 file->f_flags &= ~O_NONBLOCK;
2296         spin_unlock(&file->f_lock);
2297         return 0;
2298 }
2299
2300 /**
2301  *      tiocsetd        -       set line discipline
2302  *      @tty: tty device
2303  *      @p: pointer to user data
2304  *
2305  *      Set the line discipline according to user request.
2306  *
2307  *      Locking: see tty_set_ldisc, this function is just a helper
2308  */
2309
2310 static int tiocsetd(struct tty_struct *tty, int __user *p)
2311 {
2312         int disc;
2313         int ret;
2314
2315         if (get_user(disc, p))
2316                 return -EFAULT;
2317
2318         ret = tty_set_ldisc(tty, disc);
2319
2320         return ret;
2321 }
2322
2323 /**
2324  *      tiocgetd        -       get line discipline
2325  *      @tty: tty device
2326  *      @p: pointer to user data
2327  *
2328  *      Retrieves the line discipline id directly from the ldisc.
2329  *
2330  *      Locking: waits for ldisc reference (in case the line discipline
2331  *              is changing or the tty is being hungup)
2332  */
2333
2334 static int tiocgetd(struct tty_struct *tty, int __user *p)
2335 {
2336         struct tty_ldisc *ld;
2337         int ret;
2338
2339         ld = tty_ldisc_ref_wait(tty);
2340         if (!ld)
2341                 return -EIO;
2342         ret = put_user(ld->ops->num, p);
2343         tty_ldisc_deref(ld);
2344         return ret;
2345 }
2346
2347 /**
2348  *      send_break      -       performed time break
2349  *      @tty: device to break on
2350  *      @duration: timeout in mS
2351  *
2352  *      Perform a timed break on hardware that lacks its own driver level
2353  *      timed break functionality.
2354  *
2355  *      Locking:
2356  *              atomic_write_lock serializes
2357  *
2358  */
2359
2360 static int send_break(struct tty_struct *tty, unsigned int duration)
2361 {
2362         int retval;
2363
2364         if (tty->ops->break_ctl == NULL)
2365                 return 0;
2366
2367         if (tty->driver->flags & TTY_DRIVER_HARDWARE_BREAK)
2368                 retval = tty->ops->break_ctl(tty, duration);
2369         else {
2370                 /* Do the work ourselves */
2371                 if (tty_write_lock(tty, 0) < 0)
2372                         return -EINTR;
2373                 retval = tty->ops->break_ctl(tty, -1);
2374                 if (retval)
2375                         goto out;
2376                 if (!signal_pending(current))
2377                         msleep_interruptible(duration);
2378                 retval = tty->ops->break_ctl(tty, 0);
2379 out:
2380                 tty_write_unlock(tty);
2381                 if (signal_pending(current))
2382                         retval = -EINTR;
2383         }
2384         return retval;
2385 }
2386
2387 /**
2388  *      tty_tiocmget            -       get modem status
2389  *      @tty: tty device
2390  *      @file: user file pointer
2391  *      @p: pointer to result
2392  *
2393  *      Obtain the modem status bits from the tty driver if the feature
2394  *      is supported. Return -EINVAL if it is not available.
2395  *
2396  *      Locking: none (up to the driver)
2397  */
2398
2399 static int tty_tiocmget(struct tty_struct *tty, int __user *p)
2400 {
2401         int retval = -EINVAL;
2402
2403         if (tty->ops->tiocmget) {
2404                 retval = tty->ops->tiocmget(tty);
2405
2406                 if (retval >= 0)
2407                         retval = put_user(retval, p);
2408         }
2409         return retval;
2410 }
2411
2412 /**
2413  *      tty_tiocmset            -       set modem status
2414  *      @tty: tty device
2415  *      @cmd: command - clear bits, set bits or set all
2416  *      @p: pointer to desired bits
2417  *
2418  *      Set the modem status bits from the tty driver if the feature
2419  *      is supported. Return -EINVAL if it is not available.
2420  *
2421  *      Locking: none (up to the driver)
2422  */
2423
2424 static int tty_tiocmset(struct tty_struct *tty, unsigned int cmd,
2425              unsigned __user *p)
2426 {
2427         int retval;
2428         unsigned int set, clear, val;
2429
2430         if (tty->ops->tiocmset == NULL)
2431                 return -EINVAL;
2432
2433         retval = get_user(val, p);
2434         if (retval)
2435                 return retval;
2436         set = clear = 0;
2437         switch (cmd) {
2438         case TIOCMBIS:
2439                 set = val;
2440                 break;
2441         case TIOCMBIC:
2442                 clear = val;
2443                 break;
2444         case TIOCMSET:
2445                 set = val;
2446                 clear = ~val;
2447                 break;
2448         }
2449         set &= TIOCM_DTR|TIOCM_RTS|TIOCM_OUT1|TIOCM_OUT2|TIOCM_LOOP;
2450         clear &= TIOCM_DTR|TIOCM_RTS|TIOCM_OUT1|TIOCM_OUT2|TIOCM_LOOP;
2451         return tty->ops->tiocmset(tty, set, clear);
2452 }
2453
2454 static int tty_tiocgicount(struct tty_struct *tty, void __user *arg)
2455 {
2456         int retval = -EINVAL;
2457         struct serial_icounter_struct icount;
2458         memset(&icount, 0, sizeof(icount));
2459         if (tty->ops->get_icount)
2460                 retval = tty->ops->get_icount(tty, &icount);
2461         if (retval != 0)
2462                 return retval;
2463         if (copy_to_user(arg, &icount, sizeof(icount)))
2464                 return -EFAULT;
2465         return 0;
2466 }
2467
2468 static void tty_warn_deprecated_flags(struct serial_struct __user *ss)
2469 {
2470         static DEFINE_RATELIMIT_STATE(depr_flags,
2471                         DEFAULT_RATELIMIT_INTERVAL,
2472                         DEFAULT_RATELIMIT_BURST);
2473         char comm[TASK_COMM_LEN];
2474         int flags;
2475
2476         if (get_user(flags, &ss->flags))
2477                 return;
2478
2479         flags &= ASYNC_DEPRECATED;
2480
2481         if (flags && __ratelimit(&depr_flags))
2482                 pr_warn("%s: '%s' is using deprecated serial flags (with no effect): %.8x\n",
2483                         __func__, get_task_comm(comm, current), flags);
2484 }
2485
2486 /*
2487  * if pty, return the slave side (real_tty)
2488  * otherwise, return self
2489  */
2490 static struct tty_struct *tty_pair_get_tty(struct tty_struct *tty)
2491 {
2492         if (tty->driver->type == TTY_DRIVER_TYPE_PTY &&
2493             tty->driver->subtype == PTY_TYPE_MASTER)
2494                 tty = tty->link;
2495         return tty;
2496 }
2497
2498 /*
2499  * Split this up, as gcc can choke on it otherwise..
2500  */
2501 long tty_ioctl(struct file *file, unsigned int cmd, unsigned long arg)
2502 {
2503         struct tty_struct *tty = file_tty(file);
2504         struct tty_struct *real_tty;
2505         void __user *p = (void __user *)arg;
2506         int retval;
2507         struct tty_ldisc *ld;
2508
2509         if (tty_paranoia_check(tty, file_inode(file), "tty_ioctl"))
2510                 return -EINVAL;
2511
2512         real_tty = tty_pair_get_tty(tty);
2513
2514         /*
2515          * Factor out some common prep work
2516          */
2517         switch (cmd) {
2518         case TIOCSETD:
2519         case TIOCSBRK:
2520         case TIOCCBRK:
2521         case TCSBRK:
2522         case TCSBRKP:
2523                 retval = tty_check_change(tty);
2524                 if (retval)
2525                         return retval;
2526                 if (cmd != TIOCCBRK) {
2527                         tty_wait_until_sent(tty, 0);
2528                         if (signal_pending(current))
2529                                 return -EINTR;
2530                 }
2531                 break;
2532         }
2533
2534         /*
2535          *      Now do the stuff.
2536          */
2537         switch (cmd) {
2538         case TIOCSTI:
2539                 return tiocsti(tty, p);
2540         case TIOCGWINSZ:
2541                 return tiocgwinsz(real_tty, p);
2542         case TIOCSWINSZ:
2543                 return tiocswinsz(real_tty, p);
2544         case TIOCCONS:
2545                 return real_tty != tty ? -EINVAL : tioccons(file);
2546         case FIONBIO:
2547                 return fionbio(file, p);
2548         case TIOCEXCL:
2549                 set_bit(TTY_EXCLUSIVE, &tty->flags);
2550                 return 0;
2551         case TIOCNXCL:
2552                 clear_bit(TTY_EXCLUSIVE, &tty->flags);
2553                 return 0;
2554         case TIOCGEXCL:
2555         {
2556                 int excl = test_bit(TTY_EXCLUSIVE, &tty->flags);
2557                 return put_user(excl, (int __user *)p);
2558         }
2559         case TIOCGETD:
2560                 return tiocgetd(tty, p);
2561         case TIOCSETD:
2562                 return tiocsetd(tty, p);
2563         case TIOCVHANGUP:
2564                 if (!capable(CAP_SYS_ADMIN))
2565                         return -EPERM;
2566                 tty_vhangup(tty);
2567                 return 0;
2568         case TIOCGDEV:
2569         {
2570                 unsigned int ret = new_encode_dev(tty_devnum(real_tty));
2571                 return put_user(ret, (unsigned int __user *)p);
2572         }
2573         /*
2574          * Break handling
2575          */
2576         case TIOCSBRK:  /* Turn break on, unconditionally */
2577                 if (tty->ops->break_ctl)
2578                         return tty->ops->break_ctl(tty, -1);
2579                 return 0;
2580         case TIOCCBRK:  /* Turn break off, unconditionally */
2581                 if (tty->ops->break_ctl)
2582                         return tty->ops->break_ctl(tty, 0);
2583                 return 0;
2584         case TCSBRK:   /* SVID version: non-zero arg --> no break */
2585                 /* non-zero arg means wait for all output data
2586                  * to be sent (performed above) but don't send break.
2587                  * This is used by the tcdrain() termios function.
2588                  */
2589                 if (!arg)
2590                         return send_break(tty, 250);
2591                 return 0;
2592         case TCSBRKP:   /* support for POSIX tcsendbreak() */
2593                 return send_break(tty, arg ? arg*100 : 250);
2594
2595         case TIOCMGET:
2596                 return tty_tiocmget(tty, p);
2597         case TIOCMSET:
2598         case TIOCMBIC:
2599         case TIOCMBIS:
2600                 return tty_tiocmset(tty, cmd, p);
2601         case TIOCGICOUNT:
2602                 retval = tty_tiocgicount(tty, p);
2603                 /* For the moment allow fall through to the old method */
2604                 if (retval != -EINVAL)
2605                         return retval;
2606                 break;
2607         case TCFLSH:
2608                 switch (arg) {
2609                 case TCIFLUSH:
2610                 case TCIOFLUSH:
2611                 /* flush tty buffer and allow ldisc to process ioctl */
2612                         tty_buffer_flush(tty, NULL);
2613                         break;
2614                 }
2615                 break;
2616         case TIOCSSERIAL:
2617                 tty_warn_deprecated_flags(p);
2618                 break;
2619         case TIOCGPTPEER:
2620                 /* Special because the struct file is needed */
2621                 return ptm_open_peer(file, tty, (int)arg);
2622         default:
2623                 retval = tty_jobctrl_ioctl(tty, real_tty, file, cmd, arg);
2624                 if (retval != -ENOIOCTLCMD)
2625                         return retval;
2626         }
2627         if (tty->ops->ioctl) {
2628                 retval = tty->ops->ioctl(tty, cmd, arg);
2629                 if (retval != -ENOIOCTLCMD)
2630                         return retval;
2631         }
2632         ld = tty_ldisc_ref_wait(tty);
2633         if (!ld)
2634                 return hung_up_tty_ioctl(file, cmd, arg);
2635         retval = -EINVAL;
2636         if (ld->ops->ioctl) {
2637                 retval = ld->ops->ioctl(tty, file, cmd, arg);
2638                 if (retval == -ENOIOCTLCMD)
2639                         retval = -ENOTTY;
2640         }
2641         tty_ldisc_deref(ld);
2642         return retval;
2643 }
2644
2645 #ifdef CONFIG_COMPAT
2646 static long tty_compat_ioctl(struct file *file, unsigned int cmd,
2647                                 unsigned long arg)
2648 {
2649         struct tty_struct *tty = file_tty(file);
2650         struct tty_ldisc *ld;
2651         int retval = -ENOIOCTLCMD;
2652
2653         if (tty_paranoia_check(tty, file_inode(file), "tty_ioctl"))
2654                 return -EINVAL;
2655
2656         if (tty->ops->compat_ioctl) {
2657                 retval = tty->ops->compat_ioctl(tty, cmd, arg);
2658                 if (retval != -ENOIOCTLCMD)
2659                         return retval;
2660         }
2661
2662         ld = tty_ldisc_ref_wait(tty);
2663         if (!ld)
2664                 return hung_up_tty_compat_ioctl(file, cmd, arg);
2665         if (ld->ops->compat_ioctl)
2666                 retval = ld->ops->compat_ioctl(tty, file, cmd, arg);
2667         else
2668                 retval = n_tty_compat_ioctl_helper(tty, file, cmd, arg);
2669         tty_ldisc_deref(ld);
2670
2671         return retval;
2672 }
2673 #endif
2674
2675 static int this_tty(const void *t, struct file *file, unsigned fd)
2676 {
2677         if (likely(file->f_op->read != tty_read))
2678                 return 0;
2679         return file_tty(file) != t ? 0 : fd + 1;
2680 }
2681         
2682 /*
2683  * This implements the "Secure Attention Key" ---  the idea is to
2684  * prevent trojan horses by killing all processes associated with this
2685  * tty when the user hits the "Secure Attention Key".  Required for
2686  * super-paranoid applications --- see the Orange Book for more details.
2687  *
2688  * This code could be nicer; ideally it should send a HUP, wait a few
2689  * seconds, then send a INT, and then a KILL signal.  But you then
2690  * have to coordinate with the init process, since all processes associated
2691  * with the current tty must be dead before the new getty is allowed
2692  * to spawn.
2693  *
2694  * Now, if it would be correct ;-/ The current code has a nasty hole -
2695  * it doesn't catch files in flight. We may send the descriptor to ourselves
2696  * via AF_UNIX socket, close it and later fetch from socket. FIXME.
2697  *
2698  * Nasty bug: do_SAK is being called in interrupt context.  This can
2699  * deadlock.  We punt it up to process context.  AKPM - 16Mar2001
2700  */
2701 void __do_SAK(struct tty_struct *tty)
2702 {
2703 #ifdef TTY_SOFT_SAK
2704         tty_hangup(tty);
2705 #else
2706         struct task_struct *g, *p;
2707         struct pid *session;
2708         int             i;
2709
2710         if (!tty)
2711                 return;
2712         session = tty->session;
2713
2714         tty_ldisc_flush(tty);
2715
2716         tty_driver_flush_buffer(tty);
2717
2718         read_lock(&tasklist_lock);
2719         /* Kill the entire session */
2720         do_each_pid_task(session, PIDTYPE_SID, p) {
2721                 tty_notice(tty, "SAK: killed process %d (%s): by session\n",
2722                            task_pid_nr(p), p->comm);
2723                 send_sig(SIGKILL, p, 1);
2724         } while_each_pid_task(session, PIDTYPE_SID, p);
2725
2726         /* Now kill any processes that happen to have the tty open */
2727         do_each_thread(g, p) {
2728                 if (p->signal->tty == tty) {
2729                         tty_notice(tty, "SAK: killed process %d (%s): by controlling tty\n",
2730                                    task_pid_nr(p), p->comm);
2731                         send_sig(SIGKILL, p, 1);
2732                         continue;
2733                 }
2734                 task_lock(p);
2735                 i = iterate_fd(p->files, 0, this_tty, tty);
2736                 if (i != 0) {
2737                         tty_notice(tty, "SAK: killed process %d (%s): by fd#%d\n",
2738                                    task_pid_nr(p), p->comm, i - 1);
2739                         force_sig(SIGKILL, p);
2740                 }
2741                 task_unlock(p);
2742         } while_each_thread(g, p);
2743         read_unlock(&tasklist_lock);
2744 #endif
2745 }
2746
2747 static void do_SAK_work(struct work_struct *work)
2748 {
2749         struct tty_struct *tty =
2750                 container_of(work, struct tty_struct, SAK_work);
2751         __do_SAK(tty);
2752 }
2753
2754 /*
2755  * The tq handling here is a little racy - tty->SAK_work may already be queued.
2756  * Fortunately we don't need to worry, because if ->SAK_work is already queued,
2757  * the values which we write to it will be identical to the values which it
2758  * already has. --akpm
2759  */
2760 void do_SAK(struct tty_struct *tty)
2761 {
2762         if (!tty)
2763                 return;
2764         schedule_work(&tty->SAK_work);
2765 }
2766
2767 EXPORT_SYMBOL(do_SAK);
2768
2769 static int dev_match_devt(struct device *dev, const void *data)
2770 {
2771         const dev_t *devt = data;
2772         return dev->devt == *devt;
2773 }
2774
2775 /* Must put_device() after it's unused! */
2776 static struct device *tty_get_device(struct tty_struct *tty)
2777 {
2778         dev_t devt = tty_devnum(tty);
2779         return class_find_device(tty_class, NULL, &devt, dev_match_devt);
2780 }
2781
2782
2783 /**
2784  *      alloc_tty_struct
2785  *
2786  *      This subroutine allocates and initializes a tty structure.
2787  *
2788  *      Locking: none - tty in question is not exposed at this point
2789  */
2790
2791 struct tty_struct *alloc_tty_struct(struct tty_driver *driver, int idx)
2792 {
2793         struct tty_struct *tty;
2794
2795         tty = kzalloc(sizeof(*tty), GFP_KERNEL);
2796         if (!tty)
2797                 return NULL;
2798
2799         kref_init(&tty->kref);
2800         tty->magic = TTY_MAGIC;
2801         tty_ldisc_init(tty);
2802         tty->session = NULL;
2803         tty->pgrp = NULL;
2804         mutex_init(&tty->legacy_mutex);
2805         mutex_init(&tty->throttle_mutex);
2806         init_rwsem(&tty->termios_rwsem);
2807         mutex_init(&tty->winsize_mutex);
2808         init_ldsem(&tty->ldisc_sem);
2809         init_waitqueue_head(&tty->write_wait);
2810         init_waitqueue_head(&tty->read_wait);
2811         INIT_WORK(&tty->hangup_work, do_tty_hangup);
2812         mutex_init(&tty->atomic_write_lock);
2813         spin_lock_init(&tty->ctrl_lock);
2814         spin_lock_init(&tty->flow_lock);
2815         spin_lock_init(&tty->files_lock);
2816         INIT_LIST_HEAD(&tty->tty_files);
2817         INIT_WORK(&tty->SAK_work, do_SAK_work);
2818
2819         tty->driver = driver;
2820         tty->ops = driver->ops;
2821         tty->index = idx;
2822         tty_line_name(driver, idx, tty->name);
2823         tty->dev = tty_get_device(tty);
2824
2825         return tty;
2826 }
2827
2828 /**
2829  *      tty_put_char    -       write one character to a tty
2830  *      @tty: tty
2831  *      @ch: character
2832  *
2833  *      Write one byte to the tty using the provided put_char method
2834  *      if present. Returns the number of characters successfully output.
2835  *
2836  *      Note: the specific put_char operation in the driver layer may go
2837  *      away soon. Don't call it directly, use this method
2838  */
2839
2840 int tty_put_char(struct tty_struct *tty, unsigned char ch)
2841 {
2842         if (tty->ops->put_char)
2843                 return tty->ops->put_char(tty, ch);
2844         return tty->ops->write(tty, &ch, 1);
2845 }
2846 EXPORT_SYMBOL_GPL(tty_put_char);
2847
2848 struct class *tty_class;
2849
2850 static int tty_cdev_add(struct tty_driver *driver, dev_t dev,
2851                 unsigned int index, unsigned int count)
2852 {
2853         int err;
2854
2855         /* init here, since reused cdevs cause crashes */
2856         driver->cdevs[index] = cdev_alloc();
2857         if (!driver->cdevs[index])
2858                 return -ENOMEM;
2859         driver->cdevs[index]->ops = &tty_fops;
2860         driver->cdevs[index]->owner = driver->owner;
2861         err = cdev_add(driver->cdevs[index], dev, count);
2862         if (err)
2863                 kobject_put(&driver->cdevs[index]->kobj);
2864         return err;
2865 }
2866
2867 /**
2868  *      tty_register_device - register a tty device
2869  *      @driver: the tty driver that describes the tty device
2870  *      @index: the index in the tty driver for this tty device
2871  *      @device: a struct device that is associated with this tty device.
2872  *              This field is optional, if there is no known struct device
2873  *              for this tty device it can be set to NULL safely.
2874  *
2875  *      Returns a pointer to the struct device for this tty device
2876  *      (or ERR_PTR(-EFOO) on error).
2877  *
2878  *      This call is required to be made to register an individual tty device
2879  *      if the tty driver's flags have the TTY_DRIVER_DYNAMIC_DEV bit set.  If
2880  *      that bit is not set, this function should not be called by a tty
2881  *      driver.
2882  *
2883  *      Locking: ??
2884  */
2885
2886 struct device *tty_register_device(struct tty_driver *driver, unsigned index,
2887                                    struct device *device)
2888 {
2889         return tty_register_device_attr(driver, index, device, NULL, NULL);
2890 }
2891 EXPORT_SYMBOL(tty_register_device);
2892
2893 static void tty_device_create_release(struct device *dev)
2894 {
2895         dev_dbg(dev, "releasing...\n");
2896         kfree(dev);
2897 }
2898
2899 /**
2900  *      tty_register_device_attr - register a tty device
2901  *      @driver: the tty driver that describes the tty device
2902  *      @index: the index in the tty driver for this tty device
2903  *      @device: a struct device that is associated with this tty device.
2904  *              This field is optional, if there is no known struct device
2905  *              for this tty device it can be set to NULL safely.
2906  *      @drvdata: Driver data to be set to device.
2907  *      @attr_grp: Attribute group to be set on device.
2908  *
2909  *      Returns a pointer to the struct device for this tty device
2910  *      (or ERR_PTR(-EFOO) on error).
2911  *
2912  *      This call is required to be made to register an individual tty device
2913  *      if the tty driver's flags have the TTY_DRIVER_DYNAMIC_DEV bit set.  If
2914  *      that bit is not set, this function should not be called by a tty
2915  *      driver.
2916  *
2917  *      Locking: ??
2918  */
2919 struct device *tty_register_device_attr(struct tty_driver *driver,
2920                                    unsigned index, struct device *device,
2921                                    void *drvdata,
2922                                    const struct attribute_group **attr_grp)
2923 {
2924         char name[64];
2925         dev_t devt = MKDEV(driver->major, driver->minor_start) + index;
2926         struct ktermios *tp;
2927         struct device *dev;
2928         int retval;
2929
2930         if (index >= driver->num) {
2931                 pr_err("%s: Attempt to register invalid tty line number (%d)\n",
2932                        driver->name, index);
2933                 return ERR_PTR(-EINVAL);
2934         }
2935
2936         if (driver->type == TTY_DRIVER_TYPE_PTY)
2937                 pty_line_name(driver, index, name);
2938         else
2939                 tty_line_name(driver, index, name);
2940
2941         dev = kzalloc(sizeof(*dev), GFP_KERNEL);
2942         if (!dev)
2943                 return ERR_PTR(-ENOMEM);
2944
2945         dev->devt = devt;
2946         dev->class = tty_class;
2947         dev->parent = device;
2948         dev->release = tty_device_create_release;
2949         dev_set_name(dev, "%s", name);
2950         dev->groups = attr_grp;
2951         dev_set_drvdata(dev, drvdata);
2952
2953         dev_set_uevent_suppress(dev, 1);
2954
2955         retval = device_register(dev);
2956         if (retval)
2957                 goto err_put;
2958
2959         if (!(driver->flags & TTY_DRIVER_DYNAMIC_ALLOC)) {
2960                 /*
2961                  * Free any saved termios data so that the termios state is
2962                  * reset when reusing a minor number.
2963                  */
2964                 tp = driver->termios[index];
2965                 if (tp) {
2966                         driver->termios[index] = NULL;
2967                         kfree(tp);
2968                 }
2969
2970                 retval = tty_cdev_add(driver, devt, index, 1);
2971                 if (retval)
2972                         goto err_del;
2973         }
2974
2975         dev_set_uevent_suppress(dev, 0);
2976         kobject_uevent(&dev->kobj, KOBJ_ADD);
2977
2978         return dev;
2979
2980 err_del:
2981         device_del(dev);
2982 err_put:
2983         put_device(dev);
2984
2985         return ERR_PTR(retval);
2986 }
2987 EXPORT_SYMBOL_GPL(tty_register_device_attr);
2988
2989 /**
2990  *      tty_unregister_device - unregister a tty device
2991  *      @driver: the tty driver that describes the tty device
2992  *      @index: the index in the tty driver for this tty device
2993  *
2994  *      If a tty device is registered with a call to tty_register_device() then
2995  *      this function must be called when the tty device is gone.
2996  *
2997  *      Locking: ??
2998  */
2999
3000 void tty_unregister_device(struct tty_driver *driver, unsigned index)
3001 {
3002         device_destroy(tty_class,
3003                 MKDEV(driver->major, driver->minor_start) + index);
3004         if (!(driver->flags & TTY_DRIVER_DYNAMIC_ALLOC)) {
3005                 cdev_del(driver->cdevs[index]);
3006                 driver->cdevs[index] = NULL;
3007         }
3008 }
3009 EXPORT_SYMBOL(tty_unregister_device);
3010
3011 /**
3012  * __tty_alloc_driver -- allocate tty driver
3013  * @lines: count of lines this driver can handle at most
3014  * @owner: module which is responsible for this driver
3015  * @flags: some of TTY_DRIVER_* flags, will be set in driver->flags
3016  *
3017  * This should not be called directly, some of the provided macros should be
3018  * used instead. Use IS_ERR and friends on @retval.
3019  */
3020 struct tty_driver *__tty_alloc_driver(unsigned int lines, struct module *owner,
3021                 unsigned long flags)
3022 {
3023         struct tty_driver *driver;
3024         unsigned int cdevs = 1;
3025         int err;
3026
3027         if (!lines || (flags & TTY_DRIVER_UNNUMBERED_NODE && lines > 1))
3028                 return ERR_PTR(-EINVAL);
3029
3030         driver = kzalloc(sizeof(struct tty_driver), GFP_KERNEL);
3031         if (!driver)
3032                 return ERR_PTR(-ENOMEM);
3033
3034         kref_init(&driver->kref);
3035         driver->magic = TTY_DRIVER_MAGIC;
3036         driver->num = lines;
3037         driver->owner = owner;
3038         driver->flags = flags;
3039
3040         if (!(flags & TTY_DRIVER_DEVPTS_MEM)) {
3041                 driver->ttys = kcalloc(lines, sizeof(*driver->ttys),
3042                                 GFP_KERNEL);
3043                 driver->termios = kcalloc(lines, sizeof(*driver->termios),
3044                                 GFP_KERNEL);
3045                 if (!driver->ttys || !driver->termios) {
3046                         err = -ENOMEM;
3047                         goto err_free_all;
3048                 }
3049         }
3050
3051         if (!(flags & TTY_DRIVER_DYNAMIC_ALLOC)) {
3052                 driver->ports = kcalloc(lines, sizeof(*driver->ports),
3053                                 GFP_KERNEL);
3054                 if (!driver->ports) {
3055                         err = -ENOMEM;
3056                         goto err_free_all;
3057                 }
3058                 cdevs = lines;
3059         }
3060
3061         driver->cdevs = kcalloc(cdevs, sizeof(*driver->cdevs), GFP_KERNEL);
3062         if (!driver->cdevs) {
3063                 err = -ENOMEM;
3064                 goto err_free_all;
3065         }
3066
3067         return driver;
3068 err_free_all:
3069         kfree(driver->ports);
3070         kfree(driver->ttys);
3071         kfree(driver->termios);
3072         kfree(driver->cdevs);
3073         kfree(driver);
3074         return ERR_PTR(err);
3075 }
3076 EXPORT_SYMBOL(__tty_alloc_driver);
3077
3078 static void destruct_tty_driver(struct kref *kref)
3079 {
3080         struct tty_driver *driver = container_of(kref, struct tty_driver, kref);
3081         int i;
3082         struct ktermios *tp;
3083
3084         if (driver->flags & TTY_DRIVER_INSTALLED) {
3085                 for (i = 0; i < driver->num; i++) {
3086                         tp = driver->termios[i];
3087                         if (tp) {
3088                                 driver->termios[i] = NULL;
3089                                 kfree(tp);
3090                         }
3091                         if (!(driver->flags & TTY_DRIVER_DYNAMIC_DEV))
3092                                 tty_unregister_device(driver, i);
3093                 }
3094                 proc_tty_unregister_driver(driver);
3095                 if (driver->flags & TTY_DRIVER_DYNAMIC_ALLOC)
3096                         cdev_del(driver->cdevs[0]);
3097         }
3098         kfree(driver->cdevs);
3099         kfree(driver->ports);
3100         kfree(driver->termios);
3101         kfree(driver->ttys);
3102         kfree(driver);
3103 }
3104
3105 void tty_driver_kref_put(struct tty_driver *driver)
3106 {
3107         kref_put(&driver->kref, destruct_tty_driver);
3108 }
3109 EXPORT_SYMBOL(tty_driver_kref_put);
3110
3111 void tty_set_operations(struct tty_driver *driver,
3112                         const struct tty_operations *op)
3113 {
3114         driver->ops = op;
3115 };
3116 EXPORT_SYMBOL(tty_set_operations);
3117
3118 void put_tty_driver(struct tty_driver *d)
3119 {
3120         tty_driver_kref_put(d);
3121 }
3122 EXPORT_SYMBOL(put_tty_driver);
3123
3124 /*
3125  * Called by a tty driver to register itself.
3126  */
3127 int tty_register_driver(struct tty_driver *driver)
3128 {
3129         int error;
3130         int i;
3131         dev_t dev;
3132         struct device *d;
3133
3134         if (!driver->major) {
3135                 error = alloc_chrdev_region(&dev, driver->minor_start,
3136                                                 driver->num, driver->name);
3137                 if (!error) {
3138                         driver->major = MAJOR(dev);
3139                         driver->minor_start = MINOR(dev);
3140                 }
3141         } else {
3142                 dev = MKDEV(driver->major, driver->minor_start);
3143                 error = register_chrdev_region(dev, driver->num, driver->name);
3144         }
3145         if (error < 0)
3146                 goto err;
3147
3148         if (driver->flags & TTY_DRIVER_DYNAMIC_ALLOC) {
3149                 error = tty_cdev_add(driver, dev, 0, driver->num);
3150                 if (error)
3151                         goto err_unreg_char;
3152         }
3153
3154         mutex_lock(&tty_mutex);
3155         list_add(&driver->tty_drivers, &tty_drivers);
3156         mutex_unlock(&tty_mutex);
3157
3158         if (!(driver->flags & TTY_DRIVER_DYNAMIC_DEV)) {
3159                 for (i = 0; i < driver->num; i++) {
3160                         d = tty_register_device(driver, i, NULL);
3161                         if (IS_ERR(d)) {
3162                                 error = PTR_ERR(d);
3163                                 goto err_unreg_devs;
3164                         }
3165                 }
3166         }
3167         proc_tty_register_driver(driver);
3168         driver->flags |= TTY_DRIVER_INSTALLED;
3169         return 0;
3170
3171 err_unreg_devs:
3172         for (i--; i >= 0; i--)
3173                 tty_unregister_device(driver, i);
3174
3175         mutex_lock(&tty_mutex);
3176         list_del(&driver->tty_drivers);
3177         mutex_unlock(&tty_mutex);
3178
3179 err_unreg_char:
3180         unregister_chrdev_region(dev, driver->num);
3181 err:
3182         return error;
3183 }
3184 EXPORT_SYMBOL(tty_register_driver);
3185
3186 /*
3187  * Called by a tty driver to unregister itself.
3188  */
3189 int tty_unregister_driver(struct tty_driver *driver)
3190 {
3191 #if 0
3192         /* FIXME */
3193         if (driver->refcount)
3194                 return -EBUSY;
3195 #endif
3196         unregister_chrdev_region(MKDEV(driver->major, driver->minor_start),
3197                                 driver->num);
3198         mutex_lock(&tty_mutex);
3199         list_del(&driver->tty_drivers);
3200         mutex_unlock(&tty_mutex);
3201         return 0;
3202 }
3203
3204 EXPORT_SYMBOL(tty_unregister_driver);
3205
3206 dev_t tty_devnum(struct tty_struct *tty)
3207 {
3208         return MKDEV(tty->driver->major, tty->driver->minor_start) + tty->index;
3209 }
3210 EXPORT_SYMBOL(tty_devnum);
3211
3212 void tty_default_fops(struct file_operations *fops)
3213 {
3214         *fops = tty_fops;
3215 }
3216
3217 static char *tty_devnode(struct device *dev, umode_t *mode)
3218 {
3219         if (!mode)
3220                 return NULL;
3221         if (dev->devt == MKDEV(TTYAUX_MAJOR, 0) ||
3222             dev->devt == MKDEV(TTYAUX_MAJOR, 2))
3223                 *mode = 0666;
3224         return NULL;
3225 }
3226
3227 static int __init tty_class_init(void)
3228 {
3229         tty_class = class_create(THIS_MODULE, "tty");
3230         if (IS_ERR(tty_class))
3231                 return PTR_ERR(tty_class);
3232         tty_class->devnode = tty_devnode;
3233         return 0;
3234 }
3235
3236 postcore_initcall(tty_class_init);
3237
3238 /* 3/2004 jmc: why do these devices exist? */
3239 static struct cdev tty_cdev, console_cdev;
3240
3241 static ssize_t show_cons_active(struct device *dev,
3242                                 struct device_attribute *attr, char *buf)
3243 {
3244         struct console *cs[16];
3245         int i = 0;
3246         struct console *c;
3247         ssize_t count = 0;
3248
3249         console_lock();
3250         for_each_console(c) {
3251                 if (!c->device)
3252                         continue;
3253                 if (!c->write)
3254                         continue;
3255                 if ((c->flags & CON_ENABLED) == 0)
3256                         continue;
3257                 cs[i++] = c;
3258                 if (i >= ARRAY_SIZE(cs))
3259                         break;
3260         }
3261         while (i--) {
3262                 int index = cs[i]->index;
3263                 struct tty_driver *drv = cs[i]->device(cs[i], &index);
3264
3265                 /* don't resolve tty0 as some programs depend on it */
3266                 if (drv && (cs[i]->index > 0 || drv->major != TTY_MAJOR))
3267                         count += tty_line_name(drv, index, buf + count);
3268                 else
3269                         count += sprintf(buf + count, "%s%d",
3270                                          cs[i]->name, cs[i]->index);
3271
3272                 count += sprintf(buf + count, "%c", i ? ' ':'\n');
3273         }
3274         console_unlock();
3275
3276         return count;
3277 }
3278 static DEVICE_ATTR(active, S_IRUGO, show_cons_active, NULL);
3279
3280 static struct attribute *cons_dev_attrs[] = {
3281         &dev_attr_active.attr,
3282         NULL
3283 };
3284
3285 ATTRIBUTE_GROUPS(cons_dev);
3286
3287 static struct device *consdev;
3288
3289 void console_sysfs_notify(void)
3290 {
3291         if (consdev)
3292                 sysfs_notify(&consdev->kobj, NULL, "active");
3293 }
3294
3295 /*
3296  * Ok, now we can initialize the rest of the tty devices and can count
3297  * on memory allocations, interrupts etc..
3298  */
3299 int __init tty_init(void)
3300 {
3301         cdev_init(&tty_cdev, &tty_fops);
3302         if (cdev_add(&tty_cdev, MKDEV(TTYAUX_MAJOR, 0), 1) ||
3303             register_chrdev_region(MKDEV(TTYAUX_MAJOR, 0), 1, "/dev/tty") < 0)
3304                 panic("Couldn't register /dev/tty driver\n");
3305         device_create(tty_class, NULL, MKDEV(TTYAUX_MAJOR, 0), NULL, "tty");
3306
3307         cdev_init(&console_cdev, &console_fops);
3308         if (cdev_add(&console_cdev, MKDEV(TTYAUX_MAJOR, 1), 1) ||
3309             register_chrdev_region(MKDEV(TTYAUX_MAJOR, 1), 1, "/dev/console") < 0)
3310                 panic("Couldn't register /dev/console driver\n");
3311         consdev = device_create_with_groups(tty_class, NULL,
3312                                             MKDEV(TTYAUX_MAJOR, 1), NULL,
3313                                             cons_dev_groups, "console");
3314         if (IS_ERR(consdev))
3315                 consdev = NULL;
3316
3317 #ifdef CONFIG_VT
3318         vty_init(&console_fops);
3319 #endif
3320         return 0;
3321 }
3322
This page took 0.230587 seconds and 4 git commands to generate.