1 /* Low level interface to SPUs, for the remote server for GDB.
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/>. */
25 #include <sys/ptrace.h>
31 #include <sys/syscall.h>
33 /* Some older glibc versions do not define this. */
35 #define __WNOTHREAD 0x20000000 /* Don't wait on children of other
36 threads in this group */
39 #define PTRACE_TYPE_RET long
40 #define PTRACE_TYPE_ARG3 long
42 /* Number of registers. */
43 #define SPU_NUM_REGS 130
44 #define SPU_NUM_CORE_REGS 128
46 /* Special registers. */
47 #define SPU_ID_REGNUM 128
48 #define SPU_PC_REGNUM 129
50 /* PPU side system calls. */
51 #define INSTR_SC 0x44000002
52 #define NR_spu_run 0x0116
54 /* Get current thread ID (Linux task ID). */
55 #define current_ptid ((struct inferior_list_entry *)current_inferior)->id
57 /* These are used in remote-utils.c. */
58 int using_threads = 0;
60 /* Defined in auto-generated file reg-spu.c. */
61 void init_registers_spu (void);
64 /* Fetch PPU register REGNO. */
66 fetch_ppc_register (int regno)
70 int tid = ptid_get_lwp (current_ptid);
73 /* If running as a 32-bit process on a 64-bit system, we attempt
74 to get the full 64-bit register content of the target process.
75 If the PPC special ptrace call fails, we're on a 32-bit system;
76 just fall through to the regular ptrace call in that case. */
81 ptrace (PPC_PTRACE_PEEKUSR_3264, tid,
82 (PTRACE_TYPE_ARG3) (regno * 8), buf);
84 ptrace (PPC_PTRACE_PEEKUSR_3264, tid,
85 (PTRACE_TYPE_ARG3) (regno * 8 + 4), buf + 4);
87 return (CORE_ADDR) *(unsigned long long *)buf;
92 res = ptrace (PT_READ_U, tid,
93 (PTRACE_TYPE_ARG3) (regno * sizeof (PTRACE_TYPE_RET)), 0);
97 sprintf (mess, "reading PPC register #%d", regno);
98 perror_with_name (mess);
101 return (CORE_ADDR) (unsigned long) res;
104 /* Fetch WORD from PPU memory at (aligned) MEMADDR in thread TID. */
106 fetch_ppc_memory_1 (int tid, CORE_ADDR memaddr, PTRACE_TYPE_RET *word)
110 #ifndef __powerpc64__
113 unsigned long long addr_8 = (unsigned long long) memaddr;
114 ptrace (PPC_PTRACE_PEEKTEXT_3264, tid, (PTRACE_TYPE_ARG3) &addr_8, word);
118 *word = ptrace (PT_READ_I, tid, (PTRACE_TYPE_ARG3) (size_t) memaddr, 0);
123 /* Store WORD into PPU memory at (aligned) MEMADDR in thread TID. */
125 store_ppc_memory_1 (int tid, CORE_ADDR memaddr, PTRACE_TYPE_RET word)
129 #ifndef __powerpc64__
132 unsigned long long addr_8 = (unsigned long long) memaddr;
133 ptrace (PPC_PTRACE_POKEDATA_3264, tid, (PTRACE_TYPE_ARG3) &addr_8, word);
137 ptrace (PT_WRITE_D, tid, (PTRACE_TYPE_ARG3) (size_t) memaddr, word);
142 /* Fetch LEN bytes of PPU memory at MEMADDR to MYADDR. */
144 fetch_ppc_memory (CORE_ADDR memaddr, char *myaddr, int len)
148 CORE_ADDR addr = memaddr & -(CORE_ADDR) sizeof (PTRACE_TYPE_RET);
149 int count = ((((memaddr + len) - addr) + sizeof (PTRACE_TYPE_RET) - 1)
150 / sizeof (PTRACE_TYPE_RET));
151 PTRACE_TYPE_RET *buffer;
153 int tid = ptid_get_lwp (current_ptid);
155 buffer = (PTRACE_TYPE_RET *) alloca (count * sizeof (PTRACE_TYPE_RET));
156 for (i = 0; i < count; i++, addr += sizeof (PTRACE_TYPE_RET))
157 if ((ret = fetch_ppc_memory_1 (tid, addr, &buffer[i])) != 0)
161 (char *) buffer + (memaddr & (sizeof (PTRACE_TYPE_RET) - 1)),
167 /* Store LEN bytes from MYADDR to PPU memory at MEMADDR. */
169 store_ppc_memory (CORE_ADDR memaddr, char *myaddr, int len)
173 CORE_ADDR addr = memaddr & -(CORE_ADDR) sizeof (PTRACE_TYPE_RET);
174 int count = ((((memaddr + len) - addr) + sizeof (PTRACE_TYPE_RET) - 1)
175 / sizeof (PTRACE_TYPE_RET));
176 PTRACE_TYPE_RET *buffer;
178 int tid = ptid_get_lwp (current_ptid);
180 buffer = (PTRACE_TYPE_RET *) alloca (count * sizeof (PTRACE_TYPE_RET));
182 if (addr != memaddr || len < (int) sizeof (PTRACE_TYPE_RET))
183 if ((ret = fetch_ppc_memory_1 (tid, addr, &buffer[0])) != 0)
187 if ((ret = fetch_ppc_memory_1 (tid, addr + (count - 1)
188 * sizeof (PTRACE_TYPE_RET),
189 &buffer[count - 1])) != 0)
192 memcpy ((char *) buffer + (memaddr & (sizeof (PTRACE_TYPE_RET) - 1)),
195 for (i = 0; i < count; i++, addr += sizeof (PTRACE_TYPE_RET))
196 if ((ret = store_ppc_memory_1 (tid, addr, buffer[i])) != 0)
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, CORE_ADDR *addr)
210 CORE_ADDR 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 (*(unsigned int *)buf != 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, unsigned char *readbuf,
233 const unsigned char *writebuf,
234 CORE_ADDR offset, int len)
243 sprintf (buf, "/proc/%ld/fd/%s", ptid_get_lwp (current_ptid), 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 /* Start an inferior process and returns its pid.
266 ALLARGS is a vector of program-name and args. */
268 spu_create_inferior (char *program, char **allargs)
275 perror_with_name ("fork");
279 ptrace (PTRACE_TRACEME, 0, 0, 0);
283 execv (program, allargs);
285 execvp (program, allargs);
287 fprintf (stderr, "Cannot exec %s: %s.\n", program,
293 add_process (pid, 0);
295 ptid = ptid_build (pid, pid, 0);
296 add_thread (ptid, NULL);
300 /* Attach to an inferior process. */
302 spu_attach (unsigned long pid)
306 if (ptrace (PTRACE_ATTACH, pid, 0, 0) != 0)
308 fprintf (stderr, "Cannot attach to process %ld: %s (%d)\n", pid,
309 strerror (errno), errno);
314 add_process (pid, 1);
315 ptid = ptid_build (pid, pid, 0);
316 add_thread (ptid, NULL);
320 /* Kill the inferior process. */
325 struct process_info *process = find_process_pid (pid);
329 ptrace (PTRACE_KILL, pid, 0, 0);
332 ret = waitpid (pid, &status, 0);
333 if (WIFEXITED (status) || WIFSIGNALED (status))
335 } while (ret != -1 || errno != ECHILD);
338 remove_process (process);
342 /* Detach from inferior process. */
346 struct process_info *process = find_process_pid (pid);
350 ptrace (PTRACE_DETACH, pid, 0, 0);
353 remove_process (process);
361 struct process_info *process;
363 process = find_process_pid (pid);
368 ret = waitpid (pid, &status, 0);
369 if (WIFEXITED (status) || WIFSIGNALED (status))
371 } while (ret != -1 || errno != ECHILD);
374 /* Return nonzero if the given thread is still alive. */
376 spu_thread_alive (ptid_t ptid)
378 return ptid_equal (ptid, current_ptid);
381 /* Resume process. */
383 spu_resume (struct thread_resume *resume_info, size_t n)
387 for (i = 0; i < n; i++)
388 if (ptid_equal (resume_info[i].thread, minus_one_ptid)
389 || ptid_equal (resume_info[i].thread, current_ptid))
395 /* We don't support hardware single-stepping right now, assume
396 GDB knows to use software single-stepping. */
397 if (resume_info[i].kind == resume_step)
398 fprintf (stderr, "Hardware single-step not supported.\n");
400 regcache_invalidate ();
403 ptrace (PTRACE_CONT, ptid_get_lwp (current_ptid), 0, resume_info[i].sig);
405 perror_with_name ("ptrace");
408 /* Wait for process, returns status. */
410 spu_wait (ptid_t ptid, struct target_waitstatus *ourstatus, int options)
412 int pid = ptid_get_pid (ptid);
418 ret = waitpid (pid, &w, WNOHANG | __WALL | __WNOTHREAD);
423 perror_with_name ("waitpid");
431 /* On the first wait, continue running the inferior until we are
432 blocked inside an spu_run system call. */
438 while (!parse_spufs_run (&fd, &addr))
440 ptrace (PT_SYSCALL, pid, (PTRACE_TYPE_ARG3) 0, 0);
441 waitpid (pid, NULL, __WALL | __WNOTHREAD);
447 fprintf (stderr, "\nChild exited with retcode = %x \n", WEXITSTATUS (w));
448 ourstatus->kind = TARGET_WAITKIND_EXITED;
449 ourstatus->value.integer = WEXITSTATUS (w);
451 return pid_to_ptid (ret);
453 else if (!WIFSTOPPED (w))
455 fprintf (stderr, "\nChild terminated with signal = %x \n", WTERMSIG (w));
456 ourstatus->kind = TARGET_WAITKIND_SIGNALLED;
457 ourstatus->value.sig = target_signal_from_host (WTERMSIG (w));
459 return pid_to_ptid (ret);
462 /* After attach, we may have received a SIGSTOP. Do not return this
463 as signal to GDB, or else it will try to continue with SIGSTOP ... */
466 ourstatus->kind = TARGET_WAITKIND_STOPPED;
467 ourstatus->value.sig = TARGET_SIGNAL_0;
468 return ptid_build (ret, ret, 0);
471 ourstatus->kind = TARGET_WAITKIND_STOPPED;
472 ourstatus->value.sig = target_signal_from_host (WSTOPSIG (w));
473 return ptid_build (ret, ret, 0);
476 /* Fetch inferior registers. */
478 spu_fetch_registers (struct regcache *regcache, int regno)
483 /* We must be stopped on a spu_run system call. */
484 if (!parse_spufs_run (&fd, &addr))
487 /* The ID register holds the spufs file handle. */
488 if (regno == -1 || regno == SPU_ID_REGNUM)
489 supply_register (regcache, SPU_ID_REGNUM, (char *)&fd);
491 /* The NPC register is found at ADDR. */
492 if (regno == -1 || regno == SPU_PC_REGNUM)
495 if (fetch_ppc_memory (addr, buf, 4) == 0)
496 supply_register (regcache, SPU_PC_REGNUM, buf);
499 /* The GPRs are found in the "regs" spufs file. */
500 if (regno == -1 || (regno >= 0 && regno < SPU_NUM_CORE_REGS))
502 unsigned char buf[16*SPU_NUM_CORE_REGS];
506 sprintf (annex, "%d/regs", fd);
507 if (spu_proc_xfer_spu (annex, buf, NULL, 0, sizeof buf) == sizeof buf)
508 for (i = 0; i < SPU_NUM_CORE_REGS; i++)
509 supply_register (regcache, i, buf + i*16);
513 /* Store inferior registers. */
515 spu_store_registers (struct regcache *regcache, int regno)
520 /* ??? Some callers use 0 to mean all registers. */
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 collect_register (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_CORE_REGS))
539 unsigned char buf[16*SPU_NUM_CORE_REGS];
543 for (i = 0; i < SPU_NUM_CORE_REGS; i++)
544 collect_register (regcache, i, buf + i*16);
546 sprintf (annex, "%d/regs", fd);
547 spu_proc_xfer_spu (annex, NULL, buf, 0, sizeof buf);
551 /* Copy LEN bytes from inferior's memory starting at MEMADDR
552 to debugger memory starting at MYADDR. */
554 spu_read_memory (CORE_ADDR memaddr, unsigned char *myaddr, int len)
560 /* We must be stopped on a spu_run system call. */
561 if (!parse_spufs_run (&fd, &addr))
564 /* Use the "mem" spufs file to access SPU local store. */
565 sprintf (annex, "%d/mem", fd);
566 ret = spu_proc_xfer_spu (annex, myaddr, NULL, memaddr, len);
567 return ret == len ? 0 : EIO;
570 /* Copy LEN bytes of data from debugger memory at MYADDR
571 to inferior's memory at MEMADDR.
572 On failure (cannot write the inferior)
573 returns the value of errno. */
575 spu_write_memory (CORE_ADDR memaddr, const unsigned char *myaddr, int len)
581 /* We must be stopped on a spu_run system call. */
582 if (!parse_spufs_run (&fd, &addr))
585 /* Use the "mem" spufs file to access SPU local store. */
586 sprintf (annex, "%d/mem", fd);
587 ret = spu_proc_xfer_spu (annex, NULL, myaddr, memaddr, len);
588 return ret == len ? 0 : EIO;
591 /* Look up special symbols -- unneded here. */
593 spu_look_up_symbols (void)
597 /* Send signal to inferior. */
599 spu_request_interrupt (void)
601 syscall (SYS_tkill, ptid_get_lwp (current_ptid), SIGINT);
604 static struct target_ops spu_target_ops = {
619 spu_request_interrupt,
628 hostio_last_error_from_errno,
632 initialize_low (void)
634 static const unsigned char breakpoint[] = { 0x00, 0x00, 0x3f, 0xff };
636 set_target_ops (&spu_target_ops);
637 set_breakpoint_data (breakpoint, sizeof breakpoint);
638 init_registers_spu ();