dma: beautify queue listing output
[dragonfly.git] / contrib / gdb-6.2.1 / gdb / ser-unix.c
blob6f64f419b3383399a986150df6a005205291ea83
1 /* Serial interface for local (hardwired) serial ports on Un*x like systems
3 Copyright 1992, 1993, 1994, 1995, 1996, 1998, 1999, 2000, 2001,
4 2003, 2004 Free Software Foundation, Inc.
6 This file is part of GDB.
8 This program is free software; you can redistribute it and/or modify
9 it under the terms of the GNU General Public License as published by
10 the Free Software Foundation; either version 2 of the License, or
11 (at your option) any later version.
13 This program is distributed in the hope that it will be useful,
14 but WITHOUT ANY WARRANTY; without even the implied warranty of
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 GNU General Public License for more details.
18 You should have received a copy of the GNU General Public License
19 along with this program; if not, write to the Free Software
20 Foundation, Inc., 59 Temple Place - Suite 330,
21 Boston, MA 02111-1307, USA. */
23 #include "defs.h"
24 #include "serial.h"
25 #include "ser-unix.h"
27 #include <fcntl.h>
28 #include <sys/types.h>
29 #include "terminal.h"
30 #include <sys/socket.h>
31 #include <sys/time.h>
33 #include "gdb_string.h"
34 #include "event-loop.h"
36 #ifdef HAVE_TERMIOS
38 struct hardwire_ttystate
40 struct termios termios;
42 #endif /* termios */
44 #ifdef HAVE_TERMIO
46 /* It is believed that all systems which have added job control to SVR3
47 (e.g. sco) have also added termios. Even if not, trying to figure out
48 all the variations (TIOCGPGRP vs. TCGETPGRP, etc.) would be pretty
49 bewildering. So we don't attempt it. */
51 struct hardwire_ttystate
53 struct termio termio;
55 #endif /* termio */
57 #ifdef HAVE_SGTTY
58 struct hardwire_ttystate
60 struct sgttyb sgttyb;
61 struct tchars tc;
62 struct ltchars ltc;
63 /* Line discipline flags. */
64 int lmode;
66 #endif /* sgtty */
68 static int hardwire_open (struct serial *scb, const char *name);
69 static void hardwire_raw (struct serial *scb);
70 static int wait_for (struct serial *scb, int timeout);
71 static int hardwire_readchar (struct serial *scb, int timeout);
72 static int do_hardwire_readchar (struct serial *scb, int timeout);
73 static int generic_readchar (struct serial *scb, int timeout,
74 int (*do_readchar) (struct serial *scb,
75 int timeout));
76 static int rate_to_code (int rate);
77 static int hardwire_setbaudrate (struct serial *scb, int rate);
78 static void hardwire_close (struct serial *scb);
79 static int get_tty_state (struct serial *scb,
80 struct hardwire_ttystate * state);
81 static int set_tty_state (struct serial *scb,
82 struct hardwire_ttystate * state);
83 static serial_ttystate hardwire_get_tty_state (struct serial *scb);
84 static int hardwire_set_tty_state (struct serial *scb, serial_ttystate state);
85 static int hardwire_noflush_set_tty_state (struct serial *, serial_ttystate,
86 serial_ttystate);
87 static void hardwire_print_tty_state (struct serial *, serial_ttystate,
88 struct ui_file *);
89 static int hardwire_drain_output (struct serial *);
90 static int hardwire_flush_output (struct serial *);
91 static int hardwire_flush_input (struct serial *);
92 static int hardwire_send_break (struct serial *);
93 static int hardwire_setstopbits (struct serial *, int);
95 static int do_unix_readchar (struct serial *scb, int timeout);
96 static timer_handler_func push_event;
97 static handler_func fd_event;
98 static void reschedule (struct serial *scb);
100 void _initialize_ser_hardwire (void);
102 /* Open up a real live device for serial I/O */
104 static int
105 hardwire_open (struct serial *scb, const char *name)
107 scb->fd = open (name, O_RDWR);
108 if (scb->fd < 0)
109 return -1;
111 return 0;
114 static int
115 get_tty_state (struct serial *scb, struct hardwire_ttystate *state)
117 #ifdef HAVE_TERMIOS
118 if (tcgetattr (scb->fd, &state->termios) < 0)
119 return -1;
121 return 0;
122 #endif
124 #ifdef HAVE_TERMIO
125 if (ioctl (scb->fd, TCGETA, &state->termio) < 0)
126 return -1;
127 return 0;
128 #endif
130 #ifdef HAVE_SGTTY
131 if (ioctl (scb->fd, TIOCGETP, &state->sgttyb) < 0)
132 return -1;
133 if (ioctl (scb->fd, TIOCGETC, &state->tc) < 0)
134 return -1;
135 if (ioctl (scb->fd, TIOCGLTC, &state->ltc) < 0)
136 return -1;
137 if (ioctl (scb->fd, TIOCLGET, &state->lmode) < 0)
138 return -1;
140 return 0;
141 #endif
144 static int
145 set_tty_state (struct serial *scb, struct hardwire_ttystate *state)
147 #ifdef HAVE_TERMIOS
148 if (tcsetattr (scb->fd, TCSANOW, &state->termios) < 0)
149 return -1;
151 return 0;
152 #endif
154 #ifdef HAVE_TERMIO
155 if (ioctl (scb->fd, TCSETA, &state->termio) < 0)
156 return -1;
157 return 0;
158 #endif
160 #ifdef HAVE_SGTTY
161 if (ioctl (scb->fd, TIOCSETN, &state->sgttyb) < 0)
162 return -1;
163 if (ioctl (scb->fd, TIOCSETC, &state->tc) < 0)
164 return -1;
165 if (ioctl (scb->fd, TIOCSLTC, &state->ltc) < 0)
166 return -1;
167 if (ioctl (scb->fd, TIOCLSET, &state->lmode) < 0)
168 return -1;
170 return 0;
171 #endif
174 static serial_ttystate
175 hardwire_get_tty_state (struct serial *scb)
177 struct hardwire_ttystate *state;
179 state = (struct hardwire_ttystate *) xmalloc (sizeof *state);
181 if (get_tty_state (scb, state))
182 return NULL;
184 return (serial_ttystate) state;
187 static int
188 hardwire_set_tty_state (struct serial *scb, serial_ttystate ttystate)
190 struct hardwire_ttystate *state;
192 state = (struct hardwire_ttystate *) ttystate;
194 return set_tty_state (scb, state);
197 static int
198 hardwire_noflush_set_tty_state (struct serial *scb,
199 serial_ttystate new_ttystate,
200 serial_ttystate old_ttystate)
202 struct hardwire_ttystate new_state;
203 #ifdef HAVE_SGTTY
204 struct hardwire_ttystate *state = (struct hardwire_ttystate *) old_ttystate;
205 #endif
207 new_state = *(struct hardwire_ttystate *) new_ttystate;
209 /* Don't change in or out of raw mode; we don't want to flush input.
210 termio and termios have no such restriction; for them flushing input
211 is separate from setting the attributes. */
213 #ifdef HAVE_SGTTY
214 if (state->sgttyb.sg_flags & RAW)
215 new_state.sgttyb.sg_flags |= RAW;
216 else
217 new_state.sgttyb.sg_flags &= ~RAW;
219 /* I'm not sure whether this is necessary; the manpage just mentions
220 RAW not CBREAK. */
221 if (state->sgttyb.sg_flags & CBREAK)
222 new_state.sgttyb.sg_flags |= CBREAK;
223 else
224 new_state.sgttyb.sg_flags &= ~CBREAK;
225 #endif
227 return set_tty_state (scb, &new_state);
230 static void
231 hardwire_print_tty_state (struct serial *scb,
232 serial_ttystate ttystate,
233 struct ui_file *stream)
235 struct hardwire_ttystate *state = (struct hardwire_ttystate *) ttystate;
236 int i;
238 #ifdef HAVE_TERMIOS
239 fprintf_filtered (stream, "c_iflag = 0x%x, c_oflag = 0x%x,\n",
240 (int) state->termios.c_iflag,
241 (int) state->termios.c_oflag);
242 fprintf_filtered (stream, "c_cflag = 0x%x, c_lflag = 0x%x\n",
243 (int) state->termios.c_cflag,
244 (int) state->termios.c_lflag);
245 #if 0
246 /* This not in POSIX, and is not really documented by those systems
247 which have it (at least not Sun). */
248 fprintf_filtered (stream, "c_line = 0x%x.\n", state->termios.c_line);
249 #endif
250 fprintf_filtered (stream, "c_cc: ");
251 for (i = 0; i < NCCS; i += 1)
252 fprintf_filtered (stream, "0x%x ", state->termios.c_cc[i]);
253 fprintf_filtered (stream, "\n");
254 #endif
256 #ifdef HAVE_TERMIO
257 fprintf_filtered (stream, "c_iflag = 0x%x, c_oflag = 0x%x,\n",
258 state->termio.c_iflag, state->termio.c_oflag);
259 fprintf_filtered (stream, "c_cflag = 0x%x, c_lflag = 0x%x, c_line = 0x%x.\n",
260 state->termio.c_cflag, state->termio.c_lflag,
261 state->termio.c_line);
262 fprintf_filtered (stream, "c_cc: ");
263 for (i = 0; i < NCC; i += 1)
264 fprintf_filtered (stream, "0x%x ", state->termio.c_cc[i]);
265 fprintf_filtered (stream, "\n");
266 #endif
268 #ifdef HAVE_SGTTY
269 fprintf_filtered (stream, "sgttyb.sg_flags = 0x%x.\n",
270 state->sgttyb.sg_flags);
272 fprintf_filtered (stream, "tchars: ");
273 for (i = 0; i < (int) sizeof (struct tchars); i++)
274 fprintf_filtered (stream, "0x%x ", ((unsigned char *) &state->tc)[i]);
275 fprintf_filtered (stream, "\n");
277 fprintf_filtered (stream, "ltchars: ");
278 for (i = 0; i < (int) sizeof (struct ltchars); i++)
279 fprintf_filtered (stream, "0x%x ", ((unsigned char *) &state->ltc)[i]);
280 fprintf_filtered (stream, "\n");
282 fprintf_filtered (stream, "lmode: 0x%x\n", state->lmode);
283 #endif
286 /* Wait for the output to drain away, as opposed to flushing (discarding) it */
288 static int
289 hardwire_drain_output (struct serial *scb)
291 #ifdef HAVE_TERMIOS
292 return tcdrain (scb->fd);
293 #endif
295 #ifdef HAVE_TERMIO
296 return ioctl (scb->fd, TCSBRK, 1);
297 #endif
299 #ifdef HAVE_SGTTY
300 /* Get the current state and then restore it using TIOCSETP,
301 which should cause the output to drain and pending input
302 to be discarded. */
304 struct hardwire_ttystate state;
305 if (get_tty_state (scb, &state))
307 return (-1);
309 else
311 return (ioctl (scb->fd, TIOCSETP, &state.sgttyb));
314 #endif
317 static int
318 hardwire_flush_output (struct serial *scb)
320 #ifdef HAVE_TERMIOS
321 return tcflush (scb->fd, TCOFLUSH);
322 #endif
324 #ifdef HAVE_TERMIO
325 return ioctl (scb->fd, TCFLSH, 1);
326 #endif
328 #ifdef HAVE_SGTTY
329 /* This flushes both input and output, but we can't do better. */
330 return ioctl (scb->fd, TIOCFLUSH, 0);
331 #endif
334 static int
335 hardwire_flush_input (struct serial *scb)
337 ser_unix_flush_input (scb);
339 #ifdef HAVE_TERMIOS
340 return tcflush (scb->fd, TCIFLUSH);
341 #endif
343 #ifdef HAVE_TERMIO
344 return ioctl (scb->fd, TCFLSH, 0);
345 #endif
347 #ifdef HAVE_SGTTY
348 /* This flushes both input and output, but we can't do better. */
349 return ioctl (scb->fd, TIOCFLUSH, 0);
350 #endif
353 static int
354 hardwire_send_break (struct serial *scb)
356 #ifdef HAVE_TERMIOS
357 return tcsendbreak (scb->fd, 0);
358 #endif
360 #ifdef HAVE_TERMIO
361 return ioctl (scb->fd, TCSBRK, 0);
362 #endif
364 #ifdef HAVE_SGTTY
366 int status;
367 struct timeval timeout;
369 status = ioctl (scb->fd, TIOCSBRK, 0);
371 /* Can't use usleep; it doesn't exist in BSD 4.2. */
372 /* Note that if this select() is interrupted by a signal it will not wait
373 the full length of time. I think that is OK. */
374 timeout.tv_sec = 0;
375 timeout.tv_usec = 250000;
376 select (0, 0, 0, 0, &timeout);
377 status = ioctl (scb->fd, TIOCCBRK, 0);
378 return status;
380 #endif
383 static void
384 hardwire_raw (struct serial *scb)
386 struct hardwire_ttystate state;
388 if (get_tty_state (scb, &state))
389 fprintf_unfiltered (gdb_stderr, "get_tty_state failed: %s\n", safe_strerror (errno));
391 #ifdef HAVE_TERMIOS
392 state.termios.c_iflag = 0;
393 state.termios.c_oflag = 0;
394 state.termios.c_lflag = 0;
395 state.termios.c_cflag &= ~(CSIZE | PARENB);
396 state.termios.c_cflag |= CLOCAL | CS8;
397 state.termios.c_cc[VMIN] = 0;
398 state.termios.c_cc[VTIME] = 0;
399 #endif
401 #ifdef HAVE_TERMIO
402 state.termio.c_iflag = 0;
403 state.termio.c_oflag = 0;
404 state.termio.c_lflag = 0;
405 state.termio.c_cflag &= ~(CSIZE | PARENB);
406 state.termio.c_cflag |= CLOCAL | CS8;
407 state.termio.c_cc[VMIN] = 0;
408 state.termio.c_cc[VTIME] = 0;
409 #endif
411 #ifdef HAVE_SGTTY
412 state.sgttyb.sg_flags |= RAW | ANYP;
413 state.sgttyb.sg_flags &= ~(CBREAK | ECHO);
414 #endif
416 scb->current_timeout = 0;
418 if (set_tty_state (scb, &state))
419 fprintf_unfiltered (gdb_stderr, "set_tty_state failed: %s\n", safe_strerror (errno));
422 /* Wait for input on scb, with timeout seconds. Returns 0 on success,
423 otherwise SERIAL_TIMEOUT or SERIAL_ERROR.
425 For termio{s}, we actually just setup VTIME if necessary, and let the
426 timeout occur in the read() in hardwire_read().
429 /* FIXME: cagney/1999-09-16: Don't replace this with the equivalent
430 ser_unix*() until the old TERMIOS/SGTTY/... timer code has been
431 flushed. . */
433 /* NOTE: cagney/1999-09-30: Much of the code below is dead. The only
434 possible values of the TIMEOUT parameter are ONE and ZERO.
435 Consequently all the code that tries to handle the possability of
436 an overflowed timer is unnecessary. */
438 static int
439 wait_for (struct serial *scb, int timeout)
441 #ifdef HAVE_SGTTY
442 while (1)
444 struct timeval tv;
445 fd_set readfds;
446 int numfds;
448 /* NOTE: Some OS's can scramble the READFDS when the select()
449 call fails (ex the kernel with Red Hat 5.2). Initialize all
450 arguments before each call. */
452 tv.tv_sec = timeout;
453 tv.tv_usec = 0;
455 FD_ZERO (&readfds);
456 FD_SET (scb->fd, &readfds);
458 if (timeout >= 0)
459 numfds = select (scb->fd + 1, &readfds, 0, 0, &tv);
460 else
461 numfds = select (scb->fd + 1, &readfds, 0, 0, 0);
463 if (numfds <= 0)
464 if (numfds == 0)
465 return SERIAL_TIMEOUT;
466 else if (errno == EINTR)
467 continue;
468 else
469 return SERIAL_ERROR; /* Got an error from select or poll */
471 return 0;
473 #endif /* HAVE_SGTTY */
475 #if defined HAVE_TERMIO || defined HAVE_TERMIOS
476 if (timeout == scb->current_timeout)
477 return 0;
479 scb->current_timeout = timeout;
482 struct hardwire_ttystate state;
484 if (get_tty_state (scb, &state))
485 fprintf_unfiltered (gdb_stderr, "get_tty_state failed: %s\n", safe_strerror (errno));
487 #ifdef HAVE_TERMIOS
488 if (timeout < 0)
490 /* No timeout. */
491 state.termios.c_cc[VTIME] = 0;
492 state.termios.c_cc[VMIN] = 1;
494 else
496 state.termios.c_cc[VMIN] = 0;
497 state.termios.c_cc[VTIME] = timeout * 10;
498 if (state.termios.c_cc[VTIME] != timeout * 10)
501 /* If c_cc is an 8-bit signed character, we can't go
502 bigger than this. If it is always unsigned, we could use
503 25. */
505 scb->current_timeout = 12;
506 state.termios.c_cc[VTIME] = scb->current_timeout * 10;
507 scb->timeout_remaining = timeout - scb->current_timeout;
510 #endif
512 #ifdef HAVE_TERMIO
513 if (timeout < 0)
515 /* No timeout. */
516 state.termio.c_cc[VTIME] = 0;
517 state.termio.c_cc[VMIN] = 1;
519 else
521 state.termio.c_cc[VMIN] = 0;
522 state.termio.c_cc[VTIME] = timeout * 10;
523 if (state.termio.c_cc[VTIME] != timeout * 10)
525 /* If c_cc is an 8-bit signed character, we can't go
526 bigger than this. If it is always unsigned, we could use
527 25. */
529 scb->current_timeout = 12;
530 state.termio.c_cc[VTIME] = scb->current_timeout * 10;
531 scb->timeout_remaining = timeout - scb->current_timeout;
534 #endif
536 if (set_tty_state (scb, &state))
537 fprintf_unfiltered (gdb_stderr, "set_tty_state failed: %s\n", safe_strerror (errno));
539 return 0;
541 #endif /* HAVE_TERMIO || HAVE_TERMIOS */
544 /* Read a character with user-specified timeout. TIMEOUT is number of seconds
545 to wait, or -1 to wait forever. Use timeout of 0 to effect a poll. Returns
546 char if successful. Returns SERIAL_TIMEOUT if timeout expired, EOF if line
547 dropped dead, or SERIAL_ERROR for any other error (see errno in that case). */
549 /* FIXME: cagney/1999-09-16: Don't replace this with the equivalent
550 ser_unix*() until the old TERMIOS/SGTTY/... timer code has been
551 flushed. */
553 /* NOTE: cagney/1999-09-16: This function is not identical to
554 ser_unix_readchar() as part of replacing it with ser_unix*()
555 merging will be required - this code handles the case where read()
556 times out due to no data while ser_unix_readchar() doesn't expect
557 that. */
559 static int
560 do_hardwire_readchar (struct serial *scb, int timeout)
562 int status, delta;
563 int detach = 0;
565 if (timeout > 0)
566 timeout++;
568 /* We have to be able to keep the GUI alive here, so we break the original
569 timeout into steps of 1 second, running the "keep the GUI alive" hook
570 each time through the loop.
571 Also, timeout = 0 means to poll, so we just set the delta to 0, so we
572 will only go through the loop once. */
574 delta = (timeout == 0 ? 0 : 1);
575 while (1)
578 /* N.B. The UI may destroy our world (for instance by calling
579 remote_stop,) in which case we want to get out of here as
580 quickly as possible. It is not safe to touch scb, since
581 someone else might have freed it. The
582 deprecated_ui_loop_hook signals that we should exit by
583 returning 1. */
585 if (deprecated_ui_loop_hook)
586 detach = deprecated_ui_loop_hook (0);
588 if (detach)
589 return SERIAL_TIMEOUT;
591 scb->timeout_remaining = (timeout < 0 ? timeout : timeout - delta);
592 status = wait_for (scb, delta);
594 if (status < 0)
595 return status;
597 status = read (scb->fd, scb->buf, BUFSIZ);
599 if (status <= 0)
601 if (status == 0)
603 /* Zero characters means timeout (it could also be EOF, but
604 we don't (yet at least) distinguish). */
605 if (scb->timeout_remaining > 0)
607 timeout = scb->timeout_remaining;
608 continue;
610 else if (scb->timeout_remaining < 0)
611 continue;
612 else
613 return SERIAL_TIMEOUT;
615 else if (errno == EINTR)
616 continue;
617 else
618 return SERIAL_ERROR; /* Got an error from read */
621 scb->bufcnt = status;
622 scb->bufcnt--;
623 scb->bufp = scb->buf;
624 return *scb->bufp++;
628 static int
629 hardwire_readchar (struct serial *scb, int timeout)
631 return generic_readchar (scb, timeout, do_hardwire_readchar);
635 #ifndef B19200
636 #define B19200 EXTA
637 #endif
639 #ifndef B38400
640 #define B38400 EXTB
641 #endif
643 /* Translate baud rates from integers to damn B_codes. Unix should
644 have outgrown this crap years ago, but even POSIX wouldn't buck it. */
646 static struct
648 int rate;
649 int code;
651 baudtab[] =
654 50, B50
658 75, B75
662 110, B110
666 134, B134
670 150, B150
674 200, B200
678 300, B300
682 600, B600
686 1200, B1200
690 1800, B1800
694 2400, B2400
698 4800, B4800
702 9600, B9600
706 19200, B19200
710 38400, B38400
713 #ifdef B57600
715 57600, B57600
718 #endif
719 #ifdef B115200
721 115200, B115200
724 #endif
725 #ifdef B230400
727 230400, B230400
730 #endif
731 #ifdef B460800
733 460800, B460800
736 #endif
738 -1, -1
743 static int
744 rate_to_code (int rate)
746 int i;
748 for (i = 0; baudtab[i].rate != -1; i++)
750 /* test for perfect macth. */
751 if (rate == baudtab[i].rate)
752 return baudtab[i].code;
753 else
755 /* check if it is in between valid values. */
756 if (rate < baudtab[i].rate)
758 if (i)
760 warning ("Invalid baud rate %d. Closest values are %d and %d.",
761 rate, baudtab[i - 1].rate, baudtab[i].rate);
763 else
765 warning ("Invalid baud rate %d. Minimum value is %d.",
766 rate, baudtab[0].rate);
768 return -1;
773 /* The requested speed was too large. */
774 warning ("Invalid baud rate %d. Maximum value is %d.",
775 rate, baudtab[i - 1].rate);
776 return -1;
779 static int
780 hardwire_setbaudrate (struct serial *scb, int rate)
782 struct hardwire_ttystate state;
783 int baud_code = rate_to_code (rate);
785 if (baud_code < 0)
787 /* The baud rate was not valid.
788 A warning has already been issued. */
789 errno = EINVAL;
790 return -1;
793 if (get_tty_state (scb, &state))
794 return -1;
796 #ifdef HAVE_TERMIOS
797 cfsetospeed (&state.termios, baud_code);
798 cfsetispeed (&state.termios, baud_code);
799 #endif
801 #ifdef HAVE_TERMIO
802 #ifndef CIBAUD
803 #define CIBAUD CBAUD
804 #endif
806 state.termio.c_cflag &= ~(CBAUD | CIBAUD);
807 state.termio.c_cflag |= baud_code;
808 #endif
810 #ifdef HAVE_SGTTY
811 state.sgttyb.sg_ispeed = baud_code;
812 state.sgttyb.sg_ospeed = baud_code;
813 #endif
815 return set_tty_state (scb, &state);
818 static int
819 hardwire_setstopbits (struct serial *scb, int num)
821 struct hardwire_ttystate state;
822 int newbit;
824 if (get_tty_state (scb, &state))
825 return -1;
827 switch (num)
829 case SERIAL_1_STOPBITS:
830 newbit = 0;
831 break;
832 case SERIAL_1_AND_A_HALF_STOPBITS:
833 case SERIAL_2_STOPBITS:
834 newbit = 1;
835 break;
836 default:
837 return 1;
840 #ifdef HAVE_TERMIOS
841 if (!newbit)
842 state.termios.c_cflag &= ~CSTOPB;
843 else
844 state.termios.c_cflag |= CSTOPB; /* two bits */
845 #endif
847 #ifdef HAVE_TERMIO
848 if (!newbit)
849 state.termio.c_cflag &= ~CSTOPB;
850 else
851 state.termio.c_cflag |= CSTOPB; /* two bits */
852 #endif
854 #ifdef HAVE_SGTTY
855 return 0; /* sgtty doesn't support this */
856 #endif
858 return set_tty_state (scb, &state);
861 static void
862 hardwire_close (struct serial *scb)
864 if (scb->fd < 0)
865 return;
867 close (scb->fd);
868 scb->fd = -1;
872 /* Generic operations used by all UNIX/FD based serial interfaces. */
874 serial_ttystate
875 ser_unix_nop_get_tty_state (struct serial *scb)
877 /* allocate a dummy */
878 return (serial_ttystate) XMALLOC (int);
882 ser_unix_nop_set_tty_state (struct serial *scb, serial_ttystate ttystate)
884 return 0;
887 void
888 ser_unix_nop_raw (struct serial *scb)
890 return; /* Always in raw mode */
893 /* Wait for input on scb, with timeout seconds. Returns 0 on success,
894 otherwise SERIAL_TIMEOUT or SERIAL_ERROR. */
897 ser_unix_wait_for (struct serial *scb, int timeout)
899 while (1)
901 int numfds;
902 struct timeval tv;
903 fd_set readfds, exceptfds;
905 /* NOTE: Some OS's can scramble the READFDS when the select()
906 call fails (ex the kernel with Red Hat 5.2). Initialize all
907 arguments before each call. */
909 tv.tv_sec = timeout;
910 tv.tv_usec = 0;
912 FD_ZERO (&readfds);
913 FD_ZERO (&exceptfds);
914 FD_SET (scb->fd, &readfds);
915 FD_SET (scb->fd, &exceptfds);
917 if (timeout >= 0)
918 numfds = select (scb->fd + 1, &readfds, 0, &exceptfds, &tv);
919 else
920 numfds = select (scb->fd + 1, &readfds, 0, &exceptfds, 0);
922 if (numfds <= 0)
924 if (numfds == 0)
925 return SERIAL_TIMEOUT;
926 else if (errno == EINTR)
927 continue;
928 else
929 return SERIAL_ERROR; /* Got an error from select or poll */
932 return 0;
936 /* Read a character with user-specified timeout. TIMEOUT is number of seconds
937 to wait, or -1 to wait forever. Use timeout of 0 to effect a poll. Returns
938 char if successful. Returns -2 if timeout expired, EOF if line dropped
939 dead, or -3 for any other error (see errno in that case). */
941 static int
942 do_unix_readchar (struct serial *scb, int timeout)
944 int status;
945 int delta;
947 /* We have to be able to keep the GUI alive here, so we break the original
948 timeout into steps of 1 second, running the "keep the GUI alive" hook
949 each time through the loop.
951 Also, timeout = 0 means to poll, so we just set the delta to 0, so we
952 will only go through the loop once. */
954 delta = (timeout == 0 ? 0 : 1);
955 while (1)
958 /* N.B. The UI may destroy our world (for instance by calling
959 remote_stop,) in which case we want to get out of here as
960 quickly as possible. It is not safe to touch scb, since
961 someone else might have freed it. The
962 deprecated_ui_loop_hook signals that we should exit by
963 returning 1. */
965 if (deprecated_ui_loop_hook)
967 if (deprecated_ui_loop_hook (0))
968 return SERIAL_TIMEOUT;
971 status = ser_unix_wait_for (scb, delta);
972 if (timeout > 0)
973 timeout -= delta;
975 /* If we got a character or an error back from wait_for, then we can
976 break from the loop before the timeout is completed. */
978 if (status != SERIAL_TIMEOUT)
980 break;
983 /* If we have exhausted the original timeout, then generate
984 a SERIAL_TIMEOUT, and pass it out of the loop. */
986 else if (timeout == 0)
988 status = SERIAL_TIMEOUT;
989 break;
993 if (status < 0)
994 return status;
996 while (1)
998 status = read (scb->fd, scb->buf, BUFSIZ);
999 if (status != -1 || errno != EINTR)
1000 break;
1003 if (status <= 0)
1005 if (status == 0)
1006 return SERIAL_TIMEOUT; /* 0 chars means timeout [may need to
1007 distinguish between EOF & timeouts
1008 someday] */
1009 else
1010 return SERIAL_ERROR; /* Got an error from read */
1013 scb->bufcnt = status;
1014 scb->bufcnt--;
1015 scb->bufp = scb->buf;
1016 return *scb->bufp++;
1019 /* Perform operations common to both old and new readchar. */
1021 /* Return the next character from the input FIFO. If the FIFO is
1022 empty, call the SERIAL specific routine to try and read in more
1023 characters.
1025 Initially data from the input FIFO is returned (fd_event()
1026 pre-reads the input into that FIFO. Once that has been emptied,
1027 further data is obtained by polling the input FD using the device
1028 specific readchar() function. Note: reschedule() is called after
1029 every read. This is because there is no guarentee that the lower
1030 level fd_event() poll_event() code (which also calls reschedule())
1031 will be called. */
1033 static int
1034 generic_readchar (struct serial *scb, int timeout,
1035 int (do_readchar) (struct serial *scb, int timeout))
1037 int ch;
1038 if (scb->bufcnt > 0)
1040 ch = *scb->bufp;
1041 scb->bufcnt--;
1042 scb->bufp++;
1044 else if (scb->bufcnt < 0)
1046 /* Some errors/eof are are sticky. */
1047 ch = scb->bufcnt;
1049 else
1051 ch = do_readchar (scb, timeout);
1052 if (ch < 0)
1054 switch ((enum serial_rc) ch)
1056 case SERIAL_EOF:
1057 case SERIAL_ERROR:
1058 /* Make the error/eof stick. */
1059 scb->bufcnt = ch;
1060 break;
1061 case SERIAL_TIMEOUT:
1062 scb->bufcnt = 0;
1063 break;
1067 reschedule (scb);
1068 return ch;
1072 ser_unix_readchar (struct serial *scb, int timeout)
1074 return generic_readchar (scb, timeout, do_unix_readchar);
1078 ser_unix_nop_noflush_set_tty_state (struct serial *scb,
1079 serial_ttystate new_ttystate,
1080 serial_ttystate old_ttystate)
1082 return 0;
1085 void
1086 ser_unix_nop_print_tty_state (struct serial *scb,
1087 serial_ttystate ttystate,
1088 struct ui_file *stream)
1090 /* Nothing to print. */
1091 return;
1095 ser_unix_nop_setbaudrate (struct serial *scb, int rate)
1097 return 0; /* Never fails! */
1101 ser_unix_nop_setstopbits (struct serial *scb, int num)
1103 return 0; /* Never fails! */
1107 ser_unix_write (struct serial *scb, const char *str, int len)
1109 int cc;
1111 while (len > 0)
1113 cc = write (scb->fd, str, len);
1115 if (cc < 0)
1116 return 1;
1117 len -= cc;
1118 str += cc;
1120 return 0;
1124 ser_unix_nop_flush_output (struct serial *scb)
1126 return 0;
1130 ser_unix_flush_input (struct serial *scb)
1132 if (scb->bufcnt >= 0)
1134 scb->bufcnt = 0;
1135 scb->bufp = scb->buf;
1136 return 0;
1138 else
1139 return SERIAL_ERROR;
1143 ser_unix_nop_send_break (struct serial *scb)
1145 return 0;
1149 ser_unix_nop_drain_output (struct serial *scb)
1151 return 0;
1156 /* Event handling for ASYNC serial code.
1158 At any time the SERIAL device either: has an empty FIFO and is
1159 waiting on a FD event; or has a non-empty FIFO/error condition and
1160 is constantly scheduling timer events.
1162 ASYNC only stops pestering its client when it is de-async'ed or it
1163 is told to go away. */
1165 /* Value of scb->async_state: */
1166 enum {
1167 /* >= 0 (TIMER_SCHEDULED) */
1168 /* The ID of the currently scheduled timer event. This state is
1169 rarely encountered. Timer events are one-off so as soon as the
1170 event is delivered the state is shanged to NOTHING_SCHEDULED. */
1171 FD_SCHEDULED = -1,
1172 /* The fd_event() handler is scheduled. It is called when ever the
1173 file descriptor becomes ready. */
1174 NOTHING_SCHEDULED = -2
1175 /* Either no task is scheduled (just going into ASYNC mode) or a
1176 timer event has just gone off and the current state has been
1177 forced into nothing scheduled. */
1180 /* Identify and schedule the next ASYNC task based on scb->async_state
1181 and scb->buf* (the input FIFO). A state machine is used to avoid
1182 the need to make redundant calls into the event-loop - the next
1183 scheduled task is only changed when needed. */
1185 static void
1186 reschedule (struct serial *scb)
1188 if (serial_is_async_p (scb))
1190 int next_state;
1191 switch (scb->async_state)
1193 case FD_SCHEDULED:
1194 if (scb->bufcnt == 0)
1195 next_state = FD_SCHEDULED;
1196 else
1198 delete_file_handler (scb->fd);
1199 next_state = create_timer (0, push_event, scb);
1201 break;
1202 case NOTHING_SCHEDULED:
1203 if (scb->bufcnt == 0)
1205 add_file_handler (scb->fd, fd_event, scb);
1206 next_state = FD_SCHEDULED;
1208 else
1210 next_state = create_timer (0, push_event, scb);
1212 break;
1213 default: /* TIMER SCHEDULED */
1214 if (scb->bufcnt == 0)
1216 delete_timer (scb->async_state);
1217 add_file_handler (scb->fd, fd_event, scb);
1218 next_state = FD_SCHEDULED;
1220 else
1221 next_state = scb->async_state;
1222 break;
1224 if (serial_debug_p (scb))
1226 switch (next_state)
1228 case FD_SCHEDULED:
1229 if (scb->async_state != FD_SCHEDULED)
1230 fprintf_unfiltered (gdb_stdlog, "[fd%d->fd-scheduled]\n",
1231 scb->fd);
1232 break;
1233 default: /* TIMER SCHEDULED */
1234 if (scb->async_state == FD_SCHEDULED)
1235 fprintf_unfiltered (gdb_stdlog, "[fd%d->timer-scheduled]\n",
1236 scb->fd);
1237 break;
1240 scb->async_state = next_state;
1244 /* FD_EVENT: This is scheduled when the input FIFO is empty (and there
1245 is no pending error). As soon as data arrives, it is read into the
1246 input FIFO and the client notified. The client should then drain
1247 the FIFO using readchar(). If the FIFO isn't immediatly emptied,
1248 push_event() is used to nag the client until it is. */
1250 static void
1251 fd_event (int error, void *context)
1253 struct serial *scb = context;
1254 if (error != 0)
1256 scb->bufcnt = SERIAL_ERROR;
1258 else if (scb->bufcnt == 0)
1260 /* Prime the input FIFO. The readchar() function is used to
1261 pull characters out of the buffer. See also
1262 generic_readchar(). */
1263 int nr;
1266 nr = read (scb->fd, scb->buf, BUFSIZ);
1268 while (nr == -1 && errno == EINTR);
1269 if (nr == 0)
1271 scb->bufcnt = SERIAL_EOF;
1273 else if (nr > 0)
1275 scb->bufcnt = nr;
1276 scb->bufp = scb->buf;
1278 else
1280 scb->bufcnt = SERIAL_ERROR;
1283 scb->async_handler (scb, scb->async_context);
1284 reschedule (scb);
1287 /* PUSH_EVENT: The input FIFO is non-empty (or there is a pending
1288 error). Nag the client until all the data has been read. In the
1289 case of errors, the client will need to close or de-async the
1290 device before naging stops. */
1292 static void
1293 push_event (void *context)
1295 struct serial *scb = context;
1296 scb->async_state = NOTHING_SCHEDULED; /* Timers are one-off */
1297 scb->async_handler (scb, scb->async_context);
1298 /* re-schedule */
1299 reschedule (scb);
1302 /* Put the SERIAL device into/out-of ASYNC mode. */
1304 void
1305 ser_unix_async (struct serial *scb,
1306 int async_p)
1308 if (async_p)
1310 /* Force a re-schedule. */
1311 scb->async_state = NOTHING_SCHEDULED;
1312 if (serial_debug_p (scb))
1313 fprintf_unfiltered (gdb_stdlog, "[fd%d->asynchronous]\n",
1314 scb->fd);
1315 reschedule (scb);
1317 else
1319 if (serial_debug_p (scb))
1320 fprintf_unfiltered (gdb_stdlog, "[fd%d->synchronous]\n",
1321 scb->fd);
1322 /* De-schedule whatever tasks are currently scheduled. */
1323 switch (scb->async_state)
1325 case FD_SCHEDULED:
1326 delete_file_handler (scb->fd);
1327 break;
1328 case NOTHING_SCHEDULED:
1329 break;
1330 default: /* TIMER SCHEDULED */
1331 delete_timer (scb->async_state);
1332 break;
1337 void
1338 _initialize_ser_hardwire (void)
1340 struct serial_ops *ops = XMALLOC (struct serial_ops);
1341 memset (ops, 0, sizeof (struct serial_ops));
1342 ops->name = "hardwire";
1343 ops->next = 0;
1344 ops->open = hardwire_open;
1345 ops->close = hardwire_close;
1346 /* FIXME: Don't replace this with the equivalent ser_unix*() until
1347 the old TERMIOS/SGTTY/... timer code has been flushed. cagney
1348 1999-09-16. */
1349 ops->readchar = hardwire_readchar;
1350 ops->write = ser_unix_write;
1351 ops->flush_output = hardwire_flush_output;
1352 ops->flush_input = hardwire_flush_input;
1353 ops->send_break = hardwire_send_break;
1354 ops->go_raw = hardwire_raw;
1355 ops->get_tty_state = hardwire_get_tty_state;
1356 ops->set_tty_state = hardwire_set_tty_state;
1357 ops->print_tty_state = hardwire_print_tty_state;
1358 ops->noflush_set_tty_state = hardwire_noflush_set_tty_state;
1359 ops->setbaudrate = hardwire_setbaudrate;
1360 ops->setstopbits = hardwire_setstopbits;
1361 ops->drain_output = hardwire_drain_output;
1362 ops->async = ser_unix_async;
1363 serial_add_interface (ops);