Documentation: Add missing documentation for qdev related command line options
[qemu.git] / Makefile
blobc1fa08cecd572d16f04cb2001e551109dc66c125
1 # Makefile for QEMU.
3 # This needs to be defined before rules.mak
4 GENERATED_HEADERS = config-host.h
6 ifneq ($(wildcard config-host.mak),)
7 # Put the all: rule here so that config-host.mak can contain dependencies.
8 all: build-all
9 include config-host.mak
10 include $(SRC_PATH)/rules.mak
11 config-host.mak: configure
12 @echo $@ is out-of-date, running configure
13 @sed -n "/.*Configured with/s/[^:]*: //p" $@ | sh
14 else
15 config-host.mak:
16 @echo "Please call configure before running make!"
17 @exit 1
18 endif
20 # Don't try to regenerate Makefile or configure
21 # We don't generate any of them
22 Makefile: ;
23 configure: ;
25 .PHONY: all clean cscope distclean dvi html info install install-doc \
26 recurse-all speed tar tarbin test build-all
28 VPATH=$(SRC_PATH):$(SRC_PATH)/hw
30 LIBS+=-lz $(LIBS_TOOLS)
32 ifdef BUILD_DOCS
33 DOCS=qemu-doc.html qemu-tech.html qemu.1 qemu-img.1 qemu-nbd.8
34 else
35 DOCS=
36 endif
38 SUBDIR_MAKEFLAGS=$(if $(V),,--no-print-directory)
39 SUBDIR_DEVICES_MAK=$(patsubst %, %/config-devices.mak, $(TARGET_DIRS))
41 config-all-devices.mak: $(SUBDIR_DEVICES_MAK)
42 $(call quiet-command,cat $(SUBDIR_DEVICES_MAK) | grep =y | sort -u > $@," GEN $@")
44 %/config-devices.mak: default-configs/%.mak
45 $(call quiet-command,cat $< > $@.tmp, " GEN $@")
46 @if test -f $@ ; then \
47 echo "WARNING: $@ out of date." ;\
48 echo "Run \"make defconfig\" to regenerate." ; \
49 rm $@.tmp ; \
50 else \
51 mv $@.tmp $@ ; \
54 defconfig:
55 rm -f config-all-devices.mak $(SUBDIR_DEVICES_MAK)
57 -include config-all-devices.mak
59 build-all: $(DOCS) $(TOOLS) recurse-all
61 config-host.h: config-host.h-timestamp
62 config-host.h-timestamp: config-host.mak
64 SUBDIR_RULES=$(patsubst %,subdir-%, $(TARGET_DIRS))
66 subdir-%: $(GENERATED_HEADERS)
67 $(call quiet-command,$(MAKE) $(SUBDIR_MAKEFLAGS) -C $* V="$(V)" TARGET_DIR="$*/" all,)
69 $(filter %-softmmu,$(SUBDIR_RULES)): libqemu_common.a
71 $(filter %-user,$(SUBDIR_RULES)): libuser.a
73 libuser.a: $(GENERATED_HEADERS)
74 $(call quiet-command,$(MAKE) $(SUBDIR_MAKEFLAGS) -C libuser V="$(V)" TARGET_DIR="libuser/" all,)
76 ROMSUBDIR_RULES=$(patsubst %,romsubdir-%, $(ROMS))
77 romsubdir-%:
78 $(call quiet-command,$(MAKE) $(SUBDIR_MAKEFLAGS) -C pc-bios/$* V="$(V)" TARGET_DIR="$*/",)
80 ALL_SUBDIRS=$(TARGET_DIRS) $(patsubst %,pc-bios/%, $(ROMS))
82 recurse-all: $(SUBDIR_RULES) $(ROMSUBDIR_RULES)
84 #######################################################################
85 # QObject
86 qobject-obj-y = qint.o qstring.o qdict.o qlist.o qfloat.o qbool.o
87 qobject-obj-y += qjson.o json-lexer.o json-streamer.o json-parser.o
88 qobject-obj-y += qerror.o
90 #######################################################################
91 # block-obj-y is code used by both qemu system emulation and qemu-img
93 block-obj-y = cutils.o cache-utils.o qemu-malloc.o qemu-option.o module.o
94 block-obj-y += nbd.o block.o aio.o aes.o osdep.o
95 block-obj-$(CONFIG_POSIX) += posix-aio-compat.o
96 block-obj-$(CONFIG_LINUX_AIO) += linux-aio.o
98 block-nested-y += cow.o qcow.o vdi.o vmdk.o cloop.o dmg.o bochs.o vpc.o vvfat.o
99 block-nested-y += qcow2.o qcow2-refcount.o qcow2-cluster.o qcow2-snapshot.o
100 block-nested-y += parallels.o nbd.o
101 block-nested-$(CONFIG_WIN32) += raw-win32.o
102 block-nested-$(CONFIG_POSIX) += raw-posix.o
103 block-nested-$(CONFIG_CURL) += curl.o
105 block-obj-y += $(addprefix block/, $(block-nested-y))
107 net-obj-y = net.o
108 net-nested-y = queue.o checksum.o util.o
109 net-nested-y += socket.o
110 net-nested-y += dump.o
111 net-nested-$(CONFIG_POSIX) += tap.o
112 net-nested-$(CONFIG_LINUX) += tap-linux.o
113 net-nested-$(CONFIG_WIN32) += tap-win32.o
114 net-nested-$(CONFIG_BSD) += tap-bsd.o
115 net-nested-$(CONFIG_SOLARIS) += tap-solaris.o
116 net-nested-$(CONFIG_AIX) += tap-aix.o
117 net-nested-$(CONFIG_SLIRP) += slirp.o
118 net-nested-$(CONFIG_VDE) += vde.o
119 net-obj-y += $(addprefix net/, $(net-nested-y))
121 ######################################################################
122 # libqemu_common.a: Target independent part of system emulation. The
123 # long term path is to suppress *all* target specific code in case of
124 # system emulation, i.e. a single QEMU executable should support all
125 # CPUs and machines.
127 obj-y = $(block-obj-y)
128 obj-y += $(net-obj-y)
129 obj-y += $(qobject-obj-y)
130 obj-y += readline.o console.o
132 obj-y += tcg-runtime.o host-utils.o
133 obj-y += irq.o ioport.o
134 obj-$(CONFIG_PTIMER) += ptimer.o
135 obj-$(CONFIG_MAX7310) += max7310.o
136 obj-$(CONFIG_WM8750) += wm8750.o
137 obj-$(CONFIG_TWL92230) += twl92230.o
138 obj-$(CONFIG_TSC2005) += tsc2005.o
139 obj-$(CONFIG_LM832X) += lm832x.o
140 obj-$(CONFIG_TMP105) += tmp105.o
141 obj-$(CONFIG_STELLARIS_INPUT) += stellaris_input.o
142 obj-$(CONFIG_SSD0303) += ssd0303.o
143 obj-$(CONFIG_SSD0323) += ssd0323.o
144 obj-$(CONFIG_ADS7846) += ads7846.o
145 obj-$(CONFIG_MAX111X) += max111x.o
146 obj-$(CONFIG_DS1338) += ds1338.o
147 obj-y += i2c.o smbus.o smbus_eeprom.o
148 obj-y += eeprom93xx.o
149 obj-y += scsi-disk.o cdrom.o
150 obj-y += scsi-generic.o scsi-bus.o
151 obj-y += usb.o usb-hub.o usb-$(HOST_USB).o usb-hid.o usb-msd.o usb-wacom.o
152 obj-y += usb-serial.o usb-net.o usb-bus.o
153 obj-$(CONFIG_SSI) += ssi.o
154 obj-$(CONFIG_SSI_SD) += ssi-sd.o
155 obj-$(CONFIG_SD) += sd.o
156 obj-y += bt.o bt-host.o bt-vhci.o bt-l2cap.o bt-sdp.o bt-hci.o bt-hid.o usb-bt.o
157 obj-y += bt-hci-csr.o
158 obj-y += buffered_file.o migration.o migration-tcp.o qemu-sockets.o
159 obj-y += qemu-char.o aio.o savevm.o
160 obj-y += msmouse.o ps2.o
161 obj-y += qdev.o qdev-properties.o
162 obj-y += qemu-config.o block-migration.o
164 obj-$(CONFIG_BRLAPI) += baum.o
165 obj-$(CONFIG_POSIX) += migration-exec.o migration-unix.o migration-fd.o
167 audio/audio.o audio/fmodaudio.o: QEMU_CFLAGS += $(FMOD_CFLAGS)
169 audio-obj-y = audio.o noaudio.o wavaudio.o mixeng.o
170 audio-obj-$(CONFIG_SDL) += sdlaudio.o
171 audio-obj-$(CONFIG_OSS) += ossaudio.o
172 audio-obj-$(CONFIG_COREAUDIO) += coreaudio.o
173 audio-obj-$(CONFIG_ALSA) += alsaaudio.o
174 audio-obj-$(CONFIG_DSOUND) += dsoundaudio.o
175 audio-obj-$(CONFIG_FMOD) += fmodaudio.o
176 audio-obj-$(CONFIG_ESD) += esdaudio.o
177 audio-obj-$(CONFIG_PA) += paaudio.o
178 audio-obj-$(CONFIG_WINWAVE) += winwaveaudio.o
179 audio-obj-$(CONFIG_AUDIO_PT_INT) += audio_pt_int.o
180 audio-obj-$(CONFIG_AUDIO_WIN_INT) += audio_win_int.o
181 audio-obj-y += wavcapture.o
182 obj-y += $(addprefix audio/, $(audio-obj-y))
184 obj-y += keymaps.o
185 obj-$(CONFIG_SDL) += sdl.o sdl_zoom.o x_keymap.o
186 obj-$(CONFIG_CURSES) += curses.o
187 obj-y += vnc.o acl.o d3des.o
188 obj-$(CONFIG_VNC_TLS) += vnc-tls.o vnc-auth-vencrypt.o
189 obj-$(CONFIG_VNC_SASL) += vnc-auth-sasl.o
190 obj-$(CONFIG_COCOA) += cocoa.o
191 obj-$(CONFIG_IOTHREAD) += qemu-thread.o
193 slirp-obj-y = cksum.o if.o ip_icmp.o ip_input.o ip_output.o
194 slirp-obj-y += slirp.o mbuf.o misc.o sbuf.o socket.o tcp_input.o tcp_output.o
195 slirp-obj-y += tcp_subr.o tcp_timer.o udp.o bootp.o tftp.o
196 obj-$(CONFIG_SLIRP) += $(addprefix slirp/, $(slirp-obj-y))
198 # xen backend driver support
199 obj-$(CONFIG_XEN) += xen_backend.o xen_devconfig.o
200 obj-$(CONFIG_XEN) += xen_console.o xenfb.o xen_disk.o xen_nic.o
202 QEMU_CFLAGS+=$(CURL_CFLAGS)
204 cocoa.o: cocoa.m
206 keymaps.o: keymaps.c keymaps.h
208 sdl_zoom.o: sdl_zoom.c sdl_zoom.h sdl_zoom_template.h
210 sdl.o: sdl.c keymaps.h sdl_keysym.h sdl_zoom.h
212 sdl.o audio/sdlaudio.o sdl_zoom.o baum.o: QEMU_CFLAGS += $(SDL_CFLAGS)
214 acl.o: acl.h acl.c
216 vnc.h: vnc-tls.h vnc-auth-vencrypt.h vnc-auth-sasl.h keymaps.h
218 vnc.o: vnc.c vnc.h vnc_keysym.h vnchextile.h d3des.c d3des.h acl.h
220 vnc.o: QEMU_CFLAGS += $(VNC_TLS_CFLAGS)
222 vnc-tls.o: vnc-tls.c vnc.h
224 vnc-auth-vencrypt.o: vnc-auth-vencrypt.c vnc.h
226 vnc-auth-sasl.o: vnc-auth-sasl.c vnc.h
228 curses.o: curses.c keymaps.h curses_keys.h
230 bt-host.o: QEMU_CFLAGS += $(BLUEZ_CFLAGS)
232 libqemu_common.a: $(obj-y)
234 ######################################################################
236 qemu-img.o: qemu-img-cmds.h
238 qemu-img$(EXESUF): qemu-img.o qemu-tool.o $(block-obj-y) $(qobject-obj-y)
240 qemu-nbd$(EXESUF): qemu-nbd.o qemu-tool.o $(block-obj-y) $(qobject-obj-y)
242 qemu-io$(EXESUF): qemu-io.o qemu-tool.o cmd.o $(block-obj-y) $(qobject-obj-y)
244 qemu-img-cmds.h: $(SRC_PATH)/qemu-img-cmds.hx
245 $(call quiet-command,sh $(SRC_PATH)/hxtool -h < $< > $@," GEN $@")
247 check-qint: check-qint.o qint.o qemu-malloc.o
248 check-qstring: check-qstring.o qstring.o qemu-malloc.o
249 check-qdict: check-qdict.o qdict.o qint.o qstring.o qbool.o qemu-malloc.o qlist.o
250 check-qlist: check-qlist.o qlist.o qint.o qemu-malloc.o
251 check-qfloat: check-qfloat.o qfloat.o qemu-malloc.o
252 check-qjson: check-qjson.o qfloat.o qint.o qdict.o qstring.o qlist.o qbool.o qjson.o json-streamer.o json-lexer.o json-parser.o qemu-malloc.o
254 clean:
255 # avoid old build problems by removing potentially incorrect old files
256 rm -f config.mak op-i386.h opc-i386.h gen-op-i386.h op-arm.h opc-arm.h gen-op-arm.h
257 rm -f *.o *.d *.a $(TOOLS) TAGS cscope.* *.pod *~ */*~
258 rm -f slirp/*.o slirp/*.d audio/*.o audio/*.d block/*.o block/*.d net/*.o net/*.d
259 rm -f qemu-img-cmds.h
260 $(MAKE) -C tests clean
261 for d in $(ALL_SUBDIRS) libhw32 libhw64 libuser; do \
262 if test -d $$d; then $(MAKE) -C $$d $@ || exit 1; fi; \
263 done
265 distclean: clean
266 rm -f config-host.mak config-host.h* config-host.ld $(DOCS) qemu-options.texi qemu-img-cmds.texi qemu-monitor.texi
267 rm -f config-all-devices.mak
268 rm -f roms/seabios/config.mak roms/vgabios/config.mak
269 rm -f qemu-{doc,tech}.{info,aux,cp,dvi,fn,info,ky,log,pg,toc,tp,vr}
270 for d in $(TARGET_DIRS) libhw32 libhw64 libuser; do \
271 rm -rf $$d || exit 1 ; \
272 done
274 KEYMAPS=da en-gb et fr fr-ch is lt modifiers no pt-br sv \
275 ar de en-us fi fr-be hr it lv nl pl ru th \
276 common de-ch es fo fr-ca hu ja mk nl-be pt sl tr
278 ifdef INSTALL_BLOBS
279 BLOBS=bios.bin vgabios.bin vgabios-cirrus.bin ppc_rom.bin \
280 video.x openbios-sparc32 openbios-sparc64 openbios-ppc \
281 pxe-e1000.bin pxe-i82559er.bin \
282 pxe-ne2k_pci.bin pxe-pcnet.bin \
283 pxe-rtl8139.bin pxe-virtio.bin \
284 bamboo.dtb petalogix-s3adsp1800.dtb \
285 multiboot.bin linuxboot.bin
286 else
287 BLOBS=
288 endif
290 install-doc: $(DOCS)
291 $(INSTALL_DIR) "$(DESTDIR)$(docdir)"
292 $(INSTALL_DATA) qemu-doc.html qemu-tech.html "$(DESTDIR)$(docdir)"
293 ifdef CONFIG_POSIX
294 $(INSTALL_DIR) "$(DESTDIR)$(mandir)/man1"
295 $(INSTALL_DATA) qemu.1 qemu-img.1 "$(DESTDIR)$(mandir)/man1"
296 $(INSTALL_DIR) "$(DESTDIR)$(mandir)/man8"
297 $(INSTALL_DATA) qemu-nbd.8 "$(DESTDIR)$(mandir)/man8"
298 endif
300 install: all $(if $(BUILD_DOCS),install-doc)
301 $(INSTALL_DIR) "$(DESTDIR)$(bindir)"
302 ifneq ($(TOOLS),)
303 $(INSTALL_PROG) $(STRIP_OPT) $(TOOLS) "$(DESTDIR)$(bindir)"
304 endif
305 ifneq ($(BLOBS),)
306 $(INSTALL_DIR) "$(DESTDIR)$(datadir)"
307 set -e; for x in $(BLOBS); do \
308 $(INSTALL_DATA) $(SRC_PATH)/pc-bios/$$x "$(DESTDIR)$(datadir)"; \
309 done
310 endif
311 $(INSTALL_DIR) "$(DESTDIR)$(datadir)/keymaps"
312 set -e; for x in $(KEYMAPS); do \
313 $(INSTALL_DATA) $(SRC_PATH)/pc-bios/keymaps/$$x "$(DESTDIR)$(datadir)/keymaps"; \
314 done
315 for d in $(TARGET_DIRS); do \
316 $(MAKE) -C $$d $@ || exit 1 ; \
317 done
319 # various test targets
320 test speed: all
321 $(MAKE) -C tests $@
323 .PHONY: TAGS
324 TAGS:
325 find "$(SRC_PATH)" -name '*.[hc]' -print0 | xargs -0 etags
327 cscope:
328 rm -f ./cscope.*
329 find . -name "*.[ch]" -print | sed 's,^\./,,' > ./cscope.files
330 cscope -b
332 # documentation
333 %.html: %.texi
334 $(call quiet-command,texi2html -I=. -monolithic -number $<," GEN $@")
336 %.info: %.texi
337 $(call quiet-command,makeinfo -I . $< -o $@," GEN $@")
339 %.dvi: %.texi
340 $(call quiet-command,texi2dvi -I . $<," GEN $@")
342 qemu-options.texi: $(SRC_PATH)/qemu-options.hx
343 $(call quiet-command,sh $(SRC_PATH)/hxtool -t < $< > $@," GEN $@")
345 qemu-monitor.texi: $(SRC_PATH)/qemu-monitor.hx
346 $(call quiet-command,sh $(SRC_PATH)/hxtool -t < $< > $@," GEN $@")
348 qemu-img-cmds.texi: $(SRC_PATH)/qemu-img-cmds.hx
349 $(call quiet-command,sh $(SRC_PATH)/hxtool -t < $< > $@," GEN $@")
351 qemu.1: qemu-doc.texi qemu-options.texi qemu-monitor.texi
352 $(call quiet-command, \
353 perl -Ww -- $(SRC_PATH)/texi2pod.pl $< qemu.pod && \
354 pod2man --section=1 --center=" " --release=" " qemu.pod > $@, \
355 " GEN $@")
357 qemu-img.1: qemu-img.texi qemu-img-cmds.texi
358 $(call quiet-command, \
359 perl -Ww -- $(SRC_PATH)/texi2pod.pl $< qemu-img.pod && \
360 pod2man --section=1 --center=" " --release=" " qemu-img.pod > $@, \
361 " GEN $@")
363 qemu-nbd.8: qemu-nbd.texi
364 $(call quiet-command, \
365 perl -Ww -- $(SRC_PATH)/texi2pod.pl $< qemu-nbd.pod && \
366 pod2man --section=8 --center=" " --release=" " qemu-nbd.pod > $@, \
367 " GEN $@")
369 info: qemu-doc.info qemu-tech.info
371 dvi: qemu-doc.dvi qemu-tech.dvi
373 html: qemu-doc.html qemu-tech.html
375 qemu-doc.dvi qemu-doc.html qemu-doc.info: qemu-img.texi qemu-nbd.texi qemu-options.texi qemu-monitor.texi qemu-img-cmds.texi
377 VERSION ?= $(shell cat VERSION)
378 FILE = qemu-$(VERSION)
380 # tar release (use 'make -k tar' on a checkouted tree)
381 tar:
382 rm -rf /tmp/$(FILE)
383 cp -r . /tmp/$(FILE)
384 cd /tmp && tar zcvf ~/$(FILE).tar.gz $(FILE) --exclude CVS --exclude .git --exclude .svn
385 rm -rf /tmp/$(FILE)
387 # generate a binary distribution
388 tarbin:
389 cd / && tar zcvf ~/qemu-$(VERSION)-$(ARCH).tar.gz \
390 $(bindir)/qemu \
391 $(bindir)/qemu-system-x86_64 \
392 $(bindir)/qemu-system-arm \
393 $(bindir)/qemu-system-cris \
394 $(bindir)/qemu-system-m68k \
395 $(bindir)/qemu-system-microblaze \
396 $(bindir)/qemu-system-mips \
397 $(bindir)/qemu-system-mipsel \
398 $(bindir)/qemu-system-mips64 \
399 $(bindir)/qemu-system-mips64el \
400 $(bindir)/qemu-system-ppc \
401 $(bindir)/qemu-system-ppcemb \
402 $(bindir)/qemu-system-ppc64 \
403 $(bindir)/qemu-system-sh4 \
404 $(bindir)/qemu-system-sh4eb \
405 $(bindir)/qemu-system-sparc \
406 $(bindir)/qemu-i386 \
407 $(bindir)/qemu-x86_64 \
408 $(bindir)/qemu-alpha \
409 $(bindir)/qemu-arm \
410 $(bindir)/qemu-armeb \
411 $(bindir)/qemu-cris \
412 $(bindir)/qemu-m68k \
413 $(bindir)/qemu-microblaze \
414 $(bindir)/qemu-mips \
415 $(bindir)/qemu-mipsel \
416 $(bindir)/qemu-ppc \
417 $(bindir)/qemu-ppc64 \
418 $(bindir)/qemu-ppc64abi32 \
419 $(bindir)/qemu-sh4 \
420 $(bindir)/qemu-sh4eb \
421 $(bindir)/qemu-sparc \
422 $(bindir)/qemu-sparc64 \
423 $(bindir)/qemu-sparc32plus \
424 $(bindir)/qemu-img \
425 $(bindir)/qemu-nbd \
426 $(datadir)/bios.bin \
427 $(datadir)/vgabios.bin \
428 $(datadir)/vgabios-cirrus.bin \
429 $(datadir)/ppc_rom.bin \
430 $(datadir)/video.x \
431 $(datadir)/openbios-sparc32 \
432 $(datadir)/openbios-sparc64 \
433 $(datadir)/openbios-ppc \
434 $(datadir)/pxe-ne2k_pci.bin \
435 $(datadir)/pxe-rtl8139.bin \
436 $(datadir)/pxe-pcnet.bin \
437 $(datadir)/pxe-e1000.bin \
438 $(docdir)/qemu-doc.html \
439 $(docdir)/qemu-tech.html \
440 $(mandir)/man1/qemu.1 \
441 $(mandir)/man1/qemu-img.1 \
442 $(mandir)/man8/qemu-nbd.8
444 # Include automatically generated dependency files
445 -include $(wildcard *.d audio/*.d slirp/*.d block/*.d net/*.d)