2 * Nios II Semihosting syscall interface.
3 * This code is derived from m68k-semi.c.
4 * The semihosting protocol implemented here is described in the
6 * https://sourceware.org/git/gitweb.cgi?p=newlib-cygwin.git;a=blob;f=libgloss/nios2/nios2-semi.txt;hb=HEAD
8 * Copyright (c) 2017-2019 Mentor Graphics
10 * This program is free software; you can redistribute it and/or modify
11 * it under the terms of the GNU General Public License as published by
12 * the Free Software Foundation; either version 2 of the License, or
13 * (at your option) any later version.
15 * This program is distributed in the hope that it will be useful,
16 * but WITHOUT ANY WARRANTY; without even the implied warranty of
17 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18 * GNU General Public License for more details.
20 * You should have received a copy of the GNU General Public License
21 * along with this program; if not, see <http://www.gnu.org/licenses/>.
24 #include "qemu/osdep.h"
27 #if defined(CONFIG_USER_ONLY)
30 #include "qemu-common.h"
31 #include "exec/gdbstub.h"
32 #include "exec/softmmu-semi.h"
37 #define HOSTED_INIT_SIM 1
39 #define HOSTED_CLOSE 3
41 #define HOSTED_WRITE 5
42 #define HOSTED_LSEEK 6
43 #define HOSTED_RENAME 7
44 #define HOSTED_UNLINK 8
46 #define HOSTED_FSTAT 10
47 #define HOSTED_GETTIMEOFDAY 11
48 #define HOSTED_ISATTY 12
49 #define HOSTED_SYSTEM 13
51 typedef uint32_t gdb_mode_t
;
52 typedef uint32_t gdb_time_t
;
54 struct nios2_gdb_stat
{
55 uint32_t gdb_st_dev
; /* device */
56 uint32_t gdb_st_ino
; /* inode */
57 gdb_mode_t gdb_st_mode
; /* protection */
58 uint32_t gdb_st_nlink
; /* number of hard links */
59 uint32_t gdb_st_uid
; /* user ID of owner */
60 uint32_t gdb_st_gid
; /* group ID of owner */
61 uint32_t gdb_st_rdev
; /* device type (if inode device) */
62 uint64_t gdb_st_size
; /* total size, in bytes */
63 uint64_t gdb_st_blksize
; /* blocksize for filesystem I/O */
64 uint64_t gdb_st_blocks
; /* number of blocks allocated */
65 gdb_time_t gdb_st_atime
; /* time of last access */
66 gdb_time_t gdb_st_mtime
; /* time of last modification */
67 gdb_time_t gdb_st_ctime
; /* time of last change */
71 gdb_time_t tv_sec
; /* second */
72 uint64_t tv_usec
; /* microsecond */
75 #define GDB_O_RDONLY 0x0
76 #define GDB_O_WRONLY 0x1
77 #define GDB_O_RDWR 0x2
78 #define GDB_O_APPEND 0x8
79 #define GDB_O_CREAT 0x200
80 #define GDB_O_TRUNC 0x400
81 #define GDB_O_EXCL 0x800
83 static int translate_openflags(int flags
)
87 if (flags
& GDB_O_WRONLY
) {
89 } else if (flags
& GDB_O_RDWR
) {
95 if (flags
& GDB_O_APPEND
) {
98 if (flags
& GDB_O_CREAT
) {
101 if (flags
& GDB_O_TRUNC
) {
104 if (flags
& GDB_O_EXCL
) {
111 static bool translate_stat(CPUNios2State
*env
, target_ulong addr
,
114 struct nios2_gdb_stat
*p
;
116 p
= lock_user(VERIFY_WRITE
, addr
, sizeof(struct nios2_gdb_stat
), 0);
121 p
->gdb_st_dev
= cpu_to_be32(s
->st_dev
);
122 p
->gdb_st_ino
= cpu_to_be32(s
->st_ino
);
123 p
->gdb_st_mode
= cpu_to_be32(s
->st_mode
);
124 p
->gdb_st_nlink
= cpu_to_be32(s
->st_nlink
);
125 p
->gdb_st_uid
= cpu_to_be32(s
->st_uid
);
126 p
->gdb_st_gid
= cpu_to_be32(s
->st_gid
);
127 p
->gdb_st_rdev
= cpu_to_be32(s
->st_rdev
);
128 p
->gdb_st_size
= cpu_to_be64(s
->st_size
);
130 /* Windows stat is missing some fields. */
131 p
->gdb_st_blksize
= 0;
132 p
->gdb_st_blocks
= 0;
134 p
->gdb_st_blksize
= cpu_to_be64(s
->st_blksize
);
135 p
->gdb_st_blocks
= cpu_to_be64(s
->st_blocks
);
137 p
->gdb_st_atime
= cpu_to_be32(s
->st_atime
);
138 p
->gdb_st_mtime
= cpu_to_be32(s
->st_mtime
);
139 p
->gdb_st_ctime
= cpu_to_be32(s
->st_ctime
);
140 unlock_user(p
, addr
, sizeof(struct nios2_gdb_stat
));
144 static void nios2_semi_return_u32(CPUNios2State
*env
, uint32_t ret
,
147 target_ulong args
= env
->regs
[R_ARG1
];
148 if (put_user_u32(ret
, args
) ||
149 put_user_u32(err
, args
+ 4)) {
151 * The nios2 semihosting ABI does not provide any way to report this
152 * error to the guest, so the best we can do is log it in qemu.
153 * It is always a guest error not to pass us a valid argument block.
155 qemu_log_mask(LOG_GUEST_ERROR
, "nios2-semihosting: return value "
156 "discarded because argument block not writable\n");
160 static void nios2_semi_return_u64(CPUNios2State
*env
, uint64_t ret
,
163 target_ulong args
= env
->regs
[R_ARG1
];
164 if (put_user_u32(ret
>> 32, args
) ||
165 put_user_u32(ret
, args
+ 4) ||
166 put_user_u32(err
, args
+ 8)) {
167 /* No way to report this via nios2 semihosting ABI; just log it */
168 qemu_log_mask(LOG_GUEST_ERROR
, "nios2-semihosting: return value "
169 "discarded because argument block not writable\n");
173 static int nios2_semi_is_lseek
;
175 static void nios2_semi_cb(CPUState
*cs
, target_ulong ret
, target_ulong err
)
177 Nios2CPU
*cpu
= NIOS2_CPU(cs
);
178 CPUNios2State
*env
= &cpu
->env
;
180 if (nios2_semi_is_lseek
) {
182 * FIXME: We've already lost the high bits of the lseek
185 nios2_semi_return_u64(env
, ret
, err
);
186 nios2_semi_is_lseek
= 0;
188 nios2_semi_return_u32(env
, ret
, err
);
193 * Read the input value from the argument block; fail the semihosting
194 * call if the memory read fails.
196 #define GET_ARG(n) do { \
197 if (get_user_ual(arg ## n, args + (n) * 4)) { \
204 void do_nios2_semihosting(CPUNios2State
*env
)
208 target_ulong arg0
, arg1
, arg2
, arg3
;
214 nr
= env
->regs
[R_ARG0
];
215 args
= env
->regs
[R_ARG1
];
218 gdb_exit(env
, env
->regs
[R_ARG0
]);
219 exit(env
->regs
[R_ARG0
]);
225 if (use_gdb_syscalls()) {
226 gdb_do_syscall(nios2_semi_cb
, "open,%s,%x,%x", arg0
, (int)arg1
,
230 p
= lock_user_string(arg0
);
235 result
= open(p
, translate_openflags(arg2
), arg3
);
236 unlock_user(p
, arg0
, 0);
242 /* Ignore attempts to close stdin/out/err. */
246 if (use_gdb_syscalls()) {
247 gdb_do_syscall(nios2_semi_cb
, "close,%x", arg0
);
262 if (use_gdb_syscalls()) {
263 gdb_do_syscall(nios2_semi_cb
, "read,%x,%x,%x",
267 p
= lock_user(VERIFY_WRITE
, arg1
, len
, 0);
272 result
= read(arg0
, p
, len
);
273 unlock_user(p
, arg1
, len
);
282 if (use_gdb_syscalls()) {
283 gdb_do_syscall(nios2_semi_cb
, "write,%x,%x,%x",
287 p
= lock_user(VERIFY_READ
, arg1
, len
, 1);
292 result
= write(arg0
, p
, len
);
293 unlock_user(p
, arg0
, 0);
304 off
= (uint32_t)arg2
| ((uint64_t)arg1
<< 32);
305 if (use_gdb_syscalls()) {
306 nios2_semi_is_lseek
= 1;
307 gdb_do_syscall(nios2_semi_cb
, "lseek,%x,%lx,%x",
310 off
= lseek(arg0
, off
, arg3
);
311 nios2_semi_return_u64(env
, off
, errno
);
320 if (use_gdb_syscalls()) {
321 gdb_do_syscall(nios2_semi_cb
, "rename,%s,%s",
322 arg0
, (int)arg1
, arg2
, (int)arg3
);
325 p
= lock_user_string(arg0
);
326 q
= lock_user_string(arg2
);
331 result
= rename(p
, q
);
333 unlock_user(p
, arg0
, 0);
334 unlock_user(q
, arg2
, 0);
340 if (use_gdb_syscalls()) {
341 gdb_do_syscall(nios2_semi_cb
, "unlink,%s",
345 p
= lock_user_string(arg0
);
351 unlock_user(p
, arg0
, 0);
359 if (use_gdb_syscalls()) {
360 gdb_do_syscall(nios2_semi_cb
, "stat,%s,%x",
361 arg0
, (int)arg1
, arg2
);
365 p
= lock_user_string(arg0
);
370 result
= stat(p
, &s
);
371 unlock_user(p
, arg0
, 0);
373 if (result
== 0 && !translate_stat(env
, arg2
, &s
)) {
382 if (use_gdb_syscalls()) {
383 gdb_do_syscall(nios2_semi_cb
, "fstat,%x,%x",
388 result
= fstat(arg0
, &s
);
389 if (result
== 0 && !translate_stat(env
, arg1
, &s
)) {
395 case HOSTED_GETTIMEOFDAY
:
396 /* Only the tv parameter is used. tz is assumed NULL. */
398 if (use_gdb_syscalls()) {
399 gdb_do_syscall(nios2_semi_cb
, "gettimeofday,%x,%x",
404 struct gdb_timeval
*p
;
405 result
= qemu_gettimeofday(&tv
);
407 p
= lock_user(VERIFY_WRITE
, arg0
, sizeof(struct gdb_timeval
),
413 p
->tv_sec
= cpu_to_be32(tv
.tv_sec
);
414 p
->tv_usec
= cpu_to_be64(tv
.tv_usec
);
415 unlock_user(p
, arg0
, sizeof(struct gdb_timeval
));
422 if (use_gdb_syscalls()) {
423 gdb_do_syscall(nios2_semi_cb
, "isatty,%x", arg0
);
426 result
= isatty(arg0
);
432 if (use_gdb_syscalls()) {
433 gdb_do_syscall(nios2_semi_cb
, "system,%s",
437 p
= lock_user_string(arg0
);
443 unlock_user(p
, arg0
, 0);
448 qemu_log_mask(LOG_GUEST_ERROR
, "nios2-semihosting: unsupported "
449 "semihosting syscall %d\n", nr
);
453 nios2_semi_return_u32(env
, result
, errno
);