1 /* Base/prototype target for default child (native) targets.
3 Copyright (C) 1988-2014 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 /* This file provides a common base class/target that all native
21 target implementations extend, by calling inf_child_target to get a
22 new prototype target and then overriding target methods as
33 #include "inf-child.h"
34 #include "gdb/fileio.h"
37 #include "filestuff.h"
39 #include <sys/types.h>
43 /* A pointer to what is returned by inf_child_target. Used by
44 inf_child_open to push the most-derived target in reaction to
46 static struct target_ops *inf_child_ops = NULL;
48 /* Helper function for child_wait and the derivatives of child_wait.
49 HOSTSTATUS is the waitstatus from wait() or the equivalent; store our
50 translation of that in OURSTATUS. */
52 store_waitstatus (struct target_waitstatus *ourstatus, int hoststatus)
54 if (WIFEXITED (hoststatus))
56 ourstatus->kind = TARGET_WAITKIND_EXITED;
57 ourstatus->value.integer = WEXITSTATUS (hoststatus);
59 else if (!WIFSTOPPED (hoststatus))
61 ourstatus->kind = TARGET_WAITKIND_SIGNALLED;
62 ourstatus->value.sig = gdb_signal_from_host (WTERMSIG (hoststatus));
66 ourstatus->kind = TARGET_WAITKIND_STOPPED;
67 ourstatus->value.sig = gdb_signal_from_host (WSTOPSIG (hoststatus));
71 /* Fetch register REGNUM from the inferior. If REGNUM is -1, do this
75 inf_child_fetch_inferior_registers (struct target_ops *ops,
76 struct regcache *regcache, int regnum)
81 regnum < gdbarch_num_regs (get_regcache_arch (regcache));
83 regcache_raw_supply (regcache, regnum, NULL);
86 regcache_raw_supply (regcache, regnum, NULL);
89 /* Store register REGNUM back into the inferior. If REGNUM is -1, do
90 this for all registers (including the floating point registers). */
93 inf_child_store_inferior_registers (struct target_ops *ops,
94 struct regcache *regcache, int regnum)
99 inf_child_post_attach (struct target_ops *self, int pid)
101 /* This target doesn't require a meaningful "post attach" operation
105 /* Get ready to modify the registers array. On machines which store
106 individual registers, this doesn't need to do anything. On
107 machines which store all the registers in one fell swoop, this
108 makes sure that registers contains all the registers from the
109 program being debugged. */
112 inf_child_prepare_to_store (struct target_ops *self,
113 struct regcache *regcache)
117 /* True if the user did "target native". In that case, we won't
118 unpush the child target automatically when the last inferior is
120 static int inf_child_explicitly_opened;
122 /* See inf-child.h. */
125 inf_child_open_target (struct target_ops *target, const char *arg,
128 target_preopen (from_tty);
129 push_target (target);
130 inf_child_explicitly_opened = 1;
132 printf_filtered ("Done. Use the \"run\" command to start a process.\n");
136 inf_child_open (const char *arg, int from_tty)
138 inf_child_open_target (inf_child_ops, arg, from_tty);
141 /* Implement the to_disconnect target_ops method. */
144 inf_child_disconnect (struct target_ops *target, const char *args, int from_tty)
147 error (_("Argument given to \"disconnect\"."));
149 /* This offers to detach/kill current inferiors, and then pops all
151 target_preopen (from_tty);
154 /* Implement the to_close target_ops method. */
157 inf_child_close (struct target_ops *target)
159 /* In case we were forcibly closed. */
160 inf_child_explicitly_opened = 0;
164 inf_child_mourn_inferior (struct target_ops *ops)
166 generic_mourn_inferior ();
167 inf_child_maybe_unpush_target (ops);
170 /* See inf-child.h. */
173 inf_child_maybe_unpush_target (struct target_ops *ops)
175 if (!inf_child_explicitly_opened && !have_inferiors ())
180 inf_child_post_startup_inferior (struct target_ops *self, ptid_t ptid)
182 /* This target doesn't require a meaningful "post startup inferior"
183 operation by a debugger. */
187 inf_child_follow_fork (struct target_ops *ops, int follow_child,
190 /* This target doesn't support following fork or vfork events. */
195 inf_child_can_run (struct target_ops *self)
201 inf_child_pid_to_exec_file (struct target_ops *self, int pid)
203 /* This target doesn't support translation of a process ID to the
204 filename of the executable file. */
209 /* Target file operations. */
212 inf_child_fileio_open_flags_to_host (int fileio_open_flags, int *open_flags_p)
216 if (fileio_open_flags & ~FILEIO_O_SUPPORTED)
219 if (fileio_open_flags & FILEIO_O_CREAT)
220 open_flags |= O_CREAT;
221 if (fileio_open_flags & FILEIO_O_EXCL)
222 open_flags |= O_EXCL;
223 if (fileio_open_flags & FILEIO_O_TRUNC)
224 open_flags |= O_TRUNC;
225 if (fileio_open_flags & FILEIO_O_APPEND)
226 open_flags |= O_APPEND;
227 if (fileio_open_flags & FILEIO_O_RDONLY)
228 open_flags |= O_RDONLY;
229 if (fileio_open_flags & FILEIO_O_WRONLY)
230 open_flags |= O_WRONLY;
231 if (fileio_open_flags & FILEIO_O_RDWR)
232 open_flags |= O_RDWR;
233 /* On systems supporting binary and text mode, always open files in
236 open_flags |= O_BINARY;
239 *open_flags_p = open_flags;
244 inf_child_errno_to_fileio_error (int errnum)
251 return FILEIO_ENOENT;
259 return FILEIO_EACCES;
261 return FILEIO_EFAULT;
265 return FILEIO_EEXIST;
267 return FILEIO_ENODEV;
269 return FILEIO_ENOTDIR;
271 return FILEIO_EISDIR;
273 return FILEIO_EINVAL;
275 return FILEIO_ENFILE;
277 return FILEIO_EMFILE;
281 return FILEIO_ENOSPC;
283 return FILEIO_ESPIPE;
287 return FILEIO_ENOSYS;
289 return FILEIO_ENAMETOOLONG;
291 return FILEIO_EUNKNOWN;
294 /* Open FILENAME on the target, using FLAGS and MODE. Return a
295 target file descriptor, or -1 if an error occurs (and set
298 inf_child_fileio_open (struct target_ops *self,
299 const char *filename, int flags, int mode,
305 if (inf_child_fileio_open_flags_to_host (flags, &nat_flags) == -1)
307 *target_errno = FILEIO_EINVAL;
311 /* We do not need to convert MODE, since the fileio protocol uses
312 the standard values. */
313 fd = gdb_open_cloexec (filename, nat_flags, mode);
315 *target_errno = inf_child_errno_to_fileio_error (errno);
320 /* Write up to LEN bytes from WRITE_BUF to FD on the target.
321 Return the number of bytes written, or -1 if an error occurs
322 (and set *TARGET_ERRNO). */
324 inf_child_fileio_pwrite (struct target_ops *self,
325 int fd, const gdb_byte *write_buf, int len,
326 ULONGEST offset, int *target_errno)
331 ret = pwrite (fd, write_buf, len, (long) offset);
335 /* If we have no pwrite or it failed for this file, use lseek/write. */
338 ret = lseek (fd, (long) offset, SEEK_SET);
340 ret = write (fd, write_buf, len);
344 *target_errno = inf_child_errno_to_fileio_error (errno);
349 /* Read up to LEN bytes FD on the target into READ_BUF.
350 Return the number of bytes read, or -1 if an error occurs
351 (and set *TARGET_ERRNO). */
353 inf_child_fileio_pread (struct target_ops *self,
354 int fd, gdb_byte *read_buf, int len,
355 ULONGEST offset, int *target_errno)
360 ret = pread (fd, read_buf, len, (long) offset);
364 /* If we have no pread or it failed for this file, use lseek/read. */
367 ret = lseek (fd, (long) offset, SEEK_SET);
369 ret = read (fd, read_buf, len);
373 *target_errno = inf_child_errno_to_fileio_error (errno);
378 /* Close FD on the target. Return 0, or -1 if an error occurs
379 (and set *TARGET_ERRNO). */
381 inf_child_fileio_close (struct target_ops *self, int fd, int *target_errno)
387 *target_errno = inf_child_errno_to_fileio_error (errno);
392 /* Unlink FILENAME on the target. Return 0, or -1 if an error
393 occurs (and set *TARGET_ERRNO). */
395 inf_child_fileio_unlink (struct target_ops *self,
396 const char *filename, int *target_errno)
400 ret = unlink (filename);
402 *target_errno = inf_child_errno_to_fileio_error (errno);
407 /* Read value of symbolic link FILENAME on the target. Return a
408 null-terminated string allocated via xmalloc, or NULL if an error
409 occurs (and set *TARGET_ERRNO). */
411 inf_child_fileio_readlink (struct target_ops *self,
412 const char *filename, int *target_errno)
414 /* We support readlink only on systems that also provide a compile-time
415 maximum path length (PATH_MAX), at least for now. */
416 #if defined (HAVE_READLINK) && defined (PATH_MAX)
421 len = readlink (filename, buf, sizeof buf);
424 *target_errno = inf_child_errno_to_fileio_error (errno);
428 ret = xmalloc (len + 1);
429 memcpy (ret, buf, len);
433 *target_errno = FILEIO_ENOSYS;
439 inf_child_use_agent (struct target_ops *self, int use)
441 if (agent_loaded_p ())
451 inf_child_can_use_agent (struct target_ops *self)
453 return agent_loaded_p ();
456 /* Default implementation of the to_can_async_p and
457 to_supports_non_stop methods. */
460 return_zero (struct target_ops *ignore)
466 inf_child_target (void)
468 struct target_ops *t = XCNEW (struct target_ops);
470 t->to_shortname = "native";
471 t->to_longname = "Native process";
472 t->to_doc = "Native process (started by the \"run\" command).";
473 t->to_open = inf_child_open;
474 t->to_close = inf_child_close;
475 t->to_disconnect = inf_child_disconnect;
476 t->to_post_attach = inf_child_post_attach;
477 t->to_fetch_registers = inf_child_fetch_inferior_registers;
478 t->to_store_registers = inf_child_store_inferior_registers;
479 t->to_prepare_to_store = inf_child_prepare_to_store;
480 t->to_insert_breakpoint = memory_insert_breakpoint;
481 t->to_remove_breakpoint = memory_remove_breakpoint;
482 t->to_terminal_init = child_terminal_init;
483 t->to_terminal_inferior = child_terminal_inferior;
484 t->to_terminal_ours_for_output = child_terminal_ours_for_output;
485 t->to_terminal_save_ours = child_terminal_save_ours;
486 t->to_terminal_ours = child_terminal_ours;
487 t->to_terminal_info = child_terminal_info;
488 t->to_post_startup_inferior = inf_child_post_startup_inferior;
489 t->to_follow_fork = inf_child_follow_fork;
490 t->to_can_run = inf_child_can_run;
491 /* We must default these because they must be implemented by any
492 target that can run. */
493 t->to_can_async_p = return_zero;
494 t->to_supports_non_stop = return_zero;
495 t->to_pid_to_exec_file = inf_child_pid_to_exec_file;
496 t->to_stratum = process_stratum;
497 t->to_has_all_memory = default_child_has_all_memory;
498 t->to_has_memory = default_child_has_memory;
499 t->to_has_stack = default_child_has_stack;
500 t->to_has_registers = default_child_has_registers;
501 t->to_has_execution = default_child_has_execution;
502 t->to_fileio_open = inf_child_fileio_open;
503 t->to_fileio_pwrite = inf_child_fileio_pwrite;
504 t->to_fileio_pread = inf_child_fileio_pread;
505 t->to_fileio_close = inf_child_fileio_close;
506 t->to_fileio_unlink = inf_child_fileio_unlink;
507 t->to_fileio_readlink = inf_child_fileio_readlink;
508 t->to_magic = OPS_MAGIC;
509 t->to_use_agent = inf_child_use_agent;
510 t->to_can_use_agent = inf_child_can_use_agent;
512 /* Store a pointer so we can push the most-derived target from