Update release README with new version numbers
[binutils-gdb.git] / gdb / ser-mingw.c
blobafe04102e1554ec734b7fe18c73a7b231ce224d9
1 /* Serial interface for local (hardwired) serial ports on Windows systems
3 Copyright (C) 2006-2022 Free Software Foundation, Inc.
5 This file is part of GDB.
7 This program is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 3 of the License, or
10 (at your option) any later version.
12 This program is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with this program. If not, see <http://www.gnu.org/licenses/>. */
20 #include "defs.h"
21 #include "serial.h"
22 #include "ser-base.h"
23 #include "ser-tcp.h"
25 #include <windows.h>
26 #include <conio.h>
28 #include <fcntl.h>
29 #include <unistd.h>
30 #include <sys/types.h>
32 #include "command.h"
33 #include "gdbsupport/buildargv.h"
35 struct ser_windows_state
37 int in_progress;
38 OVERLAPPED ov;
39 DWORD lastCommMask;
40 HANDLE except_event;
43 /* CancelIo is not available for Windows 95 OS, so we need to use
44 LoadLibrary/GetProcAddress to avoid a startup failure. */
45 #define CancelIo dyn_CancelIo
46 typedef BOOL WINAPI (CancelIo_ftype) (HANDLE);
47 static CancelIo_ftype *CancelIo;
49 /* Open up a real live device for serial I/O. */
51 static int
52 ser_windows_open (struct serial *scb, const char *name)
54 HANDLE h;
55 struct ser_windows_state *state;
56 COMMTIMEOUTS timeouts;
58 h = CreateFile (name, GENERIC_READ | GENERIC_WRITE, 0, NULL,
59 OPEN_EXISTING, FILE_FLAG_OVERLAPPED, NULL);
60 if (h == INVALID_HANDLE_VALUE)
62 errno = ENOENT;
63 return -1;
66 scb->fd = _open_osfhandle ((intptr_t) h, O_RDWR);
67 if (scb->fd < 0)
69 errno = ENOENT;
70 return -1;
73 if (!SetCommMask (h, EV_RXCHAR))
75 errno = EINVAL;
76 return -1;
79 timeouts.ReadIntervalTimeout = MAXDWORD;
80 timeouts.ReadTotalTimeoutConstant = 0;
81 timeouts.ReadTotalTimeoutMultiplier = 0;
82 timeouts.WriteTotalTimeoutConstant = 0;
83 timeouts.WriteTotalTimeoutMultiplier = 0;
84 if (!SetCommTimeouts (h, &timeouts))
86 errno = EINVAL;
87 return -1;
90 state = XCNEW (struct ser_windows_state);
91 scb->state = state;
93 /* Create a manual reset event to watch the input buffer. */
94 state->ov.hEvent = CreateEvent (0, TRUE, FALSE, 0);
96 /* Create a (currently unused) handle to record exceptions. */
97 state->except_event = CreateEvent (0, TRUE, FALSE, 0);
99 return 0;
102 /* Wait for the output to drain away, as opposed to flushing (discarding)
103 it. */
105 static int
106 ser_windows_drain_output (struct serial *scb)
108 HANDLE h = (HANDLE) _get_osfhandle (scb->fd);
110 return (FlushFileBuffers (h) != 0) ? 0 : -1;
113 static int
114 ser_windows_flush_output (struct serial *scb)
116 HANDLE h = (HANDLE) _get_osfhandle (scb->fd);
118 return (PurgeComm (h, PURGE_TXCLEAR) != 0) ? 0 : -1;
121 static int
122 ser_windows_flush_input (struct serial *scb)
124 HANDLE h = (HANDLE) _get_osfhandle (scb->fd);
126 return (PurgeComm (h, PURGE_RXCLEAR) != 0) ? 0 : -1;
129 static int
130 ser_windows_send_break (struct serial *scb)
132 HANDLE h = (HANDLE) _get_osfhandle (scb->fd);
134 if (SetCommBreak (h) == 0)
135 return -1;
137 /* Delay for 250 milliseconds. */
138 Sleep (250);
140 if (ClearCommBreak (h))
141 return -1;
143 return 0;
146 static void
147 ser_windows_raw (struct serial *scb)
149 HANDLE h = (HANDLE) _get_osfhandle (scb->fd);
150 DCB state;
152 if (GetCommState (h, &state) == 0)
153 return;
155 state.fOutxCtsFlow = FALSE;
156 state.fOutxDsrFlow = FALSE;
157 state.fDtrControl = DTR_CONTROL_ENABLE;
158 state.fDsrSensitivity = FALSE;
159 state.fOutX = FALSE;
160 state.fInX = FALSE;
161 state.fNull = FALSE;
162 state.fAbortOnError = FALSE;
163 state.ByteSize = 8;
165 if (SetCommState (h, &state) == 0)
166 warning (_("SetCommState failed"));
169 static int
170 ser_windows_setstopbits (struct serial *scb, int num)
172 HANDLE h = (HANDLE) _get_osfhandle (scb->fd);
173 DCB state;
175 if (GetCommState (h, &state) == 0)
176 return -1;
178 switch (num)
180 case SERIAL_1_STOPBITS:
181 state.StopBits = ONESTOPBIT;
182 break;
183 case SERIAL_1_AND_A_HALF_STOPBITS:
184 state.StopBits = ONE5STOPBITS;
185 break;
186 case SERIAL_2_STOPBITS:
187 state.StopBits = TWOSTOPBITS;
188 break;
189 default:
190 return 1;
193 return (SetCommState (h, &state) != 0) ? 0 : -1;
196 /* Implement the "setparity" serial_ops callback. */
198 static int
199 ser_windows_setparity (struct serial *scb, int parity)
201 HANDLE h = (HANDLE) _get_osfhandle (scb->fd);
202 DCB state;
204 if (GetCommState (h, &state) == 0)
205 return -1;
207 switch (parity)
209 case GDBPARITY_NONE:
210 state.Parity = NOPARITY;
211 state.fParity = FALSE;
212 break;
213 case GDBPARITY_ODD:
214 state.Parity = ODDPARITY;
215 state.fParity = TRUE;
216 break;
217 case GDBPARITY_EVEN:
218 state.Parity = EVENPARITY;
219 state.fParity = TRUE;
220 break;
221 default:
222 internal_warning (__FILE__, __LINE__,
223 "Incorrect parity value: %d", parity);
224 return -1;
227 return (SetCommState (h, &state) != 0) ? 0 : -1;
230 static int
231 ser_windows_setbaudrate (struct serial *scb, int rate)
233 HANDLE h = (HANDLE) _get_osfhandle (scb->fd);
234 DCB state;
236 if (GetCommState (h, &state) == 0)
237 return -1;
239 state.BaudRate = rate;
241 return (SetCommState (h, &state) != 0) ? 0 : -1;
244 static void
245 ser_windows_close (struct serial *scb)
247 struct ser_windows_state *state;
249 /* Stop any pending selects. On Windows 95 OS, CancelIo function does
250 not exist. In that case, it can be replaced by a call to CloseHandle,
251 but this is not necessary here as we do close the Windows handle
252 by calling close (scb->fd) below. */
253 if (CancelIo)
254 CancelIo ((HANDLE) _get_osfhandle (scb->fd));
255 state = (struct ser_windows_state *) scb->state;
256 CloseHandle (state->ov.hEvent);
257 CloseHandle (state->except_event);
259 if (scb->fd < 0)
260 return;
262 close (scb->fd);
263 scb->fd = -1;
265 xfree (scb->state);
268 static void
269 ser_windows_wait_handle (struct serial *scb, HANDLE *read, HANDLE *except)
271 struct ser_windows_state *state;
272 COMSTAT status;
273 DWORD errors;
274 HANDLE h = (HANDLE) _get_osfhandle (scb->fd);
276 state = (struct ser_windows_state *) scb->state;
278 *except = state->except_event;
279 *read = state->ov.hEvent;
281 if (state->in_progress)
282 return;
284 /* Reset the mask - we are only interested in any characters which
285 arrive after this point, not characters which might have arrived
286 and already been read. */
288 /* This really, really shouldn't be necessary - just the second one.
289 But otherwise an internal flag for EV_RXCHAR does not get
290 cleared, and we get a duplicated event, if the last batch
291 of characters included at least two arriving close together. */
292 if (!SetCommMask (h, 0))
293 warning (_("ser_windows_wait_handle: reseting mask failed"));
295 if (!SetCommMask (h, EV_RXCHAR))
296 warning (_("ser_windows_wait_handle: reseting mask failed (2)"));
298 /* There's a potential race condition here; we must check cbInQue
299 and not wait if that's nonzero. */
301 ClearCommError (h, &errors, &status);
302 if (status.cbInQue > 0)
304 SetEvent (state->ov.hEvent);
305 return;
308 state->in_progress = 1;
309 ResetEvent (state->ov.hEvent);
310 state->lastCommMask = -2;
311 if (WaitCommEvent (h, &state->lastCommMask, &state->ov))
313 gdb_assert (state->lastCommMask & EV_RXCHAR);
314 SetEvent (state->ov.hEvent);
316 else
317 gdb_assert (GetLastError () == ERROR_IO_PENDING);
320 static int
321 ser_windows_read_prim (struct serial *scb, size_t count)
323 struct ser_windows_state *state;
324 OVERLAPPED ov;
325 DWORD bytes_read;
326 HANDLE h;
328 state = (struct ser_windows_state *) scb->state;
329 if (state->in_progress)
331 WaitForSingleObject (state->ov.hEvent, INFINITE);
332 state->in_progress = 0;
333 ResetEvent (state->ov.hEvent);
336 memset (&ov, 0, sizeof (OVERLAPPED));
337 ov.hEvent = CreateEvent (0, FALSE, FALSE, 0);
338 h = (HANDLE) _get_osfhandle (scb->fd);
340 if (!ReadFile (h, scb->buf, /* count */ 1, &bytes_read, &ov))
342 if (GetLastError () != ERROR_IO_PENDING
343 || !GetOverlappedResult (h, &ov, &bytes_read, TRUE))
344 bytes_read = -1;
347 CloseHandle (ov.hEvent);
348 return bytes_read;
351 static int
352 ser_windows_write_prim (struct serial *scb, const void *buf, size_t len)
354 OVERLAPPED ov;
355 DWORD bytes_written;
356 HANDLE h;
358 memset (&ov, 0, sizeof (OVERLAPPED));
359 ov.hEvent = CreateEvent (0, FALSE, FALSE, 0);
360 h = (HANDLE) _get_osfhandle (scb->fd);
361 if (!WriteFile (h, buf, len, &bytes_written, &ov))
363 if (GetLastError () != ERROR_IO_PENDING
364 || !GetOverlappedResult (h, &ov, &bytes_written, TRUE))
365 bytes_written = -1;
368 CloseHandle (ov.hEvent);
369 return bytes_written;
372 /* On Windows, gdb_select is implemented using WaitForMulpleObjects.
373 A "select thread" is created for each file descriptor. These
374 threads looks for activity on the corresponding descriptor, using
375 whatever techniques are appropriate for the descriptor type. When
376 that activity occurs, the thread signals an appropriate event,
377 which wakes up WaitForMultipleObjects.
379 Each select thread is in one of two states: stopped or started.
380 Select threads begin in the stopped state. When gdb_select is
381 called, threads corresponding to the descriptors of interest are
382 started by calling a wait_handle function. Each thread that
383 notices activity signals the appropriate event and then reenters
384 the stopped state. Before gdb_select returns it calls the
385 wait_handle_done functions, which return the threads to the stopped
386 state. */
388 enum select_thread_state {
389 STS_STARTED,
390 STS_STOPPED
393 struct ser_console_state
395 /* Signaled by the select thread to indicate that data is available
396 on the file descriptor. */
397 HANDLE read_event;
398 /* Signaled by the select thread to indicate that an exception has
399 occurred on the file descriptor. */
400 HANDLE except_event;
401 /* Signaled by the select thread to indicate that it has entered the
402 started state. HAVE_STARTED and HAVE_STOPPED are never signaled
403 simultaneously. */
404 HANDLE have_started;
405 /* Signaled by the select thread to indicate that it has stopped,
406 either because data is available (and READ_EVENT is signaled),
407 because an exception has occurred (and EXCEPT_EVENT is signaled),
408 or because STOP_SELECT was signaled. */
409 HANDLE have_stopped;
411 /* Signaled by the main program to tell the select thread to enter
412 the started state. */
413 HANDLE start_select;
414 /* Signaled by the main program to tell the select thread to enter
415 the stopped state. */
416 HANDLE stop_select;
417 /* Signaled by the main program to tell the select thread to
418 exit. */
419 HANDLE exit_select;
421 /* The handle for the select thread. */
422 HANDLE thread;
423 /* The state of the select thread. This field is only accessed in
424 the main program, never by the select thread itself. */
425 enum select_thread_state thread_state;
428 /* Called by a select thread to enter the stopped state. This
429 function does not return until the thread has re-entered the
430 started state. */
431 static void
432 select_thread_wait (struct ser_console_state *state)
434 HANDLE wait_events[2];
436 /* There are two things that can wake us up: a request that we enter
437 the started state, or that we exit this thread. */
438 wait_events[0] = state->start_select;
439 wait_events[1] = state->exit_select;
440 if (WaitForMultipleObjects (2, wait_events, FALSE, INFINITE)
441 != WAIT_OBJECT_0)
442 /* Either the EXIT_SELECT event was signaled (requesting that the
443 thread exit) or an error has occurred. In either case, we exit
444 the thread. */
445 ExitThread (0);
447 /* We are now in the started state. */
448 SetEvent (state->have_started);
451 typedef DWORD WINAPI (*thread_fn_type)(void *);
453 /* Create a new select thread for SCB executing THREAD_FN. The STATE
454 will be filled in by this function before return. */
455 static void
456 create_select_thread (thread_fn_type thread_fn,
457 struct serial *scb,
458 struct ser_console_state *state)
460 DWORD threadId;
462 /* Create all of the events. These are all auto-reset events. */
463 state->read_event = CreateEvent (NULL, FALSE, FALSE, NULL);
464 state->except_event = CreateEvent (NULL, FALSE, FALSE, NULL);
465 state->have_started = CreateEvent (NULL, FALSE, FALSE, NULL);
466 state->have_stopped = CreateEvent (NULL, FALSE, FALSE, NULL);
467 state->start_select = CreateEvent (NULL, FALSE, FALSE, NULL);
468 state->stop_select = CreateEvent (NULL, FALSE, FALSE, NULL);
469 state->exit_select = CreateEvent (NULL, FALSE, FALSE, NULL);
471 state->thread = CreateThread (NULL, 0, thread_fn, scb, 0, &threadId);
472 /* The thread begins in the stopped state. */
473 state->thread_state = STS_STOPPED;
476 /* Destroy the select thread indicated by STATE. */
477 static void
478 destroy_select_thread (struct ser_console_state *state)
480 /* Ask the thread to exit. */
481 SetEvent (state->exit_select);
482 /* Wait until it does. */
483 WaitForSingleObject (state->thread, INFINITE);
485 /* Destroy the events. */
486 CloseHandle (state->read_event);
487 CloseHandle (state->except_event);
488 CloseHandle (state->have_started);
489 CloseHandle (state->have_stopped);
490 CloseHandle (state->start_select);
491 CloseHandle (state->stop_select);
492 CloseHandle (state->exit_select);
495 /* Called by gdb_select to start the select thread indicated by STATE.
496 This function does not return until the thread has started. */
497 static void
498 start_select_thread (struct ser_console_state *state)
500 /* Ask the thread to start. */
501 SetEvent (state->start_select);
502 /* Wait until it does. */
503 WaitForSingleObject (state->have_started, INFINITE);
504 /* The thread is now started. */
505 state->thread_state = STS_STARTED;
508 /* Called by gdb_select to stop the select thread indicated by STATE.
509 This function does not return until the thread has stopped. */
510 static void
511 stop_select_thread (struct ser_console_state *state)
513 /* If the thread is already in the stopped state, we have nothing to
514 do. Some of the wait_handle functions avoid calling
515 start_select_thread if they notice activity on the relevant file
516 descriptors. The wait_handle_done functions still call
517 stop_select_thread -- but it is already stopped. */
518 if (state->thread_state != STS_STARTED)
519 return;
520 /* Ask the thread to stop. */
521 SetEvent (state->stop_select);
522 /* Wait until it does. */
523 WaitForSingleObject (state->have_stopped, INFINITE);
524 /* The thread is now stopped. */
525 state->thread_state = STS_STOPPED;
528 static DWORD WINAPI
529 console_select_thread (void *arg)
531 struct serial *scb = (struct serial *) arg;
532 struct ser_console_state *state;
533 int event_index;
534 HANDLE h;
536 state = (struct ser_console_state *) scb->state;
537 h = (HANDLE) _get_osfhandle (scb->fd);
539 while (1)
541 HANDLE wait_events[2];
542 INPUT_RECORD record;
543 DWORD n_records;
545 select_thread_wait (state);
547 while (1)
549 wait_events[0] = state->stop_select;
550 wait_events[1] = h;
552 event_index = WaitForMultipleObjects (2, wait_events,
553 FALSE, INFINITE);
555 if (event_index == WAIT_OBJECT_0
556 || WaitForSingleObject (state->stop_select, 0) == WAIT_OBJECT_0)
557 break;
559 if (event_index != WAIT_OBJECT_0 + 1)
561 /* Wait must have failed; assume an error has occured, e.g.
562 the handle has been closed. */
563 SetEvent (state->except_event);
564 break;
567 /* We've got a pending event on the console. See if it's
568 of interest. */
569 if (!PeekConsoleInput (h, &record, 1, &n_records) || n_records != 1)
571 /* Something went wrong. Maybe the console is gone. */
572 SetEvent (state->except_event);
573 break;
576 if (record.EventType == KEY_EVENT && record.Event.KeyEvent.bKeyDown)
578 WORD keycode = record.Event.KeyEvent.wVirtualKeyCode;
580 /* Ignore events containing only control keys. We must
581 recognize "enhanced" keys which we are interested in
582 reading via getch, if they do not map to ASCII. But we
583 do not want to report input available for e.g. the
584 control key alone. */
586 if (record.Event.KeyEvent.uChar.AsciiChar != 0
587 || keycode == VK_PRIOR
588 || keycode == VK_NEXT
589 || keycode == VK_END
590 || keycode == VK_HOME
591 || keycode == VK_LEFT
592 || keycode == VK_UP
593 || keycode == VK_RIGHT
594 || keycode == VK_DOWN
595 || keycode == VK_INSERT
596 || keycode == VK_DELETE)
598 /* This is really a keypress. */
599 SetEvent (state->read_event);
600 break;
603 else if (record.EventType == MOUSE_EVENT)
605 SetEvent (state->read_event);
606 break;
609 /* Otherwise discard it and wait again. */
610 ReadConsoleInput (h, &record, 1, &n_records);
613 SetEvent(state->have_stopped);
615 return 0;
618 static int
619 fd_is_pipe (int fd)
621 if (PeekNamedPipe ((HANDLE) _get_osfhandle (fd), NULL, 0, NULL, NULL, NULL))
622 return 1;
623 else
624 return 0;
627 static int
628 fd_is_file (int fd)
630 if (GetFileType ((HANDLE) _get_osfhandle (fd)) == FILE_TYPE_DISK)
631 return 1;
632 else
633 return 0;
636 static DWORD WINAPI
637 pipe_select_thread (void *arg)
639 struct serial *scb = (struct serial *) arg;
640 struct ser_console_state *state;
641 HANDLE h;
643 state = (struct ser_console_state *) scb->state;
644 h = (HANDLE) _get_osfhandle (scb->fd);
646 while (1)
648 DWORD n_avail;
650 select_thread_wait (state);
652 /* Wait for something to happen on the pipe. */
653 while (1)
655 if (!PeekNamedPipe (h, NULL, 0, NULL, &n_avail, NULL))
657 SetEvent (state->except_event);
658 break;
661 if (n_avail > 0)
663 SetEvent (state->read_event);
664 break;
667 /* Delay 10ms before checking again, but allow the stop
668 event to wake us. */
669 if (WaitForSingleObject (state->stop_select, 10) == WAIT_OBJECT_0)
670 break;
673 SetEvent (state->have_stopped);
675 return 0;
678 static DWORD WINAPI
679 file_select_thread (void *arg)
681 struct serial *scb = (struct serial *) arg;
682 struct ser_console_state *state;
683 HANDLE h;
685 state = (struct ser_console_state *) scb->state;
686 h = (HANDLE) _get_osfhandle (scb->fd);
688 while (1)
690 select_thread_wait (state);
692 if (SetFilePointer (h, 0, NULL, FILE_CURRENT)
693 == INVALID_SET_FILE_POINTER)
694 SetEvent (state->except_event);
695 else
696 SetEvent (state->read_event);
698 SetEvent (state->have_stopped);
700 return 0;
703 static void
704 ser_console_wait_handle (struct serial *scb, HANDLE *read, HANDLE *except)
706 struct ser_console_state *state = (struct ser_console_state *) scb->state;
708 if (state == NULL)
710 thread_fn_type thread_fn;
711 int is_tty;
713 is_tty = isatty (scb->fd);
714 if (!is_tty && !fd_is_file (scb->fd) && !fd_is_pipe (scb->fd))
716 *read = NULL;
717 *except = NULL;
718 return;
721 state = XCNEW (struct ser_console_state);
722 scb->state = state;
724 if (is_tty)
725 thread_fn = console_select_thread;
726 else if (fd_is_pipe (scb->fd))
727 thread_fn = pipe_select_thread;
728 else
729 thread_fn = file_select_thread;
731 create_select_thread (thread_fn, scb, state);
734 *read = state->read_event;
735 *except = state->except_event;
737 /* Start from a blank state. */
738 ResetEvent (state->read_event);
739 ResetEvent (state->except_event);
740 ResetEvent (state->stop_select);
742 /* First check for a key already in the buffer. If there is one,
743 we don't need a thread. This also catches the second key of
744 multi-character returns from getch, for instance for arrow
745 keys. The second half is in a C library internal buffer,
746 and PeekConsoleInput will not find it. */
747 if (_kbhit ())
749 SetEvent (state->read_event);
750 return;
753 /* Otherwise, start the select thread. */
754 start_select_thread (state);
757 static void
758 ser_console_done_wait_handle (struct serial *scb)
760 struct ser_console_state *state = (struct ser_console_state *) scb->state;
762 if (state == NULL)
763 return;
765 stop_select_thread (state);
768 static void
769 ser_console_close (struct serial *scb)
771 struct ser_console_state *state = (struct ser_console_state *) scb->state;
773 if (scb->state)
775 destroy_select_thread (state);
776 xfree (scb->state);
780 struct ser_console_ttystate
782 int is_a_tty;
785 static serial_ttystate
786 ser_console_get_tty_state (struct serial *scb)
788 if (isatty (scb->fd))
790 struct ser_console_ttystate *state;
792 state = XNEW (struct ser_console_ttystate);
793 state->is_a_tty = 1;
794 return state;
796 else
797 return NULL;
800 struct pipe_state
802 /* Since we use the pipe_select_thread for our select emulation,
803 we need to place the state structure it requires at the front
804 of our state. */
805 struct ser_console_state wait;
807 /* The pex obj for our (one-stage) pipeline. */
808 struct pex_obj *pex;
810 /* Streams for the pipeline's input and output. */
811 FILE *input, *output;
814 static struct pipe_state *
815 make_pipe_state (void)
817 struct pipe_state *ps = XCNEW (struct pipe_state);
819 ps->wait.read_event = INVALID_HANDLE_VALUE;
820 ps->wait.except_event = INVALID_HANDLE_VALUE;
821 ps->wait.start_select = INVALID_HANDLE_VALUE;
822 ps->wait.stop_select = INVALID_HANDLE_VALUE;
824 return ps;
827 static void
828 free_pipe_state (struct pipe_state *ps)
830 int saved_errno = errno;
832 if (ps->wait.read_event != INVALID_HANDLE_VALUE)
833 destroy_select_thread (&ps->wait);
835 /* Close the pipe to the child. We must close the pipe before
836 calling pex_free because pex_free will wait for the child to exit
837 and the child will not exit until the pipe is closed. */
838 if (ps->input)
839 fclose (ps->input);
840 if (ps->pex)
842 pex_free (ps->pex);
843 /* pex_free closes ps->output. */
845 else if (ps->output)
846 fclose (ps->output);
848 xfree (ps);
850 errno = saved_errno;
853 struct pipe_state_destroyer
855 void operator() (pipe_state *ps) const
857 free_pipe_state (ps);
861 typedef std::unique_ptr<pipe_state, pipe_state_destroyer> pipe_state_up;
863 static int
864 pipe_windows_open (struct serial *scb, const char *name)
866 FILE *pex_stderr;
868 if (name == NULL)
869 error_no_arg (_("child command"));
871 gdb_argv argv (name);
873 if (! argv[0] || argv[0][0] == '\0')
874 error (_("missing child command"));
876 pipe_state_up ps (make_pipe_state ());
878 ps->pex = pex_init (PEX_USE_PIPES, "target remote pipe", NULL);
879 if (! ps->pex)
880 return -1;
881 ps->input = pex_input_pipe (ps->pex, 1);
882 if (! ps->input)
883 return -1;
886 int err;
887 const char *err_msg
888 = pex_run (ps->pex, PEX_SEARCH | PEX_BINARY_INPUT | PEX_BINARY_OUTPUT
889 | PEX_STDERR_TO_PIPE,
890 argv[0], argv.get (), NULL, NULL,
891 &err);
893 if (err_msg)
895 /* Our caller expects us to return -1, but all they'll do with
896 it generally is print the message based on errno. We have
897 all the same information here, plus err_msg provided by
898 pex_run, so we just raise the error here. */
899 if (err)
900 error (_("error starting child process '%s': %s: %s"),
901 name, err_msg, safe_strerror (err));
902 else
903 error (_("error starting child process '%s': %s"),
904 name, err_msg);
908 ps->output = pex_read_output (ps->pex, 1);
909 if (! ps->output)
910 return -1;
911 scb->fd = fileno (ps->output);
913 pex_stderr = pex_read_err (ps->pex, 1);
914 if (! pex_stderr)
915 return -1;
916 scb->error_fd = fileno (pex_stderr);
918 scb->state = ps.release ();
920 return 0;
923 static int
924 pipe_windows_fdopen (struct serial *scb, int fd)
926 struct pipe_state *ps;
928 ps = make_pipe_state ();
930 ps->input = fdopen (fd, "r+");
931 if (! ps->input)
932 goto fail;
934 ps->output = fdopen (fd, "r+");
935 if (! ps->output)
936 goto fail;
938 scb->fd = fd;
939 scb->state = (void *) ps;
941 return 0;
943 fail:
944 free_pipe_state (ps);
945 return -1;
948 static void
949 pipe_windows_close (struct serial *scb)
951 struct pipe_state *ps = (struct pipe_state *) scb->state;
953 /* In theory, we should try to kill the subprocess here, but the pex
954 interface doesn't give us enough information to do that. Usually
955 closing the input pipe will get the message across. */
957 free_pipe_state (ps);
961 static int
962 pipe_windows_read (struct serial *scb, size_t count)
964 HANDLE pipeline_out = (HANDLE) _get_osfhandle (scb->fd);
965 DWORD available;
966 DWORD bytes_read;
968 if (pipeline_out == INVALID_HANDLE_VALUE)
969 return -1;
971 if (! PeekNamedPipe (pipeline_out, NULL, 0, NULL, &available, NULL))
972 return -1;
974 if (count > available)
975 count = available;
977 if (! ReadFile (pipeline_out, scb->buf, count, &bytes_read, NULL))
978 return -1;
980 return bytes_read;
984 static int
985 pipe_windows_write (struct serial *scb, const void *buf, size_t count)
987 struct pipe_state *ps = (struct pipe_state *) scb->state;
988 HANDLE pipeline_in;
989 DWORD written;
991 int pipeline_in_fd = fileno (ps->input);
992 if (pipeline_in_fd < 0)
993 return -1;
995 pipeline_in = (HANDLE) _get_osfhandle (pipeline_in_fd);
996 if (pipeline_in == INVALID_HANDLE_VALUE)
997 return -1;
999 if (! WriteFile (pipeline_in, buf, count, &written, NULL))
1000 return -1;
1002 return written;
1006 static void
1007 pipe_wait_handle (struct serial *scb, HANDLE *read, HANDLE *except)
1009 struct pipe_state *ps = (struct pipe_state *) scb->state;
1011 /* Have we allocated our events yet? */
1012 if (ps->wait.read_event == INVALID_HANDLE_VALUE)
1013 /* Start the thread. */
1014 create_select_thread (pipe_select_thread, scb, &ps->wait);
1016 *read = ps->wait.read_event;
1017 *except = ps->wait.except_event;
1019 /* Start from a blank state. */
1020 ResetEvent (ps->wait.read_event);
1021 ResetEvent (ps->wait.except_event);
1022 ResetEvent (ps->wait.stop_select);
1024 start_select_thread (&ps->wait);
1027 static void
1028 pipe_done_wait_handle (struct serial *scb)
1030 struct pipe_state *ps = (struct pipe_state *) scb->state;
1032 /* Have we allocated our events yet? */
1033 if (ps->wait.read_event == INVALID_HANDLE_VALUE)
1034 return;
1036 stop_select_thread (&ps->wait);
1039 static int
1040 pipe_avail (struct serial *scb, int fd)
1042 HANDLE h = (HANDLE) _get_osfhandle (fd);
1043 DWORD numBytes;
1044 BOOL r = PeekNamedPipe (h, NULL, 0, NULL, &numBytes, NULL);
1046 if (r == FALSE)
1047 numBytes = 0;
1048 return numBytes;
1052 gdb_pipe (int pdes[2])
1054 if (_pipe (pdes, 512, _O_BINARY | _O_NOINHERIT) == -1)
1055 return -1;
1056 return 0;
1059 struct net_windows_state
1061 struct ser_console_state base;
1063 HANDLE sock_event;
1066 /* Check whether the socket has any pending data to be read. If so,
1067 set the select thread's read event. On error, set the select
1068 thread's except event. If any event was set, return true,
1069 otherwise return false. */
1071 static int
1072 net_windows_socket_check_pending (struct serial *scb)
1074 struct net_windows_state *state = (struct net_windows_state *) scb->state;
1075 unsigned long available;
1077 if (ioctlsocket (scb->fd, FIONREAD, &available) != 0)
1079 /* The socket closed, or some other error. */
1080 SetEvent (state->base.except_event);
1081 return 1;
1083 else if (available > 0)
1085 SetEvent (state->base.read_event);
1086 return 1;
1089 return 0;
1092 static DWORD WINAPI
1093 net_windows_select_thread (void *arg)
1095 struct serial *scb = (struct serial *) arg;
1096 struct net_windows_state *state;
1097 int event_index;
1099 state = (struct net_windows_state *) scb->state;
1101 while (1)
1103 HANDLE wait_events[2];
1104 WSANETWORKEVENTS events;
1106 select_thread_wait (&state->base);
1108 wait_events[0] = state->base.stop_select;
1109 wait_events[1] = state->sock_event;
1111 /* Wait for something to happen on the socket. */
1112 while (1)
1114 event_index = WaitForMultipleObjects (2, wait_events, FALSE, INFINITE);
1116 if (event_index == WAIT_OBJECT_0
1117 || WaitForSingleObject (state->base.stop_select, 0) == WAIT_OBJECT_0)
1119 /* We have been requested to stop. */
1120 break;
1123 if (event_index != WAIT_OBJECT_0 + 1)
1125 /* Some error has occured. Assume that this is an error
1126 condition. */
1127 SetEvent (state->base.except_event);
1128 break;
1131 /* Enumerate the internal network events, and reset the
1132 object that signalled us to catch the next event. */
1133 if (WSAEnumNetworkEvents (scb->fd, state->sock_event, &events) != 0)
1135 /* Something went wrong. Maybe the socket is gone. */
1136 SetEvent (state->base.except_event);
1137 break;
1140 if (events.lNetworkEvents & FD_READ)
1142 if (net_windows_socket_check_pending (scb))
1143 break;
1145 /* Spurious wakeup. That is, the socket's event was
1146 signalled before we last called recv. */
1149 if (events.lNetworkEvents & FD_CLOSE)
1151 SetEvent (state->base.except_event);
1152 break;
1156 SetEvent (state->base.have_stopped);
1158 return 0;
1161 static void
1162 net_windows_wait_handle (struct serial *scb, HANDLE *read, HANDLE *except)
1164 struct net_windows_state *state = (struct net_windows_state *) scb->state;
1166 /* Start from a clean slate. */
1167 ResetEvent (state->base.read_event);
1168 ResetEvent (state->base.except_event);
1169 ResetEvent (state->base.stop_select);
1171 *read = state->base.read_event;
1172 *except = state->base.except_event;
1174 /* Check any pending events. Otherwise, start the select
1175 thread. */
1176 if (!net_windows_socket_check_pending (scb))
1177 start_select_thread (&state->base);
1180 static void
1181 net_windows_done_wait_handle (struct serial *scb)
1183 struct net_windows_state *state = (struct net_windows_state *) scb->state;
1185 stop_select_thread (&state->base);
1188 static int
1189 net_windows_open (struct serial *scb, const char *name)
1191 struct net_windows_state *state;
1192 int ret;
1194 ret = net_open (scb, name);
1195 if (ret != 0)
1196 return ret;
1198 state = XCNEW (struct net_windows_state);
1199 scb->state = state;
1201 /* Associate an event with the socket. */
1202 state->sock_event = CreateEvent (0, TRUE, FALSE, 0);
1203 WSAEventSelect (scb->fd, state->sock_event, FD_READ | FD_CLOSE);
1205 /* Start the thread. */
1206 create_select_thread (net_windows_select_thread, scb, &state->base);
1208 return 0;
1212 static void
1213 net_windows_close (struct serial *scb)
1215 struct net_windows_state *state = (struct net_windows_state *) scb->state;
1217 destroy_select_thread (&state->base);
1218 CloseHandle (state->sock_event);
1220 xfree (scb->state);
1222 net_close (scb);
1225 /* The serial port driver. */
1227 static const struct serial_ops hardwire_ops =
1229 "hardwire",
1230 ser_windows_open,
1231 ser_windows_close,
1232 NULL,
1233 ser_base_readchar,
1234 ser_base_write,
1235 ser_windows_flush_output,
1236 ser_windows_flush_input,
1237 ser_windows_send_break,
1238 ser_windows_raw,
1239 /* These are only used for stdin; we do not need them for serial
1240 ports, so supply the standard dummies. */
1241 ser_base_get_tty_state,
1242 ser_base_copy_tty_state,
1243 ser_base_set_tty_state,
1244 ser_base_print_tty_state,
1245 ser_windows_setbaudrate,
1246 ser_windows_setstopbits,
1247 ser_windows_setparity,
1248 ser_windows_drain_output,
1249 ser_base_async,
1250 ser_windows_read_prim,
1251 ser_windows_write_prim,
1252 NULL,
1253 ser_windows_wait_handle
1256 /* The dummy serial driver used for terminals. We only provide the
1257 TTY-related methods. */
1259 static const struct serial_ops tty_ops =
1261 "terminal",
1262 NULL,
1263 ser_console_close,
1264 NULL,
1265 NULL,
1266 NULL,
1267 NULL,
1268 NULL,
1269 NULL,
1270 NULL,
1271 ser_console_get_tty_state,
1272 ser_base_copy_tty_state,
1273 ser_base_set_tty_state,
1274 ser_base_print_tty_state,
1275 NULL,
1276 NULL,
1277 NULL,
1278 ser_base_drain_output,
1279 NULL,
1280 NULL,
1281 NULL,
1282 NULL,
1283 ser_console_wait_handle,
1284 ser_console_done_wait_handle
1287 /* The pipe interface. */
1289 static const struct serial_ops pipe_ops =
1291 "pipe",
1292 pipe_windows_open,
1293 pipe_windows_close,
1294 pipe_windows_fdopen,
1295 ser_base_readchar,
1296 ser_base_write,
1297 ser_base_flush_output,
1298 ser_base_flush_input,
1299 ser_base_send_break,
1300 ser_base_raw,
1301 ser_base_get_tty_state,
1302 ser_base_copy_tty_state,
1303 ser_base_set_tty_state,
1304 ser_base_print_tty_state,
1305 ser_base_setbaudrate,
1306 ser_base_setstopbits,
1307 ser_base_setparity,
1308 ser_base_drain_output,
1309 ser_base_async,
1310 pipe_windows_read,
1311 pipe_windows_write,
1312 pipe_avail,
1313 pipe_wait_handle,
1314 pipe_done_wait_handle
1317 /* The TCP/UDP socket driver. */
1319 static const struct serial_ops tcp_ops =
1321 "tcp",
1322 net_windows_open,
1323 net_windows_close,
1324 NULL,
1325 ser_base_readchar,
1326 ser_base_write,
1327 ser_base_flush_output,
1328 ser_base_flush_input,
1329 ser_tcp_send_break,
1330 ser_base_raw,
1331 ser_base_get_tty_state,
1332 ser_base_copy_tty_state,
1333 ser_base_set_tty_state,
1334 ser_base_print_tty_state,
1335 ser_base_setbaudrate,
1336 ser_base_setstopbits,
1337 ser_base_setparity,
1338 ser_base_drain_output,
1339 ser_base_async,
1340 net_read_prim,
1341 net_write_prim,
1342 NULL,
1343 net_windows_wait_handle,
1344 net_windows_done_wait_handle
1347 void _initialize_ser_windows ();
1348 void
1349 _initialize_ser_windows ()
1351 WSADATA wsa_data;
1353 HMODULE hm = NULL;
1355 /* First find out if kernel32 exports CancelIo function. */
1356 hm = LoadLibrary ("kernel32.dll");
1357 if (hm)
1359 CancelIo = (CancelIo_ftype *) GetProcAddress (hm, "CancelIo");
1360 FreeLibrary (hm);
1362 else
1363 CancelIo = NULL;
1365 serial_add_interface (&hardwire_ops);
1366 serial_add_interface (&tty_ops);
1367 serial_add_interface (&pipe_ops);
1369 /* If WinSock works, register the TCP/UDP socket driver. */
1371 if (WSAStartup (MAKEWORD (1, 0), &wsa_data) != 0)
1372 /* WinSock is unavailable. */
1373 return;
1375 serial_add_interface (&tcp_ops);