1 /* SPU native-dependent code for GDB, the GNU debugger.
2 Copyright (C) 2006-2012 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/>. */
23 #include "gdb_string.h"
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>
37 #include <sys/param.h>
41 /* PPU side system calls. */
42 #define INSTR_SC 0x44000002
43 #define NR_spu_run 0x0116
46 /* Fetch PPU register REGNO. */
48 fetch_ppc_register (int regno)
52 int tid = TIDGET (inferior_ptid);
54 tid = PIDGET (inferior_ptid);
57 /* If running as a 32-bit process on a 64-bit system, we attempt
58 to get the full 64-bit register content of the target process.
59 If the PPC special ptrace call fails, we're on a 32-bit system;
60 just fall through to the regular ptrace call in that case. */
65 ptrace (PPC_PTRACE_PEEKUSR_3264, tid,
66 (PTRACE_TYPE_ARG3) (regno * 8), buf);
68 ptrace (PPC_PTRACE_PEEKUSR_3264, tid,
69 (PTRACE_TYPE_ARG3) (regno * 8 + 4), buf + 4);
71 return (ULONGEST) *(uint64_t *)buf;
76 res = ptrace (PT_READ_U, tid,
77 (PTRACE_TYPE_ARG3) (regno * sizeof (PTRACE_TYPE_RET)), 0);
81 xsnprintf (mess, sizeof mess, "reading PPC register #%d", regno);
82 perror_with_name (_(mess));
85 return (ULONGEST) (unsigned long) res;
88 /* Fetch WORD from PPU memory at (aligned) MEMADDR in thread TID. */
90 fetch_ppc_memory_1 (int tid, ULONGEST memaddr, PTRACE_TYPE_RET *word)
97 uint64_t addr_8 = (uint64_t) memaddr;
98 ptrace (PPC_PTRACE_PEEKTEXT_3264, tid, (PTRACE_TYPE_ARG3) &addr_8, word);
102 *word = ptrace (PT_READ_I, tid, (PTRACE_TYPE_ARG3) (size_t) memaddr, 0);
107 /* Store WORD into PPU memory at (aligned) MEMADDR in thread TID. */
109 store_ppc_memory_1 (int tid, ULONGEST memaddr, PTRACE_TYPE_RET word)
113 #ifndef __powerpc64__
116 uint64_t addr_8 = (uint64_t) memaddr;
117 ptrace (PPC_PTRACE_POKEDATA_3264, tid, (PTRACE_TYPE_ARG3) &addr_8, word);
121 ptrace (PT_WRITE_D, tid, (PTRACE_TYPE_ARG3) (size_t) memaddr, word);
126 /* Fetch LEN bytes of PPU memory at MEMADDR to MYADDR. */
128 fetch_ppc_memory (ULONGEST memaddr, gdb_byte *myaddr, int len)
132 ULONGEST addr = memaddr & -(ULONGEST) sizeof (PTRACE_TYPE_RET);
133 int count = ((((memaddr + len) - addr) + sizeof (PTRACE_TYPE_RET) - 1)
134 / sizeof (PTRACE_TYPE_RET));
135 PTRACE_TYPE_RET *buffer;
137 int tid = TIDGET (inferior_ptid);
139 tid = PIDGET (inferior_ptid);
141 buffer = (PTRACE_TYPE_RET *) alloca (count * sizeof (PTRACE_TYPE_RET));
142 for (i = 0; i < count; i++, addr += sizeof (PTRACE_TYPE_RET))
144 ret = fetch_ppc_memory_1 (tid, addr, &buffer[i]);
150 (char *) buffer + (memaddr & (sizeof (PTRACE_TYPE_RET) - 1)),
156 /* Store LEN bytes from MYADDR to PPU memory at MEMADDR. */
158 store_ppc_memory (ULONGEST memaddr, const gdb_byte *myaddr, int len)
162 ULONGEST addr = memaddr & -(ULONGEST) sizeof (PTRACE_TYPE_RET);
163 int count = ((((memaddr + len) - addr) + sizeof (PTRACE_TYPE_RET) - 1)
164 / sizeof (PTRACE_TYPE_RET));
165 PTRACE_TYPE_RET *buffer;
167 int tid = TIDGET (inferior_ptid);
169 tid = PIDGET (inferior_ptid);
171 buffer = (PTRACE_TYPE_RET *) alloca (count * sizeof (PTRACE_TYPE_RET));
173 if (addr != memaddr || len < (int) sizeof (PTRACE_TYPE_RET))
175 ret = fetch_ppc_memory_1 (tid, addr, &buffer[0]);
182 ret = fetch_ppc_memory_1 (tid, addr + (count - 1)
183 * sizeof (PTRACE_TYPE_RET),
189 memcpy ((char *) buffer + (memaddr & (sizeof (PTRACE_TYPE_RET) - 1)),
192 for (i = 0; i < count; i++, addr += sizeof (PTRACE_TYPE_RET))
194 ret = store_ppc_memory_1 (tid, addr, buffer[i]);
203 /* If the PPU thread is currently stopped on a spu_run system call,
204 return to FD and ADDR the file handle and NPC parameter address
205 used with the system call. Return non-zero if successful. */
207 parse_spufs_run (int *fd, ULONGEST *addr)
209 enum bfd_endian byte_order = gdbarch_byte_order (target_gdbarch ());
211 ULONGEST pc = fetch_ppc_register (32); /* nip */
213 /* Fetch instruction preceding current NIP. */
214 if (fetch_ppc_memory (pc-4, buf, 4) != 0)
216 /* It should be a "sc" instruction. */
217 if (extract_unsigned_integer (buf, 4, byte_order) != INSTR_SC)
219 /* System call number should be NR_spu_run. */
220 if (fetch_ppc_register (0) != NR_spu_run)
223 /* Register 3 contains fd, register 4 the NPC param pointer. */
224 *fd = fetch_ppc_register (34); /* orig_gpr3 */
225 *addr = fetch_ppc_register (4);
230 /* Copy LEN bytes at OFFSET in spufs file ANNEX into/from READBUF or WRITEBUF,
231 using the /proc file system. */
233 spu_proc_xfer_spu (const char *annex, gdb_byte *readbuf,
234 const gdb_byte *writebuf,
235 ULONGEST offset, LONGEST len)
240 int pid = PIDGET (inferior_ptid);
245 xsnprintf (buf, sizeof buf, "/proc/%d/fd/%s", pid, annex);
246 fd = open (buf, writebuf? O_WRONLY : O_RDONLY);
251 && lseek (fd, (off_t) offset, SEEK_SET) != (off_t) offset)
258 ret = write (fd, writebuf, (size_t) len);
260 ret = read (fd, readbuf, (size_t) len);
267 /* Inferior memory should contain an SPE executable image at location ADDR.
268 Allocate a BFD representing that executable. Return NULL on error. */
271 spu_bfd_iovec_open (struct bfd *nbfd, void *open_closure)
277 spu_bfd_iovec_close (struct bfd *nbfd, void *stream)
284 spu_bfd_iovec_pread (struct bfd *abfd, void *stream, void *buf,
285 file_ptr nbytes, file_ptr offset)
287 ULONGEST addr = *(ULONGEST *)stream;
289 if (fetch_ppc_memory (addr + offset, buf, nbytes) != 0)
291 bfd_set_error (bfd_error_invalid_operation);
299 spu_bfd_iovec_stat (struct bfd *abfd, void *stream, struct stat *sb)
301 /* We don't have an easy way of finding the size of embedded spu
302 images. We could parse the in-memory ELF header and section
303 table to find the extent of the last section but that seems
304 pointless when the size is needed only for checks of other
305 parsed values in dbxread.c. */
306 sb->st_size = INT_MAX;
311 spu_bfd_open (ULONGEST addr)
316 ULONGEST *open_closure = xmalloc (sizeof (ULONGEST));
317 *open_closure = addr;
319 nbfd = gdb_bfd_openr_iovec ("<in-memory>", "elf32-spu",
320 spu_bfd_iovec_open, open_closure,
321 spu_bfd_iovec_pread, spu_bfd_iovec_close,
326 if (!bfd_check_format (nbfd, bfd_object))
328 gdb_bfd_unref (nbfd);
332 /* Retrieve SPU name note and update BFD name. */
333 spu_name = bfd_get_section_by_name (nbfd, ".note.spu_name");
336 int sect_size = bfd_section_size (nbfd, spu_name);
339 char *buf = alloca (sect_size - 20 + 1);
340 bfd_get_section_contents (nbfd, spu_name, buf, 20, sect_size - 20);
341 buf[sect_size - 20] = '\0';
343 xfree ((char *)nbfd->filename);
344 nbfd->filename = xstrdup (buf);
351 /* INFERIOR_FD is a file handle passed by the inferior to the
352 spu_run system call. Assuming the SPE context was allocated
353 by the libspe library, try to retrieve the main SPE executable
354 file from its copy within the target process. */
356 spu_symbol_file_add_from_memory (int inferior_fd)
365 /* Read object ID. */
366 xsnprintf (annex, sizeof annex, "%d/object-id", inferior_fd);
367 len = spu_proc_xfer_spu (annex, id, NULL, 0, sizeof id);
368 if (len <= 0 || len >= sizeof id)
371 addr = strtoulst (id, NULL, 16);
375 /* Open BFD representing SPE executable and read its symbols. */
376 nbfd = spu_bfd_open (addr);
379 struct cleanup *cleanup = make_cleanup_bfd_unref (nbfd);
381 symbol_file_add_from_bfd (nbfd, SYMFILE_VERBOSE | SYMFILE_MAINLINE,
383 do_cleanups (cleanup);
388 /* Override the post_startup_inferior routine to continue running
389 the inferior until the first spu_run system call. */
391 spu_child_post_startup_inferior (ptid_t ptid)
396 int tid = TIDGET (ptid);
400 while (!parse_spufs_run (&fd, &addr))
402 ptrace (PT_SYSCALL, tid, (PTRACE_TYPE_ARG3) 0, 0);
403 waitpid (tid, NULL, __WALL | __WNOTHREAD);
407 /* Override the post_attach routine to try load the SPE executable
408 file image from its copy inside the target process. */
410 spu_child_post_attach (int pid)
415 /* Like child_post_startup_inferior, if we happened to attach to
416 the inferior while it wasn't currently in spu_run, continue
417 running it until we get back there. */
418 while (!parse_spufs_run (&fd, &addr))
420 ptrace (PT_SYSCALL, pid, (PTRACE_TYPE_ARG3) 0, 0);
421 waitpid (pid, NULL, __WALL | __WNOTHREAD);
424 /* If the user has not provided an executable file, try to extract
425 the image from inside the target process. */
426 if (!get_exec_file (0))
427 spu_symbol_file_add_from_memory (fd);
430 /* Wait for child PTID to do something. Return id of the child,
431 minus_one_ptid in case of error; store status into *OURSTATUS. */
433 spu_child_wait (struct target_ops *ops,
434 ptid_t ptid, struct target_waitstatus *ourstatus, int options)
442 set_sigint_trap (); /* Causes SIGINT to be passed on to the
445 pid = waitpid (PIDGET (ptid), &status, 0);
446 if (pid == -1 && errno == ECHILD)
447 /* Try again with __WCLONE to check cloned processes. */
448 pid = waitpid (PIDGET (ptid), &status, __WCLONE);
452 /* Make sure we don't report an event for the exit of the
453 original program, if we've detached from it. */
454 if (pid != -1 && !WIFSTOPPED (status) && pid != PIDGET (inferior_ptid))
460 clear_sigint_trap ();
462 while (pid == -1 && save_errno == EINTR);
466 warning (_("Child process unexpectedly missing: %s"),
467 safe_strerror (save_errno));
469 /* Claim it exited with unknown signal. */
470 ourstatus->kind = TARGET_WAITKIND_SIGNALLED;
471 ourstatus->value.sig = GDB_SIGNAL_UNKNOWN;
472 return inferior_ptid;
475 store_waitstatus (ourstatus, status);
476 return pid_to_ptid (pid);
479 /* Override the fetch_inferior_register routine. */
481 spu_fetch_inferior_registers (struct target_ops *ops,
482 struct regcache *regcache, int regno)
487 /* We must be stopped on a spu_run system call. */
488 if (!parse_spufs_run (&fd, &addr))
491 /* The ID register holds the spufs file handle. */
492 if (regno == -1 || regno == SPU_ID_REGNUM)
494 struct gdbarch *gdbarch = get_regcache_arch (regcache);
495 enum bfd_endian byte_order = gdbarch_byte_order (gdbarch);
497 store_unsigned_integer (buf, 4, byte_order, fd);
498 regcache_raw_supply (regcache, SPU_ID_REGNUM, buf);
501 /* The NPC register is found at ADDR. */
502 if (regno == -1 || regno == SPU_PC_REGNUM)
505 if (fetch_ppc_memory (addr, buf, 4) == 0)
506 regcache_raw_supply (regcache, SPU_PC_REGNUM, buf);
509 /* The GPRs are found in the "regs" spufs file. */
510 if (regno == -1 || (regno >= 0 && regno < SPU_NUM_GPRS))
512 gdb_byte buf[16 * SPU_NUM_GPRS];
516 xsnprintf (annex, sizeof annex, "%d/regs", fd);
517 if (spu_proc_xfer_spu (annex, buf, NULL, 0, sizeof buf) == sizeof buf)
518 for (i = 0; i < SPU_NUM_GPRS; i++)
519 regcache_raw_supply (regcache, i, buf + i*16);
523 /* Override the store_inferior_register routine. */
525 spu_store_inferior_registers (struct target_ops *ops,
526 struct regcache *regcache, int regno)
531 /* We must be stopped on a spu_run system call. */
532 if (!parse_spufs_run (&fd, &addr))
535 /* The NPC register is found at ADDR. */
536 if (regno == -1 || regno == SPU_PC_REGNUM)
539 regcache_raw_collect (regcache, SPU_PC_REGNUM, buf);
540 store_ppc_memory (addr, buf, 4);
543 /* The GPRs are found in the "regs" spufs file. */
544 if (regno == -1 || (regno >= 0 && regno < SPU_NUM_GPRS))
546 gdb_byte buf[16 * SPU_NUM_GPRS];
550 for (i = 0; i < SPU_NUM_GPRS; i++)
551 regcache_raw_collect (regcache, i, buf + i*16);
553 xsnprintf (annex, sizeof annex, "%d/regs", fd);
554 spu_proc_xfer_spu (annex, NULL, buf, 0, sizeof buf);
558 /* Override the to_xfer_partial routine. */
560 spu_xfer_partial (struct target_ops *ops,
561 enum target_object object, const char *annex,
562 gdb_byte *readbuf, const gdb_byte *writebuf,
563 ULONGEST offset, LONGEST len)
565 if (object == TARGET_OBJECT_SPU)
566 return spu_proc_xfer_spu (annex, readbuf, writebuf, offset, len);
568 if (object == TARGET_OBJECT_MEMORY)
572 char mem_annex[32], lslr_annex[32];
577 /* We must be stopped on a spu_run system call. */
578 if (!parse_spufs_run (&fd, &addr))
581 /* Use the "mem" spufs file to access SPU local store. */
582 xsnprintf (mem_annex, sizeof mem_annex, "%d/mem", fd);
583 ret = spu_proc_xfer_spu (mem_annex, readbuf, writebuf, offset, len);
587 /* SPU local store access wraps the address around at the
588 local store limit. We emulate this here. To avoid needing
589 an extra access to retrieve the LSLR, we only do that after
590 trying the original address first, and getting end-of-file. */
591 xsnprintf (lslr_annex, sizeof lslr_annex, "%d/lslr", fd);
592 memset (buf, 0, sizeof buf);
593 if (spu_proc_xfer_spu (lslr_annex, buf, NULL, 0, sizeof buf) <= 0)
596 lslr = strtoulst (buf, NULL, 16);
597 return spu_proc_xfer_spu (mem_annex, readbuf, writebuf,
604 /* Override the to_can_use_hw_breakpoint routine. */
606 spu_can_use_hw_breakpoint (int type, int cnt, int othertype)
612 /* Initialize SPU native target. */
614 _initialize_spu_nat (void)
616 /* Generic ptrace methods. */
617 struct target_ops *t;
618 t = inf_ptrace_target ();
620 /* Add SPU methods. */
621 t->to_post_attach = spu_child_post_attach;
622 t->to_post_startup_inferior = spu_child_post_startup_inferior;
623 t->to_wait = spu_child_wait;
624 t->to_fetch_registers = spu_fetch_inferior_registers;
625 t->to_store_registers = spu_store_inferior_registers;
626 t->to_xfer_partial = spu_xfer_partial;
627 t->to_can_use_hw_breakpoint = spu_can_use_hw_breakpoint;
629 /* Register SPU target. */