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 ENODEV
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"
88 #endif /* !defined(QEMU_TOOL) */
91 #define xglue(x, y) x ## y
92 #define glue(x, y) xglue(x, y)
93 #define stringify(s) tostring(s)
94 #define tostring(s) #s
98 #define MIN(a, b) (((a) < (b)) ? (a) : (b))
101 #define MAX(a, b) (((a) > (b)) ? (a) : (b))
105 void pstrcpy(char *buf, int buf_size, const char *str);
106 char *pstrcat(char *buf, int buf_size, const char *s);
107 int strstart(const char *str, const char *val, const char **ptr);
108 int stristart(const char *str, const char *val, const char **ptr);
111 uint64_t muldiv64(uint64_t a, uint32_t b, uint32_t c);
113 void hw_error(const char *fmt, ...);
115 extern const char *bios_dir;
117 extern int vm_running;
119 typedef struct vm_change_state_entry VMChangeStateEntry;
120 typedef void VMChangeStateHandler(void *opaque, int running);
121 typedef void VMStopHandler(void *opaque, int reason);
123 VMChangeStateEntry *qemu_add_vm_change_state_handler(VMChangeStateHandler *cb,
125 void qemu_del_vm_change_state_handler(VMChangeStateEntry *e);
127 int qemu_add_vm_stop_handler(VMStopHandler *cb, void *opaque);
128 void qemu_del_vm_stop_handler(VMStopHandler *cb, void *opaque);
131 void vm_stop(int reason);
133 typedef void QEMUResetHandler(void *opaque);
135 void qemu_register_reset(QEMUResetHandler *func, void *opaque);
136 void qemu_system_reset_request(void);
137 void qemu_system_shutdown_request(void);
138 void qemu_system_powerdown_request(void);
139 #if !defined(TARGET_SPARC)
140 // Please implement a power failure function to signal the OS
141 #define qemu_system_powerdown() do{}while(0)
143 void qemu_system_powerdown(void);
146 void main_loop_wait(int timeout);
149 extern int bios_size;
151 extern int cirrus_vga_enabled;
152 extern int graphic_width;
153 extern int graphic_height;
154 extern int graphic_depth;
155 extern const char *keyboard_layout;
156 extern int kqemu_allowed;
157 extern int win2k_install_hack;
158 extern int usb_enabled;
161 extern int semihosting_enabled;
162 extern int autostart;
164 #define MAX_OPTION_ROMS 16
165 extern const char *option_rom[MAX_OPTION_ROMS];
166 extern int nb_option_roms;
168 /* XXX: make it dynamic */
169 #if defined (TARGET_PPC) || defined (TARGET_SPARC64)
170 #define BIOS_SIZE ((512 + 32) * 1024)
171 #elif defined(TARGET_MIPS)
172 #define BIOS_SIZE (4 * 1024 * 1024)
174 #define BIOS_SIZE ((256 + 64) * 1024)
177 /* keyboard/mouse support */
179 #define MOUSE_EVENT_LBUTTON 0x01
180 #define MOUSE_EVENT_RBUTTON 0x02
181 #define MOUSE_EVENT_MBUTTON 0x04
183 typedef void QEMUPutKBDEvent(void *opaque, int keycode);
184 typedef void QEMUPutMouseEvent(void *opaque, int dx, int dy, int dz, int buttons_state);
186 typedef struct QEMUPutMouseEntry {
187 QEMUPutMouseEvent *qemu_put_mouse_event;
188 void *qemu_put_mouse_event_opaque;
189 int qemu_put_mouse_event_absolute;
190 char *qemu_put_mouse_event_name;
192 /* used internally by qemu for handling mice */
193 struct QEMUPutMouseEntry *next;
196 void qemu_add_kbd_event_handler(QEMUPutKBDEvent *func, void *opaque);
197 QEMUPutMouseEntry *qemu_add_mouse_event_handler(QEMUPutMouseEvent *func,
198 void *opaque, int absolute,
200 void qemu_remove_mouse_event_handler(QEMUPutMouseEntry *entry);
202 void kbd_put_keycode(int keycode);
203 void kbd_mouse_event(int dx, int dy, int dz, int buttons_state);
204 int kbd_mouse_is_absolute(void);
206 void do_info_mice(void);
207 void do_mouse_set(int index);
209 /* keysym is a unicode code except for special keys (see QEMU_KEY_xxx
211 #define QEMU_KEY_ESC1(c) ((c) | 0xe100)
212 #define QEMU_KEY_BACKSPACE 0x007f
213 #define QEMU_KEY_UP QEMU_KEY_ESC1('A')
214 #define QEMU_KEY_DOWN QEMU_KEY_ESC1('B')
215 #define QEMU_KEY_RIGHT QEMU_KEY_ESC1('C')
216 #define QEMU_KEY_LEFT QEMU_KEY_ESC1('D')
217 #define QEMU_KEY_HOME QEMU_KEY_ESC1(1)
218 #define QEMU_KEY_END QEMU_KEY_ESC1(4)
219 #define QEMU_KEY_PAGEUP QEMU_KEY_ESC1(5)
220 #define QEMU_KEY_PAGEDOWN QEMU_KEY_ESC1(6)
221 #define QEMU_KEY_DELETE QEMU_KEY_ESC1(3)
223 #define QEMU_KEY_CTRL_UP 0xe400
224 #define QEMU_KEY_CTRL_DOWN 0xe401
225 #define QEMU_KEY_CTRL_LEFT 0xe402
226 #define QEMU_KEY_CTRL_RIGHT 0xe403
227 #define QEMU_KEY_CTRL_HOME 0xe404
228 #define QEMU_KEY_CTRL_END 0xe405
229 #define QEMU_KEY_CTRL_PAGEUP 0xe406
230 #define QEMU_KEY_CTRL_PAGEDOWN 0xe407
232 void kbd_put_keysym(int keysym);
234 /* async I/O support */
236 typedef void IOReadHandler(void *opaque, const uint8_t *buf, int size);
237 typedef int IOCanRWHandler(void *opaque);
238 typedef void IOHandler(void *opaque);
240 int qemu_set_fd_handler2(int fd,
241 IOCanRWHandler *fd_read_poll,
245 int qemu_set_fd_handler(int fd,
250 /* Polling handling */
252 /* return TRUE if no sleep should be done afterwards */
253 typedef int PollingFunc(void *opaque);
255 int qemu_add_polling_cb(PollingFunc *func, void *opaque);
256 void qemu_del_polling_cb(PollingFunc *func, void *opaque);
259 /* Wait objects handling */
260 typedef void WaitObjectFunc(void *opaque);
262 int qemu_add_wait_object(HANDLE handle, WaitObjectFunc *func, void *opaque);
263 void qemu_del_wait_object(HANDLE handle, WaitObjectFunc *func, void *opaque);
266 typedef struct QEMUBH QEMUBH;
268 /* character device */
270 #define CHR_EVENT_BREAK 0 /* serial break char */
271 #define CHR_EVENT_FOCUS 1 /* focus to this terminal (modal input needed) */
272 #define CHR_EVENT_RESET 2 /* new connection established */
275 #define CHR_IOCTL_SERIAL_SET_PARAMS 1
281 } QEMUSerialSetParams;
283 #define CHR_IOCTL_SERIAL_SET_BREAK 2
285 #define CHR_IOCTL_PP_READ_DATA 3
286 #define CHR_IOCTL_PP_WRITE_DATA 4
287 #define CHR_IOCTL_PP_READ_CONTROL 5
288 #define CHR_IOCTL_PP_WRITE_CONTROL 6
289 #define CHR_IOCTL_PP_READ_STATUS 7
291 typedef void IOEventHandler(void *opaque, int event);
293 typedef struct CharDriverState {
294 int (*chr_write)(struct CharDriverState *s, const uint8_t *buf, int len);
295 void (*chr_update_read_handler)(struct CharDriverState *s);
296 int (*chr_ioctl)(struct CharDriverState *s, int cmd, void *arg);
297 IOEventHandler *chr_event;
298 IOCanRWHandler *chr_can_read;
299 IOReadHandler *chr_read;
300 void *handler_opaque;
301 void (*chr_send_event)(struct CharDriverState *chr, int event);
302 void (*chr_close)(struct CharDriverState *chr);
307 CharDriverState *qemu_chr_open(const char *filename);
308 void qemu_chr_printf(CharDriverState *s, const char *fmt, ...);
309 int qemu_chr_write(CharDriverState *s, const uint8_t *buf, int len);
310 void qemu_chr_send_event(CharDriverState *s, int event);
311 void qemu_chr_add_handlers(CharDriverState *s,
312 IOCanRWHandler *fd_can_read,
313 IOReadHandler *fd_read,
314 IOEventHandler *fd_event,
316 int qemu_chr_ioctl(CharDriverState *s, int cmd, void *arg);
317 void qemu_chr_reset(CharDriverState *s);
318 int qemu_chr_can_read(CharDriverState *s);
319 void qemu_chr_read(CharDriverState *s, uint8_t *buf, int len);
323 typedef struct DisplayState DisplayState;
324 typedef struct TextConsole TextConsole;
326 typedef void (*vga_hw_update_ptr)(void *);
327 typedef void (*vga_hw_invalidate_ptr)(void *);
328 typedef void (*vga_hw_screen_dump_ptr)(void *, const char *);
330 TextConsole *graphic_console_init(DisplayState *ds, vga_hw_update_ptr update,
331 vga_hw_invalidate_ptr invalidate,
332 vga_hw_screen_dump_ptr screen_dump,
334 void vga_hw_update(void);
335 void vga_hw_invalidate(void);
336 void vga_hw_screen_dump(const char *filename);
338 int is_graphic_console(void);
339 CharDriverState *text_console_init(DisplayState *ds);
340 void console_select(unsigned int index);
344 #define MAX_SERIAL_PORTS 4
346 extern CharDriverState *serial_hds[MAX_SERIAL_PORTS];
350 #define MAX_PARALLEL_PORTS 3
352 extern CharDriverState *parallel_hds[MAX_PARALLEL_PORTS];
356 typedef struct VLANClientState VLANClientState;
358 struct VLANClientState {
359 IOReadHandler *fd_read;
360 /* Packets may still be sent if this returns zero. It's used to
361 rate-limit the slirp code. */
362 IOCanRWHandler *fd_can_read;
364 struct VLANClientState *next;
365 struct VLANState *vlan;
369 typedef struct VLANState {
371 VLANClientState *first_client;
372 struct VLANState *next;
375 VLANState *qemu_find_vlan(int id);
376 VLANClientState *qemu_new_vlan_client(VLANState *vlan,
377 IOReadHandler *fd_read,
378 IOCanRWHandler *fd_can_read,
380 int qemu_can_send_packet(VLANClientState *vc);
381 void qemu_send_packet(VLANClientState *vc, const uint8_t *buf, int size);
382 void qemu_handler_true(void *opaque);
384 void do_info_network(void);
387 int tap_win32_init(VLANState *vlan, const char *ifname);
393 typedef struct NICInfo {
400 extern NICInfo nd_table[MAX_NICS];
404 typedef struct QEMUClock QEMUClock;
405 typedef struct QEMUTimer QEMUTimer;
406 typedef void QEMUTimerCB(void *opaque);
408 /* The real time clock should be used only for stuff which does not
409 change the virtual machine state, as it is run even if the virtual
410 machine is stopped. The real time clock has a frequency of 1000
412 extern QEMUClock *rt_clock;
414 /* The virtual clock is only run during the emulation. It is stopped
415 when the virtual machine is stopped. Virtual timers use a high
416 precision clock, usually cpu cycles (use ticks_per_sec). */
417 extern QEMUClock *vm_clock;
419 int64_t qemu_get_clock(QEMUClock *clock);
421 QEMUTimer *qemu_new_timer(QEMUClock *clock, QEMUTimerCB *cb, void *opaque);
422 void qemu_free_timer(QEMUTimer *ts);
423 void qemu_del_timer(QEMUTimer *ts);
424 void qemu_mod_timer(QEMUTimer *ts, int64_t expire_time);
425 int qemu_timer_pending(QEMUTimer *ts);
427 extern int64_t ticks_per_sec;
428 extern int pit_min_timer_count;
430 int64_t cpu_get_ticks(void);
431 void cpu_enable_ticks(void);
432 void cpu_disable_ticks(void);
436 typedef struct QEMUFile QEMUFile;
438 QEMUFile *qemu_fopen(const char *filename, const char *mode);
439 void qemu_fflush(QEMUFile *f);
440 void qemu_fclose(QEMUFile *f);
441 void qemu_put_buffer(QEMUFile *f, const uint8_t *buf, int size);
442 void qemu_put_byte(QEMUFile *f, int v);
443 void qemu_put_be16(QEMUFile *f, unsigned int v);
444 void qemu_put_be32(QEMUFile *f, unsigned int v);
445 void qemu_put_be64(QEMUFile *f, uint64_t v);
446 int qemu_get_buffer(QEMUFile *f, uint8_t *buf, int size);
447 int qemu_get_byte(QEMUFile *f);
448 unsigned int qemu_get_be16(QEMUFile *f);
449 unsigned int qemu_get_be32(QEMUFile *f);
450 uint64_t qemu_get_be64(QEMUFile *f);
452 static inline void qemu_put_be64s(QEMUFile *f, const uint64_t *pv)
454 qemu_put_be64(f, *pv);
457 static inline void qemu_put_be32s(QEMUFile *f, const uint32_t *pv)
459 qemu_put_be32(f, *pv);
462 static inline void qemu_put_be16s(QEMUFile *f, const uint16_t *pv)
464 qemu_put_be16(f, *pv);
467 static inline void qemu_put_8s(QEMUFile *f, const uint8_t *pv)
469 qemu_put_byte(f, *pv);
472 static inline void qemu_get_be64s(QEMUFile *f, uint64_t *pv)
474 *pv = qemu_get_be64(f);
477 static inline void qemu_get_be32s(QEMUFile *f, uint32_t *pv)
479 *pv = qemu_get_be32(f);
482 static inline void qemu_get_be16s(QEMUFile *f, uint16_t *pv)
484 *pv = qemu_get_be16(f);
487 static inline void qemu_get_8s(QEMUFile *f, uint8_t *pv)
489 *pv = qemu_get_byte(f);
492 #if TARGET_LONG_BITS == 64
493 #define qemu_put_betl qemu_put_be64
494 #define qemu_get_betl qemu_get_be64
495 #define qemu_put_betls qemu_put_be64s
496 #define qemu_get_betls qemu_get_be64s
498 #define qemu_put_betl qemu_put_be32
499 #define qemu_get_betl qemu_get_be32
500 #define qemu_put_betls qemu_put_be32s
501 #define qemu_get_betls qemu_get_be32s
504 int64_t qemu_ftell(QEMUFile *f);
505 int64_t qemu_fseek(QEMUFile *f, int64_t pos, int whence);
507 typedef void SaveStateHandler(QEMUFile *f, void *opaque);
508 typedef int LoadStateHandler(QEMUFile *f, void *opaque, int version_id);
510 int register_savevm(const char *idstr,
513 SaveStateHandler *save_state,
514 LoadStateHandler *load_state,
516 void qemu_get_timer(QEMUFile *f, QEMUTimer *ts);
517 void qemu_put_timer(QEMUFile *f, QEMUTimer *ts);
519 void cpu_save(QEMUFile *f, void *opaque);
520 int cpu_load(QEMUFile *f, void *opaque, int version_id);
522 void do_savevm(const char *name);
523 void do_loadvm(const char *name);
524 void do_delvm(const char *name);
525 void do_info_snapshots(void);
528 typedef void QEMUBHFunc(void *opaque);
530 QEMUBH *qemu_bh_new(QEMUBHFunc *cb, void *opaque);
531 void qemu_bh_schedule(QEMUBH *bh);
532 void qemu_bh_cancel(QEMUBH *bh);
533 void qemu_bh_delete(QEMUBH *bh);
534 int qemu_bh_poll(void);
537 typedef struct BlockDriverState BlockDriverState;
538 typedef struct BlockDriver BlockDriver;
540 extern BlockDriver bdrv_raw;
541 extern BlockDriver bdrv_host_device;
542 extern BlockDriver bdrv_cow;
543 extern BlockDriver bdrv_qcow;
544 extern BlockDriver bdrv_vmdk;
545 extern BlockDriver bdrv_cloop;
546 extern BlockDriver bdrv_dmg;
547 extern BlockDriver bdrv_bochs;
548 extern BlockDriver bdrv_vpc;
549 extern BlockDriver bdrv_vvfat;
550 extern BlockDriver bdrv_qcow2;
552 typedef struct BlockDriverInfo {
553 /* in bytes, 0 if irrelevant */
555 /* offset at which the VM state can be saved (0 if not possible) */
556 int64_t vm_state_offset;
559 typedef struct QEMUSnapshotInfo {
560 char id_str[128]; /* unique snapshot id */
561 /* the following fields are informative. They are not needed for
562 the consistency of the snapshot */
563 char name[256]; /* user choosen name */
564 uint32_t vm_state_size; /* VM state info size */
565 uint32_t date_sec; /* UTC date of the snapshot */
567 uint64_t vm_clock_nsec; /* VM clock relative to boot */
570 #define BDRV_O_RDONLY 0x0000
571 #define BDRV_O_RDWR 0x0002
572 #define BDRV_O_ACCESS 0x0003
573 #define BDRV_O_CREAT 0x0004 /* create an empty file */
574 #define BDRV_O_SNAPSHOT 0x0008 /* open the file read only and save writes in a snapshot */
575 #define BDRV_O_FILE 0x0010 /* open as a raw file (do not try to
576 use a disk image format on top of
580 void bdrv_init(void);
581 BlockDriver *bdrv_find_format(const char *format_name);
582 int bdrv_create(BlockDriver *drv,
583 const char *filename, int64_t size_in_sectors,
584 const char *backing_file, int flags);
585 BlockDriverState *bdrv_new(const char *device_name);
586 void bdrv_delete(BlockDriverState *bs);
587 int bdrv_file_open(BlockDriverState **pbs, const char *filename, int flags);
588 int bdrv_open(BlockDriverState *bs, const char *filename, int flags);
589 int bdrv_open2(BlockDriverState *bs, const char *filename, int flags,
591 void bdrv_close(BlockDriverState *bs);
592 int bdrv_read(BlockDriverState *bs, int64_t sector_num,
593 uint8_t *buf, int nb_sectors);
594 int bdrv_write(BlockDriverState *bs, int64_t sector_num,
595 const uint8_t *buf, int nb_sectors);
596 int bdrv_pread(BlockDriverState *bs, int64_t offset,
597 void *buf, int count);
598 int bdrv_pwrite(BlockDriverState *bs, int64_t offset,
599 const void *buf, int count);
600 int bdrv_truncate(BlockDriverState *bs, int64_t offset);
601 int64_t bdrv_getlength(BlockDriverState *bs);
602 void bdrv_get_geometry(BlockDriverState *bs, int64_t *nb_sectors_ptr);
603 int bdrv_commit(BlockDriverState *bs);
604 void bdrv_set_boot_sector(BlockDriverState *bs, const uint8_t *data, int size);
605 /* async block I/O */
606 typedef struct BlockDriverAIOCB BlockDriverAIOCB;
607 typedef void BlockDriverCompletionFunc(void *opaque, int ret);
609 BlockDriverAIOCB *bdrv_aio_read(BlockDriverState *bs, int64_t sector_num,
610 uint8_t *buf, int nb_sectors,
611 BlockDriverCompletionFunc *cb, void *opaque);
612 BlockDriverAIOCB *bdrv_aio_write(BlockDriverState *bs, int64_t sector_num,
613 const uint8_t *buf, int nb_sectors,
614 BlockDriverCompletionFunc *cb, void *opaque);
615 void bdrv_aio_cancel(BlockDriverAIOCB *acb);
617 void qemu_aio_init(void);
618 void qemu_aio_poll(void);
619 void qemu_aio_flush(void);
620 void qemu_aio_wait_start(void);
621 void qemu_aio_wait(void);
622 void qemu_aio_wait_end(void);
624 /* Ensure contents are flushed to disk. */
625 void bdrv_flush(BlockDriverState *bs);
627 #define BDRV_TYPE_HD 0
628 #define BDRV_TYPE_CDROM 1
629 #define BDRV_TYPE_FLOPPY 2
630 #define BIOS_ATA_TRANSLATION_AUTO 0
631 #define BIOS_ATA_TRANSLATION_NONE 1
632 #define BIOS_ATA_TRANSLATION_LBA 2
633 #define BIOS_ATA_TRANSLATION_LARGE 3
634 #define BIOS_ATA_TRANSLATION_RECHS 4
636 void bdrv_set_geometry_hint(BlockDriverState *bs,
637 int cyls, int heads, int secs);
638 void bdrv_set_type_hint(BlockDriverState *bs, int type);
639 void bdrv_set_translation_hint(BlockDriverState *bs, int translation);
640 void bdrv_get_geometry_hint(BlockDriverState *bs,
641 int *pcyls, int *pheads, int *psecs);
642 int bdrv_get_type_hint(BlockDriverState *bs);
643 int bdrv_get_translation_hint(BlockDriverState *bs);
644 int bdrv_is_removable(BlockDriverState *bs);
645 int bdrv_is_read_only(BlockDriverState *bs);
646 int bdrv_is_inserted(BlockDriverState *bs);
647 int bdrv_media_changed(BlockDriverState *bs);
648 int bdrv_is_locked(BlockDriverState *bs);
649 void bdrv_set_locked(BlockDriverState *bs, int locked);
650 void bdrv_eject(BlockDriverState *bs, int eject_flag);
651 void bdrv_set_change_cb(BlockDriverState *bs,
652 void (*change_cb)(void *opaque), void *opaque);
653 void bdrv_get_format(BlockDriverState *bs, char *buf, int buf_size);
654 void bdrv_info(void);
655 BlockDriverState *bdrv_find(const char *name);
656 void bdrv_iterate(void (*it)(void *opaque, const char *name), void *opaque);
657 int bdrv_is_encrypted(BlockDriverState *bs);
658 int bdrv_set_key(BlockDriverState *bs, const char *key);
659 void bdrv_iterate_format(void (*it)(void *opaque, const char *name),
661 const char *bdrv_get_device_name(BlockDriverState *bs);
662 int bdrv_write_compressed(BlockDriverState *bs, int64_t sector_num,
663 const uint8_t *buf, int nb_sectors);
664 int bdrv_get_info(BlockDriverState *bs, BlockDriverInfo *bdi);
666 void bdrv_get_backing_filename(BlockDriverState *bs,
667 char *filename, int filename_size);
668 int bdrv_snapshot_create(BlockDriverState *bs,
669 QEMUSnapshotInfo *sn_info);
670 int bdrv_snapshot_goto(BlockDriverState *bs,
671 const char *snapshot_id);
672 int bdrv_snapshot_delete(BlockDriverState *bs, const char *snapshot_id);
673 int bdrv_snapshot_list(BlockDriverState *bs,
674 QEMUSnapshotInfo **psn_info);
675 char *bdrv_snapshot_dump(char *buf, int buf_size, QEMUSnapshotInfo *sn);
677 char *get_human_readable_size(char *buf, int buf_size, int64_t size);
678 int path_is_absolute(const char *path);
679 void path_combine(char *dest, int dest_size,
680 const char *base_path,
681 const char *filename);
685 typedef void QEMUMachineInitFunc(int ram_size, int vga_ram_size,
687 DisplayState *ds, const char **fd_filename, int snapshot,
688 const char *kernel_filename, const char *kernel_cmdline,
689 const char *initrd_filename);
691 typedef struct QEMUMachine {
694 QEMUMachineInitFunc *init;
695 struct QEMUMachine *next;
698 int qemu_register_machine(QEMUMachine *m);
700 typedef void SetIRQFunc(void *opaque, int irq_num, int level);
701 typedef void IRQRequestFunc(void *opaque, int level);
705 extern target_phys_addr_t isa_mem_base;
707 typedef void (IOPortWriteFunc)(void *opaque, uint32_t address, uint32_t data);
708 typedef uint32_t (IOPortReadFunc)(void *opaque, uint32_t address);
710 int register_ioport_read(int start, int length, int size,
711 IOPortReadFunc *func, void *opaque);
712 int register_ioport_write(int start, int length, int size,
713 IOPortWriteFunc *func, void *opaque);
714 void isa_unassign_ioport(int start, int length);
716 void isa_mmio_init(target_phys_addr_t base, target_phys_addr_t size);
720 extern target_phys_addr_t pci_mem_base;
722 typedef struct PCIBus PCIBus;
723 typedef struct PCIDevice PCIDevice;
725 typedef void PCIConfigWriteFunc(PCIDevice *pci_dev,
726 uint32_t address, uint32_t data, int len);
727 typedef uint32_t PCIConfigReadFunc(PCIDevice *pci_dev,
728 uint32_t address, int len);
729 typedef void PCIMapIORegionFunc(PCIDevice *pci_dev, int region_num,
730 uint32_t addr, uint32_t size, int type);
732 #define PCI_ADDRESS_SPACE_MEM 0x00
733 #define PCI_ADDRESS_SPACE_IO 0x01
734 #define PCI_ADDRESS_SPACE_MEM_PREFETCH 0x08
736 typedef struct PCIIORegion {
737 uint32_t addr; /* current PCI mapping address. -1 means not mapped */
740 PCIMapIORegionFunc *map_func;
743 #define PCI_ROM_SLOT 6
744 #define PCI_NUM_REGIONS 7
746 #define PCI_DEVICES_MAX 64
748 #define PCI_VENDOR_ID 0x00 /* 16 bits */
749 #define PCI_DEVICE_ID 0x02 /* 16 bits */
750 #define PCI_COMMAND 0x04 /* 16 bits */
751 #define PCI_COMMAND_IO 0x1 /* Enable response in I/O space */
752 #define PCI_COMMAND_MEMORY 0x2 /* Enable response in Memory space */
753 #define PCI_CLASS_DEVICE 0x0a /* Device class */
754 #define PCI_INTERRUPT_LINE 0x3c /* 8 bits */
755 #define PCI_INTERRUPT_PIN 0x3d /* 8 bits */
756 #define PCI_MIN_GNT 0x3e /* 8 bits */
757 #define PCI_MAX_LAT 0x3f /* 8 bits */
760 /* PCI config space */
763 /* the following fields are read only */
767 PCIIORegion io_regions[PCI_NUM_REGIONS];
769 /* do not access the following fields */
770 PCIConfigReadFunc *config_read;
771 PCIConfigWriteFunc *config_write;
772 /* ??? This is a PC-specific hack, and should be removed. */
775 /* Current IRQ levels. Used internally by the generic PCI code. */
779 PCIDevice *pci_register_device(PCIBus *bus, const char *name,
780 int instance_size, int devfn,
781 PCIConfigReadFunc *config_read,
782 PCIConfigWriteFunc *config_write);
784 void pci_register_io_region(PCIDevice *pci_dev, int region_num,
785 uint32_t size, int type,
786 PCIMapIORegionFunc *map_func);
788 void pci_set_irq(PCIDevice *pci_dev, int irq_num, int level);
790 uint32_t pci_default_read_config(PCIDevice *d,
791 uint32_t address, int len);
792 void pci_default_write_config(PCIDevice *d,
793 uint32_t address, uint32_t val, int len);
794 void pci_device_save(PCIDevice *s, QEMUFile *f);
795 int pci_device_load(PCIDevice *s, QEMUFile *f);
797 typedef void (*pci_set_irq_fn)(void *pic, int irq_num, int level);
798 typedef int (*pci_map_irq_fn)(PCIDevice *pci_dev, int irq_num);
799 PCIBus *pci_register_bus(pci_set_irq_fn set_irq, pci_map_irq_fn map_irq,
800 void *pic, int devfn_min, int nirq);
802 void pci_nic_init(PCIBus *bus, NICInfo *nd, int devfn);
803 void pci_data_write(void *opaque, uint32_t addr, uint32_t val, int len);
804 uint32_t pci_data_read(void *opaque, uint32_t addr, int len);
805 int pci_bus_num(PCIBus *s);
806 void pci_for_each_device(int bus_num, void (*fn)(PCIDevice *d));
809 PCIBus *pci_bridge_init(PCIBus *bus, int devfn, uint32_t id,
810 pci_map_irq_fn map_irq, const char *name);
813 PCIBus *pci_prep_init(void);
816 PCIBus *pci_grackle_init(uint32_t base, void *pic);
819 PCIBus *pci_pmac_init(void *pic);
822 PCIBus *pci_apb_init(target_ulong special_base, target_ulong mem_base,
825 PCIBus *pci_vpb_init(void *pic, int irq, int realview);
828 PCIBus *i440fx_init(PCIDevice **pi440fx_state);
829 void i440fx_set_smm(PCIDevice *d, int val);
830 int piix3_init(PCIBus *bus, int devfn);
831 void i440fx_init_memory_mappings(PCIDevice *d);
833 int piix4_init(PCIBus *bus, int devfn);
836 typedef struct openpic_t openpic_t;
837 void openpic_set_irq(void *opaque, int n_IRQ, int level);
838 openpic_t *openpic_init (PCIBus *bus, int *pmem_index, int nb_cpus,
842 typedef struct HeathrowPICS HeathrowPICS;
843 void heathrow_pic_set_irq(void *opaque, int num, int level);
844 HeathrowPICS *heathrow_pic_init(int *pmem_index);
847 PCIBus *pci_gt64120_init(void *pic);
856 int (*init_isa) (AudioState *s);
857 int (*init_pci) (PCIBus *bus, AudioState *s);
861 extern struct soundhw soundhw[];
866 #define VGA_RAM_SIZE (8192 * 1024)
868 struct DisplayState {
872 int bgr; /* BGR color order instead of RGB. Only valid for depth == 32 */
877 void (*dpy_update)(struct DisplayState *s, int x, int y, int w, int h);
878 void (*dpy_resize)(struct DisplayState *s, int w, int h);
879 void (*dpy_refresh)(struct DisplayState *s);
880 void (*dpy_copy)(struct DisplayState *s, int src_x, int src_y, int dst_x, int dst_y, int w, int h);
883 static inline void dpy_update(DisplayState *s, int x, int y, int w, int h)
885 s->dpy_update(s, x, y, w, h);
888 static inline void dpy_resize(DisplayState *s, int w, int h)
890 s->dpy_resize(s, w, h);
893 int isa_vga_init(DisplayState *ds, uint8_t *vga_ram_base,
894 unsigned long vga_ram_offset, int vga_ram_size);
895 int pci_vga_init(PCIBus *bus, DisplayState *ds, uint8_t *vga_ram_base,
896 unsigned long vga_ram_offset, int vga_ram_size,
897 unsigned long vga_bios_offset, int vga_bios_size);
900 void pci_cirrus_vga_init(PCIBus *bus, DisplayState *ds, uint8_t *vga_ram_base,
901 unsigned long vga_ram_offset, int vga_ram_size);
902 void isa_cirrus_vga_init(DisplayState *ds, uint8_t *vga_ram_base,
903 unsigned long vga_ram_offset, int vga_ram_size);
906 void sdl_display_init(DisplayState *ds, int full_screen);
909 void cocoa_display_init(DisplayState *ds, int full_screen);
912 void vnc_display_init(DisplayState *ds, const char *display);
915 extern uint8_t _translate_keycode(const int key);
920 extern BlockDriverState *bs_table[MAX_DISKS + 1];
922 void isa_ide_init(int iobase, int iobase2, int irq,
923 BlockDriverState *hd0, BlockDriverState *hd1);
924 void pci_cmd646_ide_init(PCIBus *bus, BlockDriverState **hd_table,
925 int secondary_ide_enabled);
926 void pci_piix3_ide_init(PCIBus *bus, BlockDriverState **hd_table, int devfn);
927 int pmac_ide_init (BlockDriverState **hd_table,
928 SetIRQFunc *set_irq, void *irq_opaque, int irq);
931 int cdrom_read_toc(int nb_sectors, uint8_t *buf, int msf, int start_track);
932 int cdrom_read_toc_raw(int nb_sectors, uint8_t *buf, int msf, int session_num);
935 int es1370_init (PCIBus *bus, AudioState *s);
938 int SB16_init (AudioState *s);
941 int Adlib_init (AudioState *s);
944 int GUS_init (AudioState *s);
947 typedef int (*DMA_transfer_handler) (void *opaque, int nchan, int pos, int size);
948 int DMA_get_channel_mode (int nchan);
949 int DMA_read_memory (int nchan, void *buf, int pos, int size);
950 int DMA_write_memory (int nchan, void *buf, int pos, int size);
951 void DMA_hold_DREQ (int nchan);
952 void DMA_release_DREQ (int nchan);
953 void DMA_schedule(int nchan);
955 void DMA_init (int high_page_enable);
956 void DMA_register_channel (int nchan,
957 DMA_transfer_handler transfer_handler,
961 extern BlockDriverState *fd_table[MAX_FD];
963 typedef struct fdctrl_t fdctrl_t;
965 fdctrl_t *fdctrl_init (int irq_lvl, int dma_chann, int mem_mapped,
967 BlockDriverState **fds);
968 int fdctrl_get_drive_type(fdctrl_t *fdctrl, int drive_num);
972 void isa_ne2000_init(int base, int irq, NICInfo *nd);
973 void pci_ne2000_init(PCIBus *bus, NICInfo *nd, int devfn);
977 void pci_rtl8139_init(PCIBus *bus, NICInfo *nd, int devfn);
981 void pci_pcnet_init(PCIBus *bus, NICInfo *nd, int devfn);
982 void pcnet_h_reset(void *opaque);
983 void *lance_init(NICInfo *nd, uint32_t leaddr, void *dma_opaque);
992 typedef struct RTCState RTCState;
994 RTCState *rtc_init(int base, int irq);
995 void rtc_set_memory(RTCState *s, int addr, int val);
996 void rtc_set_date(RTCState *s, const struct tm *tm);
1000 typedef struct SerialState SerialState;
1001 SerialState *serial_init(SetIRQFunc *set_irq, void *opaque,
1002 int base, int irq, CharDriverState *chr);
1003 SerialState *serial_mm_init (SetIRQFunc *set_irq, void *opaque,
1004 target_ulong base, int it_shift,
1005 int irq, CharDriverState *chr);
1009 typedef struct ParallelState ParallelState;
1010 ParallelState *parallel_init(int base, int irq, CharDriverState *chr);
1014 typedef struct PicState2 PicState2;
1015 extern PicState2 *isa_pic;
1016 void pic_set_irq(int irq, int level);
1017 void pic_set_irq_new(void *opaque, int irq, int level);
1018 PicState2 *pic_init(IRQRequestFunc *irq_request, void *irq_request_opaque);
1019 void pic_set_alt_irq_func(PicState2 *s, SetIRQFunc *alt_irq_func,
1020 void *alt_irq_opaque);
1021 int pic_read_irq(PicState2 *s);
1022 void pic_update_irq(PicState2 *s);
1023 uint32_t pic_intack_read(PicState2 *s);
1024 void pic_info(void);
1025 void irq_info(void);
1028 typedef struct IOAPICState IOAPICState;
1030 int apic_init(CPUState *env);
1031 int apic_get_interrupt(CPUState *env);
1032 IOAPICState *ioapic_init(void);
1033 void ioapic_set_irq(void *opaque, int vector, int level);
1037 #define PIT_FREQ 1193182
1039 typedef struct PITState PITState;
1041 PITState *pit_init(int base, int irq);
1042 void pit_set_gate(PITState *pit, int channel, int val);
1043 int pit_get_gate(PITState *pit, int channel);
1044 int pit_get_initial_count(PITState *pit, int channel);
1045 int pit_get_mode(PITState *pit, int channel);
1046 int pit_get_out(PITState *pit, int channel, int64_t current_time);
1049 void pcspk_init(PITState *);
1050 int pcspk_audio_init(AudioState *);
1053 extern int acpi_enabled;
1054 void piix4_pm_init(PCIBus *bus, int devfn);
1055 void acpi_bios_init(void);
1058 extern QEMUMachine pc_machine;
1059 extern QEMUMachine isapc_machine;
1060 extern int fd_bootchk;
1062 void ioport_set_a20(int enable);
1063 int ioport_get_a20(void);
1066 extern QEMUMachine prep_machine;
1067 extern QEMUMachine core99_machine;
1068 extern QEMUMachine heathrow_machine;
1071 extern QEMUMachine mips_machine;
1074 extern QEMUMachine mips_malta_machine;
1077 extern void cpu_mips_irq_request(void *opaque, int irq, int level);
1080 extern void cpu_mips_clock_init(CPUState *);
1081 extern void cpu_mips_irqctrl_init (void);
1084 extern QEMUMachine shix_machine;
1087 ppc_tb_t *cpu_ppc_tb_init (CPUState *env, uint32_t freq);
1089 void PREP_debug_write (void *opaque, uint32_t addr, uint32_t val);
1091 extern CPUWriteMemoryFunc *PPC_io_write[];
1092 extern CPUReadMemoryFunc *PPC_io_read[];
1093 void PPC_debug_write (void *opaque, uint32_t addr, uint32_t val);
1096 extern QEMUMachine sun4m_machine;
1097 void pic_set_irq_cpu(int irq, int level, unsigned int cpu);
1100 void *iommu_init(uint32_t addr);
1101 void sparc_iommu_memory_rw(void *opaque, target_phys_addr_t addr,
1102 uint8_t *buf, int len, int is_write);
1103 static inline void sparc_iommu_memory_read(void *opaque,
1104 target_phys_addr_t addr,
1105 uint8_t *buf, int len)
1107 sparc_iommu_memory_rw(opaque, addr, buf, len, 0);
1110 static inline void sparc_iommu_memory_write(void *opaque,
1111 target_phys_addr_t addr,
1112 uint8_t *buf, int len)
1114 sparc_iommu_memory_rw(opaque, addr, buf, len, 1);
1118 void tcx_init(DisplayState *ds, uint32_t addr, uint8_t *vram_base,
1119 unsigned long vram_offset, int vram_size, int width, int height);
1121 /* slavio_intctl.c */
1122 void *slavio_intctl_init();
1123 void slavio_intctl_set_cpu(void *opaque, unsigned int cpu, CPUState *env);
1124 void slavio_pic_info(void *opaque);
1125 void slavio_irq_info(void *opaque);
1126 void slavio_pic_set_irq(void *opaque, int irq, int level);
1127 void slavio_pic_set_irq_cpu(void *opaque, int irq, int level, unsigned int cpu);
1130 int get_image_size(const char *filename);
1131 int load_image(const char *filename, uint8_t *addr);
1132 int load_elf(const char *filename, int64_t virt_to_phys_addend, uint64_t *pentry);
1133 int load_aout(const char *filename, uint8_t *addr);
1135 /* slavio_timer.c */
1136 void slavio_timer_init(uint32_t addr, int irq, int mode, unsigned int cpu);
1138 /* slavio_serial.c */
1139 SerialState *slavio_serial_init(int base, int irq, CharDriverState *chr1, CharDriverState *chr2);
1140 void slavio_serial_ms_kbd_init(int base, int irq);
1143 void *slavio_misc_init(uint32_t base, int irq);
1144 void slavio_set_power_fail(void *opaque, int power_failing);
1147 void esp_scsi_attach(void *opaque, BlockDriverState *bd, int id);
1148 void *esp_init(BlockDriverState **bd, uint32_t espaddr, void *dma_opaque);
1149 void esp_reset(void *opaque);
1152 void *sparc32_dma_init(uint32_t daddr, int espirq, int leirq, void *iommu,
1154 void ledma_set_irq(void *opaque, int isr);
1155 void ledma_memory_read(void *opaque, target_phys_addr_t addr,
1156 uint8_t *buf, int len, int do_bswap);
1157 void ledma_memory_write(void *opaque, target_phys_addr_t addr,
1158 uint8_t *buf, int len, int do_bswap);
1159 void espdma_raise_irq(void *opaque);
1160 void espdma_clear_irq(void *opaque);
1161 void espdma_memory_read(void *opaque, uint8_t *buf, int len);
1162 void espdma_memory_write(void *opaque, uint8_t *buf, int len);
1163 void sparc32_dma_set_reset_data(void *opaque, void *esp_opaque,
1164 void *lance_opaque);
1167 void cs_init(target_phys_addr_t base, int irq, void *intctl);
1170 extern QEMUMachine sun4u_machine;
1173 #include "hw/m48t59.h"
1175 void NVRAM_set_byte (m48t59_t *nvram, uint32_t addr, uint8_t value);
1176 uint8_t NVRAM_get_byte (m48t59_t *nvram, uint32_t addr);
1177 void NVRAM_set_word (m48t59_t *nvram, uint32_t addr, uint16_t value);
1178 uint16_t NVRAM_get_word (m48t59_t *nvram, uint32_t addr);
1179 void NVRAM_set_lword (m48t59_t *nvram, uint32_t addr, uint32_t value);
1180 uint32_t NVRAM_get_lword (m48t59_t *nvram, uint32_t addr);
1181 void NVRAM_set_string (m48t59_t *nvram, uint32_t addr,
1182 const unsigned char *str, uint32_t max);
1183 int NVRAM_get_string (m48t59_t *nvram, uint8_t *dst, uint16_t addr, int max);
1184 void NVRAM_set_crc (m48t59_t *nvram, uint32_t addr,
1185 uint32_t start, uint32_t count);
1186 int PPC_NVRAM_set_params (m48t59_t *nvram, uint16_t NVRAM_size,
1187 const unsigned char *arch,
1188 uint32_t RAM_size, int boot_device,
1189 uint32_t kernel_image, uint32_t kernel_size,
1190 const char *cmdline,
1191 uint32_t initrd_image, uint32_t initrd_size,
1192 uint32_t NVRAM_image,
1193 int width, int height, int depth);
1197 #define MAX_ADB_DEVICES 16
1199 #define ADB_MAX_OUT_LEN 16
1201 typedef struct ADBDevice ADBDevice;
1203 /* buf = NULL means polling */
1204 typedef int ADBDeviceRequest(ADBDevice *d, uint8_t *buf_out,
1205 const uint8_t *buf, int len);
1206 typedef int ADBDeviceReset(ADBDevice *d);
1209 struct ADBBusState *bus;
1212 ADBDeviceRequest *devreq;
1213 ADBDeviceReset *devreset;
1217 typedef struct ADBBusState {
1218 ADBDevice devices[MAX_ADB_DEVICES];
1223 int adb_request(ADBBusState *s, uint8_t *buf_out,
1224 const uint8_t *buf, int len);
1225 int adb_poll(ADBBusState *s, uint8_t *buf_out);
1227 ADBDevice *adb_register_device(ADBBusState *s, int devaddr,
1228 ADBDeviceRequest *devreq,
1229 ADBDeviceReset *devreset,
1231 void adb_kbd_init(ADBBusState *bus);
1232 void adb_mouse_init(ADBBusState *bus);
1236 extern ADBBusState adb_bus;
1237 int cuda_init(SetIRQFunc *set_irq, void *irq_opaque, int irq);
1241 /* usb ports of the VM */
1243 void qemu_register_usb_port(USBPort *port, void *opaque, int index,
1244 usb_attachfn attach);
1246 #define VM_USB_HUB_SIZE 8
1248 void do_usb_add(const char *devname);
1249 void do_usb_del(const char *devname);
1250 void usb_info(void);
1254 SCSI_REASON_DONE, /* Command complete. */
1255 SCSI_REASON_DATA /* Transfer complete, more data required. */
1258 typedef struct SCSIDevice SCSIDevice;
1259 typedef void (*scsi_completionfn)(void *opaque, int reason, uint32_t tag,
1262 SCSIDevice *scsi_disk_init(BlockDriverState *bdrv,
1264 scsi_completionfn completion,
1266 void scsi_disk_destroy(SCSIDevice *s);
1268 int32_t scsi_send_command(SCSIDevice *s, uint32_t tag, uint8_t *buf, int lun);
1269 /* SCSI data transfers are asynchrnonous. However, unlike the block IO
1270 layer the completion routine may be called directly by
1271 scsi_{read,write}_data. */
1272 void scsi_read_data(SCSIDevice *s, uint32_t tag);
1273 int scsi_write_data(SCSIDevice *s, uint32_t tag);
1274 void scsi_cancel_io(SCSIDevice *s, uint32_t tag);
1275 uint8_t *scsi_get_buf(SCSIDevice *s, uint32_t tag);
1278 void lsi_scsi_attach(void *opaque, BlockDriverState *bd, int id);
1279 void *lsi_scsi_init(PCIBus *bus, int devfn);
1281 /* integratorcp.c */
1282 extern QEMUMachine integratorcp926_machine;
1283 extern QEMUMachine integratorcp1026_machine;
1286 extern QEMUMachine versatilepb_machine;
1287 extern QEMUMachine versatileab_machine;
1290 extern QEMUMachine realview_machine;
1293 void *ps2_kbd_init(void (*update_irq)(void *, int), void *update_arg);
1294 void *ps2_mouse_init(void (*update_irq)(void *, int), void *update_arg);
1295 void ps2_write_mouse(void *, int val);
1296 void ps2_write_keyboard(void *, int val);
1297 uint32_t ps2_read_data(void *);
1298 void ps2_queue(void *, int b);
1299 void ps2_keyboard_set_translation(void *opaque, int mode);
1302 void smc91c111_init(NICInfo *, uint32_t, void *, int);
1305 void *pl110_init(DisplayState *ds, uint32_t base, void *pic, int irq, int);
1308 void pl011_init(uint32_t base, void *pic, int irq, CharDriverState *chr);
1311 void pl050_init(uint32_t base, void *pic, int irq, int is_mouse);
1314 void *pl080_init(uint32_t base, void *pic, int irq, int nchannels);
1317 void *pl190_init(uint32_t base, void *parent, int irq, int fiq);
1320 void sp804_init(uint32_t base, void *pic, int irq);
1321 void icp_pit_init(uint32_t base, void *pic, int irq);
1324 void arm_sysctl_init(uint32_t base, uint32_t sys_id);
1327 void *arm_gic_init(uint32_t base, void *parent, int parent_irq);
1331 void arm_load_kernel(CPUState *env, int ram_size, const char *kernel_filename,
1332 const char *kernel_cmdline, const char *initrd_filename,
1338 struct SH7750State *sh7750_init(CPUState * cpu);
1341 /* The callback will be triggered if any of the designated lines change */
1342 uint16_t portamask_trigger;
1343 uint16_t portbmask_trigger;
1344 /* Return 0 if no action was taken */
1345 int (*port_change_cb) (uint16_t porta, uint16_t portb,
1346 uint16_t * periph_pdtra,
1347 uint16_t * periph_portdira,
1348 uint16_t * periph_pdtrb,
1349 uint16_t * periph_portdirb);
1352 int sh7750_register_io_device(struct SH7750State *s,
1353 sh7750_io_device * device);
1355 int tc58128_init(struct SH7750State *s, char *zone1, char *zone2);
1357 /* NOR flash devices */
1358 typedef struct pflash_t pflash_t;
1360 pflash_t *pflash_register (target_ulong base, ram_addr_t off,
1361 BlockDriverState *bs,
1362 target_ulong sector_len, int nb_blocs, int width,
1363 uint16_t id0, uint16_t id1,
1364 uint16_t id2, uint16_t id3);
1366 #include "gdbstub.h"
1368 #endif /* defined(QEMU_TOOL) */
1371 void monitor_init(CharDriverState *hd, int show_banner);
1372 void term_puts(const char *str);
1373 void term_vprintf(const char *fmt, va_list ap);
1374 void term_printf(const char *fmt, ...) __attribute__ ((__format__ (__printf__, 1, 2)));
1375 void term_print_filename(const char *filename);
1376 void term_flush(void);
1377 void term_print_help(void);
1378 void monitor_readline(const char *prompt, int is_password,
1379 char *buf, int buf_size);
1382 typedef void ReadLineFunc(void *opaque, const char *str);
1384 extern int completion_index;
1385 void add_completion(const char *str);
1386 void readline_handle_byte(int ch);
1387 void readline_find_completion(const char *cmdline);
1388 const char *readline_get_history(unsigned int index);
1389 void readline_start(const char *prompt, int is_password,
1390 ReadLineFunc *readline_func, void *opaque);
1392 void kqemu_record_dump(void);