196fd7ce5SGreg Kroah-Hartman #include <linux/types.h> 296fd7ce5SGreg Kroah-Hartman #include <linux/errno.h> 38b3ffa17SJiri Slaby #include <linux/kmod.h> 496fd7ce5SGreg Kroah-Hartman #include <linux/sched.h> 596fd7ce5SGreg Kroah-Hartman #include <linux/interrupt.h> 696fd7ce5SGreg Kroah-Hartman #include <linux/tty.h> 796fd7ce5SGreg Kroah-Hartman #include <linux/tty_driver.h> 896fd7ce5SGreg Kroah-Hartman #include <linux/file.h> 996fd7ce5SGreg Kroah-Hartman #include <linux/mm.h> 1096fd7ce5SGreg Kroah-Hartman #include <linux/string.h> 1196fd7ce5SGreg Kroah-Hartman #include <linux/slab.h> 1296fd7ce5SGreg Kroah-Hartman #include <linux/poll.h> 1396fd7ce5SGreg Kroah-Hartman #include <linux/proc_fs.h> 1496fd7ce5SGreg Kroah-Hartman #include <linux/init.h> 1596fd7ce5SGreg Kroah-Hartman #include <linux/module.h> 1696fd7ce5SGreg Kroah-Hartman #include <linux/device.h> 1796fd7ce5SGreg Kroah-Hartman #include <linux/wait.h> 1896fd7ce5SGreg Kroah-Hartman #include <linux/bitops.h> 1996fd7ce5SGreg Kroah-Hartman #include <linux/seq_file.h> 2096fd7ce5SGreg Kroah-Hartman #include <linux/uaccess.h> 210c73c08eSJiri Slaby #include <linux/ratelimit.h> 2296fd7ce5SGreg Kroah-Hartman 2396fd7ce5SGreg Kroah-Hartman /* 2496fd7ce5SGreg Kroah-Hartman * This guards the refcounted line discipline lists. The lock 2596fd7ce5SGreg Kroah-Hartman * must be taken with irqs off because there are hangup path 2696fd7ce5SGreg Kroah-Hartman * callers who will do ldisc lookups and cannot sleep. 2796fd7ce5SGreg Kroah-Hartman */ 2896fd7ce5SGreg Kroah-Hartman 29c9739941SIvo Sieben static DEFINE_RAW_SPINLOCK(tty_ldisc_lock); 3096fd7ce5SGreg Kroah-Hartman static DECLARE_WAIT_QUEUE_HEAD(tty_ldisc_wait); 3196fd7ce5SGreg Kroah-Hartman /* Line disc dispatch table */ 3296fd7ce5SGreg Kroah-Hartman static struct tty_ldisc_ops *tty_ldiscs[NR_LDISCS]; 3396fd7ce5SGreg Kroah-Hartman 3496fd7ce5SGreg Kroah-Hartman static inline struct tty_ldisc *get_ldisc(struct tty_ldisc *ld) 3596fd7ce5SGreg Kroah-Hartman { 3696fd7ce5SGreg Kroah-Hartman if (ld) 3796fd7ce5SGreg Kroah-Hartman atomic_inc(&ld->users); 3896fd7ce5SGreg Kroah-Hartman return ld; 3996fd7ce5SGreg Kroah-Hartman } 4096fd7ce5SGreg Kroah-Hartman 4196fd7ce5SGreg Kroah-Hartman static void put_ldisc(struct tty_ldisc *ld) 4296fd7ce5SGreg Kroah-Hartman { 4396fd7ce5SGreg Kroah-Hartman unsigned long flags; 4496fd7ce5SGreg Kroah-Hartman 4596fd7ce5SGreg Kroah-Hartman if (WARN_ON_ONCE(!ld)) 4696fd7ce5SGreg Kroah-Hartman return; 4796fd7ce5SGreg Kroah-Hartman 4896fd7ce5SGreg Kroah-Hartman /* 4996fd7ce5SGreg Kroah-Hartman * If this is the last user, free the ldisc, and 5096fd7ce5SGreg Kroah-Hartman * release the ldisc ops. 5196fd7ce5SGreg Kroah-Hartman * 52c9739941SIvo Sieben * We really want an "atomic_dec_and_raw_lock_irqsave()", 5396fd7ce5SGreg Kroah-Hartman * but we don't have it, so this does it by hand. 5496fd7ce5SGreg Kroah-Hartman */ 55c9739941SIvo Sieben raw_spin_lock_irqsave(&tty_ldisc_lock, flags); 56c9739941SIvo Sieben if (atomic_dec_and_test(&ld->users)) { 5796fd7ce5SGreg Kroah-Hartman struct tty_ldisc_ops *ldo = ld->ops; 5896fd7ce5SGreg Kroah-Hartman 5996fd7ce5SGreg Kroah-Hartman ldo->refcount--; 6096fd7ce5SGreg Kroah-Hartman module_put(ldo->owner); 61c9739941SIvo Sieben raw_spin_unlock_irqrestore(&tty_ldisc_lock, flags); 6296fd7ce5SGreg Kroah-Hartman 6396fd7ce5SGreg Kroah-Hartman kfree(ld); 6496fd7ce5SGreg Kroah-Hartman return; 6596fd7ce5SGreg Kroah-Hartman } 66c9739941SIvo Sieben raw_spin_unlock_irqrestore(&tty_ldisc_lock, flags); 67bd5d7ce9SIvo Sieben 68bd5d7ce9SIvo Sieben if (waitqueue_active(&ld->wq_idle)) 691541f845SIvo Sieben wake_up(&ld->wq_idle); 7096fd7ce5SGreg Kroah-Hartman } 7196fd7ce5SGreg Kroah-Hartman 7296fd7ce5SGreg Kroah-Hartman /** 7396fd7ce5SGreg Kroah-Hartman * tty_register_ldisc - install a line discipline 7496fd7ce5SGreg Kroah-Hartman * @disc: ldisc number 7596fd7ce5SGreg Kroah-Hartman * @new_ldisc: pointer to the ldisc object 7696fd7ce5SGreg Kroah-Hartman * 7796fd7ce5SGreg Kroah-Hartman * Installs a new line discipline into the kernel. The discipline 7896fd7ce5SGreg Kroah-Hartman * is set up as unreferenced and then made available to the kernel 7996fd7ce5SGreg Kroah-Hartman * from this point onwards. 8096fd7ce5SGreg Kroah-Hartman * 8196fd7ce5SGreg Kroah-Hartman * Locking: 8296fd7ce5SGreg Kroah-Hartman * takes tty_ldisc_lock to guard against ldisc races 8396fd7ce5SGreg Kroah-Hartman */ 8496fd7ce5SGreg Kroah-Hartman 8596fd7ce5SGreg Kroah-Hartman int tty_register_ldisc(int disc, struct tty_ldisc_ops *new_ldisc) 8696fd7ce5SGreg Kroah-Hartman { 8796fd7ce5SGreg Kroah-Hartman unsigned long flags; 8896fd7ce5SGreg Kroah-Hartman int ret = 0; 8996fd7ce5SGreg Kroah-Hartman 9096fd7ce5SGreg Kroah-Hartman if (disc < N_TTY || disc >= NR_LDISCS) 9196fd7ce5SGreg Kroah-Hartman return -EINVAL; 9296fd7ce5SGreg Kroah-Hartman 93c9739941SIvo Sieben raw_spin_lock_irqsave(&tty_ldisc_lock, flags); 9496fd7ce5SGreg Kroah-Hartman tty_ldiscs[disc] = new_ldisc; 9596fd7ce5SGreg Kroah-Hartman new_ldisc->num = disc; 9696fd7ce5SGreg Kroah-Hartman new_ldisc->refcount = 0; 97c9739941SIvo Sieben raw_spin_unlock_irqrestore(&tty_ldisc_lock, flags); 9896fd7ce5SGreg Kroah-Hartman 9996fd7ce5SGreg Kroah-Hartman return ret; 10096fd7ce5SGreg Kroah-Hartman } 10196fd7ce5SGreg Kroah-Hartman EXPORT_SYMBOL(tty_register_ldisc); 10296fd7ce5SGreg Kroah-Hartman 10396fd7ce5SGreg Kroah-Hartman /** 10496fd7ce5SGreg Kroah-Hartman * tty_unregister_ldisc - unload a line discipline 10596fd7ce5SGreg Kroah-Hartman * @disc: ldisc number 10696fd7ce5SGreg Kroah-Hartman * @new_ldisc: pointer to the ldisc object 10796fd7ce5SGreg Kroah-Hartman * 10896fd7ce5SGreg Kroah-Hartman * Remove a line discipline from the kernel providing it is not 10996fd7ce5SGreg Kroah-Hartman * currently in use. 11096fd7ce5SGreg Kroah-Hartman * 11196fd7ce5SGreg Kroah-Hartman * Locking: 11296fd7ce5SGreg Kroah-Hartman * takes tty_ldisc_lock to guard against ldisc races 11396fd7ce5SGreg Kroah-Hartman */ 11496fd7ce5SGreg Kroah-Hartman 11596fd7ce5SGreg Kroah-Hartman int tty_unregister_ldisc(int disc) 11696fd7ce5SGreg Kroah-Hartman { 11796fd7ce5SGreg Kroah-Hartman unsigned long flags; 11896fd7ce5SGreg Kroah-Hartman int ret = 0; 11996fd7ce5SGreg Kroah-Hartman 12096fd7ce5SGreg Kroah-Hartman if (disc < N_TTY || disc >= NR_LDISCS) 12196fd7ce5SGreg Kroah-Hartman return -EINVAL; 12296fd7ce5SGreg Kroah-Hartman 123c9739941SIvo Sieben raw_spin_lock_irqsave(&tty_ldisc_lock, flags); 12496fd7ce5SGreg Kroah-Hartman if (tty_ldiscs[disc]->refcount) 12596fd7ce5SGreg Kroah-Hartman ret = -EBUSY; 12696fd7ce5SGreg Kroah-Hartman else 12796fd7ce5SGreg Kroah-Hartman tty_ldiscs[disc] = NULL; 128c9739941SIvo Sieben raw_spin_unlock_irqrestore(&tty_ldisc_lock, flags); 12996fd7ce5SGreg Kroah-Hartman 13096fd7ce5SGreg Kroah-Hartman return ret; 13196fd7ce5SGreg Kroah-Hartman } 13296fd7ce5SGreg Kroah-Hartman EXPORT_SYMBOL(tty_unregister_ldisc); 13396fd7ce5SGreg Kroah-Hartman 13496fd7ce5SGreg Kroah-Hartman static struct tty_ldisc_ops *get_ldops(int disc) 13596fd7ce5SGreg Kroah-Hartman { 13696fd7ce5SGreg Kroah-Hartman unsigned long flags; 13796fd7ce5SGreg Kroah-Hartman struct tty_ldisc_ops *ldops, *ret; 13896fd7ce5SGreg Kroah-Hartman 139c9739941SIvo Sieben raw_spin_lock_irqsave(&tty_ldisc_lock, flags); 14096fd7ce5SGreg Kroah-Hartman ret = ERR_PTR(-EINVAL); 14196fd7ce5SGreg Kroah-Hartman ldops = tty_ldiscs[disc]; 14296fd7ce5SGreg Kroah-Hartman if (ldops) { 14396fd7ce5SGreg Kroah-Hartman ret = ERR_PTR(-EAGAIN); 14496fd7ce5SGreg Kroah-Hartman if (try_module_get(ldops->owner)) { 14596fd7ce5SGreg Kroah-Hartman ldops->refcount++; 14696fd7ce5SGreg Kroah-Hartman ret = ldops; 14796fd7ce5SGreg Kroah-Hartman } 14896fd7ce5SGreg Kroah-Hartman } 149c9739941SIvo Sieben raw_spin_unlock_irqrestore(&tty_ldisc_lock, flags); 15096fd7ce5SGreg Kroah-Hartman return ret; 15196fd7ce5SGreg Kroah-Hartman } 15296fd7ce5SGreg Kroah-Hartman 15396fd7ce5SGreg Kroah-Hartman static void put_ldops(struct tty_ldisc_ops *ldops) 15496fd7ce5SGreg Kroah-Hartman { 15596fd7ce5SGreg Kroah-Hartman unsigned long flags; 15696fd7ce5SGreg Kroah-Hartman 157c9739941SIvo Sieben raw_spin_lock_irqsave(&tty_ldisc_lock, flags); 15896fd7ce5SGreg Kroah-Hartman ldops->refcount--; 15996fd7ce5SGreg Kroah-Hartman module_put(ldops->owner); 160c9739941SIvo Sieben raw_spin_unlock_irqrestore(&tty_ldisc_lock, flags); 16196fd7ce5SGreg Kroah-Hartman } 16296fd7ce5SGreg Kroah-Hartman 16396fd7ce5SGreg Kroah-Hartman /** 16496fd7ce5SGreg Kroah-Hartman * tty_ldisc_get - take a reference to an ldisc 16596fd7ce5SGreg Kroah-Hartman * @disc: ldisc number 16696fd7ce5SGreg Kroah-Hartman * 16796fd7ce5SGreg Kroah-Hartman * Takes a reference to a line discipline. Deals with refcounts and 16896fd7ce5SGreg Kroah-Hartman * module locking counts. Returns NULL if the discipline is not available. 16996fd7ce5SGreg Kroah-Hartman * Returns a pointer to the discipline and bumps the ref count if it is 17096fd7ce5SGreg Kroah-Hartman * available 17196fd7ce5SGreg Kroah-Hartman * 17296fd7ce5SGreg Kroah-Hartman * Locking: 17396fd7ce5SGreg Kroah-Hartman * takes tty_ldisc_lock to guard against ldisc races 17496fd7ce5SGreg Kroah-Hartman */ 17596fd7ce5SGreg Kroah-Hartman 17696fd7ce5SGreg Kroah-Hartman static struct tty_ldisc *tty_ldisc_get(int disc) 17796fd7ce5SGreg Kroah-Hartman { 17896fd7ce5SGreg Kroah-Hartman struct tty_ldisc *ld; 17996fd7ce5SGreg Kroah-Hartman struct tty_ldisc_ops *ldops; 18096fd7ce5SGreg Kroah-Hartman 18196fd7ce5SGreg Kroah-Hartman if (disc < N_TTY || disc >= NR_LDISCS) 18296fd7ce5SGreg Kroah-Hartman return ERR_PTR(-EINVAL); 18396fd7ce5SGreg Kroah-Hartman 18496fd7ce5SGreg Kroah-Hartman /* 18596fd7ce5SGreg Kroah-Hartman * Get the ldisc ops - we may need to request them to be loaded 18696fd7ce5SGreg Kroah-Hartman * dynamically and try again. 18796fd7ce5SGreg Kroah-Hartman */ 18896fd7ce5SGreg Kroah-Hartman ldops = get_ldops(disc); 18996fd7ce5SGreg Kroah-Hartman if (IS_ERR(ldops)) { 19096fd7ce5SGreg Kroah-Hartman request_module("tty-ldisc-%d", disc); 19196fd7ce5SGreg Kroah-Hartman ldops = get_ldops(disc); 19296fd7ce5SGreg Kroah-Hartman if (IS_ERR(ldops)) 19396fd7ce5SGreg Kroah-Hartman return ERR_CAST(ldops); 19496fd7ce5SGreg Kroah-Hartman } 19596fd7ce5SGreg Kroah-Hartman 19696fd7ce5SGreg Kroah-Hartman ld = kmalloc(sizeof(struct tty_ldisc), GFP_KERNEL); 19796fd7ce5SGreg Kroah-Hartman if (ld == NULL) { 19896fd7ce5SGreg Kroah-Hartman put_ldops(ldops); 19996fd7ce5SGreg Kroah-Hartman return ERR_PTR(-ENOMEM); 20096fd7ce5SGreg Kroah-Hartman } 20196fd7ce5SGreg Kroah-Hartman 20296fd7ce5SGreg Kroah-Hartman ld->ops = ldops; 20396fd7ce5SGreg Kroah-Hartman atomic_set(&ld->users, 1); 2041541f845SIvo Sieben init_waitqueue_head(&ld->wq_idle); 2051541f845SIvo Sieben 20696fd7ce5SGreg Kroah-Hartman return ld; 20796fd7ce5SGreg Kroah-Hartman } 20896fd7ce5SGreg Kroah-Hartman 20996fd7ce5SGreg Kroah-Hartman static void *tty_ldiscs_seq_start(struct seq_file *m, loff_t *pos) 21096fd7ce5SGreg Kroah-Hartman { 21196fd7ce5SGreg Kroah-Hartman return (*pos < NR_LDISCS) ? pos : NULL; 21296fd7ce5SGreg Kroah-Hartman } 21396fd7ce5SGreg Kroah-Hartman 21496fd7ce5SGreg Kroah-Hartman static void *tty_ldiscs_seq_next(struct seq_file *m, void *v, loff_t *pos) 21596fd7ce5SGreg Kroah-Hartman { 21696fd7ce5SGreg Kroah-Hartman (*pos)++; 21796fd7ce5SGreg Kroah-Hartman return (*pos < NR_LDISCS) ? pos : NULL; 21896fd7ce5SGreg Kroah-Hartman } 21996fd7ce5SGreg Kroah-Hartman 22096fd7ce5SGreg Kroah-Hartman static void tty_ldiscs_seq_stop(struct seq_file *m, void *v) 22196fd7ce5SGreg Kroah-Hartman { 22296fd7ce5SGreg Kroah-Hartman } 22396fd7ce5SGreg Kroah-Hartman 22496fd7ce5SGreg Kroah-Hartman static int tty_ldiscs_seq_show(struct seq_file *m, void *v) 22596fd7ce5SGreg Kroah-Hartman { 22696fd7ce5SGreg Kroah-Hartman int i = *(loff_t *)v; 22796fd7ce5SGreg Kroah-Hartman struct tty_ldisc_ops *ldops; 22896fd7ce5SGreg Kroah-Hartman 22996fd7ce5SGreg Kroah-Hartman ldops = get_ldops(i); 23096fd7ce5SGreg Kroah-Hartman if (IS_ERR(ldops)) 23196fd7ce5SGreg Kroah-Hartman return 0; 23296fd7ce5SGreg Kroah-Hartman seq_printf(m, "%-10s %2d\n", ldops->name ? ldops->name : "???", i); 23396fd7ce5SGreg Kroah-Hartman put_ldops(ldops); 23496fd7ce5SGreg Kroah-Hartman return 0; 23596fd7ce5SGreg Kroah-Hartman } 23696fd7ce5SGreg Kroah-Hartman 23796fd7ce5SGreg Kroah-Hartman static const struct seq_operations tty_ldiscs_seq_ops = { 23896fd7ce5SGreg Kroah-Hartman .start = tty_ldiscs_seq_start, 23996fd7ce5SGreg Kroah-Hartman .next = tty_ldiscs_seq_next, 24096fd7ce5SGreg Kroah-Hartman .stop = tty_ldiscs_seq_stop, 24196fd7ce5SGreg Kroah-Hartman .show = tty_ldiscs_seq_show, 24296fd7ce5SGreg Kroah-Hartman }; 24396fd7ce5SGreg Kroah-Hartman 24496fd7ce5SGreg Kroah-Hartman static int proc_tty_ldiscs_open(struct inode *inode, struct file *file) 24596fd7ce5SGreg Kroah-Hartman { 24696fd7ce5SGreg Kroah-Hartman return seq_open(file, &tty_ldiscs_seq_ops); 24796fd7ce5SGreg Kroah-Hartman } 24896fd7ce5SGreg Kroah-Hartman 24996fd7ce5SGreg Kroah-Hartman const struct file_operations tty_ldiscs_proc_fops = { 25096fd7ce5SGreg Kroah-Hartman .owner = THIS_MODULE, 25196fd7ce5SGreg Kroah-Hartman .open = proc_tty_ldiscs_open, 25296fd7ce5SGreg Kroah-Hartman .read = seq_read, 25396fd7ce5SGreg Kroah-Hartman .llseek = seq_lseek, 25496fd7ce5SGreg Kroah-Hartman .release = seq_release, 25596fd7ce5SGreg Kroah-Hartman }; 25696fd7ce5SGreg Kroah-Hartman 25796fd7ce5SGreg Kroah-Hartman /** 25896fd7ce5SGreg Kroah-Hartman * tty_ldisc_assign - set ldisc on a tty 25996fd7ce5SGreg Kroah-Hartman * @tty: tty to assign 26096fd7ce5SGreg Kroah-Hartman * @ld: line discipline 26196fd7ce5SGreg Kroah-Hartman * 26296fd7ce5SGreg Kroah-Hartman * Install an instance of a line discipline into a tty structure. The 26396fd7ce5SGreg Kroah-Hartman * ldisc must have a reference count above zero to ensure it remains. 26496fd7ce5SGreg Kroah-Hartman * The tty instance refcount starts at zero. 26596fd7ce5SGreg Kroah-Hartman * 26696fd7ce5SGreg Kroah-Hartman * Locking: 26796fd7ce5SGreg Kroah-Hartman * Caller must hold references 26896fd7ce5SGreg Kroah-Hartman */ 26996fd7ce5SGreg Kroah-Hartman 27096fd7ce5SGreg Kroah-Hartman static void tty_ldisc_assign(struct tty_struct *tty, struct tty_ldisc *ld) 27196fd7ce5SGreg Kroah-Hartman { 27296fd7ce5SGreg Kroah-Hartman tty->ldisc = ld; 27396fd7ce5SGreg Kroah-Hartman } 27496fd7ce5SGreg Kroah-Hartman 27596fd7ce5SGreg Kroah-Hartman /** 27696fd7ce5SGreg Kroah-Hartman * tty_ldisc_try - internal helper 27796fd7ce5SGreg Kroah-Hartman * @tty: the tty 27896fd7ce5SGreg Kroah-Hartman * 27996fd7ce5SGreg Kroah-Hartman * Make a single attempt to grab and bump the refcount on 28096fd7ce5SGreg Kroah-Hartman * the tty ldisc. Return 0 on failure or 1 on success. This is 28196fd7ce5SGreg Kroah-Hartman * used to implement both the waiting and non waiting versions 28296fd7ce5SGreg Kroah-Hartman * of tty_ldisc_ref 28396fd7ce5SGreg Kroah-Hartman * 28496fd7ce5SGreg Kroah-Hartman * Locking: takes tty_ldisc_lock 28596fd7ce5SGreg Kroah-Hartman */ 28696fd7ce5SGreg Kroah-Hartman 28796fd7ce5SGreg Kroah-Hartman static struct tty_ldisc *tty_ldisc_try(struct tty_struct *tty) 28896fd7ce5SGreg Kroah-Hartman { 28996fd7ce5SGreg Kroah-Hartman unsigned long flags; 29096fd7ce5SGreg Kroah-Hartman struct tty_ldisc *ld; 29196fd7ce5SGreg Kroah-Hartman 292c9739941SIvo Sieben raw_spin_lock_irqsave(&tty_ldisc_lock, flags); 29396fd7ce5SGreg Kroah-Hartman ld = NULL; 29496fd7ce5SGreg Kroah-Hartman if (test_bit(TTY_LDISC, &tty->flags)) 29596fd7ce5SGreg Kroah-Hartman ld = get_ldisc(tty->ldisc); 296c9739941SIvo Sieben raw_spin_unlock_irqrestore(&tty_ldisc_lock, flags); 29796fd7ce5SGreg Kroah-Hartman return ld; 29896fd7ce5SGreg Kroah-Hartman } 29996fd7ce5SGreg Kroah-Hartman 30096fd7ce5SGreg Kroah-Hartman /** 30196fd7ce5SGreg Kroah-Hartman * tty_ldisc_ref_wait - wait for the tty ldisc 30296fd7ce5SGreg Kroah-Hartman * @tty: tty device 30396fd7ce5SGreg Kroah-Hartman * 30496fd7ce5SGreg Kroah-Hartman * Dereference the line discipline for the terminal and take a 30596fd7ce5SGreg Kroah-Hartman * reference to it. If the line discipline is in flux then 30696fd7ce5SGreg Kroah-Hartman * wait patiently until it changes. 30796fd7ce5SGreg Kroah-Hartman * 30896fd7ce5SGreg Kroah-Hartman * Note: Must not be called from an IRQ/timer context. The caller 30996fd7ce5SGreg Kroah-Hartman * must also be careful not to hold other locks that will deadlock 31096fd7ce5SGreg Kroah-Hartman * against a discipline change, such as an existing ldisc reference 31196fd7ce5SGreg Kroah-Hartman * (which we check for) 31296fd7ce5SGreg Kroah-Hartman * 31396fd7ce5SGreg Kroah-Hartman * Locking: call functions take tty_ldisc_lock 31496fd7ce5SGreg Kroah-Hartman */ 31596fd7ce5SGreg Kroah-Hartman 31696fd7ce5SGreg Kroah-Hartman struct tty_ldisc *tty_ldisc_ref_wait(struct tty_struct *tty) 31796fd7ce5SGreg Kroah-Hartman { 31896fd7ce5SGreg Kroah-Hartman struct tty_ldisc *ld; 31996fd7ce5SGreg Kroah-Hartman 32096fd7ce5SGreg Kroah-Hartman /* wait_event is a macro */ 32196fd7ce5SGreg Kroah-Hartman wait_event(tty_ldisc_wait, (ld = tty_ldisc_try(tty)) != NULL); 32296fd7ce5SGreg Kroah-Hartman return ld; 32396fd7ce5SGreg Kroah-Hartman } 32496fd7ce5SGreg Kroah-Hartman EXPORT_SYMBOL_GPL(tty_ldisc_ref_wait); 32596fd7ce5SGreg Kroah-Hartman 32696fd7ce5SGreg Kroah-Hartman /** 32796fd7ce5SGreg Kroah-Hartman * tty_ldisc_ref - get the tty ldisc 32896fd7ce5SGreg Kroah-Hartman * @tty: tty device 32996fd7ce5SGreg Kroah-Hartman * 33096fd7ce5SGreg Kroah-Hartman * Dereference the line discipline for the terminal and take a 33196fd7ce5SGreg Kroah-Hartman * reference to it. If the line discipline is in flux then 33296fd7ce5SGreg Kroah-Hartman * return NULL. Can be called from IRQ and timer functions. 33396fd7ce5SGreg Kroah-Hartman * 33496fd7ce5SGreg Kroah-Hartman * Locking: called functions take tty_ldisc_lock 33596fd7ce5SGreg Kroah-Hartman */ 33696fd7ce5SGreg Kroah-Hartman 33796fd7ce5SGreg Kroah-Hartman struct tty_ldisc *tty_ldisc_ref(struct tty_struct *tty) 33896fd7ce5SGreg Kroah-Hartman { 33996fd7ce5SGreg Kroah-Hartman return tty_ldisc_try(tty); 34096fd7ce5SGreg Kroah-Hartman } 34196fd7ce5SGreg Kroah-Hartman EXPORT_SYMBOL_GPL(tty_ldisc_ref); 34296fd7ce5SGreg Kroah-Hartman 34396fd7ce5SGreg Kroah-Hartman /** 34496fd7ce5SGreg Kroah-Hartman * tty_ldisc_deref - free a tty ldisc reference 34596fd7ce5SGreg Kroah-Hartman * @ld: reference to free up 34696fd7ce5SGreg Kroah-Hartman * 34796fd7ce5SGreg Kroah-Hartman * Undoes the effect of tty_ldisc_ref or tty_ldisc_ref_wait. May 34896fd7ce5SGreg Kroah-Hartman * be called in IRQ context. 34996fd7ce5SGreg Kroah-Hartman * 35096fd7ce5SGreg Kroah-Hartman * Locking: takes tty_ldisc_lock 35196fd7ce5SGreg Kroah-Hartman */ 35296fd7ce5SGreg Kroah-Hartman 35396fd7ce5SGreg Kroah-Hartman void tty_ldisc_deref(struct tty_ldisc *ld) 35496fd7ce5SGreg Kroah-Hartman { 35596fd7ce5SGreg Kroah-Hartman put_ldisc(ld); 35696fd7ce5SGreg Kroah-Hartman } 35796fd7ce5SGreg Kroah-Hartman EXPORT_SYMBOL_GPL(tty_ldisc_deref); 35896fd7ce5SGreg Kroah-Hartman 35996fd7ce5SGreg Kroah-Hartman static inline void tty_ldisc_put(struct tty_ldisc *ld) 36096fd7ce5SGreg Kroah-Hartman { 36196fd7ce5SGreg Kroah-Hartman put_ldisc(ld); 36296fd7ce5SGreg Kroah-Hartman } 36396fd7ce5SGreg Kroah-Hartman 36496fd7ce5SGreg Kroah-Hartman /** 36596fd7ce5SGreg Kroah-Hartman * tty_ldisc_enable - allow ldisc use 36696fd7ce5SGreg Kroah-Hartman * @tty: terminal to activate ldisc on 36796fd7ce5SGreg Kroah-Hartman * 36896fd7ce5SGreg Kroah-Hartman * Set the TTY_LDISC flag when the line discipline can be called 36996fd7ce5SGreg Kroah-Hartman * again. Do necessary wakeups for existing sleepers. Clear the LDISC 37096fd7ce5SGreg Kroah-Hartman * changing flag to indicate any ldisc change is now over. 37196fd7ce5SGreg Kroah-Hartman * 37296fd7ce5SGreg Kroah-Hartman * Note: nobody should set the TTY_LDISC bit except via this function. 37396fd7ce5SGreg Kroah-Hartman * Clearing directly is allowed. 37496fd7ce5SGreg Kroah-Hartman */ 37596fd7ce5SGreg Kroah-Hartman 37696fd7ce5SGreg Kroah-Hartman void tty_ldisc_enable(struct tty_struct *tty) 37796fd7ce5SGreg Kroah-Hartman { 37896fd7ce5SGreg Kroah-Hartman set_bit(TTY_LDISC, &tty->flags); 37996fd7ce5SGreg Kroah-Hartman clear_bit(TTY_LDISC_CHANGING, &tty->flags); 38096fd7ce5SGreg Kroah-Hartman wake_up(&tty_ldisc_wait); 38196fd7ce5SGreg Kroah-Hartman } 38296fd7ce5SGreg Kroah-Hartman 38396fd7ce5SGreg Kroah-Hartman /** 38496fd7ce5SGreg Kroah-Hartman * tty_ldisc_flush - flush line discipline queue 38596fd7ce5SGreg Kroah-Hartman * @tty: tty 38696fd7ce5SGreg Kroah-Hartman * 38796fd7ce5SGreg Kroah-Hartman * Flush the line discipline queue (if any) for this tty. If there 38896fd7ce5SGreg Kroah-Hartman * is no line discipline active this is a no-op. 38996fd7ce5SGreg Kroah-Hartman */ 39096fd7ce5SGreg Kroah-Hartman 39196fd7ce5SGreg Kroah-Hartman void tty_ldisc_flush(struct tty_struct *tty) 39296fd7ce5SGreg Kroah-Hartman { 39396fd7ce5SGreg Kroah-Hartman struct tty_ldisc *ld = tty_ldisc_ref(tty); 39496fd7ce5SGreg Kroah-Hartman if (ld) { 39596fd7ce5SGreg Kroah-Hartman if (ld->ops->flush_buffer) 39696fd7ce5SGreg Kroah-Hartman ld->ops->flush_buffer(tty); 39796fd7ce5SGreg Kroah-Hartman tty_ldisc_deref(ld); 39896fd7ce5SGreg Kroah-Hartman } 39996fd7ce5SGreg Kroah-Hartman tty_buffer_flush(tty); 40096fd7ce5SGreg Kroah-Hartman } 40196fd7ce5SGreg Kroah-Hartman EXPORT_SYMBOL_GPL(tty_ldisc_flush); 40296fd7ce5SGreg Kroah-Hartman 40396fd7ce5SGreg Kroah-Hartman /** 40496fd7ce5SGreg Kroah-Hartman * tty_set_termios_ldisc - set ldisc field 40596fd7ce5SGreg Kroah-Hartman * @tty: tty structure 40696fd7ce5SGreg Kroah-Hartman * @num: line discipline number 40796fd7ce5SGreg Kroah-Hartman * 40896fd7ce5SGreg Kroah-Hartman * This is probably overkill for real world processors but 40996fd7ce5SGreg Kroah-Hartman * they are not on hot paths so a little discipline won't do 41096fd7ce5SGreg Kroah-Hartman * any harm. 41196fd7ce5SGreg Kroah-Hartman * 41296fd7ce5SGreg Kroah-Hartman * Locking: takes termios_mutex 41396fd7ce5SGreg Kroah-Hartman */ 41496fd7ce5SGreg Kroah-Hartman 41596fd7ce5SGreg Kroah-Hartman static void tty_set_termios_ldisc(struct tty_struct *tty, int num) 41696fd7ce5SGreg Kroah-Hartman { 41796fd7ce5SGreg Kroah-Hartman mutex_lock(&tty->termios_mutex); 418adc8d746SAlan Cox tty->termios.c_line = num; 41996fd7ce5SGreg Kroah-Hartman mutex_unlock(&tty->termios_mutex); 42096fd7ce5SGreg Kroah-Hartman } 42196fd7ce5SGreg Kroah-Hartman 42296fd7ce5SGreg Kroah-Hartman /** 42396fd7ce5SGreg Kroah-Hartman * tty_ldisc_open - open a line discipline 42496fd7ce5SGreg Kroah-Hartman * @tty: tty we are opening the ldisc on 42596fd7ce5SGreg Kroah-Hartman * @ld: discipline to open 42696fd7ce5SGreg Kroah-Hartman * 42796fd7ce5SGreg Kroah-Hartman * A helper opening method. Also a convenient debugging and check 42896fd7ce5SGreg Kroah-Hartman * point. 42996fd7ce5SGreg Kroah-Hartman * 43096fd7ce5SGreg Kroah-Hartman * Locking: always called with BTM already held. 43196fd7ce5SGreg Kroah-Hartman */ 43296fd7ce5SGreg Kroah-Hartman 43396fd7ce5SGreg Kroah-Hartman static int tty_ldisc_open(struct tty_struct *tty, struct tty_ldisc *ld) 43496fd7ce5SGreg Kroah-Hartman { 43596fd7ce5SGreg Kroah-Hartman WARN_ON(test_and_set_bit(TTY_LDISC_OPEN, &tty->flags)); 43696fd7ce5SGreg Kroah-Hartman if (ld->ops->open) { 43796fd7ce5SGreg Kroah-Hartman int ret; 43896fd7ce5SGreg Kroah-Hartman /* BTM here locks versus a hangup event */ 43996fd7ce5SGreg Kroah-Hartman ret = ld->ops->open(tty); 4407f90cfc5SJiri Slaby if (ret) 4417f90cfc5SJiri Slaby clear_bit(TTY_LDISC_OPEN, &tty->flags); 44296fd7ce5SGreg Kroah-Hartman return ret; 44396fd7ce5SGreg Kroah-Hartman } 44496fd7ce5SGreg Kroah-Hartman return 0; 44596fd7ce5SGreg Kroah-Hartman } 44696fd7ce5SGreg Kroah-Hartman 44796fd7ce5SGreg Kroah-Hartman /** 44896fd7ce5SGreg Kroah-Hartman * tty_ldisc_close - close a line discipline 44996fd7ce5SGreg Kroah-Hartman * @tty: tty we are opening the ldisc on 45096fd7ce5SGreg Kroah-Hartman * @ld: discipline to close 45196fd7ce5SGreg Kroah-Hartman * 45296fd7ce5SGreg Kroah-Hartman * A helper close method. Also a convenient debugging and check 45396fd7ce5SGreg Kroah-Hartman * point. 45496fd7ce5SGreg Kroah-Hartman */ 45596fd7ce5SGreg Kroah-Hartman 45696fd7ce5SGreg Kroah-Hartman static void tty_ldisc_close(struct tty_struct *tty, struct tty_ldisc *ld) 45796fd7ce5SGreg Kroah-Hartman { 45896fd7ce5SGreg Kroah-Hartman WARN_ON(!test_bit(TTY_LDISC_OPEN, &tty->flags)); 45996fd7ce5SGreg Kroah-Hartman clear_bit(TTY_LDISC_OPEN, &tty->flags); 46096fd7ce5SGreg Kroah-Hartman if (ld->ops->close) 46196fd7ce5SGreg Kroah-Hartman ld->ops->close(tty); 46296fd7ce5SGreg Kroah-Hartman } 46396fd7ce5SGreg Kroah-Hartman 46496fd7ce5SGreg Kroah-Hartman /** 46596fd7ce5SGreg Kroah-Hartman * tty_ldisc_restore - helper for tty ldisc change 46696fd7ce5SGreg Kroah-Hartman * @tty: tty to recover 46796fd7ce5SGreg Kroah-Hartman * @old: previous ldisc 46896fd7ce5SGreg Kroah-Hartman * 46996fd7ce5SGreg Kroah-Hartman * Restore the previous line discipline or N_TTY when a line discipline 47096fd7ce5SGreg Kroah-Hartman * change fails due to an open error 47196fd7ce5SGreg Kroah-Hartman */ 47296fd7ce5SGreg Kroah-Hartman 47396fd7ce5SGreg Kroah-Hartman static void tty_ldisc_restore(struct tty_struct *tty, struct tty_ldisc *old) 47496fd7ce5SGreg Kroah-Hartman { 47596fd7ce5SGreg Kroah-Hartman char buf[64]; 47696fd7ce5SGreg Kroah-Hartman struct tty_ldisc *new_ldisc; 47796fd7ce5SGreg Kroah-Hartman int r; 47896fd7ce5SGreg Kroah-Hartman 47996fd7ce5SGreg Kroah-Hartman /* There is an outstanding reference here so this is safe */ 48096fd7ce5SGreg Kroah-Hartman old = tty_ldisc_get(old->ops->num); 48196fd7ce5SGreg Kroah-Hartman WARN_ON(IS_ERR(old)); 48296fd7ce5SGreg Kroah-Hartman tty_ldisc_assign(tty, old); 48396fd7ce5SGreg Kroah-Hartman tty_set_termios_ldisc(tty, old->ops->num); 48496fd7ce5SGreg Kroah-Hartman if (tty_ldisc_open(tty, old) < 0) { 48596fd7ce5SGreg Kroah-Hartman tty_ldisc_put(old); 48696fd7ce5SGreg Kroah-Hartman /* This driver is always present */ 48796fd7ce5SGreg Kroah-Hartman new_ldisc = tty_ldisc_get(N_TTY); 48896fd7ce5SGreg Kroah-Hartman if (IS_ERR(new_ldisc)) 48996fd7ce5SGreg Kroah-Hartman panic("n_tty: get"); 49096fd7ce5SGreg Kroah-Hartman tty_ldisc_assign(tty, new_ldisc); 49196fd7ce5SGreg Kroah-Hartman tty_set_termios_ldisc(tty, N_TTY); 49296fd7ce5SGreg Kroah-Hartman r = tty_ldisc_open(tty, new_ldisc); 49396fd7ce5SGreg Kroah-Hartman if (r < 0) 49496fd7ce5SGreg Kroah-Hartman panic("Couldn't open N_TTY ldisc for " 49596fd7ce5SGreg Kroah-Hartman "%s --- error %d.", 49696fd7ce5SGreg Kroah-Hartman tty_name(tty, buf), r); 49796fd7ce5SGreg Kroah-Hartman } 49896fd7ce5SGreg Kroah-Hartman } 49996fd7ce5SGreg Kroah-Hartman 50096fd7ce5SGreg Kroah-Hartman /** 50196fd7ce5SGreg Kroah-Hartman * tty_ldisc_halt - shut down the line discipline 50296fd7ce5SGreg Kroah-Hartman * @tty: tty device 50396fd7ce5SGreg Kroah-Hartman * 50496fd7ce5SGreg Kroah-Hartman * Shut down the line discipline and work queue for this tty device. 50596fd7ce5SGreg Kroah-Hartman * The TTY_LDISC flag being cleared ensures no further references can 50696fd7ce5SGreg Kroah-Hartman * be obtained while the delayed work queue halt ensures that no more 50796fd7ce5SGreg Kroah-Hartman * data is fed to the ldisc. 50896fd7ce5SGreg Kroah-Hartman * 50996fd7ce5SGreg Kroah-Hartman * You need to do a 'flush_scheduled_work()' (outside the ldisc_mutex) 51096fd7ce5SGreg Kroah-Hartman * in order to make sure any currently executing ldisc work is also 51196fd7ce5SGreg Kroah-Hartman * flushed. 51296fd7ce5SGreg Kroah-Hartman */ 51396fd7ce5SGreg Kroah-Hartman 51496fd7ce5SGreg Kroah-Hartman static int tty_ldisc_halt(struct tty_struct *tty) 51596fd7ce5SGreg Kroah-Hartman { 51696fd7ce5SGreg Kroah-Hartman clear_bit(TTY_LDISC, &tty->flags); 517ecbbfd44SJiri Slaby return cancel_work_sync(&tty->port->buf.work); 51896fd7ce5SGreg Kroah-Hartman } 51996fd7ce5SGreg Kroah-Hartman 52096fd7ce5SGreg Kroah-Hartman /** 5210a1f1a0bSTejun Heo * tty_ldisc_flush_works - flush all works of a tty 5220a1f1a0bSTejun Heo * @tty: tty device to flush works for 5230a1f1a0bSTejun Heo * 5240a1f1a0bSTejun Heo * Sync flush all works belonging to @tty. 5250a1f1a0bSTejun Heo */ 5260a1f1a0bSTejun Heo static void tty_ldisc_flush_works(struct tty_struct *tty) 5270a1f1a0bSTejun Heo { 52843829731STejun Heo flush_work(&tty->hangup_work); 52943829731STejun Heo flush_work(&tty->SAK_work); 530ecbbfd44SJiri Slaby flush_work(&tty->port->buf.work); 5310a1f1a0bSTejun Heo } 5320a1f1a0bSTejun Heo 5330a1f1a0bSTejun Heo /** 534100eeae2SJiri Slaby * tty_ldisc_wait_idle - wait for the ldisc to become idle 535100eeae2SJiri Slaby * @tty: tty to wait for 536df92d056SJiri Slaby * @timeout: for how long to wait at most 537100eeae2SJiri Slaby * 538100eeae2SJiri Slaby * Wait for the line discipline to become idle. The discipline must 539100eeae2SJiri Slaby * have been halted for this to guarantee it remains idle. 540100eeae2SJiri Slaby */ 541df92d056SJiri Slaby static int tty_ldisc_wait_idle(struct tty_struct *tty, long timeout) 542100eeae2SJiri Slaby { 543df92d056SJiri Slaby long ret; 5441541f845SIvo Sieben ret = wait_event_timeout(tty->ldisc->wq_idle, 545df92d056SJiri Slaby atomic_read(&tty->ldisc->users) == 1, timeout); 546100eeae2SJiri Slaby return ret > 0 ? 0 : -EBUSY; 547100eeae2SJiri Slaby } 548100eeae2SJiri Slaby 549100eeae2SJiri Slaby /** 55096fd7ce5SGreg Kroah-Hartman * tty_set_ldisc - set line discipline 55196fd7ce5SGreg Kroah-Hartman * @tty: the terminal to set 55296fd7ce5SGreg Kroah-Hartman * @ldisc: the line discipline 55396fd7ce5SGreg Kroah-Hartman * 55496fd7ce5SGreg Kroah-Hartman * Set the discipline of a tty line. Must be called from a process 55596fd7ce5SGreg Kroah-Hartman * context. The ldisc change logic has to protect itself against any 55696fd7ce5SGreg Kroah-Hartman * overlapping ldisc change (including on the other end of pty pairs), 55796fd7ce5SGreg Kroah-Hartman * the close of one side of a tty/pty pair, and eventually hangup. 55896fd7ce5SGreg Kroah-Hartman * 55996fd7ce5SGreg Kroah-Hartman * Locking: takes tty_ldisc_lock, termios_mutex 56096fd7ce5SGreg Kroah-Hartman */ 56196fd7ce5SGreg Kroah-Hartman 56296fd7ce5SGreg Kroah-Hartman int tty_set_ldisc(struct tty_struct *tty, int ldisc) 56396fd7ce5SGreg Kroah-Hartman { 56496fd7ce5SGreg Kroah-Hartman int retval; 56596fd7ce5SGreg Kroah-Hartman struct tty_ldisc *o_ldisc, *new_ldisc; 56696fd7ce5SGreg Kroah-Hartman int work, o_work = 0; 56796fd7ce5SGreg Kroah-Hartman struct tty_struct *o_tty; 56896fd7ce5SGreg Kroah-Hartman 56996fd7ce5SGreg Kroah-Hartman new_ldisc = tty_ldisc_get(ldisc); 57096fd7ce5SGreg Kroah-Hartman if (IS_ERR(new_ldisc)) 57196fd7ce5SGreg Kroah-Hartman return PTR_ERR(new_ldisc); 57296fd7ce5SGreg Kroah-Hartman 57389c8d91eSAlan Cox tty_lock(tty); 57496fd7ce5SGreg Kroah-Hartman /* 57596fd7ce5SGreg Kroah-Hartman * We need to look at the tty locking here for pty/tty pairs 57696fd7ce5SGreg Kroah-Hartman * when both sides try to change in parallel. 57796fd7ce5SGreg Kroah-Hartman */ 57896fd7ce5SGreg Kroah-Hartman 57996fd7ce5SGreg Kroah-Hartman o_tty = tty->link; /* o_tty is the pty side or NULL */ 58096fd7ce5SGreg Kroah-Hartman 58196fd7ce5SGreg Kroah-Hartman 58296fd7ce5SGreg Kroah-Hartman /* 58396fd7ce5SGreg Kroah-Hartman * Check the no-op case 58496fd7ce5SGreg Kroah-Hartman */ 58596fd7ce5SGreg Kroah-Hartman 58696fd7ce5SGreg Kroah-Hartman if (tty->ldisc->ops->num == ldisc) { 58789c8d91eSAlan Cox tty_unlock(tty); 58896fd7ce5SGreg Kroah-Hartman tty_ldisc_put(new_ldisc); 58996fd7ce5SGreg Kroah-Hartman return 0; 59096fd7ce5SGreg Kroah-Hartman } 59196fd7ce5SGreg Kroah-Hartman 59289c8d91eSAlan Cox tty_unlock(tty); 59396fd7ce5SGreg Kroah-Hartman /* 59496fd7ce5SGreg Kroah-Hartman * Problem: What do we do if this blocks ? 59596fd7ce5SGreg Kroah-Hartman * We could deadlock here 59696fd7ce5SGreg Kroah-Hartman */ 59796fd7ce5SGreg Kroah-Hartman 59896fd7ce5SGreg Kroah-Hartman tty_wait_until_sent(tty, 0); 59996fd7ce5SGreg Kroah-Hartman 60089c8d91eSAlan Cox tty_lock(tty); 60196fd7ce5SGreg Kroah-Hartman mutex_lock(&tty->ldisc_mutex); 60296fd7ce5SGreg Kroah-Hartman 60396fd7ce5SGreg Kroah-Hartman /* 60496fd7ce5SGreg Kroah-Hartman * We could be midstream of another ldisc change which has 60596fd7ce5SGreg Kroah-Hartman * dropped the lock during processing. If so we need to wait. 60696fd7ce5SGreg Kroah-Hartman */ 60796fd7ce5SGreg Kroah-Hartman 60896fd7ce5SGreg Kroah-Hartman while (test_bit(TTY_LDISC_CHANGING, &tty->flags)) { 60996fd7ce5SGreg Kroah-Hartman mutex_unlock(&tty->ldisc_mutex); 61089c8d91eSAlan Cox tty_unlock(tty); 61196fd7ce5SGreg Kroah-Hartman wait_event(tty_ldisc_wait, 61296fd7ce5SGreg Kroah-Hartman test_bit(TTY_LDISC_CHANGING, &tty->flags) == 0); 61389c8d91eSAlan Cox tty_lock(tty); 61496fd7ce5SGreg Kroah-Hartman mutex_lock(&tty->ldisc_mutex); 61596fd7ce5SGreg Kroah-Hartman } 61696fd7ce5SGreg Kroah-Hartman 61796fd7ce5SGreg Kroah-Hartman set_bit(TTY_LDISC_CHANGING, &tty->flags); 61896fd7ce5SGreg Kroah-Hartman 61996fd7ce5SGreg Kroah-Hartman /* 62096fd7ce5SGreg Kroah-Hartman * No more input please, we are switching. The new ldisc 62196fd7ce5SGreg Kroah-Hartman * will update this value in the ldisc open function 62296fd7ce5SGreg Kroah-Hartman */ 62396fd7ce5SGreg Kroah-Hartman 62496fd7ce5SGreg Kroah-Hartman tty->receive_room = 0; 62596fd7ce5SGreg Kroah-Hartman 62696fd7ce5SGreg Kroah-Hartman o_ldisc = tty->ldisc; 62796fd7ce5SGreg Kroah-Hartman 62889c8d91eSAlan Cox tty_unlock(tty); 62996fd7ce5SGreg Kroah-Hartman /* 63096fd7ce5SGreg Kroah-Hartman * Make sure we don't change while someone holds a 63196fd7ce5SGreg Kroah-Hartman * reference to the line discipline. The TTY_LDISC bit 63296fd7ce5SGreg Kroah-Hartman * prevents anyone taking a reference once it is clear. 63396fd7ce5SGreg Kroah-Hartman * We need the lock to avoid racing reference takers. 63496fd7ce5SGreg Kroah-Hartman * 63596fd7ce5SGreg Kroah-Hartman * We must clear the TTY_LDISC bit here to avoid a livelock 63696fd7ce5SGreg Kroah-Hartman * with a userspace app continually trying to use the tty in 63796fd7ce5SGreg Kroah-Hartman * parallel to the change and re-referencing the tty. 63896fd7ce5SGreg Kroah-Hartman */ 63996fd7ce5SGreg Kroah-Hartman 64096fd7ce5SGreg Kroah-Hartman work = tty_ldisc_halt(tty); 64196fd7ce5SGreg Kroah-Hartman if (o_tty) 64296fd7ce5SGreg Kroah-Hartman o_work = tty_ldisc_halt(o_tty); 64396fd7ce5SGreg Kroah-Hartman 64496fd7ce5SGreg Kroah-Hartman /* 64596fd7ce5SGreg Kroah-Hartman * Wait for ->hangup_work and ->buf.work handlers to terminate. 64696fd7ce5SGreg Kroah-Hartman * We must drop the mutex here in case a hangup is also in process. 64796fd7ce5SGreg Kroah-Hartman */ 64896fd7ce5SGreg Kroah-Hartman 64996fd7ce5SGreg Kroah-Hartman mutex_unlock(&tty->ldisc_mutex); 65096fd7ce5SGreg Kroah-Hartman 6510a1f1a0bSTejun Heo tty_ldisc_flush_works(tty); 65296fd7ce5SGreg Kroah-Hartman 653df92d056SJiri Slaby retval = tty_ldisc_wait_idle(tty, 5 * HZ); 654100eeae2SJiri Slaby 65589c8d91eSAlan Cox tty_lock(tty); 65696fd7ce5SGreg Kroah-Hartman mutex_lock(&tty->ldisc_mutex); 657100eeae2SJiri Slaby 658100eeae2SJiri Slaby /* handle wait idle failure locked */ 659100eeae2SJiri Slaby if (retval) { 660100eeae2SJiri Slaby tty_ldisc_put(new_ldisc); 661100eeae2SJiri Slaby goto enable; 662100eeae2SJiri Slaby } 663100eeae2SJiri Slaby 66440c9f61eSShachar Shemesh if (test_bit(TTY_HUPPING, &tty->flags)) { 66596fd7ce5SGreg Kroah-Hartman /* We were raced by the hangup method. It will have stomped 66696fd7ce5SGreg Kroah-Hartman the ldisc data and closed the ldisc down */ 66796fd7ce5SGreg Kroah-Hartman clear_bit(TTY_LDISC_CHANGING, &tty->flags); 66896fd7ce5SGreg Kroah-Hartman mutex_unlock(&tty->ldisc_mutex); 66996fd7ce5SGreg Kroah-Hartman tty_ldisc_put(new_ldisc); 67089c8d91eSAlan Cox tty_unlock(tty); 67196fd7ce5SGreg Kroah-Hartman return -EIO; 67296fd7ce5SGreg Kroah-Hartman } 67396fd7ce5SGreg Kroah-Hartman 67496fd7ce5SGreg Kroah-Hartman /* Shutdown the current discipline. */ 67596fd7ce5SGreg Kroah-Hartman tty_ldisc_close(tty, o_ldisc); 67696fd7ce5SGreg Kroah-Hartman 67796fd7ce5SGreg Kroah-Hartman /* Now set up the new line discipline. */ 67896fd7ce5SGreg Kroah-Hartman tty_ldisc_assign(tty, new_ldisc); 67996fd7ce5SGreg Kroah-Hartman tty_set_termios_ldisc(tty, ldisc); 68096fd7ce5SGreg Kroah-Hartman 68196fd7ce5SGreg Kroah-Hartman retval = tty_ldisc_open(tty, new_ldisc); 68296fd7ce5SGreg Kroah-Hartman if (retval < 0) { 68396fd7ce5SGreg Kroah-Hartman /* Back to the old one or N_TTY if we can't */ 68496fd7ce5SGreg Kroah-Hartman tty_ldisc_put(new_ldisc); 68596fd7ce5SGreg Kroah-Hartman tty_ldisc_restore(tty, o_ldisc); 68696fd7ce5SGreg Kroah-Hartman } 68796fd7ce5SGreg Kroah-Hartman 68896fd7ce5SGreg Kroah-Hartman /* At this point we hold a reference to the new ldisc and a 68996fd7ce5SGreg Kroah-Hartman a reference to the old ldisc. If we ended up flipping back 69096fd7ce5SGreg Kroah-Hartman to the existing ldisc we have two references to it */ 69196fd7ce5SGreg Kroah-Hartman 69296fd7ce5SGreg Kroah-Hartman if (tty->ldisc->ops->num != o_ldisc->ops->num && tty->ops->set_ldisc) 69396fd7ce5SGreg Kroah-Hartman tty->ops->set_ldisc(tty); 69496fd7ce5SGreg Kroah-Hartman 69596fd7ce5SGreg Kroah-Hartman tty_ldisc_put(o_ldisc); 69696fd7ce5SGreg Kroah-Hartman 697100eeae2SJiri Slaby enable: 69896fd7ce5SGreg Kroah-Hartman /* 69996fd7ce5SGreg Kroah-Hartman * Allow ldisc referencing to occur again 70096fd7ce5SGreg Kroah-Hartman */ 70196fd7ce5SGreg Kroah-Hartman 70296fd7ce5SGreg Kroah-Hartman tty_ldisc_enable(tty); 70396fd7ce5SGreg Kroah-Hartman if (o_tty) 70496fd7ce5SGreg Kroah-Hartman tty_ldisc_enable(o_tty); 70596fd7ce5SGreg Kroah-Hartman 70696fd7ce5SGreg Kroah-Hartman /* Restart the work queue in case no characters kick it off. Safe if 70796fd7ce5SGreg Kroah-Hartman already running */ 70896fd7ce5SGreg Kroah-Hartman if (work) 709ecbbfd44SJiri Slaby schedule_work(&tty->port->buf.work); 71096fd7ce5SGreg Kroah-Hartman if (o_work) 711ecbbfd44SJiri Slaby schedule_work(&o_tty->port->buf.work); 71296fd7ce5SGreg Kroah-Hartman mutex_unlock(&tty->ldisc_mutex); 71389c8d91eSAlan Cox tty_unlock(tty); 71496fd7ce5SGreg Kroah-Hartman return retval; 71596fd7ce5SGreg Kroah-Hartman } 71696fd7ce5SGreg Kroah-Hartman 71796fd7ce5SGreg Kroah-Hartman /** 71896fd7ce5SGreg Kroah-Hartman * tty_reset_termios - reset terminal state 71996fd7ce5SGreg Kroah-Hartman * @tty: tty to reset 72096fd7ce5SGreg Kroah-Hartman * 72196fd7ce5SGreg Kroah-Hartman * Restore a terminal to the driver default state. 72296fd7ce5SGreg Kroah-Hartman */ 72396fd7ce5SGreg Kroah-Hartman 72496fd7ce5SGreg Kroah-Hartman static void tty_reset_termios(struct tty_struct *tty) 72596fd7ce5SGreg Kroah-Hartman { 72696fd7ce5SGreg Kroah-Hartman mutex_lock(&tty->termios_mutex); 727adc8d746SAlan Cox tty->termios = tty->driver->init_termios; 728adc8d746SAlan Cox tty->termios.c_ispeed = tty_termios_input_baud_rate(&tty->termios); 729adc8d746SAlan Cox tty->termios.c_ospeed = tty_termios_baud_rate(&tty->termios); 73096fd7ce5SGreg Kroah-Hartman mutex_unlock(&tty->termios_mutex); 73196fd7ce5SGreg Kroah-Hartman } 73296fd7ce5SGreg Kroah-Hartman 73396fd7ce5SGreg Kroah-Hartman 73496fd7ce5SGreg Kroah-Hartman /** 73596fd7ce5SGreg Kroah-Hartman * tty_ldisc_reinit - reinitialise the tty ldisc 73696fd7ce5SGreg Kroah-Hartman * @tty: tty to reinit 73796fd7ce5SGreg Kroah-Hartman * @ldisc: line discipline to reinitialize 73896fd7ce5SGreg Kroah-Hartman * 73996fd7ce5SGreg Kroah-Hartman * Switch the tty to a line discipline and leave the ldisc 74096fd7ce5SGreg Kroah-Hartman * state closed 74196fd7ce5SGreg Kroah-Hartman */ 74296fd7ce5SGreg Kroah-Hartman 7431c95ba1eSPhilippe Rétornaz static int tty_ldisc_reinit(struct tty_struct *tty, int ldisc) 74496fd7ce5SGreg Kroah-Hartman { 7451c95ba1eSPhilippe Rétornaz struct tty_ldisc *ld = tty_ldisc_get(ldisc); 7461c95ba1eSPhilippe Rétornaz 7471c95ba1eSPhilippe Rétornaz if (IS_ERR(ld)) 7481c95ba1eSPhilippe Rétornaz return -1; 74996fd7ce5SGreg Kroah-Hartman 75096fd7ce5SGreg Kroah-Hartman tty_ldisc_close(tty, tty->ldisc); 75196fd7ce5SGreg Kroah-Hartman tty_ldisc_put(tty->ldisc); 75296fd7ce5SGreg Kroah-Hartman tty->ldisc = NULL; 75396fd7ce5SGreg Kroah-Hartman /* 75496fd7ce5SGreg Kroah-Hartman * Switch the line discipline back 75596fd7ce5SGreg Kroah-Hartman */ 75696fd7ce5SGreg Kroah-Hartman tty_ldisc_assign(tty, ld); 75796fd7ce5SGreg Kroah-Hartman tty_set_termios_ldisc(tty, ldisc); 7581c95ba1eSPhilippe Rétornaz 7591c95ba1eSPhilippe Rétornaz return 0; 76096fd7ce5SGreg Kroah-Hartman } 76196fd7ce5SGreg Kroah-Hartman 76296fd7ce5SGreg Kroah-Hartman /** 76396fd7ce5SGreg Kroah-Hartman * tty_ldisc_hangup - hangup ldisc reset 76496fd7ce5SGreg Kroah-Hartman * @tty: tty being hung up 76596fd7ce5SGreg Kroah-Hartman * 76696fd7ce5SGreg Kroah-Hartman * Some tty devices reset their termios when they receive a hangup 76796fd7ce5SGreg Kroah-Hartman * event. In that situation we must also switch back to N_TTY properly 76896fd7ce5SGreg Kroah-Hartman * before we reset the termios data. 76996fd7ce5SGreg Kroah-Hartman * 77096fd7ce5SGreg Kroah-Hartman * Locking: We can take the ldisc mutex as the rest of the code is 77196fd7ce5SGreg Kroah-Hartman * careful to allow for this. 77296fd7ce5SGreg Kroah-Hartman * 77396fd7ce5SGreg Kroah-Hartman * In the pty pair case this occurs in the close() path of the 77496fd7ce5SGreg Kroah-Hartman * tty itself so we must be careful about locking rules. 77596fd7ce5SGreg Kroah-Hartman */ 77696fd7ce5SGreg Kroah-Hartman 77796fd7ce5SGreg Kroah-Hartman void tty_ldisc_hangup(struct tty_struct *tty) 77896fd7ce5SGreg Kroah-Hartman { 77996fd7ce5SGreg Kroah-Hartman struct tty_ldisc *ld; 78096fd7ce5SGreg Kroah-Hartman int reset = tty->driver->flags & TTY_DRIVER_RESET_TERMIOS; 78196fd7ce5SGreg Kroah-Hartman int err = 0; 78296fd7ce5SGreg Kroah-Hartman 78396fd7ce5SGreg Kroah-Hartman /* 78496fd7ce5SGreg Kroah-Hartman * FIXME! What are the locking issues here? This may me overdoing 78596fd7ce5SGreg Kroah-Hartman * things... This question is especially important now that we've 78696fd7ce5SGreg Kroah-Hartman * removed the irqlock. 78796fd7ce5SGreg Kroah-Hartman */ 78896fd7ce5SGreg Kroah-Hartman ld = tty_ldisc_ref(tty); 78996fd7ce5SGreg Kroah-Hartman if (ld != NULL) { 79096fd7ce5SGreg Kroah-Hartman /* We may have no line discipline at this point */ 79196fd7ce5SGreg Kroah-Hartman if (ld->ops->flush_buffer) 79296fd7ce5SGreg Kroah-Hartman ld->ops->flush_buffer(tty); 79396fd7ce5SGreg Kroah-Hartman tty_driver_flush_buffer(tty); 79496fd7ce5SGreg Kroah-Hartman if ((test_bit(TTY_DO_WRITE_WAKEUP, &tty->flags)) && 79596fd7ce5SGreg Kroah-Hartman ld->ops->write_wakeup) 79696fd7ce5SGreg Kroah-Hartman ld->ops->write_wakeup(tty); 79796fd7ce5SGreg Kroah-Hartman if (ld->ops->hangup) 79896fd7ce5SGreg Kroah-Hartman ld->ops->hangup(tty); 79996fd7ce5SGreg Kroah-Hartman tty_ldisc_deref(ld); 80096fd7ce5SGreg Kroah-Hartman } 80196fd7ce5SGreg Kroah-Hartman /* 80296fd7ce5SGreg Kroah-Hartman * FIXME: Once we trust the LDISC code better we can wait here for 80396fd7ce5SGreg Kroah-Hartman * ldisc completion and fix the driver call race 80496fd7ce5SGreg Kroah-Hartman */ 80596fd7ce5SGreg Kroah-Hartman wake_up_interruptible_poll(&tty->write_wait, POLLOUT); 80696fd7ce5SGreg Kroah-Hartman wake_up_interruptible_poll(&tty->read_wait, POLLIN); 80796fd7ce5SGreg Kroah-Hartman /* 80896fd7ce5SGreg Kroah-Hartman * Shutdown the current line discipline, and reset it to 80996fd7ce5SGreg Kroah-Hartman * N_TTY if need be. 81096fd7ce5SGreg Kroah-Hartman * 81196fd7ce5SGreg Kroah-Hartman * Avoid racing set_ldisc or tty_ldisc_release 81296fd7ce5SGreg Kroah-Hartman */ 81396fd7ce5SGreg Kroah-Hartman mutex_lock(&tty->ldisc_mutex); 81496fd7ce5SGreg Kroah-Hartman 81596fd7ce5SGreg Kroah-Hartman /* 81696fd7ce5SGreg Kroah-Hartman * this is like tty_ldisc_halt, but we need to give up 817f23eb2b2SLinus Torvalds * the BTM before calling cancel_work_sync, which may 818f23eb2b2SLinus Torvalds * need to wait for another function taking the BTM 81996fd7ce5SGreg Kroah-Hartman */ 82096fd7ce5SGreg Kroah-Hartman clear_bit(TTY_LDISC, &tty->flags); 82189c8d91eSAlan Cox tty_unlock(tty); 822ecbbfd44SJiri Slaby cancel_work_sync(&tty->port->buf.work); 82396fd7ce5SGreg Kroah-Hartman mutex_unlock(&tty->ldisc_mutex); 8240c73c08eSJiri Slaby retry: 82589c8d91eSAlan Cox tty_lock(tty); 82696fd7ce5SGreg Kroah-Hartman mutex_lock(&tty->ldisc_mutex); 82796fd7ce5SGreg Kroah-Hartman 82896fd7ce5SGreg Kroah-Hartman /* At this point we have a closed ldisc and we want to 82996fd7ce5SGreg Kroah-Hartman reopen it. We could defer this to the next open but 83096fd7ce5SGreg Kroah-Hartman it means auditing a lot of other paths so this is 83196fd7ce5SGreg Kroah-Hartman a FIXME */ 83296fd7ce5SGreg Kroah-Hartman if (tty->ldisc) { /* Not yet closed */ 8330c73c08eSJiri Slaby if (atomic_read(&tty->ldisc->users) != 1) { 8340c73c08eSJiri Slaby char cur_n[TASK_COMM_LEN], tty_n[64]; 8350c73c08eSJiri Slaby long timeout = 3 * HZ; 83689c8d91eSAlan Cox tty_unlock(tty); 8370c73c08eSJiri Slaby 8380c73c08eSJiri Slaby while (tty_ldisc_wait_idle(tty, timeout) == -EBUSY) { 8390c73c08eSJiri Slaby timeout = MAX_SCHEDULE_TIMEOUT; 8400c73c08eSJiri Slaby printk_ratelimited(KERN_WARNING 8410c73c08eSJiri Slaby "%s: waiting (%s) for %s took too long, but we keep waiting...\n", 8420c73c08eSJiri Slaby __func__, get_task_comm(cur_n, current), 8430c73c08eSJiri Slaby tty_name(tty, tty_n)); 8440c73c08eSJiri Slaby } 8450c73c08eSJiri Slaby mutex_unlock(&tty->ldisc_mutex); 8460c73c08eSJiri Slaby goto retry; 8470c73c08eSJiri Slaby } 84830042072SJiri Slaby 84996fd7ce5SGreg Kroah-Hartman if (reset == 0) { 8501c95ba1eSPhilippe Rétornaz 851adc8d746SAlan Cox if (!tty_ldisc_reinit(tty, tty->termios.c_line)) 85296fd7ce5SGreg Kroah-Hartman err = tty_ldisc_open(tty, tty->ldisc); 8531c95ba1eSPhilippe Rétornaz else 8541c95ba1eSPhilippe Rétornaz err = 1; 85596fd7ce5SGreg Kroah-Hartman } 85696fd7ce5SGreg Kroah-Hartman /* If the re-open fails or we reset then go to N_TTY. The 85796fd7ce5SGreg Kroah-Hartman N_TTY open cannot fail */ 85896fd7ce5SGreg Kroah-Hartman if (reset || err) { 8591c95ba1eSPhilippe Rétornaz BUG_ON(tty_ldisc_reinit(tty, N_TTY)); 86096fd7ce5SGreg Kroah-Hartman WARN_ON(tty_ldisc_open(tty, tty->ldisc)); 86196fd7ce5SGreg Kroah-Hartman } 86296fd7ce5SGreg Kroah-Hartman tty_ldisc_enable(tty); 86396fd7ce5SGreg Kroah-Hartman } 86496fd7ce5SGreg Kroah-Hartman mutex_unlock(&tty->ldisc_mutex); 86596fd7ce5SGreg Kroah-Hartman if (reset) 86696fd7ce5SGreg Kroah-Hartman tty_reset_termios(tty); 86796fd7ce5SGreg Kroah-Hartman } 86896fd7ce5SGreg Kroah-Hartman 86996fd7ce5SGreg Kroah-Hartman /** 87096fd7ce5SGreg Kroah-Hartman * tty_ldisc_setup - open line discipline 87196fd7ce5SGreg Kroah-Hartman * @tty: tty being shut down 87296fd7ce5SGreg Kroah-Hartman * @o_tty: pair tty for pty/tty pairs 87396fd7ce5SGreg Kroah-Hartman * 87496fd7ce5SGreg Kroah-Hartman * Called during the initial open of a tty/pty pair in order to set up the 87596fd7ce5SGreg Kroah-Hartman * line disciplines and bind them to the tty. This has no locking issues 87696fd7ce5SGreg Kroah-Hartman * as the device isn't yet active. 87796fd7ce5SGreg Kroah-Hartman */ 87896fd7ce5SGreg Kroah-Hartman 87996fd7ce5SGreg Kroah-Hartman int tty_ldisc_setup(struct tty_struct *tty, struct tty_struct *o_tty) 88096fd7ce5SGreg Kroah-Hartman { 88196fd7ce5SGreg Kroah-Hartman struct tty_ldisc *ld = tty->ldisc; 88296fd7ce5SGreg Kroah-Hartman int retval; 88396fd7ce5SGreg Kroah-Hartman 88496fd7ce5SGreg Kroah-Hartman retval = tty_ldisc_open(tty, ld); 88596fd7ce5SGreg Kroah-Hartman if (retval) 88696fd7ce5SGreg Kroah-Hartman return retval; 88796fd7ce5SGreg Kroah-Hartman 88896fd7ce5SGreg Kroah-Hartman if (o_tty) { 88996fd7ce5SGreg Kroah-Hartman retval = tty_ldisc_open(o_tty, o_tty->ldisc); 89096fd7ce5SGreg Kroah-Hartman if (retval) { 89196fd7ce5SGreg Kroah-Hartman tty_ldisc_close(tty, ld); 89296fd7ce5SGreg Kroah-Hartman return retval; 89396fd7ce5SGreg Kroah-Hartman } 89496fd7ce5SGreg Kroah-Hartman tty_ldisc_enable(o_tty); 89596fd7ce5SGreg Kroah-Hartman } 89696fd7ce5SGreg Kroah-Hartman tty_ldisc_enable(tty); 89796fd7ce5SGreg Kroah-Hartman return 0; 89896fd7ce5SGreg Kroah-Hartman } 89989c8d91eSAlan Cox 90089c8d91eSAlan Cox static void tty_ldisc_kill(struct tty_struct *tty) 90189c8d91eSAlan Cox { 90231e12128SJiri Slaby /* There cannot be users from userspace now. But there still might be 90331e12128SJiri Slaby * drivers holding a reference via tty_ldisc_ref. Do not steal them the 90431e12128SJiri Slaby * ldisc until they are done. */ 90531e12128SJiri Slaby tty_ldisc_wait_idle(tty, MAX_SCHEDULE_TIMEOUT); 90631e12128SJiri Slaby 90789c8d91eSAlan Cox mutex_lock(&tty->ldisc_mutex); 90889c8d91eSAlan Cox /* 90989c8d91eSAlan Cox * Now kill off the ldisc 91089c8d91eSAlan Cox */ 91189c8d91eSAlan Cox tty_ldisc_close(tty, tty->ldisc); 91289c8d91eSAlan Cox tty_ldisc_put(tty->ldisc); 91389c8d91eSAlan Cox /* Force an oops if we mess this up */ 91489c8d91eSAlan Cox tty->ldisc = NULL; 91589c8d91eSAlan Cox 91689c8d91eSAlan Cox /* Ensure the next open requests the N_TTY ldisc */ 91789c8d91eSAlan Cox tty_set_termios_ldisc(tty, N_TTY); 91889c8d91eSAlan Cox mutex_unlock(&tty->ldisc_mutex); 91989c8d91eSAlan Cox } 92089c8d91eSAlan Cox 92196fd7ce5SGreg Kroah-Hartman /** 92296fd7ce5SGreg Kroah-Hartman * tty_ldisc_release - release line discipline 92396fd7ce5SGreg Kroah-Hartman * @tty: tty being shut down 92496fd7ce5SGreg Kroah-Hartman * @o_tty: pair tty for pty/tty pairs 92596fd7ce5SGreg Kroah-Hartman * 92696fd7ce5SGreg Kroah-Hartman * Called during the final close of a tty/pty pair in order to shut down 92796fd7ce5SGreg Kroah-Hartman * the line discpline layer. On exit the ldisc assigned is N_TTY and the 92896fd7ce5SGreg Kroah-Hartman * ldisc has not been opened. 92996fd7ce5SGreg Kroah-Hartman */ 93096fd7ce5SGreg Kroah-Hartman 93196fd7ce5SGreg Kroah-Hartman void tty_ldisc_release(struct tty_struct *tty, struct tty_struct *o_tty) 93296fd7ce5SGreg Kroah-Hartman { 93396fd7ce5SGreg Kroah-Hartman /* 93496fd7ce5SGreg Kroah-Hartman * Prevent flush_to_ldisc() from rescheduling the work for later. Then 93596fd7ce5SGreg Kroah-Hartman * kill any delayed work. As this is the final close it does not 93696fd7ce5SGreg Kroah-Hartman * race with the set_ldisc code path. 93796fd7ce5SGreg Kroah-Hartman */ 93896fd7ce5SGreg Kroah-Hartman 93989c8d91eSAlan Cox tty_lock_pair(tty, o_tty); 94096fd7ce5SGreg Kroah-Hartman tty_ldisc_halt(tty); 9410a1f1a0bSTejun Heo tty_ldisc_flush_works(tty); 94289c8d91eSAlan Cox if (o_tty) { 94389c8d91eSAlan Cox tty_ldisc_halt(o_tty); 94489c8d91eSAlan Cox tty_ldisc_flush_works(o_tty); 94589c8d91eSAlan Cox } 946d155255aSAlan Cox 9476d31a88cSAlan Cox /* This will need doing differently if we need to lock */ 94889c8d91eSAlan Cox tty_ldisc_kill(tty); 94996fd7ce5SGreg Kroah-Hartman 95089c8d91eSAlan Cox if (o_tty) 95189c8d91eSAlan Cox tty_ldisc_kill(o_tty); 95289c8d91eSAlan Cox 95389c8d91eSAlan Cox tty_unlock_pair(tty, o_tty); 95496fd7ce5SGreg Kroah-Hartman /* And the memory resources remaining (buffers, termios) will be 95596fd7ce5SGreg Kroah-Hartman disposed of when the kref hits zero */ 95696fd7ce5SGreg Kroah-Hartman } 95796fd7ce5SGreg Kroah-Hartman 95896fd7ce5SGreg Kroah-Hartman /** 95996fd7ce5SGreg Kroah-Hartman * tty_ldisc_init - ldisc setup for new tty 96096fd7ce5SGreg Kroah-Hartman * @tty: tty being allocated 96196fd7ce5SGreg Kroah-Hartman * 96296fd7ce5SGreg Kroah-Hartman * Set up the line discipline objects for a newly allocated tty. Note that 96396fd7ce5SGreg Kroah-Hartman * the tty structure is not completely set up when this call is made. 96496fd7ce5SGreg Kroah-Hartman */ 96596fd7ce5SGreg Kroah-Hartman 96696fd7ce5SGreg Kroah-Hartman void tty_ldisc_init(struct tty_struct *tty) 96796fd7ce5SGreg Kroah-Hartman { 96896fd7ce5SGreg Kroah-Hartman struct tty_ldisc *ld = tty_ldisc_get(N_TTY); 96996fd7ce5SGreg Kroah-Hartman if (IS_ERR(ld)) 97096fd7ce5SGreg Kroah-Hartman panic("n_tty: init_tty"); 97196fd7ce5SGreg Kroah-Hartman tty_ldisc_assign(tty, ld); 97296fd7ce5SGreg Kroah-Hartman } 97396fd7ce5SGreg Kroah-Hartman 9746716671dSJiri Slaby /** 9756716671dSJiri Slaby * tty_ldisc_init - ldisc cleanup for new tty 9766716671dSJiri Slaby * @tty: tty that was allocated recently 9776716671dSJiri Slaby * 9786716671dSJiri Slaby * The tty structure must not becompletely set up (tty_ldisc_setup) when 9796716671dSJiri Slaby * this call is made. 9806716671dSJiri Slaby */ 9816716671dSJiri Slaby void tty_ldisc_deinit(struct tty_struct *tty) 9826716671dSJiri Slaby { 9836716671dSJiri Slaby put_ldisc(tty->ldisc); 9846716671dSJiri Slaby tty_ldisc_assign(tty, NULL); 9856716671dSJiri Slaby } 9866716671dSJiri Slaby 98796fd7ce5SGreg Kroah-Hartman void tty_ldisc_begin(void) 98896fd7ce5SGreg Kroah-Hartman { 98996fd7ce5SGreg Kroah-Hartman /* Setup the default TTY line discipline. */ 99096fd7ce5SGreg Kroah-Hartman (void) tty_register_ldisc(N_TTY, &tty_ldisc_N_TTY); 99196fd7ce5SGreg Kroah-Hartman } 992