blob: d133f35f4c47edfeb706f80f07d507421ddca599 [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
Kevin Wolfbeb6f0d2010-01-15 12:56:41 +01005#include "config-host.h"
6
malca5e50b22009-02-01 22:19:27 +00007#define QEMU_NORETURN __attribute__ ((__noreturn__))
Blue Swirl747bbdf2009-10-18 16:26:06 +00008#ifdef CONFIG_GCC_ATTRIBUTE_WARN_UNUSED_RESULT
9#define QEMU_WARN_UNUSED_RESULT __attribute__((warn_unused_result))
10#else
11#define QEMU_WARN_UNUSED_RESULT
12#endif
blueswir17d99a002009-01-14 19:00:36 +000013
Paolo Bonzini24ebf5f2010-02-18 21:25:23 +010014#define QEMU_BUILD_BUG_ON(x) typedef char __build_bug_on__##__LINE__[(x)?-1:1];
15
Blue Swirl29e922b2010-03-29 19:24:00 +000016typedef struct QEMUTimer QEMUTimer;
17typedef struct QEMUFile QEMUFile;
18typedef struct QEMUBH QEMUBH;
19
malca5e50b22009-02-01 22:19:27 +000020/* Hack around the mess dyngen-exec.h causes: We need QEMU_NORETURN in files that
blueswir17d99a002009-01-14 19:00:36 +000021 cannot include the following headers without conflicts. This condition has
22 to be removed once dyngen is gone. */
23#ifndef __DYNGEN_EXEC_H__
24
pbrookfaf07962007-11-11 02:51:17 +000025/* we put basic includes here to avoid repeating them in device drivers */
26#include <stdlib.h>
27#include <stdio.h>
28#include <stdarg.h>
Paul Brook11165822010-06-13 19:00:50 +010029#include <stdbool.h>
pbrookfaf07962007-11-11 02:51:17 +000030#include <string.h>
balrogc8906842008-11-12 17:18:41 +000031#include <strings.h>
pbrookfaf07962007-11-11 02:51:17 +000032#include <inttypes.h>
33#include <limits.h>
34#include <time.h>
35#include <ctype.h>
36#include <errno.h>
37#include <unistd.h>
38#include <fcntl.h>
39#include <sys/stat.h>
Paul Brook55616502009-05-13 20:51:49 +010040#include <assert.h>
pbrookfaf07962007-11-11 02:51:17 +000041
42#ifndef O_LARGEFILE
43#define O_LARGEFILE 0
44#endif
45#ifndef O_BINARY
46#define O_BINARY 0
47#endif
Juan Quintela0e74e662009-07-27 16:12:57 +020048#ifndef MAP_ANONYMOUS
49#define MAP_ANONYMOUS MAP_ANON
50#endif
pbrookfaf07962007-11-11 02:51:17 +000051#ifndef ENOMEDIUM
52#define ENOMEDIUM ENODEV
53#endif
Anthony Liguori4c955382009-07-28 15:48:31 -050054#if !defined(ENOTSUP)
Juan Quintela2880bc32009-07-27 16:13:22 +020055#define ENOTSUP 4096
56#endif
pbrookfaf07962007-11-11 02:51:17 +000057
Juan Quintela6114fdb2009-07-27 16:12:59 +020058#ifndef CONFIG_IOVEC
59#define CONFIG_IOVEC
aliguoribf9298b2008-12-05 20:05:26 +000060struct iovec {
61 void *iov_base;
62 size_t iov_len;
63};
Christoph Hellwige2a305f2010-01-26 14:49:08 +010064/*
65 * Use the same value as Linux for now.
66 */
67#define IOV_MAX 1024
blueswir1331dadd2008-12-06 19:44:56 +000068#else
69#include <sys/uio.h>
aliguoribf9298b2008-12-05 20:05:26 +000070#endif
71
pbrookfaf07962007-11-11 02:51:17 +000072#ifdef _WIN32
pbrookfaf07962007-11-11 02:51:17 +000073#define fsync _commit
74#define lseek _lseeki64
pbrookfaf07962007-11-11 02:51:17 +000075extern int qemu_ftruncate64(int, int64_t);
76#define ftruncate qemu_ftruncate64
77
pbrookfaf07962007-11-11 02:51:17 +000078static inline char *realpath(const char *path, char *resolved_path)
79{
80 _fullpath(resolved_path, path, _MAX_PATH);
81 return resolved_path;
82}
83
84#define PRId64 "I64d"
85#define PRIx64 "I64x"
86#define PRIu64 "I64u"
87#define PRIo64 "I64o"
88#endif
89
90/* FIXME: Remove NEED_CPU_H. */
91#ifndef NEED_CPU_H
92
pbrookfaf07962007-11-11 02:51:17 +000093#include <setjmp.h>
94#include "osdep.h"
95#include "bswap.h"
96
97#else
98
99#include "cpu.h"
100
101#endif /* !defined(NEED_CPU_H) */
102
103/* bottom halves */
pbrookfaf07962007-11-11 02:51:17 +0000104typedef void QEMUBHFunc(void *opaque);
105
Kevin Wolf9a1e9482009-10-22 17:54:38 +0200106void async_context_push(void);
107void async_context_pop(void);
108int get_async_context_id(void);
109
pbrookfaf07962007-11-11 02:51:17 +0000110QEMUBH *qemu_bh_new(QEMUBHFunc *cb, void *opaque);
111void qemu_bh_schedule(QEMUBH *bh);
aliguori80d35802008-10-31 17:42:00 +0000112/* Bottom halfs that are scheduled from a bottom half handler are instantly
113 * invoked. This can create an infinite loop if a bottom half handler
114 * schedules itself. qemu_bh_schedule_idle() avoids this infinite loop by
115 * ensuring that the bottom half isn't executed until the next main loop
116 * iteration.
117 */
aliguori1b435b12008-10-31 17:24:21 +0000118void qemu_bh_schedule_idle(QEMUBH *bh);
pbrookfaf07962007-11-11 02:51:17 +0000119void qemu_bh_cancel(QEMUBH *bh);
120void qemu_bh_delete(QEMUBH *bh);
121int qemu_bh_poll(void);
Kevin Wolf4f999d02009-10-22 17:54:37 +0200122void qemu_bh_update_timeout(int *timeout);
pbrookfaf07962007-11-11 02:51:17 +0000123
pbrook87ecb682007-11-17 17:14:51 +0000124uint64_t muldiv64(uint64_t a, uint32_t b, uint32_t c);
125
balrogf6503052008-02-17 11:42:19 +0000126void qemu_get_timedate(struct tm *tm, int offset);
127int qemu_timedate_diff(struct tm *tm);
128
pbrookfaf07962007-11-11 02:51:17 +0000129/* cutils.c */
130void pstrcpy(char *buf, int buf_size, const char *str);
131char *pstrcat(char *buf, int buf_size, const char *s);
132int strstart(const char *str, const char *val, const char **ptr);
133int stristart(const char *str, const char *val, const char **ptr);
Blue Swirld43277c2009-07-01 18:24:44 +0000134int qemu_strnlen(const char *s, int max_len);
pbrookfaf07962007-11-11 02:51:17 +0000135time_t mktimegm(struct tm *tm);
blueswir1ad46db92008-12-11 19:37:54 +0000136int qemu_fls(int i);
Christoph Hellwig6f1953c2009-09-04 19:01:32 +0200137int qemu_fdatasync(int fd);
Paolo Bonzinidb1a4972010-03-10 11:38:55 +0100138int fcntl_setfl(int fd, int flag);
pbrookfaf07962007-11-11 02:51:17 +0000139
Blue Swirl37022082009-08-15 07:51:59 +0000140/* path.c */
141void init_paths(const char *prefix);
142const char *path(const char *pathname);
143
blueswir1cd390082008-11-16 13:53:32 +0000144#define qemu_isalnum(c) isalnum((unsigned char)(c))
145#define qemu_isalpha(c) isalpha((unsigned char)(c))
146#define qemu_iscntrl(c) iscntrl((unsigned char)(c))
147#define qemu_isdigit(c) isdigit((unsigned char)(c))
148#define qemu_isgraph(c) isgraph((unsigned char)(c))
149#define qemu_islower(c) islower((unsigned char)(c))
150#define qemu_isprint(c) isprint((unsigned char)(c))
151#define qemu_ispunct(c) ispunct((unsigned char)(c))
152#define qemu_isspace(c) isspace((unsigned char)(c))
153#define qemu_isupper(c) isupper((unsigned char)(c))
154#define qemu_isxdigit(c) isxdigit((unsigned char)(c))
155#define qemu_tolower(c) tolower((unsigned char)(c))
156#define qemu_toupper(c) toupper((unsigned char)(c))
157#define qemu_isascii(c) isascii((unsigned char)(c))
158#define qemu_toascii(c) toascii((unsigned char)(c))
159
aurel32ca10f862008-04-11 21:35:42 +0000160void *qemu_malloc(size_t size);
ths2137b4c2008-08-06 08:37:17 +0000161void *qemu_realloc(void *ptr, size_t size);
aurel32ca10f862008-04-11 21:35:42 +0000162void *qemu_mallocz(size_t size);
163void qemu_free(void *ptr);
164char *qemu_strdup(const char *str);
balrogac4b0d02008-11-09 00:28:40 +0000165char *qemu_strndup(const char *str, size_t size);
aurel32ca10f862008-04-11 21:35:42 +0000166
167void *get_mmap_addr(unsigned long size);
168
169
Glauber Costad549db52009-10-07 16:38:03 -0300170void qemu_mutex_lock_iothread(void);
171void qemu_mutex_unlock_iothread(void);
172
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
pbrook87ecb682007-11-17 17:14:51 +0000183/* Error handling. */
184
malca5e50b22009-02-01 22:19:27 +0000185void QEMU_NORETURN hw_error(const char *fmt, ...)
blueswir17d99a002009-01-14 19:00:36 +0000186 __attribute__ ((__format__ (__printf__, 1, 2)));
pbrook87ecb682007-11-17 17:14:51 +0000187
188/* IO callbacks. */
189typedef void IOReadHandler(void *opaque, const uint8_t *buf, int size);
Juan Quintela7b27a762010-03-11 17:55:39 +0100190typedef int IOCanReadHandler(void *opaque);
pbrook87ecb682007-11-17 17:14:51 +0000191typedef void IOHandler(void *opaque);
192
193struct 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;
206typedef struct DisplayState DisplayState;
aliguori7d957bd2009-01-15 22:14:11 +0000207typedef struct DisplayChangeListener DisplayChangeListener;
208typedef struct DisplaySurface DisplaySurface;
aliguori7b5d76d2009-03-13 15:02:13 +0000209typedef struct DisplayAllocator DisplayAllocator;
aliguori7d957bd2009-01-15 22:14:11 +0000210typedef struct PixelFormat PixelFormat;
pbrook87ecb682007-11-17 17:14:51 +0000211typedef struct TextConsole TextConsole;
pbrookc60e08d2008-07-01 16:24:38 +0000212typedef TextConsole QEMUConsole;
pbrook87ecb682007-11-17 17:14:51 +0000213typedef struct CharDriverState CharDriverState;
Gerd Hoffmann76d32cb2009-10-21 15:25:22 +0200214typedef struct MACAddr MACAddr;
pbrook87ecb682007-11-17 17:14:51 +0000215typedef struct VLANState VLANState;
Mark McLoughlinf7105842009-10-08 19:58:31 +0100216typedef struct VLANClientState VLANClientState;
pbrook87ecb682007-11-17 17:14:51 +0000217typedef struct i2c_bus i2c_bus;
218typedef struct i2c_slave i2c_slave;
219typedef struct SMBusDevice SMBusDevice;
Isaku Yamahatafb47a2e2009-11-12 14:58:41 +0900220typedef struct PCIHostState PCIHostState;
221typedef struct PCIExpressHost PCIExpressHost;
pbrook87ecb682007-11-17 17:14:51 +0000222typedef struct PCIBus PCIBus;
223typedef struct PCIDevice PCIDevice;
224typedef struct SerialState SerialState;
225typedef struct IRQState *qemu_irq;
Paul Brookbc24a222009-05-10 01:44:56 +0100226typedef struct PCMCIACardState PCMCIACardState;
227typedef struct MouseTransformInfo MouseTransformInfo;
228typedef struct uWireSlave uWireSlave;
229typedef struct I2SCodec I2SCodec;
Paul Brookaae94602009-05-14 22:35:06 +0100230typedef struct DeviceState DeviceState;
Paul Brook90d37232009-05-14 22:35:09 +0100231typedef struct SSIBus SSIBus;
Michael S. Tsirkin2292b332010-03-17 13:07:58 +0200232typedef struct EventNotifier EventNotifier;
Michael S. Tsirkin2be24aa2010-03-17 13:08:10 +0200233typedef struct VirtIODevice VirtIODevice;
pbrook87ecb682007-11-17 17:14:51 +0000234
Michael S. Tsirkin186993e2010-02-10 21:25:42 +0200235typedef uint64_t pcibus_t;
236
Blue Swirld2053c32010-03-29 19:23:48 +0000237void cpu_exec_init_all(unsigned long tb_size);
238
pbrookb3c77242008-06-30 16:31:04 +0000239/* CPU save/load. */
240void cpu_save(QEMUFile *f, void *opaque);
241int cpu_load(QEMUFile *f, void *opaque, int version_id);
242
aliguori9e472e12008-10-08 19:50:24 +0000243/* Force QEMU to stop what it's doing and service IO */
244void qemu_service_io(void);
245
aliguorid9f75a42009-04-24 18:03:11 +0000246/* Force QEMU to process pending events */
247void qemu_notify_event(void);
248
aliguori8edac962009-04-24 18:03:45 +0000249/* Unblock cpu */
250void qemu_cpu_kick(void *env);
251int qemu_cpu_self(void *env);
252
Marcelo Tosattie82bcec2010-05-04 09:45:22 -0300253/* work queue */
254struct qemu_work_item {
255 struct qemu_work_item *next;
256 void (*func)(void *data);
257 void *data;
258 int done;
259};
260
aliguori0bf46a42009-04-24 18:03:41 +0000261#ifdef CONFIG_USER_ONLY
262#define qemu_init_vcpu(env) do { } while (0)
263#else
264void qemu_init_vcpu(void *env);
265#endif
266
aliguori44e3ee82009-01-22 16:59:20 +0000267typedef struct QEMUIOVector {
268 struct iovec *iov;
269 int niov;
270 int nalloc;
aliguori249aa742009-01-26 17:17:52 +0000271 size_t size;
aliguori44e3ee82009-01-22 16:59:20 +0000272} QEMUIOVector;
273
274void qemu_iovec_init(QEMUIOVector *qiov, int alloc_hint);
aliguori522584a2009-03-28 17:46:10 +0000275void qemu_iovec_init_external(QEMUIOVector *qiov, struct iovec *iov, int niov);
aliguori44e3ee82009-01-22 16:59:20 +0000276void qemu_iovec_add(QEMUIOVector *qiov, void *base, size_t len);
Kevin Wolf40b4f532009-09-09 17:53:37 +0200277void qemu_iovec_concat(QEMUIOVector *dst, QEMUIOVector *src, size_t size);
aliguori44e3ee82009-01-22 16:59:20 +0000278void qemu_iovec_destroy(QEMUIOVector *qiov);
aliguoribe959462009-02-05 21:23:54 +0000279void qemu_iovec_reset(QEMUIOVector *qiov);
aliguori44e3ee82009-01-22 16:59:20 +0000280void qemu_iovec_to_buffer(QEMUIOVector *qiov, void *buf);
aliguori249aa742009-01-26 17:17:52 +0000281void qemu_iovec_from_buffer(QEMUIOVector *qiov, const void *buf, size_t count);
aliguori44e3ee82009-01-22 16:59:20 +0000282
aliguori376253e2009-03-05 23:01:23 +0000283struct Monitor;
284typedef struct Monitor Monitor;
285
Paul Brookabd0c6b2009-11-20 00:03:47 +0000286/* Convert a byte between binary and BCD. */
287static inline uint8_t to_bcd(uint8_t val)
288{
289 return ((val / 10) << 4) | (val % 10);
290}
291
292static inline uint8_t from_bcd(uint8_t val)
293{
294 return ((val >> 4) * 10) + (val & 0x0f);
295}
296
Anthony Liguori0bfe3ca2009-05-14 19:29:53 +0100297#include "module.h"
298
blueswir17d99a002009-01-14 19:00:36 +0000299#endif /* dyngen-exec.h hack */
300
pbrookfaf07962007-11-11 02:51:17 +0000301#endif