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 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_tid ((struct inferior_list_entry *)current_inferior)->id
57 /* These are used in remote-utils.c. */
58 int using_threads
= 0;
61 /* Fetch PPU register REGNO. */
63 fetch_ppc_register (int regno
)
67 int tid
= current_tid
;
70 /* If running as a 32-bit process on a 64-bit system, we attempt
71 to get the full 64-bit register content of the target process.
72 If the PPC special ptrace call fails, we're on a 32-bit system;
73 just fall through to the regular ptrace call in that case. */
78 ptrace (PPC_PTRACE_PEEKUSR_3264
, tid
,
79 (PTRACE_TYPE_ARG3
) (regno
* 8), buf
);
81 ptrace (PPC_PTRACE_PEEKUSR_3264
, tid
,
82 (PTRACE_TYPE_ARG3
) (regno
* 8 + 4), buf
+ 4);
84 return (CORE_ADDR
) *(unsigned long long *)buf
;
89 res
= ptrace (PT_READ_U
, tid
,
90 (PTRACE_TYPE_ARG3
) (regno
* sizeof (PTRACE_TYPE_RET
)), 0);
94 sprintf (mess
, "reading PPC register #%d", regno
);
95 perror_with_name (mess
);
98 return (CORE_ADDR
) (unsigned long) res
;
101 /* Fetch WORD from PPU memory at (aligned) MEMADDR in thread TID. */
103 fetch_ppc_memory_1 (int tid
, CORE_ADDR memaddr
, PTRACE_TYPE_RET
*word
)
107 #ifndef __powerpc64__
110 unsigned long long addr_8
= (unsigned long long) memaddr
;
111 ptrace (PPC_PTRACE_PEEKTEXT_3264
, tid
, (PTRACE_TYPE_ARG3
) &addr_8
, word
);
115 *word
= ptrace (PT_READ_I
, tid
, (PTRACE_TYPE_ARG3
) (size_t) memaddr
, 0);
120 /* Store WORD into PPU memory at (aligned) MEMADDR in thread TID. */
122 store_ppc_memory_1 (int tid
, CORE_ADDR memaddr
, PTRACE_TYPE_RET word
)
126 #ifndef __powerpc64__
129 unsigned long long addr_8
= (unsigned long long) memaddr
;
130 ptrace (PPC_PTRACE_POKEDATA_3264
, tid
, (PTRACE_TYPE_ARG3
) &addr_8
, word
);
134 ptrace (PT_WRITE_D
, tid
, (PTRACE_TYPE_ARG3
) (size_t) memaddr
, word
);
139 /* Fetch LEN bytes of PPU memory at MEMADDR to MYADDR. */
141 fetch_ppc_memory (CORE_ADDR memaddr
, char *myaddr
, int len
)
145 CORE_ADDR addr
= memaddr
& -(CORE_ADDR
) sizeof (PTRACE_TYPE_RET
);
146 int count
= ((((memaddr
+ len
) - addr
) + sizeof (PTRACE_TYPE_RET
) - 1)
147 / sizeof (PTRACE_TYPE_RET
));
148 PTRACE_TYPE_RET
*buffer
;
150 int tid
= current_tid
;
152 buffer
= (PTRACE_TYPE_RET
*) alloca (count
* sizeof (PTRACE_TYPE_RET
));
153 for (i
= 0; i
< count
; i
++, addr
+= sizeof (PTRACE_TYPE_RET
))
154 if ((ret
= fetch_ppc_memory_1 (tid
, addr
, &buffer
[i
])) != 0)
158 (char *) buffer
+ (memaddr
& (sizeof (PTRACE_TYPE_RET
) - 1)),
164 /* Store LEN bytes from MYADDR to PPU memory at MEMADDR. */
166 store_ppc_memory (CORE_ADDR memaddr
, char *myaddr
, int len
)
170 CORE_ADDR addr
= memaddr
& -(CORE_ADDR
) sizeof (PTRACE_TYPE_RET
);
171 int count
= ((((memaddr
+ len
) - addr
) + sizeof (PTRACE_TYPE_RET
) - 1)
172 / sizeof (PTRACE_TYPE_RET
));
173 PTRACE_TYPE_RET
*buffer
;
175 int tid
= current_tid
;
177 buffer
= (PTRACE_TYPE_RET
*) alloca (count
* sizeof (PTRACE_TYPE_RET
));
179 if (addr
!= memaddr
|| len
< (int) sizeof (PTRACE_TYPE_RET
))
180 if ((ret
= fetch_ppc_memory_1 (tid
, addr
, &buffer
[0])) != 0)
184 if ((ret
= fetch_ppc_memory_1 (tid
, addr
+ (count
- 1)
185 * sizeof (PTRACE_TYPE_RET
),
186 &buffer
[count
- 1])) != 0)
189 memcpy ((char *) buffer
+ (memaddr
& (sizeof (PTRACE_TYPE_RET
) - 1)),
192 for (i
= 0; i
< count
; i
++, addr
+= sizeof (PTRACE_TYPE_RET
))
193 if ((ret
= store_ppc_memory_1 (tid
, addr
, buffer
[i
])) != 0)
200 /* If the PPU thread is currently stopped on a spu_run system call,
201 return to FD and ADDR the file handle and NPC parameter address
202 used with the system call. Return non-zero if successful. */
204 parse_spufs_run (int *fd
, CORE_ADDR
*addr
)
207 CORE_ADDR pc
= fetch_ppc_register (32); /* nip */
209 /* Fetch instruction preceding current NIP. */
210 if (fetch_ppc_memory (pc
-4, buf
, 4) != 0)
212 /* It should be a "sc" instruction. */
213 if (*(unsigned int *)buf
!= INSTR_SC
)
215 /* System call number should be NR_spu_run. */
216 if (fetch_ppc_register (0) != NR_spu_run
)
219 /* Register 3 contains fd, register 4 the NPC param pointer. */
220 *fd
= fetch_ppc_register (34); /* orig_gpr3 */
221 *addr
= fetch_ppc_register (4);
226 /* Copy LEN bytes at OFFSET in spufs file ANNEX into/from READBUF or WRITEBUF,
227 using the /proc file system. */
229 spu_proc_xfer_spu (const char *annex
, unsigned char *readbuf
,
230 const unsigned char *writebuf
,
231 CORE_ADDR offset
, int len
)
240 sprintf (buf
, "/proc/%ld/fd/%s", current_tid
, annex
);
241 fd
= open (buf
, writebuf
? O_WRONLY
: O_RDONLY
);
246 && lseek (fd
, (off_t
) offset
, SEEK_SET
) != (off_t
) offset
)
253 ret
= write (fd
, writebuf
, (size_t) len
);
255 ret
= read (fd
, readbuf
, (size_t) len
);
262 /* Start an inferior process and returns its pid.
263 ALLARGS is a vector of program-name and args. */
265 spu_create_inferior (char *program
, char **allargs
)
271 perror_with_name ("fork");
275 ptrace (PTRACE_TRACEME
, 0, 0, 0);
279 execv (program
, allargs
);
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
)
351 if (resume_info
->leave_stopped
)
354 /* We don't support hardware single-stepping right now, assume
355 GDB knows to use software single-stepping. */
356 if (resume_info
->step
)
357 fprintf (stderr
, "Hardware single-step not supported.\n");
359 regcache_invalidate ();
362 ptrace (PTRACE_CONT
, current_tid
, 0, resume_info
->sig
);
364 perror_with_name ("ptrace");
367 /* Wait for process, returns status. */
369 spu_wait (char *status
)
371 int tid
= current_tid
;
377 ret
= waitpid (tid
, &w
, WNOHANG
| __WALL
| __WNOTHREAD
);
382 perror_with_name ("waitpid");
390 /* On the first wait, continue running the inferior until we are
391 blocked inside an spu_run system call. */
397 while (!parse_spufs_run (&fd
, &addr
))
399 ptrace (PT_SYSCALL
, tid
, (PTRACE_TYPE_ARG3
) 0, 0);
400 waitpid (tid
, NULL
, __WALL
| __WNOTHREAD
);
406 fprintf (stderr
, "\nChild exited with retcode = %x \n", WEXITSTATUS (w
));
409 return ((unsigned char) WEXITSTATUS (w
));
411 else if (!WIFSTOPPED (w
))
413 fprintf (stderr
, "\nChild terminated with signal = %x \n", WTERMSIG (w
));
416 return ((unsigned char) WTERMSIG (w
));
419 /* After attach, we may have received a SIGSTOP. Do not return this
420 as signal to GDB, or else it will try to continue with SIGSTOP ... */
428 return ((unsigned char) WSTOPSIG (w
));
431 /* Fetch inferior registers. */
433 spu_fetch_registers (int regno
)
438 /* ??? Some callers use 0 to mean all registers. */
442 /* We must be stopped on a spu_run system call. */
443 if (!parse_spufs_run (&fd
, &addr
))
446 /* The ID register holds the spufs file handle. */
447 if (regno
== -1 || regno
== SPU_ID_REGNUM
)
448 supply_register (SPU_ID_REGNUM
, (char *)&fd
);
450 /* The NPC register is found at ADDR. */
451 if (regno
== -1 || regno
== SPU_PC_REGNUM
)
454 if (fetch_ppc_memory (addr
, buf
, 4) == 0)
455 supply_register (SPU_PC_REGNUM
, buf
);
458 /* The GPRs are found in the "regs" spufs file. */
459 if (regno
== -1 || (regno
>= 0 && regno
< SPU_NUM_CORE_REGS
))
461 unsigned char buf
[16*SPU_NUM_CORE_REGS
];
465 sprintf (annex
, "%d/regs", fd
);
466 if (spu_proc_xfer_spu (annex
, buf
, NULL
, 0, sizeof buf
) == sizeof buf
)
467 for (i
= 0; i
< SPU_NUM_CORE_REGS
; i
++)
468 supply_register (i
, buf
+ i
*16);
472 /* Store inferior registers. */
474 spu_store_registers (int regno
)
479 /* ??? Some callers use 0 to mean all registers. */
483 /* We must be stopped on a spu_run system call. */
484 if (!parse_spufs_run (&fd
, &addr
))
487 /* The NPC register is found at ADDR. */
488 if (regno
== -1 || regno
== SPU_PC_REGNUM
)
491 collect_register (SPU_PC_REGNUM
, buf
);
492 store_ppc_memory (addr
, buf
, 4);
495 /* The GPRs are found in the "regs" spufs file. */
496 if (regno
== -1 || (regno
>= 0 && regno
< SPU_NUM_CORE_REGS
))
498 unsigned char buf
[16*SPU_NUM_CORE_REGS
];
502 for (i
= 0; i
< SPU_NUM_CORE_REGS
; i
++)
503 collect_register (i
, buf
+ i
*16);
505 sprintf (annex
, "%d/regs", fd
);
506 spu_proc_xfer_spu (annex
, NULL
, buf
, 0, sizeof buf
);
510 /* Copy LEN bytes from inferior's memory starting at MEMADDR
511 to debugger memory starting at MYADDR. */
513 spu_read_memory (CORE_ADDR memaddr
, unsigned char *myaddr
, int len
)
519 /* We must be stopped on a spu_run system call. */
520 if (!parse_spufs_run (&fd
, &addr
))
523 /* Use the "mem" spufs file to access SPU local store. */
524 sprintf (annex
, "%d/mem", fd
);
525 ret
= spu_proc_xfer_spu (annex
, myaddr
, NULL
, memaddr
, len
);
526 return ret
== len
? 0 : EIO
;
529 /* Copy LEN bytes of data from debugger memory at MYADDR
530 to inferior's memory at MEMADDR.
531 On failure (cannot write the inferior)
532 returns the value of errno. */
534 spu_write_memory (CORE_ADDR memaddr
, const unsigned char *myaddr
, int len
)
540 /* We must be stopped on a spu_run system call. */
541 if (!parse_spufs_run (&fd
, &addr
))
544 /* Use the "mem" spufs file to access SPU local store. */
545 sprintf (annex
, "%d/mem", fd
);
546 ret
= spu_proc_xfer_spu (annex
, NULL
, myaddr
, memaddr
, len
);
547 return ret
== len
? 0 : EIO
;
550 /* Look up special symbols -- unneded here. */
552 spu_look_up_symbols (void)
556 /* Send signal to inferior. */
558 spu_request_interrupt (void)
560 syscall (SYS_tkill
, current_tid
, SIGINT
);
564 spu_arch_string (void)
569 static struct target_ops spu_target_ops
= {
583 spu_request_interrupt
,
596 initialize_low (void)
598 static const unsigned char breakpoint
[] = { 0x00, 0x00, 0x3f, 0xff };
600 set_target_ops (&spu_target_ops
);
601 set_breakpoint_data (breakpoint
, sizeof breakpoint
);