开通博客赚积分
发布资源赚积分
分类

源码开发语言/平台
当前位置：首页 > 源码/资料 > 操作系统开发 > 查看源码
TERMIOS.3
资源名称：os_source.zip　[点击查看]
上传用户：datang2001
上传日期：2007-02-01
资源大小：53269k
文件大小：4k
源码类别：

操作系统开发

开发平台：

C/C++

TERMIOS.3：源码内容
  1. .TH TERMIOS 3
  2. .SH NAME
  3. termios, tcgetattr, tcsetattr, cfgetispeed, cfgetospeed, cfsetispeed, cfsetospeed, tcsendbreak, tcdrain, tcflush, tcflow - change terminal attributes
  4. .SH SYNOPSIS
  5. .ft B
  6. .nf
  7. #include <termios.h>
  9. int tcgetattr(int fIfdfP, struct termios *fItpfP)
  10. int tcsetattr(int fIfdfP, int fIactionfP, const struct termios *fItpfP)
  12. speed_t cfgetispeed(const struct termios *fItpfP)
  13. speed_t cfgetospeed(const struct termios *fItpfP)
  14. int cfsetispeed(struct termios *fItpfP, speed_t fIspeedfP)
  15. int cfsetospeed(struct termios *fItpfP, speed_t fIspeedfP)
  17. int tcsendbreak(int fIfdfP, int fIdurationfP)
  18. int tcdrain(int fIfdfP)
  19. int tcflush(int fIfdfP, int fIqueue_selectorfP)
  20. int tcflow(int fIfdfP, int fIactionfP)
  21. .fi
  22. .ft P
  23. .SH DESCRIPTION
  24. .de SP
  25. .if t .sp 0.4
  26. .if n .sp
  27. ..
  28. These are the user functions that modify the tty attributes mentioned in
  29. .BR tty (4).
  30. In the following,
  31. .I fd
  32. refers to an open terminal device file,
  33. .I tp
  34. is the address of a
  35. .BR "struct termios" ,
  36. and
  37. .I speed
  38. and values of type
  39. .B speed_t
  40. are equal to one of the
  41. .BR B0 ,
  42. .BR B50 ,
  43. etc. baud rate symbols.  All functions, symbols, and types are declared in
  44. .BR <termios.h> .
  45. .PP
  46. The effects of the tty functions are:
  47. .TP
  48. .B tcgetattr(fIfdfP, fItpfP)
  49. Get the current settings of the tty attributes.
  50. .TP
  51. .B tcsetattr(fIfdfP, TCSANOW, fItpfP)
  52. Set the terminal attributes.  The change occurs immediately.
  53. .TP
  54. .B tcsetattr(fIfdfP, TCSADRAIN, fItpfP)
  55. Set the terminal attributes.  The change occurs once all the output waiting
  56. in the output queues has been transmitted.  This should be used when options
  57. affecting output are changed.
  58. .TP
  59. .B tcsetattr(fIfdfP, TCSAFLUSH, fItpfP)
  60. Set the terminal attributes.  But first wait until all the output waiting
  61. in the output queues has been transmitted.  All input waiting in the input
  62. queues is then discarded and the change is made.  This should be used when
  63. switching from canonical to non-canonical mode or vice-versa.  (Oddly
  64. enough, this is seldom what you want, because it discards typeahead.  An
  65. editing shell does the Right Thing if it uses
  66. .B TCSANOW
  67. instead.  s-2POSIXs+2 may not guarantee good results, but in practice most
  68. systems make the canonical input available in raw mode.)
  69. .TP
  70. .B cfgetispeed(fItpfP)
  71. Return the input baud rate encoded in the termios structure.
  72. .TP
  73. .B cfgetospeed(fItpfP)
  74. Return the output baud rate encoded in the termios structure.
  75. .TP
  76. .B cfsetispeed(fItpfP, fIspeedfP)
  77. Encode the new input baud rate into the termios structure.
  78. .TP
  79. .B cfsetospeed(fItpfP, fIspeedfP)
  80. Encode the new output baud rate into the termios structure.
  81. .TP
  82. .B tcsendbreak(fIfdfP, fIdurationfP)
  83. Emit a break condition on a serial line for a time indicated by
  84. .IR duration .
  85. (Always 0.4 seconds under Minix,
  86. .I duration
  87. is ignored.)
  88. .TP
  89. .B tcdrain(fIfdfP)
  90. Wait until all output waiting in the output queues has been transmitted.
  91. .TP
  92. .B tcflush(fIfdfP, TCIFLUSH)
  93. Flush the input queue.  (I.e. discard it.)
  94. .TP
  95. .B tcflush(fIfdfP, TCOFLUSH)
  96. Flush the output queue.
  97. .TP
  98. .B tcflush(fIfdfP, TCIOFLUSH)
  99. Flush the input and output queues.
  100. .TP
  101. .B tcflow(fIfdfP, TCOOFF)
  102. Suspend output.  (Like the effect of
  103. .BR STOP .)
  104. .TP
  105. .B tcflow(fIfdfP, TCOON)
  106. Restart output.  (Like the effect of
  107. .BR START .)
  108. .TP
  109. .B tcflow(fIfdfP, TCIOFF)
  110. Transmit a
  111. .B STOP
  112. character intended to make the remote device stop transmitting data.
  113. .TP
  114. .B tcflow(fIfdfP, TCION)
  115. Transmit a
  116. .B START
  117. character to restart the remote device.
  118. .SH "SEE ALSO"
  119. .BR stty (1),
  120. .BR tty (4).
  121. .SH DIAGNOSTICS
  122. All functions return 0 unless otherwise specified, and -1 on error with
  123. .B errno
  124. set to indicate the type of error.  The most notable errors are
  125. .B ENOTTY
  126. if
  127. .I fd
  128. does not refer to a terminal device, and
  129. .B EINTR
  130. if one of the functions waiting for output to drain is interrupted.
  131. .SH NOTES
  132. It may be interesting to know that the functions operating on the tty are
  133. directly translated into the following Minix
  134. .B ioctl
  135. requests:
  136. .BR TCGETS ,
  137. .BR TCSETS
  138. (now),
  139. .BR TCSETSW
  140. (drain),
  141. .BR TCSETSF ,
  142. (flush),
  143. .BR TCSBRK ,
  144. .BR TCDRAIN ,
  145. .BR TCFLSH ,
  146. and
  147. .BR TCFLOW .
  148. You should only use this knowledge when trying to understand the tty driver
  149. code, of course.
  150. .SH BUGS
  151. .SH AUTHOR
  152. Kees J. Bot (kjb@cs.vu.nl)