blob: 44870fe5236e480ee6b68c5b5a0a71a5baa1ec40 [file] [log] [blame]
pbrookfaf07962007-11-11 02:51:17 +00001/* Common header file that is included by all of qemu. */
2#ifndef QEMU_COMMON_H
3#define QEMU_COMMON_H
4
Luiz Capitulino5c026322011-07-11 14:24:44 -03005#include "compiler.h"
Kevin Wolfbeb6f0d2010-01-15 12:56:41 +01006#include "config-host.h"
7
Paolo Bonzini332ae282011-07-28 12:10:28 +02008#if defined(__arm__) || defined(__sparc__) || defined(__mips__) || defined(__hppa__) || defined(__ia64__)
9#define WORDS_ALIGNED
10#endif
11
Blue Swirl082b5552011-03-27 09:04:57 +000012#define TFR(expr) do { if ((expr) != -1) break; } while (errno == EINTR)
Paolo Bonzini24ebf5f2010-02-18 21:25:23 +010013
Blue Swirl29e922b2010-03-29 19:24:00 +000014typedef struct QEMUTimer QEMUTimer;
15typedef struct QEMUFile QEMUFile;
Blue Swirl92a16d72010-06-19 07:47:42 +000016typedef struct DeviceState DeviceState;
Blue Swirl29e922b2010-03-29 19:24:00 +000017
Jan Kiszka316378e2011-03-02 08:56:09 +010018struct Monitor;
19typedef struct Monitor Monitor;
20
pbrookfaf07962007-11-11 02:51:17 +000021/* we put basic includes here to avoid repeating them in device drivers */
22#include <stdlib.h>
23#include <stdio.h>
24#include <stdarg.h>
Paul Brook11165822010-06-13 19:00:50 +010025#include <stdbool.h>
pbrookfaf07962007-11-11 02:51:17 +000026#include <string.h>
balrogc8906842008-11-12 17:18:41 +000027#include <strings.h>
pbrookfaf07962007-11-11 02:51:17 +000028#include <inttypes.h>
29#include <limits.h>
30#include <time.h>
31#include <ctype.h>
32#include <errno.h>
33#include <unistd.h>
34#include <fcntl.h>
35#include <sys/stat.h>
Hervé Poussineaudcfd0862011-03-06 13:23:13 +000036#include <sys/time.h>
Paul Brook55616502009-05-13 20:51:49 +010037#include <assert.h>
Alexandre Raymond86f69a92011-06-01 22:21:30 -040038#include <signal.h>
Anthony Liguori14015302011-08-20 22:18:37 -050039#include <glib.h>
pbrookfaf07962007-11-11 02:51:17 +000040
Blue Swirl082b5552011-03-27 09:04:57 +000041#ifdef _WIN32
42#include "qemu-os-win32.h"
43#endif
44
45#ifdef CONFIG_POSIX
46#include "qemu-os-posix.h"
47#endif
48
pbrookfaf07962007-11-11 02:51:17 +000049#ifndef O_LARGEFILE
50#define O_LARGEFILE 0
51#endif
52#ifndef O_BINARY
53#define O_BINARY 0
54#endif
Juan Quintela0e74e662009-07-27 16:12:57 +020055#ifndef MAP_ANONYMOUS
56#define MAP_ANONYMOUS MAP_ANON
57#endif
pbrookfaf07962007-11-11 02:51:17 +000058#ifndef ENOMEDIUM
59#define ENOMEDIUM ENODEV
60#endif
Anthony Liguori4c955382009-07-28 15:48:31 -050061#if !defined(ENOTSUP)
Juan Quintela2880bc32009-07-27 16:13:22 +020062#define ENOTSUP 4096
63#endif
Gerd Hoffmann3c9405a2010-10-07 11:50:45 +020064#ifndef TIME_MAX
65#define TIME_MAX LONG_MAX
66#endif
pbrookfaf07962007-11-11 02:51:17 +000067
Juan Quintela6114fdb2009-07-27 16:12:59 +020068#ifndef CONFIG_IOVEC
69#define CONFIG_IOVEC
aliguoribf9298b2008-12-05 20:05:26 +000070struct iovec {
71 void *iov_base;
72 size_t iov_len;
73};
Christoph Hellwige2a305f2010-01-26 14:49:08 +010074/*
75 * Use the same value as Linux for now.
76 */
77#define IOV_MAX 1024
blueswir1331dadd2008-12-06 19:44:56 +000078#else
79#include <sys/uio.h>
aliguoribf9298b2008-12-05 20:05:26 +000080#endif
81
Stefan Weilf8684452010-10-22 23:03:30 +020082typedef int (*fprintf_function)(FILE *f, const char *fmt, ...)
83 GCC_FMT_ATTR(2, 3);
84
pbrookfaf07962007-11-11 02:51:17 +000085#ifdef _WIN32
pbrookfaf07962007-11-11 02:51:17 +000086#define fsync _commit
87#define lseek _lseeki64
Blue Swirl64b85a82011-01-23 16:21:20 +000088int qemu_ftruncate64(int, int64_t);
pbrookfaf07962007-11-11 02:51:17 +000089#define ftruncate qemu_ftruncate64
90
pbrookfaf07962007-11-11 02:51:17 +000091static inline char *realpath(const char *path, char *resolved_path)
92{
93 _fullpath(resolved_path, path, _MAX_PATH);
94 return resolved_path;
95}
pbrookfaf07962007-11-11 02:51:17 +000096#endif
97
Paolo Bonzini946fb272011-09-12 13:57:37 +020098/* icount */
99void configure_icount(const char *option);
100extern int use_icount;
101
pbrookfaf07962007-11-11 02:51:17 +0000102/* FIXME: Remove NEED_CPU_H. */
103#ifndef NEED_CPU_H
104
pbrookfaf07962007-11-11 02:51:17 +0000105#include "osdep.h"
106#include "bswap.h"
107
108#else
109
110#include "cpu.h"
111
112#endif /* !defined(NEED_CPU_H) */
113
Andreas Färber3bbbee12011-05-29 19:42:51 +0200114/* main function, renamed */
115#if defined(CONFIG_COCOA)
116int qemu_main(int argc, char **argv, char **envp);
117#endif
118
balrogf6503052008-02-17 11:42:19 +0000119void qemu_get_timedate(struct tm *tm, int offset);
120int qemu_timedate_diff(struct tm *tm);
121
pbrookfaf07962007-11-11 02:51:17 +0000122/* cutils.c */
123void pstrcpy(char *buf, int buf_size, const char *str);
124char *pstrcat(char *buf, int buf_size, const char *s);
125int strstart(const char *str, const char *val, const char **ptr);
126int stristart(const char *str, const char *val, const char **ptr);
Blue Swirld43277c2009-07-01 18:24:44 +0000127int qemu_strnlen(const char *s, int max_len);
pbrookfaf07962007-11-11 02:51:17 +0000128time_t mktimegm(struct tm *tm);
blueswir1ad46db92008-12-11 19:37:54 +0000129int qemu_fls(int i);
Christoph Hellwig6f1953c2009-09-04 19:01:32 +0200130int qemu_fdatasync(int fd);
Paolo Bonzinidb1a4972010-03-10 11:38:55 +0100131int fcntl_setfl(int fd, int flag);
Stefan Berger443916d2011-09-28 06:41:32 -0400132int qemu_parse_fd(const char *param);
Jes Sorensend8427002010-12-09 14:17:24 +0100133
Jes Sorensend7142452011-01-26 11:54:58 +0100134/*
135 * strtosz() suffixes used to specify the default treatment of an
136 * argument passed to strtosz() without an explicit suffix.
137 * These should be defined using upper case characters in the range
138 * A-Z, as strtosz() will use qemu_toupper() on the given argument
139 * prior to comparison.
140 */
Jes Sorensend8427002010-12-09 14:17:24 +0100141#define STRTOSZ_DEFSUFFIX_TB 'T'
142#define STRTOSZ_DEFSUFFIX_GB 'G'
143#define STRTOSZ_DEFSUFFIX_MB 'M'
144#define STRTOSZ_DEFSUFFIX_KB 'K'
145#define STRTOSZ_DEFSUFFIX_B 'B'
Jes Sorensen70b4f4b2011-01-05 11:41:02 +0100146int64_t strtosz(const char *nptr, char **end);
147int64_t strtosz_suffix(const char *nptr, char **end, const char default_suffix);
Joerg Roedela732e1b2011-07-07 16:13:11 +0200148int64_t strtosz_suffix_unit(const char *nptr, char **end,
149 const char default_suffix, int64_t unit);
pbrookfaf07962007-11-11 02:51:17 +0000150
Blue Swirl37022082009-08-15 07:51:59 +0000151/* path.c */
152void init_paths(const char *prefix);
153const char *path(const char *pathname);
154
blueswir1cd390082008-11-16 13:53:32 +0000155#define qemu_isalnum(c) isalnum((unsigned char)(c))
156#define qemu_isalpha(c) isalpha((unsigned char)(c))
157#define qemu_iscntrl(c) iscntrl((unsigned char)(c))
158#define qemu_isdigit(c) isdigit((unsigned char)(c))
159#define qemu_isgraph(c) isgraph((unsigned char)(c))
160#define qemu_islower(c) islower((unsigned char)(c))
161#define qemu_isprint(c) isprint((unsigned char)(c))
162#define qemu_ispunct(c) ispunct((unsigned char)(c))
163#define qemu_isspace(c) isspace((unsigned char)(c))
164#define qemu_isupper(c) isupper((unsigned char)(c))
165#define qemu_isxdigit(c) isxdigit((unsigned char)(c))
166#define qemu_tolower(c) tolower((unsigned char)(c))
167#define qemu_toupper(c) toupper((unsigned char)(c))
168#define qemu_isascii(c) isascii((unsigned char)(c))
169#define qemu_toascii(c) toascii((unsigned char)(c))
170
Jes Sorensenb152aa82010-10-26 10:39:26 +0200171void *qemu_oom_check(void *ptr);
aurel32ca10f862008-04-11 21:35:42 +0000172
Kevin Wolf40ff6d72009-12-02 12:24:42 +0100173int qemu_open(const char *name, int flags, ...);
Juan Quintela7c7c0622010-01-20 00:56:09 +0100174ssize_t qemu_write_full(int fd, const void *buf, size_t count)
175 QEMU_WARN_UNUSED_RESULT;
Kevin Wolf40ff6d72009-12-02 12:24:42 +0100176void qemu_set_cloexec(int fd);
177
178#ifndef _WIN32
Paolo Bonzinif3dfda62010-02-11 00:23:46 +0100179int qemu_eventfd(int pipefd[2]);
Kevin Wolf40ff6d72009-12-02 12:24:42 +0100180int qemu_pipe(int pipefd[2]);
181#endif
182
Blue Swirl00aa0042011-07-23 20:04:29 +0000183#ifdef _WIN32
184#define qemu_recv(sockfd, buf, len, flags) recv(sockfd, (void *)buf, len, flags)
185#else
186#define qemu_recv(sockfd, buf, len, flags) recv(sockfd, buf, len, flags)
187#endif
188
pbrook87ecb682007-11-17 17:14:51 +0000189/* Error handling. */
190
Stefan Weile5924d82010-09-23 21:28:03 +0200191void QEMU_NORETURN hw_error(const char *fmt, ...) GCC_FMT_ATTR(1, 2);
pbrook87ecb682007-11-17 17:14:51 +0000192
pbrook87ecb682007-11-17 17:14:51 +0000193struct ParallelIOArg {
194 void *buffer;
195 int count;
196};
197
198typedef int (*DMA_transfer_handler) (void *opaque, int nchan, int pos, int size);
199
200/* A load of opaque types so that device init declarations don't have to
201 pull in all the real definitions. */
202typedef struct NICInfo NICInfo;
balrog1ae26a12008-09-28 23:19:47 +0000203typedef struct HCIInfo HCIInfo;
pbrook87ecb682007-11-17 17:14:51 +0000204typedef struct AudioState AudioState;
205typedef struct BlockDriverState BlockDriverState;
Blue Swirl24463332010-08-24 15:22:24 +0000206typedef struct DriveInfo DriveInfo;
pbrook87ecb682007-11-17 17:14:51 +0000207typedef struct DisplayState DisplayState;
aliguori7d957bd2009-01-15 22:14:11 +0000208typedef struct DisplayChangeListener DisplayChangeListener;
209typedef struct DisplaySurface DisplaySurface;
aliguori7b5d76d2009-03-13 15:02:13 +0000210typedef struct DisplayAllocator DisplayAllocator;
aliguori7d957bd2009-01-15 22:14:11 +0000211typedef struct PixelFormat PixelFormat;
pbrook87ecb682007-11-17 17:14:51 +0000212typedef struct TextConsole TextConsole;
pbrookc60e08d2008-07-01 16:24:38 +0000213typedef TextConsole QEMUConsole;
pbrook87ecb682007-11-17 17:14:51 +0000214typedef struct CharDriverState CharDriverState;
Gerd Hoffmann76d32cb2009-10-21 15:25:22 +0200215typedef struct MACAddr MACAddr;
pbrook87ecb682007-11-17 17:14:51 +0000216typedef struct VLANState VLANState;
Mark McLoughlinf7105842009-10-08 19:58:31 +0100217typedef struct VLANClientState VLANClientState;
pbrook87ecb682007-11-17 17:14:51 +0000218typedef struct i2c_bus i2c_bus;
219typedef struct i2c_slave i2c_slave;
220typedef struct SMBusDevice SMBusDevice;
Isaku Yamahatafb47a2e2009-11-12 14:58:41 +0900221typedef struct PCIHostState PCIHostState;
222typedef struct PCIExpressHost PCIExpressHost;
pbrook87ecb682007-11-17 17:14:51 +0000223typedef struct PCIBus PCIBus;
224typedef struct PCIDevice PCIDevice;
Isaku Yamahata04285272010-10-19 18:06:34 +0900225typedef struct PCIExpressDevice PCIExpressDevice;
Isaku Yamahata68f79992010-07-13 13:01:42 +0900226typedef struct PCIBridge PCIBridge;
Isaku Yamahata34e65942010-11-16 17:26:09 +0900227typedef struct PCIEAERMsg PCIEAERMsg;
228typedef struct PCIEAERLog PCIEAERLog;
229typedef struct PCIEAERErr PCIEAERErr;
Isaku Yamahatabc20ba92010-10-20 17:18:52 +0900230typedef struct PCIEPort PCIEPort;
231typedef struct PCIESlot PCIESlot;
pbrook87ecb682007-11-17 17:14:51 +0000232typedef struct SerialState SerialState;
233typedef struct IRQState *qemu_irq;
Paul Brookbc24a222009-05-10 01:44:56 +0100234typedef struct PCMCIACardState PCMCIACardState;
235typedef struct MouseTransformInfo MouseTransformInfo;
236typedef struct uWireSlave uWireSlave;
237typedef struct I2SCodec I2SCodec;
Paul Brook90d37232009-05-14 22:35:09 +0100238typedef struct SSIBus SSIBus;
Michael S. Tsirkin2292b332010-03-17 13:07:58 +0200239typedef struct EventNotifier EventNotifier;
Michael S. Tsirkin2be24aa2010-03-17 13:08:10 +0200240typedef struct VirtIODevice VirtIODevice;
Gerd Hoffmannd35bf9a2011-07-12 13:36:23 +0200241typedef struct QEMUSGList QEMUSGList;
pbrook87ecb682007-11-17 17:14:51 +0000242
Michael S. Tsirkin186993e2010-02-10 21:25:42 +0200243typedef uint64_t pcibus_t;
244
Jan Kiszkad5ab9712011-08-02 16:10:21 +0200245void tcg_exec_init(unsigned long tb_size);
246bool tcg_enabled(void);
247
248void cpu_exec_init_all(void);
Blue Swirld2053c32010-03-29 19:23:48 +0000249
pbrookb3c77242008-06-30 16:31:04 +0000250/* CPU save/load. */
251void cpu_save(QEMUFile *f, void *opaque);
252int cpu_load(QEMUFile *f, void *opaque, int version_id);
253
aliguori8edac962009-04-24 18:03:45 +0000254/* Unblock cpu */
255void qemu_cpu_kick(void *env);
Jan Kiszka46d62fa2011-02-01 22:15:59 +0100256void qemu_cpu_kick_self(void);
Jan Kiszkab7680cb2011-03-12 17:43:51 +0100257int qemu_cpu_is_self(void *env);
Paolo Bonziniab33fcd2011-04-13 10:03:44 +0200258bool all_cpu_threads_idle(void);
aliguori8edac962009-04-24 18:03:45 +0000259
Marcelo Tosattie82bcec2010-05-04 09:45:22 -0300260/* work queue */
261struct qemu_work_item {
262 struct qemu_work_item *next;
263 void (*func)(void *data);
264 void *data;
265 int done;
266};
267
aliguori0bf46a42009-04-24 18:03:41 +0000268#ifdef CONFIG_USER_ONLY
269#define qemu_init_vcpu(env) do { } while (0)
270#else
271void qemu_init_vcpu(void *env);
272#endif
273
aliguori44e3ee82009-01-22 16:59:20 +0000274typedef struct QEMUIOVector {
275 struct iovec *iov;
276 int niov;
277 int nalloc;
aliguori249aa742009-01-26 17:17:52 +0000278 size_t size;
aliguori44e3ee82009-01-22 16:59:20 +0000279} QEMUIOVector;
280
281void qemu_iovec_init(QEMUIOVector *qiov, int alloc_hint);
aliguori522584a2009-03-28 17:46:10 +0000282void qemu_iovec_init_external(QEMUIOVector *qiov, struct iovec *iov, int niov);
aliguori44e3ee82009-01-22 16:59:20 +0000283void qemu_iovec_add(QEMUIOVector *qiov, void *base, size_t len);
Kevin Wolfb8a83a42010-09-13 18:06:11 +0200284void qemu_iovec_copy(QEMUIOVector *dst, QEMUIOVector *src, uint64_t skip,
285 size_t size);
Kevin Wolf40b4f532009-09-09 17:53:37 +0200286void qemu_iovec_concat(QEMUIOVector *dst, QEMUIOVector *src, size_t size);
aliguori44e3ee82009-01-22 16:59:20 +0000287void qemu_iovec_destroy(QEMUIOVector *qiov);
aliguoribe959462009-02-05 21:23:54 +0000288void qemu_iovec_reset(QEMUIOVector *qiov);
aliguori44e3ee82009-01-22 16:59:20 +0000289void qemu_iovec_to_buffer(QEMUIOVector *qiov, void *buf);
aliguori249aa742009-01-26 17:17:52 +0000290void qemu_iovec_from_buffer(QEMUIOVector *qiov, const void *buf, size_t count);
Kevin Wolfb8a83a42010-09-13 18:06:11 +0200291void qemu_iovec_memset(QEMUIOVector *qiov, int c, size_t count);
Chunqiang Tange0d9c6f2011-02-03 10:12:49 -0500292void qemu_iovec_memset_skip(QEMUIOVector *qiov, int c, size_t count,
293 size_t skip);
aliguori44e3ee82009-01-22 16:59:20 +0000294
Jes Sorensen6b837bc2011-03-30 14:16:25 +0200295void qemu_progress_init(int enabled, float min_skip);
296void qemu_progress_end(void);
Jes Sorensen3bfe4db2011-05-09 17:32:20 +0200297void qemu_progress_print(float delta, int max);
Jes Sorensen6b837bc2011-03-30 14:16:25 +0200298
Blue Swirl082b5552011-03-27 09:04:57 +0000299#define QEMU_FILE_TYPE_BIOS 0
300#define QEMU_FILE_TYPE_KEYMAP 1
301char *qemu_find_file(int type, const char *name);
302
303/* OS specific functions */
304void os_setup_early_signal_handling(void);
305char *os_find_datadir(const char *argv0);
306void os_parse_cmd_args(int index, const char *optarg);
307void os_pidfile_error(void);
308
Paul Brookabd0c6b2009-11-20 00:03:47 +0000309/* Convert a byte between binary and BCD. */
310static inline uint8_t to_bcd(uint8_t val)
311{
312 return ((val / 10) << 4) | (val % 10);
313}
314
315static inline uint8_t from_bcd(uint8_t val)
316{
317 return ((val >> 4) * 10) + (val & 0x0f);
318}
319
malc338b9222010-10-30 01:41:01 +0400320/* compute with 96 bit intermediate result: (a*b)/c */
321static inline uint64_t muldiv64(uint64_t a, uint32_t b, uint32_t c)
322{
323 union {
324 uint64_t ll;
325 struct {
326#ifdef HOST_WORDS_BIGENDIAN
327 uint32_t high, low;
328#else
329 uint32_t low, high;
330#endif
331 } l;
332 } u, res;
333 uint64_t rl, rh;
334
335 u.ll = a;
336 rl = (uint64_t)u.l.low * (uint64_t)b;
337 rh = (uint64_t)u.l.high * (uint64_t)b;
338 rh += (rl >> 32);
339 res.l.high = rh / c;
340 res.l.low = (((rh % c) << 32) + (rl & 0xffffffff)) / c;
341 return res.ll;
342}
343
Stefan Hajnoczi39516902011-11-17 13:40:25 +0000344/* Round number down to multiple */
345#define QEMU_ALIGN_DOWN(n, m) ((n) / (m) * (m))
346
347/* Round number up to multiple */
348#define QEMU_ALIGN_UP(n, m) QEMU_ALIGN_DOWN((n) + (m) - 1, (m))
349
Anthony Liguori0bfe3ca2009-05-14 19:29:53 +0100350#include "module.h"
351
pbrookfaf07962007-11-11 02:51:17 +0000352#endif