1 /* SPU native-dependent code for GDB, the GNU debugger.
2 Copyright (C) 2006, 2007, 2008, 2009, 2010, 2011
3 Free Software Foundation, Inc.
5 Contributed by Ulrich Weigand <uweigand@de.ibm.com>.
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/>. */
24 #include "gdb_string.h"
27 #include "inf-ptrace.h"
31 #include "gdbthread.h"
33 #include <sys/ptrace.h>
34 #include <asm/ptrace.h>
35 #include <sys/types.h>
36 #include <sys/param.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 = TIDGET (inferior_ptid);
53 tid = PIDGET (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 = TIDGET (inferior_ptid);
138 tid = PIDGET (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 = TIDGET (inferior_ptid);
168 tid = PIDGET (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 /* Copy LEN bytes at OFFSET in spufs file ANNEX into/from READBUF or WRITEBUF,
230 using the /proc file system. */
232 spu_proc_xfer_spu (const char *annex, gdb_byte *readbuf,
233 const gdb_byte *writebuf,
234 ULONGEST offset, LONGEST len)
239 int pid = PIDGET (inferior_ptid);
244 xsnprintf (buf, sizeof buf, "/proc/%d/fd/%s", pid, annex);
245 fd = open (buf, writebuf? O_WRONLY : O_RDONLY);
250 && lseek (fd, (off_t) offset, SEEK_SET) != (off_t) offset)
257 ret = write (fd, writebuf, (size_t) len);
259 ret = read (fd, readbuf, (size_t) len);
266 /* Inferior memory should contain an SPE executable image at location ADDR.
267 Allocate a BFD representing that executable. Return NULL on error. */
270 spu_bfd_iovec_open (struct bfd *nbfd, void *open_closure)
276 spu_bfd_iovec_close (struct bfd *nbfd, void *stream)
283 spu_bfd_iovec_pread (struct bfd *abfd, void *stream, void *buf,
284 file_ptr nbytes, file_ptr offset)
286 ULONGEST addr = *(ULONGEST *)stream;
288 if (fetch_ppc_memory (addr + offset, buf, nbytes) != 0)
290 bfd_set_error (bfd_error_invalid_operation);
298 spu_bfd_iovec_stat (struct bfd *abfd, void *stream, struct stat *sb)
300 /* We don't have an easy way of finding the size of embedded spu
301 images. We could parse the in-memory ELF header and section
302 table to find the extent of the last section but that seems
303 pointless when the size is needed only for checks of other
304 parsed values in dbxread.c. */
305 sb->st_size = INT_MAX;
310 spu_bfd_open (ULONGEST addr)
315 ULONGEST *open_closure = xmalloc (sizeof (ULONGEST));
316 *open_closure = addr;
318 nbfd = bfd_openr_iovec (xstrdup ("<in-memory>"), "elf32-spu",
319 spu_bfd_iovec_open, open_closure,
320 spu_bfd_iovec_pread, spu_bfd_iovec_close,
325 if (!bfd_check_format (nbfd, bfd_object))
331 /* Retrieve SPU name note and update BFD name. */
332 spu_name = bfd_get_section_by_name (nbfd, ".note.spu_name");
335 int sect_size = bfd_section_size (nbfd, spu_name);
338 char *buf = alloca (sect_size - 20 + 1);
339 bfd_get_section_contents (nbfd, spu_name, buf, 20, sect_size - 20);
340 buf[sect_size - 20] = '\0';
342 xfree ((char *)nbfd->filename);
343 nbfd->filename = xstrdup (buf);
350 /* INFERIOR_FD is a file handle passed by the inferior to the
351 spu_run system call. Assuming the SPE context was allocated
352 by the libspe library, try to retrieve the main SPE executable
353 file from its copy within the target process. */
355 spu_symbol_file_add_from_memory (int inferior_fd)
364 /* Read object ID. */
365 xsnprintf (annex, sizeof annex, "%d/object-id", inferior_fd);
366 len = spu_proc_xfer_spu (annex, id, NULL, 0, sizeof id);
367 if (len <= 0 || len >= sizeof id)
370 addr = strtoulst (id, NULL, 16);
374 /* Open BFD representing SPE executable and read its symbols. */
375 nbfd = spu_bfd_open (addr);
377 symbol_file_add_from_bfd (nbfd, SYMFILE_VERBOSE | SYMFILE_MAINLINE,
382 /* Override the post_startup_inferior routine to continue running
383 the inferior until the first spu_run system call. */
385 spu_child_post_startup_inferior (ptid_t ptid)
390 int tid = TIDGET (ptid);
394 while (!parse_spufs_run (&fd, &addr))
396 ptrace (PT_SYSCALL, tid, (PTRACE_TYPE_ARG3) 0, 0);
397 waitpid (tid, NULL, __WALL | __WNOTHREAD);
401 /* Override the post_attach routine to try load the SPE executable
402 file image from its copy inside the target process. */
404 spu_child_post_attach (int pid)
409 /* Like child_post_startup_inferior, if we happened to attach to
410 the inferior while it wasn't currently in spu_run, continue
411 running it until we get back there. */
412 while (!parse_spufs_run (&fd, &addr))
414 ptrace (PT_SYSCALL, pid, (PTRACE_TYPE_ARG3) 0, 0);
415 waitpid (pid, NULL, __WALL | __WNOTHREAD);
418 /* If the user has not provided an executable file, try to extract
419 the image from inside the target process. */
420 if (!get_exec_file (0))
421 spu_symbol_file_add_from_memory (fd);
424 /* Wait for child PTID to do something. Return id of the child,
425 minus_one_ptid in case of error; store status into *OURSTATUS. */
427 spu_child_wait (struct target_ops *ops,
428 ptid_t ptid, struct target_waitstatus *ourstatus, int options)
436 set_sigint_trap (); /* Causes SIGINT to be passed on to the
439 pid = waitpid (PIDGET (ptid), &status, 0);
440 if (pid == -1 && errno == ECHILD)
441 /* Try again with __WCLONE to check cloned processes. */
442 pid = waitpid (PIDGET (ptid), &status, __WCLONE);
446 /* Make sure we don't report an event for the exit of the
447 original program, if we've detached from it. */
448 if (pid != -1 && !WIFSTOPPED (status) && pid != PIDGET (inferior_ptid))
454 clear_sigint_trap ();
456 while (pid == -1 && save_errno == EINTR);
460 warning (_("Child process unexpectedly missing: %s"),
461 safe_strerror (save_errno));
463 /* Claim it exited with unknown signal. */
464 ourstatus->kind = TARGET_WAITKIND_SIGNALLED;
465 ourstatus->value.sig = TARGET_SIGNAL_UNKNOWN;
466 return inferior_ptid;
469 store_waitstatus (ourstatus, status);
470 return pid_to_ptid (pid);
473 /* Override the fetch_inferior_register routine. */
475 spu_fetch_inferior_registers (struct target_ops *ops,
476 struct regcache *regcache, int regno)
481 /* We must be stopped on a spu_run system call. */
482 if (!parse_spufs_run (&fd, &addr))
485 /* The ID register holds the spufs file handle. */
486 if (regno == -1 || regno == SPU_ID_REGNUM)
488 struct gdbarch *gdbarch = get_regcache_arch (regcache);
489 enum bfd_endian byte_order = gdbarch_byte_order (gdbarch);
491 store_unsigned_integer (buf, 4, byte_order, fd);
492 regcache_raw_supply (regcache, SPU_ID_REGNUM, buf);
495 /* The NPC register is found at ADDR. */
496 if (regno == -1 || regno == SPU_PC_REGNUM)
499 if (fetch_ppc_memory (addr, buf, 4) == 0)
500 regcache_raw_supply (regcache, SPU_PC_REGNUM, buf);
503 /* The GPRs are found in the "regs" spufs file. */
504 if (regno == -1 || (regno >= 0 && regno < SPU_NUM_GPRS))
506 gdb_byte buf[16 * SPU_NUM_GPRS];
510 xsnprintf (annex, sizeof annex, "%d/regs", fd);
511 if (spu_proc_xfer_spu (annex, buf, NULL, 0, sizeof buf) == sizeof buf)
512 for (i = 0; i < SPU_NUM_GPRS; i++)
513 regcache_raw_supply (regcache, i, buf + i*16);
517 /* Override the store_inferior_register routine. */
519 spu_store_inferior_registers (struct target_ops *ops,
520 struct regcache *regcache, int regno)
525 /* We must be stopped on a spu_run system call. */
526 if (!parse_spufs_run (&fd, &addr))
529 /* The NPC register is found at ADDR. */
530 if (regno == -1 || regno == SPU_PC_REGNUM)
533 regcache_raw_collect (regcache, SPU_PC_REGNUM, buf);
534 store_ppc_memory (addr, buf, 4);
537 /* The GPRs are found in the "regs" spufs file. */
538 if (regno == -1 || (regno >= 0 && regno < SPU_NUM_GPRS))
540 gdb_byte buf[16 * SPU_NUM_GPRS];
544 for (i = 0; i < SPU_NUM_GPRS; i++)
545 regcache_raw_collect (regcache, i, buf + i*16);
547 xsnprintf (annex, sizeof annex, "%d/regs", fd);
548 spu_proc_xfer_spu (annex, NULL, buf, 0, sizeof buf);
552 /* Override the to_xfer_partial routine. */
554 spu_xfer_partial (struct target_ops *ops,
555 enum target_object object, const char *annex,
556 gdb_byte *readbuf, const gdb_byte *writebuf,
557 ULONGEST offset, LONGEST len)
559 if (object == TARGET_OBJECT_SPU)
560 return spu_proc_xfer_spu (annex, readbuf, writebuf, offset, len);
562 if (object == TARGET_OBJECT_MEMORY)
566 char mem_annex[32], lslr_annex[32];
571 /* We must be stopped on a spu_run system call. */
572 if (!parse_spufs_run (&fd, &addr))
575 /* Use the "mem" spufs file to access SPU local store. */
576 xsnprintf (mem_annex, sizeof mem_annex, "%d/mem", fd);
577 ret = spu_proc_xfer_spu (mem_annex, readbuf, writebuf, offset, len);
581 /* SPU local store access wraps the address around at the
582 local store limit. We emulate this here. To avoid needing
583 an extra access to retrieve the LSLR, we only do that after
584 trying the original address first, and getting end-of-file. */
585 xsnprintf (lslr_annex, sizeof lslr_annex, "%d/lslr", fd);
586 memset (buf, 0, sizeof buf);
587 if (spu_proc_xfer_spu (lslr_annex, buf, NULL, 0, sizeof buf) <= 0)
590 lslr = strtoulst (buf, NULL, 16);
591 return spu_proc_xfer_spu (mem_annex, readbuf, writebuf,
598 /* Override the to_can_use_hw_breakpoint routine. */
600 spu_can_use_hw_breakpoint (int type, int cnt, int othertype)
606 /* Initialize SPU native target. */
608 _initialize_spu_nat (void)
610 /* Generic ptrace methods. */
611 struct target_ops *t;
612 t = inf_ptrace_target ();
614 /* Add SPU methods. */
615 t->to_post_attach = spu_child_post_attach;
616 t->to_post_startup_inferior = spu_child_post_startup_inferior;
617 t->to_wait = spu_child_wait;
618 t->to_fetch_registers = spu_fetch_inferior_registers;
619 t->to_store_registers = spu_store_inferior_registers;
620 t->to_xfer_partial = spu_xfer_partial;
621 t->to_can_use_hw_breakpoint = spu_can_use_hw_breakpoint;
623 /* Register SPU target. */