logo

oasis-root

Compiled tree of Oasis Linux based on own branch at <https://hacktivis.me/git/oasis/> git clone https://anongit.hacktivis.me/git/oasis-root.git

cfsetispeed.3p (2706B)

    

  1. '\" et
  2. .TH CFSETISPEED "3P" 2017 "IEEE/The Open Group" "POSIX Programmer's Manual"
  3. .\"
  4. .SH PROLOG
  5. This manual page is part of the POSIX Programmer's Manual.
  6. The Linux implementation of this interface may differ (consult
  7. the corresponding Linux manual page for details of Linux behavior),
  8. or the interface may not be implemented on Linux.
  9. .\"
  10. .SH NAME
  11. cfsetispeed
  12. \(em set input baud rate
  13. .SH SYNOPSIS
  14. .LP
  15. .nf
  16. #include <termios.h>
  17. .P
  18. int cfsetispeed(struct termios *\fItermios_p\fP, speed_t \fIspeed\fP);
  19. .fi
  20. .SH DESCRIPTION
  21. The
  22. \fIcfsetispeed\fR()
  23. function shall set the input baud rate stored in the structure pointed
  24. to by
  25. .IR termios_p
  26. to
  27. .IR speed.
  28. .P
  29. There shall be no effect on the baud rates set in the hardware until a
  30. subsequent successful call to
  31. \fItcsetattr\fR()
  32. with the same
  33. .BR termios
  34. structure. Similarly, errors resulting from attempts to set baud rates
  35. not supported by the terminal device need not be detected until the
  36. \fItcsetattr\fR()
  37. function is called.
  38. .SH "RETURN VALUE"
  39. Upon successful completion,
  40. \fIcfsetispeed\fR()
  41. shall return 0; otherwise, \-1 shall be returned, and
  42. .IR errno
  43. may be set to indicate the error.
  44. .SH ERRORS
  45. The
  46. \fIcfsetispeed\fR()
  47. function may fail if:
  48. .TP
  49. .BR EINVAL
  50. The
  51. .IR speed
  52. value is not a valid baud rate.
  53. .TP
  54. .BR EINVAL
  55. The value of
  56. .IR speed
  57. is outside the range of possible speed values as specified in
  58. .IR <termios.h> .
  59. .LP
  60. .IR "The following sections are informative."
  61. .SH EXAMPLES
  62. None.
  63. .SH "APPLICATION USAGE"
  64. None.
  65. .SH RATIONALE
  66. Refer to
  67. .IR "\fIcfgetispeed\fR\^(\|)".
  68. .SH "FUTURE DIRECTIONS"
  69. None.
  70. .SH "SEE ALSO"
  71. .IR "\fIcfgetispeed\fR\^(\|)",
  72. .IR "\fIcfgetospeed\fR\^(\|)",
  73. .IR "\fIcfsetospeed\fR\^(\|)",
  74. .IR "\fItcsetattr\fR\^(\|)"
  75. .P
  76. The Base Definitions volume of POSIX.1\(hy2017,
  77. .IR "Chapter 11" ", " "General Terminal Interface",
  78. .IR "\fB<termios.h>\fP"
  79. .\"
  80. .SH COPYRIGHT
  81. Portions of this text are reprinted and reproduced in electronic form
  82. from IEEE Std 1003.1-2017, Standard for Information Technology
  83. -- Portable Operating System Interface (POSIX), The Open Group Base
  84. Specifications Issue 7, 2018 Edition,
  85. Copyright (C) 2018 by the Institute of
  86. Electrical and Electronics Engineers, Inc and The Open Group.
  87. In the event of any discrepancy between this version and the original IEEE and
  88. The Open Group Standard, the original IEEE and The Open Group Standard
  89. is the referee document. The original Standard can be obtained online at
  90. http://www.opengroup.org/unix/online.html .
  91. .PP
  92. Any typographical or formatting errors that appear
  93. in this page are most likely
  94. to have been introduced during the conversion of the source files to
  95. man page format. To report such errors, see
  96. https://www.kernel.org/doc/man-pages/reporting_bugs.html .