pty.c
上传用户:jlfgdled
上传日期:2013-04-10
资源大小:33168k
文件大小:14k
源码类别:

Linux/Unix编程

开发平台:

Unix_Linux

  1. /*
  2.  *  linux/drivers/char/pty.c
  3.  *
  4.  *  Copyright (C) 1991, 1992  Linus Torvalds
  5.  *
  6.  *  Added support for a Unix98-style ptmx device.
  7.  *    -- C. Scott Ananian <cananian@alumni.princeton.edu>, 14-Jan-1998
  8.  *  Added TTY_DO_WRITE_WAKEUP to enable n_tty to send POLL_OUT to
  9.  *      waiting writers -- Sapan Bhatia <sapan@corewars.org>
  10.  *
  11.  *
  12.  */
  13. #include <linux/config.h>
  14. #include <linux/module.h> /* For EXPORT_SYMBOL */
  15. #include <linux/errno.h>
  16. #include <linux/sched.h>
  17. #include <linux/interrupt.h>
  18. #include <linux/tty.h>
  19. #include <linux/tty_flip.h>
  20. #include <linux/fcntl.h>
  21. #include <linux/string.h>
  22. #include <linux/major.h>
  23. #include <linux/mm.h>
  24. #include <linux/init.h>
  25. #include <linux/devfs_fs_kernel.h>
  26. #include <asm/uaccess.h>
  27. #include <asm/system.h>
  28. #include <asm/bitops.h>
  29. #define BUILDING_PTY_C 1
  30. #include <linux/devpts_fs.h>
  31. struct pty_struct {
  32. int magic;
  33. wait_queue_head_t open_wait;
  34. };
  35. #define PTY_MAGIC 0x5001
  36. static struct tty_driver pty_driver, pty_slave_driver;
  37. static int pty_refcount;
  38. /* Note: one set of tables for BSD and one for Unix98 */
  39. static struct tty_struct *pty_table[NR_PTYS];
  40. static struct termios *pty_termios[NR_PTYS];
  41. static struct termios *pty_termios_locked[NR_PTYS];
  42. static struct tty_struct *ttyp_table[NR_PTYS];
  43. static struct termios *ttyp_termios[NR_PTYS];
  44. static struct termios *ttyp_termios_locked[NR_PTYS];
  45. static struct pty_struct pty_state[NR_PTYS];
  46. #ifdef CONFIG_UNIX98_PTYS
  47. /* These are global because they are accessed in tty_io.c */
  48. struct tty_driver ptm_driver[UNIX98_NR_MAJORS];
  49. struct tty_driver pts_driver[UNIX98_NR_MAJORS];
  50. static struct tty_struct *ptm_table[UNIX98_NR_MAJORS][NR_PTYS];
  51. static struct termios *ptm_termios[UNIX98_NR_MAJORS][NR_PTYS];
  52. static struct termios *ptm_termios_locked[UNIX98_NR_MAJORS][NR_PTYS];
  53. static struct tty_struct *pts_table[UNIX98_NR_MAJORS][NR_PTYS];
  54. static struct termios *pts_termios[UNIX98_NR_MAJORS][NR_PTYS];
  55. static struct termios *pts_termios_locked[UNIX98_NR_MAJORS][NR_PTYS];
  56. static struct pty_struct ptm_state[UNIX98_NR_MAJORS][NR_PTYS];
  57. #endif
  58. #define MIN(a,b) ((a) < (b) ? (a) : (b))
  59. static void pty_close(struct tty_struct * tty, struct file * filp)
  60. {
  61. if (!tty)
  62. return;
  63. if (tty->driver.subtype == PTY_TYPE_MASTER) {
  64. if (tty->count > 1)
  65. printk("master pty_close: count = %d!!n", tty->count);
  66. } else {
  67. if (tty->count > 2)
  68. return;
  69. }
  70. wake_up_interruptible(&tty->read_wait);
  71. wake_up_interruptible(&tty->write_wait);
  72. tty->packet = 0;
  73. if (!tty->link)
  74. return;
  75. tty->link->packet = 0;
  76. wake_up_interruptible(&tty->link->read_wait);
  77. wake_up_interruptible(&tty->link->write_wait);
  78. set_bit(TTY_OTHER_CLOSED, &tty->link->flags);
  79. if (tty->driver.subtype == PTY_TYPE_MASTER) {
  80. set_bit(TTY_OTHER_CLOSED, &tty->flags);
  81. #ifdef CONFIG_UNIX98_PTYS
  82. {
  83. unsigned int major = MAJOR(tty->device) - UNIX98_PTY_MASTER_MAJOR;
  84. if ( major < UNIX98_NR_MAJORS ) {
  85. devpts_pty_kill( MINOR(tty->device)
  86.   - tty->driver.minor_start + tty->driver.name_base );
  87. }
  88. }
  89. #endif
  90. tty_unregister_devfs (&tty->link->driver, MINOR (tty->device));
  91. tty_vhangup(tty->link);
  92. }
  93. }
  94. /*
  95.  * The unthrottle routine is called by the line discipline to signal
  96.  * that it can receive more characters.  For PTY's, the TTY_THROTTLED
  97.  * flag is always set, to force the line discipline to always call the
  98.  * unthrottle routine when there are fewer than TTY_THRESHOLD_UNTHROTTLE 
  99.  * characters in the queue.  This is necessary since each time this
  100.  * happens, we need to wake up any sleeping processes that could be
  101.  * (1) trying to send data to the pty, or (2) waiting in wait_until_sent()
  102.  * for the pty buffer to be drained.
  103.  */
  104. static void pty_unthrottle(struct tty_struct * tty)
  105. {
  106. struct tty_struct *o_tty = tty->link;
  107. if (!o_tty)
  108. return;
  109. if ((o_tty->flags & (1 << TTY_DO_WRITE_WAKEUP)) &&
  110.     o_tty->ldisc.write_wakeup)
  111. (o_tty->ldisc.write_wakeup)(o_tty);
  112. wake_up_interruptible(&o_tty->write_wait);
  113. set_bit(TTY_THROTTLED, &tty->flags);
  114. }
  115. /*
  116.  * WSH 05/24/97: modified to 
  117.  *   (1) use space in tty->flip instead of a shared temp buffer
  118.  *  The flip buffers aren't being used for a pty, so there's lots
  119.  *  of space available.  The buffer is protected by a per-pty
  120.  *  semaphore that should almost never come under contention.
  121.  *   (2) avoid redundant copying for cases where count >> receive_room
  122.  * N.B. Calls from user space may now return an error code instead of
  123.  * a count.
  124.  */
  125. static int pty_write(struct tty_struct * tty, int from_user,
  126.        const unsigned char *buf, int count)
  127. {
  128. struct tty_struct *to = tty->link;
  129. int c=0, n, room;
  130. char *temp_buffer;
  131. if (!to || tty->stopped)
  132. return 0;
  133. if (from_user) {
  134. down(&tty->flip.pty_sem);
  135. temp_buffer = &tty->flip.char_buf[0];
  136. while (count > 0) {
  137. /* check space so we don't copy needlessly */ 
  138. n = to->ldisc.receive_room(to);
  139. if (n > count)
  140. n = count;
  141. if (!n) break;
  142. n  = MIN(n, PTY_BUF_SIZE);
  143. n -= copy_from_user(temp_buffer, buf, n);
  144. if (!n) {
  145. if (!c)
  146. c = -EFAULT;
  147. break;
  148. }
  149. /* check again in case the buffer filled up */
  150. room = to->ldisc.receive_room(to);
  151. if (n > room)
  152. n = room;
  153. if (!n) break;
  154. buf   += n; 
  155. c     += n;
  156. count -= n;
  157. to->ldisc.receive_buf(to, temp_buffer, 0, n);
  158. }
  159. up(&tty->flip.pty_sem);
  160. } else {
  161. c = to->ldisc.receive_room(to);
  162. if (c > count)
  163. c = count;
  164. to->ldisc.receive_buf(to, buf, 0, c);
  165. }
  166. return c;
  167. }
  168. static int pty_write_room(struct tty_struct *tty)
  169. {
  170. struct tty_struct *to = tty->link;
  171. if (!to || tty->stopped)
  172. return 0;
  173. return to->ldisc.receive_room(to);
  174. }
  175. /*
  176.  * WSH 05/24/97:  Modified for asymmetric MASTER/SLAVE behavior
  177.  * The chars_in_buffer() value is used by the ldisc select() function 
  178.  * to hold off writing when chars_in_buffer > WAKEUP_CHARS (== 256).
  179.  * The pty driver chars_in_buffer() Master/Slave must behave differently:
  180.  *
  181.  *      The Master side needs to allow typed-ahead commands to accumulate
  182.  *      while being canonicalized, so we report "our buffer" as empty until
  183.  * some threshold is reached, and then report the count. (Any count >
  184.  * WAKEUP_CHARS is regarded by select() as "full".)  To avoid deadlock 
  185.  * the count returned must be 0 if no canonical data is available to be 
  186.  * read. (The N_TTY ldisc.chars_in_buffer now knows this.)
  187.  *  
  188.  * The Slave side passes all characters in raw mode to the Master side's
  189.  * buffer where they can be read immediately, so in this case we can
  190.  * return the true count in the buffer.
  191.  */
  192. static int pty_chars_in_buffer(struct tty_struct *tty)
  193. {
  194. struct tty_struct *to = tty->link;
  195. int count;
  196. if (!to || !to->ldisc.chars_in_buffer)
  197. return 0;
  198. /* The ldisc must report 0 if no characters available to be read */
  199. count = to->ldisc.chars_in_buffer(to);
  200. if (tty->driver.subtype == PTY_TYPE_SLAVE) return count;
  201. /* Master side driver ... if the other side's read buffer is less than 
  202.  * half full, return 0 to allow writers to proceed; otherwise return
  203.  * the count.  This leaves a comfortable margin to avoid overflow, 
  204.  * and still allows half a buffer's worth of typed-ahead commands.
  205.  */
  206. return ((count < N_TTY_BUF_SIZE/2) ? 0 : count);
  207. }
  208. /* 
  209.  * Return the device number of a Unix98 PTY (only!).  This lets us open a
  210.  * master pty with the multi-headed ptmx device, then find out which
  211.  * one we got after it is open, with an ioctl.
  212.  */
  213. #ifdef CONFIG_UNIX98_PTYS
  214. static int pty_get_device_number(struct tty_struct *tty, unsigned int *value)
  215. {
  216. unsigned int result = MINOR(tty->device)
  217. - tty->driver.minor_start + tty->driver.name_base;
  218. return put_user(result, value);
  219. }
  220. #endif
  221. /* Set the lock flag on a pty */
  222. static int pty_set_lock(struct tty_struct *tty, int * arg)
  223. {
  224. int val;
  225. if (get_user(val,arg))
  226. return -EFAULT;
  227. if (val)
  228. set_bit(TTY_PTY_LOCK, &tty->flags);
  229. else
  230. clear_bit(TTY_PTY_LOCK, &tty->flags);
  231. return 0;
  232. }
  233. static int pty_bsd_ioctl(struct tty_struct *tty, struct file *file,
  234. unsigned int cmd, unsigned long arg)
  235. {
  236. if (!tty) {
  237. printk("pty_ioctl called with NULL tty!n");
  238. return -EIO;
  239. }
  240. switch(cmd) {
  241. case TIOCSPTLCK: /* Set PT Lock (disallow slave open) */
  242. return pty_set_lock(tty, (int *) arg);
  243. }
  244. return -ENOIOCTLCMD;
  245. }
  246. #ifdef CONFIG_UNIX98_PTYS
  247. static int pty_unix98_ioctl(struct tty_struct *tty, struct file *file,
  248.     unsigned int cmd, unsigned long arg)
  249. {
  250. if (!tty) {
  251. printk("pty_unix98_ioctl called with NULL tty!n");
  252. return -EIO;
  253. }
  254. switch(cmd) {
  255. case TIOCGPTN: /* Get PT Number */
  256. return pty_get_device_number(tty, (unsigned int *)arg);
  257. }
  258. return pty_bsd_ioctl(tty,file,cmd,arg);
  259. }
  260. #endif
  261. static void pty_flush_buffer(struct tty_struct *tty)
  262. {
  263. struct tty_struct *to = tty->link;
  264. if (!to)
  265. return;
  266. if (to->ldisc.flush_buffer)
  267. to->ldisc.flush_buffer(to);
  268. if (to->packet) {
  269. tty->ctrl_status |= TIOCPKT_FLUSHWRITE;
  270. wake_up_interruptible(&to->read_wait);
  271. }
  272. }
  273. static int pty_open(struct tty_struct *tty, struct file * filp)
  274. {
  275. int retval;
  276. int line;
  277. struct pty_struct *pty;
  278. retval = -ENODEV;
  279. if (!tty || !tty->link)
  280. goto out;
  281. line = MINOR(tty->device) - tty->driver.minor_start;
  282. if ((line < 0) || (line >= NR_PTYS))
  283. goto out;
  284. pty = (struct pty_struct *)(tty->driver.driver_state) + line;
  285. tty->driver_data = pty;
  286. retval = -EIO;
  287. if (test_bit(TTY_OTHER_CLOSED, &tty->flags))
  288. goto out;
  289. if (test_bit(TTY_PTY_LOCK, &tty->link->flags))
  290. goto out;
  291. if (tty->link->count != 1)
  292. goto out;
  293. clear_bit(TTY_OTHER_CLOSED, &tty->link->flags);
  294. wake_up_interruptible(&pty->open_wait);
  295. set_bit(TTY_THROTTLED, &tty->flags);
  296. set_bit(TTY_DO_WRITE_WAKEUP, &tty->flags);
  297. /*  Register a slave for the master  */
  298. if (tty->driver.major == PTY_MASTER_MAJOR)
  299. tty_register_devfs(&tty->link->driver,
  300.    DEVFS_FL_CURRENT_OWNER | DEVFS_FL_WAIT,
  301.    tty->link->driver.minor_start +
  302.    MINOR(tty->device)-tty->driver.minor_start);
  303. retval = 0;
  304. out:
  305. return retval;
  306. }
  307. static void pty_set_termios(struct tty_struct *tty, struct termios *old_termios)
  308. {
  309.         tty->termios->c_cflag &= ~(CSIZE | PARENB);
  310.         tty->termios->c_cflag |= (CS8 | CREAD);
  311. }
  312. int __init pty_init(void)
  313. {
  314. int i;
  315. /* Traditional BSD devices */
  316. memset(&pty_state, 0, sizeof(pty_state));
  317. for (i = 0; i < NR_PTYS; i++)
  318. init_waitqueue_head(&pty_state[i].open_wait);
  319. memset(&pty_driver, 0, sizeof(struct tty_driver));
  320. pty_driver.magic = TTY_DRIVER_MAGIC;
  321. pty_driver.driver_name = "pty_master";
  322. #ifdef CONFIG_DEVFS_FS
  323. pty_driver.name = "pty/m%d";
  324. #else
  325. pty_driver.name = "pty";
  326. #endif
  327. pty_driver.major = PTY_MASTER_MAJOR;
  328. pty_driver.minor_start = 0;
  329. pty_driver.num = NR_PTYS;
  330. pty_driver.type = TTY_DRIVER_TYPE_PTY;
  331. pty_driver.subtype = PTY_TYPE_MASTER;
  332. pty_driver.init_termios = tty_std_termios;
  333. pty_driver.init_termios.c_iflag = 0;
  334. pty_driver.init_termios.c_oflag = 0;
  335. pty_driver.init_termios.c_cflag = B38400 | CS8 | CREAD;
  336. pty_driver.init_termios.c_lflag = 0;
  337. pty_driver.flags = TTY_DRIVER_RESET_TERMIOS | TTY_DRIVER_REAL_RAW;
  338. pty_driver.refcount = &pty_refcount;
  339. pty_driver.table = pty_table;
  340. pty_driver.termios = pty_termios;
  341. pty_driver.termios_locked = pty_termios_locked;
  342. pty_driver.driver_state = pty_state;
  343. pty_driver.other = &pty_slave_driver;
  344. pty_driver.open = pty_open;
  345. pty_driver.close = pty_close;
  346. pty_driver.write = pty_write;
  347. pty_driver.write_room = pty_write_room;
  348. pty_driver.flush_buffer = pty_flush_buffer;
  349. pty_driver.chars_in_buffer = pty_chars_in_buffer;
  350. pty_driver.unthrottle = pty_unthrottle;
  351. pty_driver.set_termios = pty_set_termios;
  352. pty_slave_driver = pty_driver;
  353. pty_slave_driver.driver_name = "pty_slave";
  354. pty_slave_driver.proc_entry = 0;
  355. #ifdef CONFIG_DEVFS_FS
  356. pty_slave_driver.name = "pty/s%d";
  357. #else
  358. pty_slave_driver.name = "ttyp";
  359. #endif
  360. pty_slave_driver.subtype = PTY_TYPE_SLAVE;
  361. pty_slave_driver.major = PTY_SLAVE_MAJOR;
  362. pty_slave_driver.minor_start = 0;
  363. pty_slave_driver.init_termios = tty_std_termios;
  364. pty_slave_driver.init_termios.c_cflag = B38400 | CS8 | CREAD;
  365. /* Slave ptys are registered when their corresponding master pty
  366.  * is opened, and unregistered when the pair is closed.
  367.  */
  368. pty_slave_driver.flags |= TTY_DRIVER_NO_DEVFS;
  369. pty_slave_driver.table = ttyp_table;
  370. pty_slave_driver.termios = ttyp_termios;
  371. pty_slave_driver.termios_locked = ttyp_termios_locked;
  372. pty_slave_driver.driver_state = pty_state;
  373. pty_slave_driver.other = &pty_driver;
  374. if (tty_register_driver(&pty_driver))
  375. panic("Couldn't register pty driver");
  376. if (tty_register_driver(&pty_slave_driver))
  377. panic("Couldn't register pty slave driver");
  378. /* 
  379.  * only the master pty gets this ioctl (which is why we
  380.  * assign it here, instead of up with the rest of the
  381.  * pty_driver initialization. <cananian@alumni.princeton.edu>
  382.  */
  383. pty_driver.ioctl = pty_bsd_ioctl;
  384. /* Unix98 devices */
  385. #ifdef CONFIG_UNIX98_PTYS
  386. devfs_mk_dir (NULL, "pts", NULL);
  387. printk("pty: %d Unix98 ptys configuredn", UNIX98_NR_MAJORS*NR_PTYS);
  388. for ( i = 0 ; i < UNIX98_NR_MAJORS ; i++ ) {
  389. int j;
  390. ptm_driver[i] = pty_driver;
  391. ptm_driver[i].name = "ptm";
  392. ptm_driver[i].proc_entry = 0;
  393. ptm_driver[i].major = UNIX98_PTY_MASTER_MAJOR+i;
  394. ptm_driver[i].minor_start = 0;
  395. ptm_driver[i].name_base = i*NR_PTYS;
  396. ptm_driver[i].num = NR_PTYS;
  397. ptm_driver[i].other = &pts_driver[i];
  398. ptm_driver[i].flags |= TTY_DRIVER_NO_DEVFS;
  399. ptm_driver[i].table = ptm_table[i];
  400. ptm_driver[i].termios = ptm_termios[i];
  401. ptm_driver[i].termios_locked = ptm_termios_locked[i];
  402. ptm_driver[i].driver_state = ptm_state[i];
  403. for (j = 0; j < NR_PTYS; j++)
  404. init_waitqueue_head(&ptm_state[i][j].open_wait);
  405. pts_driver[i] = pty_slave_driver;
  406. #ifdef CONFIG_DEVFS_FS
  407. pts_driver[i].name = "pts/%d";
  408. #else
  409. pts_driver[i].name = "pts";
  410. #endif
  411. pts_driver[i].proc_entry = 0;
  412. pts_driver[i].major = UNIX98_PTY_SLAVE_MAJOR+i;
  413. pts_driver[i].minor_start = 0;
  414. pts_driver[i].name_base = i*NR_PTYS;
  415. pts_driver[i].num = ptm_driver[i].num;
  416. pts_driver[i].other = &ptm_driver[i];
  417. pts_driver[i].table = pts_table[i];
  418. pts_driver[i].termios = pts_termios[i];
  419. pts_driver[i].termios_locked = pts_termios_locked[i];
  420. pts_driver[i].driver_state = ptm_state[i];
  421. ptm_driver[i].ioctl = pty_unix98_ioctl;
  422. if (tty_register_driver(&ptm_driver[i]))
  423. panic("Couldn't register Unix98 ptm driver major %d",
  424.       ptm_driver[i].major);
  425. if (tty_register_driver(&pts_driver[i]))
  426. panic("Couldn't register Unix98 pts driver major %d",
  427.       pts_driver[i].major);
  428. }
  429. #endif
  430. return 0;
  431. }