974 lines · 23.4 KB · C
RawDownload
#include <linux/types.h>#include <linux/errno.h>#include <linux/kmod.h>#include <linux/sched.h>#include <linux/interrupt.h>#include <linux/tty.h>#include <linux/tty_driver.h>#include <linux/file.h>#include <linux/mm.h>#include <linux/string.h>#include <linux/slab.h>#include <linux/poll.h>#include <linux/proc_fs.h>#include <linux/init.h>#include <linux/module.h>#include <linux/device.h>#include <linux/wait.h>#include <linux/bitops.h>#include <linux/seq_file.h>#include <linux/uaccess.h>#include <linux/ratelimit.h> /* *	This guards the refcounted line discipline lists. The lock *	must be taken with irqs off because there are hangup path *	callers who will do ldisc lookups and cannot sleep. */ static DEFINE_SPINLOCK(tty_ldisc_lock);static DECLARE_WAIT_QUEUE_HEAD(tty_ldisc_wait);/* Line disc dispatch table */static struct tty_ldisc_ops *tty_ldiscs[NR_LDISCS]; static inline struct tty_ldisc *get_ldisc(struct tty_ldisc *ld){	if (ld)		atomic_inc(&ld->users);	return ld;} static void put_ldisc(struct tty_ldisc *ld){	unsigned long flags; 	if (WARN_ON_ONCE(!ld))		return; 	/*	 * If this is the last user, free the ldisc, and	 * release the ldisc ops.	 *	 * We really want an "atomic_dec_and_lock_irqsave()",	 * but we don't have it, so this does it by hand.	 */	local_irq_save(flags);	if (atomic_dec_and_lock(&ld->users, &tty_ldisc_lock)) {		struct tty_ldisc_ops *ldo = ld->ops; 		ldo->refcount--;		module_put(ldo->owner);		spin_unlock_irqrestore(&tty_ldisc_lock, flags); 		kfree(ld);		return;	}	local_irq_restore(flags);	wake_up(&ld->wq_idle);} /** *	tty_register_ldisc	-	install a line discipline *	@disc: ldisc number *	@new_ldisc: pointer to the ldisc object * *	Installs a new line discipline into the kernel. The discipline *	is set up as unreferenced and then made available to the kernel *	from this point onwards. * *	Locking: *		takes tty_ldisc_lock to guard against ldisc races */ int tty_register_ldisc(int disc, struct tty_ldisc_ops *new_ldisc){	unsigned long flags;	int ret = 0; 	if (disc < N_TTY || disc >= NR_LDISCS)		return -EINVAL; 	spin_lock_irqsave(&tty_ldisc_lock, flags);	tty_ldiscs[disc] = new_ldisc;	new_ldisc->num = disc;	new_ldisc->refcount = 0;	spin_unlock_irqrestore(&tty_ldisc_lock, flags); 	return ret;}EXPORT_SYMBOL(tty_register_ldisc); /** *	tty_unregister_ldisc	-	unload a line discipline *	@disc: ldisc number *	@new_ldisc: pointer to the ldisc object * *	Remove a line discipline from the kernel providing it is not *	currently in use. * *	Locking: *		takes tty_ldisc_lock to guard against ldisc races */ int tty_unregister_ldisc(int disc){	unsigned long flags;	int ret = 0; 	if (disc < N_TTY || disc >= NR_LDISCS)		return -EINVAL; 	spin_lock_irqsave(&tty_ldisc_lock, flags);	if (tty_ldiscs[disc]->refcount)		ret = -EBUSY;	else		tty_ldiscs[disc] = NULL;	spin_unlock_irqrestore(&tty_ldisc_lock, flags); 	return ret;}EXPORT_SYMBOL(tty_unregister_ldisc); static struct tty_ldisc_ops *get_ldops(int disc){	unsigned long flags;	struct tty_ldisc_ops *ldops, *ret; 	spin_lock_irqsave(&tty_ldisc_lock, flags);	ret = ERR_PTR(-EINVAL);	ldops = tty_ldiscs[disc];	if (ldops) {		ret = ERR_PTR(-EAGAIN);		if (try_module_get(ldops->owner)) {			ldops->refcount++;			ret = ldops;		}	}	spin_unlock_irqrestore(&tty_ldisc_lock, flags);	return ret;} static void put_ldops(struct tty_ldisc_ops *ldops){	unsigned long flags; 	spin_lock_irqsave(&tty_ldisc_lock, flags);	ldops->refcount--;	module_put(ldops->owner);	spin_unlock_irqrestore(&tty_ldisc_lock, flags);} /** *	tty_ldisc_get		-	take a reference to an ldisc *	@disc: ldisc number * *	Takes a reference to a line discipline. Deals with refcounts and *	module locking counts. Returns NULL if the discipline is not available. *	Returns a pointer to the discipline and bumps the ref count if it is *	available * *	Locking: *		takes tty_ldisc_lock to guard against ldisc races */ static struct tty_ldisc *tty_ldisc_get(int disc){	struct tty_ldisc *ld;	struct tty_ldisc_ops *ldops; 	if (disc < N_TTY || disc >= NR_LDISCS)		return ERR_PTR(-EINVAL); 	/*	 * Get the ldisc ops - we may need to request them to be loaded	 * dynamically and try again.	 */	ldops = get_ldops(disc);	if (IS_ERR(ldops)) {		request_module("tty-ldisc-%d", disc);		ldops = get_ldops(disc);		if (IS_ERR(ldops))			return ERR_CAST(ldops);	} 	ld = kmalloc(sizeof(struct tty_ldisc), GFP_KERNEL);	if (ld == NULL) {		put_ldops(ldops);		return ERR_PTR(-ENOMEM);	} 	ld->ops = ldops;	atomic_set(&ld->users, 1);	init_waitqueue_head(&ld->wq_idle); 	return ld;} static void *tty_ldiscs_seq_start(struct seq_file *m, loff_t *pos){	return (*pos < NR_LDISCS) ? pos : NULL;} static void *tty_ldiscs_seq_next(struct seq_file *m, void *v, loff_t *pos){	(*pos)++;	return (*pos < NR_LDISCS) ? pos : NULL;} static void tty_ldiscs_seq_stop(struct seq_file *m, void *v){} static int tty_ldiscs_seq_show(struct seq_file *m, void *v){	int i = *(loff_t *)v;	struct tty_ldisc_ops *ldops; 	ldops = get_ldops(i);	if (IS_ERR(ldops))		return 0;	seq_printf(m, "%-10s %2d\n", ldops->name ? ldops->name : "???", i);	put_ldops(ldops);	return 0;} static const struct seq_operations tty_ldiscs_seq_ops = {	.start	= tty_ldiscs_seq_start,	.next	= tty_ldiscs_seq_next,	.stop	= tty_ldiscs_seq_stop,	.show	= tty_ldiscs_seq_show,}; static int proc_tty_ldiscs_open(struct inode *inode, struct file *file){	return seq_open(file, &tty_ldiscs_seq_ops);} const struct file_operations tty_ldiscs_proc_fops = {	.owner		= THIS_MODULE,	.open		= proc_tty_ldiscs_open,	.read		= seq_read,	.llseek		= seq_lseek,	.release	= seq_release,}; /** *	tty_ldisc_assign	-	set ldisc on a tty *	@tty: tty to assign *	@ld: line discipline * *	Install an instance of a line discipline into a tty structure. The *	ldisc must have a reference count above zero to ensure it remains. *	The tty instance refcount starts at zero. * *	Locking: *		Caller must hold references */ static void tty_ldisc_assign(struct tty_struct *tty, struct tty_ldisc *ld){	tty->ldisc = ld;} /** *	tty_ldisc_try		-	internal helper *	@tty: the tty * *	Make a single attempt to grab and bump the refcount on *	the tty ldisc. Return 0 on failure or 1 on success. This is *	used to implement both the waiting and non waiting versions *	of tty_ldisc_ref * *	Locking: takes tty_ldisc_lock */ static struct tty_ldisc *tty_ldisc_try(struct tty_struct *tty){	unsigned long flags;	struct tty_ldisc *ld; 	spin_lock_irqsave(&tty_ldisc_lock, flags);	ld = NULL;	if (test_bit(TTY_LDISC, &tty->flags))		ld = get_ldisc(tty->ldisc);	spin_unlock_irqrestore(&tty_ldisc_lock, flags);	return ld;} /** *	tty_ldisc_ref_wait	-	wait for the tty ldisc *	@tty: tty device * *	Dereference the line discipline for the terminal and take a *	reference to it. If the line discipline is in flux then *	wait patiently until it changes. * *	Note: Must not be called from an IRQ/timer context. The caller *	must also be careful not to hold other locks that will deadlock *	against a discipline change, such as an existing ldisc reference *	(which we check for) * *	Locking: call functions take tty_ldisc_lock */ struct tty_ldisc *tty_ldisc_ref_wait(struct tty_struct *tty){	struct tty_ldisc *ld; 	/* wait_event is a macro */	wait_event(tty_ldisc_wait, (ld = tty_ldisc_try(tty)) != NULL);	return ld;}EXPORT_SYMBOL_GPL(tty_ldisc_ref_wait); /** *	tty_ldisc_ref		-	get the tty ldisc *	@tty: tty device * *	Dereference the line discipline for the terminal and take a *	reference to it. If the line discipline is in flux then *	return NULL. Can be called from IRQ and timer functions. * *	Locking: called functions take tty_ldisc_lock */ struct tty_ldisc *tty_ldisc_ref(struct tty_struct *tty){	return tty_ldisc_try(tty);}EXPORT_SYMBOL_GPL(tty_ldisc_ref); /** *	tty_ldisc_deref		-	free a tty ldisc reference *	@ld: reference to free up * *	Undoes the effect of tty_ldisc_ref or tty_ldisc_ref_wait. May *	be called in IRQ context. * *	Locking: takes tty_ldisc_lock */ void tty_ldisc_deref(struct tty_ldisc *ld){	put_ldisc(ld);}EXPORT_SYMBOL_GPL(tty_ldisc_deref); static inline void tty_ldisc_put(struct tty_ldisc *ld){	put_ldisc(ld);} /** *	tty_ldisc_enable	-	allow ldisc use *	@tty: terminal to activate ldisc on * *	Set the TTY_LDISC flag when the line discipline can be called *	again. Do necessary wakeups for existing sleepers. Clear the LDISC *	changing flag to indicate any ldisc change is now over. * *	Note: nobody should set the TTY_LDISC bit except via this function. *	Clearing directly is allowed. */ void tty_ldisc_enable(struct tty_struct *tty){	set_bit(TTY_LDISC, &tty->flags);	clear_bit(TTY_LDISC_CHANGING, &tty->flags);	wake_up(&tty_ldisc_wait);} /** *	tty_ldisc_flush	-	flush line discipline queue *	@tty: tty * *	Flush the line discipline queue (if any) for this tty. If there *	is no line discipline active this is a no-op. */ void tty_ldisc_flush(struct tty_struct *tty){	struct tty_ldisc *ld = tty_ldisc_ref(tty);	if (ld) {		if (ld->ops->flush_buffer)			ld->ops->flush_buffer(tty);		tty_ldisc_deref(ld);	}	tty_buffer_flush(tty);}EXPORT_SYMBOL_GPL(tty_ldisc_flush); /** *	tty_set_termios_ldisc		-	set ldisc field *	@tty: tty structure *	@num: line discipline number * *	This is probably overkill for real world processors but *	they are not on hot paths so a little discipline won't do *	any harm. * *	Locking: takes termios_mutex */ static void tty_set_termios_ldisc(struct tty_struct *tty, int num){	mutex_lock(&tty->termios_mutex);	tty->termios->c_line = num;	mutex_unlock(&tty->termios_mutex);} /** *	tty_ldisc_open		-	open a line discipline *	@tty: tty we are opening the ldisc on *	@ld: discipline to open * *	A helper opening method. Also a convenient debugging and check *	point. * *	Locking: always called with BTM already held. */ static int tty_ldisc_open(struct tty_struct *tty, struct tty_ldisc *ld){	WARN_ON(test_and_set_bit(TTY_LDISC_OPEN, &tty->flags));	if (ld->ops->open) {		int ret;                /* BTM here locks versus a hangup event */		ret = ld->ops->open(tty);		if (ret)			clear_bit(TTY_LDISC_OPEN, &tty->flags);		return ret;	}	return 0;} /** *	tty_ldisc_close		-	close a line discipline *	@tty: tty we are opening the ldisc on *	@ld: discipline to close * *	A helper close method. Also a convenient debugging and check *	point. */ static void tty_ldisc_close(struct tty_struct *tty, struct tty_ldisc *ld){	WARN_ON(!test_bit(TTY_LDISC_OPEN, &tty->flags));	clear_bit(TTY_LDISC_OPEN, &tty->flags);	if (ld->ops->close)		ld->ops->close(tty);} /** *	tty_ldisc_restore	-	helper for tty ldisc change *	@tty: tty to recover *	@old: previous ldisc * *	Restore the previous line discipline or N_TTY when a line discipline *	change fails due to an open error */ static void tty_ldisc_restore(struct tty_struct *tty, struct tty_ldisc *old){	char buf[64];	struct tty_ldisc *new_ldisc;	int r; 	/* There is an outstanding reference here so this is safe */	old = tty_ldisc_get(old->ops->num);	WARN_ON(IS_ERR(old));	tty_ldisc_assign(tty, old);	tty_set_termios_ldisc(tty, old->ops->num);	if (tty_ldisc_open(tty, old) < 0) {		tty_ldisc_put(old);		/* This driver is always present */		new_ldisc = tty_ldisc_get(N_TTY);		if (IS_ERR(new_ldisc))			panic("n_tty: get");		tty_ldisc_assign(tty, new_ldisc);		tty_set_termios_ldisc(tty, N_TTY);		r = tty_ldisc_open(tty, new_ldisc);		if (r < 0)			panic("Couldn't open N_TTY ldisc for "			      "%s --- error %d.",			      tty_name(tty, buf), r);	}} /** *	tty_ldisc_halt		-	shut down the line discipline *	@tty: tty device

Lines 1–500 of 974.

Keyboard shortcuts

General

Show keyboard shortcuts
?
Focus the current search
/

Issues and pull requests

Open filters
f

Issues, pull requests and Inbox

Select next item
j↓
Select previous item
k↑
Open selected item
Enter
Dismiss filters or clear selection
Esc

Repository code

Go to file
t