tty_ioctl.c revision 579a00a5c2f0a85fb4602a53e2c1beb77a646528
1/*
2 *  Copyright (C) 1991, 1992, 1993, 1994  Linus Torvalds
3 *
4 * Modified by Fred N. van Kempen, 01/29/93, to add line disciplines
5 * which can be dynamically activated and de-activated by the line
6 * discipline handling modules (like SLIP).
7 */
8
9#include <linux/types.h>
10#include <linux/termios.h>
11#include <linux/errno.h>
12#include <linux/sched.h>
13#include <linux/kernel.h>
14#include <linux/major.h>
15#include <linux/tty.h>
16#include <linux/fcntl.h>
17#include <linux/string.h>
18#include <linux/mm.h>
19#include <linux/module.h>
20#include <linux/bitops.h>
21#include <linux/mutex.h>
22#include <linux/compat.h>
23
24#include <asm/io.h>
25#include <asm/uaccess.h>
26
27#undef TTY_DEBUG_WAIT_UNTIL_SENT
28
29#undef	DEBUG
30
31/*
32 * Internal flag options for termios setting behavior
33 */
34#define TERMIOS_FLUSH	1
35#define TERMIOS_WAIT	2
36#define TERMIOS_TERMIO	4
37#define TERMIOS_OLD	8
38
39
40/**
41 *	tty_chars_in_buffer	-	characters pending
42 *	@tty: terminal
43 *
44 *	Return the number of bytes of data in the device private
45 *	output queue. If no private method is supplied there is assumed
46 *	to be no queue on the device.
47 */
48
49int tty_chars_in_buffer(struct tty_struct *tty)
50{
51	if (tty->ops->chars_in_buffer)
52		return tty->ops->chars_in_buffer(tty);
53	else
54		return 0;
55}
56EXPORT_SYMBOL(tty_chars_in_buffer);
57
58/**
59 *	tty_write_room		-	write queue space
60 *	@tty: terminal
61 *
62 *	Return the number of bytes that can be queued to this device
63 *	at the present time. The result should be treated as a guarantee
64 *	and the driver cannot offer a value it later shrinks by more than
65 *	the number of bytes written. If no method is provided 2K is always
66 *	returned and data may be lost as there will be no flow control.
67 */
68
69int tty_write_room(struct tty_struct *tty)
70{
71	if (tty->ops->write_room)
72		return tty->ops->write_room(tty);
73	return 2048;
74}
75EXPORT_SYMBOL(tty_write_room);
76
77/**
78 *	tty_driver_flush_buffer	-	discard internal buffer
79 *	@tty: terminal
80 *
81 *	Discard the internal output buffer for this device. If no method
82 *	is provided then either the buffer cannot be hardware flushed or
83 *	there is no buffer driver side.
84 */
85void tty_driver_flush_buffer(struct tty_struct *tty)
86{
87	if (tty->ops->flush_buffer)
88		tty->ops->flush_buffer(tty);
89}
90EXPORT_SYMBOL(tty_driver_flush_buffer);
91
92/**
93 *	tty_throttle		-	flow control
94 *	@tty: terminal
95 *
96 *	Indicate that a tty should stop transmitting data down the stack.
97 *	Takes the termios mutex to protect against parallel throttle/unthrottle
98 *	and also to ensure the driver can consistently reference its own
99 *	termios data at this point when implementing software flow control.
100 */
101
102void tty_throttle(struct tty_struct *tty)
103{
104	mutex_lock(&tty->termios_mutex);
105	/* check TTY_THROTTLED first so it indicates our state */
106	if (!test_and_set_bit(TTY_THROTTLED, &tty->flags) &&
107	    tty->ops->throttle)
108		tty->ops->throttle(tty);
109	tty->flow_change = 0;
110	mutex_unlock(&tty->termios_mutex);
111}
112EXPORT_SYMBOL(tty_throttle);
113
114/**
115 *	tty_unthrottle		-	flow control
116 *	@tty: terminal
117 *
118 *	Indicate that a tty may continue transmitting data down the stack.
119 *	Takes the termios mutex to protect against parallel throttle/unthrottle
120 *	and also to ensure the driver can consistently reference its own
121 *	termios data at this point when implementing software flow control.
122 *
123 *	Drivers should however remember that the stack can issue a throttle,
124 *	then change flow control method, then unthrottle.
125 */
126
127void tty_unthrottle(struct tty_struct *tty)
128{
129	mutex_lock(&tty->termios_mutex);
130	if (test_and_clear_bit(TTY_THROTTLED, &tty->flags) &&
131	    tty->ops->unthrottle)
132		tty->ops->unthrottle(tty);
133	tty->flow_change = 0;
134	mutex_unlock(&tty->termios_mutex);
135}
136EXPORT_SYMBOL(tty_unthrottle);
137
138/**
139 *	tty_throttle_safe	-	flow control
140 *	@tty: terminal
141 *
142 *	Similar to tty_throttle() but will only attempt throttle
143 *	if tty->flow_change is TTY_THROTTLE_SAFE. Prevents an accidental
144 *	throttle due to race conditions when throttling is conditional
145 *	on factors evaluated prior to throttling.
146 *
147 *	Returns 0 if tty is throttled (or was already throttled)
148 */
149
150int tty_throttle_safe(struct tty_struct *tty)
151{
152	int ret = 0;
153
154	mutex_lock(&tty->termios_mutex);
155	if (!test_bit(TTY_THROTTLED, &tty->flags)) {
156		if (tty->flow_change != TTY_THROTTLE_SAFE)
157			ret = 1;
158		else {
159			set_bit(TTY_THROTTLED, &tty->flags);
160			if (tty->ops->throttle)
161				tty->ops->throttle(tty);
162		}
163	}
164	mutex_unlock(&tty->termios_mutex);
165
166	return ret;
167}
168
169/**
170 *	tty_unthrottle_safe	-	flow control
171 *	@tty: terminal
172 *
173 *	Similar to tty_unthrottle() but will only attempt unthrottle
174 *	if tty->flow_change is TTY_UNTHROTTLE_SAFE. Prevents an accidental
175 *	unthrottle due to race conditions when unthrottling is conditional
176 *	on factors evaluated prior to unthrottling.
177 *
178 *	Returns 0 if tty is unthrottled (or was already unthrottled)
179 */
180
181int tty_unthrottle_safe(struct tty_struct *tty)
182{
183	int ret = 0;
184
185	mutex_lock(&tty->termios_mutex);
186	if (test_bit(TTY_THROTTLED, &tty->flags)) {
187		if (tty->flow_change != TTY_UNTHROTTLE_SAFE)
188			ret = 1;
189		else {
190			clear_bit(TTY_THROTTLED, &tty->flags);
191			if (tty->ops->unthrottle)
192				tty->ops->unthrottle(tty);
193		}
194	}
195	mutex_unlock(&tty->termios_mutex);
196
197	return ret;
198}
199
200/**
201 *	tty_wait_until_sent	-	wait for I/O to finish
202 *	@tty: tty we are waiting for
203 *	@timeout: how long we will wait
204 *
205 *	Wait for characters pending in a tty driver to hit the wire, or
206 *	for a timeout to occur (eg due to flow control)
207 *
208 *	Locking: none
209 */
210
211void tty_wait_until_sent(struct tty_struct *tty, long timeout)
212{
213#ifdef TTY_DEBUG_WAIT_UNTIL_SENT
214	char buf[64];
215
216	printk(KERN_DEBUG "%s wait until sent...\n", tty_name(tty, buf));
217#endif
218	if (!timeout)
219		timeout = MAX_SCHEDULE_TIMEOUT;
220	if (wait_event_interruptible_timeout(tty->write_wait,
221			!tty_chars_in_buffer(tty), timeout) >= 0) {
222		if (tty->ops->wait_until_sent)
223			tty->ops->wait_until_sent(tty, timeout);
224	}
225}
226EXPORT_SYMBOL(tty_wait_until_sent);
227
228
229/*
230 *		Termios Helper Methods
231 */
232
233static void unset_locked_termios(struct ktermios *termios,
234				 struct ktermios *old,
235				 struct ktermios *locked)
236{
237	int	i;
238
239#define NOSET_MASK(x, y, z) (x = ((x) & ~(z)) | ((y) & (z)))
240
241	if (!locked) {
242		printk(KERN_WARNING "Warning?!? termios_locked is NULL.\n");
243		return;
244	}
245
246	NOSET_MASK(termios->c_iflag, old->c_iflag, locked->c_iflag);
247	NOSET_MASK(termios->c_oflag, old->c_oflag, locked->c_oflag);
248	NOSET_MASK(termios->c_cflag, old->c_cflag, locked->c_cflag);
249	NOSET_MASK(termios->c_lflag, old->c_lflag, locked->c_lflag);
250	termios->c_line = locked->c_line ? old->c_line : termios->c_line;
251	for (i = 0; i < NCCS; i++)
252		termios->c_cc[i] = locked->c_cc[i] ?
253			old->c_cc[i] : termios->c_cc[i];
254	/* FIXME: What should we do for i/ospeed */
255}
256
257/*
258 * Routine which returns the baud rate of the tty
259 *
260 * Note that the baud_table needs to be kept in sync with the
261 * include/asm/termbits.h file.
262 */
263static const speed_t baud_table[] = {
264	0, 50, 75, 110, 134, 150, 200, 300, 600, 1200, 1800, 2400, 4800,
265	9600, 19200, 38400, 57600, 115200, 230400, 460800,
266#ifdef __sparc__
267	76800, 153600, 307200, 614400, 921600
268#else
269	500000, 576000, 921600, 1000000, 1152000, 1500000, 2000000,
270	2500000, 3000000, 3500000, 4000000
271#endif
272};
273
274#ifndef __sparc__
275static const tcflag_t baud_bits[] = {
276	B0, B50, B75, B110, B134, B150, B200, B300, B600,
277	B1200, B1800, B2400, B4800, B9600, B19200, B38400,
278	B57600, B115200, B230400, B460800, B500000, B576000,
279	B921600, B1000000, B1152000, B1500000, B2000000, B2500000,
280	B3000000, B3500000, B4000000
281};
282#else
283static const tcflag_t baud_bits[] = {
284	B0, B50, B75, B110, B134, B150, B200, B300, B600,
285	B1200, B1800, B2400, B4800, B9600, B19200, B38400,
286	B57600, B115200, B230400, B460800, B76800, B153600,
287	B307200, B614400, B921600
288};
289#endif
290
291static int n_baud_table = ARRAY_SIZE(baud_table);
292
293/**
294 *	tty_termios_baud_rate
295 *	@termios: termios structure
296 *
297 *	Convert termios baud rate data into a speed. This should be called
298 *	with the termios lock held if this termios is a terminal termios
299 *	structure. May change the termios data. Device drivers can call this
300 *	function but should use ->c_[io]speed directly as they are updated.
301 *
302 *	Locking: none
303 */
304
305speed_t tty_termios_baud_rate(struct ktermios *termios)
306{
307	unsigned int cbaud;
308
309	cbaud = termios->c_cflag & CBAUD;
310
311#ifdef BOTHER
312	/* Magic token for arbitrary speed via c_ispeed/c_ospeed */
313	if (cbaud == BOTHER)
314		return termios->c_ospeed;
315#endif
316	if (cbaud & CBAUDEX) {
317		cbaud &= ~CBAUDEX;
318
319		if (cbaud < 1 || cbaud + 15 > n_baud_table)
320			termios->c_cflag &= ~CBAUDEX;
321		else
322			cbaud += 15;
323	}
324	return baud_table[cbaud];
325}
326EXPORT_SYMBOL(tty_termios_baud_rate);
327
328/**
329 *	tty_termios_input_baud_rate
330 *	@termios: termios structure
331 *
332 *	Convert termios baud rate data into a speed. This should be called
333 *	with the termios lock held if this termios is a terminal termios
334 *	structure. May change the termios data. Device drivers can call this
335 *	function but should use ->c_[io]speed directly as they are updated.
336 *
337 *	Locking: none
338 */
339
340speed_t tty_termios_input_baud_rate(struct ktermios *termios)
341{
342#ifdef IBSHIFT
343	unsigned int cbaud = (termios->c_cflag >> IBSHIFT) & CBAUD;
344
345	if (cbaud == B0)
346		return tty_termios_baud_rate(termios);
347
348	/* Magic token for arbitrary speed via c_ispeed*/
349	if (cbaud == BOTHER)
350		return termios->c_ispeed;
351
352	if (cbaud & CBAUDEX) {
353		cbaud &= ~CBAUDEX;
354
355		if (cbaud < 1 || cbaud + 15 > n_baud_table)
356			termios->c_cflag &= ~(CBAUDEX << IBSHIFT);
357		else
358			cbaud += 15;
359	}
360	return baud_table[cbaud];
361#else
362	return tty_termios_baud_rate(termios);
363#endif
364}
365EXPORT_SYMBOL(tty_termios_input_baud_rate);
366
367/**
368 *	tty_termios_encode_baud_rate
369 *	@termios: ktermios structure holding user requested state
370 *	@ispeed: input speed
371 *	@ospeed: output speed
372 *
373 *	Encode the speeds set into the passed termios structure. This is
374 *	used as a library helper for drivers so that they can report back
375 *	the actual speed selected when it differs from the speed requested
376 *
377 *	For maximal back compatibility with legacy SYS5/POSIX *nix behaviour
378 *	we need to carefully set the bits when the user does not get the
379 *	desired speed. We allow small margins and preserve as much of possible
380 *	of the input intent to keep compatibility.
381 *
382 *	Locking: Caller should hold termios lock. This is already held
383 *	when calling this function from the driver termios handler.
384 *
385 *	The ifdefs deal with platforms whose owners have yet to update them
386 *	and will all go away once this is done.
387 */
388
389void tty_termios_encode_baud_rate(struct ktermios *termios,
390				  speed_t ibaud, speed_t obaud)
391{
392	int i = 0;
393	int ifound = -1, ofound = -1;
394	int iclose = ibaud/50, oclose = obaud/50;
395	int ibinput = 0;
396
397	if (obaud == 0)			/* CD dropped 		  */
398		ibaud = 0;		/* Clear ibaud to be sure */
399
400	termios->c_ispeed = ibaud;
401	termios->c_ospeed = obaud;
402
403#ifdef BOTHER
404	/* If the user asked for a precise weird speed give a precise weird
405	   answer. If they asked for a Bfoo speed they many have problems
406	   digesting non-exact replies so fuzz a bit */
407
408	if ((termios->c_cflag & CBAUD) == BOTHER)
409		oclose = 0;
410	if (((termios->c_cflag >> IBSHIFT) & CBAUD) == BOTHER)
411		iclose = 0;
412	if ((termios->c_cflag >> IBSHIFT) & CBAUD)
413		ibinput = 1;	/* An input speed was specified */
414#endif
415	termios->c_cflag &= ~CBAUD;
416
417	/*
418	 *	Our goal is to find a close match to the standard baud rate
419	 *	returned. Walk the baud rate table and if we get a very close
420	 *	match then report back the speed as a POSIX Bxxxx value by
421	 *	preference
422	 */
423
424	do {
425		if (obaud - oclose <= baud_table[i] &&
426		    obaud + oclose >= baud_table[i]) {
427			termios->c_cflag |= baud_bits[i];
428			ofound = i;
429		}
430		if (ibaud - iclose <= baud_table[i] &&
431		    ibaud + iclose >= baud_table[i]) {
432			/* For the case input == output don't set IBAUD bits
433			   if the user didn't do so */
434			if (ofound == i && !ibinput)
435				ifound  = i;
436#ifdef IBSHIFT
437			else {
438				ifound = i;
439				termios->c_cflag |= (baud_bits[i] << IBSHIFT);
440			}
441#endif
442		}
443	} while (++i < n_baud_table);
444
445	/*
446	 *	If we found no match then use BOTHER if provided or warn
447	 *	the user their platform maintainer needs to wake up if not.
448	 */
449#ifdef BOTHER
450	if (ofound == -1)
451		termios->c_cflag |= BOTHER;
452	/* Set exact input bits only if the input and output differ or the
453	   user already did */
454	if (ifound == -1 && (ibaud != obaud || ibinput))
455		termios->c_cflag |= (BOTHER << IBSHIFT);
456#else
457	if (ifound == -1 || ofound == -1) {
458		printk_once(KERN_WARNING "tty: Unable to return correct "
459			  "speed data as your architecture needs updating.\n");
460	}
461#endif
462}
463EXPORT_SYMBOL_GPL(tty_termios_encode_baud_rate);
464
465/**
466 *	tty_encode_baud_rate		-	set baud rate of the tty
467 *	@ibaud: input baud rate
468 *	@obad: output baud rate
469 *
470 *	Update the current termios data for the tty with the new speed
471 *	settings. The caller must hold the termios_mutex for the tty in
472 *	question.
473 */
474
475void tty_encode_baud_rate(struct tty_struct *tty, speed_t ibaud, speed_t obaud)
476{
477	tty_termios_encode_baud_rate(&tty->termios, ibaud, obaud);
478}
479EXPORT_SYMBOL_GPL(tty_encode_baud_rate);
480
481/**
482 *	tty_termios_copy_hw	-	copy hardware settings
483 *	@new: New termios
484 *	@old: Old termios
485 *
486 *	Propagate the hardware specific terminal setting bits from
487 *	the old termios structure to the new one. This is used in cases
488 *	where the hardware does not support reconfiguration or as a helper
489 *	in some cases where only minimal reconfiguration is supported
490 */
491
492void tty_termios_copy_hw(struct ktermios *new, struct ktermios *old)
493{
494	/* The bits a dumb device handles in software. Smart devices need
495	   to always provide a set_termios method */
496	new->c_cflag &= HUPCL | CREAD | CLOCAL;
497	new->c_cflag |= old->c_cflag & ~(HUPCL | CREAD | CLOCAL);
498	new->c_ispeed = old->c_ispeed;
499	new->c_ospeed = old->c_ospeed;
500}
501EXPORT_SYMBOL(tty_termios_copy_hw);
502
503/**
504 *	tty_termios_hw_change	-	check for setting change
505 *	@a: termios
506 *	@b: termios to compare
507 *
508 *	Check if any of the bits that affect a dumb device have changed
509 *	between the two termios structures, or a speed change is needed.
510 */
511
512int tty_termios_hw_change(struct ktermios *a, struct ktermios *b)
513{
514	if (a->c_ispeed != b->c_ispeed || a->c_ospeed != b->c_ospeed)
515		return 1;
516	if ((a->c_cflag ^ b->c_cflag) & ~(HUPCL | CREAD | CLOCAL))
517		return 1;
518	return 0;
519}
520EXPORT_SYMBOL(tty_termios_hw_change);
521
522/**
523 *	tty_set_termios		-	update termios values
524 *	@tty: tty to update
525 *	@new_termios: desired new value
526 *
527 *	Perform updates to the termios values set on this terminal. There
528 *	is a bit of layering violation here with n_tty in terms of the
529 *	internal knowledge of this function.
530 *
531 *	Locking: termios_mutex
532 */
533
534int tty_set_termios(struct tty_struct *tty, struct ktermios *new_termios)
535{
536	struct ktermios old_termios;
537	struct tty_ldisc *ld;
538	unsigned long flags;
539
540	/*
541	 *	Perform the actual termios internal changes under lock.
542	 */
543
544
545	/* FIXME: we need to decide on some locking/ordering semantics
546	   for the set_termios notification eventually */
547	mutex_lock(&tty->termios_mutex);
548	old_termios = tty->termios;
549	tty->termios = *new_termios;
550	unset_locked_termios(&tty->termios, &old_termios, &tty->termios_locked);
551
552	/* See if packet mode change of state. */
553	if (tty->link && tty->link->packet) {
554		int extproc = (old_termios.c_lflag & EXTPROC) |
555				(tty->termios.c_lflag & EXTPROC);
556		int old_flow = ((old_termios.c_iflag & IXON) &&
557				(old_termios.c_cc[VSTOP] == '\023') &&
558				(old_termios.c_cc[VSTART] == '\021'));
559		int new_flow = (I_IXON(tty) &&
560				STOP_CHAR(tty) == '\023' &&
561				START_CHAR(tty) == '\021');
562		if ((old_flow != new_flow) || extproc) {
563			spin_lock_irqsave(&tty->ctrl_lock, flags);
564			if (old_flow != new_flow) {
565				tty->ctrl_status &= ~(TIOCPKT_DOSTOP | TIOCPKT_NOSTOP);
566				if (new_flow)
567					tty->ctrl_status |= TIOCPKT_DOSTOP;
568				else
569					tty->ctrl_status |= TIOCPKT_NOSTOP;
570			}
571			if (extproc)
572				tty->ctrl_status |= TIOCPKT_IOCTL;
573			spin_unlock_irqrestore(&tty->ctrl_lock, flags);
574			wake_up_interruptible(&tty->link->read_wait);
575		}
576	}
577
578	if (tty->ops->set_termios)
579		(*tty->ops->set_termios)(tty, &old_termios);
580	else
581		tty_termios_copy_hw(&tty->termios, &old_termios);
582
583	ld = tty_ldisc_ref(tty);
584	if (ld != NULL) {
585		if (ld->ops->set_termios)
586			(ld->ops->set_termios)(tty, &old_termios);
587		tty_ldisc_deref(ld);
588	}
589	mutex_unlock(&tty->termios_mutex);
590	return 0;
591}
592EXPORT_SYMBOL_GPL(tty_set_termios);
593
594/**
595 *	set_termios		-	set termios values for a tty
596 *	@tty: terminal device
597 *	@arg: user data
598 *	@opt: option information
599 *
600 *	Helper function to prepare termios data and run necessary other
601 *	functions before using tty_set_termios to do the actual changes.
602 *
603 *	Locking:
604 *		Called functions take ldisc and termios_mutex locks
605 */
606
607static int set_termios(struct tty_struct *tty, void __user *arg, int opt)
608{
609	struct ktermios tmp_termios;
610	struct tty_ldisc *ld;
611	int retval = tty_check_change(tty);
612
613	if (retval)
614		return retval;
615
616	mutex_lock(&tty->termios_mutex);
617	tmp_termios = tty->termios;
618	mutex_unlock(&tty->termios_mutex);
619
620	if (opt & TERMIOS_TERMIO) {
621		if (user_termio_to_kernel_termios(&tmp_termios,
622						(struct termio __user *)arg))
623			return -EFAULT;
624#ifdef TCGETS2
625	} else if (opt & TERMIOS_OLD) {
626		if (user_termios_to_kernel_termios_1(&tmp_termios,
627						(struct termios __user *)arg))
628			return -EFAULT;
629	} else {
630		if (user_termios_to_kernel_termios(&tmp_termios,
631						(struct termios2 __user *)arg))
632			return -EFAULT;
633	}
634#else
635	} else if (user_termios_to_kernel_termios(&tmp_termios,
636					(struct termios __user *)arg))
637		return -EFAULT;
638#endif
639
640	/* If old style Bfoo values are used then load c_ispeed/c_ospeed
641	 * with the real speed so its unconditionally usable */
642	tmp_termios.c_ispeed = tty_termios_input_baud_rate(&tmp_termios);
643	tmp_termios.c_ospeed = tty_termios_baud_rate(&tmp_termios);
644
645	ld = tty_ldisc_ref(tty);
646
647	if (ld != NULL) {
648		if ((opt & TERMIOS_FLUSH) && ld->ops->flush_buffer)
649			ld->ops->flush_buffer(tty);
650		tty_ldisc_deref(ld);
651	}
652
653	if (opt & TERMIOS_WAIT) {
654		tty_wait_until_sent(tty, 0);
655		if (signal_pending(current))
656			return -ERESTARTSYS;
657	}
658
659	tty_set_termios(tty, &tmp_termios);
660
661	/* FIXME: Arguably if tmp_termios == tty->termios AND the
662	   actual requested termios was not tmp_termios then we may
663	   want to return an error as no user requested change has
664	   succeeded */
665	return 0;
666}
667
668static void copy_termios(struct tty_struct *tty, struct ktermios *kterm)
669{
670	mutex_lock(&tty->termios_mutex);
671	*kterm = tty->termios;
672	mutex_unlock(&tty->termios_mutex);
673}
674
675static void copy_termios_locked(struct tty_struct *tty, struct ktermios *kterm)
676{
677	mutex_lock(&tty->termios_mutex);
678	*kterm = tty->termios_locked;
679	mutex_unlock(&tty->termios_mutex);
680}
681
682static int get_termio(struct tty_struct *tty, struct termio __user *termio)
683{
684	struct ktermios kterm;
685	copy_termios(tty, &kterm);
686	if (kernel_termios_to_user_termio(termio, &kterm))
687		return -EFAULT;
688	return 0;
689}
690
691
692#ifdef TCGETX
693
694/**
695 *	set_termiox	-	set termiox fields if possible
696 *	@tty: terminal
697 *	@arg: termiox structure from user
698 *	@opt: option flags for ioctl type
699 *
700 *	Implement the device calling points for the SYS5 termiox ioctl
701 *	interface in Linux
702 */
703
704static int set_termiox(struct tty_struct *tty, void __user *arg, int opt)
705{
706	struct termiox tnew;
707	struct tty_ldisc *ld;
708
709	if (tty->termiox == NULL)
710		return -EINVAL;
711	if (copy_from_user(&tnew, arg, sizeof(struct termiox)))
712		return -EFAULT;
713
714	ld = tty_ldisc_ref(tty);
715	if (ld != NULL) {
716		if ((opt & TERMIOS_FLUSH) && ld->ops->flush_buffer)
717			ld->ops->flush_buffer(tty);
718		tty_ldisc_deref(ld);
719	}
720	if (opt & TERMIOS_WAIT) {
721		tty_wait_until_sent(tty, 0);
722		if (signal_pending(current))
723			return -ERESTARTSYS;
724	}
725
726	mutex_lock(&tty->termios_mutex);
727	if (tty->ops->set_termiox)
728		tty->ops->set_termiox(tty, &tnew);
729	mutex_unlock(&tty->termios_mutex);
730	return 0;
731}
732
733#endif
734
735
736#ifdef TIOCGETP
737/*
738 * These are deprecated, but there is limited support..
739 *
740 * The "sg_flags" translation is a joke..
741 */
742static int get_sgflags(struct tty_struct *tty)
743{
744	int flags = 0;
745
746	if (!(tty->termios.c_lflag & ICANON)) {
747		if (tty->termios.c_lflag & ISIG)
748			flags |= 0x02;		/* cbreak */
749		else
750			flags |= 0x20;		/* raw */
751	}
752	if (tty->termios.c_lflag & ECHO)
753		flags |= 0x08;			/* echo */
754	if (tty->termios.c_oflag & OPOST)
755		if (tty->termios.c_oflag & ONLCR)
756			flags |= 0x10;		/* crmod */
757	return flags;
758}
759
760static int get_sgttyb(struct tty_struct *tty, struct sgttyb __user *sgttyb)
761{
762	struct sgttyb tmp;
763
764	mutex_lock(&tty->termios_mutex);
765	tmp.sg_ispeed = tty->termios.c_ispeed;
766	tmp.sg_ospeed = tty->termios.c_ospeed;
767	tmp.sg_erase = tty->termios.c_cc[VERASE];
768	tmp.sg_kill = tty->termios.c_cc[VKILL];
769	tmp.sg_flags = get_sgflags(tty);
770	mutex_unlock(&tty->termios_mutex);
771
772	return copy_to_user(sgttyb, &tmp, sizeof(tmp)) ? -EFAULT : 0;
773}
774
775static void set_sgflags(struct ktermios *termios, int flags)
776{
777	termios->c_iflag = ICRNL | IXON;
778	termios->c_oflag = 0;
779	termios->c_lflag = ISIG | ICANON;
780	if (flags & 0x02) {	/* cbreak */
781		termios->c_iflag = 0;
782		termios->c_lflag &= ~ICANON;
783	}
784	if (flags & 0x08) {		/* echo */
785		termios->c_lflag |= ECHO | ECHOE | ECHOK |
786				    ECHOCTL | ECHOKE | IEXTEN;
787	}
788	if (flags & 0x10) {		/* crmod */
789		termios->c_oflag |= OPOST | ONLCR;
790	}
791	if (flags & 0x20) {	/* raw */
792		termios->c_iflag = 0;
793		termios->c_lflag &= ~(ISIG | ICANON);
794	}
795	if (!(termios->c_lflag & ICANON)) {
796		termios->c_cc[VMIN] = 1;
797		termios->c_cc[VTIME] = 0;
798	}
799}
800
801/**
802 *	set_sgttyb		-	set legacy terminal values
803 *	@tty: tty structure
804 *	@sgttyb: pointer to old style terminal structure
805 *
806 *	Updates a terminal from the legacy BSD style terminal information
807 *	structure.
808 *
809 *	Locking: termios_mutex
810 */
811
812static int set_sgttyb(struct tty_struct *tty, struct sgttyb __user *sgttyb)
813{
814	int retval;
815	struct sgttyb tmp;
816	struct ktermios termios;
817
818	retval = tty_check_change(tty);
819	if (retval)
820		return retval;
821
822	if (copy_from_user(&tmp, sgttyb, sizeof(tmp)))
823		return -EFAULT;
824
825	mutex_lock(&tty->termios_mutex);
826	termios = tty->termios;
827	termios.c_cc[VERASE] = tmp.sg_erase;
828	termios.c_cc[VKILL] = tmp.sg_kill;
829	set_sgflags(&termios, tmp.sg_flags);
830	/* Try and encode into Bfoo format */
831#ifdef BOTHER
832	tty_termios_encode_baud_rate(&termios, termios.c_ispeed,
833						termios.c_ospeed);
834#endif
835	mutex_unlock(&tty->termios_mutex);
836	tty_set_termios(tty, &termios);
837	return 0;
838}
839#endif
840
841#ifdef TIOCGETC
842static int get_tchars(struct tty_struct *tty, struct tchars __user *tchars)
843{
844	struct tchars tmp;
845
846	mutex_lock(&tty->termios_mutex);
847	tmp.t_intrc = tty->termios.c_cc[VINTR];
848	tmp.t_quitc = tty->termios.c_cc[VQUIT];
849	tmp.t_startc = tty->termios.c_cc[VSTART];
850	tmp.t_stopc = tty->termios.c_cc[VSTOP];
851	tmp.t_eofc = tty->termios.c_cc[VEOF];
852	tmp.t_brkc = tty->termios.c_cc[VEOL2];	/* what is brkc anyway? */
853	mutex_unlock(&tty->termios_mutex);
854	return copy_to_user(tchars, &tmp, sizeof(tmp)) ? -EFAULT : 0;
855}
856
857static int set_tchars(struct tty_struct *tty, struct tchars __user *tchars)
858{
859	struct tchars tmp;
860
861	if (copy_from_user(&tmp, tchars, sizeof(tmp)))
862		return -EFAULT;
863	mutex_lock(&tty->termios_mutex);
864	tty->termios.c_cc[VINTR] = tmp.t_intrc;
865	tty->termios.c_cc[VQUIT] = tmp.t_quitc;
866	tty->termios.c_cc[VSTART] = tmp.t_startc;
867	tty->termios.c_cc[VSTOP] = tmp.t_stopc;
868	tty->termios.c_cc[VEOF] = tmp.t_eofc;
869	tty->termios.c_cc[VEOL2] = tmp.t_brkc;	/* what is brkc anyway? */
870	mutex_unlock(&tty->termios_mutex);
871	return 0;
872}
873#endif
874
875#ifdef TIOCGLTC
876static int get_ltchars(struct tty_struct *tty, struct ltchars __user *ltchars)
877{
878	struct ltchars tmp;
879
880	mutex_lock(&tty->termios_mutex);
881	tmp.t_suspc = tty->termios.c_cc[VSUSP];
882	/* what is dsuspc anyway? */
883	tmp.t_dsuspc = tty->termios.c_cc[VSUSP];
884	tmp.t_rprntc = tty->termios.c_cc[VREPRINT];
885	/* what is flushc anyway? */
886	tmp.t_flushc = tty->termios.c_cc[VEOL2];
887	tmp.t_werasc = tty->termios.c_cc[VWERASE];
888	tmp.t_lnextc = tty->termios.c_cc[VLNEXT];
889	mutex_unlock(&tty->termios_mutex);
890	return copy_to_user(ltchars, &tmp, sizeof(tmp)) ? -EFAULT : 0;
891}
892
893static int set_ltchars(struct tty_struct *tty, struct ltchars __user *ltchars)
894{
895	struct ltchars tmp;
896
897	if (copy_from_user(&tmp, ltchars, sizeof(tmp)))
898		return -EFAULT;
899
900	mutex_lock(&tty->termios_mutex);
901	tty->termios.c_cc[VSUSP] = tmp.t_suspc;
902	/* what is dsuspc anyway? */
903	tty->termios.c_cc[VEOL2] = tmp.t_dsuspc;
904	tty->termios.c_cc[VREPRINT] = tmp.t_rprntc;
905	/* what is flushc anyway? */
906	tty->termios.c_cc[VEOL2] = tmp.t_flushc;
907	tty->termios.c_cc[VWERASE] = tmp.t_werasc;
908	tty->termios.c_cc[VLNEXT] = tmp.t_lnextc;
909	mutex_unlock(&tty->termios_mutex);
910	return 0;
911}
912#endif
913
914/**
915 *	send_prio_char		-	send priority character
916 *
917 *	Send a high priority character to the tty even if stopped
918 *
919 *	Locking: none for xchar method, write ordering for write method.
920 */
921
922static int send_prio_char(struct tty_struct *tty, char ch)
923{
924	int	was_stopped = tty->stopped;
925
926	if (tty->ops->send_xchar) {
927		tty->ops->send_xchar(tty, ch);
928		return 0;
929	}
930
931	if (tty_write_lock(tty, 0) < 0)
932		return -ERESTARTSYS;
933
934	if (was_stopped)
935		start_tty(tty);
936	tty->ops->write(tty, &ch, 1);
937	if (was_stopped)
938		stop_tty(tty);
939	tty_write_unlock(tty);
940	return 0;
941}
942
943/**
944 *	tty_change_softcar	-	carrier change ioctl helper
945 *	@tty: tty to update
946 *	@arg: enable/disable CLOCAL
947 *
948 *	Perform a change to the CLOCAL state and call into the driver
949 *	layer to make it visible. All done with the termios mutex
950 */
951
952static int tty_change_softcar(struct tty_struct *tty, int arg)
953{
954	int ret = 0;
955	int bit = arg ? CLOCAL : 0;
956	struct ktermios old;
957
958	mutex_lock(&tty->termios_mutex);
959	old = tty->termios;
960	tty->termios.c_cflag &= ~CLOCAL;
961	tty->termios.c_cflag |= bit;
962	if (tty->ops->set_termios)
963		tty->ops->set_termios(tty, &old);
964	if ((tty->termios.c_cflag & CLOCAL) != bit)
965		ret = -EINVAL;
966	mutex_unlock(&tty->termios_mutex);
967	return ret;
968}
969
970/**
971 *	tty_mode_ioctl		-	mode related ioctls
972 *	@tty: tty for the ioctl
973 *	@file: file pointer for the tty
974 *	@cmd: command
975 *	@arg: ioctl argument
976 *
977 *	Perform non line discipline specific mode control ioctls. This
978 *	is designed to be called by line disciplines to ensure they provide
979 *	consistent mode setting.
980 */
981
982int tty_mode_ioctl(struct tty_struct *tty, struct file *file,
983			unsigned int cmd, unsigned long arg)
984{
985	struct tty_struct *real_tty;
986	void __user *p = (void __user *)arg;
987	int ret = 0;
988	struct ktermios kterm;
989
990	BUG_ON(file == NULL);
991
992	if (tty->driver->type == TTY_DRIVER_TYPE_PTY &&
993	    tty->driver->subtype == PTY_TYPE_MASTER)
994		real_tty = tty->link;
995	else
996		real_tty = tty;
997
998	switch (cmd) {
999#ifdef TIOCGETP
1000	case TIOCGETP:
1001		return get_sgttyb(real_tty, (struct sgttyb __user *) arg);
1002	case TIOCSETP:
1003	case TIOCSETN:
1004		return set_sgttyb(real_tty, (struct sgttyb __user *) arg);
1005#endif
1006#ifdef TIOCGETC
1007	case TIOCGETC:
1008		return get_tchars(real_tty, p);
1009	case TIOCSETC:
1010		return set_tchars(real_tty, p);
1011#endif
1012#ifdef TIOCGLTC
1013	case TIOCGLTC:
1014		return get_ltchars(real_tty, p);
1015	case TIOCSLTC:
1016		return set_ltchars(real_tty, p);
1017#endif
1018	case TCSETSF:
1019		return set_termios(real_tty, p,  TERMIOS_FLUSH | TERMIOS_WAIT | TERMIOS_OLD);
1020	case TCSETSW:
1021		return set_termios(real_tty, p, TERMIOS_WAIT | TERMIOS_OLD);
1022	case TCSETS:
1023		return set_termios(real_tty, p, TERMIOS_OLD);
1024#ifndef TCGETS2
1025	case TCGETS:
1026		copy_termios(real_tty, &kterm);
1027		if (kernel_termios_to_user_termios((struct termios __user *)arg, &kterm))
1028			ret = -EFAULT;
1029		return ret;
1030#else
1031	case TCGETS:
1032		copy_termios(real_tty, &kterm);
1033		if (kernel_termios_to_user_termios_1((struct termios __user *)arg, &kterm))
1034			ret = -EFAULT;
1035		return ret;
1036	case TCGETS2:
1037		copy_termios(real_tty, &kterm);
1038		if (kernel_termios_to_user_termios((struct termios2 __user *)arg, &kterm))
1039			ret = -EFAULT;
1040		return ret;
1041	case TCSETSF2:
1042		return set_termios(real_tty, p,  TERMIOS_FLUSH | TERMIOS_WAIT);
1043	case TCSETSW2:
1044		return set_termios(real_tty, p, TERMIOS_WAIT);
1045	case TCSETS2:
1046		return set_termios(real_tty, p, 0);
1047#endif
1048	case TCGETA:
1049		return get_termio(real_tty, p);
1050	case TCSETAF:
1051		return set_termios(real_tty, p, TERMIOS_FLUSH | TERMIOS_WAIT | TERMIOS_TERMIO);
1052	case TCSETAW:
1053		return set_termios(real_tty, p, TERMIOS_WAIT | TERMIOS_TERMIO);
1054	case TCSETA:
1055		return set_termios(real_tty, p, TERMIOS_TERMIO);
1056#ifndef TCGETS2
1057	case TIOCGLCKTRMIOS:
1058		copy_termios_locked(real_tty, &kterm);
1059		if (kernel_termios_to_user_termios((struct termios __user *)arg, &kterm))
1060			ret = -EFAULT;
1061		return ret;
1062	case TIOCSLCKTRMIOS:
1063		if (!capable(CAP_SYS_ADMIN))
1064			return -EPERM;
1065		copy_termios_locked(real_tty, &kterm);
1066		if (user_termios_to_kernel_termios(&kterm,
1067					       (struct termios __user *) arg))
1068			return -EFAULT;
1069		mutex_lock(&real_tty->termios_mutex);
1070		real_tty->termios_locked = kterm;
1071		mutex_unlock(&real_tty->termios_mutex);
1072		return 0;
1073#else
1074	case TIOCGLCKTRMIOS:
1075		copy_termios_locked(real_tty, &kterm);
1076		if (kernel_termios_to_user_termios_1((struct termios __user *)arg, &kterm))
1077			ret = -EFAULT;
1078		return ret;
1079	case TIOCSLCKTRMIOS:
1080		if (!capable(CAP_SYS_ADMIN))
1081			return -EPERM;
1082		copy_termios_locked(real_tty, &kterm);
1083		if (user_termios_to_kernel_termios_1(&kterm,
1084					       (struct termios __user *) arg))
1085			return -EFAULT;
1086		mutex_lock(&real_tty->termios_mutex);
1087		real_tty->termios_locked = kterm;
1088		mutex_unlock(&real_tty->termios_mutex);
1089		return ret;
1090#endif
1091#ifdef TCGETX
1092	case TCGETX: {
1093		struct termiox ktermx;
1094		if (real_tty->termiox == NULL)
1095			return -EINVAL;
1096		mutex_lock(&real_tty->termios_mutex);
1097		memcpy(&ktermx, real_tty->termiox, sizeof(struct termiox));
1098		mutex_unlock(&real_tty->termios_mutex);
1099		if (copy_to_user(p, &ktermx, sizeof(struct termiox)))
1100			ret = -EFAULT;
1101		return ret;
1102	}
1103	case TCSETX:
1104		return set_termiox(real_tty, p, 0);
1105	case TCSETXW:
1106		return set_termiox(real_tty, p, TERMIOS_WAIT);
1107	case TCSETXF:
1108		return set_termiox(real_tty, p, TERMIOS_FLUSH);
1109#endif
1110	case TIOCGSOFTCAR:
1111		copy_termios(real_tty, &kterm);
1112		ret = put_user((kterm.c_cflag & CLOCAL) ? 1 : 0,
1113						(int __user *)arg);
1114		return ret;
1115	case TIOCSSOFTCAR:
1116		if (get_user(arg, (unsigned int __user *) arg))
1117			return -EFAULT;
1118		return tty_change_softcar(real_tty, arg);
1119	default:
1120		return -ENOIOCTLCMD;
1121	}
1122}
1123EXPORT_SYMBOL_GPL(tty_mode_ioctl);
1124
1125
1126/* Caller guarantees ldisc reference is held */
1127static int __tty_perform_flush(struct tty_struct *tty, unsigned long arg)
1128{
1129	struct tty_ldisc *ld = tty->ldisc;
1130
1131	switch (arg) {
1132	case TCIFLUSH:
1133		if (ld && ld->ops->flush_buffer) {
1134			ld->ops->flush_buffer(tty);
1135			tty_unthrottle(tty);
1136		}
1137		break;
1138	case TCIOFLUSH:
1139		if (ld && ld->ops->flush_buffer) {
1140			ld->ops->flush_buffer(tty);
1141			tty_unthrottle(tty);
1142		}
1143		/* fall through */
1144	case TCOFLUSH:
1145		tty_driver_flush_buffer(tty);
1146		break;
1147	default:
1148		return -EINVAL;
1149	}
1150	return 0;
1151}
1152
1153int tty_perform_flush(struct tty_struct *tty, unsigned long arg)
1154{
1155	struct tty_ldisc *ld;
1156	int retval = tty_check_change(tty);
1157	if (retval)
1158		return retval;
1159
1160	ld = tty_ldisc_ref_wait(tty);
1161	retval = __tty_perform_flush(tty, arg);
1162	if (ld)
1163		tty_ldisc_deref(ld);
1164	return retval;
1165}
1166EXPORT_SYMBOL_GPL(tty_perform_flush);
1167
1168int n_tty_ioctl_helper(struct tty_struct *tty, struct file *file,
1169		       unsigned int cmd, unsigned long arg)
1170{
1171	int retval;
1172
1173	switch (cmd) {
1174	case TCXONC:
1175		retval = tty_check_change(tty);
1176		if (retval)
1177			return retval;
1178		switch (arg) {
1179		case TCOOFF:
1180			if (!tty->flow_stopped) {
1181				tty->flow_stopped = 1;
1182				stop_tty(tty);
1183			}
1184			break;
1185		case TCOON:
1186			if (tty->flow_stopped) {
1187				tty->flow_stopped = 0;
1188				start_tty(tty);
1189			}
1190			break;
1191		case TCIOFF:
1192			if (STOP_CHAR(tty) != __DISABLED_CHAR)
1193				return send_prio_char(tty, STOP_CHAR(tty));
1194			break;
1195		case TCION:
1196			if (START_CHAR(tty) != __DISABLED_CHAR)
1197				return send_prio_char(tty, START_CHAR(tty));
1198			break;
1199		default:
1200			return -EINVAL;
1201		}
1202		return 0;
1203	case TCFLSH:
1204		return __tty_perform_flush(tty, arg);
1205	default:
1206		/* Try the mode commands */
1207		return tty_mode_ioctl(tty, file, cmd, arg);
1208	}
1209}
1210EXPORT_SYMBOL(n_tty_ioctl_helper);
1211
1212#ifdef CONFIG_COMPAT
1213long n_tty_compat_ioctl_helper(struct tty_struct *tty, struct file *file,
1214					unsigned int cmd, unsigned long arg)
1215{
1216	switch (cmd) {
1217	case TIOCGLCKTRMIOS:
1218	case TIOCSLCKTRMIOS:
1219		return tty_mode_ioctl(tty, file, cmd, (unsigned long) compat_ptr(arg));
1220	default:
1221		return -ENOIOCTLCMD;
1222	}
1223}
1224EXPORT_SYMBOL(n_tty_compat_ioctl_helper);
1225#endif
1226
1227