tty.h 24.4 KB
Newer Older
L
Linus Torvalds 已提交
1 2 3
#ifndef _LINUX_TTY_H
#define _LINUX_TTY_H

4 5 6 7 8 9 10
#include <linux/fs.h>
#include <linux/major.h>
#include <linux/termios.h>
#include <linux/workqueue.h>
#include <linux/tty_driver.h>
#include <linux/tty_ldisc.h>
#include <linux/mutex.h>
11
#include <linux/tty_flags.h>
12
#include <uapi/linux/tty.h>
13 14 15 16 17 18 19 20



/*
 * (Note: the *_driver.minor_start values 1, 64, 128, 192 are
 * hardcoded at present.)
 */
#define NR_UNIX98_PTY_DEFAULT	4096      /* Default maximum for Unix98 ptys */
21
#define NR_UNIX98_PTY_RESERVE	1024	  /* Default reserve for main devpts */
22 23
#define NR_UNIX98_PTY_MAX	(1 << MINORBITS) /* Absolute limit */

L
Linus Torvalds 已提交
24 25 26 27 28 29 30
/*
 * This character is the same as _POSIX_VDISABLE: it cannot be used as
 * a c_cc[] character, but indicates that a particular special character
 * isn't in use (eg VINTR has no character etc)
 */
#define __DISABLED_CHAR '\0'

A
Alan Cox 已提交
31 32 33 34 35 36
struct tty_buffer {
	struct tty_buffer *next;
	char *char_buf_ptr;
	unsigned char *flag_buf_ptr;
	int used;
	int size;
P
Paul Fulghum 已提交
37 38
	int commit;
	int read;
A
Alan Cox 已提交
39 40 41 42
	/* Data points here */
	unsigned long data[0];
};

43 44
/*
 * We default to dicing tty buffer allocations to this many characters
45 46 47 48
 * in order to avoid multiple page allocations. We know the size of
 * tty_buffer itself but it must also be taken into account that the
 * the buffer is 256 byte aligned. See tty_buffer_find for the allocation
 * logic this must match
49 50
 */

51
#define TTY_BUFFER_PAGE	(((PAGE_SIZE - sizeof(struct tty_buffer)) / 2) & ~0xFF)
52 53


A
Alan Cox 已提交
54
struct tty_bufhead {
55
	struct work_struct work;
56
	spinlock_t lock;
A
Alan Cox 已提交
57 58 59
	struct tty_buffer *head;	/* Queue head */
	struct tty_buffer *tail;	/* Active buffer */
	struct tty_buffer *free;	/* Free queue head */
A
Alan Cox 已提交
60 61
	int memory_used;		/* Buffer space used excluding
								free queue */
L
Linus Torvalds 已提交
62 63 64 65 66 67 68 69 70 71 72
};
/*
 * When a break, frame error, or parity error happens, these codes are
 * stuffed into the flags buffer.
 */
#define TTY_NORMAL	0
#define TTY_BREAK	1
#define TTY_FRAME	2
#define TTY_PARITY	3
#define TTY_OVERRUN	4

73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89
#define INTR_CHAR(tty) ((tty)->termios.c_cc[VINTR])
#define QUIT_CHAR(tty) ((tty)->termios.c_cc[VQUIT])
#define ERASE_CHAR(tty) ((tty)->termios.c_cc[VERASE])
#define KILL_CHAR(tty) ((tty)->termios.c_cc[VKILL])
#define EOF_CHAR(tty) ((tty)->termios.c_cc[VEOF])
#define TIME_CHAR(tty) ((tty)->termios.c_cc[VTIME])
#define MIN_CHAR(tty) ((tty)->termios.c_cc[VMIN])
#define SWTC_CHAR(tty) ((tty)->termios.c_cc[VSWTC])
#define START_CHAR(tty) ((tty)->termios.c_cc[VSTART])
#define STOP_CHAR(tty) ((tty)->termios.c_cc[VSTOP])
#define SUSP_CHAR(tty) ((tty)->termios.c_cc[VSUSP])
#define EOL_CHAR(tty) ((tty)->termios.c_cc[VEOL])
#define REPRINT_CHAR(tty) ((tty)->termios.c_cc[VREPRINT])
#define DISCARD_CHAR(tty) ((tty)->termios.c_cc[VDISCARD])
#define WERASE_CHAR(tty) ((tty)->termios.c_cc[VWERASE])
#define LNEXT_CHAR(tty)	((tty)->termios.c_cc[VLNEXT])
#define EOL2_CHAR(tty) ((tty)->termios.c_cc[VEOL2])
L
Linus Torvalds 已提交
90

91 92 93 94
#define _I_FLAG(tty, f)	((tty)->termios.c_iflag & (f))
#define _O_FLAG(tty, f)	((tty)->termios.c_oflag & (f))
#define _C_FLAG(tty, f)	((tty)->termios.c_cflag & (f))
#define _L_FLAG(tty, f)	((tty)->termios.c_lflag & (f))
A
Alan Cox 已提交
95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152

#define I_IGNBRK(tty)	_I_FLAG((tty), IGNBRK)
#define I_BRKINT(tty)	_I_FLAG((tty), BRKINT)
#define I_IGNPAR(tty)	_I_FLAG((tty), IGNPAR)
#define I_PARMRK(tty)	_I_FLAG((tty), PARMRK)
#define I_INPCK(tty)	_I_FLAG((tty), INPCK)
#define I_ISTRIP(tty)	_I_FLAG((tty), ISTRIP)
#define I_INLCR(tty)	_I_FLAG((tty), INLCR)
#define I_IGNCR(tty)	_I_FLAG((tty), IGNCR)
#define I_ICRNL(tty)	_I_FLAG((tty), ICRNL)
#define I_IUCLC(tty)	_I_FLAG((tty), IUCLC)
#define I_IXON(tty)	_I_FLAG((tty), IXON)
#define I_IXANY(tty)	_I_FLAG((tty), IXANY)
#define I_IXOFF(tty)	_I_FLAG((tty), IXOFF)
#define I_IMAXBEL(tty)	_I_FLAG((tty), IMAXBEL)
#define I_IUTF8(tty)	_I_FLAG((tty), IUTF8)

#define O_OPOST(tty)	_O_FLAG((tty), OPOST)
#define O_OLCUC(tty)	_O_FLAG((tty), OLCUC)
#define O_ONLCR(tty)	_O_FLAG((tty), ONLCR)
#define O_OCRNL(tty)	_O_FLAG((tty), OCRNL)
#define O_ONOCR(tty)	_O_FLAG((tty), ONOCR)
#define O_ONLRET(tty)	_O_FLAG((tty), ONLRET)
#define O_OFILL(tty)	_O_FLAG((tty), OFILL)
#define O_OFDEL(tty)	_O_FLAG((tty), OFDEL)
#define O_NLDLY(tty)	_O_FLAG((tty), NLDLY)
#define O_CRDLY(tty)	_O_FLAG((tty), CRDLY)
#define O_TABDLY(tty)	_O_FLAG((tty), TABDLY)
#define O_BSDLY(tty)	_O_FLAG((tty), BSDLY)
#define O_VTDLY(tty)	_O_FLAG((tty), VTDLY)
#define O_FFDLY(tty)	_O_FLAG((tty), FFDLY)

#define C_BAUD(tty)	_C_FLAG((tty), CBAUD)
#define C_CSIZE(tty)	_C_FLAG((tty), CSIZE)
#define C_CSTOPB(tty)	_C_FLAG((tty), CSTOPB)
#define C_CREAD(tty)	_C_FLAG((tty), CREAD)
#define C_PARENB(tty)	_C_FLAG((tty), PARENB)
#define C_PARODD(tty)	_C_FLAG((tty), PARODD)
#define C_HUPCL(tty)	_C_FLAG((tty), HUPCL)
#define C_CLOCAL(tty)	_C_FLAG((tty), CLOCAL)
#define C_CIBAUD(tty)	_C_FLAG((tty), CIBAUD)
#define C_CRTSCTS(tty)	_C_FLAG((tty), CRTSCTS)

#define L_ISIG(tty)	_L_FLAG((tty), ISIG)
#define L_ICANON(tty)	_L_FLAG((tty), ICANON)
#define L_XCASE(tty)	_L_FLAG((tty), XCASE)
#define L_ECHO(tty)	_L_FLAG((tty), ECHO)
#define L_ECHOE(tty)	_L_FLAG((tty), ECHOE)
#define L_ECHOK(tty)	_L_FLAG((tty), ECHOK)
#define L_ECHONL(tty)	_L_FLAG((tty), ECHONL)
#define L_NOFLSH(tty)	_L_FLAG((tty), NOFLSH)
#define L_TOSTOP(tty)	_L_FLAG((tty), TOSTOP)
#define L_ECHOCTL(tty)	_L_FLAG((tty), ECHOCTL)
#define L_ECHOPRT(tty)	_L_FLAG((tty), ECHOPRT)
#define L_ECHOKE(tty)	_L_FLAG((tty), ECHOKE)
#define L_FLUSHO(tty)	_L_FLAG((tty), FLUSHO)
#define L_PENDIN(tty)	_L_FLAG((tty), PENDIN)
#define L_IEXTEN(tty)	_L_FLAG((tty), IEXTEN)
153
#define L_EXTPROC(tty)	_L_FLAG((tty), EXTPROC)
L
Linus Torvalds 已提交
154 155

struct device;
M
Miloslav Trmac 已提交
156
struct signal_struct;
157 158 159 160 161 162 163 164 165 166 167

/*
 * Port level information. Each device keeps its own port level information
 * so provide a common structure for those ports wanting to use common support
 * routines.
 *
 * The tty port has a different lifetime to the tty so must be kept apart.
 * In addition be careful as tty -> port mappings are valid for the life
 * of the tty object but in many cases port -> tty mappings are valid only
 * until a hangup so don't use the wrong path.
 */
A
Alan Cox 已提交
168

169 170 171 172 173
struct tty_port;

struct tty_port_operations {
	/* Return 1 if the carrier is raised */
	int (*carrier_raised)(struct tty_port *port);
A
Alan Cox 已提交
174
	/* Control the DTR line */
175
	void (*dtr_rts)(struct tty_port *port, int raise);
A
Alan Cox 已提交
176
	/* Called when the last close completes or a hangup finishes
A
Alan Cox 已提交
177 178
	   IFF the port was initialized. Do not use to free resources. Called
	   under the port mutex to serialize against activate/shutdowns */
A
Alan Cox 已提交
179 180
	void (*shutdown)(struct tty_port *port);
	void (*drop)(struct tty_port *port);
A
Alan Cox 已提交
181 182 183 184 185
	/* Called under the port mutex from tty_port_open, serialized using
	   the port mutex */
        /* FIXME: long term getting the tty argument *out* of this would be
           good for consoles */
	int (*activate)(struct tty_port *port, struct tty_struct *tty);
186 187
	/* Called on the final put of a port */
	void (*destruct)(struct tty_port *port);
188 189
};
	
190
struct tty_port {
J
Jiri Slaby 已提交
191
	struct tty_bufhead	buf;		/* Locked internally */
192
	struct tty_struct	*tty;		/* Back pointer */
J
Jiri Slaby 已提交
193
	struct tty_struct	*itty;		/* internal back ptr */
194
	const struct tty_port_operations *ops;	/* Port operations */
A
Alan Cox 已提交
195
	spinlock_t		lock;		/* Lock protecting tty field */
196 197 198 199
	int			blocked_open;	/* Waiting to open */
	int			count;		/* Usage count */
	wait_queue_head_t	open_wait;	/* Open waiters */
	wait_queue_head_t	close_wait;	/* Close waiters */
200
	wait_queue_head_t	delta_msr_wait;	/* Modem status change */
201
	unsigned long		flags;		/* TTY flags ASY_*/
202 203 204
	unsigned long		iflags;		/* TTYP_ internal flags */
#define TTYP_FLUSHING			1  /* Flushing to ldisc in progress */
#define TTYP_FLUSHPENDING		2  /* Queued buffer flush pending */
J
Jiri Slaby 已提交
205 206
	unsigned char		console:1,	/* port is a console */
				low_latency:1;	/* direct buffer flush */
207
	struct mutex		mutex;		/* Locking */
208
	struct mutex		buf_mutex;	/* Buffer alloc lock */
209
	unsigned char		*xmit_buf;	/* Optional buffer */
210 211
	unsigned int		close_delay;	/* Close port delay */
	unsigned int		closing_wait;	/* Delay for output */
212 213 214
	int			drain_delay;	/* Set to zero if no pure time
						   based drain is needed else
						   set to size of fifo */
215
	struct kref		kref;		/* Ref counter */
216 217
};

L
Linus Torvalds 已提交
218 219 220 221 222 223 224 225 226 227 228
/*
 * Where all of the state associated with a tty is kept while the tty
 * is open.  Since the termios state should be kept even if the tty
 * has been closed --- for things like the baud rate, etc --- it is
 * not stored here, but rather a pointer to the real state is stored
 * here.  Possible the winsize structure should have the same
 * treatment, but (1) the default 80x24 is usually right and (2) it's
 * most often used by a windowing system, which will set the correct
 * size each time the window is created or resized anyway.
 * 						- TYT, 9/14/92
 */
A
Alan Cox 已提交
229 230 231

struct tty_operations;

L
Linus Torvalds 已提交
232 233
struct tty_struct {
	int	magic;
A
Alan Cox 已提交
234
	struct kref kref;
235
	struct device *dev;
L
Linus Torvalds 已提交
236
	struct tty_driver *driver;
A
Alan Cox 已提交
237
	const struct tty_operations *ops;
L
Linus Torvalds 已提交
238
	int index;
A
Alan Cox 已提交
239 240 241 242 243

	/* Protects ldisc changes: Lock tty not pty */
	struct mutex ldisc_mutex;
	struct tty_ldisc *ldisc;

244
	struct mutex atomic_write_lock;
A
Alan Cox 已提交
245
	struct mutex legacy_mutex;
246
	struct mutex termios_mutex;
A
Alan Cox 已提交
247
	spinlock_t ctrl_lock;
A
Alan Cox 已提交
248
	/* Termios values are protected by the termios mutex */
249
	struct ktermios termios, termios_locked;
A
Alan Cox 已提交
250
	struct termiox *termiox;	/* May be NULL for unsupported */
L
Linus Torvalds 已提交
251
	char name[64];
A
Alan Cox 已提交
252
	struct pid *pgrp;		/* Protected by ctrl lock */
253
	struct pid *session;
L
Linus Torvalds 已提交
254 255
	unsigned long flags;
	int count;
A
Alan Cox 已提交
256
	struct winsize winsize;		/* termios mutex */
L
Linus Torvalds 已提交
257
	unsigned char stopped:1, hw_stopped:1, flow_stopped:1, packet:1;
A
Alan Cox 已提交
258
	unsigned char ctrl_status;	/* ctrl_lock */
A
Alan Cox 已提交
259
	unsigned int receive_room;	/* Bytes free for queue */
260
	int flow_change;
L
Linus Torvalds 已提交
261 262 263 264 265 266 267 268 269 270 271 272

	struct tty_struct *link;
	struct fasync_struct *fasync;
	int alt_speed;		/* For magic substitution of 38400 bps */
	wait_queue_head_t write_wait;
	wait_queue_head_t read_wait;
	struct work_struct hangup_work;
	void *disc_data;
	void *driver_data;
	struct list_head tty_files;

#define N_TTY_BUF_SIZE 4096
273

L
Linus Torvalds 已提交
274 275 276 277 278 279
	unsigned char closing:1;
	unsigned short minimum_to_wake;
	unsigned char *write_buf;
	int write_cnt;
	/* If the tty has a pending do_SAK, queue it here - akpm */
	struct work_struct SAK_work;
280
	struct tty_port *port;
L
Linus Torvalds 已提交
281 282
};

N
Nick Piggin 已提交
283 284 285 286 287 288 289
/* Each of a tty's open files has private_data pointing to tty_file_private */
struct tty_file_private {
	struct tty_struct *tty;
	struct file *file;
	struct list_head list;
};

L
Linus Torvalds 已提交
290 291 292 293 294
/* tty magic number */
#define TTY_MAGIC		0x5401

/*
 * These bits are used in the flags field of the tty structure.
A
Alan Cox 已提交
295
 *
L
Linus Torvalds 已提交
296 297 298 299 300 301
 * So that interrupts won't be able to mess up the queues,
 * copy_to_cooked must be atomic with respect to itself, as must
 * tty->write.  Thus, you must use the inline functions set_bit() and
 * clear_bit() to make things atomic.
 */
#define TTY_THROTTLED 		0	/* Call unthrottle() at threshold min */
A
Alan Cox 已提交
302
#define TTY_IO_ERROR 		1	/* Cause an I/O error (may be no ldisc too) */
L
Linus Torvalds 已提交
303 304 305 306 307 308 309
#define TTY_OTHER_CLOSED 	2	/* Other side (if any) has closed */
#define TTY_EXCLUSIVE 		3	/* Exclusive open mode */
#define TTY_DEBUG 		4	/* Debugging */
#define TTY_DO_WRITE_WAKEUP 	5	/* Call write_wakeup after queuing new */
#define TTY_PUSH 		6	/* n_tty private */
#define TTY_CLOSING 		7	/* ->close() in progress */
#define TTY_LDISC 		9	/* Line discipline attached */
A
Alan Cox 已提交
310
#define TTY_LDISC_CHANGING 	10	/* Line discipline changing */
A
Alan Cox 已提交
311
#define TTY_LDISC_OPEN	 	11	/* Line discipline is open */
L
Linus Torvalds 已提交
312 313 314 315 316
#define TTY_HW_COOK_OUT 	14	/* Hardware can do output cooking */
#define TTY_HW_COOK_IN 		15	/* Hardware can do input cooking */
#define TTY_PTY_LOCK 		16	/* pty private */
#define TTY_NO_WRITE_SPLIT 	17	/* Preserve write boundaries to driver */
#define TTY_HUPPED 		18	/* Post driver->hangup() */
J
Jiri Slaby 已提交
317
#define TTY_HUPPING 		21	/* ->hangup() in progress */
L
Linus Torvalds 已提交
318 319 320

#define TTY_WRITE_FLUSH(tty) tty_write_flush((tty))

321 322 323 324 325 326 327 328 329 330 331 332 333 334 335
/* Values for tty->flow_change */
#define TTY_THROTTLE_SAFE 1
#define TTY_UNTHROTTLE_SAFE 2

static inline void __tty_set_flow_change(struct tty_struct *tty, int val)
{
	tty->flow_change = val;
}

static inline void tty_set_flow_change(struct tty_struct *tty, int val)
{
	tty->flow_change = val;
	smp_mb();
}

336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368
#ifdef CONFIG_TTY
extern void console_init(void);
extern void tty_kref_put(struct tty_struct *tty);
extern struct pid *tty_get_pgrp(struct tty_struct *tty);
extern void tty_vhangup_self(void);
extern void disassociate_ctty(int priv);
extern dev_t tty_devnum(struct tty_struct *tty);
extern void proc_clear_tty(struct task_struct *p);
extern struct tty_struct *get_current_tty(void);
/* tty_io.c */
extern int __init tty_init(void);
#else
static inline void console_init(void)
{ }
static inline void tty_kref_put(struct tty_struct *tty)
{ }
static inline struct pid *tty_get_pgrp(struct tty_struct *tty)
{ return NULL; }
static inline void tty_vhangup_self(void)
{ }
static inline void disassociate_ctty(int priv)
{ }
static inline dev_t tty_devnum(struct tty_struct *tty)
{ return 0; }
static inline void proc_clear_tty(struct task_struct *p)
{ }
static inline struct tty_struct *get_current_tty(void)
{ return NULL; }
/* tty_io.c */
static inline int __init tty_init(void)
{ return 0; }
#endif

L
Linus Torvalds 已提交
369 370
extern void tty_write_flush(struct tty_struct *);

371
extern struct ktermios tty_std_termios;
L
Linus Torvalds 已提交
372 373 374

extern int vcs_init(void);

375 376
extern struct class *tty_class;

A
Alan Cox 已提交
377 378 379 380 381 382 383 384 385
/**
 *	tty_kref_get		-	get a tty reference
 *	@tty: tty device
 *
 *	Return a new reference to a tty object. The caller must hold
 *	sufficient locks/counts to ensure that their existing reference cannot
 *	go away
 */

386
static inline struct tty_struct *tty_kref_get(struct tty_struct *tty)
A
Alan Cox 已提交
387 388 389 390 391 392
{
	if (tty)
		kref_get(&tty->kref);
	return tty;
}

L
Linus Torvalds 已提交
393 394 395
extern int tty_paranoia_check(struct tty_struct *tty, struct inode *inode,
			      const char *routine);
extern char *tty_name(struct tty_struct *tty, char *buf);
A
Alan Cox 已提交
396 397 398 399
extern void tty_wait_until_sent(struct tty_struct *tty, long timeout);
extern int tty_check_change(struct tty_struct *tty);
extern void stop_tty(struct tty_struct *tty);
extern void start_tty(struct tty_struct *tty);
L
Linus Torvalds 已提交
400 401
extern int tty_register_driver(struct tty_driver *driver);
extern int tty_unregister_driver(struct tty_driver *driver);
402 403
extern struct device *tty_register_device(struct tty_driver *driver,
					  unsigned index, struct device *dev);
404 405 406 407
extern struct device *tty_register_device_attr(struct tty_driver *driver,
				unsigned index, struct device *device,
				void *drvdata,
				const struct attribute_group **attr_grp);
L
Linus Torvalds 已提交
408 409 410 411
extern void tty_unregister_device(struct tty_driver *driver, unsigned index);
extern int tty_read_raw_data(struct tty_struct *tty, unsigned char *bufp,
			     int buflen);
extern void tty_write_message(struct tty_struct *tty, char *msg);
A
Alan Cox 已提交
412 413 414 415
extern int tty_put_char(struct tty_struct *tty, unsigned char c);
extern int tty_chars_in_buffer(struct tty_struct *tty);
extern int tty_write_room(struct tty_struct *tty);
extern void tty_driver_flush_buffer(struct tty_struct *tty);
A
Alan Cox 已提交
416 417
extern void tty_throttle(struct tty_struct *tty);
extern void tty_unthrottle(struct tty_struct *tty);
418 419
extern int tty_throttle_safe(struct tty_struct *tty);
extern int tty_unthrottle_safe(struct tty_struct *tty);
A
Alan Cox 已提交
420
extern int tty_do_resize(struct tty_struct *tty, struct winsize *ws);
J
Jiri Slaby 已提交
421 422
extern void tty_driver_remove_tty(struct tty_driver *driver,
				  struct tty_struct *tty);
A
Alan Cox 已提交
423
extern void tty_free_termios(struct tty_struct *tty);
424
extern int is_current_pgrp_orphaned(void);
L
Linus Torvalds 已提交
425 426
extern int is_ignored(int sig);
extern int tty_signal(int sig, struct tty_struct *tty);
A
Alan Cox 已提交
427 428
extern void tty_hangup(struct tty_struct *tty);
extern void tty_vhangup(struct tty_struct *tty);
A
Arnd Bergmann 已提交
429
extern void tty_vhangup_locked(struct tty_struct *tty);
L
Linus Torvalds 已提交
430
extern void tty_unhangup(struct file *filp);
A
Alan Cox 已提交
431
extern int tty_hung_up_p(struct file *filp);
L
Linus Torvalds 已提交
432
extern void do_SAK(struct tty_struct *tty);
433
extern void __do_SAK(struct tty_struct *tty);
434
extern void no_tty(void);
435
extern void tty_flush_to_ldisc(struct tty_struct *tty);
J
Jiri Slaby 已提交
436
extern void tty_buffer_free_all(struct tty_port *port);
A
Alan Cox 已提交
437
extern void tty_buffer_flush(struct tty_struct *tty);
J
Jiri Slaby 已提交
438
extern void tty_buffer_init(struct tty_port *port);
439 440
extern speed_t tty_termios_baud_rate(struct ktermios *termios);
extern speed_t tty_termios_input_baud_rate(struct ktermios *termios);
A
Alan Cox 已提交
441 442 443 444
extern void tty_termios_encode_baud_rate(struct ktermios *termios,
						speed_t ibaud, speed_t obaud);
extern void tty_encode_baud_rate(struct tty_struct *tty,
						speed_t ibaud, speed_t obaud);
445 446 447 448 449 450 451 452 453 454 455 456 457 458 459 460

/**
 *	tty_get_baud_rate	-	get tty bit rates
 *	@tty: tty to query
 *
 *	Returns the baud rate as an integer for this terminal. The
 *	termios lock must be held by the caller and the terminal bit
 *	flags may be updated.
 *
 *	Locking: none
 */
static inline speed_t tty_get_baud_rate(struct tty_struct *tty)
{
	return tty_termios_baud_rate(&tty->termios);
}

461
extern void tty_termios_copy_hw(struct ktermios *new, struct ktermios *old);
A
Alan Cox 已提交
462
extern int tty_termios_hw_change(struct ktermios *a, struct ktermios *b);
463
extern int tty_set_termios(struct tty_struct *tty, struct ktermios *kt);
L
Linus Torvalds 已提交
464 465 466 467

extern struct tty_ldisc *tty_ldisc_ref(struct tty_struct *);
extern void tty_ldisc_deref(struct tty_ldisc *);
extern struct tty_ldisc *tty_ldisc_ref_wait(struct tty_struct *);
A
Alan Cox 已提交
468
extern void tty_ldisc_hangup(struct tty_struct *tty);
A
Alan Cox 已提交
469
extern const struct file_operations tty_ldiscs_proc_fops;
L
Linus Torvalds 已提交
470 471 472 473

extern void tty_wakeup(struct tty_struct *tty);
extern void tty_ldisc_flush(struct tty_struct *tty);

A
Alan Cox 已提交
474
extern long tty_ioctl(struct file *file, unsigned int cmd, unsigned long arg);
475 476 477
extern int tty_mode_ioctl(struct tty_struct *tty, struct file *file,
			unsigned int cmd, unsigned long arg);
extern int tty_perform_flush(struct tty_struct *tty, unsigned long arg);
478
extern void tty_default_fops(struct file_operations *fops);
479
extern struct tty_struct *alloc_tty_struct(void);
J
Jiri Slaby 已提交
480 481 482
extern int tty_alloc_file(struct file *file);
extern void tty_add_file(struct tty_struct *tty, struct file *file);
extern void tty_free_file(struct file *file);
483 484 485
extern void free_tty_struct(struct tty_struct *tty);
extern void initialize_tty_struct(struct tty_struct *tty,
		struct tty_driver *driver, int idx);
486
extern void deinitialize_tty_struct(struct tty_struct *tty);
487
extern struct tty_struct *tty_init_dev(struct tty_driver *driver, int idx);
488
extern int tty_release(struct inode *inode, struct file *filp);
489
extern int tty_init_termios(struct tty_struct *tty);
490 491
extern int tty_standard_install(struct tty_driver *driver,
		struct tty_struct *tty);
492

493 494 495
extern struct tty_struct *tty_pair_get_tty(struct tty_struct *tty);
extern struct tty_struct *tty_pair_get_pty(struct tty_struct *tty);

I
Ingo Molnar 已提交
496
extern struct mutex tty_mutex;
N
Nick Piggin 已提交
497
extern spinlock_t tty_files_lock;
L
Linus Torvalds 已提交
498

499 500 501 502
extern void tty_write_unlock(struct tty_struct *tty);
extern int tty_write_lock(struct tty_struct *tty, int ndelay);
#define tty_is_writelocked(tty)  (mutex_is_locked(&tty->atomic_write_lock))

503
extern void tty_port_init(struct tty_port *port);
J
Jiri Slaby 已提交
504 505
extern void tty_port_link_device(struct tty_port *port,
		struct tty_driver *driver, unsigned index);
506 507 508
extern struct device *tty_port_register_device(struct tty_port *port,
		struct tty_driver *driver, unsigned index,
		struct device *device);
509 510 511 512
extern struct device *tty_port_register_device_attr(struct tty_port *port,
		struct tty_driver *driver, unsigned index,
		struct device *device, void *drvdata,
		const struct attribute_group **attr_grp);
513 514
extern int tty_port_alloc_xmit_buf(struct tty_port *port);
extern void tty_port_free_xmit_buf(struct tty_port *port);
J
Jiri Slaby 已提交
515
extern void tty_port_destroy(struct tty_port *port);
516 517
extern void tty_port_put(struct tty_port *port);

518
static inline struct tty_port *tty_port_get(struct tty_port *port)
519 520 521 522 523 524
{
	if (port)
		kref_get(&port->kref);
	return port;
}

H
Huang Shijie 已提交
525 526 527 528 529 530
/* If the cts flow control is enabled, return true. */
static inline bool tty_port_cts_enabled(struct tty_port *port)
{
	return port->flags & ASYNC_CTS_FLOW;
}

A
Alan Cox 已提交
531 532
extern struct tty_struct *tty_port_tty_get(struct tty_port *port);
extern void tty_port_tty_set(struct tty_port *port, struct tty_struct *tty);
533
extern int tty_port_carrier_raised(struct tty_port *port);
A
Alan Cox 已提交
534
extern void tty_port_raise_dtr_rts(struct tty_port *port);
535
extern void tty_port_lower_dtr_rts(struct tty_port *port);
536
extern void tty_port_hangup(struct tty_port *port);
537 538
extern int tty_port_block_til_ready(struct tty_port *port,
				struct tty_struct *tty, struct file *filp);
539 540 541
extern int tty_port_close_start(struct tty_port *port,
				struct tty_struct *tty, struct file *filp);
extern void tty_port_close_end(struct tty_port *port, struct tty_struct *tty);
A
Alan Cox 已提交
542 543
extern void tty_port_close(struct tty_port *port,
				struct tty_struct *tty, struct file *filp);
544 545
extern int tty_port_install(struct tty_port *port, struct tty_driver *driver,
				struct tty_struct *tty);
A
Alan Cox 已提交
546 547
extern int tty_port_open(struct tty_port *port,
				struct tty_struct *tty, struct file *filp);
548
static inline int tty_port_users(struct tty_port *port)
A
Alan Cox 已提交
549 550 551 552
{
	return port->count + port->blocked_open;
}

553 554 555 556 557 558
extern int tty_register_ldisc(int disc, struct tty_ldisc_ops *new_ldisc);
extern int tty_unregister_ldisc(int disc);
extern int tty_set_ldisc(struct tty_struct *tty, int ldisc);
extern int tty_ldisc_setup(struct tty_struct *tty, struct tty_struct *o_tty);
extern void tty_ldisc_release(struct tty_struct *tty, struct tty_struct *o_tty);
extern void tty_ldisc_init(struct tty_struct *tty);
559
extern void tty_ldisc_deinit(struct tty_struct *tty);
560 561 562
extern void tty_ldisc_begin(void);
/* This last one is just for the tty layer internals and shouldn't be used elsewhere */
extern void tty_ldisc_enable(struct tty_struct *tty);
563 564


L
Linus Torvalds 已提交
565
/* n_tty.c */
A
Alan Cox 已提交
566
extern struct tty_ldisc_ops tty_ldisc_N_TTY;
567
extern void n_tty_inherit_ops(struct tty_ldisc_ops *ops);
L
Linus Torvalds 已提交
568

M
Miloslav Trmac 已提交
569 570 571
/* tty_audit.c */
#ifdef CONFIG_AUDIT
extern void tty_audit_add_data(struct tty_struct *tty, unsigned char *data,
572
			       size_t size, unsigned icanon);
M
Miloslav Trmac 已提交
573 574
extern void tty_audit_exit(void);
extern void tty_audit_fork(struct signal_struct *sig);
A
Al Viro 已提交
575
extern void tty_audit_tiocsti(struct tty_struct *tty, char ch);
M
Miloslav Trmac 已提交
576
extern void tty_audit_push(struct tty_struct *tty);
577
extern int tty_audit_push_task(struct task_struct *tsk,
578
			       kuid_t loginuid, u32 sessionid);
M
Miloslav Trmac 已提交
579 580
#else
static inline void tty_audit_add_data(struct tty_struct *tty,
581
		unsigned char *data, size_t size, unsigned icanon)
M
Miloslav Trmac 已提交
582 583
{
}
A
Al Viro 已提交
584 585 586
static inline void tty_audit_tiocsti(struct tty_struct *tty, char ch)
{
}
M
Miloslav Trmac 已提交
587 588 589 590 591 592 593 594 595
static inline void tty_audit_exit(void)
{
}
static inline void tty_audit_fork(struct signal_struct *sig)
{
}
static inline void tty_audit_push(struct tty_struct *tty)
{
}
596
static inline int tty_audit_push_task(struct task_struct *tsk,
597
				      kuid_t loginuid, u32 sessionid)
M
Miloslav Trmac 已提交
598
{
599
	return 0;
M
Miloslav Trmac 已提交
600 601 602
}
#endif

L
Linus Torvalds 已提交
603
/* tty_ioctl.c */
604
extern int n_tty_ioctl_helper(struct tty_struct *tty, struct file *file,
L
Linus Torvalds 已提交
605
		       unsigned int cmd, unsigned long arg);
606 607
extern long n_tty_compat_ioctl_helper(struct tty_struct *tty, struct file *file,
		       unsigned int cmd, unsigned long arg);
L
Linus Torvalds 已提交
608 609 610 611

/* serial.c */

extern void serial_console_init(void);
A
Alan Cox 已提交
612

L
Linus Torvalds 已提交
613 614 615 616 617 618
/* pcxx.c */

extern int pcxe_open(struct tty_struct *tty, struct file *filp);

/* vt.c */

619
extern int vt_ioctl(struct tty_struct *tty,
L
Linus Torvalds 已提交
620 621
		    unsigned int cmd, unsigned long arg);

622
extern long vt_compat_ioctl(struct tty_struct *tty,
623 624
		     unsigned int cmd, unsigned long arg);

625
/* tty_mutex.c */
626
/* functions for preparation of BKL removal */
A
Alan Cox 已提交
627 628 629 630 631 632
extern void __lockfunc tty_lock(struct tty_struct *tty);
extern void __lockfunc tty_unlock(struct tty_struct *tty);
extern void __lockfunc tty_lock_pair(struct tty_struct *tty,
				struct tty_struct *tty2);
extern void __lockfunc tty_unlock_pair(struct tty_struct *tty,
				struct tty_struct *tty2);
633

634 635 636 637 638 639 640 641 642 643 644 645 646
/*
 * this shall be called only from where BTM is held (like close)
 *
 * We need this to ensure nobody waits for us to finish while we are waiting.
 * Without this we were encountering system stalls.
 *
 * This should be indeed removed with BTM removal later.
 *
 * Locking: BTM required. Nobody is allowed to hold port->mutex.
 */
static inline void tty_wait_until_sent_from_close(struct tty_struct *tty,
		long timeout)
{
A
Alan Cox 已提交
647
	tty_unlock(tty); /* tty->ops->close holds the BTM, drop it while waiting */
648
	tty_wait_until_sent(tty, timeout);
A
Alan Cox 已提交
649
	tty_lock(tty);
650
}
651

652 653 654 655 656 657 658 659 660 661 662 663
/*
 * wait_event_interruptible_tty -- wait for a condition with the tty lock held
 *
 * The condition we are waiting for might take a long time to
 * become true, or might depend on another thread taking the
 * BTM. In either case, we need to drop the BTM to guarantee
 * forward progress. This is a leftover from the conversion
 * from the BKL and should eventually get removed as the BTM
 * falls out of use.
 *
 * Do not use in new code.
 */
A
Alan Cox 已提交
664
#define wait_event_interruptible_tty(tty, wq, condition)		\
665 666 667
({									\
	int __ret = 0;							\
	if (!(condition)) {						\
A
Alan Cox 已提交
668
		__wait_event_interruptible_tty(tty, wq, condition, __ret);	\
669 670 671 672
	}								\
	__ret;								\
})

A
Alan Cox 已提交
673
#define __wait_event_interruptible_tty(tty, wq, condition, ret)		\
674 675 676 677 678 679 680 681
do {									\
	DEFINE_WAIT(__wait);						\
									\
	for (;;) {							\
		prepare_to_wait(&wq, &__wait, TASK_INTERRUPTIBLE);	\
		if (condition)						\
			break;						\
		if (!signal_pending(current)) {				\
A
Alan Cox 已提交
682
			tty_unlock(tty);					\
683
			schedule();					\
A
Alan Cox 已提交
684
			tty_lock(tty);					\
685 686 687 688 689 690 691 692 693
			continue;					\
		}							\
		ret = -ERESTARTSYS;					\
		break;							\
	}								\
	finish_wait(&wq, &__wait);					\
} while (0)


L
Linus Torvalds 已提交
694
#endif