1 /* Target-vector operations for controlling windows child processes, for GDB.
3 Copyright (C) 1995-2020 Free Software Foundation, Inc.
5 Contributed by Cygnus Solutions, A Red Hat Company.
7 This file is part of GDB.
9 This program is free software; you can redistribute it and/or modify
10 it under the terms of the GNU General Public License as published by
11 the Free Software Foundation; either version 3 of the License, or
12 (at your option) any later version.
14 This program is distributed in the hope that it will be useful,
15 but WITHOUT ANY WARRANTY; without even the implied warranty of
16 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 GNU General Public License for more details.
19 You should have received a copy of the GNU General Public License
20 along with this program. If not, see <http://www.gnu.org/licenses/>. */
22 /* Originally by Steve Chamberlain, sac@cygnus.com */
25 #include "frame.h" /* required by inferior.h */
31 #include "completer.h"
35 #include <sys/types.h>
42 #include <sys/cygwin.h>
43 #include <cygwin/version.h>
47 #include "filenames.h"
51 #include "gdb_obstack.h"
52 #include "gdbthread.h"
58 #include "xml-support.h"
61 #include "i386-tdep.h"
62 #include "i387-tdep.h"
64 #include "windows-tdep.h"
65 #include "windows-nat.h"
67 #include "complaints.h"
68 #include "inf-child.h"
69 #include "gdbsupport/gdb_tilde_expand.h"
70 #include "gdbsupport/pathstuff.h"
72 #define AdjustTokenPrivileges dyn_AdjustTokenPrivileges
73 #define DebugActiveProcessStop dyn_DebugActiveProcessStop
74 #define DebugBreakProcess dyn_DebugBreakProcess
75 #define DebugSetProcessKillOnExit dyn_DebugSetProcessKillOnExit
76 #define EnumProcessModules dyn_EnumProcessModules
77 #define GetModuleInformation dyn_GetModuleInformation
78 #define LookupPrivilegeValueA dyn_LookupPrivilegeValueA
79 #define OpenProcessToken dyn_OpenProcessToken
80 #define GetConsoleFontSize dyn_GetConsoleFontSize
81 #define GetCurrentConsoleFont dyn_GetCurrentConsoleFont
83 typedef BOOL
WINAPI (AdjustTokenPrivileges_ftype
) (HANDLE
, BOOL
,
85 DWORD
, PTOKEN_PRIVILEGES
,
87 static AdjustTokenPrivileges_ftype
*AdjustTokenPrivileges
;
89 typedef BOOL
WINAPI (DebugActiveProcessStop_ftype
) (DWORD
);
90 static DebugActiveProcessStop_ftype
*DebugActiveProcessStop
;
92 typedef BOOL
WINAPI (DebugBreakProcess_ftype
) (HANDLE
);
93 static DebugBreakProcess_ftype
*DebugBreakProcess
;
95 typedef BOOL
WINAPI (DebugSetProcessKillOnExit_ftype
) (BOOL
);
96 static DebugSetProcessKillOnExit_ftype
*DebugSetProcessKillOnExit
;
98 typedef BOOL
WINAPI (EnumProcessModules_ftype
) (HANDLE
, HMODULE
*, DWORD
,
100 static EnumProcessModules_ftype
*EnumProcessModules
;
102 typedef BOOL
WINAPI (GetModuleInformation_ftype
) (HANDLE
, HMODULE
,
103 LPMODULEINFO
, DWORD
);
104 static GetModuleInformation_ftype
*GetModuleInformation
;
106 typedef BOOL
WINAPI (LookupPrivilegeValueA_ftype
) (LPCSTR
, LPCSTR
, PLUID
);
107 static LookupPrivilegeValueA_ftype
*LookupPrivilegeValueA
;
109 typedef BOOL
WINAPI (OpenProcessToken_ftype
) (HANDLE
, DWORD
, PHANDLE
);
110 static OpenProcessToken_ftype
*OpenProcessToken
;
112 typedef BOOL
WINAPI (GetCurrentConsoleFont_ftype
) (HANDLE
, BOOL
,
113 CONSOLE_FONT_INFO
*);
114 static GetCurrentConsoleFont_ftype
*GetCurrentConsoleFont
;
116 typedef COORD
WINAPI (GetConsoleFontSize_ftype
) (HANDLE
, DWORD
);
117 static GetConsoleFontSize_ftype
*GetConsoleFontSize
;
121 #undef GetModuleFileNameEx
124 # define __PMAX (MAX_PATH + 1)
125 typedef DWORD
WINAPI (GetModuleFileNameEx_ftype
) (HANDLE
, HMODULE
, LPSTR
, DWORD
);
126 static GetModuleFileNameEx_ftype
*GetModuleFileNameEx
;
127 # define STARTUPINFO STARTUPINFOA
128 # define CreateProcess CreateProcessA
129 # define GetModuleFileNameEx_name "GetModuleFileNameExA"
130 # define bad_GetModuleFileNameEx bad_GetModuleFileNameExA
132 # define __PMAX PATH_MAX
133 /* The starting and ending address of the cygwin1.dll text segment. */
134 static CORE_ADDR cygwin_load_start
;
135 static CORE_ADDR cygwin_load_end
;
137 typedef wchar_t cygwin_buf_t
;
138 typedef DWORD
WINAPI (GetModuleFileNameEx_ftype
) (HANDLE
, HMODULE
,
140 static GetModuleFileNameEx_ftype
*GetModuleFileNameEx
;
141 # define STARTUPINFO STARTUPINFOW
142 # define CreateProcess CreateProcessW
143 # define GetModuleFileNameEx_name "GetModuleFileNameExW"
144 # define bad_GetModuleFileNameEx bad_GetModuleFileNameExW
147 static int have_saved_context
; /* True if we've saved context from a
150 static CONTEXT saved_context
; /* Contains the saved context from a
154 /* If we're not using the old Cygwin header file set, define the
155 following which never should have been in the generic Win32 API
156 headers in the first place since they were our own invention... */
157 #ifndef _GNU_H_WINDOWS_H
160 FLAG_TRACE_BIT
= 0x100,
164 #ifndef CONTEXT_EXTENDED_REGISTERS
165 /* This macro is only defined on ia32. It only makes sense on this target,
166 so define it as zero if not already defined. */
167 #define CONTEXT_EXTENDED_REGISTERS 0
170 #define CONTEXT_DEBUGGER_DR CONTEXT_FULL | CONTEXT_FLOATING_POINT \
171 | CONTEXT_SEGMENTS | CONTEXT_DEBUG_REGISTERS \
172 | CONTEXT_EXTENDED_REGISTERS
174 static uintptr_t dr
[8];
175 static int debug_registers_changed
;
176 static int debug_registers_used
;
178 static int windows_initialization_done
;
179 #define DR6_CLEAR_VALUE 0xffff0ff0
181 /* The exception thrown by a program to tell the debugger the name of
182 a thread. The exception record contains an ID of a thread and a
183 name to give it. This exception has no documented name, but MSDN
184 dubs it "MS_VC_EXCEPTION" in one code example. */
185 #define MS_VC_EXCEPTION 0x406d1388
189 HANDLE_EXCEPTION_UNHANDLED
= 0,
190 HANDLE_EXCEPTION_HANDLED
,
191 HANDLE_EXCEPTION_IGNORED
192 } handle_exception_result
;
194 /* The string sent by cygwin when it processes a signal.
195 FIXME: This should be in a cygwin include file. */
196 #ifndef _CYGWIN_SIGNAL_STRING
197 #define _CYGWIN_SIGNAL_STRING "cYgSiGw00f"
200 #define CHECK(x) check (x, __FILE__,__LINE__)
201 #define DEBUG_EXEC(x) if (debug_exec) printf_unfiltered x
202 #define DEBUG_EVENTS(x) if (debug_events) printf_unfiltered x
203 #define DEBUG_MEM(x) if (debug_memory) printf_unfiltered x
204 #define DEBUG_EXCEPT(x) if (debug_exceptions) printf_unfiltered x
206 static void cygwin_set_dr (int i
, CORE_ADDR addr
);
207 static void cygwin_set_dr7 (unsigned long val
);
208 static CORE_ADDR
cygwin_get_dr (int i
);
209 static unsigned long cygwin_get_dr6 (void);
210 static unsigned long cygwin_get_dr7 (void);
212 static enum gdb_signal last_sig
= GDB_SIGNAL_0
;
213 /* Set if a signal was received from the debugged process. */
215 /* Thread information structure used to track information that is
216 not available in gdb's thread structure. */
217 typedef struct windows_thread_info_struct
219 struct windows_thread_info_struct
*next
;
222 CORE_ADDR thread_local_base
;
230 static windows_thread_info thread_head
;
232 /* The process and thread handles for the above context. */
234 static DEBUG_EVENT current_event
; /* The current debug event from
236 static HANDLE current_process_handle
; /* Currently executing process */
237 static windows_thread_info
*current_thread
; /* Info on currently selected thread */
239 /* Counts of things. */
240 static int exception_count
= 0;
241 static int event_count
= 0;
242 static int saw_create
;
243 static int open_process_used
= 0;
246 static bool new_console
= false;
248 static bool cygwin_exceptions
= false;
250 static bool new_group
= true;
251 static bool debug_exec
= false; /* show execution */
252 static bool debug_events
= false; /* show events from kernel */
253 static bool debug_memory
= false; /* show target memory accesses */
254 static bool debug_exceptions
= false; /* show target exceptions */
255 static bool useshell
= false; /* use shell for subprocesses */
257 /* This vector maps GDB's idea of a register's number into an offset
258 in the windows exception context vector.
260 It also contains the bit mask needed to load the register in question.
262 The contents of this table can only be computed by the units
263 that provide CPU-specific support for Windows native debugging.
264 These units should set the table by calling
265 windows_set_context_register_offsets.
267 One day we could read a reg, we could inspect the context we
268 already have loaded, if it doesn't have the bit set that we need,
269 we read that set of registers in using GetThreadContext. If the
270 context already contains what we need, we just unpack it. Then to
271 write a register, first we have to ensure that the context contains
272 the other regs of the group, and then we copy the info in and set
275 static const int *mappings
;
277 /* The function to use in order to determine whether a register is
278 a segment register or not. */
279 static segment_register_p_ftype
*segment_register_p
;
281 /* See windows_nat_target::resume to understand why this is commented
284 /* This vector maps the target's idea of an exception (extracted
285 from the DEBUG_EVENT structure) to GDB's idea. */
287 struct xlate_exception
293 static const struct xlate_exception xlate
[] =
295 {EXCEPTION_ACCESS_VIOLATION
, GDB_SIGNAL_SEGV
},
296 {STATUS_STACK_OVERFLOW
, GDB_SIGNAL_SEGV
},
297 {EXCEPTION_BREAKPOINT
, GDB_SIGNAL_TRAP
},
298 {DBG_CONTROL_C
, GDB_SIGNAL_INT
},
299 {EXCEPTION_SINGLE_STEP
, GDB_SIGNAL_TRAP
},
300 {STATUS_FLOAT_DIVIDE_BY_ZERO
, GDB_SIGNAL_FPE
}
305 struct windows_nat_target final
: public x86_nat_target
<inf_child_target
>
307 void close () override
;
309 void attach (const char *, int) override
;
311 bool attach_no_wait () override
314 void detach (inferior
*, int) override
;
316 void resume (ptid_t
, int , enum gdb_signal
) override
;
318 ptid_t
wait (ptid_t
, struct target_waitstatus
*, int) override
;
320 void fetch_registers (struct regcache
*, int) override
;
321 void store_registers (struct regcache
*, int) override
;
323 enum target_xfer_status
xfer_partial (enum target_object object
,
326 const gdb_byte
*writebuf
,
327 ULONGEST offset
, ULONGEST len
,
328 ULONGEST
*xfered_len
) override
;
330 void files_info () override
;
332 void kill () override
;
334 void create_inferior (const char *, const std::string
&,
335 char **, int) override
;
337 void mourn_inferior () override
;
339 bool thread_alive (ptid_t ptid
) override
;
341 std::string
pid_to_str (ptid_t
) override
;
343 void interrupt () override
;
345 char *pid_to_exec_file (int pid
) override
;
347 ptid_t
get_ada_task_ptid (long lwp
, long thread
) override
;
349 bool get_tib_address (ptid_t ptid
, CORE_ADDR
*addr
) override
;
351 const char *thread_name (struct thread_info
*) override
;
354 static windows_nat_target the_windows_nat_target
;
356 /* Set the MAPPINGS static global to OFFSETS.
357 See the description of MAPPINGS for more details. */
360 windows_set_context_register_offsets (const int *offsets
)
365 /* See windows-nat.h. */
368 windows_set_segment_register_p (segment_register_p_ftype
*fun
)
370 segment_register_p
= fun
;
374 check (BOOL ok
, const char *file
, int line
)
377 printf_filtered ("error return %s:%d was %u\n", file
, line
,
378 (unsigned) GetLastError ());
381 /* Find a thread record given a thread id. If GET_CONTEXT is not 0,
382 then also retrieve the context for this thread. If GET_CONTEXT is
383 negative, then don't suspend the thread. */
384 static windows_thread_info
*
385 thread_rec (DWORD id
, int get_context
)
387 windows_thread_info
*th
;
389 for (th
= &thread_head
; (th
= th
->next
) != NULL
;)
392 if (!th
->suspended
&& get_context
)
394 if (get_context
> 0 && id
!= current_event
.dwThreadId
)
396 if (SuspendThread (th
->h
) == (DWORD
) -1)
398 DWORD err
= GetLastError ();
400 /* We get Access Denied (5) when trying to suspend
401 threads that Windows started on behalf of the
402 debuggee, usually when those threads are just
404 We can get Invalid Handle (6) if the main thread
406 if (err
!= ERROR_INVALID_HANDLE
407 && err
!= ERROR_ACCESS_DENIED
)
408 warning (_("SuspendThread (tid=0x%x) failed."
410 (unsigned) id
, (unsigned) err
);
416 else if (get_context
< 0)
418 th
->reload_context
= 1;
426 /* Add a thread to the thread list.
428 PTID is the ptid of the thread to be added.
429 H is its Windows handle.
430 TLB is its thread local base.
431 MAIN_THREAD_P should be true if the thread to be added is
432 the main thread, false otherwise. */
434 static windows_thread_info
*
435 windows_add_thread (ptid_t ptid
, HANDLE h
, void *tlb
, bool main_thread_p
)
437 windows_thread_info
*th
;
440 gdb_assert (ptid
.tid () != 0);
444 if ((th
= thread_rec (id
, FALSE
)))
447 th
= XCNEW (windows_thread_info
);
450 th
->thread_local_base
= (CORE_ADDR
) (uintptr_t) tlb
;
451 th
->next
= thread_head
.next
;
452 thread_head
.next
= th
;
454 /* Add this new thread to the list of threads.
456 To be consistent with what's done on other platforms, we add
457 the main thread silently (in reality, this thread is really
458 more of a process to the user than a thread). */
460 add_thread_silent (ptid
);
464 /* Set the debug registers for the new thread if they are used. */
465 if (debug_registers_used
)
467 /* Only change the value of the debug registers. */
468 th
->context
.ContextFlags
= CONTEXT_DEBUG_REGISTERS
;
469 CHECK (GetThreadContext (th
->h
, &th
->context
));
470 th
->context
.Dr0
= dr
[0];
471 th
->context
.Dr1
= dr
[1];
472 th
->context
.Dr2
= dr
[2];
473 th
->context
.Dr3
= dr
[3];
474 th
->context
.Dr6
= DR6_CLEAR_VALUE
;
475 th
->context
.Dr7
= dr
[7];
476 CHECK (SetThreadContext (th
->h
, &th
->context
));
477 th
->context
.ContextFlags
= 0;
482 /* Clear out any old thread list and reinitialize it to a
485 windows_init_thread_list (void)
487 windows_thread_info
*th
= &thread_head
;
489 DEBUG_EVENTS (("gdb: windows_init_thread_list\n"));
491 while (th
->next
!= NULL
)
493 windows_thread_info
*here
= th
->next
;
494 th
->next
= here
->next
;
497 thread_head
.next
= NULL
;
500 /* Delete a thread from the list of threads.
502 PTID is the ptid of the thread to be deleted.
503 EXIT_CODE is the thread's exit code.
504 MAIN_THREAD_P should be true if the thread to be deleted is
505 the main thread, false otherwise. */
508 windows_delete_thread (ptid_t ptid
, DWORD exit_code
, bool main_thread_p
)
510 windows_thread_info
*th
;
513 gdb_assert (ptid
.tid () != 0);
517 /* Emit a notification about the thread being deleted.
519 Note that no notification was printed when the main thread
520 was created, and thus, unless in verbose mode, we should be
521 symmetrical, and avoid that notification for the main thread
525 printf_unfiltered ("[Deleting %s]\n", target_pid_to_str (ptid
).c_str ());
526 else if (print_thread_events
&& !main_thread_p
)
527 printf_unfiltered (_("[%s exited with code %u]\n"),
528 target_pid_to_str (ptid
).c_str (),
529 (unsigned) exit_code
);
531 delete_thread (find_thread_ptid (ptid
));
533 for (th
= &thread_head
;
534 th
->next
!= NULL
&& th
->next
->id
!= id
;
538 if (th
->next
!= NULL
)
540 windows_thread_info
*here
= th
->next
;
541 th
->next
= here
->next
;
547 /* Fetches register number R from the given windows_thread_info,
548 and supplies its value to the given regcache.
550 This function assumes that R is non-negative. A failed assertion
551 is raised if that is not true.
553 This function assumes that TH->RELOAD_CONTEXT is not set, meaning
554 that the windows_thread_info has an up-to-date context. A failed
555 assertion is raised if that assumption is violated. */
558 windows_fetch_one_register (struct regcache
*regcache
,
559 windows_thread_info
*th
, int r
)
562 gdb_assert (!th
->reload_context
);
564 char *context_offset
= ((char *) &th
->context
) + mappings
[r
];
565 struct gdbarch
*gdbarch
= regcache
->arch ();
566 struct gdbarch_tdep
*tdep
= gdbarch_tdep (gdbarch
);
568 if (r
== I387_FISEG_REGNUM (tdep
))
570 long l
= *((long *) context_offset
) & 0xffff;
571 regcache
->raw_supply (r
, (char *) &l
);
573 else if (r
== I387_FOP_REGNUM (tdep
))
575 long l
= (*((long *) context_offset
) >> 16) & ((1 << 11) - 1);
576 regcache
->raw_supply (r
, (char *) &l
);
578 else if (segment_register_p (r
))
580 /* GDB treats segment registers as 32bit registers, but they are
581 in fact only 16 bits long. Make sure we do not read extra
582 bits from our source buffer. */
583 long l
= *((long *) context_offset
) & 0xffff;
584 regcache
->raw_supply (r
, (char *) &l
);
587 regcache
->raw_supply (r
, context_offset
);
591 windows_nat_target::fetch_registers (struct regcache
*regcache
, int r
)
593 DWORD tid
= regcache
->ptid ().tid ();
594 windows_thread_info
*th
= thread_rec (tid
, TRUE
);
596 /* Check if TH exists. Windows sometimes uses a non-existent
597 thread id in its events. */
601 if (th
->reload_context
)
604 if (have_saved_context
)
606 /* Lie about where the program actually is stopped since
607 cygwin has informed us that we should consider the signal
608 to have occurred at another location which is stored in
610 memcpy (&th
->context
, &saved_context
,
611 __COPY_CONTEXT_SIZE
);
612 have_saved_context
= 0;
617 th
->context
.ContextFlags
= CONTEXT_DEBUGGER_DR
;
618 CHECK (GetThreadContext (th
->h
, &th
->context
));
619 /* Copy dr values from that thread.
620 But only if there were not modified since last stop.
622 if (!debug_registers_changed
)
624 dr
[0] = th
->context
.Dr0
;
625 dr
[1] = th
->context
.Dr1
;
626 dr
[2] = th
->context
.Dr2
;
627 dr
[3] = th
->context
.Dr3
;
628 dr
[6] = th
->context
.Dr6
;
629 dr
[7] = th
->context
.Dr7
;
632 th
->reload_context
= 0;
636 for (r
= 0; r
< gdbarch_num_regs (regcache
->arch()); r
++)
637 windows_fetch_one_register (regcache
, th
, r
);
639 windows_fetch_one_register (regcache
, th
, r
);
642 /* Collect the register number R from the given regcache, and store
643 its value into the corresponding area of the given thread's context.
645 This function assumes that R is non-negative. A failed assertion
646 assertion is raised if that is not true. */
649 windows_store_one_register (const struct regcache
*regcache
,
650 windows_thread_info
*th
, int r
)
654 regcache
->raw_collect (r
, ((char *) &th
->context
) + mappings
[r
]);
657 /* Store a new register value into the context of the thread tied to
661 windows_nat_target::store_registers (struct regcache
*regcache
, int r
)
663 DWORD tid
= regcache
->ptid ().tid ();
664 windows_thread_info
*th
= thread_rec (tid
, TRUE
);
666 /* Check if TH exists. Windows sometimes uses a non-existent
667 thread id in its events. */
672 for (r
= 0; r
< gdbarch_num_regs (regcache
->arch ()); r
++)
673 windows_store_one_register (regcache
, th
, r
);
675 windows_store_one_register (regcache
, th
, r
);
678 /* Maintain a linked list of "so" information. */
679 struct lm_info_windows
: public lm_info_base
681 LPVOID load_addr
= 0;
684 static struct so_list solib_start
, *solib_end
;
686 static struct so_list
*
687 windows_make_so (const char *name
, LPVOID load_addr
)
694 WIN32_FIND_DATA w32_fd
;
695 HANDLE h
= FindFirstFile(name
, &w32_fd
);
697 if (h
== INVALID_HANDLE_VALUE
)
703 if (GetCurrentDirectory (MAX_PATH
+ 1, cwd
))
705 p
= strrchr (buf
, '\\');
708 SetCurrentDirectory (buf
);
709 GetFullPathName (w32_fd
.cFileName
, MAX_PATH
, buf
, &p
);
710 SetCurrentDirectory (cwd
);
713 if (strcasecmp (buf
, "ntdll.dll") == 0)
715 GetSystemDirectory (buf
, sizeof (buf
));
716 strcat (buf
, "\\ntdll.dll");
719 cygwin_buf_t buf
[__PMAX
];
722 if (access (name
, F_OK
) != 0)
724 if (strcasecmp (name
, "ntdll.dll") == 0)
727 GetSystemDirectoryW (buf
, sizeof (buf
) / sizeof (wchar_t));
728 wcscat (buf
, L
"\\ntdll.dll");
732 GetSystemDirectoryA (buf
, sizeof (buf
) / sizeof (wchar_t));
733 strcat (buf
, "\\ntdll.dll");
738 so
= XCNEW (struct so_list
);
739 lm_info_windows
*li
= new lm_info_windows
;
741 li
->load_addr
= load_addr
;
742 strcpy (so
->so_original_name
, name
);
744 strcpy (so
->so_name
, buf
);
747 cygwin_conv_path (CCP_WIN_W_TO_POSIX
, buf
, so
->so_name
,
748 SO_NAME_MAX_PATH_SIZE
);
751 char *rname
= realpath (name
, NULL
);
752 if (rname
&& strlen (rname
) < SO_NAME_MAX_PATH_SIZE
)
754 strcpy (so
->so_name
, rname
);
758 error (_("dll path too long"));
760 /* Record cygwin1.dll .text start/end. */
761 p
= strchr (so
->so_name
, '\0') - (sizeof ("/cygwin1.dll") - 1);
762 if (p
>= so
->so_name
&& strcasecmp (p
, "/cygwin1.dll") == 0)
764 asection
*text
= NULL
;
766 gdb_bfd_ref_ptr
abfd (gdb_bfd_open (so
->so_name
, "pei-i386", -1));
771 if (bfd_check_format (abfd
.get (), bfd_object
))
772 text
= bfd_get_section_by_name (abfd
.get (), ".text");
777 /* The symbols in a dll are offset by 0x1000, which is the
778 offset from 0 of the first byte in an image - because of the
779 file header and the section alignment. */
780 cygwin_load_start
= (CORE_ADDR
) (uintptr_t) ((char *)
782 cygwin_load_end
= cygwin_load_start
+ bfd_section_size (text
);
790 get_image_name (HANDLE h
, void *address
, int unicode
)
793 static char buf
[__PMAX
];
795 static char buf
[(2 * __PMAX
) + 1];
797 DWORD size
= unicode
? sizeof (WCHAR
) : sizeof (char);
803 /* Attempt to read the name of the dll that was detected.
804 This is documented to work only when actively debugging
805 a program. It will not work for attached processes. */
809 /* See if we could read the address of a string, and that the
810 address isn't null. */
811 if (!ReadProcessMemory (h
, address
, &address_ptr
,
812 sizeof (address_ptr
), &done
)
813 || done
!= sizeof (address_ptr
) || !address_ptr
)
816 /* Find the length of the string. */
817 while (ReadProcessMemory (h
, address_ptr
+ len
++ * size
, &b
, size
, &done
)
818 && (b
[0] != 0 || b
[size
- 1] != 0) && done
== size
)
822 ReadProcessMemory (h
, address_ptr
, buf
, len
, &done
);
825 WCHAR
*unicode_address
= (WCHAR
*) alloca (len
* sizeof (WCHAR
));
826 ReadProcessMemory (h
, address_ptr
, unicode_address
, len
* sizeof (WCHAR
),
829 wcstombs (buf
, unicode_address
, __PMAX
);
831 WideCharToMultiByte (CP_ACP
, 0, unicode_address
, len
, buf
, sizeof buf
,
839 /* Handle a DLL load event, and return 1.
841 This function assumes that this event did not occur during inferior
842 initialization, where their event info may be incomplete (see
843 do_initial_windows_stuff and windows_add_all_dlls for more info
844 on how we handle DLL loading during that phase). */
849 LOAD_DLL_DEBUG_INFO
*event
= ¤t_event
.u
.LoadDll
;
852 /* Try getting the DLL name via the lpImageName field of the event.
853 Note that Microsoft documents this fields as strictly optional,
854 in the sense that it might be NULL. And the first DLL event in
855 particular is explicitly documented as "likely not pass[ed]"
856 (source: MSDN LOAD_DLL_DEBUG_INFO structure). */
857 dll_name
= get_image_name (current_process_handle
,
858 event
->lpImageName
, event
->fUnicode
);
862 solib_end
->next
= windows_make_so (dll_name
, event
->lpBaseOfDll
);
863 solib_end
= solib_end
->next
;
865 lm_info_windows
*li
= (lm_info_windows
*) solib_end
->lm_info
;
867 DEBUG_EVENTS (("gdb: Loading dll \"%s\" at %s.\n", solib_end
->so_name
,
868 host_address_to_string (li
->load_addr
)));
872 windows_free_so (struct so_list
*so
)
874 lm_info_windows
*li
= (lm_info_windows
*) so
->lm_info
;
880 /* Handle a DLL unload event.
881 Return 1 if successful, or zero otherwise.
883 This function assumes that this event did not occur during inferior
884 initialization, where their event info may be incomplete (see
885 do_initial_windows_stuff and windows_add_all_dlls for more info
886 on how we handle DLL loading during that phase). */
891 LPVOID lpBaseOfDll
= current_event
.u
.UnloadDll
.lpBaseOfDll
;
894 for (so
= &solib_start
; so
->next
!= NULL
; so
= so
->next
)
896 lm_info_windows
*li_next
= (lm_info_windows
*) so
->next
->lm_info
;
898 if (li_next
->load_addr
== lpBaseOfDll
)
900 struct so_list
*sodel
= so
->next
;
902 so
->next
= sodel
->next
;
905 DEBUG_EVENTS (("gdb: Unloading dll \"%s\".\n", sodel
->so_name
));
907 windows_free_so (sodel
);
912 /* We did not find any DLL that was previously loaded at this address,
913 so register a complaint. We do not report an error, because we have
914 observed that this may be happening under some circumstances. For
915 instance, running 32bit applications on x64 Windows causes us to receive
916 4 mysterious UNLOAD_DLL_DEBUG_EVENTs during the startup phase (these
917 events are apparently caused by the WOW layer, the interface between
918 32bit and 64bit worlds). */
919 complaint (_("dll starting at %s not found."),
920 host_address_to_string (lpBaseOfDll
));
923 /* Call FUNC wrapped in a TRY/CATCH that swallows all GDB
927 catch_errors (void (*func
) ())
933 catch (const gdb_exception
&ex
)
935 exception_print (gdb_stderr
, ex
);
939 /* Clear list of loaded DLLs. */
941 windows_clear_solib (void)
943 solib_start
.next
= NULL
;
944 solib_end
= &solib_start
;
948 signal_event_command (const char *args
, int from_tty
)
950 uintptr_t event_id
= 0;
951 char *endargs
= NULL
;
954 error (_("signal-event requires an argument (integer event id)"));
956 event_id
= strtoumax (args
, &endargs
, 10);
958 if ((errno
== ERANGE
) || (event_id
== 0) || (event_id
> UINTPTR_MAX
) ||
959 ((HANDLE
) event_id
== INVALID_HANDLE_VALUE
))
960 error (_("Failed to convert `%s' to event id"), args
);
962 SetEvent ((HANDLE
) event_id
);
963 CloseHandle ((HANDLE
) event_id
);
966 /* Handle DEBUG_STRING output from child process.
967 Cygwin prepends its messages with a "cygwin:". Interpret this as
968 a Cygwin signal. Otherwise just print the string as a warning. */
970 handle_output_debug_string (struct target_waitstatus
*ourstatus
)
972 gdb::unique_xmalloc_ptr
<char> s
;
975 if (!target_read_string
976 ((CORE_ADDR
) (uintptr_t) current_event
.u
.DebugString
.lpDebugStringData
,
978 || !s
|| !*(s
.get ()))
980 else if (!startswith (s
.get (), _CYGWIN_SIGNAL_STRING
))
983 if (!startswith (s
.get (), "cYg"))
986 char *p
= strchr (s
.get (), '\0');
988 if (p
> s
.get () && *--p
== '\n')
990 warning (("%s"), s
.get ());
996 /* Got a cygwin signal marker. A cygwin signal is followed by
997 the signal number itself and then optionally followed by the
998 thread id and address to saved context within the DLL. If
999 these are supplied, then the given thread is assumed to have
1000 issued the signal and the context from the thread is assumed
1001 to be stored at the given address in the inferior. Tell gdb
1002 to treat this like a real signal. */
1004 int sig
= strtol (s
.get () + sizeof (_CYGWIN_SIGNAL_STRING
) - 1, &p
, 0);
1005 gdb_signal gotasig
= gdb_signal_from_host (sig
);
1007 ourstatus
->value
.sig
= gotasig
;
1013 ourstatus
->kind
= TARGET_WAITKIND_STOPPED
;
1014 retval
= strtoul (p
, &p
, 0);
1016 retval
= current_event
.dwThreadId
;
1017 else if ((x
= (LPCVOID
) (uintptr_t) strtoull (p
, NULL
, 0))
1018 && ReadProcessMemory (current_process_handle
, x
,
1020 __COPY_CONTEXT_SIZE
, &n
)
1021 && n
== __COPY_CONTEXT_SIZE
)
1022 have_saved_context
= 1;
1031 display_selector (HANDLE thread
, DWORD sel
)
1034 if (GetThreadSelectorEntry (thread
, sel
, &info
))
1037 printf_filtered ("0x%03x: ", (unsigned) sel
);
1038 if (!info
.HighWord
.Bits
.Pres
)
1040 puts_filtered ("Segment not present\n");
1043 base
= (info
.HighWord
.Bits
.BaseHi
<< 24) +
1044 (info
.HighWord
.Bits
.BaseMid
<< 16)
1046 limit
= (info
.HighWord
.Bits
.LimitHi
<< 16) + info
.LimitLow
;
1047 if (info
.HighWord
.Bits
.Granularity
)
1048 limit
= (limit
<< 12) | 0xfff;
1049 printf_filtered ("base=0x%08x limit=0x%08x", base
, limit
);
1050 if (info
.HighWord
.Bits
.Default_Big
)
1051 puts_filtered(" 32-bit ");
1053 puts_filtered(" 16-bit ");
1054 switch ((info
.HighWord
.Bits
.Type
& 0xf) >> 1)
1057 puts_filtered ("Data (Read-Only, Exp-up");
1060 puts_filtered ("Data (Read/Write, Exp-up");
1063 puts_filtered ("Unused segment (");
1066 puts_filtered ("Data (Read/Write, Exp-down");
1069 puts_filtered ("Code (Exec-Only, N.Conf");
1072 puts_filtered ("Code (Exec/Read, N.Conf");
1075 puts_filtered ("Code (Exec-Only, Conf");
1078 puts_filtered ("Code (Exec/Read, Conf");
1081 printf_filtered ("Unknown type 0x%lx",
1082 (unsigned long) info
.HighWord
.Bits
.Type
);
1084 if ((info
.HighWord
.Bits
.Type
& 0x1) == 0)
1085 puts_filtered(", N.Acc");
1086 puts_filtered (")\n");
1087 if ((info
.HighWord
.Bits
.Type
& 0x10) == 0)
1088 puts_filtered("System selector ");
1089 printf_filtered ("Priviledge level = %ld. ",
1090 (unsigned long) info
.HighWord
.Bits
.Dpl
);
1091 if (info
.HighWord
.Bits
.Granularity
)
1092 puts_filtered ("Page granular.\n");
1094 puts_filtered ("Byte granular.\n");
1099 DWORD err
= GetLastError ();
1100 if (err
== ERROR_NOT_SUPPORTED
)
1101 printf_filtered ("Function not supported\n");
1103 printf_filtered ("Invalid selector 0x%x.\n", (unsigned) sel
);
1109 display_selectors (const char * args
, int from_tty
)
1111 if (!current_thread
)
1113 puts_filtered ("Impossible to display selectors now.\n");
1119 puts_filtered ("Selector $cs\n");
1120 display_selector (current_thread
->h
,
1121 current_thread
->context
.SegCs
);
1122 puts_filtered ("Selector $ds\n");
1123 display_selector (current_thread
->h
,
1124 current_thread
->context
.SegDs
);
1125 puts_filtered ("Selector $es\n");
1126 display_selector (current_thread
->h
,
1127 current_thread
->context
.SegEs
);
1128 puts_filtered ("Selector $ss\n");
1129 display_selector (current_thread
->h
,
1130 current_thread
->context
.SegSs
);
1131 puts_filtered ("Selector $fs\n");
1132 display_selector (current_thread
->h
,
1133 current_thread
->context
.SegFs
);
1134 puts_filtered ("Selector $gs\n");
1135 display_selector (current_thread
->h
,
1136 current_thread
->context
.SegGs
);
1141 sel
= parse_and_eval_long (args
);
1142 printf_filtered ("Selector \"%s\"\n",args
);
1143 display_selector (current_thread
->h
, sel
);
1147 #define DEBUG_EXCEPTION_SIMPLE(x) if (debug_exceptions) \
1148 printf_unfiltered ("gdb: Target exception %s at %s\n", x, \
1149 host_address_to_string (\
1150 current_event.u.Exception.ExceptionRecord.ExceptionAddress))
1152 static handle_exception_result
1153 handle_exception (struct target_waitstatus
*ourstatus
)
1155 EXCEPTION_RECORD
*rec
= ¤t_event
.u
.Exception
.ExceptionRecord
;
1156 DWORD code
= rec
->ExceptionCode
;
1157 handle_exception_result result
= HANDLE_EXCEPTION_HANDLED
;
1159 ourstatus
->kind
= TARGET_WAITKIND_STOPPED
;
1161 /* Record the context of the current thread. */
1162 thread_rec (current_event
.dwThreadId
, -1);
1166 case EXCEPTION_ACCESS_VIOLATION
:
1167 DEBUG_EXCEPTION_SIMPLE ("EXCEPTION_ACCESS_VIOLATION");
1168 ourstatus
->value
.sig
= GDB_SIGNAL_SEGV
;
1171 /* See if the access violation happened within the cygwin DLL
1172 itself. Cygwin uses a kind of exception handling to deal
1173 with passed-in invalid addresses. gdb should not treat
1174 these as real SEGVs since they will be silently handled by
1175 cygwin. A real SEGV will (theoretically) be caught by
1176 cygwin later in the process and will be sent as a
1177 cygwin-specific-signal. So, ignore SEGVs if they show up
1178 within the text segment of the DLL itself. */
1180 CORE_ADDR addr
= (CORE_ADDR
) (uintptr_t) rec
->ExceptionAddress
;
1182 if ((!cygwin_exceptions
&& (addr
>= cygwin_load_start
1183 && addr
< cygwin_load_end
))
1184 || (find_pc_partial_function (addr
, &fn
, NULL
, NULL
)
1185 && startswith (fn
, "KERNEL32!IsBad")))
1186 return HANDLE_EXCEPTION_UNHANDLED
;
1190 case STATUS_STACK_OVERFLOW
:
1191 DEBUG_EXCEPTION_SIMPLE ("STATUS_STACK_OVERFLOW");
1192 ourstatus
->value
.sig
= GDB_SIGNAL_SEGV
;
1194 case STATUS_FLOAT_DENORMAL_OPERAND
:
1195 DEBUG_EXCEPTION_SIMPLE ("STATUS_FLOAT_DENORMAL_OPERAND");
1196 ourstatus
->value
.sig
= GDB_SIGNAL_FPE
;
1198 case EXCEPTION_ARRAY_BOUNDS_EXCEEDED
:
1199 DEBUG_EXCEPTION_SIMPLE ("EXCEPTION_ARRAY_BOUNDS_EXCEEDED");
1200 ourstatus
->value
.sig
= GDB_SIGNAL_FPE
;
1202 case STATUS_FLOAT_INEXACT_RESULT
:
1203 DEBUG_EXCEPTION_SIMPLE ("STATUS_FLOAT_INEXACT_RESULT");
1204 ourstatus
->value
.sig
= GDB_SIGNAL_FPE
;
1206 case STATUS_FLOAT_INVALID_OPERATION
:
1207 DEBUG_EXCEPTION_SIMPLE ("STATUS_FLOAT_INVALID_OPERATION");
1208 ourstatus
->value
.sig
= GDB_SIGNAL_FPE
;
1210 case STATUS_FLOAT_OVERFLOW
:
1211 DEBUG_EXCEPTION_SIMPLE ("STATUS_FLOAT_OVERFLOW");
1212 ourstatus
->value
.sig
= GDB_SIGNAL_FPE
;
1214 case STATUS_FLOAT_STACK_CHECK
:
1215 DEBUG_EXCEPTION_SIMPLE ("STATUS_FLOAT_STACK_CHECK");
1216 ourstatus
->value
.sig
= GDB_SIGNAL_FPE
;
1218 case STATUS_FLOAT_UNDERFLOW
:
1219 DEBUG_EXCEPTION_SIMPLE ("STATUS_FLOAT_UNDERFLOW");
1220 ourstatus
->value
.sig
= GDB_SIGNAL_FPE
;
1222 case STATUS_FLOAT_DIVIDE_BY_ZERO
:
1223 DEBUG_EXCEPTION_SIMPLE ("STATUS_FLOAT_DIVIDE_BY_ZERO");
1224 ourstatus
->value
.sig
= GDB_SIGNAL_FPE
;
1226 case STATUS_INTEGER_DIVIDE_BY_ZERO
:
1227 DEBUG_EXCEPTION_SIMPLE ("STATUS_INTEGER_DIVIDE_BY_ZERO");
1228 ourstatus
->value
.sig
= GDB_SIGNAL_FPE
;
1230 case STATUS_INTEGER_OVERFLOW
:
1231 DEBUG_EXCEPTION_SIMPLE ("STATUS_INTEGER_OVERFLOW");
1232 ourstatus
->value
.sig
= GDB_SIGNAL_FPE
;
1234 case EXCEPTION_BREAKPOINT
:
1235 DEBUG_EXCEPTION_SIMPLE ("EXCEPTION_BREAKPOINT");
1236 ourstatus
->value
.sig
= GDB_SIGNAL_TRAP
;
1239 DEBUG_EXCEPTION_SIMPLE ("DBG_CONTROL_C");
1240 ourstatus
->value
.sig
= GDB_SIGNAL_INT
;
1242 case DBG_CONTROL_BREAK
:
1243 DEBUG_EXCEPTION_SIMPLE ("DBG_CONTROL_BREAK");
1244 ourstatus
->value
.sig
= GDB_SIGNAL_INT
;
1246 case EXCEPTION_SINGLE_STEP
:
1247 DEBUG_EXCEPTION_SIMPLE ("EXCEPTION_SINGLE_STEP");
1248 ourstatus
->value
.sig
= GDB_SIGNAL_TRAP
;
1250 case EXCEPTION_ILLEGAL_INSTRUCTION
:
1251 DEBUG_EXCEPTION_SIMPLE ("EXCEPTION_ILLEGAL_INSTRUCTION");
1252 ourstatus
->value
.sig
= GDB_SIGNAL_ILL
;
1254 case EXCEPTION_PRIV_INSTRUCTION
:
1255 DEBUG_EXCEPTION_SIMPLE ("EXCEPTION_PRIV_INSTRUCTION");
1256 ourstatus
->value
.sig
= GDB_SIGNAL_ILL
;
1258 case EXCEPTION_NONCONTINUABLE_EXCEPTION
:
1259 DEBUG_EXCEPTION_SIMPLE ("EXCEPTION_NONCONTINUABLE_EXCEPTION");
1260 ourstatus
->value
.sig
= GDB_SIGNAL_ILL
;
1262 case MS_VC_EXCEPTION
:
1263 if (rec
->NumberParameters
>= 3
1264 && (rec
->ExceptionInformation
[0] & 0xffffffff) == 0x1000)
1266 DWORD named_thread_id
;
1267 windows_thread_info
*named_thread
;
1268 CORE_ADDR thread_name_target
;
1270 DEBUG_EXCEPTION_SIMPLE ("MS_VC_EXCEPTION");
1272 thread_name_target
= rec
->ExceptionInformation
[1];
1273 named_thread_id
= (DWORD
) (0xffffffff & rec
->ExceptionInformation
[2]);
1275 if (named_thread_id
== (DWORD
) -1)
1276 named_thread_id
= current_event
.dwThreadId
;
1278 named_thread
= thread_rec (named_thread_id
, 0);
1279 if (named_thread
!= NULL
)
1281 int thread_name_len
;
1282 gdb::unique_xmalloc_ptr
<char> thread_name
;
1284 thread_name_len
= target_read_string (thread_name_target
,
1285 &thread_name
, 1025, NULL
);
1286 if (thread_name_len
> 0)
1288 thread_name
.get ()[thread_name_len
- 1] = '\0';
1289 xfree (named_thread
->name
);
1290 named_thread
->name
= thread_name
.release ();
1293 ourstatus
->value
.sig
= GDB_SIGNAL_TRAP
;
1294 result
= HANDLE_EXCEPTION_IGNORED
;
1297 /* treat improperly formed exception as unknown */
1300 /* Treat unhandled first chance exceptions specially. */
1301 if (current_event
.u
.Exception
.dwFirstChance
)
1302 return HANDLE_EXCEPTION_UNHANDLED
;
1303 printf_unfiltered ("gdb: unknown target exception 0x%08x at %s\n",
1304 (unsigned) current_event
.u
.Exception
.ExceptionRecord
.ExceptionCode
,
1305 host_address_to_string (
1306 current_event
.u
.Exception
.ExceptionRecord
.ExceptionAddress
));
1307 ourstatus
->value
.sig
= GDB_SIGNAL_UNKNOWN
;
1311 last_sig
= ourstatus
->value
.sig
;
1315 /* Resume thread specified by ID, or all artificially suspended
1316 threads, if we are continuing execution. KILLED non-zero means we
1317 have killed the inferior, so we should ignore weird errors due to
1318 threads shutting down. */
1320 windows_continue (DWORD continue_status
, int id
, int killed
)
1322 windows_thread_info
*th
;
1325 DEBUG_EVENTS (("ContinueDebugEvent (cpid=%d, ctid=0x%x, %s);\n",
1326 (unsigned) current_event
.dwProcessId
,
1327 (unsigned) current_event
.dwThreadId
,
1328 continue_status
== DBG_CONTINUE
?
1329 "DBG_CONTINUE" : "DBG_EXCEPTION_NOT_HANDLED"));
1331 for (th
= &thread_head
; (th
= th
->next
) != NULL
;)
1332 if ((id
== -1 || id
== (int) th
->id
)
1335 if (debug_registers_changed
)
1337 th
->context
.ContextFlags
|= CONTEXT_DEBUG_REGISTERS
;
1338 th
->context
.Dr0
= dr
[0];
1339 th
->context
.Dr1
= dr
[1];
1340 th
->context
.Dr2
= dr
[2];
1341 th
->context
.Dr3
= dr
[3];
1342 th
->context
.Dr6
= DR6_CLEAR_VALUE
;
1343 th
->context
.Dr7
= dr
[7];
1345 if (th
->context
.ContextFlags
)
1349 if (GetExitCodeThread (th
->h
, &ec
)
1350 && ec
== STILL_ACTIVE
)
1352 BOOL status
= SetThreadContext (th
->h
, &th
->context
);
1357 th
->context
.ContextFlags
= 0;
1359 if (th
->suspended
> 0)
1360 (void) ResumeThread (th
->h
);
1364 res
= ContinueDebugEvent (current_event
.dwProcessId
,
1365 current_event
.dwThreadId
,
1369 error (_("Failed to resume program execution"
1370 " (ContinueDebugEvent failed, error %u)"),
1371 (unsigned int) GetLastError ());
1373 debug_registers_changed
= 0;
1377 /* Called in pathological case where Windows fails to send a
1378 CREATE_PROCESS_DEBUG_EVENT after an attach. */
1380 fake_create_process (void)
1382 current_process_handle
= OpenProcess (PROCESS_ALL_ACCESS
, FALSE
,
1383 current_event
.dwProcessId
);
1384 if (current_process_handle
!= NULL
)
1385 open_process_used
= 1;
1388 error (_("OpenProcess call failed, GetLastError = %u"),
1389 (unsigned) GetLastError ());
1390 /* We can not debug anything in that case. */
1393 = windows_add_thread (ptid_t (current_event
.dwProcessId
, 0,
1394 current_event
.dwThreadId
),
1395 current_event
.u
.CreateThread
.hThread
,
1396 current_event
.u
.CreateThread
.lpThreadLocalBase
,
1397 true /* main_thread_p */);
1398 return current_event
.dwThreadId
;
1402 windows_nat_target::resume (ptid_t ptid
, int step
, enum gdb_signal sig
)
1404 windows_thread_info
*th
;
1405 DWORD continue_status
= DBG_CONTINUE
;
1407 /* A specific PTID means `step only this thread id'. */
1408 int resume_all
= ptid
== minus_one_ptid
;
1410 /* If we're continuing all threads, it's the current inferior that
1411 should be handled specially. */
1413 ptid
= inferior_ptid
;
1415 if (sig
!= GDB_SIGNAL_0
)
1417 if (current_event
.dwDebugEventCode
!= EXCEPTION_DEBUG_EVENT
)
1419 DEBUG_EXCEPT(("Cannot continue with signal %d here.\n",sig
));
1421 else if (sig
== last_sig
)
1422 continue_status
= DBG_EXCEPTION_NOT_HANDLED
;
1425 /* This code does not seem to work, because
1426 the kernel does probably not consider changes in the ExceptionRecord
1427 structure when passing the exception to the inferior.
1428 Note that this seems possible in the exception handler itself. */
1430 for (const xlate_exception
&x
: xlate
)
1433 current_event
.u
.Exception
.ExceptionRecord
.ExceptionCode
1435 continue_status
= DBG_EXCEPTION_NOT_HANDLED
;
1438 if (continue_status
== DBG_CONTINUE
)
1440 DEBUG_EXCEPT(("Cannot continue with signal %d.\n",sig
));
1444 DEBUG_EXCEPT(("Can only continue with received signal %d.\n",
1448 last_sig
= GDB_SIGNAL_0
;
1450 DEBUG_EXEC (("gdb: windows_resume (pid=%d, tid=0x%x, step=%d, sig=%d);\n",
1451 ptid
.pid (), (unsigned) ptid
.tid (), step
, sig
));
1453 /* Get context for currently selected thread. */
1454 th
= thread_rec (inferior_ptid
.tid (), FALSE
);
1459 /* Single step by setting t bit. */
1460 struct regcache
*regcache
= get_current_regcache ();
1461 struct gdbarch
*gdbarch
= regcache
->arch ();
1462 fetch_registers (regcache
, gdbarch_ps_regnum (gdbarch
));
1463 th
->context
.EFlags
|= FLAG_TRACE_BIT
;
1466 if (th
->context
.ContextFlags
)
1468 if (debug_registers_changed
)
1470 th
->context
.Dr0
= dr
[0];
1471 th
->context
.Dr1
= dr
[1];
1472 th
->context
.Dr2
= dr
[2];
1473 th
->context
.Dr3
= dr
[3];
1474 th
->context
.Dr6
= DR6_CLEAR_VALUE
;
1475 th
->context
.Dr7
= dr
[7];
1477 CHECK (SetThreadContext (th
->h
, &th
->context
));
1478 th
->context
.ContextFlags
= 0;
1482 /* Allow continuing with the same signal that interrupted us.
1483 Otherwise complain. */
1486 windows_continue (continue_status
, -1, 0);
1488 windows_continue (continue_status
, ptid
.tid (), 0);
1491 /* Ctrl-C handler used when the inferior is not run in the same console. The
1492 handler is in charge of interrupting the inferior using DebugBreakProcess.
1493 Note that this function is not available prior to Windows XP. In this case
1494 we emit a warning. */
1496 ctrl_c_handler (DWORD event_type
)
1498 const int attach_flag
= current_inferior ()->attach_flag
;
1500 /* Only handle Ctrl-C and Ctrl-Break events. Ignore others. */
1501 if (event_type
!= CTRL_C_EVENT
&& event_type
!= CTRL_BREAK_EVENT
)
1504 /* If the inferior and the debugger share the same console, do nothing as
1505 the inferior has also received the Ctrl-C event. */
1506 if (!new_console
&& !attach_flag
)
1509 if (!DebugBreakProcess (current_process_handle
))
1510 warning (_("Could not interrupt program. "
1511 "Press Ctrl-c in the program console."));
1513 /* Return true to tell that Ctrl-C has been handled. */
1517 /* Get the next event from the child. Returns a non-zero thread id if the event
1518 requires handling by WFI (or whatever). */
1520 get_windows_debug_event (struct target_ops
*ops
,
1521 int pid
, struct target_waitstatus
*ourstatus
)
1524 DWORD continue_status
, event_code
;
1525 windows_thread_info
*th
;
1526 static windows_thread_info dummy_thread_info
;
1527 DWORD thread_id
= 0;
1529 last_sig
= GDB_SIGNAL_0
;
1531 if (!(debug_event
= WaitForDebugEvent (¤t_event
, 1000)))
1535 continue_status
= DBG_CONTINUE
;
1537 event_code
= current_event
.dwDebugEventCode
;
1538 ourstatus
->kind
= TARGET_WAITKIND_SPURIOUS
;
1540 have_saved_context
= 0;
1544 case CREATE_THREAD_DEBUG_EVENT
:
1545 DEBUG_EVENTS (("gdb: kernel event for pid=%u tid=0x%x code=%s)\n",
1546 (unsigned) current_event
.dwProcessId
,
1547 (unsigned) current_event
.dwThreadId
,
1548 "CREATE_THREAD_DEBUG_EVENT"));
1549 if (saw_create
!= 1)
1551 struct inferior
*inf
;
1552 inf
= find_inferior_pid (current_event
.dwProcessId
);
1553 if (!saw_create
&& inf
->attach_flag
)
1555 /* Kludge around a Windows bug where first event is a create
1556 thread event. Caused when attached process does not have
1558 thread_id
= fake_create_process ();
1564 /* Record the existence of this thread. */
1565 thread_id
= current_event
.dwThreadId
;
1566 th
= windows_add_thread
1567 (ptid_t (current_event
.dwProcessId
, 0, current_event
.dwThreadId
),
1568 current_event
.u
.CreateThread
.hThread
,
1569 current_event
.u
.CreateThread
.lpThreadLocalBase
,
1570 false /* main_thread_p */);
1574 case EXIT_THREAD_DEBUG_EVENT
:
1575 DEBUG_EVENTS (("gdb: kernel event for pid=%u tid=0x%x code=%s)\n",
1576 (unsigned) current_event
.dwProcessId
,
1577 (unsigned) current_event
.dwThreadId
,
1578 "EXIT_THREAD_DEBUG_EVENT"));
1579 windows_delete_thread (ptid_t (current_event
.dwProcessId
, 0,
1580 current_event
.dwThreadId
),
1581 current_event
.u
.ExitThread
.dwExitCode
,
1582 false /* main_thread_p */);
1583 th
= &dummy_thread_info
;
1586 case CREATE_PROCESS_DEBUG_EVENT
:
1587 DEBUG_EVENTS (("gdb: kernel event for pid=%u tid=0x%x code=%s)\n",
1588 (unsigned) current_event
.dwProcessId
,
1589 (unsigned) current_event
.dwThreadId
,
1590 "CREATE_PROCESS_DEBUG_EVENT"));
1591 CloseHandle (current_event
.u
.CreateProcessInfo
.hFile
);
1592 if (++saw_create
!= 1)
1595 current_process_handle
= current_event
.u
.CreateProcessInfo
.hProcess
;
1596 /* Add the main thread. */
1597 th
= windows_add_thread
1598 (ptid_t (current_event
.dwProcessId
, 0,
1599 current_event
.dwThreadId
),
1600 current_event
.u
.CreateProcessInfo
.hThread
,
1601 current_event
.u
.CreateProcessInfo
.lpThreadLocalBase
,
1602 true /* main_thread_p */);
1603 thread_id
= current_event
.dwThreadId
;
1606 case EXIT_PROCESS_DEBUG_EVENT
:
1607 DEBUG_EVENTS (("gdb: kernel event for pid=%u tid=0x%x code=%s)\n",
1608 (unsigned) current_event
.dwProcessId
,
1609 (unsigned) current_event
.dwThreadId
,
1610 "EXIT_PROCESS_DEBUG_EVENT"));
1611 if (!windows_initialization_done
)
1613 target_terminal::ours ();
1614 target_mourn_inferior (inferior_ptid
);
1615 error (_("During startup program exited with code 0x%x."),
1616 (unsigned int) current_event
.u
.ExitProcess
.dwExitCode
);
1618 else if (saw_create
== 1)
1620 windows_delete_thread (ptid_t (current_event
.dwProcessId
, 0,
1621 current_event
.dwThreadId
),
1622 0, true /* main_thread_p */);
1623 ourstatus
->kind
= TARGET_WAITKIND_EXITED
;
1624 ourstatus
->value
.integer
= current_event
.u
.ExitProcess
.dwExitCode
;
1625 thread_id
= current_event
.dwThreadId
;
1629 case LOAD_DLL_DEBUG_EVENT
:
1630 DEBUG_EVENTS (("gdb: kernel event for pid=%u tid=0x%x code=%s)\n",
1631 (unsigned) current_event
.dwProcessId
,
1632 (unsigned) current_event
.dwThreadId
,
1633 "LOAD_DLL_DEBUG_EVENT"));
1634 CloseHandle (current_event
.u
.LoadDll
.hFile
);
1635 if (saw_create
!= 1 || ! windows_initialization_done
)
1637 catch_errors (handle_load_dll
);
1638 ourstatus
->kind
= TARGET_WAITKIND_LOADED
;
1639 ourstatus
->value
.integer
= 0;
1640 thread_id
= current_event
.dwThreadId
;
1643 case UNLOAD_DLL_DEBUG_EVENT
:
1644 DEBUG_EVENTS (("gdb: kernel event for pid=%u tid=0x%x code=%s)\n",
1645 (unsigned) current_event
.dwProcessId
,
1646 (unsigned) current_event
.dwThreadId
,
1647 "UNLOAD_DLL_DEBUG_EVENT"));
1648 if (saw_create
!= 1 || ! windows_initialization_done
)
1650 catch_errors (handle_unload_dll
);
1651 ourstatus
->kind
= TARGET_WAITKIND_LOADED
;
1652 ourstatus
->value
.integer
= 0;
1653 thread_id
= current_event
.dwThreadId
;
1656 case EXCEPTION_DEBUG_EVENT
:
1657 DEBUG_EVENTS (("gdb: kernel event for pid=%u tid=0x%x code=%s)\n",
1658 (unsigned) current_event
.dwProcessId
,
1659 (unsigned) current_event
.dwThreadId
,
1660 "EXCEPTION_DEBUG_EVENT"));
1661 if (saw_create
!= 1)
1663 switch (handle_exception (ourstatus
))
1665 case HANDLE_EXCEPTION_UNHANDLED
:
1667 continue_status
= DBG_EXCEPTION_NOT_HANDLED
;
1669 case HANDLE_EXCEPTION_HANDLED
:
1670 thread_id
= current_event
.dwThreadId
;
1672 case HANDLE_EXCEPTION_IGNORED
:
1673 continue_status
= DBG_CONTINUE
;
1678 case OUTPUT_DEBUG_STRING_EVENT
: /* Message from the kernel. */
1679 DEBUG_EVENTS (("gdb: kernel event for pid=%u tid=0x%x code=%s)\n",
1680 (unsigned) current_event
.dwProcessId
,
1681 (unsigned) current_event
.dwThreadId
,
1682 "OUTPUT_DEBUG_STRING_EVENT"));
1683 if (saw_create
!= 1)
1685 thread_id
= handle_output_debug_string (ourstatus
);
1689 if (saw_create
!= 1)
1691 printf_unfiltered ("gdb: kernel event for pid=%u tid=0x%x\n",
1692 (unsigned) current_event
.dwProcessId
,
1693 (unsigned) current_event
.dwThreadId
);
1694 printf_unfiltered (" unknown event code %u\n",
1695 (unsigned) current_event
.dwDebugEventCode
);
1699 if (!thread_id
|| saw_create
!= 1)
1701 CHECK (windows_continue (continue_status
, -1, 0));
1705 inferior_ptid
= ptid_t (current_event
.dwProcessId
, 0, thread_id
);
1706 current_thread
= th
;
1707 if (!current_thread
)
1708 current_thread
= thread_rec (thread_id
, TRUE
);
1715 /* Wait for interesting events to occur in the target process. */
1717 windows_nat_target::wait (ptid_t ptid
, struct target_waitstatus
*ourstatus
,
1722 /* We loop when we get a non-standard exception rather than return
1723 with a SPURIOUS because resume can try and step or modify things,
1724 which needs a current_thread->h. But some of these exceptions mark
1725 the birth or death of threads, which mean that the current thread
1726 isn't necessarily what you think it is. */
1732 /* If the user presses Ctrl-c while the debugger is waiting
1733 for an event, he expects the debugger to interrupt his program
1734 and to get the prompt back. There are two possible situations:
1736 - The debugger and the program do not share the console, in
1737 which case the Ctrl-c event only reached the debugger.
1738 In that case, the ctrl_c handler will take care of interrupting
1739 the inferior. Note that this case is working starting with
1740 Windows XP. For Windows 2000, Ctrl-C should be pressed in the
1743 - The debugger and the program share the same console, in which
1744 case both debugger and inferior will receive the Ctrl-c event.
1745 In that case the ctrl_c handler will ignore the event, as the
1746 Ctrl-c event generated inside the inferior will trigger the
1747 expected debug event.
1749 FIXME: brobecker/2008-05-20: If the inferior receives the
1750 signal first and the delay until GDB receives that signal
1751 is sufficiently long, GDB can sometimes receive the SIGINT
1752 after we have unblocked the CTRL+C handler. This would
1753 lead to the debugger stopping prematurely while handling
1754 the new-thread event that comes with the handling of the SIGINT
1755 inside the inferior, and then stop again immediately when
1756 the user tries to resume the execution in the inferior.
1757 This is a classic race that we should try to fix one day. */
1758 SetConsoleCtrlHandler (&ctrl_c_handler
, TRUE
);
1759 retval
= get_windows_debug_event (this, pid
, ourstatus
);
1760 SetConsoleCtrlHandler (&ctrl_c_handler
, FALSE
);
1763 return ptid_t (current_event
.dwProcessId
, 0, retval
);
1768 if (deprecated_ui_loop_hook
!= NULL
)
1769 detach
= deprecated_ui_loop_hook (0);
1777 /* Iterate over all DLLs currently mapped by our inferior, and
1778 add them to our list of solibs. */
1781 windows_add_all_dlls (void)
1783 HMODULE dummy_hmodule
;
1788 if (EnumProcessModules (current_process_handle
, &dummy_hmodule
,
1789 sizeof (HMODULE
), &cb_needed
) == 0)
1795 hmodules
= (HMODULE
*) alloca (cb_needed
);
1796 if (EnumProcessModules (current_process_handle
, hmodules
,
1797 cb_needed
, &cb_needed
) == 0)
1800 for (i
= 1; i
< (int) (cb_needed
/ sizeof (HMODULE
)); i
++)
1804 wchar_t dll_name
[__PMAX
];
1807 char dll_name
[__PMAX
];
1810 if (GetModuleInformation (current_process_handle
, hmodules
[i
],
1811 &mi
, sizeof (mi
)) == 0)
1813 if (GetModuleFileNameEx (current_process_handle
, hmodules
[i
],
1814 dll_name
, sizeof (dll_name
)) == 0)
1817 wcstombs (name
, dll_name
, __PMAX
);
1822 solib_end
->next
= windows_make_so (name
, mi
.lpBaseOfDll
);
1823 solib_end
= solib_end
->next
;
1828 do_initial_windows_stuff (struct target_ops
*ops
, DWORD pid
, int attaching
)
1831 struct inferior
*inf
;
1833 last_sig
= GDB_SIGNAL_0
;
1835 exception_count
= 0;
1836 open_process_used
= 0;
1837 debug_registers_changed
= 0;
1838 debug_registers_used
= 0;
1839 for (i
= 0; i
< sizeof (dr
) / sizeof (dr
[0]); i
++)
1842 cygwin_load_start
= cygwin_load_end
= 0;
1844 current_event
.dwProcessId
= pid
;
1845 memset (¤t_event
, 0, sizeof (current_event
));
1846 if (!target_is_pushed (ops
))
1848 disable_breakpoints_in_shlibs ();
1849 windows_clear_solib ();
1850 clear_proceed_status (0);
1851 init_wait_for_inferior ();
1853 inf
= current_inferior ();
1854 inferior_appeared (inf
, pid
);
1855 inf
->attach_flag
= attaching
;
1857 /* Make the new process the current inferior, so terminal handling
1858 can rely on it. When attaching, we don't know about any thread
1859 id here, but that's OK --- nothing should be referencing the
1860 current thread until we report an event out of windows_wait. */
1861 inferior_ptid
= ptid_t (pid
);
1863 target_terminal::init ();
1864 target_terminal::inferior ();
1866 windows_initialization_done
= 0;
1870 struct target_waitstatus status
;
1872 ops
->wait (minus_one_ptid
, &status
, 0);
1874 /* Note windows_wait returns TARGET_WAITKIND_SPURIOUS for thread
1876 if (status
.kind
!= TARGET_WAITKIND_LOADED
1877 && status
.kind
!= TARGET_WAITKIND_SPURIOUS
)
1880 ops
->resume (minus_one_ptid
, 0, GDB_SIGNAL_0
);
1883 /* Now that the inferior has been started and all DLLs have been mapped,
1884 we can iterate over all DLLs and load them in.
1886 We avoid doing it any earlier because, on certain versions of Windows,
1887 LOAD_DLL_DEBUG_EVENTs are sometimes not complete. In particular,
1888 we have seen on Windows 8.1 that the ntdll.dll load event does not
1889 include the DLL name, preventing us from creating an associated SO.
1890 A possible explanation is that ntdll.dll might be mapped before
1891 the SO info gets created by the Windows system -- ntdll.dll is
1892 the first DLL to be reported via LOAD_DLL_DEBUG_EVENT and other DLLs
1893 do not seem to suffer from that problem.
1895 Rather than try to work around this sort of issue, it is much
1896 simpler to just ignore DLL load/unload events during the startup
1897 phase, and then process them all in one batch now. */
1898 windows_add_all_dlls ();
1900 windows_initialization_done
= 1;
1904 /* Try to set or remove a user privilege to the current process. Return -1
1905 if that fails, the previous setting of that privilege otherwise.
1907 This code is copied from the Cygwin source code and rearranged to allow
1908 dynamically loading of the needed symbols from advapi32 which is only
1909 available on NT/2K/XP. */
1911 set_process_privilege (const char *privilege
, BOOL enable
)
1913 HANDLE token_hdl
= NULL
;
1915 TOKEN_PRIVILEGES new_priv
, orig_priv
;
1919 if (!OpenProcessToken (GetCurrentProcess (),
1920 TOKEN_QUERY
| TOKEN_ADJUST_PRIVILEGES
,
1924 if (!LookupPrivilegeValueA (NULL
, privilege
, &restore_priv
))
1927 new_priv
.PrivilegeCount
= 1;
1928 new_priv
.Privileges
[0].Luid
= restore_priv
;
1929 new_priv
.Privileges
[0].Attributes
= enable
? SE_PRIVILEGE_ENABLED
: 0;
1931 if (!AdjustTokenPrivileges (token_hdl
, FALSE
, &new_priv
,
1932 sizeof orig_priv
, &orig_priv
, &size
))
1935 /* Disabled, otherwise every `attach' in an unprivileged user session
1936 would raise the "Failed to get SE_DEBUG_NAME privilege" warning in
1937 windows_attach(). */
1938 /* AdjustTokenPrivileges returns TRUE even if the privilege could not
1939 be enabled. GetLastError () returns an correct error code, though. */
1940 if (enable
&& GetLastError () == ERROR_NOT_ALL_ASSIGNED
)
1944 ret
= orig_priv
.Privileges
[0].Attributes
== SE_PRIVILEGE_ENABLED
? 1 : 0;
1948 CloseHandle (token_hdl
);
1953 /* Attach to process PID, then initialize for debugging it. */
1956 windows_nat_target::attach (const char *args
, int from_tty
)
1961 pid
= parse_pid_to_attach (args
);
1963 if (set_process_privilege (SE_DEBUG_NAME
, TRUE
) < 0)
1965 printf_unfiltered ("Warning: Failed to get SE_DEBUG_NAME privilege\n");
1966 printf_unfiltered ("This can cause attach to "
1967 "fail on Windows NT/2K/XP\n");
1970 windows_init_thread_list ();
1971 ok
= DebugActiveProcess (pid
);
1977 /* Try fall back to Cygwin pid. */
1978 pid
= cygwin_internal (CW_CYGWIN_PID_TO_WINPID
, pid
);
1981 ok
= DebugActiveProcess (pid
);
1986 error (_("Can't attach to process %u (error %u)"),
1987 (unsigned) pid
, (unsigned) GetLastError ());
1989 DebugSetProcessKillOnExit (FALSE
);
1993 char *exec_file
= (char *) get_exec_file (0);
1996 printf_unfiltered ("Attaching to program `%s', %s\n", exec_file
,
1997 target_pid_to_str (ptid_t (pid
)).c_str ());
1999 printf_unfiltered ("Attaching to %s\n",
2000 target_pid_to_str (ptid_t (pid
)).c_str ());
2003 do_initial_windows_stuff (this, pid
, 1);
2004 target_terminal::ours ();
2008 windows_nat_target::detach (inferior
*inf
, int from_tty
)
2012 ptid_t ptid
= minus_one_ptid
;
2013 resume (ptid
, 0, GDB_SIGNAL_0
);
2015 if (!DebugActiveProcessStop (current_event
.dwProcessId
))
2017 error (_("Can't detach process %u (error %u)"),
2018 (unsigned) current_event
.dwProcessId
, (unsigned) GetLastError ());
2021 DebugSetProcessKillOnExit (FALSE
);
2023 if (detached
&& from_tty
)
2025 const char *exec_file
= get_exec_file (0);
2028 printf_unfiltered ("Detaching from program: %s, Pid %u\n", exec_file
,
2029 (unsigned) current_event
.dwProcessId
);
2032 x86_cleanup_dregs ();
2033 inferior_ptid
= null_ptid
;
2034 detach_inferior (inf
);
2036 maybe_unpush_target ();
2039 /* Try to determine the executable filename.
2041 EXE_NAME_RET is a pointer to a buffer whose size is EXE_NAME_MAX_LEN.
2043 Upon success, the filename is stored inside EXE_NAME_RET, and
2044 this function returns nonzero.
2046 Otherwise, this function returns zero and the contents of
2047 EXE_NAME_RET is undefined. */
2050 windows_get_exec_module_filename (char *exe_name_ret
, size_t exe_name_max_len
)
2057 if (!EnumProcessModules (current_process_handle
, &dh_buf
,
2058 sizeof (HMODULE
), &cbNeeded
) || !cbNeeded
)
2061 /* We know the executable is always first in the list of modules,
2062 which we just fetched. So no need to fetch more. */
2066 /* Cygwin prefers that the path be in /x/y/z format, so extract
2067 the filename into a temporary buffer first, and then convert it
2068 to POSIX format into the destination buffer. */
2069 cygwin_buf_t
*pathbuf
= (cygwin_buf_t
*) alloca (exe_name_max_len
* sizeof (cygwin_buf_t
));
2071 len
= GetModuleFileNameEx (current_process_handle
,
2072 dh_buf
, pathbuf
, exe_name_max_len
);
2074 error (_("Error getting executable filename: %u."),
2075 (unsigned) GetLastError ());
2076 if (cygwin_conv_path (CCP_WIN_W_TO_POSIX
, pathbuf
, exe_name_ret
,
2077 exe_name_max_len
) < 0)
2078 error (_("Error converting executable filename to POSIX: %d."), errno
);
2081 len
= GetModuleFileNameEx (current_process_handle
,
2082 dh_buf
, exe_name_ret
, exe_name_max_len
);
2084 error (_("Error getting executable filename: %u."),
2085 (unsigned) GetLastError ());
2088 return 1; /* success */
2091 /* The pid_to_exec_file target_ops method for this platform. */
2094 windows_nat_target::pid_to_exec_file (int pid
)
2096 static char path
[__PMAX
];
2098 /* Try to find exe name as symlink target of /proc/<pid>/exe. */
2100 char procexe
[sizeof ("/proc/4294967295/exe")];
2102 xsnprintf (procexe
, sizeof (procexe
), "/proc/%u/exe", pid
);
2103 nchars
= readlink (procexe
, path
, sizeof(path
));
2104 if (nchars
> 0 && nchars
< sizeof (path
))
2106 path
[nchars
] = '\0'; /* Got it */
2111 /* If we get here then either Cygwin is hosed, this isn't a Cygwin version
2112 of gdb, or we're trying to debug a non-Cygwin windows executable. */
2113 if (!windows_get_exec_module_filename (path
, sizeof (path
)))
2119 /* Print status information about what we're accessing. */
2122 windows_nat_target::files_info ()
2124 struct inferior
*inf
= current_inferior ();
2126 printf_unfiltered ("\tUsing the running image of %s %s.\n",
2127 inf
->attach_flag
? "attached" : "child",
2128 target_pid_to_str (inferior_ptid
).c_str ());
2131 /* Modify CreateProcess parameters for use of a new separate console.
2133 *FLAGS: DWORD parameter for general process creation flags.
2134 *SI: STARTUPINFO structure, for which the console window size and
2135 console buffer size is filled in if GDB is running in a console.
2136 to create the new console.
2137 The size of the used font is not available on all versions of
2138 Windows OS. Furthermore, the current font might not be the default
2139 font, but this is still better than before.
2140 If the windows and buffer sizes are computed,
2141 SI->DWFLAGS is changed so that this information is used
2142 by CreateProcess function. */
2145 windows_set_console_info (STARTUPINFO
*si
, DWORD
*flags
)
2147 HANDLE hconsole
= CreateFile ("CONOUT$", GENERIC_READ
| GENERIC_WRITE
,
2148 FILE_SHARE_READ
, NULL
, OPEN_EXISTING
, 0, 0);
2150 if (hconsole
!= INVALID_HANDLE_VALUE
)
2152 CONSOLE_SCREEN_BUFFER_INFO sbinfo
;
2154 CONSOLE_FONT_INFO cfi
;
2156 GetCurrentConsoleFont (hconsole
, FALSE
, &cfi
);
2157 font_size
= GetConsoleFontSize (hconsole
, cfi
.nFont
);
2158 GetConsoleScreenBufferInfo(hconsole
, &sbinfo
);
2159 si
->dwXSize
= sbinfo
.srWindow
.Right
- sbinfo
.srWindow
.Left
+ 1;
2160 si
->dwYSize
= sbinfo
.srWindow
.Bottom
- sbinfo
.srWindow
.Top
+ 1;
2162 si
->dwXSize
*= font_size
.X
;
2166 si
->dwYSize
*= font_size
.Y
;
2169 si
->dwXCountChars
= sbinfo
.dwSize
.X
;
2170 si
->dwYCountChars
= sbinfo
.dwSize
.Y
;
2171 si
->dwFlags
|= STARTF_USESIZE
| STARTF_USECOUNTCHARS
;
2173 *flags
|= CREATE_NEW_CONSOLE
;
2177 /* Function called by qsort to sort environment strings. */
2180 envvar_cmp (const void *a
, const void *b
)
2182 const char **p
= (const char **) a
;
2183 const char **q
= (const char **) b
;
2184 return strcasecmp (*p
, *q
);
2190 clear_win32_environment (char **env
)
2194 wchar_t *copy
= NULL
, *equalpos
;
2196 for (i
= 0; env
[i
] && *env
[i
]; i
++)
2198 len
= mbstowcs (NULL
, env
[i
], 0) + 1;
2199 copy
= (wchar_t *) xrealloc (copy
, len
* sizeof (wchar_t));
2200 mbstowcs (copy
, env
[i
], len
);
2201 equalpos
= wcschr (copy
, L
'=');
2204 SetEnvironmentVariableW (copy
, NULL
);
2212 /* Redirection of inferior I/O streams for native MS-Windows programs.
2213 Unlike on Unix, where this is handled by invoking the inferior via
2214 the shell, on MS-Windows we need to emulate the cmd.exe shell.
2216 The official documentation of the cmd.exe redirection features is here:
2218 http://www.microsoft.com/resources/documentation/windows/xp/all/proddocs/en-us/redirection.mspx
2220 (That page talks about Windows XP, but there's no newer
2221 documentation, so we assume later versions of cmd.exe didn't change
2224 Caveat: the documentation on that page seems to include a few lies.
2225 For example, it describes strange constructs 1<&2 and 2<&1, which
2226 seem to work only when 1>&2 resp. 2>&1 would make sense, and so I
2227 think the cmd.exe parser of the redirection symbols simply doesn't
2228 care about the < vs > distinction in these cases. Therefore, the
2229 supported features are explicitly documented below.
2231 The emulation below aims at supporting all the valid use cases
2232 supported by cmd.exe, which include:
2234 < FILE redirect standard input from FILE
2235 0< FILE redirect standard input from FILE
2236 <&N redirect standard input from file descriptor N
2237 0<&N redirect standard input from file descriptor N
2238 > FILE redirect standard output to FILE
2239 >> FILE append standard output to FILE
2240 1>> FILE append standard output to FILE
2241 >&N redirect standard output to file descriptor N
2242 1>&N redirect standard output to file descriptor N
2243 >>&N append standard output to file descriptor N
2244 1>>&N append standard output to file descriptor N
2245 2> FILE redirect standard error to FILE
2246 2>> FILE append standard error to FILE
2247 2>&N redirect standard error to file descriptor N
2248 2>>&N append standard error to file descriptor N
2250 Note that using N > 2 in the above construct is supported, but
2251 requires that the corresponding file descriptor be open by some
2252 means elsewhere or outside GDB. Also note that using ">&0" or
2253 "<&2" will generally fail, because the file descriptor redirected
2254 from is normally open in an incompatible mode (e.g., FD 0 is open
2255 for reading only). IOW, use of such tricks is not recommended;
2256 you are on your own.
2258 We do NOT support redirection of file descriptors above 2, as in
2259 "3>SOME-FILE", because MinGW compiled programs don't (supporting
2260 that needs special handling in the startup code that MinGW
2261 doesn't have). Pipes are also not supported.
2263 As for invalid use cases, where the redirection contains some
2264 error, the emulation below will detect that and produce some
2265 error and/or failure. But the behavior in those cases is not
2266 bug-for-bug compatible with what cmd.exe does in those cases.
2267 That's because what cmd.exe does then is not well defined, and
2268 seems to be a side effect of the cmd.exe parsing of the command
2269 line more than anything else. For example, try redirecting to an
2270 invalid file name, as in "> foo:bar".
2272 There are also minor syntactic deviations from what cmd.exe does
2273 in some corner cases. For example, it doesn't support the likes
2274 of "> &foo" to mean redirect to file named literally "&foo"; we
2275 do support that here, because that, too, sounds like some issue
2276 with the cmd.exe parser. Another nicety is that we support
2277 redirection targets that use file names with forward slashes,
2278 something cmd.exe doesn't -- this comes in handy since GDB
2279 file-name completion can be used when typing the command line for
2282 /* Support routines for redirecting standard handles of the inferior. */
2284 /* Parse a single redirection spec, open/duplicate the specified
2285 file/fd, and assign the appropriate value to one of the 3 standard
2286 file descriptors. */
2288 redir_open (const char *redir_string
, int *inp
, int *out
, int *err
)
2290 int *fd
, ref_fd
= -2;
2292 const char *fname
= redir_string
+ 1;
2293 int rc
= *redir_string
;
2308 fd
= (rc
== '2') ? err
: out
;
2309 mode
= O_WRONLY
| O_CREAT
;
2322 if (*fname
== '&' && '0' <= fname
[1] && fname
[1] <= '9')
2324 /* A reference to a file descriptor. */
2326 ref_fd
= (int) strtol (fname
+ 1, &fdtail
, 10);
2327 if (fdtail
> fname
+ 1 && *fdtail
== '\0')
2329 /* Don't allow redirection when open modes are incompatible. */
2330 if ((ref_fd
== 0 && (fd
== out
|| fd
== err
))
2331 || ((ref_fd
== 1 || ref_fd
== 2) && fd
== inp
))
2338 else if (ref_fd
== 1)
2340 else if (ref_fd
== 2)
2350 fname
++; /* skip the separator space */
2351 /* If the descriptor is already open, close it. This allows
2352 multiple specs of redirections for the same stream, which is
2353 somewhat nonsensical, but still valid and supported by cmd.exe.
2354 (But cmd.exe only opens a single file in this case, the one
2355 specified by the last redirection spec on the command line.) */
2360 *fd
= _open (fname
, mode
, _S_IREAD
| _S_IWRITE
);
2364 else if (ref_fd
== -1)
2365 *fd
= -1; /* reset to default destination */
2368 *fd
= _dup (ref_fd
);
2372 /* _open just sets a flag for O_APPEND, which won't be passed to the
2373 inferior, so we need to actually move the file pointer. */
2374 if ((mode
& O_APPEND
) != 0)
2375 _lseek (*fd
, 0L, SEEK_END
);
2379 /* Canonicalize a single redirection spec and set up the corresponding
2380 file descriptor as specified. */
2382 redir_set_redirection (const char *s
, int *inp
, int *out
, int *err
)
2384 char buf
[__PMAX
+ 2 + 5]; /* extra space for quotes & redirection string */
2386 const char *start
= s
;
2389 *d
++ = *s
++; /* copy the 1st character, < or > or a digit */
2390 if ((*start
== '>' || *start
== '1' || *start
== '2')
2394 if (*s
== '>' && *start
!= '>')
2397 else if (*start
== '0' && *s
== '<')
2399 /* cmd.exe recognizes "&N" only immediately after the redirection symbol. */
2402 while (isspace (*s
)) /* skip whitespace before file name */
2404 *d
++ = ' '; /* separate file name with a single space */
2407 /* Copy the file name. */
2410 /* Remove quoting characters from the file name in buf[]. */
2411 if (*s
== '"') /* could support '..' quoting here */
2415 else if (*s
== quote
)
2423 else if (*s
== '\\')
2425 if (s
[1] == '"') /* could support '..' here */
2429 else if (isspace (*s
) && !quote
)
2433 if (d
- buf
>= sizeof (buf
) - 1)
2435 errno
= ENAMETOOLONG
;
2441 /* Windows doesn't allow redirection characters in file names, so we
2442 can bail out early if they use them, or if there's no target file
2443 name after the redirection symbol. */
2444 if (d
[-1] == '>' || d
[-1] == '<')
2449 if (redir_open (buf
, inp
, out
, err
) == 0)
2454 /* Parse the command line for redirection specs and prepare the file
2455 descriptors for the 3 standard streams accordingly. */
2457 redirect_inferior_handles (const char *cmd_orig
, char *cmd
,
2458 int *inp
, int *out
, int *err
)
2460 const char *s
= cmd_orig
;
2463 bool retval
= false;
2465 while (isspace (*s
))
2470 if (*s
== '"') /* could also support '..' quoting here */
2474 else if (*s
== quote
)
2477 else if (*s
== '\\')
2479 if (s
[1] == '"') /* escaped quote char */
2484 /* Process a single redirection candidate. */
2485 if (*s
== '<' || *s
== '>'
2486 || ((*s
== '1' || *s
== '2') && s
[1] == '>')
2487 || (*s
== '0' && s
[1] == '<'))
2489 int skip
= redir_set_redirection (s
, inp
, out
, err
);
2503 #endif /* !__CYGWIN__ */
2505 /* Start an inferior windows child process and sets inferior_ptid to its pid.
2506 EXEC_FILE is the file to run.
2507 ALLARGS is a string containing the arguments to the program.
2508 ENV is the environment vector to pass. Errors reported with error(). */
2511 windows_nat_target::create_inferior (const char *exec_file
,
2512 const std::string
&origallargs
,
2513 char **in_env
, int from_tty
)
2517 cygwin_buf_t real_path
[__PMAX
];
2518 cygwin_buf_t shell
[__PMAX
]; /* Path to shell */
2519 cygwin_buf_t infcwd
[__PMAX
];
2521 cygwin_buf_t
*toexec
;
2522 cygwin_buf_t
*cygallargs
;
2524 char **old_env
= NULL
;
2528 int ostdin
, ostdout
, ostderr
;
2529 #else /* !__CYGWIN__ */
2530 char shell
[__PMAX
]; /* Path to shell */
2532 char *args
, *allargs_copy
;
2533 size_t args_len
, allargs_len
;
2534 int fd_inp
= -1, fd_out
= -1, fd_err
= -1;
2535 HANDLE tty
= INVALID_HANDLE_VALUE
;
2536 bool redirected
= false;
2543 #endif /* !__CYGWIN__ */
2544 const char *allargs
= origallargs
.c_str ();
2545 PROCESS_INFORMATION pi
;
2548 const char *inferior_io_terminal
= get_inferior_io_terminal ();
2551 error (_("No executable specified, use `target exec'."));
2553 const char *inferior_cwd
= get_inferior_cwd ();
2554 std::string expanded_infcwd
;
2555 if (inferior_cwd
!= NULL
)
2557 expanded_infcwd
= gdb_tilde_expand (inferior_cwd
);
2558 /* Mirror slashes on inferior's cwd. */
2559 std::replace (expanded_infcwd
.begin (), expanded_infcwd
.end (),
2561 inferior_cwd
= expanded_infcwd
.c_str ();
2564 memset (&si
, 0, sizeof (si
));
2565 si
.cb
= sizeof (si
);
2568 flags
|= CREATE_NEW_PROCESS_GROUP
;
2571 windows_set_console_info (&si
, &flags
);
2576 flags
|= DEBUG_ONLY_THIS_PROCESS
;
2577 if (cygwin_conv_path (CCP_POSIX_TO_WIN_W
, exec_file
, real_path
,
2578 __PMAX
* sizeof (cygwin_buf_t
)) < 0)
2579 error (_("Error starting executable: %d"), errno
);
2582 len
= mbstowcs (NULL
, allargs
, 0) + 1;
2583 if (len
== (size_t) -1)
2584 error (_("Error starting executable: %d"), errno
);
2585 cygallargs
= (wchar_t *) alloca (len
* sizeof (wchar_t));
2586 mbstowcs (cygallargs
, allargs
, len
);
2587 #else /* !__USEWIDE */
2588 cygallargs
= allargs
;
2594 if (cygwin_conv_path (CCP_POSIX_TO_WIN_W
, sh
, shell
, __PMAX
) < 0)
2595 error (_("Error starting executable via shell: %d"), errno
);
2597 len
= sizeof (L
" -c 'exec '") + mbstowcs (NULL
, exec_file
, 0)
2598 + mbstowcs (NULL
, allargs
, 0) + 2;
2599 cygallargs
= (wchar_t *) alloca (len
* sizeof (wchar_t));
2600 swprintf (cygallargs
, len
, L
" -c 'exec %s %s'", exec_file
, allargs
);
2601 #else /* !__USEWIDE */
2602 len
= (sizeof (" -c 'exec '") + strlen (exec_file
)
2603 + strlen (allargs
) + 2);
2604 cygallargs
= (char *) alloca (len
);
2605 xsnprintf (cygallargs
, len
, " -c 'exec %s %s'", exec_file
, allargs
);
2606 #endif /* __USEWIDE */
2608 flags
|= DEBUG_PROCESS
;
2611 if (inferior_cwd
!= NULL
2612 && cygwin_conv_path (CCP_POSIX_TO_WIN_W
, inferior_cwd
,
2613 infcwd
, strlen (inferior_cwd
)) < 0)
2614 error (_("Error converting inferior cwd: %d"), errno
);
2617 args
= (cygwin_buf_t
*) alloca ((wcslen (toexec
) + wcslen (cygallargs
) + 2)
2618 * sizeof (wchar_t));
2619 wcscpy (args
, toexec
);
2620 wcscat (args
, L
" ");
2621 wcscat (args
, cygallargs
);
2622 #else /* !__USEWIDE */
2623 args
= (cygwin_buf_t
*) alloca (strlen (toexec
) + strlen (cygallargs
) + 2);
2624 strcpy (args
, toexec
);
2626 strcat (args
, cygallargs
);
2627 #endif /* !__USEWIDE */
2629 #ifdef CW_CVT_ENV_TO_WINENV
2630 /* First try to create a direct Win32 copy of the POSIX environment. */
2631 w32_env
= (PWCHAR
) cygwin_internal (CW_CVT_ENV_TO_WINENV
, in_env
);
2632 if (w32_env
!= (PWCHAR
) -1)
2633 flags
|= CREATE_UNICODE_ENVIRONMENT
;
2635 /* If that fails, fall back to old method tweaking GDB's environment. */
2636 #endif /* CW_CVT_ENV_TO_WINENV */
2638 /* Reset all Win32 environment variables to avoid leftover on next run. */
2639 clear_win32_environment (environ
);
2640 /* Prepare the environment vars for CreateProcess. */
2643 cygwin_internal (CW_SYNC_WINENV
);
2647 if (!inferior_io_terminal
)
2648 tty
= ostdin
= ostdout
= ostderr
= -1;
2651 tty
= open (inferior_io_terminal
, O_RDWR
| O_NOCTTY
);
2654 print_sys_errmsg (inferior_io_terminal
, errno
);
2655 ostdin
= ostdout
= ostderr
= -1;
2668 windows_init_thread_list ();
2669 ret
= CreateProcess (0,
2670 args
, /* command line */
2671 NULL
, /* Security */
2673 TRUE
, /* inherit handles */
2674 flags
, /* start flags */
2675 w32_env
, /* environment */
2676 inferior_cwd
!= NULL
? infcwd
: NULL
, /* current
2681 /* Just free the Win32 environment, if it could be created. */
2685 /* Reset all environment variables to avoid leftover on next run. */
2686 clear_win32_environment (in_env
);
2687 /* Restore normal GDB environment variables. */
2689 cygwin_internal (CW_SYNC_WINENV
);
2702 #else /* !__CYGWIN__ */
2703 allargs_len
= strlen (allargs
);
2704 allargs_copy
= strcpy ((char *) alloca (allargs_len
+ 1), allargs
);
2705 if (strpbrk (allargs_copy
, "<>") != NULL
)
2710 redirect_inferior_handles (allargs
, allargs_copy
,
2711 &fd_inp
, &fd_out
, &fd_err
);
2713 warning (_("Error in redirection: %s."), safe_strerror (errno
));
2716 allargs_len
= strlen (allargs_copy
);
2718 /* If not all the standard streams are redirected by the command
2719 line, use inferior_io_terminal for those which aren't. */
2720 if (inferior_io_terminal
2721 && !(fd_inp
>= 0 && fd_out
>= 0 && fd_err
>= 0))
2723 SECURITY_ATTRIBUTES sa
;
2724 sa
.nLength
= sizeof(sa
);
2725 sa
.lpSecurityDescriptor
= 0;
2726 sa
.bInheritHandle
= TRUE
;
2727 tty
= CreateFileA (inferior_io_terminal
, GENERIC_READ
| GENERIC_WRITE
,
2728 0, &sa
, OPEN_EXISTING
, FILE_ATTRIBUTE_NORMAL
, 0);
2729 if (tty
== INVALID_HANDLE_VALUE
)
2730 warning (_("Warning: Failed to open TTY %s, error %#x."),
2731 inferior_io_terminal
, (unsigned) GetLastError ());
2733 if (redirected
|| tty
!= INVALID_HANDLE_VALUE
)
2736 si
.hStdInput
= (HANDLE
) _get_osfhandle (fd_inp
);
2737 else if (tty
!= INVALID_HANDLE_VALUE
)
2740 si
.hStdInput
= GetStdHandle (STD_INPUT_HANDLE
);
2742 si
.hStdOutput
= (HANDLE
) _get_osfhandle (fd_out
);
2743 else if (tty
!= INVALID_HANDLE_VALUE
)
2744 si
.hStdOutput
= tty
;
2746 si
.hStdOutput
= GetStdHandle (STD_OUTPUT_HANDLE
);
2748 si
.hStdError
= (HANDLE
) _get_osfhandle (fd_err
);
2749 else if (tty
!= INVALID_HANDLE_VALUE
)
2752 si
.hStdError
= GetStdHandle (STD_ERROR_HANDLE
);
2753 si
.dwFlags
|= STARTF_USESTDHANDLES
;
2757 /* Build the command line, a space-separated list of tokens where
2758 the first token is the name of the module to be executed.
2759 To avoid ambiguities introduced by spaces in the module name,
2761 args_len
= strlen (toexec
) + 2 /* quotes */ + allargs_len
+ 2;
2762 args
= (char *) alloca (args_len
);
2763 xsnprintf (args
, args_len
, "\"%s\" %s", toexec
, allargs_copy
);
2765 flags
|= DEBUG_ONLY_THIS_PROCESS
;
2767 /* CreateProcess takes the environment list as a null terminated set of
2768 strings (i.e. two nulls terminate the list). */
2770 /* Get total size for env strings. */
2771 for (envlen
= 0, i
= 0; in_env
[i
] && *in_env
[i
]; i
++)
2772 envlen
+= strlen (in_env
[i
]) + 1;
2774 envsize
= sizeof (in_env
[0]) * (i
+ 1);
2775 env
= (char **) alloca (envsize
);
2776 memcpy (env
, in_env
, envsize
);
2777 /* Windows programs expect the environment block to be sorted. */
2778 qsort (env
, i
, sizeof (char *), envvar_cmp
);
2780 w32env
= (char *) alloca (envlen
+ 1);
2782 /* Copy env strings into new buffer. */
2783 for (temp
= w32env
, i
= 0; env
[i
] && *env
[i
]; i
++)
2785 strcpy (temp
, env
[i
]);
2786 temp
+= strlen (temp
) + 1;
2789 /* Final nil string to terminate new env. */
2792 windows_init_thread_list ();
2793 ret
= CreateProcessA (0,
2794 args
, /* command line */
2795 NULL
, /* Security */
2797 TRUE
, /* inherit handles */
2798 flags
, /* start flags */
2799 w32env
, /* environment */
2800 inferior_cwd
, /* current directory */
2803 if (tty
!= INVALID_HANDLE_VALUE
)
2811 #endif /* !__CYGWIN__ */
2814 error (_("Error creating process %s, (error %u)."),
2815 exec_file
, (unsigned) GetLastError ());
2817 CloseHandle (pi
.hThread
);
2818 CloseHandle (pi
.hProcess
);
2820 if (useshell
&& shell
[0] != '\0')
2825 do_initial_windows_stuff (this, pi
.dwProcessId
, 0);
2827 /* windows_continue (DBG_CONTINUE, -1, 0); */
2831 windows_nat_target::mourn_inferior ()
2833 (void) windows_continue (DBG_CONTINUE
, -1, 0);
2834 x86_cleanup_dregs();
2835 if (open_process_used
)
2837 CHECK (CloseHandle (current_process_handle
));
2838 open_process_used
= 0;
2840 inf_child_target::mourn_inferior ();
2843 /* Send a SIGINT to the process group. This acts just like the user typed a
2844 ^C on the controlling terminal. */
2847 windows_nat_target::interrupt ()
2849 DEBUG_EVENTS (("gdb: GenerateConsoleCtrlEvent (CTRLC_EVENT, 0)\n"));
2850 CHECK (GenerateConsoleCtrlEvent (CTRL_C_EVENT
, current_event
.dwProcessId
));
2851 registers_changed (); /* refresh register state */
2854 /* Helper for windows_xfer_partial that handles memory transfers.
2855 Arguments are like target_xfer_partial. */
2857 static enum target_xfer_status
2858 windows_xfer_memory (gdb_byte
*readbuf
, const gdb_byte
*writebuf
,
2859 ULONGEST memaddr
, ULONGEST len
, ULONGEST
*xfered_len
)
2863 DWORD lasterror
= 0;
2865 if (writebuf
!= NULL
)
2867 DEBUG_MEM (("gdb: write target memory, %s bytes at %s\n",
2868 pulongest (len
), core_addr_to_string (memaddr
)));
2869 success
= WriteProcessMemory (current_process_handle
,
2870 (LPVOID
) (uintptr_t) memaddr
, writebuf
,
2873 lasterror
= GetLastError ();
2874 FlushInstructionCache (current_process_handle
,
2875 (LPCVOID
) (uintptr_t) memaddr
, len
);
2879 DEBUG_MEM (("gdb: read target memory, %s bytes at %s\n",
2880 pulongest (len
), core_addr_to_string (memaddr
)));
2881 success
= ReadProcessMemory (current_process_handle
,
2882 (LPCVOID
) (uintptr_t) memaddr
, readbuf
,
2885 lasterror
= GetLastError ();
2887 *xfered_len
= (ULONGEST
) done
;
2888 if (!success
&& lasterror
== ERROR_PARTIAL_COPY
&& done
> 0)
2889 return TARGET_XFER_OK
;
2891 return success
? TARGET_XFER_OK
: TARGET_XFER_E_IO
;
2895 windows_nat_target::kill ()
2897 CHECK (TerminateProcess (current_process_handle
, 0));
2901 if (!windows_continue (DBG_CONTINUE
, -1, 1))
2903 if (!WaitForDebugEvent (¤t_event
, INFINITE
))
2905 if (current_event
.dwDebugEventCode
== EXIT_PROCESS_DEBUG_EVENT
)
2909 target_mourn_inferior (inferior_ptid
); /* Or just windows_mourn_inferior? */
2913 windows_nat_target::close ()
2915 DEBUG_EVENTS (("gdb: windows_close, inferior_ptid=%d\n",
2916 inferior_ptid
.pid ()));
2919 /* Convert pid to printable format. */
2921 windows_nat_target::pid_to_str (ptid_t ptid
)
2923 if (ptid
.tid () != 0)
2924 return string_printf ("Thread %d.0x%lx", ptid
.pid (), ptid
.tid ());
2926 return normal_pid_to_str (ptid
);
2929 static enum target_xfer_status
2930 windows_xfer_shared_libraries (struct target_ops
*ops
,
2931 enum target_object object
, const char *annex
,
2932 gdb_byte
*readbuf
, const gdb_byte
*writebuf
,
2933 ULONGEST offset
, ULONGEST len
,
2934 ULONGEST
*xfered_len
)
2936 struct obstack obstack
;
2942 return TARGET_XFER_E_IO
;
2944 obstack_init (&obstack
);
2945 obstack_grow_str (&obstack
, "<library-list>\n");
2946 for (so
= solib_start
.next
; so
; so
= so
->next
)
2948 lm_info_windows
*li
= (lm_info_windows
*) so
->lm_info
;
2950 windows_xfer_shared_library (so
->so_name
, (CORE_ADDR
)
2951 (uintptr_t) li
->load_addr
,
2952 target_gdbarch (), &obstack
);
2954 obstack_grow_str0 (&obstack
, "</library-list>\n");
2956 buf
= (const char *) obstack_finish (&obstack
);
2957 len_avail
= strlen (buf
);
2958 if (offset
>= len_avail
)
2962 if (len
> len_avail
- offset
)
2963 len
= len_avail
- offset
;
2964 memcpy (readbuf
, buf
+ offset
, len
);
2967 obstack_free (&obstack
, NULL
);
2968 *xfered_len
= (ULONGEST
) len
;
2969 return len
!= 0 ? TARGET_XFER_OK
: TARGET_XFER_EOF
;
2972 enum target_xfer_status
2973 windows_nat_target::xfer_partial (enum target_object object
,
2974 const char *annex
, gdb_byte
*readbuf
,
2975 const gdb_byte
*writebuf
, ULONGEST offset
,
2976 ULONGEST len
, ULONGEST
*xfered_len
)
2980 case TARGET_OBJECT_MEMORY
:
2981 return windows_xfer_memory (readbuf
, writebuf
, offset
, len
, xfered_len
);
2983 case TARGET_OBJECT_LIBRARIES
:
2984 return windows_xfer_shared_libraries (this, object
, annex
, readbuf
,
2985 writebuf
, offset
, len
, xfered_len
);
2988 if (beneath () == NULL
)
2990 /* This can happen when requesting the transfer of unsupported
2991 objects before a program has been started (and therefore
2992 with the current_target having no target beneath). */
2993 return TARGET_XFER_E_IO
;
2995 return beneath ()->xfer_partial (object
, annex
,
2996 readbuf
, writebuf
, offset
, len
,
3001 /* Provide thread local base, i.e. Thread Information Block address.
3002 Returns 1 if ptid is found and sets *ADDR to thread_local_base. */
3005 windows_nat_target::get_tib_address (ptid_t ptid
, CORE_ADDR
*addr
)
3007 windows_thread_info
*th
;
3009 th
= thread_rec (ptid
.tid (), 0);
3014 *addr
= th
->thread_local_base
;
3020 windows_nat_target::get_ada_task_ptid (long lwp
, long thread
)
3022 return ptid_t (inferior_ptid
.pid (), 0, lwp
);
3025 /* Implementation of the to_thread_name method. */
3028 windows_nat_target::thread_name (struct thread_info
*thr
)
3030 return thread_rec (thr
->ptid
.tid (), 0)->name
;
3035 _initialize_windows_nat (void)
3037 x86_dr_low
.set_control
= cygwin_set_dr7
;
3038 x86_dr_low
.set_addr
= cygwin_set_dr
;
3039 x86_dr_low
.get_addr
= cygwin_get_dr
;
3040 x86_dr_low
.get_status
= cygwin_get_dr6
;
3041 x86_dr_low
.get_control
= cygwin_get_dr7
;
3043 /* x86_dr_low.debug_register_length field is set by
3044 calling x86_set_debug_register_length function
3045 in processor windows specific native file. */
3047 add_inf_child_target (&the_windows_nat_target
);
3050 cygwin_internal (CW_SET_DOS_FILE_WARNING
, 0);
3053 add_com ("signal-event", class_run
, signal_event_command
, _("\
3054 Signal a crashed process with event ID, to allow its debugging.\n\
3055 This command is needed in support of setting up GDB as JIT debugger on \
3056 MS-Windows. The command should be invoked from the GDB command line using \
3057 the '-ex' command-line option. The ID of the event that blocks the \
3058 crashed process will be supplied by the Windows JIT debugging mechanism."));
3061 add_setshow_boolean_cmd ("shell", class_support
, &useshell
, _("\
3062 Set use of shell to start subprocess."), _("\
3063 Show use of shell to start subprocess."), NULL
,
3065 NULL
, /* FIXME: i18n: */
3066 &setlist
, &showlist
);
3068 add_setshow_boolean_cmd ("cygwin-exceptions", class_support
,
3069 &cygwin_exceptions
, _("\
3070 Break when an exception is detected in the Cygwin DLL itself."), _("\
3071 Show whether gdb breaks on exceptions in the Cygwin DLL itself."), NULL
,
3073 NULL
, /* FIXME: i18n: */
3074 &setlist
, &showlist
);
3077 add_setshow_boolean_cmd ("new-console", class_support
, &new_console
, _("\
3078 Set creation of new console when creating child process."), _("\
3079 Show creation of new console when creating child process."), NULL
,
3081 NULL
, /* FIXME: i18n: */
3082 &setlist
, &showlist
);
3084 add_setshow_boolean_cmd ("new-group", class_support
, &new_group
, _("\
3085 Set creation of new group when creating child process."), _("\
3086 Show creation of new group when creating child process."), NULL
,
3088 NULL
, /* FIXME: i18n: */
3089 &setlist
, &showlist
);
3091 add_setshow_boolean_cmd ("debugexec", class_support
, &debug_exec
, _("\
3092 Set whether to display execution in child process."), _("\
3093 Show whether to display execution in child process."), NULL
,
3095 NULL
, /* FIXME: i18n: */
3096 &setlist
, &showlist
);
3098 add_setshow_boolean_cmd ("debugevents", class_support
, &debug_events
, _("\
3099 Set whether to display kernel events in child process."), _("\
3100 Show whether to display kernel events in child process."), NULL
,
3102 NULL
, /* FIXME: i18n: */
3103 &setlist
, &showlist
);
3105 add_setshow_boolean_cmd ("debugmemory", class_support
, &debug_memory
, _("\
3106 Set whether to display memory accesses in child process."), _("\
3107 Show whether to display memory accesses in child process."), NULL
,
3109 NULL
, /* FIXME: i18n: */
3110 &setlist
, &showlist
);
3112 add_setshow_boolean_cmd ("debugexceptions", class_support
,
3113 &debug_exceptions
, _("\
3114 Set whether to display kernel exceptions in child process."), _("\
3115 Show whether to display kernel exceptions in child process."), NULL
,
3117 NULL
, /* FIXME: i18n: */
3118 &setlist
, &showlist
);
3120 init_w32_command_list ();
3122 add_cmd ("selector", class_info
, display_selectors
,
3123 _("Display selectors infos."),
3127 /* Hardware watchpoint support, adapted from go32-nat.c code. */
3129 /* Pass the address ADDR to the inferior in the I'th debug register.
3130 Here we just store the address in dr array, the registers will be
3131 actually set up when windows_continue is called. */
3133 cygwin_set_dr (int i
, CORE_ADDR addr
)
3136 internal_error (__FILE__
, __LINE__
,
3137 _("Invalid register %d in cygwin_set_dr.\n"), i
);
3139 debug_registers_changed
= 1;
3140 debug_registers_used
= 1;
3143 /* Pass the value VAL to the inferior in the DR7 debug control
3144 register. Here we just store the address in D_REGS, the watchpoint
3145 will be actually set up in windows_wait. */
3147 cygwin_set_dr7 (unsigned long val
)
3149 dr
[7] = (CORE_ADDR
) val
;
3150 debug_registers_changed
= 1;
3151 debug_registers_used
= 1;
3154 /* Get the value of debug register I from the inferior. */
3157 cygwin_get_dr (int i
)
3162 /* Get the value of the DR6 debug status register from the inferior.
3163 Here we just return the value stored in dr[6]
3164 by the last call to thread_rec for current_event.dwThreadId id. */
3165 static unsigned long
3166 cygwin_get_dr6 (void)
3168 return (unsigned long) dr
[6];
3171 /* Get the value of the DR7 debug status register from the inferior.
3172 Here we just return the value stored in dr[7] by the last call to
3173 thread_rec for current_event.dwThreadId id. */
3175 static unsigned long
3176 cygwin_get_dr7 (void)
3178 return (unsigned long) dr
[7];
3181 /* Determine if the thread referenced by "ptid" is alive
3182 by "polling" it. If WaitForSingleObject returns WAIT_OBJECT_0
3183 it means that the thread has died. Otherwise it is assumed to be alive. */
3186 windows_nat_target::thread_alive (ptid_t ptid
)
3190 gdb_assert (ptid
.tid () != 0);
3193 return WaitForSingleObject (thread_rec (tid
, FALSE
)->h
, 0) != WAIT_OBJECT_0
;
3197 _initialize_check_for_gdb_ini (void)
3200 if (inhibit_gdbinit
)
3203 homedir
= getenv ("HOME");
3207 char *oldini
= (char *) alloca (strlen (homedir
) +
3208 sizeof ("gdb.ini") + 1);
3209 strcpy (oldini
, homedir
);
3210 p
= strchr (oldini
, '\0');
3211 if (p
> oldini
&& !IS_DIR_SEPARATOR (p
[-1]))
3213 strcpy (p
, "gdb.ini");
3214 if (access (oldini
, 0) == 0)
3216 int len
= strlen (oldini
);
3217 char *newini
= (char *) alloca (len
+ 2);
3219 xsnprintf (newini
, len
+ 2, "%.*s.gdbinit",
3220 (int) (len
- (sizeof ("gdb.ini") - 1)), oldini
);
3221 warning (_("obsolete '%s' found. Rename to '%s'."), oldini
, newini
);
3226 /* Define dummy functions which always return error for the rare cases where
3227 these functions could not be found. */
3229 bad_DebugActiveProcessStop (DWORD w
)
3234 bad_DebugBreakProcess (HANDLE w
)
3239 bad_DebugSetProcessKillOnExit (BOOL w
)
3244 bad_EnumProcessModules (HANDLE w
, HMODULE
*x
, DWORD y
, LPDWORD z
)
3251 bad_GetModuleFileNameExW (HANDLE w
, HMODULE x
, LPWSTR y
, DWORD z
)
3257 bad_GetModuleFileNameExA (HANDLE w
, HMODULE x
, LPSTR y
, DWORD z
)
3264 bad_GetModuleInformation (HANDLE w
, HMODULE x
, LPMODULEINFO y
, DWORD z
)
3270 bad_OpenProcessToken (HANDLE w
, DWORD x
, PHANDLE y
)
3276 bad_GetCurrentConsoleFont (HANDLE w
, BOOL bMaxWindow
, CONSOLE_FONT_INFO
*f
)
3282 bad_GetConsoleFontSize (HANDLE w
, DWORD nFont
)
3290 /* Load any functions which may not be available in ancient versions
3294 _initialize_loadable (void)
3298 #define GPA(m, func) \
3299 func = (func ## _ftype *) GetProcAddress (m, #func)
3301 hm
= LoadLibrary ("kernel32.dll");
3304 GPA (hm
, DebugActiveProcessStop
);
3305 GPA (hm
, DebugBreakProcess
);
3306 GPA (hm
, DebugSetProcessKillOnExit
);
3307 GPA (hm
, GetConsoleFontSize
);
3308 GPA (hm
, DebugActiveProcessStop
);
3309 GPA (hm
, GetCurrentConsoleFont
);
3312 /* Set variables to dummy versions of these processes if the function
3313 wasn't found in kernel32.dll. */
3314 if (!DebugBreakProcess
)
3315 DebugBreakProcess
= bad_DebugBreakProcess
;
3316 if (!DebugActiveProcessStop
|| !DebugSetProcessKillOnExit
)
3318 DebugActiveProcessStop
= bad_DebugActiveProcessStop
;
3319 DebugSetProcessKillOnExit
= bad_DebugSetProcessKillOnExit
;
3321 if (!GetConsoleFontSize
)
3322 GetConsoleFontSize
= bad_GetConsoleFontSize
;
3323 if (!GetCurrentConsoleFont
)
3324 GetCurrentConsoleFont
= bad_GetCurrentConsoleFont
;
3326 /* Load optional functions used for retrieving filename information
3327 associated with the currently debugged process or its dlls. */
3328 hm
= LoadLibrary ("psapi.dll");
3331 GPA (hm
, EnumProcessModules
);
3332 GPA (hm
, GetModuleInformation
);
3333 GetModuleFileNameEx
= (GetModuleFileNameEx_ftype
*)
3334 GetProcAddress (hm
, GetModuleFileNameEx_name
);
3337 if (!EnumProcessModules
|| !GetModuleInformation
|| !GetModuleFileNameEx
)
3339 /* Set variables to dummy versions of these processes if the function
3340 wasn't found in psapi.dll. */
3341 EnumProcessModules
= bad_EnumProcessModules
;
3342 GetModuleInformation
= bad_GetModuleInformation
;
3343 GetModuleFileNameEx
= bad_GetModuleFileNameEx
;
3344 /* This will probably fail on Windows 9x/Me. Let the user know
3345 that we're missing some functionality. */
3347 cannot automatically find executable file or library to read symbols.\n\
3348 Use \"file\" or \"dll\" command to load executable/libraries directly."));
3351 hm
= LoadLibrary ("advapi32.dll");
3354 GPA (hm
, OpenProcessToken
);
3355 GPA (hm
, LookupPrivilegeValueA
);
3356 GPA (hm
, AdjustTokenPrivileges
);
3357 /* Only need to set one of these since if OpenProcessToken fails nothing
3359 if (!OpenProcessToken
|| !LookupPrivilegeValueA
3360 || !AdjustTokenPrivileges
)
3361 OpenProcessToken
= bad_OpenProcessToken
;