2 * QEMU System Emulator header
4 * Copyright (c) 2003 Fabrice Bellard
6 * Permission is hereby granted, free of charge, to any person obtaining a copy
7 * of this software and associated documentation files (the "Software"), to deal
8 * in the Software without restriction, including without limitation the rights
9 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
10 * copies of the Software, and to permit persons to whom the Software is
11 * furnished to do so, subject to the following conditions:
13 * The above copyright notice and this permission notice shall be included in
14 * all copies or substantial portions of the Software.
16 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
19 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
21 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
27 /* we put basic includes here to avoid repeating them in device drivers */
51 #define lseek _lseeki64
53 extern int qemu_ftruncate64(int, int64_t);
54 #define ftruncate qemu_ftruncate64
57 static inline char *realpath(const char *path
, char *resolved_path
)
59 _fullpath(resolved_path
, path
, _MAX_PATH
);
71 /* we use QEMU_TOOL in the command line tools which do not depend on
72 the target CPU type */
73 #include "config-host.h"
80 #include "audio/audio.h"
84 #endif /* !defined(QEMU_TOOL) */
87 #define xglue(x, y) x ## y
88 #define glue(x, y) xglue(x, y)
89 #define stringify(s) tostring(s)
90 #define tostring(s) #s
94 #define MIN(a, b) (((a) < (b)) ? (a) : (b))
97 #define MAX(a, b) (((a) > (b)) ? (a) : (b))
101 uint64_t muldiv64(uint64_t a
, uint32_t b
, uint32_t c
);
103 void hw_error(const char *fmt
, ...);
105 extern const char *bios_dir
;
107 void pstrcpy(char *buf
, int buf_size
, const char *str
);
108 char *pstrcat(char *buf
, int buf_size
, const char *s
);
109 int strstart(const char *str
, const char *val
, const char **ptr
);
111 extern int vm_running
;
113 typedef struct vm_change_state_entry VMChangeStateEntry
;
114 typedef void VMChangeStateHandler(void *opaque
, int running
);
115 typedef void VMStopHandler(void *opaque
, int reason
);
117 VMChangeStateEntry
*qemu_add_vm_change_state_handler(VMChangeStateHandler
*cb
,
119 void qemu_del_vm_change_state_handler(VMChangeStateEntry
*e
);
121 int qemu_add_vm_stop_handler(VMStopHandler
*cb
, void *opaque
);
122 void qemu_del_vm_stop_handler(VMStopHandler
*cb
, void *opaque
);
125 void vm_stop(int reason
);
127 typedef void QEMUResetHandler(void *opaque
);
129 void qemu_register_reset(QEMUResetHandler
*func
, void *opaque
);
130 void qemu_system_reset_request(void);
131 void qemu_system_shutdown_request(void);
132 void qemu_system_powerdown_request(void);
133 #if !defined(TARGET_SPARC)
134 // Please implement a power failure function to signal the OS
135 #define qemu_system_powerdown() do{}while(0)
137 void qemu_system_powerdown(void);
140 void main_loop_wait(int timeout
);
143 extern int bios_size
;
145 extern int cirrus_vga_enabled
;
146 extern int graphic_width
;
147 extern int graphic_height
;
148 extern int graphic_depth
;
149 extern const char *keyboard_layout
;
150 extern int kqemu_allowed
;
151 extern int win2k_install_hack
;
152 extern int usb_enabled
;
155 /* XXX: make it dynamic */
156 #if defined (TARGET_PPC) || defined (TARGET_SPARC64)
157 #define BIOS_SIZE ((512 + 32) * 1024)
158 #elif defined(TARGET_MIPS)
159 #define BIOS_SIZE (128 * 1024)
161 #define BIOS_SIZE ((256 + 64) * 1024)
164 /* keyboard/mouse support */
166 #define MOUSE_EVENT_LBUTTON 0x01
167 #define MOUSE_EVENT_RBUTTON 0x02
168 #define MOUSE_EVENT_MBUTTON 0x04
170 typedef void QEMUPutKBDEvent(void *opaque
, int keycode
);
171 typedef void QEMUPutMouseEvent(void *opaque
, int dx
, int dy
, int dz
, int buttons_state
);
173 void qemu_add_kbd_event_handler(QEMUPutKBDEvent
*func
, void *opaque
);
174 void qemu_add_mouse_event_handler(QEMUPutMouseEvent
*func
, void *opaque
, int absolute
);
176 void kbd_put_keycode(int keycode
);
177 void kbd_mouse_event(int dx
, int dy
, int dz
, int buttons_state
);
178 int kbd_mouse_is_absolute(void);
180 /* keysym is a unicode code except for special keys (see QEMU_KEY_xxx
182 #define QEMU_KEY_ESC1(c) ((c) | 0xe100)
183 #define QEMU_KEY_BACKSPACE 0x007f
184 #define QEMU_KEY_UP QEMU_KEY_ESC1('A')
185 #define QEMU_KEY_DOWN QEMU_KEY_ESC1('B')
186 #define QEMU_KEY_RIGHT QEMU_KEY_ESC1('C')
187 #define QEMU_KEY_LEFT QEMU_KEY_ESC1('D')
188 #define QEMU_KEY_HOME QEMU_KEY_ESC1(1)
189 #define QEMU_KEY_END QEMU_KEY_ESC1(4)
190 #define QEMU_KEY_PAGEUP QEMU_KEY_ESC1(5)
191 #define QEMU_KEY_PAGEDOWN QEMU_KEY_ESC1(6)
192 #define QEMU_KEY_DELETE QEMU_KEY_ESC1(3)
194 #define QEMU_KEY_CTRL_UP 0xe400
195 #define QEMU_KEY_CTRL_DOWN 0xe401
196 #define QEMU_KEY_CTRL_LEFT 0xe402
197 #define QEMU_KEY_CTRL_RIGHT 0xe403
198 #define QEMU_KEY_CTRL_HOME 0xe404
199 #define QEMU_KEY_CTRL_END 0xe405
200 #define QEMU_KEY_CTRL_PAGEUP 0xe406
201 #define QEMU_KEY_CTRL_PAGEDOWN 0xe407
203 void kbd_put_keysym(int keysym
);
205 /* async I/O support */
207 typedef void IOReadHandler(void *opaque
, const uint8_t *buf
, int size
);
208 typedef int IOCanRWHandler(void *opaque
);
209 typedef void IOHandler(void *opaque
);
211 int qemu_set_fd_handler2(int fd
,
212 IOCanRWHandler
*fd_read_poll
,
216 int qemu_set_fd_handler(int fd
,
221 /* Polling handling */
223 /* return TRUE if no sleep should be done afterwards */
224 typedef int PollingFunc(void *opaque
);
226 int qemu_add_polling_cb(PollingFunc
*func
, void *opaque
);
227 void qemu_del_polling_cb(PollingFunc
*func
, void *opaque
);
230 /* Wait objects handling */
231 typedef void WaitObjectFunc(void *opaque
);
233 int qemu_add_wait_object(HANDLE handle
, WaitObjectFunc
*func
, void *opaque
);
234 void qemu_del_wait_object(HANDLE handle
, WaitObjectFunc
*func
, void *opaque
);
237 /* character device */
239 #define CHR_EVENT_BREAK 0 /* serial break char */
240 #define CHR_EVENT_FOCUS 1 /* focus to this terminal (modal input needed) */
244 #define CHR_IOCTL_SERIAL_SET_PARAMS 1
250 } QEMUSerialSetParams
;
252 #define CHR_IOCTL_SERIAL_SET_BREAK 2
254 #define CHR_IOCTL_PP_READ_DATA 3
255 #define CHR_IOCTL_PP_WRITE_DATA 4
256 #define CHR_IOCTL_PP_READ_CONTROL 5
257 #define CHR_IOCTL_PP_WRITE_CONTROL 6
258 #define CHR_IOCTL_PP_READ_STATUS 7
260 typedef void IOEventHandler(void *opaque
, int event
);
262 typedef struct CharDriverState
{
263 int (*chr_write
)(struct CharDriverState
*s
, const uint8_t *buf
, int len
);
264 void (*chr_add_read_handler
)(struct CharDriverState
*s
,
265 IOCanRWHandler
*fd_can_read
,
266 IOReadHandler
*fd_read
, void *opaque
);
267 int (*chr_ioctl
)(struct CharDriverState
*s
, int cmd
, void *arg
);
268 IOEventHandler
*chr_event
;
269 void (*chr_send_event
)(struct CharDriverState
*chr
, int event
);
270 void (*chr_close
)(struct CharDriverState
*chr
);
274 void qemu_chr_printf(CharDriverState
*s
, const char *fmt
, ...);
275 int qemu_chr_write(CharDriverState
*s
, const uint8_t *buf
, int len
);
276 void qemu_chr_send_event(CharDriverState
*s
, int event
);
277 void qemu_chr_add_read_handler(CharDriverState
*s
,
278 IOCanRWHandler
*fd_can_read
,
279 IOReadHandler
*fd_read
, void *opaque
);
280 void qemu_chr_add_event_handler(CharDriverState
*s
, IOEventHandler
*chr_event
);
281 int qemu_chr_ioctl(CharDriverState
*s
, int cmd
, void *arg
);
285 typedef struct DisplayState DisplayState
;
286 typedef struct TextConsole TextConsole
;
288 typedef void (*vga_hw_update_ptr
)(void *);
289 typedef void (*vga_hw_invalidate_ptr
)(void *);
290 typedef void (*vga_hw_screen_dump_ptr
)(void *, const char *);
292 TextConsole
*graphic_console_init(DisplayState
*ds
, vga_hw_update_ptr update
,
293 vga_hw_invalidate_ptr invalidate
,
294 vga_hw_screen_dump_ptr screen_dump
,
296 void vga_hw_update(void);
297 void vga_hw_invalidate(void);
298 void vga_hw_screen_dump(const char *filename
);
300 int is_graphic_console(void);
301 CharDriverState
*text_console_init(DisplayState
*ds
);
302 void console_select(unsigned int index
);
306 #define MAX_SERIAL_PORTS 4
308 extern CharDriverState
*serial_hds
[MAX_SERIAL_PORTS
];
312 #define MAX_PARALLEL_PORTS 3
314 extern CharDriverState
*parallel_hds
[MAX_PARALLEL_PORTS
];
318 typedef struct VLANClientState VLANClientState
;
320 struct VLANClientState
{
321 IOReadHandler
*fd_read
;
322 /* Packets may still be sent if this returns zero. It's used to
323 rate-limit the slirp code. */
324 IOCanRWHandler
*fd_can_read
;
326 struct VLANClientState
*next
;
327 struct VLANState
*vlan
;
331 typedef struct VLANState
{
333 VLANClientState
*first_client
;
334 struct VLANState
*next
;
337 VLANState
*qemu_find_vlan(int id
);
338 VLANClientState
*qemu_new_vlan_client(VLANState
*vlan
,
339 IOReadHandler
*fd_read
,
340 IOCanRWHandler
*fd_can_read
,
342 int qemu_can_send_packet(VLANClientState
*vc
);
343 void qemu_send_packet(VLANClientState
*vc
, const uint8_t *buf
, int size
);
344 void qemu_handler_true(void *opaque
);
346 void do_info_network(void);
349 int tap_win32_init(VLANState
*vlan
, const char *ifname
);
350 void tap_win32_poll(void);
356 typedef struct NICInfo
{
363 extern NICInfo nd_table
[MAX_NICS
];
367 typedef struct QEMUClock QEMUClock
;
368 typedef struct QEMUTimer QEMUTimer
;
369 typedef void QEMUTimerCB(void *opaque
);
371 /* The real time clock should be used only for stuff which does not
372 change the virtual machine state, as it is run even if the virtual
373 machine is stopped. The real time clock has a frequency of 1000
375 extern QEMUClock
*rt_clock
;
377 /* The virtual clock is only run during the emulation. It is stopped
378 when the virtual machine is stopped. Virtual timers use a high
379 precision clock, usually cpu cycles (use ticks_per_sec). */
380 extern QEMUClock
*vm_clock
;
382 int64_t qemu_get_clock(QEMUClock
*clock
);
384 QEMUTimer
*qemu_new_timer(QEMUClock
*clock
, QEMUTimerCB
*cb
, void *opaque
);
385 void qemu_free_timer(QEMUTimer
*ts
);
386 void qemu_del_timer(QEMUTimer
*ts
);
387 void qemu_mod_timer(QEMUTimer
*ts
, int64_t expire_time
);
388 int qemu_timer_pending(QEMUTimer
*ts
);
390 extern int64_t ticks_per_sec
;
391 extern int pit_min_timer_count
;
393 int64_t cpu_get_ticks(void);
394 void cpu_enable_ticks(void);
395 void cpu_disable_ticks(void);
399 typedef struct QEMUFile QEMUFile
;
401 QEMUFile
*qemu_fopen(const char *filename
, const char *mode
);
402 void qemu_fflush(QEMUFile
*f
);
403 void qemu_fclose(QEMUFile
*f
);
404 void qemu_put_buffer(QEMUFile
*f
, const uint8_t *buf
, int size
);
405 void qemu_put_byte(QEMUFile
*f
, int v
);
406 void qemu_put_be16(QEMUFile
*f
, unsigned int v
);
407 void qemu_put_be32(QEMUFile
*f
, unsigned int v
);
408 void qemu_put_be64(QEMUFile
*f
, uint64_t v
);
409 int qemu_get_buffer(QEMUFile
*f
, uint8_t *buf
, int size
);
410 int qemu_get_byte(QEMUFile
*f
);
411 unsigned int qemu_get_be16(QEMUFile
*f
);
412 unsigned int qemu_get_be32(QEMUFile
*f
);
413 uint64_t qemu_get_be64(QEMUFile
*f
);
415 static inline void qemu_put_be64s(QEMUFile
*f
, const uint64_t *pv
)
417 qemu_put_be64(f
, *pv
);
420 static inline void qemu_put_be32s(QEMUFile
*f
, const uint32_t *pv
)
422 qemu_put_be32(f
, *pv
);
425 static inline void qemu_put_be16s(QEMUFile
*f
, const uint16_t *pv
)
427 qemu_put_be16(f
, *pv
);
430 static inline void qemu_put_8s(QEMUFile
*f
, const uint8_t *pv
)
432 qemu_put_byte(f
, *pv
);
435 static inline void qemu_get_be64s(QEMUFile
*f
, uint64_t *pv
)
437 *pv
= qemu_get_be64(f
);
440 static inline void qemu_get_be32s(QEMUFile
*f
, uint32_t *pv
)
442 *pv
= qemu_get_be32(f
);
445 static inline void qemu_get_be16s(QEMUFile
*f
, uint16_t *pv
)
447 *pv
= qemu_get_be16(f
);
450 static inline void qemu_get_8s(QEMUFile
*f
, uint8_t *pv
)
452 *pv
= qemu_get_byte(f
);
455 #if TARGET_LONG_BITS == 64
456 #define qemu_put_betl qemu_put_be64
457 #define qemu_get_betl qemu_get_be64
458 #define qemu_put_betls qemu_put_be64s
459 #define qemu_get_betls qemu_get_be64s
461 #define qemu_put_betl qemu_put_be32
462 #define qemu_get_betl qemu_get_be32
463 #define qemu_put_betls qemu_put_be32s
464 #define qemu_get_betls qemu_get_be32s
467 int64_t qemu_ftell(QEMUFile
*f
);
468 int64_t qemu_fseek(QEMUFile
*f
, int64_t pos
, int whence
);
470 typedef void SaveStateHandler(QEMUFile
*f
, void *opaque
);
471 typedef int LoadStateHandler(QEMUFile
*f
, void *opaque
, int version_id
);
473 int register_savevm(const char *idstr
,
476 SaveStateHandler
*save_state
,
477 LoadStateHandler
*load_state
,
479 void qemu_get_timer(QEMUFile
*f
, QEMUTimer
*ts
);
480 void qemu_put_timer(QEMUFile
*f
, QEMUTimer
*ts
);
482 void cpu_save(QEMUFile
*f
, void *opaque
);
483 int cpu_load(QEMUFile
*f
, void *opaque
, int version_id
);
485 void do_savevm(const char *name
);
486 void do_loadvm(const char *name
);
487 void do_delvm(const char *name
);
488 void do_info_snapshots(void);
491 typedef struct QEMUBH QEMUBH
;
492 typedef void QEMUBHFunc(void *opaque
);
494 QEMUBH
*qemu_bh_new(QEMUBHFunc
*cb
, void *opaque
);
495 void qemu_bh_schedule(QEMUBH
*bh
);
496 void qemu_bh_cancel(QEMUBH
*bh
);
497 void qemu_bh_delete(QEMUBH
*bh
);
498 void qemu_bh_poll(void);
501 typedef struct BlockDriverState BlockDriverState
;
502 typedef struct BlockDriver BlockDriver
;
504 extern BlockDriver bdrv_raw
;
505 extern BlockDriver bdrv_cow
;
506 extern BlockDriver bdrv_qcow
;
507 extern BlockDriver bdrv_vmdk
;
508 extern BlockDriver bdrv_cloop
;
509 extern BlockDriver bdrv_dmg
;
510 extern BlockDriver bdrv_bochs
;
511 extern BlockDriver bdrv_vpc
;
512 extern BlockDriver bdrv_vvfat
;
513 extern BlockDriver bdrv_qcow2
;
515 typedef struct BlockDriverInfo
{
516 /* in bytes, 0 if irrelevant */
518 /* offset at which the VM state can be saved (0 if not possible) */
519 int64_t vm_state_offset
;
522 typedef struct QEMUSnapshotInfo
{
523 char id_str
[128]; /* unique snapshot id */
524 /* the following fields are informative. They are not needed for
525 the consistency of the snapshot */
526 char name
[256]; /* user choosen name */
527 uint32_t vm_state_size
; /* VM state info size */
528 uint32_t date_sec
; /* UTC date of the snapshot */
530 uint64_t vm_clock_nsec
; /* VM clock relative to boot */
533 #define BDRV_O_RDONLY 0x0000
534 #define BDRV_O_RDWR 0x0002
535 #define BDRV_O_ACCESS 0x0003
536 #define BDRV_O_CREAT 0x0004 /* create an empty file */
537 #define BDRV_O_SNAPSHOT 0x0008 /* open the file read only and save writes in a snapshot */
538 #define BDRV_O_FILE 0x0010 /* open as a raw file (do not try to
539 use a disk image format on top of
543 void bdrv_init(void);
544 BlockDriver
*bdrv_find_format(const char *format_name
);
545 int bdrv_create(BlockDriver
*drv
,
546 const char *filename
, int64_t size_in_sectors
,
547 const char *backing_file
, int flags
);
548 BlockDriverState
*bdrv_new(const char *device_name
);
549 void bdrv_delete(BlockDriverState
*bs
);
550 int bdrv_file_open(BlockDriverState
**pbs
, const char *filename
, int flags
);
551 int bdrv_open(BlockDriverState
*bs
, const char *filename
, int flags
);
552 int bdrv_open2(BlockDriverState
*bs
, const char *filename
, int flags
,
554 void bdrv_close(BlockDriverState
*bs
);
555 int bdrv_read(BlockDriverState
*bs
, int64_t sector_num
,
556 uint8_t *buf
, int nb_sectors
);
557 int bdrv_write(BlockDriverState
*bs
, int64_t sector_num
,
558 const uint8_t *buf
, int nb_sectors
);
559 int bdrv_pread(BlockDriverState
*bs
, int64_t offset
,
560 void *buf
, int count
);
561 int bdrv_pwrite(BlockDriverState
*bs
, int64_t offset
,
562 const void *buf
, int count
);
563 int bdrv_truncate(BlockDriverState
*bs
, int64_t offset
);
564 int64_t bdrv_getlength(BlockDriverState
*bs
);
565 void bdrv_get_geometry(BlockDriverState
*bs
, int64_t *nb_sectors_ptr
);
566 int bdrv_commit(BlockDriverState
*bs
);
567 void bdrv_set_boot_sector(BlockDriverState
*bs
, const uint8_t *data
, int size
);
568 /* async block I/O */
569 typedef struct BlockDriverAIOCB BlockDriverAIOCB
;
570 typedef void BlockDriverCompletionFunc(void *opaque
, int ret
);
572 BlockDriverAIOCB
*bdrv_aio_new(BlockDriverState
*bs
);
573 int bdrv_aio_read(BlockDriverAIOCB
*acb
, int64_t sector_num
,
574 uint8_t *buf
, int nb_sectors
,
575 BlockDriverCompletionFunc
*cb
, void *opaque
);
576 int bdrv_aio_write(BlockDriverAIOCB
*acb
, int64_t sector_num
,
577 const uint8_t *buf
, int nb_sectors
,
578 BlockDriverCompletionFunc
*cb
, void *opaque
);
579 void bdrv_aio_cancel(BlockDriverAIOCB
*acb
);
580 void bdrv_aio_delete(BlockDriverAIOCB
*acb
);
582 void qemu_aio_init(void);
583 void qemu_aio_poll(void);
584 void qemu_aio_wait_start(void);
585 void qemu_aio_wait(void);
586 void qemu_aio_wait_end(void);
588 /* Ensure contents are flushed to disk. */
589 void bdrv_flush(BlockDriverState
*bs
);
591 #define BDRV_TYPE_HD 0
592 #define BDRV_TYPE_CDROM 1
593 #define BDRV_TYPE_FLOPPY 2
594 #define BIOS_ATA_TRANSLATION_AUTO 0
595 #define BIOS_ATA_TRANSLATION_NONE 1
596 #define BIOS_ATA_TRANSLATION_LBA 2
598 void bdrv_set_geometry_hint(BlockDriverState
*bs
,
599 int cyls
, int heads
, int secs
);
600 void bdrv_set_type_hint(BlockDriverState
*bs
, int type
);
601 void bdrv_set_translation_hint(BlockDriverState
*bs
, int translation
);
602 void bdrv_get_geometry_hint(BlockDriverState
*bs
,
603 int *pcyls
, int *pheads
, int *psecs
);
604 int bdrv_get_type_hint(BlockDriverState
*bs
);
605 int bdrv_get_translation_hint(BlockDriverState
*bs
);
606 int bdrv_is_removable(BlockDriverState
*bs
);
607 int bdrv_is_read_only(BlockDriverState
*bs
);
608 int bdrv_is_inserted(BlockDriverState
*bs
);
609 int bdrv_is_locked(BlockDriverState
*bs
);
610 void bdrv_set_locked(BlockDriverState
*bs
, int locked
);
611 void bdrv_set_change_cb(BlockDriverState
*bs
,
612 void (*change_cb
)(void *opaque
), void *opaque
);
613 void bdrv_get_format(BlockDriverState
*bs
, char *buf
, int buf_size
);
614 void bdrv_info(void);
615 BlockDriverState
*bdrv_find(const char *name
);
616 void bdrv_iterate(void (*it
)(void *opaque
, const char *name
), void *opaque
);
617 int bdrv_is_encrypted(BlockDriverState
*bs
);
618 int bdrv_set_key(BlockDriverState
*bs
, const char *key
);
619 void bdrv_iterate_format(void (*it
)(void *opaque
, const char *name
),
621 const char *bdrv_get_device_name(BlockDriverState
*bs
);
622 int bdrv_write_compressed(BlockDriverState
*bs
, int64_t sector_num
,
623 const uint8_t *buf
, int nb_sectors
);
624 int bdrv_get_info(BlockDriverState
*bs
, BlockDriverInfo
*bdi
);
626 void bdrv_get_backing_filename(BlockDriverState
*bs
,
627 char *filename
, int filename_size
);
628 int bdrv_snapshot_create(BlockDriverState
*bs
,
629 QEMUSnapshotInfo
*sn_info
);
630 int bdrv_snapshot_goto(BlockDriverState
*bs
,
631 const char *snapshot_id
);
632 int bdrv_snapshot_delete(BlockDriverState
*bs
, const char *snapshot_id
);
633 int bdrv_snapshot_list(BlockDriverState
*bs
,
634 QEMUSnapshotInfo
**psn_info
);
635 char *bdrv_snapshot_dump(char *buf
, int buf_size
, QEMUSnapshotInfo
*sn
);
637 char *get_human_readable_size(char *buf
, int buf_size
, int64_t size
);
638 int path_is_absolute(const char *path
);
639 void path_combine(char *dest
, int dest_size
,
640 const char *base_path
,
641 const char *filename
);
645 typedef void QEMUMachineInitFunc(int ram_size
, int vga_ram_size
,
647 DisplayState
*ds
, const char **fd_filename
, int snapshot
,
648 const char *kernel_filename
, const char *kernel_cmdline
,
649 const char *initrd_filename
);
651 typedef struct QEMUMachine
{
654 QEMUMachineInitFunc
*init
;
655 struct QEMUMachine
*next
;
658 int qemu_register_machine(QEMUMachine
*m
);
660 typedef void SetIRQFunc(void *opaque
, int irq_num
, int level
);
661 typedef void IRQRequestFunc(void *opaque
, int level
);
665 extern target_phys_addr_t isa_mem_base
;
667 typedef void (IOPortWriteFunc
)(void *opaque
, uint32_t address
, uint32_t data
);
668 typedef uint32_t (IOPortReadFunc
)(void *opaque
, uint32_t address
);
670 int register_ioport_read(int start
, int length
, int size
,
671 IOPortReadFunc
*func
, void *opaque
);
672 int register_ioport_write(int start
, int length
, int size
,
673 IOPortWriteFunc
*func
, void *opaque
);
674 void isa_unassign_ioport(int start
, int length
);
678 extern target_phys_addr_t pci_mem_base
;
680 typedef struct PCIBus PCIBus
;
681 typedef struct PCIDevice PCIDevice
;
683 typedef void PCIConfigWriteFunc(PCIDevice
*pci_dev
,
684 uint32_t address
, uint32_t data
, int len
);
685 typedef uint32_t PCIConfigReadFunc(PCIDevice
*pci_dev
,
686 uint32_t address
, int len
);
687 typedef void PCIMapIORegionFunc(PCIDevice
*pci_dev
, int region_num
,
688 uint32_t addr
, uint32_t size
, int type
);
690 #define PCI_ADDRESS_SPACE_MEM 0x00
691 #define PCI_ADDRESS_SPACE_IO 0x01
692 #define PCI_ADDRESS_SPACE_MEM_PREFETCH 0x08
694 typedef struct PCIIORegion
{
695 uint32_t addr
; /* current PCI mapping address. -1 means not mapped */
698 PCIMapIORegionFunc
*map_func
;
701 #define PCI_ROM_SLOT 6
702 #define PCI_NUM_REGIONS 7
704 #define PCI_DEVICES_MAX 64
706 #define PCI_VENDOR_ID 0x00 /* 16 bits */
707 #define PCI_DEVICE_ID 0x02 /* 16 bits */
708 #define PCI_COMMAND 0x04 /* 16 bits */
709 #define PCI_COMMAND_IO 0x1 /* Enable response in I/O space */
710 #define PCI_COMMAND_MEMORY 0x2 /* Enable response in Memory space */
711 #define PCI_CLASS_DEVICE 0x0a /* Device class */
712 #define PCI_INTERRUPT_LINE 0x3c /* 8 bits */
713 #define PCI_INTERRUPT_PIN 0x3d /* 8 bits */
714 #define PCI_MIN_GNT 0x3e /* 8 bits */
715 #define PCI_MAX_LAT 0x3f /* 8 bits */
718 /* PCI config space */
721 /* the following fields are read only */
725 PCIIORegion io_regions
[PCI_NUM_REGIONS
];
727 /* do not access the following fields */
728 PCIConfigReadFunc
*config_read
;
729 PCIConfigWriteFunc
*config_write
;
730 /* ??? This is a PC-specific hack, and should be removed. */
734 PCIDevice
*pci_register_device(PCIBus
*bus
, const char *name
,
735 int instance_size
, int devfn
,
736 PCIConfigReadFunc
*config_read
,
737 PCIConfigWriteFunc
*config_write
);
739 void pci_register_io_region(PCIDevice
*pci_dev
, int region_num
,
740 uint32_t size
, int type
,
741 PCIMapIORegionFunc
*map_func
);
743 void pci_set_irq(PCIDevice
*pci_dev
, int irq_num
, int level
);
745 uint32_t pci_default_read_config(PCIDevice
*d
,
746 uint32_t address
, int len
);
747 void pci_default_write_config(PCIDevice
*d
,
748 uint32_t address
, uint32_t val
, int len
);
749 void generic_pci_save(QEMUFile
* f
, void *opaque
);
750 int generic_pci_load(QEMUFile
* f
, void *opaque
, int version_id
);
752 typedef void (*pci_set_irq_fn
)(PCIDevice
*pci_dev
, void *pic
,
753 int irq_num
, int level
);
754 PCIBus
*pci_register_bus(pci_set_irq_fn set_irq
, void *pic
, int devfn_min
);
756 void pci_nic_init(PCIBus
*bus
, NICInfo
*nd
);
757 void pci_data_write(void *opaque
, uint32_t addr
, uint32_t val
, int len
);
758 uint32_t pci_data_read(void *opaque
, uint32_t addr
, int len
);
759 int pci_bus_num(PCIBus
*s
);
760 void pci_for_each_device(void (*fn
)(PCIDevice
*d
));
765 PCIBus
*pci_prep_init(void);
768 PCIBus
*pci_grackle_init(uint32_t base
, void *pic
);
771 PCIBus
*pci_pmac_init(void *pic
);
774 PCIBus
*pci_apb_init(target_ulong special_base
, target_ulong mem_base
,
777 PCIBus
*pci_vpb_init(void *pic
);
780 PCIBus
*i440fx_init(void);
781 int piix3_init(PCIBus
*bus
);
782 void pci_bios_init(void);
785 typedef struct openpic_t openpic_t
;
786 void openpic_set_irq(void *opaque
, int n_IRQ
, int level
);
787 openpic_t
*openpic_init (PCIBus
*bus
, int *pmem_index
, int nb_cpus
,
791 typedef struct HeathrowPICS HeathrowPICS
;
792 void heathrow_pic_set_irq(void *opaque
, int num
, int level
);
793 HeathrowPICS
*heathrow_pic_init(int *pmem_index
);
802 int (*init_isa
) (AudioState
*s
);
803 int (*init_pci
) (PCIBus
*bus
, AudioState
*s
);
807 extern struct soundhw soundhw
[];
812 #define VGA_RAM_SIZE (8192 * 1024)
814 struct DisplayState
{
818 int bgr
; /* BGR color order instead of RGB. Only valid for depth == 32 */
823 void (*dpy_update
)(struct DisplayState
*s
, int x
, int y
, int w
, int h
);
824 void (*dpy_resize
)(struct DisplayState
*s
, int w
, int h
);
825 void (*dpy_refresh
)(struct DisplayState
*s
);
826 void (*dpy_copy
)(struct DisplayState
*s
, int src_x
, int src_y
, int dst_x
, int dst_y
, int w
, int h
);
829 static inline void dpy_update(DisplayState
*s
, int x
, int y
, int w
, int h
)
831 s
->dpy_update(s
, x
, y
, w
, h
);
834 static inline void dpy_resize(DisplayState
*s
, int w
, int h
)
836 s
->dpy_resize(s
, w
, h
);
839 int vga_initialize(PCIBus
*bus
, DisplayState
*ds
, uint8_t *vga_ram_base
,
840 unsigned long vga_ram_offset
, int vga_ram_size
,
841 unsigned long vga_bios_offset
, int vga_bios_size
);
844 void pci_cirrus_vga_init(PCIBus
*bus
, DisplayState
*ds
, uint8_t *vga_ram_base
,
845 unsigned long vga_ram_offset
, int vga_ram_size
);
846 void isa_cirrus_vga_init(DisplayState
*ds
, uint8_t *vga_ram_base
,
847 unsigned long vga_ram_offset
, int vga_ram_size
);
850 void sdl_display_init(DisplayState
*ds
, int full_screen
);
853 void cocoa_display_init(DisplayState
*ds
, int full_screen
);
856 void vnc_display_init(DisplayState
*ds
, int display
);
861 extern BlockDriverState
*bs_table
[MAX_DISKS
+ 1];
863 void isa_ide_init(int iobase
, int iobase2
, int irq
,
864 BlockDriverState
*hd0
, BlockDriverState
*hd1
);
865 void pci_cmd646_ide_init(PCIBus
*bus
, BlockDriverState
**hd_table
,
866 int secondary_ide_enabled
);
867 void pci_piix3_ide_init(PCIBus
*bus
, BlockDriverState
**hd_table
, int devfn
);
868 int pmac_ide_init (BlockDriverState
**hd_table
,
869 SetIRQFunc
*set_irq
, void *irq_opaque
, int irq
);
872 int cdrom_read_toc(int nb_sectors
, uint8_t *buf
, int msf
, int start_track
);
873 int cdrom_read_toc_raw(int nb_sectors
, uint8_t *buf
, int msf
, int session_num
);
876 int es1370_init (PCIBus
*bus
, AudioState
*s
);
879 int SB16_init (AudioState
*s
);
882 int Adlib_init (AudioState
*s
);
885 int GUS_init (AudioState
*s
);
888 typedef int (*DMA_transfer_handler
) (void *opaque
, int nchan
, int pos
, int size
);
889 int DMA_get_channel_mode (int nchan
);
890 int DMA_read_memory (int nchan
, void *buf
, int pos
, int size
);
891 int DMA_write_memory (int nchan
, void *buf
, int pos
, int size
);
892 void DMA_hold_DREQ (int nchan
);
893 void DMA_release_DREQ (int nchan
);
894 void DMA_schedule(int nchan
);
896 void DMA_init (int high_page_enable
);
897 void DMA_register_channel (int nchan
,
898 DMA_transfer_handler transfer_handler
,
902 extern BlockDriverState
*fd_table
[MAX_FD
];
904 typedef struct fdctrl_t fdctrl_t
;
906 fdctrl_t
*fdctrl_init (int irq_lvl
, int dma_chann
, int mem_mapped
,
908 BlockDriverState
**fds
);
909 int fdctrl_get_drive_type(fdctrl_t
*fdctrl
, int drive_num
);
913 void isa_ne2000_init(int base
, int irq
, NICInfo
*nd
);
914 void pci_ne2000_init(PCIBus
*bus
, NICInfo
*nd
);
918 void pci_rtl8139_init(PCIBus
*bus
, NICInfo
*nd
);
922 void pci_pcnet_init(PCIBus
*bus
, NICInfo
*nd
);
930 typedef struct RTCState RTCState
;
932 RTCState
*rtc_init(int base
, int irq
);
933 void rtc_set_memory(RTCState
*s
, int addr
, int val
);
934 void rtc_set_date(RTCState
*s
, const struct tm
*tm
);
938 typedef struct SerialState SerialState
;
939 SerialState
*serial_init(SetIRQFunc
*set_irq
, void *opaque
,
940 int base
, int irq
, CharDriverState
*chr
);
941 SerialState
*serial_mm_init (SetIRQFunc
*set_irq
, void *opaque
,
942 target_ulong base
, int it_shift
,
943 int irq
, CharDriverState
*chr
);
947 typedef struct ParallelState ParallelState
;
948 ParallelState
*parallel_init(int base
, int irq
, CharDriverState
*chr
);
952 typedef struct PicState2 PicState2
;
953 extern PicState2
*isa_pic
;
954 void pic_set_irq(int irq
, int level
);
955 void pic_set_irq_new(void *opaque
, int irq
, int level
);
956 PicState2
*pic_init(IRQRequestFunc
*irq_request
, void *irq_request_opaque
);
957 void pic_set_alt_irq_func(PicState2
*s
, SetIRQFunc
*alt_irq_func
,
958 void *alt_irq_opaque
);
959 int pic_read_irq(PicState2
*s
);
960 void pic_update_irq(PicState2
*s
);
961 uint32_t pic_intack_read(PicState2
*s
);
966 typedef struct IOAPICState IOAPICState
;
968 int apic_init(CPUState
*env
);
969 int apic_get_interrupt(CPUState
*env
);
970 IOAPICState
*ioapic_init(void);
971 void ioapic_set_irq(void *opaque
, int vector
, int level
);
975 #define PIT_FREQ 1193182
977 typedef struct PITState PITState
;
979 PITState
*pit_init(int base
, int irq
);
980 void pit_set_gate(PITState
*pit
, int channel
, int val
);
981 int pit_get_gate(PITState
*pit
, int channel
);
982 int pit_get_initial_count(PITState
*pit
, int channel
);
983 int pit_get_mode(PITState
*pit
, int channel
);
984 int pit_get_out(PITState
*pit
, int channel
, int64_t current_time
);
987 void pcspk_init(PITState
*);
988 int pcspk_audio_init(AudioState
*);
991 extern int acpi_enabled
;
992 void piix4_pm_init(PCIBus
*bus
, int devfn
);
993 void acpi_bios_init(void);
996 extern QEMUMachine pc_machine
;
997 extern QEMUMachine isapc_machine
;
998 extern int fd_bootchk
;
1000 void ioport_set_a20(int enable
);
1001 int ioport_get_a20(void);
1004 extern QEMUMachine prep_machine
;
1005 extern QEMUMachine core99_machine
;
1006 extern QEMUMachine heathrow_machine
;
1009 extern QEMUMachine mips_machine
;
1012 extern QEMUMachine shix_machine
;
1015 ppc_tb_t
*cpu_ppc_tb_init (CPUState
*env
, uint32_t freq
);
1017 void PREP_debug_write (void *opaque
, uint32_t addr
, uint32_t val
);
1019 extern CPUWriteMemoryFunc
*PPC_io_write
[];
1020 extern CPUReadMemoryFunc
*PPC_io_read
[];
1021 void PPC_debug_write (void *opaque
, uint32_t addr
, uint32_t val
);
1024 extern QEMUMachine sun4m_machine
;
1025 uint32_t iommu_translate(uint32_t addr
);
1026 void pic_set_irq_cpu(int irq
, int level
, unsigned int cpu
);
1029 void *iommu_init(uint32_t addr
);
1030 uint32_t iommu_translate_local(void *opaque
, uint32_t addr
);
1033 void lance_init(NICInfo
*nd
, int irq
, uint32_t leaddr
, uint32_t ledaddr
);
1036 void tcx_init(DisplayState
*ds
, uint32_t addr
, uint8_t *vram_base
,
1037 unsigned long vram_offset
, int vram_size
, int width
, int height
);
1039 /* slavio_intctl.c */
1040 void *slavio_intctl_init();
1041 void slavio_intctl_set_cpu(void *opaque
, unsigned int cpu
, CPUState
*env
);
1042 void slavio_pic_info(void *opaque
);
1043 void slavio_irq_info(void *opaque
);
1044 void slavio_pic_set_irq(void *opaque
, int irq
, int level
);
1045 void slavio_pic_set_irq_cpu(void *opaque
, int irq
, int level
, unsigned int cpu
);
1048 int get_image_size(const char *filename
);
1049 int load_image(const char *filename
, uint8_t *addr
);
1050 int load_elf(const char *filename
, int64_t virt_to_phys_addend
, uint64_t *pentry
);
1051 int load_aout(const char *filename
, uint8_t *addr
);
1053 /* slavio_timer.c */
1054 void slavio_timer_init(uint32_t addr
, int irq
, int mode
, unsigned int cpu
);
1056 /* slavio_serial.c */
1057 SerialState
*slavio_serial_init(int base
, int irq
, CharDriverState
*chr1
, CharDriverState
*chr2
);
1058 void slavio_serial_ms_kbd_init(int base
, int irq
);
1061 void *slavio_misc_init(uint32_t base
, int irq
);
1062 void slavio_set_power_fail(void *opaque
, int power_failing
);
1065 void esp_init(BlockDriverState
**bd
, int irq
, uint32_t espaddr
, uint32_t espdaddr
);
1068 extern QEMUMachine sun4u_machine
;
1071 #include "hw/m48t59.h"
1073 void NVRAM_set_byte (m48t59_t
*nvram
, uint32_t addr
, uint8_t value
);
1074 uint8_t NVRAM_get_byte (m48t59_t
*nvram
, uint32_t addr
);
1075 void NVRAM_set_word (m48t59_t
*nvram
, uint32_t addr
, uint16_t value
);
1076 uint16_t NVRAM_get_word (m48t59_t
*nvram
, uint32_t addr
);
1077 void NVRAM_set_lword (m48t59_t
*nvram
, uint32_t addr
, uint32_t value
);
1078 uint32_t NVRAM_get_lword (m48t59_t
*nvram
, uint32_t addr
);
1079 void NVRAM_set_string (m48t59_t
*nvram
, uint32_t addr
,
1080 const unsigned char *str
, uint32_t max
);
1081 int NVRAM_get_string (m48t59_t
*nvram
, uint8_t *dst
, uint16_t addr
, int max
);
1082 void NVRAM_set_crc (m48t59_t
*nvram
, uint32_t addr
,
1083 uint32_t start
, uint32_t count
);
1084 int PPC_NVRAM_set_params (m48t59_t
*nvram
, uint16_t NVRAM_size
,
1085 const unsigned char *arch
,
1086 uint32_t RAM_size
, int boot_device
,
1087 uint32_t kernel_image
, uint32_t kernel_size
,
1088 const char *cmdline
,
1089 uint32_t initrd_image
, uint32_t initrd_size
,
1090 uint32_t NVRAM_image
,
1091 int width
, int height
, int depth
);
1095 #define MAX_ADB_DEVICES 16
1097 #define ADB_MAX_OUT_LEN 16
1099 typedef struct ADBDevice ADBDevice
;
1101 /* buf = NULL means polling */
1102 typedef int ADBDeviceRequest(ADBDevice
*d
, uint8_t *buf_out
,
1103 const uint8_t *buf
, int len
);
1104 typedef int ADBDeviceReset(ADBDevice
*d
);
1107 struct ADBBusState
*bus
;
1110 ADBDeviceRequest
*devreq
;
1111 ADBDeviceReset
*devreset
;
1115 typedef struct ADBBusState
{
1116 ADBDevice devices
[MAX_ADB_DEVICES
];
1121 int adb_request(ADBBusState
*s
, uint8_t *buf_out
,
1122 const uint8_t *buf
, int len
);
1123 int adb_poll(ADBBusState
*s
, uint8_t *buf_out
);
1125 ADBDevice
*adb_register_device(ADBBusState
*s
, int devaddr
,
1126 ADBDeviceRequest
*devreq
,
1127 ADBDeviceReset
*devreset
,
1129 void adb_kbd_init(ADBBusState
*bus
);
1130 void adb_mouse_init(ADBBusState
*bus
);
1134 extern ADBBusState adb_bus
;
1135 int cuda_init(SetIRQFunc
*set_irq
, void *irq_opaque
, int irq
);
1139 /* usb ports of the VM */
1141 void qemu_register_usb_port(USBPort
*port
, void *opaque
, int index
,
1142 usb_attachfn attach
);
1144 #define VM_USB_HUB_SIZE 8
1146 void do_usb_add(const char *devname
);
1147 void do_usb_del(const char *devname
);
1148 void usb_info(void);
1151 typedef struct SCSIDevice SCSIDevice
;
1152 typedef void (*scsi_completionfn
)(void *, uint32_t, int);
1154 SCSIDevice
*scsi_disk_init(BlockDriverState
*bdrv
,
1155 scsi_completionfn completion
,
1157 void scsi_disk_destroy(SCSIDevice
*s
);
1159 int32_t scsi_send_command(SCSIDevice
*s
, uint32_t tag
, uint8_t *buf
, int lun
);
1160 int scsi_read_data(SCSIDevice
*s
, uint8_t *data
, uint32_t len
);
1161 int scsi_write_data(SCSIDevice
*s
, uint8_t *data
, uint32_t len
);
1164 void lsi_scsi_attach(void *opaque
, BlockDriverState
*bd
, int id
);
1165 void *lsi_scsi_init(PCIBus
*bus
, int devfn
);
1167 /* integratorcp.c */
1168 extern QEMUMachine integratorcp926_machine
;
1169 extern QEMUMachine integratorcp1026_machine
;
1172 extern QEMUMachine versatilepb_machine
;
1173 extern QEMUMachine versatileab_machine
;
1176 void *ps2_kbd_init(void (*update_irq
)(void *, int), void *update_arg
);
1177 void *ps2_mouse_init(void (*update_irq
)(void *, int), void *update_arg
);
1178 void ps2_write_mouse(void *, int val
);
1179 void ps2_write_keyboard(void *, int val
);
1180 uint32_t ps2_read_data(void *);
1181 void ps2_queue(void *, int b
);
1182 void ps2_keyboard_set_translation(void *opaque
, int mode
);
1185 void smc91c111_init(NICInfo
*, uint32_t, void *, int);
1188 void *pl110_init(DisplayState
*ds
, uint32_t base
, void *pic
, int irq
, int);
1191 void pl011_init(uint32_t base
, void *pic
, int irq
, CharDriverState
*chr
);
1194 void pl050_init(uint32_t base
, void *pic
, int irq
, int is_mouse
);
1197 void *pl080_init(uint32_t base
, void *pic
, int irq
);
1200 void *pl190_init(uint32_t base
, void *parent
, int irq
, int fiq
);
1203 void sp804_init(uint32_t base
, void *pic
, int irq
);
1204 void icp_pit_init(uint32_t base
, void *pic
, int irq
);
1208 void arm_load_kernel(int ram_size
, const char *kernel_filename
,
1209 const char *kernel_cmdline
, const char *initrd_filename
,
1215 struct SH7750State
*sh7750_init(CPUState
* cpu
);
1218 /* The callback will be triggered if any of the designated lines change */
1219 uint16_t portamask_trigger
;
1220 uint16_t portbmask_trigger
;
1221 /* Return 0 if no action was taken */
1222 int (*port_change_cb
) (uint16_t porta
, uint16_t portb
,
1223 uint16_t * periph_pdtra
,
1224 uint16_t * periph_portdira
,
1225 uint16_t * periph_pdtrb
,
1226 uint16_t * periph_portdirb
);
1229 int sh7750_register_io_device(struct SH7750State
*s
,
1230 sh7750_io_device
* device
);
1232 int tc58128_init(struct SH7750State
*s
, char *zone1
, char *zone2
);
1234 /* NOR flash devices */
1235 typedef struct pflash_t pflash_t
;
1237 pflash_t
*pflash_register (target_ulong base
, ram_addr_t off
,
1238 BlockDriverState
*bs
,
1239 target_ulong sector_len
, int nb_blocs
, int width
,
1240 uint16_t id0
, uint16_t id1
,
1241 uint16_t id2
, uint16_t id3
);
1243 #endif /* defined(QEMU_TOOL) */
1246 void monitor_init(CharDriverState
*hd
, int show_banner
);
1247 void term_puts(const char *str
);
1248 void term_vprintf(const char *fmt
, va_list ap
);
1249 void term_printf(const char *fmt
, ...) __attribute__ ((__format__ (__printf__
, 1, 2)));
1250 void term_flush(void);
1251 void term_print_help(void);
1252 void monitor_readline(const char *prompt
, int is_password
,
1253 char *buf
, int buf_size
);
1256 typedef void ReadLineFunc(void *opaque
, const char *str
);
1258 extern int completion_index
;
1259 void add_completion(const char *str
);
1260 void readline_handle_byte(int ch
);
1261 void readline_find_completion(const char *cmdline
);
1262 const char *readline_get_history(unsigned int index
);
1263 void readline_start(const char *prompt
, int is_password
,
1264 ReadLineFunc
*readline_func
, void *opaque
);
1266 void kqemu_record_dump(void);