1 /* Low level interface to SPUs, for the remote server for GDB.
2 Copyright (C) 2006, 2007 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 2 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, write to the Free Software
20 Foundation, Inc., 51 Franklin Street, Fifth Floor,
21 Boston, MA 02110-1301, USA. */
27 #include <sys/ptrace.h>
33 #include <sys/syscall.h>
35 /* Some older glibc versions do not define this. */
37 #define __WNOTHREAD 0x20000000 /* Don't wait on children of other
38 threads in this group */
41 #define PTRACE_TYPE_RET long
42 #define PTRACE_TYPE_ARG3 long
44 /* Number of registers. */
45 #define SPU_NUM_REGS 130
46 #define SPU_NUM_CORE_REGS 128
48 /* Special registers. */
49 #define SPU_ID_REGNUM 128
50 #define SPU_PC_REGNUM 129
52 /* PPU side system calls. */
53 #define INSTR_SC 0x44000002
54 #define NR_spu_run 0x0116
56 /* Get current thread ID (Linux task ID). */
57 #define current_tid ((struct inferior_list_entry *)current_inferior)->id
59 /* These are used in remote-utils.c. */
60 int using_threads = 0;
63 /* Fetch PPU register REGNO. */
65 fetch_ppc_register (int regno)
69 int tid = current_tid;
72 /* If running as a 32-bit process on a 64-bit system, we attempt
73 to get the full 64-bit register content of the target process.
74 If the PPC special ptrace call fails, we're on a 32-bit system;
75 just fall through to the regular ptrace call in that case. */
80 ptrace (PPC_PTRACE_PEEKUSR_3264, tid,
81 (PTRACE_TYPE_ARG3) (regno * 8), buf);
83 ptrace (PPC_PTRACE_PEEKUSR_3264, tid,
84 (PTRACE_TYPE_ARG3) (regno * 8 + 4), buf + 4);
86 return (CORE_ADDR) *(unsigned long long *)buf;
91 res = ptrace (PT_READ_U, tid,
92 (PTRACE_TYPE_ARG3) (regno * sizeof (PTRACE_TYPE_RET)), 0);
96 sprintf (mess, "reading PPC register #%d", regno);
97 perror_with_name (mess);
100 return (CORE_ADDR) (unsigned long) res;
103 /* Fetch WORD from PPU memory at (aligned) MEMADDR in thread TID. */
105 fetch_ppc_memory_1 (int tid, CORE_ADDR memaddr, PTRACE_TYPE_RET *word)
109 #ifndef __powerpc64__
112 unsigned long long addr_8 = (unsigned long long) memaddr;
113 ptrace (PPC_PTRACE_PEEKTEXT_3264, tid, (PTRACE_TYPE_ARG3) &addr_8, word);
117 *word = ptrace (PT_READ_I, tid, (PTRACE_TYPE_ARG3) (size_t) memaddr, 0);
122 /* Store WORD into PPU memory at (aligned) MEMADDR in thread TID. */
124 store_ppc_memory_1 (int tid, CORE_ADDR memaddr, PTRACE_TYPE_RET word)
128 #ifndef __powerpc64__
131 unsigned long long addr_8 = (unsigned long long) memaddr;
132 ptrace (PPC_PTRACE_POKEDATA_3264, tid, (PTRACE_TYPE_ARG3) &addr_8, word);
136 ptrace (PT_WRITE_D, tid, (PTRACE_TYPE_ARG3) (size_t) memaddr, word);
141 /* Fetch LEN bytes of PPU memory at MEMADDR to MYADDR. */
143 fetch_ppc_memory (CORE_ADDR memaddr, char *myaddr, int len)
147 CORE_ADDR addr = memaddr & -(CORE_ADDR) sizeof (PTRACE_TYPE_RET);
148 int count = ((((memaddr + len) - addr) + sizeof (PTRACE_TYPE_RET) - 1)
149 / sizeof (PTRACE_TYPE_RET));
150 PTRACE_TYPE_RET *buffer;
152 int tid = current_tid;
154 buffer = (PTRACE_TYPE_RET *) alloca (count * sizeof (PTRACE_TYPE_RET));
155 for (i = 0; i < count; i++, addr += sizeof (PTRACE_TYPE_RET))
156 if ((ret = fetch_ppc_memory_1 (tid, addr, &buffer[i])) != 0)
160 (char *) buffer + (memaddr & (sizeof (PTRACE_TYPE_RET) - 1)),
166 /* Store LEN bytes from MYADDR to PPU memory at MEMADDR. */
168 store_ppc_memory (CORE_ADDR memaddr, char *myaddr, int len)
172 CORE_ADDR addr = memaddr & -(CORE_ADDR) sizeof (PTRACE_TYPE_RET);
173 int count = ((((memaddr + len) - addr) + sizeof (PTRACE_TYPE_RET) - 1)
174 / sizeof (PTRACE_TYPE_RET));
175 PTRACE_TYPE_RET *buffer;
177 int tid = current_tid;
179 buffer = (PTRACE_TYPE_RET *) alloca (count * sizeof (PTRACE_TYPE_RET));
181 if (addr != memaddr || len < (int) sizeof (PTRACE_TYPE_RET))
182 if ((ret = fetch_ppc_memory_1 (tid, addr, &buffer[0])) != 0)
186 if ((ret = fetch_ppc_memory_1 (tid, addr + (count - 1)
187 * sizeof (PTRACE_TYPE_RET),
188 &buffer[count - 1])) != 0)
191 memcpy ((char *) buffer + (memaddr & (sizeof (PTRACE_TYPE_RET) - 1)),
194 for (i = 0; i < count; i++, addr += sizeof (PTRACE_TYPE_RET))
195 if ((ret = store_ppc_memory_1 (tid, addr, buffer[i])) != 0)
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, CORE_ADDR *addr)
209 CORE_ADDR 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 (*(unsigned int *)buf != 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, unsigned char *readbuf,
232 const unsigned char *writebuf,
233 CORE_ADDR offset, int len)
242 sprintf (buf, "/proc/%ld/fd/%s", current_tid, annex);
243 fd = open (buf, writebuf? O_WRONLY : O_RDONLY);
248 && lseek (fd, (off_t) offset, SEEK_SET) != (off_t) offset)
255 ret = write (fd, writebuf, (size_t) len);
257 ret = read (fd, readbuf, (size_t) len);
264 /* Start an inferior process and returns its pid.
265 ALLARGS is a vector of program-name and args. */
267 spu_create_inferior (char *program, char **allargs)
273 perror_with_name ("fork");
277 ptrace (PTRACE_TRACEME, 0, 0, 0);
281 execvp (program, allargs);
283 fprintf (stderr, "Cannot exec %s: %s.\n", program,
289 add_thread (pid, NULL, pid);
293 /* Attach to an inferior process. */
295 spu_attach (unsigned long pid)
297 if (ptrace (PTRACE_ATTACH, pid, 0, 0) != 0)
299 fprintf (stderr, "Cannot attach to process %ld: %s (%d)\n", pid,
300 strerror (errno), errno);
305 add_thread (pid, NULL, pid);
309 /* Kill the inferior process. */
313 ptrace (PTRACE_KILL, current_tid, 0, 0);
316 /* Detach from inferior process. */
320 ptrace (PTRACE_DETACH, current_tid, 0, 0);
330 ret = waitpid (current_tid, &status, 0);
331 if (WIFEXITED (status) || WIFSIGNALED (status))
333 } while (ret != -1 || errno != ECHILD);
336 /* Return nonzero if the given thread is still alive. */
338 spu_thread_alive (unsigned long tid)
340 return tid == current_tid;
343 /* Resume process. */
345 spu_resume (struct thread_resume *resume_info)
347 while (resume_info->thread != -1
348 && resume_info->thread != current_tid)
354 if (resume_info->leave_stopped)
357 /* We don't support hardware single-stepping right now, assume
358 GDB knows to use software single-stepping. */
359 if (resume_info->step)
360 fprintf (stderr, "Hardware single-step not supported.\n");
362 regcache_invalidate ();
365 ptrace (PTRACE_CONT, current_tid, 0, resume_info->sig);
367 perror_with_name ("ptrace");
370 /* Wait for process, returns status. */
372 spu_wait (char *status)
374 int tid = current_tid;
383 ret = waitpid (tid, &w, WNOHANG | __WALL | __WNOTHREAD);
388 perror_with_name ("waitpid");
396 /* On the first wait, continue running the inferior until we are
397 blocked inside an spu_run system call. */
403 while (!parse_spufs_run (&fd, &addr))
405 ptrace (PT_SYSCALL, tid, (PTRACE_TYPE_ARG3) 0, 0);
406 waitpid (tid, NULL, __WALL | __WNOTHREAD);
414 fprintf (stderr, "\nChild exited with retcode = %x \n", WEXITSTATUS (w));
417 return ((unsigned char) WEXITSTATUS (w));
419 else if (!WIFSTOPPED (w))
421 fprintf (stderr, "\nChild terminated with signal = %x \n", WTERMSIG (w));
424 return ((unsigned char) WTERMSIG (w));
427 /* After attach, we may have received a SIGSTOP. Do not return this
428 as signal to GDB, or else it will try to continue with SIGSTOP ... */
436 return ((unsigned char) WSTOPSIG (w));
439 /* Fetch inferior registers. */
441 spu_fetch_registers (int regno)
446 /* ??? Some callers use 0 to mean all registers. */
450 /* We must be stopped on a spu_run system call. */
451 if (!parse_spufs_run (&fd, &addr))
454 /* The ID register holds the spufs file handle. */
455 if (regno == -1 || regno == SPU_ID_REGNUM)
456 supply_register (SPU_ID_REGNUM, (char *)&fd);
458 /* The NPC register is found at ADDR. */
459 if (regno == -1 || regno == SPU_PC_REGNUM)
462 if (fetch_ppc_memory (addr, buf, 4) == 0)
463 supply_register (SPU_PC_REGNUM, buf);
466 /* The GPRs are found in the "regs" spufs file. */
467 if (regno == -1 || (regno >= 0 && regno < SPU_NUM_CORE_REGS))
469 unsigned char buf[16*SPU_NUM_CORE_REGS];
473 sprintf (annex, "%d/regs", fd);
474 if (spu_proc_xfer_spu (annex, buf, NULL, 0, sizeof buf) == sizeof buf)
475 for (i = 0; i < SPU_NUM_CORE_REGS; i++)
476 supply_register (i, buf + i*16);
480 /* Store inferior registers. */
482 spu_store_registers (int regno)
487 /* ??? Some callers use 0 to mean all registers. */
491 /* We must be stopped on a spu_run system call. */
492 if (!parse_spufs_run (&fd, &addr))
495 /* The NPC register is found at ADDR. */
496 if (regno == -1 || regno == SPU_PC_REGNUM)
499 collect_register (SPU_PC_REGNUM, buf);
500 store_ppc_memory (addr, buf, 4);
503 /* The GPRs are found in the "regs" spufs file. */
504 if (regno == -1 || (regno >= 0 && regno < SPU_NUM_CORE_REGS))
506 unsigned char buf[16*SPU_NUM_CORE_REGS];
510 for (i = 0; i < SPU_NUM_CORE_REGS; i++)
511 collect_register (i, buf + i*16);
513 sprintf (annex, "%d/regs", fd);
514 spu_proc_xfer_spu (annex, NULL, buf, 0, sizeof buf);
518 /* Copy LEN bytes from inferior's memory starting at MEMADDR
519 to debugger memory starting at MYADDR. */
521 spu_read_memory (CORE_ADDR memaddr, unsigned char *myaddr, int len)
527 /* We must be stopped on a spu_run system call. */
528 if (!parse_spufs_run (&fd, &addr))
531 /* Use the "mem" spufs file to access SPU local store. */
532 sprintf (annex, "%d/mem", fd);
533 ret = spu_proc_xfer_spu (annex, myaddr, NULL, memaddr, len);
534 return ret == len ? 0 : EIO;
537 /* Copy LEN bytes of data from debugger memory at MYADDR
538 to inferior's memory at MEMADDR.
539 On failure (cannot write the inferior)
540 returns the value of errno. */
542 spu_write_memory (CORE_ADDR memaddr, const unsigned char *myaddr, int len)
548 /* We must be stopped on a spu_run system call. */
549 if (!parse_spufs_run (&fd, &addr))
552 /* Use the "mem" spufs file to access SPU local store. */
553 sprintf (annex, "%d/mem", fd);
554 ret = spu_proc_xfer_spu (annex, NULL, myaddr, memaddr, len);
555 return ret == len ? 0 : EIO;
558 /* Look up special symbols -- unneded here. */
560 spu_look_up_symbols (void)
564 /* Send signal to inferior. */
566 spu_request_interrupt (void)
568 syscall (SYS_tkill, current_tid, SIGINT);
572 spu_arch_string (void)
577 static struct target_ops spu_target_ops = {
591 spu_request_interrupt,
604 initialize_low (void)
606 static const unsigned char breakpoint[] = { 0x00, 0x00, 0x3f, 0xff };
608 set_target_ops (&spu_target_ops);
609 set_breakpoint_data (breakpoint, sizeof breakpoint);