Skip to contentSkip to conversation

ioctl_tty.2: Document TIOCSERGETLSR/TIOCSER_TEMT

PATCH In review Pali Rohár 2 participants 2 messages Oct 26, 2022

Subsystems (2)
lore
Share & tools
lore
#0 lore raw

PATCH 1/1 ioctl_tty.2: Document TIOCSERGETLSR/TIOCSER_TEMT

---
 man2/ioctl_tty.2 | 16 +++++++++++++++-
 1 file changed, 15 insertions(+), 1 deletion(-)
man2/ioctl_tty.2 +15 -1
index 759ea7bba62f..41ff38b6f578 100644
@@ -309,6 +309,21 @@ for the argument values
 .BR TCIFLUSH ,
 .BR TCOFLUSH ,
 .BR TCIOFLUSH .
+.TP
+.B TIOCSERGETLSR
+Argument:
+.BI "int\~*" argp
+.IP
+Get line status register. Status register has
+.B TIOCSER_TEMT
+bit set when output buffer is empty and also hardware transmitter is physically empty.
+.IP
+Does not have to be supported by all serial tty drivers.
+.IP
+.BR tcdrain (3)
+does not wait and returns immediately when
+.B TIOCSER_TEMT
+bit is set.
 .SS Faking input
 .TP
 .B TIOCSTI
@@ -890,7 +905,6 @@ main(int argc, char *argv[])
 .\" TIOCSERGWILD		int *
 .\" TIOCSERSWILD		const int *
 .\" TIOCSERGSTRUCT		struct async_struct *
-.\" TIOCSERGETLSR		int *
 .\" TIOCSERGETMULTI		struct serial_multiport_struct *
 .\" TIOCSERSETMULTI		const struct serial_multiport_struct *
 .\" TIOCGSERIAL, TIOCSSERIAL (see above)
Signature · 1 line
2.20.1
#1 lore raw

Hi Pali!

Quoted 1 line · Pali Rohár

Patch applied. Thanks!

Cheers,

Alex

Quoted 38 lines
---
  man2/ioctl_tty.2 | 16 +++++++++++++++-
  1 file changed, 15 insertions(+), 1 deletion(-)
man2/ioctl_tty.2 +15 -1
index 759ea7bba62f..41ff38b6f578 100644
@@ -309,6 +309,21 @@ for the argument values
  .BR TCIFLUSH ,
  .BR TCOFLUSH ,
  .BR TCIOFLUSH .
+.TP
+.B TIOCSERGETLSR
+Argument:
+.BI "int\~*" argp
+.IP
+Get line status register. Status register has
+.B TIOCSER_TEMT
+bit set when output buffer is empty and also hardware transmitter is physically empty.
+.IP
+Does not have to be supported by all serial tty drivers.
+.IP
+.BR tcdrain (3)
+does not wait and returns immediately when
+.B TIOCSER_TEMT
+bit is set.
  .SS Faking input
  .TP
  .B TIOCSTI
@@ -890,7 +905,6 @@ main(int argc, char *argv[])
  .\" TIOCSERGWILD		int *
  .\" TIOCSERSWILD		const int *
  .\" TIOCSERGSTRUCT		struct async_struct *
-.\" TIOCSERGETLSR		int *
  .\" TIOCSERGETMULTI		struct serial_multiport_struct *
  .\" TIOCSERSETMULTI		const struct serial_multiport_struct *
  .\" TIOCGSERIAL, TIOCSSERIAL (see above)
Signature · 1 line
<http://www.alejandro-colomar.es/>