* breakpoint.c, breakpoint.h (breakpoint_init_inferior): New function

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

diff --git a/gdb/serial.h b/gdb/serial.h
index a9dba27212529328d2453e1cd80a822e74e2f392..dfe15bc418d262db9081e45f40fde33e2888d7cc 100644 (file)
--- a/gdb/serial.h
+++ b/gdb/serial.h
@@ -17,6 +17,9 @@ You should have received a copy of the GNU General Public License
 along with this program; if not, write to the Free Software
 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.  */
 
+#ifndef SERIAL_H
+#define SERIAL_H
+
 /* Terminal state pointer.  This is specific to each type of interface. */
 
 typedef PTR serial_ttystate;
@@ -116,9 +119,10 @@ serial_t serial_fdopen PARAMS ((int fd));
   ((*((SERIAL_T)->ops->noflush_set_tty_state)) \
     ((SERIAL_T), (NEW_TTYSTATE), (OLD_TTYSTATE)))
 
-/* Read one char from the serial device with TIMEOUT seconds timeout.
-   Returns char if ok, else one of the following codes.  Note that all
-   error codes are guaranteed to be < 0.  */
+/* Read one char from the serial device with TIMEOUT seconds to wait
+   or -1 to wait forever.  Use timeout of 0 to effect a poll. Returns
+   char if ok, else one of the following codes.  Note that all error
+   codes are guaranteed to be < 0.  */
 
 #define SERIAL_ERROR -1                /* General error, see errno for details */
 #define SERIAL_TIMEOUT -2
@@ -131,8 +135,8 @@ serial_t serial_fdopen PARAMS ((int fd));
 
 #define SERIAL_SETBAUDRATE(SERIAL_T, RATE) ((SERIAL_T)->ops->setbaudrate((SERIAL_T), RATE))
 
-/* Write LEN chars from STRING to the port SERIAL_T.  Returns 0 for success,
-   -1 for failure.  */
+/* Write LEN chars from STRING to the port SERIAL_T.  Returns 0 for
+   success, non-zero for failure.  */
 
 #define SERIAL_WRITE(SERIAL_T, STRING, LEN) ((SERIAL_T)->ops->write((SERIAL_T), STRING, LEN))
 
@@ -160,3 +164,5 @@ extern int job_control;
 /* Set the process group of the caller to its own pid, or do nothing if
    we lack job control.  */
 extern int gdb_setpgid PARAMS ((void));
+
+#endif /* SERIAL_H */