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 */
49 #define ENOMEDIUM 4097
55 #define lseek _lseeki64
57 #define ENOMEDIUM 4097
58 extern int qemu_ftruncate64(int, int64_t);
59 #define ftruncate qemu_ftruncate64
62 static inline char *realpath(const char *path, char *resolved_path)
64 _fullpath(resolved_path, path, _MAX_PATH);
76 /* we use QEMU_TOOL in the command line tools which do not depend on
77 the target CPU type */
78 #include "config-host.h"
85 #include "audio/audio.h"
89 #endif /* !defined(QEMU_TOOL) */
92 #define xglue(x, y) x ## y
93 #define glue(x, y) xglue(x, y)
94 #define stringify(s) tostring(s)
95 #define tostring(s) #s
99 #define MIN(a, b) (((a) < (b)) ? (a) : (b))
102 #define MAX(a, b) (((a) > (b)) ? (a) : (b))
106 uint64_t muldiv64(uint64_t a, uint32_t b, uint32_t c);
108 void hw_error(const char *fmt, ...);
110 extern const char *bios_dir;
112 void pstrcpy(char *buf, int buf_size, const char *str);
113 char *pstrcat(char *buf, int buf_size, const char *s);
114 int strstart(const char *str, const char *val, const char **ptr);
116 extern int vm_running;
118 typedef struct vm_change_state_entry VMChangeStateEntry;
119 typedef void VMChangeStateHandler(void *opaque, int running);
120 typedef void VMStopHandler(void *opaque, int reason);
122 VMChangeStateEntry *qemu_add_vm_change_state_handler(VMChangeStateHandler *cb,
124 void qemu_del_vm_change_state_handler(VMChangeStateEntry *e);
126 int qemu_add_vm_stop_handler(VMStopHandler *cb, void *opaque);
127 void qemu_del_vm_stop_handler(VMStopHandler *cb, void *opaque);
130 void vm_stop(int reason);
132 typedef void QEMUResetHandler(void *opaque);
134 void qemu_register_reset(QEMUResetHandler *func, void *opaque);
135 void qemu_system_reset_request(void);
136 void qemu_system_shutdown_request(void);
137 void qemu_system_powerdown_request(void);
138 #if !defined(TARGET_SPARC)
139 // Please implement a power failure function to signal the OS
140 #define qemu_system_powerdown() do{}while(0)
142 void qemu_system_powerdown(void);
145 void main_loop_wait(int timeout);
148 extern int bios_size;
150 extern int cirrus_vga_enabled;
151 extern int graphic_width;
152 extern int graphic_height;
153 extern int graphic_depth;
154 extern const char *keyboard_layout;
155 extern int kqemu_allowed;
156 extern int win2k_install_hack;
157 extern int usb_enabled;
161 #define MAX_OPTION_ROMS 16
162 extern const char *option_rom[MAX_OPTION_ROMS];
163 extern int nb_option_roms;
165 /* XXX: make it dynamic */
166 #if defined (TARGET_PPC) || defined (TARGET_SPARC64)
167 #define BIOS_SIZE ((512 + 32) * 1024)
168 #elif defined(TARGET_MIPS)
169 #define BIOS_SIZE (128 * 1024)
171 #define BIOS_SIZE ((256 + 64) * 1024)
174 /* keyboard/mouse support */
176 #define MOUSE_EVENT_LBUTTON 0x01
177 #define MOUSE_EVENT_RBUTTON 0x02
178 #define MOUSE_EVENT_MBUTTON 0x04
180 typedef void QEMUPutKBDEvent(void *opaque, int keycode);
181 typedef void QEMUPutMouseEvent(void *opaque, int dx, int dy, int dz, int buttons_state);
183 typedef struct QEMUPutMouseEntry {
184 QEMUPutMouseEvent *qemu_put_mouse_event;
185 void *qemu_put_mouse_event_opaque;
186 int qemu_put_mouse_event_absolute;
187 char *qemu_put_mouse_event_name;
189 /* used internally by qemu for handling mice */
190 struct QEMUPutMouseEntry *next;
193 void qemu_add_kbd_event_handler(QEMUPutKBDEvent *func, void *opaque);
194 QEMUPutMouseEntry *qemu_add_mouse_event_handler(QEMUPutMouseEvent *func,
195 void *opaque, int absolute,
197 void qemu_remove_mouse_event_handler(QEMUPutMouseEntry *entry);
199 void kbd_put_keycode(int keycode);
200 void kbd_mouse_event(int dx, int dy, int dz, int buttons_state);
201 int kbd_mouse_is_absolute(void);
203 void do_info_mice(void);
204 void do_mouse_set(int index);
206 /* keysym is a unicode code except for special keys (see QEMU_KEY_xxx
208 #define QEMU_KEY_ESC1(c) ((c) | 0xe100)
209 #define QEMU_KEY_BACKSPACE 0x007f
210 #define QEMU_KEY_UP QEMU_KEY_ESC1('A')
211 #define QEMU_KEY_DOWN QEMU_KEY_ESC1('B')
212 #define QEMU_KEY_RIGHT QEMU_KEY_ESC1('C')
213 #define QEMU_KEY_LEFT QEMU_KEY_ESC1('D')
214 #define QEMU_KEY_HOME QEMU_KEY_ESC1(1)
215 #define QEMU_KEY_END QEMU_KEY_ESC1(4)
216 #define QEMU_KEY_PAGEUP QEMU_KEY_ESC1(5)
217 #define QEMU_KEY_PAGEDOWN QEMU_KEY_ESC1(6)
218 #define QEMU_KEY_DELETE QEMU_KEY_ESC1(3)
220 #define QEMU_KEY_CTRL_UP 0xe400
221 #define QEMU_KEY_CTRL_DOWN 0xe401
222 #define QEMU_KEY_CTRL_LEFT 0xe402
223 #define QEMU_KEY_CTRL_RIGHT 0xe403
224 #define QEMU_KEY_CTRL_HOME 0xe404
225 #define QEMU_KEY_CTRL_END 0xe405
226 #define QEMU_KEY_CTRL_PAGEUP 0xe406
227 #define QEMU_KEY_CTRL_PAGEDOWN 0xe407
229 void kbd_put_keysym(int keysym);
231 /* async I/O support */
233 typedef void IOReadHandler(void *opaque, const uint8_t *buf, int size);
234 typedef int IOCanRWHandler(void *opaque);
235 typedef void IOHandler(void *opaque);
237 int qemu_set_fd_handler2(int fd,
238 IOCanRWHandler *fd_read_poll,
242 int qemu_set_fd_handler(int fd,
247 /* Polling handling */
249 /* return TRUE if no sleep should be done afterwards */
250 typedef int PollingFunc(void *opaque);
252 int qemu_add_polling_cb(PollingFunc *func, void *opaque);
253 void qemu_del_polling_cb(PollingFunc *func, void *opaque);
256 /* Wait objects handling */
257 typedef void WaitObjectFunc(void *opaque);
259 int qemu_add_wait_object(HANDLE handle, WaitObjectFunc *func, void *opaque);
260 void qemu_del_wait_object(HANDLE handle, WaitObjectFunc *func, void *opaque);
263 typedef struct QEMUBH QEMUBH;
265 /* character device */
267 #define CHR_EVENT_BREAK 0 /* serial break char */
268 #define CHR_EVENT_FOCUS 1 /* focus to this terminal (modal input needed) */
269 #define CHR_EVENT_RESET 2 /* new connection established */
272 #define CHR_IOCTL_SERIAL_SET_PARAMS 1
278 } QEMUSerialSetParams;
280 #define CHR_IOCTL_SERIAL_SET_BREAK 2
282 #define CHR_IOCTL_PP_READ_DATA 3
283 #define CHR_IOCTL_PP_WRITE_DATA 4
284 #define CHR_IOCTL_PP_READ_CONTROL 5
285 #define CHR_IOCTL_PP_WRITE_CONTROL 6
286 #define CHR_IOCTL_PP_READ_STATUS 7
288 typedef void IOEventHandler(void *opaque, int event);
290 typedef struct CharDriverState {
291 int (*chr_write)(struct CharDriverState *s, const uint8_t *buf, int len);
292 void (*chr_add_read_handler)(struct CharDriverState *s,
293 IOCanRWHandler *fd_can_read,
294 IOReadHandler *fd_read, void *opaque);
295 int (*chr_ioctl)(struct CharDriverState *s, int cmd, void *arg);
296 IOEventHandler *chr_event;
297 void (*chr_send_event)(struct CharDriverState *chr, int event);
298 void (*chr_close)(struct CharDriverState *chr);
303 void qemu_chr_printf(CharDriverState *s, const char *fmt, ...);
304 int qemu_chr_write(CharDriverState *s, const uint8_t *buf, int len);
305 void qemu_chr_send_event(CharDriverState *s, int event);
306 void qemu_chr_add_read_handler(CharDriverState *s,
307 IOCanRWHandler *fd_can_read,
308 IOReadHandler *fd_read, void *opaque);
309 void qemu_chr_add_event_handler(CharDriverState *s, IOEventHandler *chr_event);
310 int qemu_chr_ioctl(CharDriverState *s, int cmd, void *arg);
311 void qemu_chr_reset(CharDriverState *s);
315 typedef struct DisplayState DisplayState;
316 typedef struct TextConsole TextConsole;
318 typedef void (*vga_hw_update_ptr)(void *);
319 typedef void (*vga_hw_invalidate_ptr)(void *);
320 typedef void (*vga_hw_screen_dump_ptr)(void *, const char *);
322 TextConsole *graphic_console_init(DisplayState *ds, vga_hw_update_ptr update,
323 vga_hw_invalidate_ptr invalidate,
324 vga_hw_screen_dump_ptr screen_dump,
326 void vga_hw_update(void);
327 void vga_hw_invalidate(void);
328 void vga_hw_screen_dump(const char *filename);
330 int is_graphic_console(void);
331 CharDriverState *text_console_init(DisplayState *ds);
332 void console_select(unsigned int index);
336 #define MAX_SERIAL_PORTS 4
338 extern CharDriverState *serial_hds[MAX_SERIAL_PORTS];
342 #define MAX_PARALLEL_PORTS 3
344 extern CharDriverState *parallel_hds[MAX_PARALLEL_PORTS];
348 typedef struct VLANClientState VLANClientState;
350 struct VLANClientState {
351 IOReadHandler *fd_read;
352 /* Packets may still be sent if this returns zero. It's used to
353 rate-limit the slirp code. */
354 IOCanRWHandler *fd_can_read;
356 struct VLANClientState *next;
357 struct VLANState *vlan;
361 typedef struct VLANState {
363 VLANClientState *first_client;
364 struct VLANState *next;
367 VLANState *qemu_find_vlan(int id);
368 VLANClientState *qemu_new_vlan_client(VLANState *vlan,
369 IOReadHandler *fd_read,
370 IOCanRWHandler *fd_can_read,
372 int qemu_can_send_packet(VLANClientState *vc);
373 void qemu_send_packet(VLANClientState *vc, const uint8_t *buf, int size);
374 void qemu_handler_true(void *opaque);
376 void do_info_network(void);
379 int tap_win32_init(VLANState *vlan, const char *ifname);
385 typedef struct NICInfo {
392 extern NICInfo nd_table[MAX_NICS];
396 typedef struct QEMUClock QEMUClock;
397 typedef struct QEMUTimer QEMUTimer;
398 typedef void QEMUTimerCB(void *opaque);
400 /* The real time clock should be used only for stuff which does not
401 change the virtual machine state, as it is run even if the virtual
402 machine is stopped. The real time clock has a frequency of 1000
404 extern QEMUClock *rt_clock;
406 /* The virtual clock is only run during the emulation. It is stopped
407 when the virtual machine is stopped. Virtual timers use a high
408 precision clock, usually cpu cycles (use ticks_per_sec). */
409 extern QEMUClock *vm_clock;
411 int64_t qemu_get_clock(QEMUClock *clock);
413 QEMUTimer *qemu_new_timer(QEMUClock *clock, QEMUTimerCB *cb, void *opaque);
414 void qemu_free_timer(QEMUTimer *ts);
415 void qemu_del_timer(QEMUTimer *ts);
416 void qemu_mod_timer(QEMUTimer *ts, int64_t expire_time);
417 int qemu_timer_pending(QEMUTimer *ts);
419 extern int64_t ticks_per_sec;
420 extern int pit_min_timer_count;
422 int64_t cpu_get_ticks(void);
423 void cpu_enable_ticks(void);
424 void cpu_disable_ticks(void);
428 typedef struct QEMUFile QEMUFile;
430 QEMUFile *qemu_fopen(const char *filename, const char *mode);
431 void qemu_fflush(QEMUFile *f);
432 void qemu_fclose(QEMUFile *f);
433 void qemu_put_buffer(QEMUFile *f, const uint8_t *buf, int size);
434 void qemu_put_byte(QEMUFile *f, int v);
435 void qemu_put_be16(QEMUFile *f, unsigned int v);
436 void qemu_put_be32(QEMUFile *f, unsigned int v);
437 void qemu_put_be64(QEMUFile *f, uint64_t v);
438 int qemu_get_buffer(QEMUFile *f, uint8_t *buf, int size);
439 int qemu_get_byte(QEMUFile *f);
440 unsigned int qemu_get_be16(QEMUFile *f);
441 unsigned int qemu_get_be32(QEMUFile *f);
442 uint64_t qemu_get_be64(QEMUFile *f);
444 static inline void qemu_put_be64s(QEMUFile *f, const uint64_t *pv)
446 qemu_put_be64(f, *pv);
449 static inline void qemu_put_be32s(QEMUFile *f, const uint32_t *pv)
451 qemu_put_be32(f, *pv);
454 static inline void qemu_put_be16s(QEMUFile *f, const uint16_t *pv)
456 qemu_put_be16(f, *pv);
459 static inline void qemu_put_8s(QEMUFile *f, const uint8_t *pv)
461 qemu_put_byte(f, *pv);
464 static inline void qemu_get_be64s(QEMUFile *f, uint64_t *pv)
466 *pv = qemu_get_be64(f);
469 static inline void qemu_get_be32s(QEMUFile *f, uint32_t *pv)
471 *pv = qemu_get_be32(f);
474 static inline void qemu_get_be16s(QEMUFile *f, uint16_t *pv)
476 *pv = qemu_get_be16(f);
479 static inline void qemu_get_8s(QEMUFile *f, uint8_t *pv)
481 *pv = qemu_get_byte(f);
484 #if TARGET_LONG_BITS == 64
485 #define qemu_put_betl qemu_put_be64
486 #define qemu_get_betl qemu_get_be64
487 #define qemu_put_betls qemu_put_be64s
488 #define qemu_get_betls qemu_get_be64s
490 #define qemu_put_betl qemu_put_be32
491 #define qemu_get_betl qemu_get_be32
492 #define qemu_put_betls qemu_put_be32s
493 #define qemu_get_betls qemu_get_be32s
496 int64_t qemu_ftell(QEMUFile *f);
497 int64_t qemu_fseek(QEMUFile *f, int64_t pos, int whence);
499 typedef void SaveStateHandler(QEMUFile *f, void *opaque);
500 typedef int LoadStateHandler(QEMUFile *f, void *opaque, int version_id);
502 int register_savevm(const char *idstr,
505 SaveStateHandler *save_state,
506 LoadStateHandler *load_state,
508 void qemu_get_timer(QEMUFile *f, QEMUTimer *ts);
509 void qemu_put_timer(QEMUFile *f, QEMUTimer *ts);
511 void cpu_save(QEMUFile *f, void *opaque);
512 int cpu_load(QEMUFile *f, void *opaque, int version_id);
514 void do_savevm(const char *name);
515 void do_loadvm(const char *name);
516 void do_delvm(const char *name);
517 void do_info_snapshots(void);
520 typedef void QEMUBHFunc(void *opaque);
522 QEMUBH *qemu_bh_new(QEMUBHFunc *cb, void *opaque);
523 void qemu_bh_schedule(QEMUBH *bh);
524 void qemu_bh_cancel(QEMUBH *bh);
525 void qemu_bh_delete(QEMUBH *bh);
526 int qemu_bh_poll(void);
529 typedef struct BlockDriverState BlockDriverState;
530 typedef struct BlockDriver BlockDriver;
532 extern BlockDriver bdrv_raw;
533 extern BlockDriver bdrv_host_device;
534 extern BlockDriver bdrv_cow;
535 extern BlockDriver bdrv_qcow;
536 extern BlockDriver bdrv_vmdk;
537 extern BlockDriver bdrv_cloop;
538 extern BlockDriver bdrv_dmg;
539 extern BlockDriver bdrv_bochs;
540 extern BlockDriver bdrv_vpc;
541 extern BlockDriver bdrv_vvfat;
542 extern BlockDriver bdrv_qcow2;
544 typedef struct BlockDriverInfo {
545 /* in bytes, 0 if irrelevant */
547 /* offset at which the VM state can be saved (0 if not possible) */
548 int64_t vm_state_offset;
551 typedef struct QEMUSnapshotInfo {
552 char id_str[128]; /* unique snapshot id */
553 /* the following fields are informative. They are not needed for
554 the consistency of the snapshot */
555 char name[256]; /* user choosen name */
556 uint32_t vm_state_size; /* VM state info size */
557 uint32_t date_sec; /* UTC date of the snapshot */
559 uint64_t vm_clock_nsec; /* VM clock relative to boot */
562 #define BDRV_O_RDONLY 0x0000
563 #define BDRV_O_RDWR 0x0002
564 #define BDRV_O_ACCESS 0x0003
565 #define BDRV_O_CREAT 0x0004 /* create an empty file */
566 #define BDRV_O_SNAPSHOT 0x0008 /* open the file read only and save writes in a snapshot */
567 #define BDRV_O_FILE 0x0010 /* open as a raw file (do not try to
568 use a disk image format on top of
572 void bdrv_init(void);
573 BlockDriver *bdrv_find_format(const char *format_name);
574 int bdrv_create(BlockDriver *drv,
575 const char *filename, int64_t size_in_sectors,
576 const char *backing_file, int flags);
577 BlockDriverState *bdrv_new(const char *device_name);
578 void bdrv_delete(BlockDriverState *bs);
579 int bdrv_file_open(BlockDriverState **pbs, const char *filename, int flags);
580 int bdrv_open(BlockDriverState *bs, const char *filename, int flags);
581 int bdrv_open2(BlockDriverState *bs, const char *filename, int flags,
583 void bdrv_close(BlockDriverState *bs);
584 int bdrv_read(BlockDriverState *bs, int64_t sector_num,
585 uint8_t *buf, int nb_sectors);
586 int bdrv_write(BlockDriverState *bs, int64_t sector_num,
587 const uint8_t *buf, int nb_sectors);
588 int bdrv_pread(BlockDriverState *bs, int64_t offset,
589 void *buf, int count);
590 int bdrv_pwrite(BlockDriverState *bs, int64_t offset,
591 const void *buf, int count);
592 int bdrv_truncate(BlockDriverState *bs, int64_t offset);
593 int64_t bdrv_getlength(BlockDriverState *bs);
594 void bdrv_get_geometry(BlockDriverState *bs, int64_t *nb_sectors_ptr);
595 int bdrv_commit(BlockDriverState *bs);
596 void bdrv_set_boot_sector(BlockDriverState *bs, const uint8_t *data, int size);
597 /* async block I/O */
598 typedef struct BlockDriverAIOCB BlockDriverAIOCB;
599 typedef void BlockDriverCompletionFunc(void *opaque, int ret);
601 BlockDriverAIOCB *bdrv_aio_read(BlockDriverState *bs, int64_t sector_num,
602 uint8_t *buf, int nb_sectors,
603 BlockDriverCompletionFunc *cb, void *opaque);
604 BlockDriverAIOCB *bdrv_aio_write(BlockDriverState *bs, int64_t sector_num,
605 const uint8_t *buf, int nb_sectors,
606 BlockDriverCompletionFunc *cb, void *opaque);
607 void bdrv_aio_cancel(BlockDriverAIOCB *acb);
609 void qemu_aio_init(void);
610 void qemu_aio_poll(void);
611 void qemu_aio_flush(void);
612 void qemu_aio_wait_start(void);
613 void qemu_aio_wait(void);
614 void qemu_aio_wait_end(void);
616 /* Ensure contents are flushed to disk. */
617 void bdrv_flush(BlockDriverState *bs);
619 #define BDRV_TYPE_HD 0
620 #define BDRV_TYPE_CDROM 1
621 #define BDRV_TYPE_FLOPPY 2
622 #define BIOS_ATA_TRANSLATION_AUTO 0
623 #define BIOS_ATA_TRANSLATION_NONE 1
624 #define BIOS_ATA_TRANSLATION_LBA 2
625 #define BIOS_ATA_TRANSLATION_LARGE 3
626 #define BIOS_ATA_TRANSLATION_RECHS 4
628 void bdrv_set_geometry_hint(BlockDriverState *bs,
629 int cyls, int heads, int secs);
630 void bdrv_set_type_hint(BlockDriverState *bs, int type);
631 void bdrv_set_translation_hint(BlockDriverState *bs, int translation);
632 void bdrv_get_geometry_hint(BlockDriverState *bs,
633 int *pcyls, int *pheads, int *psecs);
634 int bdrv_get_type_hint(BlockDriverState *bs);
635 int bdrv_get_translation_hint(BlockDriverState *bs);
636 int bdrv_is_removable(BlockDriverState *bs);
637 int bdrv_is_read_only(BlockDriverState *bs);
638 int bdrv_is_inserted(BlockDriverState *bs);
639 int bdrv_media_changed(BlockDriverState *bs);
640 int bdrv_is_locked(BlockDriverState *bs);
641 void bdrv_set_locked(BlockDriverState *bs, int locked);
642 void bdrv_eject(BlockDriverState *bs, int eject_flag);
643 void bdrv_set_change_cb(BlockDriverState *bs,
644 void (*change_cb)(void *opaque), void *opaque);
645 void bdrv_get_format(BlockDriverState *bs, char *buf, int buf_size);
646 void bdrv_info(void);
647 BlockDriverState *bdrv_find(const char *name);
648 void bdrv_iterate(void (*it)(void *opaque, const char *name), void *opaque);
649 int bdrv_is_encrypted(BlockDriverState *bs);
650 int bdrv_set_key(BlockDriverState *bs, const char *key);
651 void bdrv_iterate_format(void (*it)(void *opaque, const char *name),
653 const char *bdrv_get_device_name(BlockDriverState *bs);
654 int bdrv_write_compressed(BlockDriverState *bs, int64_t sector_num,
655 const uint8_t *buf, int nb_sectors);
656 int bdrv_get_info(BlockDriverState *bs, BlockDriverInfo *bdi);
658 void bdrv_get_backing_filename(BlockDriverState *bs,
659 char *filename, int filename_size);
660 int bdrv_snapshot_create(BlockDriverState *bs,
661 QEMUSnapshotInfo *sn_info);
662 int bdrv_snapshot_goto(BlockDriverState *bs,
663 const char *snapshot_id);
664 int bdrv_snapshot_delete(BlockDriverState *bs, const char *snapshot_id);
665 int bdrv_snapshot_list(BlockDriverState *bs,
666 QEMUSnapshotInfo **psn_info);
667 char *bdrv_snapshot_dump(char *buf, int buf_size, QEMUSnapshotInfo *sn);
669 char *get_human_readable_size(char *buf, int buf_size, int64_t size);
670 int path_is_absolute(const char *path);
671 void path_combine(char *dest, int dest_size,
672 const char *base_path,
673 const char *filename);
677 typedef void QEMUMachineInitFunc(int ram_size, int vga_ram_size,
679 DisplayState *ds, const char **fd_filename, int snapshot,
680 const char *kernel_filename, const char *kernel_cmdline,
681 const char *initrd_filename);
683 typedef struct QEMUMachine {
686 QEMUMachineInitFunc *init;
687 struct QEMUMachine *next;
690 int qemu_register_machine(QEMUMachine *m);
692 typedef void SetIRQFunc(void *opaque, int irq_num, int level);
693 typedef void IRQRequestFunc(void *opaque, int level);
697 extern target_phys_addr_t isa_mem_base;
699 typedef void (IOPortWriteFunc)(void *opaque, uint32_t address, uint32_t data);
700 typedef uint32_t (IOPortReadFunc)(void *opaque, uint32_t address);
702 int register_ioport_read(int start, int length, int size,
703 IOPortReadFunc *func, void *opaque);
704 int register_ioport_write(int start, int length, int size,
705 IOPortWriteFunc *func, void *opaque);
706 void isa_unassign_ioport(int start, int length);
708 void isa_mmio_init(target_phys_addr_t base, target_phys_addr_t size);
712 extern target_phys_addr_t pci_mem_base;
714 typedef struct PCIBus PCIBus;
715 typedef struct PCIDevice PCIDevice;
717 typedef void PCIConfigWriteFunc(PCIDevice *pci_dev,
718 uint32_t address, uint32_t data, int len);
719 typedef uint32_t PCIConfigReadFunc(PCIDevice *pci_dev,
720 uint32_t address, int len);
721 typedef void PCIMapIORegionFunc(PCIDevice *pci_dev, int region_num,
722 uint32_t addr, uint32_t size, int type);
724 #define PCI_ADDRESS_SPACE_MEM 0x00
725 #define PCI_ADDRESS_SPACE_IO 0x01
726 #define PCI_ADDRESS_SPACE_MEM_PREFETCH 0x08
728 typedef struct PCIIORegion {
729 uint32_t addr; /* current PCI mapping address. -1 means not mapped */
732 PCIMapIORegionFunc *map_func;
735 #define PCI_ROM_SLOT 6
736 #define PCI_NUM_REGIONS 7
738 #define PCI_DEVICES_MAX 64
740 #define PCI_VENDOR_ID 0x00 /* 16 bits */
741 #define PCI_DEVICE_ID 0x02 /* 16 bits */
742 #define PCI_COMMAND 0x04 /* 16 bits */
743 #define PCI_COMMAND_IO 0x1 /* Enable response in I/O space */
744 #define PCI_COMMAND_MEMORY 0x2 /* Enable response in Memory space */
745 #define PCI_CLASS_DEVICE 0x0a /* Device class */
746 #define PCI_INTERRUPT_LINE 0x3c /* 8 bits */
747 #define PCI_INTERRUPT_PIN 0x3d /* 8 bits */
748 #define PCI_MIN_GNT 0x3e /* 8 bits */
749 #define PCI_MAX_LAT 0x3f /* 8 bits */
752 /* PCI config space */
755 /* the following fields are read only */
759 PCIIORegion io_regions[PCI_NUM_REGIONS];
761 /* do not access the following fields */
762 PCIConfigReadFunc *config_read;
763 PCIConfigWriteFunc *config_write;
764 /* ??? This is a PC-specific hack, and should be removed. */
767 /* Current IRQ levels. Used internally by the generic PCI code. */
771 PCIDevice *pci_register_device(PCIBus *bus, const char *name,
772 int instance_size, int devfn,
773 PCIConfigReadFunc *config_read,
774 PCIConfigWriteFunc *config_write);
776 void pci_register_io_region(PCIDevice *pci_dev, int region_num,
777 uint32_t size, int type,
778 PCIMapIORegionFunc *map_func);
780 void pci_set_irq(PCIDevice *pci_dev, int irq_num, int level);
782 uint32_t pci_default_read_config(PCIDevice *d,
783 uint32_t address, int len);
784 void pci_default_write_config(PCIDevice *d,
785 uint32_t address, uint32_t val, int len);
786 void pci_device_save(PCIDevice *s, QEMUFile *f);
787 int pci_device_load(PCIDevice *s, QEMUFile *f);
789 typedef void (*pci_set_irq_fn)(void *pic, int irq_num, int level);
790 typedef int (*pci_map_irq_fn)(PCIDevice *pci_dev, int irq_num);
791 PCIBus *pci_register_bus(pci_set_irq_fn set_irq, pci_map_irq_fn map_irq,
792 void *pic, int devfn_min, int nirq);
794 void pci_nic_init(PCIBus *bus, NICInfo *nd);
795 void pci_data_write(void *opaque, uint32_t addr, uint32_t val, int len);
796 uint32_t pci_data_read(void *opaque, uint32_t addr, int len);
797 int pci_bus_num(PCIBus *s);
798 void pci_for_each_device(int bus_num, void (*fn)(PCIDevice *d));
801 PCIBus *pci_bridge_init(PCIBus *bus, int devfn, uint32_t id,
802 pci_map_irq_fn map_irq, const char *name);
805 PCIBus *pci_prep_init(void);
808 PCIBus *pci_grackle_init(uint32_t base, void *pic);
811 PCIBus *pci_pmac_init(void *pic);
814 PCIBus *pci_apb_init(target_ulong special_base, target_ulong mem_base,
817 PCIBus *pci_vpb_init(void *pic, int irq, int realview);
820 PCIBus *i440fx_init(PCIDevice **pi440fx_state);
821 void i440fx_set_smm(PCIDevice *d, int val);
822 int piix3_init(PCIBus *bus);
823 void i440fx_init_memory_mappings(PCIDevice *d);
826 typedef struct openpic_t openpic_t;
827 void openpic_set_irq(void *opaque, int n_IRQ, int level);
828 openpic_t *openpic_init (PCIBus *bus, int *pmem_index, int nb_cpus,
832 typedef struct HeathrowPICS HeathrowPICS;
833 void heathrow_pic_set_irq(void *opaque, int num, int level);
834 HeathrowPICS *heathrow_pic_init(int *pmem_index);
843 int (*init_isa) (AudioState *s);
844 int (*init_pci) (PCIBus *bus, AudioState *s);
848 extern struct soundhw soundhw[];
853 #define VGA_RAM_SIZE (8192 * 1024)
855 struct DisplayState {
859 int bgr; /* BGR color order instead of RGB. Only valid for depth == 32 */
864 void (*dpy_update)(struct DisplayState *s, int x, int y, int w, int h);
865 void (*dpy_resize)(struct DisplayState *s, int w, int h);
866 void (*dpy_refresh)(struct DisplayState *s);
867 void (*dpy_copy)(struct DisplayState *s, int src_x, int src_y, int dst_x, int dst_y, int w, int h);
870 static inline void dpy_update(DisplayState *s, int x, int y, int w, int h)
872 s->dpy_update(s, x, y, w, h);
875 static inline void dpy_resize(DisplayState *s, int w, int h)
877 s->dpy_resize(s, w, h);
880 int isa_vga_init(DisplayState *ds, uint8_t *vga_ram_base,
881 unsigned long vga_ram_offset, int vga_ram_size);
882 int pci_vga_init(PCIBus *bus, DisplayState *ds, uint8_t *vga_ram_base,
883 unsigned long vga_ram_offset, int vga_ram_size,
884 unsigned long vga_bios_offset, int vga_bios_size);
887 void pci_cirrus_vga_init(PCIBus *bus, DisplayState *ds, uint8_t *vga_ram_base,
888 unsigned long vga_ram_offset, int vga_ram_size);
889 void isa_cirrus_vga_init(DisplayState *ds, uint8_t *vga_ram_base,
890 unsigned long vga_ram_offset, int vga_ram_size);
893 void sdl_display_init(DisplayState *ds, int full_screen);
896 void cocoa_display_init(DisplayState *ds, int full_screen);
899 void vnc_display_init(DisplayState *ds, const char *display);
904 extern BlockDriverState *bs_table[MAX_DISKS + 1];
906 void isa_ide_init(int iobase, int iobase2, int irq,
907 BlockDriverState *hd0, BlockDriverState *hd1);
908 void pci_cmd646_ide_init(PCIBus *bus, BlockDriverState **hd_table,
909 int secondary_ide_enabled);
910 void pci_piix3_ide_init(PCIBus *bus, BlockDriverState **hd_table, int devfn);
911 int pmac_ide_init (BlockDriverState **hd_table,
912 SetIRQFunc *set_irq, void *irq_opaque, int irq);
915 int cdrom_read_toc(int nb_sectors, uint8_t *buf, int msf, int start_track);
916 int cdrom_read_toc_raw(int nb_sectors, uint8_t *buf, int msf, int session_num);
919 int es1370_init (PCIBus *bus, AudioState *s);
922 int SB16_init (AudioState *s);
925 int Adlib_init (AudioState *s);
928 int GUS_init (AudioState *s);
931 typedef int (*DMA_transfer_handler) (void *opaque, int nchan, int pos, int size);
932 int DMA_get_channel_mode (int nchan);
933 int DMA_read_memory (int nchan, void *buf, int pos, int size);
934 int DMA_write_memory (int nchan, void *buf, int pos, int size);
935 void DMA_hold_DREQ (int nchan);
936 void DMA_release_DREQ (int nchan);
937 void DMA_schedule(int nchan);
939 void DMA_init (int high_page_enable);
940 void DMA_register_channel (int nchan,
941 DMA_transfer_handler transfer_handler,
945 extern BlockDriverState *fd_table[MAX_FD];
947 typedef struct fdctrl_t fdctrl_t;
949 fdctrl_t *fdctrl_init (int irq_lvl, int dma_chann, int mem_mapped,
951 BlockDriverState **fds);
952 int fdctrl_get_drive_type(fdctrl_t *fdctrl, int drive_num);
956 void isa_ne2000_init(int base, int irq, NICInfo *nd);
957 void pci_ne2000_init(PCIBus *bus, NICInfo *nd);
961 void pci_rtl8139_init(PCIBus *bus, NICInfo *nd);
965 void pci_pcnet_init(PCIBus *bus, NICInfo *nd);
966 void pcnet_h_reset(void *opaque);
967 void *lance_init(NICInfo *nd, uint32_t leaddr, void *dma_opaque);
976 typedef struct RTCState RTCState;
978 RTCState *rtc_init(int base, int irq);
979 void rtc_set_memory(RTCState *s, int addr, int val);
980 void rtc_set_date(RTCState *s, const struct tm *tm);
984 typedef struct SerialState SerialState;
985 SerialState *serial_init(SetIRQFunc *set_irq, void *opaque,
986 int base, int irq, CharDriverState *chr);
987 SerialState *serial_mm_init (SetIRQFunc *set_irq, void *opaque,
988 target_ulong base, int it_shift,
989 int irq, CharDriverState *chr);
993 typedef struct ParallelState ParallelState;
994 ParallelState *parallel_init(int base, int irq, CharDriverState *chr);
998 typedef struct PicState2 PicState2;
999 extern PicState2 *isa_pic;
1000 void pic_set_irq(int irq, int level);
1001 void pic_set_irq_new(void *opaque, int irq, int level);
1002 PicState2 *pic_init(IRQRequestFunc *irq_request, void *irq_request_opaque);
1003 void pic_set_alt_irq_func(PicState2 *s, SetIRQFunc *alt_irq_func,
1004 void *alt_irq_opaque);
1005 int pic_read_irq(PicState2 *s);
1006 void pic_update_irq(PicState2 *s);
1007 uint32_t pic_intack_read(PicState2 *s);
1008 void pic_info(void);
1009 void irq_info(void);
1012 typedef struct IOAPICState IOAPICState;
1014 int apic_init(CPUState *env);
1015 int apic_get_interrupt(CPUState *env);
1016 IOAPICState *ioapic_init(void);
1017 void ioapic_set_irq(void *opaque, int vector, int level);
1021 #define PIT_FREQ 1193182
1023 typedef struct PITState PITState;
1025 PITState *pit_init(int base, int irq);
1026 void pit_set_gate(PITState *pit, int channel, int val);
1027 int pit_get_gate(PITState *pit, int channel);
1028 int pit_get_initial_count(PITState *pit, int channel);
1029 int pit_get_mode(PITState *pit, int channel);
1030 int pit_get_out(PITState *pit, int channel, int64_t current_time);
1033 void pcspk_init(PITState *);
1034 int pcspk_audio_init(AudioState *);
1037 extern int acpi_enabled;
1038 void piix4_pm_init(PCIBus *bus, int devfn);
1039 void acpi_bios_init(void);
1042 extern QEMUMachine pc_machine;
1043 extern QEMUMachine isapc_machine;
1044 extern int fd_bootchk;
1046 void ioport_set_a20(int enable);
1047 int ioport_get_a20(void);
1050 extern QEMUMachine prep_machine;
1051 extern QEMUMachine core99_machine;
1052 extern QEMUMachine heathrow_machine;
1055 extern QEMUMachine mips_machine;
1058 extern void cpu_mips_clock_init(CPUState *);
1059 extern void cpu_mips_irqctrl_init (void);
1062 extern QEMUMachine shix_machine;
1065 ppc_tb_t *cpu_ppc_tb_init (CPUState *env, uint32_t freq);
1067 void PREP_debug_write (void *opaque, uint32_t addr, uint32_t val);
1069 extern CPUWriteMemoryFunc *PPC_io_write[];
1070 extern CPUReadMemoryFunc *PPC_io_read[];
1071 void PPC_debug_write (void *opaque, uint32_t addr, uint32_t val);
1074 extern QEMUMachine sun4m_machine;
1075 void pic_set_irq_cpu(int irq, int level, unsigned int cpu);
1078 void *iommu_init(uint32_t addr);
1079 void sparc_iommu_memory_rw(void *opaque, target_phys_addr_t addr,
1080 uint8_t *buf, int len, int is_write);
1081 static inline void sparc_iommu_memory_read(void *opaque,
1082 target_phys_addr_t addr,
1083 uint8_t *buf, int len)
1085 sparc_iommu_memory_rw(opaque, addr, buf, len, 0);
1088 static inline void sparc_iommu_memory_write(void *opaque,
1089 target_phys_addr_t addr,
1090 uint8_t *buf, int len)
1092 sparc_iommu_memory_rw(opaque, addr, buf, len, 1);
1096 void tcx_init(DisplayState *ds, uint32_t addr, uint8_t *vram_base,
1097 unsigned long vram_offset, int vram_size, int width, int height);
1099 /* slavio_intctl.c */
1100 void *slavio_intctl_init();
1101 void slavio_intctl_set_cpu(void *opaque, unsigned int cpu, CPUState *env);
1102 void slavio_pic_info(void *opaque);
1103 void slavio_irq_info(void *opaque);
1104 void slavio_pic_set_irq(void *opaque, int irq, int level);
1105 void slavio_pic_set_irq_cpu(void *opaque, int irq, int level, unsigned int cpu);
1108 int get_image_size(const char *filename);
1109 int load_image(const char *filename, uint8_t *addr);
1110 int load_elf(const char *filename, int64_t virt_to_phys_addend, uint64_t *pentry);
1111 int load_aout(const char *filename, uint8_t *addr);
1113 /* slavio_timer.c */
1114 void slavio_timer_init(uint32_t addr, int irq, int mode, unsigned int cpu);
1116 /* slavio_serial.c */
1117 SerialState *slavio_serial_init(int base, int irq, CharDriverState *chr1, CharDriverState *chr2);
1118 void slavio_serial_ms_kbd_init(int base, int irq);
1121 void *slavio_misc_init(uint32_t base, int irq);
1122 void slavio_set_power_fail(void *opaque, int power_failing);
1125 void esp_scsi_attach(void *opaque, BlockDriverState *bd, int id);
1126 void *esp_init(BlockDriverState **bd, uint32_t espaddr, void *dma_opaque);
1127 void esp_reset(void *opaque);
1130 void *sparc32_dma_init(uint32_t daddr, int espirq, int leirq, void *iommu,
1132 void ledma_set_irq(void *opaque, int isr);
1133 void ledma_memory_read(void *opaque, target_phys_addr_t addr,
1134 uint8_t *buf, int len, int do_bswap);
1135 void ledma_memory_write(void *opaque, target_phys_addr_t addr,
1136 uint8_t *buf, int len, int do_bswap);
1137 void espdma_raise_irq(void *opaque);
1138 void espdma_clear_irq(void *opaque);
1139 void espdma_memory_read(void *opaque, uint8_t *buf, int len);
1140 void espdma_memory_write(void *opaque, uint8_t *buf, int len);
1141 void sparc32_dma_set_reset_data(void *opaque, void *esp_opaque,
1142 void *lance_opaque);
1145 void cs_init(target_phys_addr_t base, int irq, void *intctl);
1148 extern QEMUMachine sun4u_machine;
1151 #include "hw/m48t59.h"
1153 void NVRAM_set_byte (m48t59_t *nvram, uint32_t addr, uint8_t value);
1154 uint8_t NVRAM_get_byte (m48t59_t *nvram, uint32_t addr);
1155 void NVRAM_set_word (m48t59_t *nvram, uint32_t addr, uint16_t value);
1156 uint16_t NVRAM_get_word (m48t59_t *nvram, uint32_t addr);
1157 void NVRAM_set_lword (m48t59_t *nvram, uint32_t addr, uint32_t value);
1158 uint32_t NVRAM_get_lword (m48t59_t *nvram, uint32_t addr);
1159 void NVRAM_set_string (m48t59_t *nvram, uint32_t addr,
1160 const unsigned char *str, uint32_t max);
1161 int NVRAM_get_string (m48t59_t *nvram, uint8_t *dst, uint16_t addr, int max);
1162 void NVRAM_set_crc (m48t59_t *nvram, uint32_t addr,
1163 uint32_t start, uint32_t count);
1164 int PPC_NVRAM_set_params (m48t59_t *nvram, uint16_t NVRAM_size,
1165 const unsigned char *arch,
1166 uint32_t RAM_size, int boot_device,
1167 uint32_t kernel_image, uint32_t kernel_size,
1168 const char *cmdline,
1169 uint32_t initrd_image, uint32_t initrd_size,
1170 uint32_t NVRAM_image,
1171 int width, int height, int depth);
1175 #define MAX_ADB_DEVICES 16
1177 #define ADB_MAX_OUT_LEN 16
1179 typedef struct ADBDevice ADBDevice;
1181 /* buf = NULL means polling */
1182 typedef int ADBDeviceRequest(ADBDevice *d, uint8_t *buf_out,
1183 const uint8_t *buf, int len);
1184 typedef int ADBDeviceReset(ADBDevice *d);
1187 struct ADBBusState *bus;
1190 ADBDeviceRequest *devreq;
1191 ADBDeviceReset *devreset;
1195 typedef struct ADBBusState {
1196 ADBDevice devices[MAX_ADB_DEVICES];
1201 int adb_request(ADBBusState *s, uint8_t *buf_out,
1202 const uint8_t *buf, int len);
1203 int adb_poll(ADBBusState *s, uint8_t *buf_out);
1205 ADBDevice *adb_register_device(ADBBusState *s, int devaddr,
1206 ADBDeviceRequest *devreq,
1207 ADBDeviceReset *devreset,
1209 void adb_kbd_init(ADBBusState *bus);
1210 void adb_mouse_init(ADBBusState *bus);
1214 extern ADBBusState adb_bus;
1215 int cuda_init(SetIRQFunc *set_irq, void *irq_opaque, int irq);
1219 /* usb ports of the VM */
1221 void qemu_register_usb_port(USBPort *port, void *opaque, int index,
1222 usb_attachfn attach);
1224 #define VM_USB_HUB_SIZE 8
1226 void do_usb_add(const char *devname);
1227 void do_usb_del(const char *devname);
1228 void usb_info(void);
1232 SCSI_REASON_DONE, /* Command complete. */
1233 SCSI_REASON_DATA /* Transfer complete, more data required. */
1236 typedef struct SCSIDevice SCSIDevice;
1237 typedef void (*scsi_completionfn)(void *opaque, int reason, uint32_t tag,
1240 SCSIDevice *scsi_disk_init(BlockDriverState *bdrv,
1242 scsi_completionfn completion,
1244 void scsi_disk_destroy(SCSIDevice *s);
1246 int32_t scsi_send_command(SCSIDevice *s, uint32_t tag, uint8_t *buf, int lun);
1247 /* SCSI data transfers are asynchrnonous. However, unlike the block IO
1248 layer the completion routine may be called directly by
1249 scsi_{read,write}_data. */
1250 void scsi_read_data(SCSIDevice *s, uint32_t tag);
1251 int scsi_write_data(SCSIDevice *s, uint32_t tag);
1252 void scsi_cancel_io(SCSIDevice *s, uint32_t tag);
1253 uint8_t *scsi_get_buf(SCSIDevice *s, uint32_t tag);
1256 void lsi_scsi_attach(void *opaque, BlockDriverState *bd, int id);
1257 void *lsi_scsi_init(PCIBus *bus, int devfn);
1259 /* integratorcp.c */
1260 extern QEMUMachine integratorcp926_machine;
1261 extern QEMUMachine integratorcp1026_machine;
1264 extern QEMUMachine versatilepb_machine;
1265 extern QEMUMachine versatileab_machine;
1268 extern QEMUMachine realview_machine;
1271 void *ps2_kbd_init(void (*update_irq)(void *, int), void *update_arg);
1272 void *ps2_mouse_init(void (*update_irq)(void *, int), void *update_arg);
1273 void ps2_write_mouse(void *, int val);
1274 void ps2_write_keyboard(void *, int val);
1275 uint32_t ps2_read_data(void *);
1276 void ps2_queue(void *, int b);
1277 void ps2_keyboard_set_translation(void *opaque, int mode);
1280 void smc91c111_init(NICInfo *, uint32_t, void *, int);
1283 void *pl110_init(DisplayState *ds, uint32_t base, void *pic, int irq, int);
1286 void pl011_init(uint32_t base, void *pic, int irq, CharDriverState *chr);
1289 void pl050_init(uint32_t base, void *pic, int irq, int is_mouse);
1292 void *pl080_init(uint32_t base, void *pic, int irq, int nchannels);
1295 void *pl190_init(uint32_t base, void *parent, int irq, int fiq);
1298 void sp804_init(uint32_t base, void *pic, int irq);
1299 void icp_pit_init(uint32_t base, void *pic, int irq);
1302 void arm_sysctl_init(uint32_t base, uint32_t sys_id);
1305 void *arm_gic_init(uint32_t base, void *parent, int parent_irq);
1309 void arm_load_kernel(int ram_size, const char *kernel_filename,
1310 const char *kernel_cmdline, const char *initrd_filename,
1316 struct SH7750State *sh7750_init(CPUState * cpu);
1319 /* The callback will be triggered if any of the designated lines change */
1320 uint16_t portamask_trigger;
1321 uint16_t portbmask_trigger;
1322 /* Return 0 if no action was taken */
1323 int (*port_change_cb) (uint16_t porta, uint16_t portb,
1324 uint16_t * periph_pdtra,
1325 uint16_t * periph_portdira,
1326 uint16_t * periph_pdtrb,
1327 uint16_t * periph_portdirb);
1330 int sh7750_register_io_device(struct SH7750State *s,
1331 sh7750_io_device * device);
1333 int tc58128_init(struct SH7750State *s, char *zone1, char *zone2);
1335 /* NOR flash devices */
1336 typedef struct pflash_t pflash_t;
1338 pflash_t *pflash_register (target_ulong base, ram_addr_t off,
1339 BlockDriverState *bs,
1340 target_ulong sector_len, int nb_blocs, int width,
1341 uint16_t id0, uint16_t id1,
1342 uint16_t id2, uint16_t id3);
1344 #endif /* defined(QEMU_TOOL) */
1347 void monitor_init(CharDriverState *hd, int show_banner);
1348 void term_puts(const char *str);
1349 void term_vprintf(const char *fmt, va_list ap);
1350 void term_printf(const char *fmt, ...) __attribute__ ((__format__ (__printf__, 1, 2)));
1351 void term_print_filename(const char *filename);
1352 void term_flush(void);
1353 void term_print_help(void);
1354 void monitor_readline(const char *prompt, int is_password,
1355 char *buf, int buf_size);
1358 typedef void ReadLineFunc(void *opaque, const char *str);
1360 extern int completion_index;
1361 void add_completion(const char *str);
1362 void readline_handle_byte(int ch);
1363 void readline_find_completion(const char *cmdline);
1364 const char *readline_get_history(unsigned int index);
1365 void readline_start(const char *prompt, int is_password,
1366 ReadLineFunc *readline_func, void *opaque);
1368 void kqemu_record_dump(void);