1 /* SPU native-dependent code for GDB, the GNU debugger.
2 Copyright (C) 2006-2014 Free Software Foundation, Inc.
4 Contributed by Ulrich Weigand <uweigand@de.ibm.com>.
6 This file is part of GDB.
8 This program is free software; you can redistribute it and/or modify
9 it under the terms of the GNU General Public License as published by
10 the Free Software Foundation; either version 3 of the License, or
11 (at your option) any later version.
13 This program is distributed in the hope that it will be useful,
14 but WITHOUT ANY WARRANTY; without even the implied warranty of
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 GNU General Public License for more details.
18 You should have received a copy of the GNU General Public License
19 along with this program. If not, see <http://www.gnu.org/licenses/>. */
26 #include "inf-child.h"
27 #include "inf-ptrace.h"
31 #include "gdbthread.h"
34 #include <sys/ptrace.h>
35 #include <asm/ptrace.h>
36 #include <sys/types.h>
40 /* PPU side system calls. */
41 #define INSTR_SC 0x44000002
42 #define NR_spu_run 0x0116
45 /* Fetch PPU register REGNO. */
47 fetch_ppc_register (int regno)
51 int tid = ptid_get_lwp (inferior_ptid);
53 tid = ptid_get_pid (inferior_ptid);
56 /* If running as a 32-bit process on a 64-bit system, we attempt
57 to get the full 64-bit register content of the target process.
58 If the PPC special ptrace call fails, we're on a 32-bit system;
59 just fall through to the regular ptrace call in that case. */
64 ptrace (PPC_PTRACE_PEEKUSR_3264, tid,
65 (PTRACE_TYPE_ARG3) (regno * 8), buf);
67 ptrace (PPC_PTRACE_PEEKUSR_3264, tid,
68 (PTRACE_TYPE_ARG3) (regno * 8 + 4), buf + 4);
70 return (ULONGEST) *(uint64_t *)buf;
75 res = ptrace (PT_READ_U, tid,
76 (PTRACE_TYPE_ARG3) (regno * sizeof (PTRACE_TYPE_RET)), 0);
80 xsnprintf (mess, sizeof mess, "reading PPC register #%d", regno);
81 perror_with_name (_(mess));
84 return (ULONGEST) (unsigned long) res;
87 /* Fetch WORD from PPU memory at (aligned) MEMADDR in thread TID. */
89 fetch_ppc_memory_1 (int tid, ULONGEST memaddr, PTRACE_TYPE_RET *word)
96 uint64_t addr_8 = (uint64_t) memaddr;
97 ptrace (PPC_PTRACE_PEEKTEXT_3264, tid, (PTRACE_TYPE_ARG3) &addr_8, word);
101 *word = ptrace (PT_READ_I, tid, (PTRACE_TYPE_ARG3) (size_t) memaddr, 0);
106 /* Store WORD into PPU memory at (aligned) MEMADDR in thread TID. */
108 store_ppc_memory_1 (int tid, ULONGEST memaddr, PTRACE_TYPE_RET word)
112 #ifndef __powerpc64__
115 uint64_t addr_8 = (uint64_t) memaddr;
116 ptrace (PPC_PTRACE_POKEDATA_3264, tid, (PTRACE_TYPE_ARG3) &addr_8, word);
120 ptrace (PT_WRITE_D, tid, (PTRACE_TYPE_ARG3) (size_t) memaddr, word);
125 /* Fetch LEN bytes of PPU memory at MEMADDR to MYADDR. */
127 fetch_ppc_memory (ULONGEST memaddr, gdb_byte *myaddr, int len)
131 ULONGEST addr = memaddr & -(ULONGEST) sizeof (PTRACE_TYPE_RET);
132 int count = ((((memaddr + len) - addr) + sizeof (PTRACE_TYPE_RET) - 1)
133 / sizeof (PTRACE_TYPE_RET));
134 PTRACE_TYPE_RET *buffer;
136 int tid = ptid_get_lwp (inferior_ptid);
138 tid = ptid_get_pid (inferior_ptid);
140 buffer = (PTRACE_TYPE_RET *) alloca (count * sizeof (PTRACE_TYPE_RET));
141 for (i = 0; i < count; i++, addr += sizeof (PTRACE_TYPE_RET))
143 ret = fetch_ppc_memory_1 (tid, addr, &buffer[i]);
149 (char *) buffer + (memaddr & (sizeof (PTRACE_TYPE_RET) - 1)),
155 /* Store LEN bytes from MYADDR to PPU memory at MEMADDR. */
157 store_ppc_memory (ULONGEST memaddr, const gdb_byte *myaddr, int len)
161 ULONGEST addr = memaddr & -(ULONGEST) sizeof (PTRACE_TYPE_RET);
162 int count = ((((memaddr + len) - addr) + sizeof (PTRACE_TYPE_RET) - 1)
163 / sizeof (PTRACE_TYPE_RET));
164 PTRACE_TYPE_RET *buffer;
166 int tid = ptid_get_lwp (inferior_ptid);
168 tid = ptid_get_pid (inferior_ptid);
170 buffer = (PTRACE_TYPE_RET *) alloca (count * sizeof (PTRACE_TYPE_RET));
172 if (addr != memaddr || len < (int) sizeof (PTRACE_TYPE_RET))
174 ret = fetch_ppc_memory_1 (tid, addr, &buffer[0]);
181 ret = fetch_ppc_memory_1 (tid, addr + (count - 1)
182 * sizeof (PTRACE_TYPE_RET),
188 memcpy ((char *) buffer + (memaddr & (sizeof (PTRACE_TYPE_RET) - 1)),
191 for (i = 0; i < count; i++, addr += sizeof (PTRACE_TYPE_RET))
193 ret = store_ppc_memory_1 (tid, addr, buffer[i]);
202 /* If the PPU thread is currently stopped on a spu_run system call,
203 return to FD and ADDR the file handle and NPC parameter address
204 used with the system call. Return non-zero if successful. */
206 parse_spufs_run (int *fd, ULONGEST *addr)
208 enum bfd_endian byte_order = gdbarch_byte_order (target_gdbarch ());
210 ULONGEST pc = fetch_ppc_register (32); /* nip */
212 /* Fetch instruction preceding current NIP. */
213 if (fetch_ppc_memory (pc-4, buf, 4) != 0)
215 /* It should be a "sc" instruction. */
216 if (extract_unsigned_integer (buf, 4, byte_order) != INSTR_SC)
218 /* System call number should be NR_spu_run. */
219 if (fetch_ppc_register (0) != NR_spu_run)
222 /* Register 3 contains fd, register 4 the NPC param pointer. */
223 *fd = fetch_ppc_register (34); /* orig_gpr3 */
224 *addr = fetch_ppc_register (4);
229 /* Implement the to_xfer_partial target_ops method for TARGET_OBJECT_SPU.
230 Copy LEN bytes at OFFSET in spufs file ANNEX into/from READBUF or WRITEBUF,
231 using the /proc file system. */
233 static enum target_xfer_status
234 spu_proc_xfer_spu (const char *annex, gdb_byte *readbuf,
235 const gdb_byte *writebuf,
236 ULONGEST offset, ULONGEST len, ULONGEST *xfered_len)
241 int pid = ptid_get_pid (inferior_ptid);
244 return TARGET_XFER_EOF;
246 xsnprintf (buf, sizeof buf, "/proc/%d/fd/%s", pid, annex);
247 fd = open (buf, writebuf? O_WRONLY : O_RDONLY);
249 return TARGET_XFER_E_IO;
252 && lseek (fd, (off_t) offset, SEEK_SET) != (off_t) offset)
255 return TARGET_XFER_EOF;
259 ret = write (fd, writebuf, (size_t) len);
261 ret = read (fd, readbuf, (size_t) len);
265 return TARGET_XFER_E_IO;
267 return TARGET_XFER_EOF;
270 *xfered_len = (ULONGEST) ret;
271 return TARGET_XFER_OK;
276 /* Inferior memory should contain an SPE executable image at location ADDR.
277 Allocate a BFD representing that executable. Return NULL on error. */
280 spu_bfd_iovec_open (struct bfd *nbfd, void *open_closure)
286 spu_bfd_iovec_close (struct bfd *nbfd, void *stream)
290 /* Zero means success. */
295 spu_bfd_iovec_pread (struct bfd *abfd, void *stream, void *buf,
296 file_ptr nbytes, file_ptr offset)
298 ULONGEST addr = *(ULONGEST *)stream;
300 if (fetch_ppc_memory (addr + offset, buf, nbytes) != 0)
302 bfd_set_error (bfd_error_invalid_operation);
310 spu_bfd_iovec_stat (struct bfd *abfd, void *stream, struct stat *sb)
312 /* We don't have an easy way of finding the size of embedded spu
313 images. We could parse the in-memory ELF header and section
314 table to find the extent of the last section but that seems
315 pointless when the size is needed only for checks of other
316 parsed values in dbxread.c. */
317 sb->st_size = INT_MAX;
322 spu_bfd_open (ULONGEST addr)
327 ULONGEST *open_closure = xmalloc (sizeof (ULONGEST));
328 *open_closure = addr;
330 nbfd = gdb_bfd_openr_iovec ("<in-memory>", "elf32-spu",
331 spu_bfd_iovec_open, open_closure,
332 spu_bfd_iovec_pread, spu_bfd_iovec_close,
337 if (!bfd_check_format (nbfd, bfd_object))
339 gdb_bfd_unref (nbfd);
343 /* Retrieve SPU name note and update BFD name. */
344 spu_name = bfd_get_section_by_name (nbfd, ".note.spu_name");
347 int sect_size = bfd_section_size (nbfd, spu_name);
350 char *buf = alloca (sect_size - 20 + 1);
351 bfd_get_section_contents (nbfd, spu_name, buf, 20, sect_size - 20);
352 buf[sect_size - 20] = '\0';
354 xfree ((char *)nbfd->filename);
355 nbfd->filename = xstrdup (buf);
362 /* INFERIOR_FD is a file handle passed by the inferior to the
363 spu_run system call. Assuming the SPE context was allocated
364 by the libspe library, try to retrieve the main SPE executable
365 file from its copy within the target process. */
367 spu_symbol_file_add_from_memory (int inferior_fd)
375 enum target_xfer_status status;
377 /* Read object ID. */
378 xsnprintf (annex, sizeof annex, "%d/object-id", inferior_fd);
379 status = spu_proc_xfer_spu (annex, id, NULL, 0, sizeof id, &len);
380 if (status != TARGET_XFER_OK || len >= sizeof id)
383 addr = strtoulst ((const char *) id, NULL, 16);
387 /* Open BFD representing SPE executable and read its symbols. */
388 nbfd = spu_bfd_open (addr);
391 struct cleanup *cleanup = make_cleanup_bfd_unref (nbfd);
393 symbol_file_add_from_bfd (nbfd, bfd_get_filename (nbfd),
394 SYMFILE_VERBOSE | SYMFILE_MAINLINE,
396 do_cleanups (cleanup);
401 /* Override the post_startup_inferior routine to continue running
402 the inferior until the first spu_run system call. */
404 spu_child_post_startup_inferior (struct target_ops *self, ptid_t ptid)
409 int tid = ptid_get_lwp (ptid);
411 tid = ptid_get_pid (ptid);
413 while (!parse_spufs_run (&fd, &addr))
415 ptrace (PT_SYSCALL, tid, (PTRACE_TYPE_ARG3) 0, 0);
416 waitpid (tid, NULL, __WALL | __WNOTHREAD);
420 /* Override the post_attach routine to try load the SPE executable
421 file image from its copy inside the target process. */
423 spu_child_post_attach (struct target_ops *self, int pid)
428 /* Like child_post_startup_inferior, if we happened to attach to
429 the inferior while it wasn't currently in spu_run, continue
430 running it until we get back there. */
431 while (!parse_spufs_run (&fd, &addr))
433 ptrace (PT_SYSCALL, pid, (PTRACE_TYPE_ARG3) 0, 0);
434 waitpid (pid, NULL, __WALL | __WNOTHREAD);
437 /* If the user has not provided an executable file, try to extract
438 the image from inside the target process. */
439 if (!get_exec_file (0))
440 spu_symbol_file_add_from_memory (fd);
443 /* Wait for child PTID to do something. Return id of the child,
444 minus_one_ptid in case of error; store status into *OURSTATUS. */
446 spu_child_wait (struct target_ops *ops,
447 ptid_t ptid, struct target_waitstatus *ourstatus, int options)
455 set_sigint_trap (); /* Causes SIGINT to be passed on to the
458 pid = waitpid (ptid_get_pid (ptid), &status, 0);
459 if (pid == -1 && errno == ECHILD)
460 /* Try again with __WCLONE to check cloned processes. */
461 pid = waitpid (ptid_get_pid (ptid), &status, __WCLONE);
465 /* Make sure we don't report an event for the exit of the
466 original program, if we've detached from it. */
467 if (pid != -1 && !WIFSTOPPED (status)
468 && pid != ptid_get_pid (inferior_ptid))
474 clear_sigint_trap ();
476 while (pid == -1 && save_errno == EINTR);
480 warning (_("Child process unexpectedly missing: %s"),
481 safe_strerror (save_errno));
483 /* Claim it exited with unknown signal. */
484 ourstatus->kind = TARGET_WAITKIND_SIGNALLED;
485 ourstatus->value.sig = GDB_SIGNAL_UNKNOWN;
486 return inferior_ptid;
489 store_waitstatus (ourstatus, status);
490 return pid_to_ptid (pid);
493 /* Override the fetch_inferior_register routine. */
495 spu_fetch_inferior_registers (struct target_ops *ops,
496 struct regcache *regcache, int regno)
501 /* We must be stopped on a spu_run system call. */
502 if (!parse_spufs_run (&fd, &addr))
505 /* The ID register holds the spufs file handle. */
506 if (regno == -1 || regno == SPU_ID_REGNUM)
508 struct gdbarch *gdbarch = get_regcache_arch (regcache);
509 enum bfd_endian byte_order = gdbarch_byte_order (gdbarch);
511 store_unsigned_integer (buf, 4, byte_order, fd);
512 regcache_raw_supply (regcache, SPU_ID_REGNUM, buf);
515 /* The NPC register is found at ADDR. */
516 if (regno == -1 || regno == SPU_PC_REGNUM)
519 if (fetch_ppc_memory (addr, buf, 4) == 0)
520 regcache_raw_supply (regcache, SPU_PC_REGNUM, buf);
523 /* The GPRs are found in the "regs" spufs file. */
524 if (regno == -1 || (regno >= 0 && regno < SPU_NUM_GPRS))
526 gdb_byte buf[16 * SPU_NUM_GPRS];
531 xsnprintf (annex, sizeof annex, "%d/regs", fd);
532 if ((spu_proc_xfer_spu (annex, buf, NULL, 0, sizeof buf, &len)
534 && len == sizeof buf)
535 for (i = 0; i < SPU_NUM_GPRS; i++)
536 regcache_raw_supply (regcache, i, buf + i*16);
540 /* Override the store_inferior_register routine. */
542 spu_store_inferior_registers (struct target_ops *ops,
543 struct regcache *regcache, int regno)
548 /* We must be stopped on a spu_run system call. */
549 if (!parse_spufs_run (&fd, &addr))
552 /* The NPC register is found at ADDR. */
553 if (regno == -1 || regno == SPU_PC_REGNUM)
556 regcache_raw_collect (regcache, SPU_PC_REGNUM, buf);
557 store_ppc_memory (addr, buf, 4);
560 /* The GPRs are found in the "regs" spufs file. */
561 if (regno == -1 || (regno >= 0 && regno < SPU_NUM_GPRS))
563 gdb_byte buf[16 * SPU_NUM_GPRS];
568 for (i = 0; i < SPU_NUM_GPRS; i++)
569 regcache_raw_collect (regcache, i, buf + i*16);
571 xsnprintf (annex, sizeof annex, "%d/regs", fd);
572 spu_proc_xfer_spu (annex, NULL, buf, 0, sizeof buf, &len);
576 /* Override the to_xfer_partial routine. */
577 static enum target_xfer_status
578 spu_xfer_partial (struct target_ops *ops,
579 enum target_object object, const char *annex,
580 gdb_byte *readbuf, const gdb_byte *writebuf,
581 ULONGEST offset, ULONGEST len, ULONGEST *xfered_len)
583 if (object == TARGET_OBJECT_SPU)
584 return spu_proc_xfer_spu (annex, readbuf, writebuf, offset, len,
587 if (object == TARGET_OBJECT_MEMORY)
591 char mem_annex[32], lslr_annex[32];
594 enum target_xfer_status ret;
596 /* We must be stopped on a spu_run system call. */
597 if (!parse_spufs_run (&fd, &addr))
598 return TARGET_XFER_EOF;
600 /* Use the "mem" spufs file to access SPU local store. */
601 xsnprintf (mem_annex, sizeof mem_annex, "%d/mem", fd);
602 ret = spu_proc_xfer_spu (mem_annex, readbuf, writebuf, offset, len,
604 if (ret == TARGET_XFER_OK)
607 /* SPU local store access wraps the address around at the
608 local store limit. We emulate this here. To avoid needing
609 an extra access to retrieve the LSLR, we only do that after
610 trying the original address first, and getting end-of-file. */
611 xsnprintf (lslr_annex, sizeof lslr_annex, "%d/lslr", fd);
612 memset (buf, 0, sizeof buf);
613 if (spu_proc_xfer_spu (lslr_annex, buf, NULL, 0, sizeof buf, xfered_len)
617 lslr = strtoulst ((const char *) buf, NULL, 16);
618 return spu_proc_xfer_spu (mem_annex, readbuf, writebuf,
619 offset & lslr, len, xfered_len);
622 return TARGET_XFER_E_IO;
625 /* Override the to_can_use_hw_breakpoint routine. */
627 spu_can_use_hw_breakpoint (struct target_ops *self,
628 int type, int cnt, int othertype)
633 /* -Wmissing-prototypes */
634 extern initialize_file_ftype _initialize_spu_nat;
636 /* Initialize SPU native target. */
638 _initialize_spu_nat (void)
640 /* Generic ptrace methods. */
641 struct target_ops *t;
642 t = inf_ptrace_target ();
644 /* Add SPU methods. */
645 t->to_post_attach = spu_child_post_attach;
646 t->to_post_startup_inferior = spu_child_post_startup_inferior;
647 t->to_wait = spu_child_wait;
648 t->to_fetch_registers = spu_fetch_inferior_registers;
649 t->to_store_registers = spu_store_inferior_registers;
650 t->to_xfer_partial = spu_xfer_partial;
651 t->to_can_use_hw_breakpoint = spu_can_use_hw_breakpoint;
653 /* Register SPU target. */