* serial.h (SERIAL_SET_TTY_STATE): Comment return value.

[deliverable/binutils-gdb.git] / gdb / serial.h

diff --git a/gdb/serial.h b/gdb/serial.h
index 9b967b2e238115e3317186652a9d4c2b8a9566d5..9e669cbb2bb1fb0bf6f3f45df3e9fd060e278cee 100644 (file)
--- a/gdb/serial.h
+++ b/gdb/serial.h
@@ -33,6 +33,9 @@ struct _serial_t
   unsigned char *bufp;         /* Current byte */
   unsigned char buf[BUFSIZ];   /* Da buffer itself */
   int current_timeout;         /* (termio{s} only), last value of VTIME */
+  /* ser-unix.c termio{,s} only, we still need to wait for this many more
+     seconds.  */
+  int timeout_remaining;
 };
 
 typedef struct _serial_t *serial_t;
@@ -102,7 +105,9 @@ serial_t serial_fdopen PARAMS ((const int fd));
 #define SERIAL_GET_TTY_STATE(SERIAL_T) (SERIAL_T)->ops->get_tty_state((SERIAL_T))
 
 /* Set the state of the tty to TTYSTATE.  The change is immediate.
-   When changing to or from raw mode, input might be discarded.  */
+   When changing to or from raw mode, input might be discarded.
+   Returns 0 for success, negative value for error (in which case errno
+   contains the error).  */
 #define SERIAL_SET_TTY_STATE(SERIAL_T, TTYSTATE) (SERIAL_T)->ops->set_tty_state((SERIAL_T), (TTYSTATE))
 
 /* printf_filtered a user-comprehensible description of ttystate.  */