1 /* SPU native-dependent code for GDB, the GNU debugger.
2 Copyright (C) 2006, 2007, 2008, 2009, 2010 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-ptrace.h"
30 #include "gdbthread.h"
32 #include <sys/ptrace.h>
33 #include <asm/ptrace.h>
34 #include <sys/types.h>
35 #include <sys/param.h>
39 /* PPU side system calls. */
40 #define INSTR_SC 0x44000002
41 #define NR_spu_run 0x0116
44 /* Fetch PPU register REGNO. */
46 fetch_ppc_register (int regno)
50 int tid = TIDGET (inferior_ptid);
52 tid = PIDGET (inferior_ptid);
55 /* If running as a 32-bit process on a 64-bit system, we attempt
56 to get the full 64-bit register content of the target process.
57 If the PPC special ptrace call fails, we're on a 32-bit system;
58 just fall through to the regular ptrace call in that case. */
63 ptrace (PPC_PTRACE_PEEKUSR_3264, tid,
64 (PTRACE_TYPE_ARG3) (regno * 8), buf);
66 ptrace (PPC_PTRACE_PEEKUSR_3264, tid,
67 (PTRACE_TYPE_ARG3) (regno * 8 + 4), buf + 4);
69 return (ULONGEST) *(uint64_t *)buf;
74 res = ptrace (PT_READ_U, tid,
75 (PTRACE_TYPE_ARG3) (regno * sizeof (PTRACE_TYPE_RET)), 0);
79 xsnprintf (mess, sizeof mess, "reading PPC register #%d", regno);
80 perror_with_name (_(mess));
83 return (ULONGEST) (unsigned long) res;
86 /* Fetch WORD from PPU memory at (aligned) MEMADDR in thread TID. */
88 fetch_ppc_memory_1 (int tid, ULONGEST memaddr, PTRACE_TYPE_RET *word)
95 uint64_t addr_8 = (uint64_t) memaddr;
96 ptrace (PPC_PTRACE_PEEKTEXT_3264, tid, (PTRACE_TYPE_ARG3) &addr_8, word);
100 *word = ptrace (PT_READ_I, tid, (PTRACE_TYPE_ARG3) (size_t) memaddr, 0);
105 /* Store WORD into PPU memory at (aligned) MEMADDR in thread TID. */
107 store_ppc_memory_1 (int tid, ULONGEST memaddr, PTRACE_TYPE_RET word)
111 #ifndef __powerpc64__
114 uint64_t addr_8 = (uint64_t) memaddr;
115 ptrace (PPC_PTRACE_POKEDATA_3264, tid, (PTRACE_TYPE_ARG3) &addr_8, word);
119 ptrace (PT_WRITE_D, tid, (PTRACE_TYPE_ARG3) (size_t) memaddr, word);
124 /* Fetch LEN bytes of PPU memory at MEMADDR to MYADDR. */
126 fetch_ppc_memory (ULONGEST memaddr, gdb_byte *myaddr, int len)
130 ULONGEST addr = memaddr & -(ULONGEST) sizeof (PTRACE_TYPE_RET);
131 int count = ((((memaddr + len) - addr) + sizeof (PTRACE_TYPE_RET) - 1)
132 / sizeof (PTRACE_TYPE_RET));
133 PTRACE_TYPE_RET *buffer;
135 int tid = TIDGET (inferior_ptid);
137 tid = PIDGET (inferior_ptid);
139 buffer = (PTRACE_TYPE_RET *) alloca (count * sizeof (PTRACE_TYPE_RET));
140 for (i = 0; i < count; i++, addr += sizeof (PTRACE_TYPE_RET))
142 ret = fetch_ppc_memory_1 (tid, addr, &buffer[i]);
148 (char *) buffer + (memaddr & (sizeof (PTRACE_TYPE_RET) - 1)),
154 /* Store LEN bytes from MYADDR to PPU memory at MEMADDR. */
156 store_ppc_memory (ULONGEST memaddr, const gdb_byte *myaddr, int len)
160 ULONGEST addr = memaddr & -(ULONGEST) sizeof (PTRACE_TYPE_RET);
161 int count = ((((memaddr + len) - addr) + sizeof (PTRACE_TYPE_RET) - 1)
162 / sizeof (PTRACE_TYPE_RET));
163 PTRACE_TYPE_RET *buffer;
165 int tid = TIDGET (inferior_ptid);
167 tid = PIDGET (inferior_ptid);
169 buffer = (PTRACE_TYPE_RET *) alloca (count * sizeof (PTRACE_TYPE_RET));
171 if (addr != memaddr || len < (int) sizeof (PTRACE_TYPE_RET))
173 ret = fetch_ppc_memory_1 (tid, addr, &buffer[0]);
180 ret = fetch_ppc_memory_1 (tid, addr + (count - 1)
181 * sizeof (PTRACE_TYPE_RET),
187 memcpy ((char *) buffer + (memaddr & (sizeof (PTRACE_TYPE_RET) - 1)),
190 for (i = 0; i < count; i++, addr += sizeof (PTRACE_TYPE_RET))
192 ret = store_ppc_memory_1 (tid, addr, buffer[i]);
201 /* If the PPU thread is currently stopped on a spu_run system call,
202 return to FD and ADDR the file handle and NPC parameter address
203 used with the system call. Return non-zero if successful. */
205 parse_spufs_run (int *fd, ULONGEST *addr)
207 enum bfd_endian byte_order = gdbarch_byte_order (target_gdbarch);
209 ULONGEST pc = fetch_ppc_register (32); /* nip */
211 /* Fetch instruction preceding current NIP. */
212 if (fetch_ppc_memory (pc-4, buf, 4) != 0)
214 /* It should be a "sc" instruction. */
215 if (extract_unsigned_integer (buf, 4, byte_order) != INSTR_SC)
217 /* System call number should be NR_spu_run. */
218 if (fetch_ppc_register (0) != NR_spu_run)
221 /* Register 3 contains fd, register 4 the NPC param pointer. */
222 *fd = fetch_ppc_register (34); /* orig_gpr3 */
223 *addr = fetch_ppc_register (4);
228 /* Copy LEN bytes at OFFSET in spufs file ANNEX into/from READBUF or WRITEBUF,
229 using the /proc file system. */
231 spu_proc_xfer_spu (const char *annex, gdb_byte *readbuf,
232 const gdb_byte *writebuf,
233 ULONGEST offset, LONGEST len)
238 int pid = PIDGET (inferior_ptid);
243 xsnprintf (buf, sizeof buf, "/proc/%d/fd/%s", pid, annex);
244 fd = open (buf, writebuf? O_WRONLY : O_RDONLY);
249 && lseek (fd, (off_t) offset, SEEK_SET) != (off_t) offset)
256 ret = write (fd, writebuf, (size_t) len);
258 ret = read (fd, readbuf, (size_t) len);
265 /* Inferior memory should contain an SPE executable image at location ADDR.
266 Allocate a BFD representing that executable. Return NULL on error. */
269 spu_bfd_iovec_open (struct bfd *nbfd, void *open_closure)
275 spu_bfd_iovec_close (struct bfd *nbfd, void *stream)
282 spu_bfd_iovec_pread (struct bfd *abfd, void *stream, void *buf,
283 file_ptr nbytes, file_ptr offset)
285 ULONGEST addr = *(ULONGEST *)stream;
287 if (fetch_ppc_memory (addr + offset, buf, nbytes) != 0)
289 bfd_set_error (bfd_error_invalid_operation);
297 spu_bfd_iovec_stat (struct bfd *abfd, void *stream, struct stat *sb)
299 /* We don't have an easy way of finding the size of embedded spu
300 images. We could parse the in-memory ELF header and section
301 table to find the extent of the last section but that seems
302 pointless when the size is needed only for checks of other
303 parsed values in dbxread.c. */
304 sb->st_size = INT_MAX;
309 spu_bfd_open (ULONGEST addr)
314 ULONGEST *open_closure = xmalloc (sizeof (ULONGEST));
315 *open_closure = addr;
317 nbfd = bfd_openr_iovec (xstrdup ("<in-memory>"), "elf32-spu",
318 spu_bfd_iovec_open, open_closure,
319 spu_bfd_iovec_pread, spu_bfd_iovec_close,
324 if (!bfd_check_format (nbfd, bfd_object))
330 /* Retrieve SPU name note and update BFD name. */
331 spu_name = bfd_get_section_by_name (nbfd, ".note.spu_name");
334 int sect_size = bfd_section_size (nbfd, spu_name);
337 char *buf = alloca (sect_size - 20 + 1);
338 bfd_get_section_contents (nbfd, spu_name, buf, 20, sect_size - 20);
339 buf[sect_size - 20] = '\0';
341 xfree ((char *)nbfd->filename);
342 nbfd->filename = xstrdup (buf);
349 /* INFERIOR_FD is a file handle passed by the inferior to the
350 spu_run system call. Assuming the SPE context was allocated
351 by the libspe library, try to retrieve the main SPE executable
352 file from its copy within the target process. */
354 spu_symbol_file_add_from_memory (int inferior_fd)
363 /* Read object ID. */
364 xsnprintf (annex, sizeof annex, "%d/object-id", inferior_fd);
365 len = spu_proc_xfer_spu (annex, id, NULL, 0, sizeof id);
366 if (len <= 0 || len >= sizeof id)
369 addr = strtoulst (id, NULL, 16);
373 /* Open BFD representing SPE executable and read its symbols. */
374 nbfd = spu_bfd_open (addr);
376 symbol_file_add_from_bfd (nbfd, SYMFILE_VERBOSE | SYMFILE_MAINLINE,
381 /* Override the post_startup_inferior routine to continue running
382 the inferior until the first spu_run system call. */
384 spu_child_post_startup_inferior (ptid_t ptid)
389 int tid = TIDGET (ptid);
393 while (!parse_spufs_run (&fd, &addr))
395 ptrace (PT_SYSCALL, tid, (PTRACE_TYPE_ARG3) 0, 0);
396 waitpid (tid, NULL, __WALL | __WNOTHREAD);
400 /* Override the post_attach routine to try load the SPE executable
401 file image from its copy inside the target process. */
403 spu_child_post_attach (int pid)
408 /* Like child_post_startup_inferior, if we happened to attach to
409 the inferior while it wasn't currently in spu_run, continue
410 running it until we get back there. */
411 while (!parse_spufs_run (&fd, &addr))
413 ptrace (PT_SYSCALL, pid, (PTRACE_TYPE_ARG3) 0, 0);
414 waitpid (pid, NULL, __WALL | __WNOTHREAD);
417 /* If the user has not provided an executable file, try to extract
418 the image from inside the target process. */
419 if (!get_exec_file (0))
420 spu_symbol_file_add_from_memory (fd);
423 /* Wait for child PTID to do something. Return id of the child,
424 minus_one_ptid in case of error; store status into *OURSTATUS. */
426 spu_child_wait (struct target_ops *ops,
427 ptid_t ptid, struct target_waitstatus *ourstatus, int options)
435 set_sigint_trap (); /* Causes SIGINT to be passed on to the
438 pid = waitpid (PIDGET (ptid), &status, 0);
439 if (pid == -1 && errno == ECHILD)
440 /* Try again with __WCLONE to check cloned processes. */
441 pid = waitpid (PIDGET (ptid), &status, __WCLONE);
445 /* Make sure we don't report an event for the exit of the
446 original program, if we've detached from it. */
447 if (pid != -1 && !WIFSTOPPED (status) && pid != PIDGET (inferior_ptid))
453 clear_sigint_trap ();
455 while (pid == -1 && save_errno == EINTR);
459 warning (_("Child process unexpectedly missing: %s"),
460 safe_strerror (save_errno));
462 /* Claim it exited with unknown signal. */
463 ourstatus->kind = TARGET_WAITKIND_SIGNALLED;
464 ourstatus->value.sig = TARGET_SIGNAL_UNKNOWN;
465 return inferior_ptid;
468 store_waitstatus (ourstatus, status);
469 return pid_to_ptid (pid);
472 /* Override the fetch_inferior_register routine. */
474 spu_fetch_inferior_registers (struct target_ops *ops,
475 struct regcache *regcache, int regno)
480 /* We must be stopped on a spu_run system call. */
481 if (!parse_spufs_run (&fd, &addr))
484 /* The ID register holds the spufs file handle. */
485 if (regno == -1 || regno == SPU_ID_REGNUM)
487 struct gdbarch *gdbarch = get_regcache_arch (regcache);
488 enum bfd_endian byte_order = gdbarch_byte_order (gdbarch);
490 store_unsigned_integer (buf, 4, byte_order, fd);
491 regcache_raw_supply (regcache, SPU_ID_REGNUM, buf);
494 /* The NPC register is found at ADDR. */
495 if (regno == -1 || regno == SPU_PC_REGNUM)
498 if (fetch_ppc_memory (addr, buf, 4) == 0)
499 regcache_raw_supply (regcache, SPU_PC_REGNUM, buf);
502 /* The GPRs are found in the "regs" spufs file. */
503 if (regno == -1 || (regno >= 0 && regno < SPU_NUM_GPRS))
505 gdb_byte buf[16 * SPU_NUM_GPRS];
509 xsnprintf (annex, sizeof annex, "%d/regs", fd);
510 if (spu_proc_xfer_spu (annex, buf, NULL, 0, sizeof buf) == sizeof buf)
511 for (i = 0; i < SPU_NUM_GPRS; i++)
512 regcache_raw_supply (regcache, i, buf + i*16);
516 /* Override the store_inferior_register routine. */
518 spu_store_inferior_registers (struct target_ops *ops,
519 struct regcache *regcache, int regno)
524 /* We must be stopped on a spu_run system call. */
525 if (!parse_spufs_run (&fd, &addr))
528 /* The NPC register is found at ADDR. */
529 if (regno == -1 || regno == SPU_PC_REGNUM)
532 regcache_raw_collect (regcache, SPU_PC_REGNUM, buf);
533 store_ppc_memory (addr, buf, 4);
536 /* The GPRs are found in the "regs" spufs file. */
537 if (regno == -1 || (regno >= 0 && regno < SPU_NUM_GPRS))
539 gdb_byte buf[16 * SPU_NUM_GPRS];
543 for (i = 0; i < SPU_NUM_GPRS; i++)
544 regcache_raw_collect (regcache, i, buf + i*16);
546 xsnprintf (annex, sizeof annex, "%d/regs", fd);
547 spu_proc_xfer_spu (annex, NULL, buf, 0, sizeof buf);
551 /* Override the to_xfer_partial routine. */
553 spu_xfer_partial (struct target_ops *ops,
554 enum target_object object, const char *annex,
555 gdb_byte *readbuf, const gdb_byte *writebuf,
556 ULONGEST offset, LONGEST len)
558 if (object == TARGET_OBJECT_SPU)
559 return spu_proc_xfer_spu (annex, readbuf, writebuf, offset, len);
561 if (object == TARGET_OBJECT_MEMORY)
565 char mem_annex[32], lslr_annex[32];
570 /* We must be stopped on a spu_run system call. */
571 if (!parse_spufs_run (&fd, &addr))
574 /* Use the "mem" spufs file to access SPU local store. */
575 xsnprintf (mem_annex, sizeof mem_annex, "%d/mem", fd);
576 ret = spu_proc_xfer_spu (mem_annex, readbuf, writebuf, offset, len);
580 /* SPU local store access wraps the address around at the
581 local store limit. We emulate this here. To avoid needing
582 an extra access to retrieve the LSLR, we only do that after
583 trying the original address first, and getting end-of-file. */
584 xsnprintf (lslr_annex, sizeof lslr_annex, "%d/lslr", fd);
585 memset (buf, 0, sizeof buf);
586 if (spu_proc_xfer_spu (lslr_annex, buf, NULL, 0, sizeof buf) <= 0)
589 lslr = strtoulst (buf, NULL, 16);
590 return spu_proc_xfer_spu (mem_annex, readbuf, writebuf,
597 /* Override the to_can_use_hw_breakpoint routine. */
599 spu_can_use_hw_breakpoint (int type, int cnt, int othertype)
605 /* Initialize SPU native target. */
607 _initialize_spu_nat (void)
609 /* Generic ptrace methods. */
610 struct target_ops *t;
611 t = inf_ptrace_target ();
613 /* Add SPU methods. */
614 t->to_post_attach = spu_child_post_attach;
615 t->to_post_startup_inferior = spu_child_post_startup_inferior;
616 t->to_wait = spu_child_wait;
617 t->to_fetch_registers = spu_fetch_inferior_registers;
618 t->to_store_registers = spu_store_inferior_registers;
619 t->to_xfer_partial = spu_xfer_partial;
620 t->to_can_use_hw_breakpoint = spu_can_use_hw_breakpoint;
622 /* Register SPU target. */