tty.h 25 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720
  1. #ifndef _LINUX_TTY_H
  2. #define _LINUX_TTY_H
  3. #include <linux/fs.h>
  4. #include <linux/major.h>
  5. #include <linux/termios.h>
  6. #include <linux/workqueue.h>
  7. #include <linux/tty_driver.h>
  8. #include <linux/tty_ldisc.h>
  9. #include <linux/mutex.h>
  10. #include <linux/tty_flags.h>
  11. #include <uapi/linux/tty.h>
  12. #include <linux/rwsem.h>
  13. #include <linux/llist.h>
  14. /*
  15. * (Note: the *_driver.minor_start values 1, 64, 128, 192 are
  16. * hardcoded at present.)
  17. */
  18. #define NR_UNIX98_PTY_DEFAULT 4096 /* Default maximum for Unix98 ptys */
  19. #define NR_UNIX98_PTY_RESERVE 1024 /* Default reserve for main devpts */
  20. #define NR_UNIX98_PTY_MAX (1 << MINORBITS) /* Absolute limit */
  21. /*
  22. * This character is the same as _POSIX_VDISABLE: it cannot be used as
  23. * a c_cc[] character, but indicates that a particular special character
  24. * isn't in use (eg VINTR has no character etc)
  25. */
  26. #define __DISABLED_CHAR '\0'
  27. struct tty_buffer {
  28. union {
  29. struct tty_buffer *next;
  30. struct llist_node free;
  31. };
  32. int used;
  33. int size;
  34. int commit;
  35. int read;
  36. /* Data points here */
  37. unsigned long data[0];
  38. };
  39. static inline unsigned char *char_buf_ptr(struct tty_buffer *b, int ofs)
  40. {
  41. return ((unsigned char *)b->data) + ofs;
  42. }
  43. static inline char *flag_buf_ptr(struct tty_buffer *b, int ofs)
  44. {
  45. return (char *)char_buf_ptr(b, ofs) + b->size;
  46. }
  47. /*
  48. * We default to dicing tty buffer allocations to this many characters
  49. * in order to avoid multiple page allocations. We know the size of
  50. * tty_buffer itself but it must also be taken into account that the
  51. * the buffer is 256 byte aligned. See tty_buffer_find for the allocation
  52. * logic this must match
  53. */
  54. #define TTY_BUFFER_PAGE (((PAGE_SIZE - sizeof(struct tty_buffer)) / 2) & ~0xFF)
  55. struct tty_bufhead {
  56. struct tty_buffer *head; /* Queue head */
  57. struct work_struct work;
  58. struct mutex lock;
  59. atomic_t priority;
  60. struct tty_buffer sentinel;
  61. struct llist_head free; /* Free queue head */
  62. atomic_t memory_used; /* In-use buffers excluding free list */
  63. struct tty_buffer *tail; /* Active buffer */
  64. };
  65. /*
  66. * When a break, frame error, or parity error happens, these codes are
  67. * stuffed into the flags buffer.
  68. */
  69. #define TTY_NORMAL 0
  70. #define TTY_BREAK 1
  71. #define TTY_FRAME 2
  72. #define TTY_PARITY 3
  73. #define TTY_OVERRUN 4
  74. #define INTR_CHAR(tty) ((tty)->termios.c_cc[VINTR])
  75. #define QUIT_CHAR(tty) ((tty)->termios.c_cc[VQUIT])
  76. #define ERASE_CHAR(tty) ((tty)->termios.c_cc[VERASE])
  77. #define KILL_CHAR(tty) ((tty)->termios.c_cc[VKILL])
  78. #define EOF_CHAR(tty) ((tty)->termios.c_cc[VEOF])
  79. #define TIME_CHAR(tty) ((tty)->termios.c_cc[VTIME])
  80. #define MIN_CHAR(tty) ((tty)->termios.c_cc[VMIN])
  81. #define SWTC_CHAR(tty) ((tty)->termios.c_cc[VSWTC])
  82. #define START_CHAR(tty) ((tty)->termios.c_cc[VSTART])
  83. #define STOP_CHAR(tty) ((tty)->termios.c_cc[VSTOP])
  84. #define SUSP_CHAR(tty) ((tty)->termios.c_cc[VSUSP])
  85. #define EOL_CHAR(tty) ((tty)->termios.c_cc[VEOL])
  86. #define REPRINT_CHAR(tty) ((tty)->termios.c_cc[VREPRINT])
  87. #define DISCARD_CHAR(tty) ((tty)->termios.c_cc[VDISCARD])
  88. #define WERASE_CHAR(tty) ((tty)->termios.c_cc[VWERASE])
  89. #define LNEXT_CHAR(tty) ((tty)->termios.c_cc[VLNEXT])
  90. #define EOL2_CHAR(tty) ((tty)->termios.c_cc[VEOL2])
  91. #define _I_FLAG(tty, f) ((tty)->termios.c_iflag & (f))
  92. #define _O_FLAG(tty, f) ((tty)->termios.c_oflag & (f))
  93. #define _C_FLAG(tty, f) ((tty)->termios.c_cflag & (f))
  94. #define _L_FLAG(tty, f) ((tty)->termios.c_lflag & (f))
  95. #define I_IGNBRK(tty) _I_FLAG((tty), IGNBRK)
  96. #define I_BRKINT(tty) _I_FLAG((tty), BRKINT)
  97. #define I_IGNPAR(tty) _I_FLAG((tty), IGNPAR)
  98. #define I_PARMRK(tty) _I_FLAG((tty), PARMRK)
  99. #define I_INPCK(tty) _I_FLAG((tty), INPCK)
  100. #define I_ISTRIP(tty) _I_FLAG((tty), ISTRIP)
  101. #define I_INLCR(tty) _I_FLAG((tty), INLCR)
  102. #define I_IGNCR(tty) _I_FLAG((tty), IGNCR)
  103. #define I_ICRNL(tty) _I_FLAG((tty), ICRNL)
  104. #define I_IUCLC(tty) _I_FLAG((tty), IUCLC)
  105. #define I_IXON(tty) _I_FLAG((tty), IXON)
  106. #define I_IXANY(tty) _I_FLAG((tty), IXANY)
  107. #define I_IXOFF(tty) _I_FLAG((tty), IXOFF)
  108. #define I_IMAXBEL(tty) _I_FLAG((tty), IMAXBEL)
  109. #define I_IUTF8(tty) _I_FLAG((tty), IUTF8)
  110. #define O_OPOST(tty) _O_FLAG((tty), OPOST)
  111. #define O_OLCUC(tty) _O_FLAG((tty), OLCUC)
  112. #define O_ONLCR(tty) _O_FLAG((tty), ONLCR)
  113. #define O_OCRNL(tty) _O_FLAG((tty), OCRNL)
  114. #define O_ONOCR(tty) _O_FLAG((tty), ONOCR)
  115. #define O_ONLRET(tty) _O_FLAG((tty), ONLRET)
  116. #define O_OFILL(tty) _O_FLAG((tty), OFILL)
  117. #define O_OFDEL(tty) _O_FLAG((tty), OFDEL)
  118. #define O_NLDLY(tty) _O_FLAG((tty), NLDLY)
  119. #define O_CRDLY(tty) _O_FLAG((tty), CRDLY)
  120. #define O_TABDLY(tty) _O_FLAG((tty), TABDLY)
  121. #define O_BSDLY(tty) _O_FLAG((tty), BSDLY)
  122. #define O_VTDLY(tty) _O_FLAG((tty), VTDLY)
  123. #define O_FFDLY(tty) _O_FLAG((tty), FFDLY)
  124. #define C_BAUD(tty) _C_FLAG((tty), CBAUD)
  125. #define C_CSIZE(tty) _C_FLAG((tty), CSIZE)
  126. #define C_CSTOPB(tty) _C_FLAG((tty), CSTOPB)
  127. #define C_CREAD(tty) _C_FLAG((tty), CREAD)
  128. #define C_PARENB(tty) _C_FLAG((tty), PARENB)
  129. #define C_PARODD(tty) _C_FLAG((tty), PARODD)
  130. #define C_HUPCL(tty) _C_FLAG((tty), HUPCL)
  131. #define C_CLOCAL(tty) _C_FLAG((tty), CLOCAL)
  132. #define C_CIBAUD(tty) _C_FLAG((tty), CIBAUD)
  133. #define C_CRTSCTS(tty) _C_FLAG((tty), CRTSCTS)
  134. #define L_ISIG(tty) _L_FLAG((tty), ISIG)
  135. #define L_ICANON(tty) _L_FLAG((tty), ICANON)
  136. #define L_XCASE(tty) _L_FLAG((tty), XCASE)
  137. #define L_ECHO(tty) _L_FLAG((tty), ECHO)
  138. #define L_ECHOE(tty) _L_FLAG((tty), ECHOE)
  139. #define L_ECHOK(tty) _L_FLAG((tty), ECHOK)
  140. #define L_ECHONL(tty) _L_FLAG((tty), ECHONL)
  141. #define L_NOFLSH(tty) _L_FLAG((tty), NOFLSH)
  142. #define L_TOSTOP(tty) _L_FLAG((tty), TOSTOP)
  143. #define L_ECHOCTL(tty) _L_FLAG((tty), ECHOCTL)
  144. #define L_ECHOPRT(tty) _L_FLAG((tty), ECHOPRT)
  145. #define L_ECHOKE(tty) _L_FLAG((tty), ECHOKE)
  146. #define L_FLUSHO(tty) _L_FLAG((tty), FLUSHO)
  147. #define L_PENDIN(tty) _L_FLAG((tty), PENDIN)
  148. #define L_IEXTEN(tty) _L_FLAG((tty), IEXTEN)
  149. #define L_EXTPROC(tty) _L_FLAG((tty), EXTPROC)
  150. struct device;
  151. struct signal_struct;
  152. /*
  153. * Port level information. Each device keeps its own port level information
  154. * so provide a common structure for those ports wanting to use common support
  155. * routines.
  156. *
  157. * The tty port has a different lifetime to the tty so must be kept apart.
  158. * In addition be careful as tty -> port mappings are valid for the life
  159. * of the tty object but in many cases port -> tty mappings are valid only
  160. * until a hangup so don't use the wrong path.
  161. */
  162. struct tty_port;
  163. struct tty_port_operations {
  164. /* Return 1 if the carrier is raised */
  165. int (*carrier_raised)(struct tty_port *port);
  166. /* Control the DTR line */
  167. void (*dtr_rts)(struct tty_port *port, int raise);
  168. /* Called when the last close completes or a hangup finishes
  169. IFF the port was initialized. Do not use to free resources. Called
  170. under the port mutex to serialize against activate/shutdowns */
  171. void (*shutdown)(struct tty_port *port);
  172. void (*drop)(struct tty_port *port);
  173. /* Called under the port mutex from tty_port_open, serialized using
  174. the port mutex */
  175. /* FIXME: long term getting the tty argument *out* of this would be
  176. good for consoles */
  177. int (*activate)(struct tty_port *port, struct tty_struct *tty);
  178. /* Called on the final put of a port */
  179. void (*destruct)(struct tty_port *port);
  180. };
  181. struct tty_port {
  182. struct tty_bufhead buf; /* Locked internally */
  183. struct tty_struct *tty; /* Back pointer */
  184. struct tty_struct *itty; /* internal back ptr */
  185. const struct tty_port_operations *ops; /* Port operations */
  186. spinlock_t lock; /* Lock protecting tty field */
  187. int blocked_open; /* Waiting to open */
  188. int count; /* Usage count */
  189. wait_queue_head_t open_wait; /* Open waiters */
  190. wait_queue_head_t close_wait; /* Close waiters */
  191. wait_queue_head_t delta_msr_wait; /* Modem status change */
  192. unsigned long flags; /* TTY flags ASY_*/
  193. unsigned char console:1, /* port is a console */
  194. low_latency:1; /* direct buffer flush */
  195. struct mutex mutex; /* Locking */
  196. struct mutex buf_mutex; /* Buffer alloc lock */
  197. unsigned char *xmit_buf; /* Optional buffer */
  198. unsigned int close_delay; /* Close port delay */
  199. unsigned int closing_wait; /* Delay for output */
  200. int drain_delay; /* Set to zero if no pure time
  201. based drain is needed else
  202. set to size of fifo */
  203. struct kref kref; /* Ref counter */
  204. };
  205. /*
  206. * Where all of the state associated with a tty is kept while the tty
  207. * is open. Since the termios state should be kept even if the tty
  208. * has been closed --- for things like the baud rate, etc --- it is
  209. * not stored here, but rather a pointer to the real state is stored
  210. * here. Possible the winsize structure should have the same
  211. * treatment, but (1) the default 80x24 is usually right and (2) it's
  212. * most often used by a windowing system, which will set the correct
  213. * size each time the window is created or resized anyway.
  214. * - TYT, 9/14/92
  215. */
  216. struct tty_operations;
  217. struct tty_struct {
  218. int magic;
  219. struct kref kref;
  220. struct device *dev;
  221. struct tty_driver *driver;
  222. const struct tty_operations *ops;
  223. int index;
  224. /* Protects ldisc changes: Lock tty not pty */
  225. struct ld_semaphore ldisc_sem;
  226. struct tty_ldisc *ldisc;
  227. struct mutex atomic_write_lock;
  228. struct mutex legacy_mutex;
  229. struct mutex throttle_mutex;
  230. struct rw_semaphore termios_rwsem;
  231. spinlock_t ctrl_lock;
  232. /* Termios values are protected by the termios rwsem */
  233. struct ktermios termios, termios_locked;
  234. struct termiox *termiox; /* May be NULL for unsupported */
  235. char name[64];
  236. struct pid *pgrp; /* Protected by ctrl lock */
  237. struct pid *session;
  238. unsigned long flags;
  239. int count;
  240. struct winsize winsize; /* termios rwsem */
  241. unsigned char stopped:1, hw_stopped:1, flow_stopped:1, packet:1;
  242. unsigned char ctrl_status; /* ctrl_lock */
  243. unsigned int receive_room; /* Bytes free for queue */
  244. int flow_change;
  245. struct tty_struct *link;
  246. struct fasync_struct *fasync;
  247. int alt_speed; /* For magic substitution of 38400 bps */
  248. wait_queue_head_t write_wait;
  249. wait_queue_head_t read_wait;
  250. struct work_struct hangup_work;
  251. void *disc_data;
  252. void *driver_data;
  253. struct list_head tty_files;
  254. #define N_TTY_BUF_SIZE 4096
  255. unsigned char closing:1;
  256. unsigned char *write_buf;
  257. int write_cnt;
  258. /* If the tty has a pending do_SAK, queue it here - akpm */
  259. struct work_struct SAK_work;
  260. struct tty_port *port;
  261. };
  262. /* Each of a tty's open files has private_data pointing to tty_file_private */
  263. struct tty_file_private {
  264. struct tty_struct *tty;
  265. struct file *file;
  266. struct list_head list;
  267. };
  268. /* tty magic number */
  269. #define TTY_MAGIC 0x5401
  270. /*
  271. * These bits are used in the flags field of the tty structure.
  272. *
  273. * So that interrupts won't be able to mess up the queues,
  274. * copy_to_cooked must be atomic with respect to itself, as must
  275. * tty->write. Thus, you must use the inline functions set_bit() and
  276. * clear_bit() to make things atomic.
  277. */
  278. #define TTY_THROTTLED 0 /* Call unthrottle() at threshold min */
  279. #define TTY_IO_ERROR 1 /* Cause an I/O error (may be no ldisc too) */
  280. #define TTY_OTHER_CLOSED 2 /* Other side (if any) has closed */
  281. #define TTY_EXCLUSIVE 3 /* Exclusive open mode */
  282. #define TTY_DEBUG 4 /* Debugging */
  283. #define TTY_DO_WRITE_WAKEUP 5 /* Call write_wakeup after queuing new */
  284. #define TTY_PUSH 6 /* n_tty private */
  285. #define TTY_CLOSING 7 /* ->close() in progress */
  286. #define TTY_LDISC_OPEN 11 /* Line discipline is open */
  287. #define TTY_PTY_LOCK 16 /* pty private */
  288. #define TTY_NO_WRITE_SPLIT 17 /* Preserve write boundaries to driver */
  289. #define TTY_HUPPED 18 /* Post driver->hangup() */
  290. #define TTY_HUPPING 21 /* ->hangup() in progress */
  291. #define TTY_LDISC_HALTED 22 /* Line discipline is halted */
  292. #define TTY_WRITE_FLUSH(tty) tty_write_flush((tty))
  293. /* Values for tty->flow_change */
  294. #define TTY_THROTTLE_SAFE 1
  295. #define TTY_UNTHROTTLE_SAFE 2
  296. static inline void __tty_set_flow_change(struct tty_struct *tty, int val)
  297. {
  298. tty->flow_change = val;
  299. }
  300. static inline void tty_set_flow_change(struct tty_struct *tty, int val)
  301. {
  302. tty->flow_change = val;
  303. smp_mb();
  304. }
  305. #ifdef CONFIG_TTY
  306. extern void console_init(void);
  307. extern void tty_kref_put(struct tty_struct *tty);
  308. extern struct pid *tty_get_pgrp(struct tty_struct *tty);
  309. extern void tty_vhangup_self(void);
  310. extern void disassociate_ctty(int priv);
  311. extern dev_t tty_devnum(struct tty_struct *tty);
  312. extern void proc_clear_tty(struct task_struct *p);
  313. extern struct tty_struct *get_current_tty(void);
  314. /* tty_io.c */
  315. extern int __init tty_init(void);
  316. #else
  317. static inline void console_init(void)
  318. { }
  319. static inline void tty_kref_put(struct tty_struct *tty)
  320. { }
  321. static inline struct pid *tty_get_pgrp(struct tty_struct *tty)
  322. { return NULL; }
  323. static inline void tty_vhangup_self(void)
  324. { }
  325. static inline void disassociate_ctty(int priv)
  326. { }
  327. static inline dev_t tty_devnum(struct tty_struct *tty)
  328. { return 0; }
  329. static inline void proc_clear_tty(struct task_struct *p)
  330. { }
  331. static inline struct tty_struct *get_current_tty(void)
  332. { return NULL; }
  333. /* tty_io.c */
  334. static inline int __init tty_init(void)
  335. { return 0; }
  336. #endif
  337. extern void tty_write_flush(struct tty_struct *);
  338. extern struct ktermios tty_std_termios;
  339. extern int vcs_init(void);
  340. extern struct class *tty_class;
  341. /**
  342. * tty_kref_get - get a tty reference
  343. * @tty: tty device
  344. *
  345. * Return a new reference to a tty object. The caller must hold
  346. * sufficient locks/counts to ensure that their existing reference cannot
  347. * go away
  348. */
  349. static inline struct tty_struct *tty_kref_get(struct tty_struct *tty)
  350. {
  351. if (tty)
  352. kref_get(&tty->kref);
  353. return tty;
  354. }
  355. extern int tty_paranoia_check(struct tty_struct *tty, struct inode *inode,
  356. const char *routine);
  357. extern char *tty_name(struct tty_struct *tty, char *buf);
  358. extern void tty_wait_until_sent(struct tty_struct *tty, long timeout);
  359. extern int tty_check_change(struct tty_struct *tty);
  360. extern void stop_tty(struct tty_struct *tty);
  361. extern void start_tty(struct tty_struct *tty);
  362. extern int tty_register_driver(struct tty_driver *driver);
  363. extern int tty_unregister_driver(struct tty_driver *driver);
  364. extern struct device *tty_register_device(struct tty_driver *driver,
  365. unsigned index, struct device *dev);
  366. extern struct device *tty_register_device_attr(struct tty_driver *driver,
  367. unsigned index, struct device *device,
  368. void *drvdata,
  369. const struct attribute_group **attr_grp);
  370. extern void tty_unregister_device(struct tty_driver *driver, unsigned index);
  371. extern int tty_read_raw_data(struct tty_struct *tty, unsigned char *bufp,
  372. int buflen);
  373. extern void tty_write_message(struct tty_struct *tty, char *msg);
  374. extern int tty_put_char(struct tty_struct *tty, unsigned char c);
  375. extern int tty_chars_in_buffer(struct tty_struct *tty);
  376. extern int tty_write_room(struct tty_struct *tty);
  377. extern void tty_driver_flush_buffer(struct tty_struct *tty);
  378. extern void tty_throttle(struct tty_struct *tty);
  379. extern void tty_unthrottle(struct tty_struct *tty);
  380. extern int tty_throttle_safe(struct tty_struct *tty);
  381. extern int tty_unthrottle_safe(struct tty_struct *tty);
  382. extern int tty_do_resize(struct tty_struct *tty, struct winsize *ws);
  383. extern void tty_driver_remove_tty(struct tty_driver *driver,
  384. struct tty_struct *tty);
  385. extern void tty_free_termios(struct tty_struct *tty);
  386. extern int is_current_pgrp_orphaned(void);
  387. extern int is_ignored(int sig);
  388. extern int tty_signal(int sig, struct tty_struct *tty);
  389. extern void tty_hangup(struct tty_struct *tty);
  390. extern void tty_vhangup(struct tty_struct *tty);
  391. extern void tty_vhangup_locked(struct tty_struct *tty);
  392. extern void tty_unhangup(struct file *filp);
  393. extern int tty_hung_up_p(struct file *filp);
  394. extern void do_SAK(struct tty_struct *tty);
  395. extern void __do_SAK(struct tty_struct *tty);
  396. extern void no_tty(void);
  397. extern void tty_flush_to_ldisc(struct tty_struct *tty);
  398. extern void tty_buffer_free_all(struct tty_port *port);
  399. extern void tty_buffer_flush(struct tty_struct *tty);
  400. extern void tty_buffer_init(struct tty_port *port);
  401. extern speed_t tty_termios_baud_rate(struct ktermios *termios);
  402. extern speed_t tty_termios_input_baud_rate(struct ktermios *termios);
  403. extern void tty_termios_encode_baud_rate(struct ktermios *termios,
  404. speed_t ibaud, speed_t obaud);
  405. extern void tty_encode_baud_rate(struct tty_struct *tty,
  406. speed_t ibaud, speed_t obaud);
  407. /**
  408. * tty_get_baud_rate - get tty bit rates
  409. * @tty: tty to query
  410. *
  411. * Returns the baud rate as an integer for this terminal. The
  412. * termios lock must be held by the caller and the terminal bit
  413. * flags may be updated.
  414. *
  415. * Locking: none
  416. */
  417. static inline speed_t tty_get_baud_rate(struct tty_struct *tty)
  418. {
  419. return tty_termios_baud_rate(&tty->termios);
  420. }
  421. extern void tty_termios_copy_hw(struct ktermios *new, struct ktermios *old);
  422. extern int tty_termios_hw_change(struct ktermios *a, struct ktermios *b);
  423. extern int tty_set_termios(struct tty_struct *tty, struct ktermios *kt);
  424. extern struct tty_ldisc *tty_ldisc_ref(struct tty_struct *);
  425. extern void tty_ldisc_deref(struct tty_ldisc *);
  426. extern struct tty_ldisc *tty_ldisc_ref_wait(struct tty_struct *);
  427. extern void tty_ldisc_hangup(struct tty_struct *tty);
  428. extern const struct file_operations tty_ldiscs_proc_fops;
  429. extern void tty_wakeup(struct tty_struct *tty);
  430. extern void tty_ldisc_flush(struct tty_struct *tty);
  431. extern long tty_ioctl(struct file *file, unsigned int cmd, unsigned long arg);
  432. extern int tty_mode_ioctl(struct tty_struct *tty, struct file *file,
  433. unsigned int cmd, unsigned long arg);
  434. extern int tty_perform_flush(struct tty_struct *tty, unsigned long arg);
  435. extern void tty_default_fops(struct file_operations *fops);
  436. extern struct tty_struct *alloc_tty_struct(void);
  437. extern int tty_alloc_file(struct file *file);
  438. extern void tty_add_file(struct tty_struct *tty, struct file *file);
  439. extern void tty_free_file(struct file *file);
  440. extern void free_tty_struct(struct tty_struct *tty);
  441. extern void initialize_tty_struct(struct tty_struct *tty,
  442. struct tty_driver *driver, int idx);
  443. extern void deinitialize_tty_struct(struct tty_struct *tty);
  444. extern struct tty_struct *tty_init_dev(struct tty_driver *driver, int idx);
  445. extern int tty_release(struct inode *inode, struct file *filp);
  446. extern int tty_init_termios(struct tty_struct *tty);
  447. extern int tty_standard_install(struct tty_driver *driver,
  448. struct tty_struct *tty);
  449. extern struct tty_struct *tty_pair_get_tty(struct tty_struct *tty);
  450. extern struct tty_struct *tty_pair_get_pty(struct tty_struct *tty);
  451. extern struct mutex tty_mutex;
  452. extern spinlock_t tty_files_lock;
  453. extern void tty_write_unlock(struct tty_struct *tty);
  454. extern int tty_write_lock(struct tty_struct *tty, int ndelay);
  455. #define tty_is_writelocked(tty) (mutex_is_locked(&tty->atomic_write_lock))
  456. extern void tty_port_init(struct tty_port *port);
  457. extern void tty_port_link_device(struct tty_port *port,
  458. struct tty_driver *driver, unsigned index);
  459. extern struct device *tty_port_register_device(struct tty_port *port,
  460. struct tty_driver *driver, unsigned index,
  461. struct device *device);
  462. extern struct device *tty_port_register_device_attr(struct tty_port *port,
  463. struct tty_driver *driver, unsigned index,
  464. struct device *device, void *drvdata,
  465. const struct attribute_group **attr_grp);
  466. extern int tty_port_alloc_xmit_buf(struct tty_port *port);
  467. extern void tty_port_free_xmit_buf(struct tty_port *port);
  468. extern void tty_port_destroy(struct tty_port *port);
  469. extern void tty_port_put(struct tty_port *port);
  470. static inline struct tty_port *tty_port_get(struct tty_port *port)
  471. {
  472. if (port)
  473. kref_get(&port->kref);
  474. return port;
  475. }
  476. /* If the cts flow control is enabled, return true. */
  477. static inline bool tty_port_cts_enabled(struct tty_port *port)
  478. {
  479. return port->flags & ASYNC_CTS_FLOW;
  480. }
  481. extern struct tty_struct *tty_port_tty_get(struct tty_port *port);
  482. extern void tty_port_tty_set(struct tty_port *port, struct tty_struct *tty);
  483. extern int tty_port_carrier_raised(struct tty_port *port);
  484. extern void tty_port_raise_dtr_rts(struct tty_port *port);
  485. extern void tty_port_lower_dtr_rts(struct tty_port *port);
  486. extern void tty_port_hangup(struct tty_port *port);
  487. extern void tty_port_tty_hangup(struct tty_port *port, bool check_clocal);
  488. extern void tty_port_tty_wakeup(struct tty_port *port);
  489. extern int tty_port_block_til_ready(struct tty_port *port,
  490. struct tty_struct *tty, struct file *filp);
  491. extern int tty_port_close_start(struct tty_port *port,
  492. struct tty_struct *tty, struct file *filp);
  493. extern void tty_port_close_end(struct tty_port *port, struct tty_struct *tty);
  494. extern void tty_port_close(struct tty_port *port,
  495. struct tty_struct *tty, struct file *filp);
  496. extern int tty_port_install(struct tty_port *port, struct tty_driver *driver,
  497. struct tty_struct *tty);
  498. extern int tty_port_open(struct tty_port *port,
  499. struct tty_struct *tty, struct file *filp);
  500. static inline int tty_port_users(struct tty_port *port)
  501. {
  502. return port->count + port->blocked_open;
  503. }
  504. extern int tty_register_ldisc(int disc, struct tty_ldisc_ops *new_ldisc);
  505. extern int tty_unregister_ldisc(int disc);
  506. extern int tty_set_ldisc(struct tty_struct *tty, int ldisc);
  507. extern int tty_ldisc_setup(struct tty_struct *tty, struct tty_struct *o_tty);
  508. extern void tty_ldisc_release(struct tty_struct *tty, struct tty_struct *o_tty);
  509. extern void tty_ldisc_init(struct tty_struct *tty);
  510. extern void tty_ldisc_deinit(struct tty_struct *tty);
  511. extern void tty_ldisc_begin(void);
  512. static inline int tty_ldisc_receive_buf(struct tty_ldisc *ld, unsigned char *p,
  513. char *f, int count)
  514. {
  515. if (ld->ops->receive_buf2)
  516. count = ld->ops->receive_buf2(ld->tty, p, f, count);
  517. else {
  518. count = min_t(int, count, ld->tty->receive_room);
  519. if (count)
  520. ld->ops->receive_buf(ld->tty, p, f, count);
  521. }
  522. return count;
  523. }
  524. /* n_tty.c */
  525. extern struct tty_ldisc_ops tty_ldisc_N_TTY;
  526. extern void n_tty_inherit_ops(struct tty_ldisc_ops *ops);
  527. /* tty_audit.c */
  528. #ifdef CONFIG_AUDIT
  529. extern void tty_audit_add_data(struct tty_struct *tty, unsigned char *data,
  530. size_t size, unsigned icanon);
  531. extern void tty_audit_exit(void);
  532. extern void tty_audit_fork(struct signal_struct *sig);
  533. extern void tty_audit_tiocsti(struct tty_struct *tty, char ch);
  534. extern void tty_audit_push(struct tty_struct *tty);
  535. extern int tty_audit_push_current(void);
  536. #else
  537. static inline void tty_audit_add_data(struct tty_struct *tty,
  538. unsigned char *data, size_t size, unsigned icanon)
  539. {
  540. }
  541. static inline void tty_audit_tiocsti(struct tty_struct *tty, char ch)
  542. {
  543. }
  544. static inline void tty_audit_exit(void)
  545. {
  546. }
  547. static inline void tty_audit_fork(struct signal_struct *sig)
  548. {
  549. }
  550. static inline void tty_audit_push(struct tty_struct *tty)
  551. {
  552. }
  553. static inline int tty_audit_push_current(void)
  554. {
  555. return 0;
  556. }
  557. #endif
  558. /* tty_ioctl.c */
  559. extern int n_tty_ioctl_helper(struct tty_struct *tty, struct file *file,
  560. unsigned int cmd, unsigned long arg);
  561. extern long n_tty_compat_ioctl_helper(struct tty_struct *tty, struct file *file,
  562. unsigned int cmd, unsigned long arg);
  563. /* serial.c */
  564. extern void serial_console_init(void);
  565. /* pcxx.c */
  566. extern int pcxe_open(struct tty_struct *tty, struct file *filp);
  567. /* vt.c */
  568. extern int vt_ioctl(struct tty_struct *tty,
  569. unsigned int cmd, unsigned long arg);
  570. extern long vt_compat_ioctl(struct tty_struct *tty,
  571. unsigned int cmd, unsigned long arg);
  572. /* tty_mutex.c */
  573. /* functions for preparation of BKL removal */
  574. extern void __lockfunc tty_lock(struct tty_struct *tty);
  575. extern void __lockfunc tty_unlock(struct tty_struct *tty);
  576. extern void __lockfunc tty_lock_pair(struct tty_struct *tty,
  577. struct tty_struct *tty2);
  578. extern void __lockfunc tty_unlock_pair(struct tty_struct *tty,
  579. struct tty_struct *tty2);
  580. /*
  581. * this shall be called only from where BTM is held (like close)
  582. *
  583. * We need this to ensure nobody waits for us to finish while we are waiting.
  584. * Without this we were encountering system stalls.
  585. *
  586. * This should be indeed removed with BTM removal later.
  587. *
  588. * Locking: BTM required. Nobody is allowed to hold port->mutex.
  589. */
  590. static inline void tty_wait_until_sent_from_close(struct tty_struct *tty,
  591. long timeout)
  592. {
  593. tty_unlock(tty); /* tty->ops->close holds the BTM, drop it while waiting */
  594. tty_wait_until_sent(tty, timeout);
  595. tty_lock(tty);
  596. }
  597. /*
  598. * wait_event_interruptible_tty -- wait for a condition with the tty lock held
  599. *
  600. * The condition we are waiting for might take a long time to
  601. * become true, or might depend on another thread taking the
  602. * BTM. In either case, we need to drop the BTM to guarantee
  603. * forward progress. This is a leftover from the conversion
  604. * from the BKL and should eventually get removed as the BTM
  605. * falls out of use.
  606. *
  607. * Do not use in new code.
  608. */
  609. #define wait_event_interruptible_tty(tty, wq, condition) \
  610. ({ \
  611. int __ret = 0; \
  612. if (!(condition)) { \
  613. __wait_event_interruptible_tty(tty, wq, condition, __ret); \
  614. } \
  615. __ret; \
  616. })
  617. #define __wait_event_interruptible_tty(tty, wq, condition, ret) \
  618. do { \
  619. DEFINE_WAIT(__wait); \
  620. \
  621. for (;;) { \
  622. prepare_to_wait(&wq, &__wait, TASK_INTERRUPTIBLE); \
  623. if (condition) \
  624. break; \
  625. if (!signal_pending(current)) { \
  626. tty_unlock(tty); \
  627. schedule(); \
  628. tty_lock(tty); \
  629. continue; \
  630. } \
  631. ret = -ERESTARTSYS; \
  632. break; \
  633. } \
  634. finish_wait(&wq, &__wait); \
  635. } while (0)
  636. #ifdef CONFIG_PROC_FS
  637. extern void proc_tty_register_driver(struct tty_driver *);
  638. extern void proc_tty_unregister_driver(struct tty_driver *);
  639. #else
  640. static inline void proc_tty_register_driver(struct tty_driver *d) {}
  641. static inline void proc_tty_unregister_driver(struct tty_driver *d) {}
  642. #endif
  643. #endif