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