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 #define ENOMEDIUM 4097
54 extern int qemu_ftruncate64(int, int64_t);
55 #define ftruncate qemu_ftruncate64
58 static inline char *realpath(const char *path
, char *resolved_path
)
60 _fullpath(resolved_path
, path
, _MAX_PATH
);
72 /* we use QEMU_TOOL in the command line tools which do not depend on
73 the target CPU type */
74 #include "config-host.h"
81 #include "audio/audio.h"
85 #endif /* !defined(QEMU_TOOL) */
88 #define xglue(x, y) x ## y
89 #define glue(x, y) xglue(x, y)
90 #define stringify(s) tostring(s)
91 #define tostring(s) #s
95 #define MIN(a, b) (((a) < (b)) ? (a) : (b))
98 #define MAX(a, b) (((a) > (b)) ? (a) : (b))
102 uint64_t muldiv64(uint64_t a
, uint32_t b
, uint32_t c
);
104 void hw_error(const char *fmt
, ...);
106 extern const char *bios_dir
;
108 void pstrcpy(char *buf
, int buf_size
, const char *str
);
109 char *pstrcat(char *buf
, int buf_size
, const char *s
);
110 int strstart(const char *str
, const char *val
, const char **ptr
);
112 extern int vm_running
;
114 typedef struct vm_change_state_entry VMChangeStateEntry
;
115 typedef void VMChangeStateHandler(void *opaque
, int running
);
116 typedef void VMStopHandler(void *opaque
, int reason
);
118 VMChangeStateEntry
*qemu_add_vm_change_state_handler(VMChangeStateHandler
*cb
,
120 void qemu_del_vm_change_state_handler(VMChangeStateEntry
*e
);
122 int qemu_add_vm_stop_handler(VMStopHandler
*cb
, void *opaque
);
123 void qemu_del_vm_stop_handler(VMStopHandler
*cb
, void *opaque
);
126 void vm_stop(int reason
);
128 typedef void QEMUResetHandler(void *opaque
);
130 void qemu_register_reset(QEMUResetHandler
*func
, void *opaque
);
131 void qemu_system_reset_request(void);
132 void qemu_system_shutdown_request(void);
133 void qemu_system_powerdown_request(void);
134 #if !defined(TARGET_SPARC)
135 // Please implement a power failure function to signal the OS
136 #define qemu_system_powerdown() do{}while(0)
138 void qemu_system_powerdown(void);
141 void main_loop_wait(int timeout
);
144 extern int bios_size
;
146 extern int cirrus_vga_enabled
;
147 extern int graphic_width
;
148 extern int graphic_height
;
149 extern int graphic_depth
;
150 extern const char *keyboard_layout
;
151 extern int kqemu_allowed
;
152 extern int win2k_install_hack
;
153 extern int usb_enabled
;
156 /* XXX: make it dynamic */
157 #if defined (TARGET_PPC) || defined (TARGET_SPARC64)
158 #define BIOS_SIZE ((512 + 32) * 1024)
159 #elif defined(TARGET_MIPS)
160 #define BIOS_SIZE (128 * 1024)
162 #define BIOS_SIZE ((256 + 64) * 1024)
165 /* keyboard/mouse support */
167 #define MOUSE_EVENT_LBUTTON 0x01
168 #define MOUSE_EVENT_RBUTTON 0x02
169 #define MOUSE_EVENT_MBUTTON 0x04
171 typedef void QEMUPutKBDEvent(void *opaque
, int keycode
);
172 typedef void QEMUPutMouseEvent(void *opaque
, int dx
, int dy
, int dz
, int buttons_state
);
174 void qemu_add_kbd_event_handler(QEMUPutKBDEvent
*func
, void *opaque
);
175 void qemu_add_mouse_event_handler(QEMUPutMouseEvent
*func
, void *opaque
, int absolute
);
177 void kbd_put_keycode(int keycode
);
178 void kbd_mouse_event(int dx
, int dy
, int dz
, int buttons_state
);
179 int kbd_mouse_is_absolute(void);
181 /* keysym is a unicode code except for special keys (see QEMU_KEY_xxx
183 #define QEMU_KEY_ESC1(c) ((c) | 0xe100)
184 #define QEMU_KEY_BACKSPACE 0x007f
185 #define QEMU_KEY_UP QEMU_KEY_ESC1('A')
186 #define QEMU_KEY_DOWN QEMU_KEY_ESC1('B')
187 #define QEMU_KEY_RIGHT QEMU_KEY_ESC1('C')
188 #define QEMU_KEY_LEFT QEMU_KEY_ESC1('D')
189 #define QEMU_KEY_HOME QEMU_KEY_ESC1(1)
190 #define QEMU_KEY_END QEMU_KEY_ESC1(4)
191 #define QEMU_KEY_PAGEUP QEMU_KEY_ESC1(5)
192 #define QEMU_KEY_PAGEDOWN QEMU_KEY_ESC1(6)
193 #define QEMU_KEY_DELETE QEMU_KEY_ESC1(3)
195 #define QEMU_KEY_CTRL_UP 0xe400
196 #define QEMU_KEY_CTRL_DOWN 0xe401
197 #define QEMU_KEY_CTRL_LEFT 0xe402
198 #define QEMU_KEY_CTRL_RIGHT 0xe403
199 #define QEMU_KEY_CTRL_HOME 0xe404
200 #define QEMU_KEY_CTRL_END 0xe405
201 #define QEMU_KEY_CTRL_PAGEUP 0xe406
202 #define QEMU_KEY_CTRL_PAGEDOWN 0xe407
204 void kbd_put_keysym(int keysym
);
206 /* async I/O support */
208 typedef void IOReadHandler(void *opaque
, const uint8_t *buf
, int size
);
209 typedef int IOCanRWHandler(void *opaque
);
210 typedef void IOHandler(void *opaque
);
212 int qemu_set_fd_handler2(int fd
,
213 IOCanRWHandler
*fd_read_poll
,
217 int qemu_set_fd_handler(int fd
,
222 /* Polling handling */
224 /* return TRUE if no sleep should be done afterwards */
225 typedef int PollingFunc(void *opaque
);
227 int qemu_add_polling_cb(PollingFunc
*func
, void *opaque
);
228 void qemu_del_polling_cb(PollingFunc
*func
, void *opaque
);
231 /* Wait objects handling */
232 typedef void WaitObjectFunc(void *opaque
);
234 int qemu_add_wait_object(HANDLE handle
, WaitObjectFunc
*func
, void *opaque
);
235 void qemu_del_wait_object(HANDLE handle
, WaitObjectFunc
*func
, void *opaque
);
238 /* character device */
240 #define CHR_EVENT_BREAK 0 /* serial break char */
241 #define CHR_EVENT_FOCUS 1 /* focus to this terminal (modal input needed) */
245 #define CHR_IOCTL_SERIAL_SET_PARAMS 1
251 } QEMUSerialSetParams
;
253 #define CHR_IOCTL_SERIAL_SET_BREAK 2
255 #define CHR_IOCTL_PP_READ_DATA 3
256 #define CHR_IOCTL_PP_WRITE_DATA 4
257 #define CHR_IOCTL_PP_READ_CONTROL 5
258 #define CHR_IOCTL_PP_WRITE_CONTROL 6
259 #define CHR_IOCTL_PP_READ_STATUS 7
261 typedef void IOEventHandler(void *opaque
, int event
);
263 typedef struct CharDriverState
{
264 int (*chr_write
)(struct CharDriverState
*s
, const uint8_t *buf
, int len
);
265 void (*chr_add_read_handler
)(struct CharDriverState
*s
,
266 IOCanRWHandler
*fd_can_read
,
267 IOReadHandler
*fd_read
, void *opaque
);
268 int (*chr_ioctl
)(struct CharDriverState
*s
, int cmd
, void *arg
);
269 IOEventHandler
*chr_event
;
270 void (*chr_send_event
)(struct CharDriverState
*chr
, int event
);
271 void (*chr_close
)(struct CharDriverState
*chr
);
275 void qemu_chr_printf(CharDriverState
*s
, const char *fmt
, ...);
276 int qemu_chr_write(CharDriverState
*s
, const uint8_t *buf
, int len
);
277 void qemu_chr_send_event(CharDriverState
*s
, int event
);
278 void qemu_chr_add_read_handler(CharDriverState
*s
,
279 IOCanRWHandler
*fd_can_read
,
280 IOReadHandler
*fd_read
, void *opaque
);
281 void qemu_chr_add_event_handler(CharDriverState
*s
, IOEventHandler
*chr_event
);
282 int qemu_chr_ioctl(CharDriverState
*s
, int cmd
, void *arg
);
286 typedef struct DisplayState DisplayState
;
287 typedef struct TextConsole TextConsole
;
289 typedef void (*vga_hw_update_ptr
)(void *);
290 typedef void (*vga_hw_invalidate_ptr
)(void *);
291 typedef void (*vga_hw_screen_dump_ptr
)(void *, const char *);
293 TextConsole
*graphic_console_init(DisplayState
*ds
, vga_hw_update_ptr update
,
294 vga_hw_invalidate_ptr invalidate
,
295 vga_hw_screen_dump_ptr screen_dump
,
297 void vga_hw_update(void);
298 void vga_hw_invalidate(void);
299 void vga_hw_screen_dump(const char *filename
);
301 int is_graphic_console(void);
302 CharDriverState
*text_console_init(DisplayState
*ds
);
303 void console_select(unsigned int index
);
307 #define MAX_SERIAL_PORTS 4
309 extern CharDriverState
*serial_hds
[MAX_SERIAL_PORTS
];
313 #define MAX_PARALLEL_PORTS 3
315 extern CharDriverState
*parallel_hds
[MAX_PARALLEL_PORTS
];
319 typedef struct VLANClientState VLANClientState
;
321 struct VLANClientState
{
322 IOReadHandler
*fd_read
;
323 /* Packets may still be sent if this returns zero. It's used to
324 rate-limit the slirp code. */
325 IOCanRWHandler
*fd_can_read
;
327 struct VLANClientState
*next
;
328 struct VLANState
*vlan
;
332 typedef struct VLANState
{
334 VLANClientState
*first_client
;
335 struct VLANState
*next
;
338 VLANState
*qemu_find_vlan(int id
);
339 VLANClientState
*qemu_new_vlan_client(VLANState
*vlan
,
340 IOReadHandler
*fd_read
,
341 IOCanRWHandler
*fd_can_read
,
343 int qemu_can_send_packet(VLANClientState
*vc
);
344 void qemu_send_packet(VLANClientState
*vc
, const uint8_t *buf
, int size
);
345 void qemu_handler_true(void *opaque
);
347 void do_info_network(void);
350 int tap_win32_init(VLANState
*vlan
, const char *ifname
);
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 int qemu_bh_poll(void);
501 typedef struct BlockDriverState BlockDriverState
;
502 typedef struct BlockDriver BlockDriver
;
504 extern BlockDriver bdrv_raw
;
505 extern BlockDriver bdrv_host_device
;
506 extern BlockDriver bdrv_cow
;
507 extern BlockDriver bdrv_qcow
;
508 extern BlockDriver bdrv_vmdk
;
509 extern BlockDriver bdrv_cloop
;
510 extern BlockDriver bdrv_dmg
;
511 extern BlockDriver bdrv_bochs
;
512 extern BlockDriver bdrv_vpc
;
513 extern BlockDriver bdrv_vvfat
;
514 extern BlockDriver bdrv_qcow2
;
516 typedef struct BlockDriverInfo
{
517 /* in bytes, 0 if irrelevant */
519 /* offset at which the VM state can be saved (0 if not possible) */
520 int64_t vm_state_offset
;
523 typedef struct QEMUSnapshotInfo
{
524 char id_str
[128]; /* unique snapshot id */
525 /* the following fields are informative. They are not needed for
526 the consistency of the snapshot */
527 char name
[256]; /* user choosen name */
528 uint32_t vm_state_size
; /* VM state info size */
529 uint32_t date_sec
; /* UTC date of the snapshot */
531 uint64_t vm_clock_nsec
; /* VM clock relative to boot */
534 #define BDRV_O_RDONLY 0x0000
535 #define BDRV_O_RDWR 0x0002
536 #define BDRV_O_ACCESS 0x0003
537 #define BDRV_O_CREAT 0x0004 /* create an empty file */
538 #define BDRV_O_SNAPSHOT 0x0008 /* open the file read only and save writes in a snapshot */
539 #define BDRV_O_FILE 0x0010 /* open as a raw file (do not try to
540 use a disk image format on top of
544 void bdrv_init(void);
545 BlockDriver
*bdrv_find_format(const char *format_name
);
546 int bdrv_create(BlockDriver
*drv
,
547 const char *filename
, int64_t size_in_sectors
,
548 const char *backing_file
, int flags
);
549 BlockDriverState
*bdrv_new(const char *device_name
);
550 void bdrv_delete(BlockDriverState
*bs
);
551 int bdrv_file_open(BlockDriverState
**pbs
, const char *filename
, int flags
);
552 int bdrv_open(BlockDriverState
*bs
, const char *filename
, int flags
);
553 int bdrv_open2(BlockDriverState
*bs
, const char *filename
, int flags
,
555 void bdrv_close(BlockDriverState
*bs
);
556 int bdrv_read(BlockDriverState
*bs
, int64_t sector_num
,
557 uint8_t *buf
, int nb_sectors
);
558 int bdrv_write(BlockDriverState
*bs
, int64_t sector_num
,
559 const uint8_t *buf
, int nb_sectors
);
560 int bdrv_pread(BlockDriverState
*bs
, int64_t offset
,
561 void *buf
, int count
);
562 int bdrv_pwrite(BlockDriverState
*bs
, int64_t offset
,
563 const void *buf
, int count
);
564 int bdrv_truncate(BlockDriverState
*bs
, int64_t offset
);
565 int64_t bdrv_getlength(BlockDriverState
*bs
);
566 void bdrv_get_geometry(BlockDriverState
*bs
, int64_t *nb_sectors_ptr
);
567 int bdrv_commit(BlockDriverState
*bs
);
568 void bdrv_set_boot_sector(BlockDriverState
*bs
, const uint8_t *data
, int size
);
569 /* async block I/O */
570 typedef struct BlockDriverAIOCB BlockDriverAIOCB
;
571 typedef void BlockDriverCompletionFunc(void *opaque
, int ret
);
573 BlockDriverAIOCB
*bdrv_aio_read(BlockDriverState
*bs
, int64_t sector_num
,
574 uint8_t *buf
, int nb_sectors
,
575 BlockDriverCompletionFunc
*cb
, void *opaque
);
576 BlockDriverAIOCB
*bdrv_aio_write(BlockDriverState
*bs
, int64_t sector_num
,
577 const uint8_t *buf
, int nb_sectors
,
578 BlockDriverCompletionFunc
*cb
, void *opaque
);
579 void bdrv_aio_cancel(BlockDriverAIOCB
*acb
);
581 void qemu_aio_init(void);
582 void qemu_aio_poll(void);
583 void qemu_aio_flush(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_media_changed(BlockDriverState
*bs
);
610 int bdrv_is_locked(BlockDriverState
*bs
);
611 void bdrv_set_locked(BlockDriverState
*bs
, int locked
);
612 void bdrv_eject(BlockDriverState
*bs
, int eject_flag
);
613 void bdrv_set_change_cb(BlockDriverState
*bs
,
614 void (*change_cb
)(void *opaque
), void *opaque
);
615 void bdrv_get_format(BlockDriverState
*bs
, char *buf
, int buf_size
);
616 void bdrv_info(void);
617 BlockDriverState
*bdrv_find(const char *name
);
618 void bdrv_iterate(void (*it
)(void *opaque
, const char *name
), void *opaque
);
619 int bdrv_is_encrypted(BlockDriverState
*bs
);
620 int bdrv_set_key(BlockDriverState
*bs
, const char *key
);
621 void bdrv_iterate_format(void (*it
)(void *opaque
, const char *name
),
623 const char *bdrv_get_device_name(BlockDriverState
*bs
);
624 int bdrv_write_compressed(BlockDriverState
*bs
, int64_t sector_num
,
625 const uint8_t *buf
, int nb_sectors
);
626 int bdrv_get_info(BlockDriverState
*bs
, BlockDriverInfo
*bdi
);
628 void bdrv_get_backing_filename(BlockDriverState
*bs
,
629 char *filename
, int filename_size
);
630 int bdrv_snapshot_create(BlockDriverState
*bs
,
631 QEMUSnapshotInfo
*sn_info
);
632 int bdrv_snapshot_goto(BlockDriverState
*bs
,
633 const char *snapshot_id
);
634 int bdrv_snapshot_delete(BlockDriverState
*bs
, const char *snapshot_id
);
635 int bdrv_snapshot_list(BlockDriverState
*bs
,
636 QEMUSnapshotInfo
**psn_info
);
637 char *bdrv_snapshot_dump(char *buf
, int buf_size
, QEMUSnapshotInfo
*sn
);
639 char *get_human_readable_size(char *buf
, int buf_size
, int64_t size
);
640 int path_is_absolute(const char *path
);
641 void path_combine(char *dest
, int dest_size
,
642 const char *base_path
,
643 const char *filename
);
647 typedef void QEMUMachineInitFunc(int ram_size
, int vga_ram_size
,
649 DisplayState
*ds
, const char **fd_filename
, int snapshot
,
650 const char *kernel_filename
, const char *kernel_cmdline
,
651 const char *initrd_filename
);
653 typedef struct QEMUMachine
{
656 QEMUMachineInitFunc
*init
;
657 struct QEMUMachine
*next
;
660 int qemu_register_machine(QEMUMachine
*m
);
662 typedef void SetIRQFunc(void *opaque
, int irq_num
, int level
);
663 typedef void IRQRequestFunc(void *opaque
, int level
);
667 extern target_phys_addr_t isa_mem_base
;
669 typedef void (IOPortWriteFunc
)(void *opaque
, uint32_t address
, uint32_t data
);
670 typedef uint32_t (IOPortReadFunc
)(void *opaque
, uint32_t address
);
672 int register_ioport_read(int start
, int length
, int size
,
673 IOPortReadFunc
*func
, void *opaque
);
674 int register_ioport_write(int start
, int length
, int size
,
675 IOPortWriteFunc
*func
, void *opaque
);
676 void isa_unassign_ioport(int start
, int length
);
680 extern target_phys_addr_t pci_mem_base
;
682 typedef struct PCIBus PCIBus
;
683 typedef struct PCIDevice PCIDevice
;
685 typedef void PCIConfigWriteFunc(PCIDevice
*pci_dev
,
686 uint32_t address
, uint32_t data
, int len
);
687 typedef uint32_t PCIConfigReadFunc(PCIDevice
*pci_dev
,
688 uint32_t address
, int len
);
689 typedef void PCIMapIORegionFunc(PCIDevice
*pci_dev
, int region_num
,
690 uint32_t addr
, uint32_t size
, int type
);
692 #define PCI_ADDRESS_SPACE_MEM 0x00
693 #define PCI_ADDRESS_SPACE_IO 0x01
694 #define PCI_ADDRESS_SPACE_MEM_PREFETCH 0x08
696 typedef struct PCIIORegion
{
697 uint32_t addr
; /* current PCI mapping address. -1 means not mapped */
700 PCIMapIORegionFunc
*map_func
;
703 #define PCI_ROM_SLOT 6
704 #define PCI_NUM_REGIONS 7
706 #define PCI_DEVICES_MAX 64
708 #define PCI_VENDOR_ID 0x00 /* 16 bits */
709 #define PCI_DEVICE_ID 0x02 /* 16 bits */
710 #define PCI_COMMAND 0x04 /* 16 bits */
711 #define PCI_COMMAND_IO 0x1 /* Enable response in I/O space */
712 #define PCI_COMMAND_MEMORY 0x2 /* Enable response in Memory space */
713 #define PCI_CLASS_DEVICE 0x0a /* Device class */
714 #define PCI_INTERRUPT_LINE 0x3c /* 8 bits */
715 #define PCI_INTERRUPT_PIN 0x3d /* 8 bits */
716 #define PCI_MIN_GNT 0x3e /* 8 bits */
717 #define PCI_MAX_LAT 0x3f /* 8 bits */
720 /* PCI config space */
723 /* the following fields are read only */
727 PCIIORegion io_regions
[PCI_NUM_REGIONS
];
729 /* do not access the following fields */
730 PCIConfigReadFunc
*config_read
;
731 PCIConfigWriteFunc
*config_write
;
732 /* ??? This is a PC-specific hack, and should be removed. */
736 PCIDevice
*pci_register_device(PCIBus
*bus
, const char *name
,
737 int instance_size
, int devfn
,
738 PCIConfigReadFunc
*config_read
,
739 PCIConfigWriteFunc
*config_write
);
741 void pci_register_io_region(PCIDevice
*pci_dev
, int region_num
,
742 uint32_t size
, int type
,
743 PCIMapIORegionFunc
*map_func
);
745 void pci_set_irq(PCIDevice
*pci_dev
, int irq_num
, int level
);
747 uint32_t pci_default_read_config(PCIDevice
*d
,
748 uint32_t address
, int len
);
749 void pci_default_write_config(PCIDevice
*d
,
750 uint32_t address
, uint32_t val
, int len
);
751 void pci_device_save(PCIDevice
*s
, QEMUFile
*f
);
752 int pci_device_load(PCIDevice
*s
, QEMUFile
*f
);
754 typedef void (*pci_set_irq_fn
)(PCIDevice
*pci_dev
, void *pic
,
755 int irq_num
, int level
);
756 PCIBus
*pci_register_bus(pci_set_irq_fn set_irq
, void *pic
, int devfn_min
);
758 void pci_nic_init(PCIBus
*bus
, NICInfo
*nd
);
759 void pci_data_write(void *opaque
, uint32_t addr
, uint32_t val
, int len
);
760 uint32_t pci_data_read(void *opaque
, uint32_t addr
, int len
);
761 int pci_bus_num(PCIBus
*s
);
762 void pci_for_each_device(void (*fn
)(PCIDevice
*d
));
767 PCIBus
*pci_prep_init(void);
770 PCIBus
*pci_grackle_init(uint32_t base
, void *pic
);
773 PCIBus
*pci_pmac_init(void *pic
);
776 PCIBus
*pci_apb_init(target_ulong special_base
, target_ulong mem_base
,
779 PCIBus
*pci_vpb_init(void *pic
);
782 PCIBus
*i440fx_init(void);
783 int piix3_init(PCIBus
*bus
);
784 void pci_bios_init(void);
787 typedef struct openpic_t openpic_t
;
788 void openpic_set_irq(void *opaque
, int n_IRQ
, int level
);
789 openpic_t
*openpic_init (PCIBus
*bus
, int *pmem_index
, int nb_cpus
,
793 typedef struct HeathrowPICS HeathrowPICS
;
794 void heathrow_pic_set_irq(void *opaque
, int num
, int level
);
795 HeathrowPICS
*heathrow_pic_init(int *pmem_index
);
804 int (*init_isa
) (AudioState
*s
);
805 int (*init_pci
) (PCIBus
*bus
, AudioState
*s
);
809 extern struct soundhw soundhw
[];
814 #define VGA_RAM_SIZE (8192 * 1024)
816 struct DisplayState
{
820 int bgr
; /* BGR color order instead of RGB. Only valid for depth == 32 */
825 void (*dpy_update
)(struct DisplayState
*s
, int x
, int y
, int w
, int h
);
826 void (*dpy_resize
)(struct DisplayState
*s
, int w
, int h
);
827 void (*dpy_refresh
)(struct DisplayState
*s
);
828 void (*dpy_copy
)(struct DisplayState
*s
, int src_x
, int src_y
, int dst_x
, int dst_y
, int w
, int h
);
831 static inline void dpy_update(DisplayState
*s
, int x
, int y
, int w
, int h
)
833 s
->dpy_update(s
, x
, y
, w
, h
);
836 static inline void dpy_resize(DisplayState
*s
, int w
, int h
)
838 s
->dpy_resize(s
, w
, h
);
841 int isa_vga_init(DisplayState
*ds
, uint8_t *vga_ram_base
,
842 unsigned long vga_ram_offset
, int vga_ram_size
);
843 int pci_vga_init(PCIBus
*bus
, DisplayState
*ds
, uint8_t *vga_ram_base
,
844 unsigned long vga_ram_offset
, int vga_ram_size
,
845 unsigned long vga_bios_offset
, int vga_bios_size
);
848 void pci_cirrus_vga_init(PCIBus
*bus
, DisplayState
*ds
, uint8_t *vga_ram_base
,
849 unsigned long vga_ram_offset
, int vga_ram_size
);
850 void isa_cirrus_vga_init(DisplayState
*ds
, uint8_t *vga_ram_base
,
851 unsigned long vga_ram_offset
, int vga_ram_size
);
854 void sdl_display_init(DisplayState
*ds
, int full_screen
);
857 void cocoa_display_init(DisplayState
*ds
, int full_screen
);
860 void vnc_display_init(DisplayState
*ds
, int display
);
865 extern BlockDriverState
*bs_table
[MAX_DISKS
+ 1];
867 void isa_ide_init(int iobase
, int iobase2
, int irq
,
868 BlockDriverState
*hd0
, BlockDriverState
*hd1
);
869 void pci_cmd646_ide_init(PCIBus
*bus
, BlockDriverState
**hd_table
,
870 int secondary_ide_enabled
);
871 void pci_piix3_ide_init(PCIBus
*bus
, BlockDriverState
**hd_table
, int devfn
);
872 int pmac_ide_init (BlockDriverState
**hd_table
,
873 SetIRQFunc
*set_irq
, void *irq_opaque
, int irq
);
876 int cdrom_read_toc(int nb_sectors
, uint8_t *buf
, int msf
, int start_track
);
877 int cdrom_read_toc_raw(int nb_sectors
, uint8_t *buf
, int msf
, int session_num
);
880 int es1370_init (PCIBus
*bus
, AudioState
*s
);
883 int SB16_init (AudioState
*s
);
886 int Adlib_init (AudioState
*s
);
889 int GUS_init (AudioState
*s
);
892 typedef int (*DMA_transfer_handler
) (void *opaque
, int nchan
, int pos
, int size
);
893 int DMA_get_channel_mode (int nchan
);
894 int DMA_read_memory (int nchan
, void *buf
, int pos
, int size
);
895 int DMA_write_memory (int nchan
, void *buf
, int pos
, int size
);
896 void DMA_hold_DREQ (int nchan
);
897 void DMA_release_DREQ (int nchan
);
898 void DMA_schedule(int nchan
);
900 void DMA_init (int high_page_enable
);
901 void DMA_register_channel (int nchan
,
902 DMA_transfer_handler transfer_handler
,
906 extern BlockDriverState
*fd_table
[MAX_FD
];
908 typedef struct fdctrl_t fdctrl_t
;
910 fdctrl_t
*fdctrl_init (int irq_lvl
, int dma_chann
, int mem_mapped
,
912 BlockDriverState
**fds
);
913 int fdctrl_get_drive_type(fdctrl_t
*fdctrl
, int drive_num
);
917 void isa_ne2000_init(int base
, int irq
, NICInfo
*nd
);
918 void pci_ne2000_init(PCIBus
*bus
, NICInfo
*nd
);
922 void pci_rtl8139_init(PCIBus
*bus
, NICInfo
*nd
);
926 void pci_pcnet_init(PCIBus
*bus
, NICInfo
*nd
);
934 typedef struct RTCState RTCState
;
936 RTCState
*rtc_init(int base
, int irq
);
937 void rtc_set_memory(RTCState
*s
, int addr
, int val
);
938 void rtc_set_date(RTCState
*s
, const struct tm
*tm
);
942 typedef struct SerialState SerialState
;
943 SerialState
*serial_init(SetIRQFunc
*set_irq
, void *opaque
,
944 int base
, int irq
, CharDriverState
*chr
);
945 SerialState
*serial_mm_init (SetIRQFunc
*set_irq
, void *opaque
,
946 target_ulong base
, int it_shift
,
947 int irq
, CharDriverState
*chr
);
951 typedef struct ParallelState ParallelState
;
952 ParallelState
*parallel_init(int base
, int irq
, CharDriverState
*chr
);
956 typedef struct PicState2 PicState2
;
957 extern PicState2
*isa_pic
;
958 void pic_set_irq(int irq
, int level
);
959 void pic_set_irq_new(void *opaque
, int irq
, int level
);
960 PicState2
*pic_init(IRQRequestFunc
*irq_request
, void *irq_request_opaque
);
961 void pic_set_alt_irq_func(PicState2
*s
, SetIRQFunc
*alt_irq_func
,
962 void *alt_irq_opaque
);
963 int pic_read_irq(PicState2
*s
);
964 void pic_update_irq(PicState2
*s
);
965 uint32_t pic_intack_read(PicState2
*s
);
970 typedef struct IOAPICState IOAPICState
;
972 int apic_init(CPUState
*env
);
973 int apic_get_interrupt(CPUState
*env
);
974 IOAPICState
*ioapic_init(void);
975 void ioapic_set_irq(void *opaque
, int vector
, int level
);
979 #define PIT_FREQ 1193182
981 typedef struct PITState PITState
;
983 PITState
*pit_init(int base
, int irq
);
984 void pit_set_gate(PITState
*pit
, int channel
, int val
);
985 int pit_get_gate(PITState
*pit
, int channel
);
986 int pit_get_initial_count(PITState
*pit
, int channel
);
987 int pit_get_mode(PITState
*pit
, int channel
);
988 int pit_get_out(PITState
*pit
, int channel
, int64_t current_time
);
991 void pcspk_init(PITState
*);
992 int pcspk_audio_init(AudioState
*);
995 extern int acpi_enabled
;
996 void piix4_pm_init(PCIBus
*bus
, int devfn
);
997 void acpi_bios_init(void);
1000 extern QEMUMachine pc_machine
;
1001 extern QEMUMachine isapc_machine
;
1002 extern int fd_bootchk
;
1004 void ioport_set_a20(int enable
);
1005 int ioport_get_a20(void);
1008 extern QEMUMachine prep_machine
;
1009 extern QEMUMachine core99_machine
;
1010 extern QEMUMachine heathrow_machine
;
1013 extern QEMUMachine mips_machine
;
1016 extern QEMUMachine shix_machine
;
1019 ppc_tb_t
*cpu_ppc_tb_init (CPUState
*env
, uint32_t freq
);
1021 void PREP_debug_write (void *opaque
, uint32_t addr
, uint32_t val
);
1023 extern CPUWriteMemoryFunc
*PPC_io_write
[];
1024 extern CPUReadMemoryFunc
*PPC_io_read
[];
1025 void PPC_debug_write (void *opaque
, uint32_t addr
, uint32_t val
);
1028 extern QEMUMachine sun4m_machine
;
1029 void pic_set_irq_cpu(int irq
, int level
, unsigned int cpu
);
1030 /* ??? Remove iommu_translate once lance emulation has been converted. */
1031 uint32_t iommu_translate(uint32_t addr
);
1032 void sparc_iommu_memory_read(target_phys_addr_t addr
,
1033 uint8_t *buf
, int len
);
1034 void sparc_iommu_memory_write(target_phys_addr_t addr
,
1035 uint8_t *buf
, int len
);
1038 void *iommu_init(uint32_t addr
);
1039 /* ??? Remove iommu_translate_local. */
1040 uint32_t iommu_translate_local(void *opaque
, uint32_t addr
);
1041 void sparc_iommu_memory_rw_local(void *opaque
, target_phys_addr_t addr
,
1042 uint8_t *buf
, int len
, int is_write
);
1045 void lance_init(NICInfo
*nd
, int irq
, uint32_t leaddr
, uint32_t ledaddr
);
1048 void tcx_init(DisplayState
*ds
, uint32_t addr
, uint8_t *vram_base
,
1049 unsigned long vram_offset
, int vram_size
, int width
, int height
);
1051 /* slavio_intctl.c */
1052 void *slavio_intctl_init();
1053 void slavio_intctl_set_cpu(void *opaque
, unsigned int cpu
, CPUState
*env
);
1054 void slavio_pic_info(void *opaque
);
1055 void slavio_irq_info(void *opaque
);
1056 void slavio_pic_set_irq(void *opaque
, int irq
, int level
);
1057 void slavio_pic_set_irq_cpu(void *opaque
, int irq
, int level
, unsigned int cpu
);
1060 int get_image_size(const char *filename
);
1061 int load_image(const char *filename
, uint8_t *addr
);
1062 int load_elf(const char *filename
, int64_t virt_to_phys_addend
, uint64_t *pentry
);
1063 int load_aout(const char *filename
, uint8_t *addr
);
1065 /* slavio_timer.c */
1066 void slavio_timer_init(uint32_t addr
, int irq
, int mode
, unsigned int cpu
);
1068 /* slavio_serial.c */
1069 SerialState
*slavio_serial_init(int base
, int irq
, CharDriverState
*chr1
, CharDriverState
*chr2
);
1070 void slavio_serial_ms_kbd_init(int base
, int irq
);
1073 void *slavio_misc_init(uint32_t base
, int irq
);
1074 void slavio_set_power_fail(void *opaque
, int power_failing
);
1077 void esp_init(BlockDriverState
**bd
, int irq
, uint32_t espaddr
, uint32_t espdaddr
);
1080 extern QEMUMachine sun4u_machine
;
1083 #include "hw/m48t59.h"
1085 void NVRAM_set_byte (m48t59_t
*nvram
, uint32_t addr
, uint8_t value
);
1086 uint8_t NVRAM_get_byte (m48t59_t
*nvram
, uint32_t addr
);
1087 void NVRAM_set_word (m48t59_t
*nvram
, uint32_t addr
, uint16_t value
);
1088 uint16_t NVRAM_get_word (m48t59_t
*nvram
, uint32_t addr
);
1089 void NVRAM_set_lword (m48t59_t
*nvram
, uint32_t addr
, uint32_t value
);
1090 uint32_t NVRAM_get_lword (m48t59_t
*nvram
, uint32_t addr
);
1091 void NVRAM_set_string (m48t59_t
*nvram
, uint32_t addr
,
1092 const unsigned char *str
, uint32_t max
);
1093 int NVRAM_get_string (m48t59_t
*nvram
, uint8_t *dst
, uint16_t addr
, int max
);
1094 void NVRAM_set_crc (m48t59_t
*nvram
, uint32_t addr
,
1095 uint32_t start
, uint32_t count
);
1096 int PPC_NVRAM_set_params (m48t59_t
*nvram
, uint16_t NVRAM_size
,
1097 const unsigned char *arch
,
1098 uint32_t RAM_size
, int boot_device
,
1099 uint32_t kernel_image
, uint32_t kernel_size
,
1100 const char *cmdline
,
1101 uint32_t initrd_image
, uint32_t initrd_size
,
1102 uint32_t NVRAM_image
,
1103 int width
, int height
, int depth
);
1107 #define MAX_ADB_DEVICES 16
1109 #define ADB_MAX_OUT_LEN 16
1111 typedef struct ADBDevice ADBDevice
;
1113 /* buf = NULL means polling */
1114 typedef int ADBDeviceRequest(ADBDevice
*d
, uint8_t *buf_out
,
1115 const uint8_t *buf
, int len
);
1116 typedef int ADBDeviceReset(ADBDevice
*d
);
1119 struct ADBBusState
*bus
;
1122 ADBDeviceRequest
*devreq
;
1123 ADBDeviceReset
*devreset
;
1127 typedef struct ADBBusState
{
1128 ADBDevice devices
[MAX_ADB_DEVICES
];
1133 int adb_request(ADBBusState
*s
, uint8_t *buf_out
,
1134 const uint8_t *buf
, int len
);
1135 int adb_poll(ADBBusState
*s
, uint8_t *buf_out
);
1137 ADBDevice
*adb_register_device(ADBBusState
*s
, int devaddr
,
1138 ADBDeviceRequest
*devreq
,
1139 ADBDeviceReset
*devreset
,
1141 void adb_kbd_init(ADBBusState
*bus
);
1142 void adb_mouse_init(ADBBusState
*bus
);
1146 extern ADBBusState adb_bus
;
1147 int cuda_init(SetIRQFunc
*set_irq
, void *irq_opaque
, int irq
);
1151 /* usb ports of the VM */
1153 void qemu_register_usb_port(USBPort
*port
, void *opaque
, int index
,
1154 usb_attachfn attach
);
1156 #define VM_USB_HUB_SIZE 8
1158 void do_usb_add(const char *devname
);
1159 void do_usb_del(const char *devname
);
1160 void usb_info(void);
1164 SCSI_REASON_DONE
, /* Command complete. */
1165 SCSI_REASON_DATA
/* Transfer complete, more data required. */
1168 typedef struct SCSIDevice SCSIDevice
;
1169 typedef void (*scsi_completionfn
)(void *opaque
, int reason
, uint32_t tag
,
1172 SCSIDevice
*scsi_disk_init(BlockDriverState
*bdrv
,
1174 scsi_completionfn completion
,
1176 void scsi_disk_destroy(SCSIDevice
*s
);
1178 int32_t scsi_send_command(SCSIDevice
*s
, uint32_t tag
, uint8_t *buf
, int lun
);
1179 /* SCSI data transfers are asynchrnonous. However, unlike the block IO
1180 layer the completion routine may be called directly by
1181 scsi_{read,write}_data. */
1182 void scsi_read_data(SCSIDevice
*s
, uint32_t tag
);
1183 int scsi_write_data(SCSIDevice
*s
, uint32_t tag
);
1184 void scsi_cancel_io(SCSIDevice
*s
, uint32_t tag
);
1185 uint8_t *scsi_get_buf(SCSIDevice
*s
, uint32_t tag
);
1188 void lsi_scsi_attach(void *opaque
, BlockDriverState
*bd
, int id
);
1189 void *lsi_scsi_init(PCIBus
*bus
, int devfn
);
1191 /* integratorcp.c */
1192 extern QEMUMachine integratorcp926_machine
;
1193 extern QEMUMachine integratorcp1026_machine
;
1196 extern QEMUMachine versatilepb_machine
;
1197 extern QEMUMachine versatileab_machine
;
1200 void *ps2_kbd_init(void (*update_irq
)(void *, int), void *update_arg
);
1201 void *ps2_mouse_init(void (*update_irq
)(void *, int), void *update_arg
);
1202 void ps2_write_mouse(void *, int val
);
1203 void ps2_write_keyboard(void *, int val
);
1204 uint32_t ps2_read_data(void *);
1205 void ps2_queue(void *, int b
);
1206 void ps2_keyboard_set_translation(void *opaque
, int mode
);
1209 void smc91c111_init(NICInfo
*, uint32_t, void *, int);
1212 void *pl110_init(DisplayState
*ds
, uint32_t base
, void *pic
, int irq
, int);
1215 void pl011_init(uint32_t base
, void *pic
, int irq
, CharDriverState
*chr
);
1218 void pl050_init(uint32_t base
, void *pic
, int irq
, int is_mouse
);
1221 void *pl080_init(uint32_t base
, void *pic
, int irq
);
1224 void *pl190_init(uint32_t base
, void *parent
, int irq
, int fiq
);
1227 void sp804_init(uint32_t base
, void *pic
, int irq
);
1228 void icp_pit_init(uint32_t base
, void *pic
, int irq
);
1232 void arm_load_kernel(int ram_size
, const char *kernel_filename
,
1233 const char *kernel_cmdline
, const char *initrd_filename
,
1239 struct SH7750State
*sh7750_init(CPUState
* cpu
);
1242 /* The callback will be triggered if any of the designated lines change */
1243 uint16_t portamask_trigger
;
1244 uint16_t portbmask_trigger
;
1245 /* Return 0 if no action was taken */
1246 int (*port_change_cb
) (uint16_t porta
, uint16_t portb
,
1247 uint16_t * periph_pdtra
,
1248 uint16_t * periph_portdira
,
1249 uint16_t * periph_pdtrb
,
1250 uint16_t * periph_portdirb
);
1253 int sh7750_register_io_device(struct SH7750State
*s
,
1254 sh7750_io_device
* device
);
1256 int tc58128_init(struct SH7750State
*s
, char *zone1
, char *zone2
);
1258 /* NOR flash devices */
1259 typedef struct pflash_t pflash_t
;
1261 pflash_t
*pflash_register (target_ulong base
, ram_addr_t off
,
1262 BlockDriverState
*bs
,
1263 target_ulong sector_len
, int nb_blocs
, int width
,
1264 uint16_t id0
, uint16_t id1
,
1265 uint16_t id2
, uint16_t id3
);
1267 #endif /* defined(QEMU_TOOL) */
1270 void monitor_init(CharDriverState
*hd
, int show_banner
);
1271 void term_puts(const char *str
);
1272 void term_vprintf(const char *fmt
, va_list ap
);
1273 void term_printf(const char *fmt
, ...) __attribute__ ((__format__ (__printf__
, 1, 2)));
1274 void term_flush(void);
1275 void term_print_help(void);
1276 void monitor_readline(const char *prompt
, int is_password
,
1277 char *buf
, int buf_size
);
1280 typedef void ReadLineFunc(void *opaque
, const char *str
);
1282 extern int completion_index
;
1283 void add_completion(const char *str
);
1284 void readline_handle_byte(int ch
);
1285 void readline_find_completion(const char *cmdline
);
1286 const char *readline_get_history(unsigned int index
);
1287 void readline_start(const char *prompt
, int is_password
,
1288 ReadLineFunc
*readline_func
, void *opaque
);
1290 void kqemu_record_dump(void);