Fix some spelling bugs in documentation and comments
[qemu/ar7.git] / Makefile
blob168093c6cf20ca51abd3c71507928b5d7dbc7400
1 # Makefile for QEMU.
3 # Always point to the root of the build tree (needs GNU make).
4 BUILD_DIR=$(CURDIR)
6 GENERATED_HEADERS = config-host.h trace.h qemu-options.def
7 ifeq ($(TRACE_BACKEND),dtrace)
8 GENERATED_HEADERS += trace-dtrace.h
9 endif
10 GENERATED_HEADERS += qmp-commands.h qapi-types.h qapi-visit.h
12 ifneq ($(wildcard config-host.mak),)
13 # Put the all: rule here so that config-host.mak can contain dependencies.
14 all: build-all
15 include config-host.mak
16 include $(SRC_PATH)/rules.mak
17 config-host.mak: $(SRC_PATH)/configure
18 @echo $@ is out-of-date, running configure
19 @sed -n "/.*Configured with/s/[^:]*: //p" $@ | sh
20 else
21 config-host.mak:
22 @echo "Please call configure before running make!"
23 @exit 1
24 endif
26 # Don't try to regenerate Makefile or configure
27 # We don't generate any of them
28 Makefile: ;
29 configure: ;
31 .PHONY: all clean cscope distclean dvi html info install install-doc \
32 pdf recurse-all speed tar tarbin test build-all
34 $(call set-vpath, $(SRC_PATH):$(SRC_PATH)/hw)
36 LIBS+=-lz $(LIBS_TOOLS)
38 ifdef BUILD_DOCS
39 DOCS=qemu-doc.html qemu-tech.html qemu.1 qemu-img.1 qemu-nbd.8 QMP/qmp-commands.txt
40 else
41 DOCS=
42 endif
44 SUBDIR_MAKEFLAGS=$(if $(V),,--no-print-directory) BUILD_DIR=$(BUILD_DIR)
45 SUBDIR_DEVICES_MAK=$(patsubst %, %/config-devices.mak, $(TARGET_DIRS))
46 SUBDIR_DEVICES_MAK_DEP=$(patsubst %, %/config-devices.mak.d, $(TARGET_DIRS))
48 config-all-devices.mak: $(SUBDIR_DEVICES_MAK)
49 $(call quiet-command,cat $(SUBDIR_DEVICES_MAK) | grep =y | sort -u > $@," GEN $@")
51 -include $(SUBDIR_DEVICES_MAK_DEP)
53 %/config-devices.mak: default-configs/%.mak
54 $(call quiet-command,$(SHELL) $(SRC_PATH)/scripts/make_device_config.sh $@ $<, " GEN $@")
55 @if test -f $@; then \
56 if cmp -s $@.old $@; then \
57 mv $@.tmp $@; \
58 cp -p $@ $@.old; \
59 else \
60 if test -f $@.old; then \
61 echo "WARNING: $@ (user modified) out of date.";\
62 else \
63 echo "WARNING: $@ out of date.";\
64 fi; \
65 echo "Run \"make defconfig\" to regenerate."; \
66 rm $@.tmp; \
67 fi; \
68 else \
69 mv $@.tmp $@; \
70 cp -p $@ $@.old; \
73 defconfig:
74 rm -f config-all-devices.mak $(SUBDIR_DEVICES_MAK)
76 -include config-all-devices.mak
78 build-all: $(DOCS) $(TOOLS) $(CHECKS) recurse-all
80 config-host.h: config-host.h-timestamp
81 config-host.h-timestamp: config-host.mak
82 qemu-options.def: $(SRC_PATH)/qemu-options.hx
83 $(call quiet-command,sh $(SRC_PATH)/scripts/hxtool -h < $< > $@," GEN $@")
85 SUBDIR_RULES=$(patsubst %,subdir-%, $(TARGET_DIRS))
87 subdir-%: $(GENERATED_HEADERS)
88 $(call quiet-command,$(MAKE) $(SUBDIR_MAKEFLAGS) -C $* V="$(V)" TARGET_DIR="$*/" all,)
90 ifneq ($(wildcard config-host.mak),)
91 include $(SRC_PATH)/Makefile.objs
92 endif
94 $(common-obj-y): $(GENERATED_HEADERS)
95 subdir-libcacard: $(oslib-obj-y) $(trace-obj-y) qemu-timer-common.o
97 $(filter %-softmmu,$(SUBDIR_RULES)): $(trace-obj-y) $(common-obj-y) subdir-libdis
99 $(filter %-user,$(SUBDIR_RULES)): $(GENERATED_HEADERS) $(trace-obj-y) subdir-libdis-user subdir-libuser
101 ROMSUBDIR_RULES=$(patsubst %,romsubdir-%, $(ROMS))
102 romsubdir-%:
103 $(call quiet-command,$(MAKE) $(SUBDIR_MAKEFLAGS) -C pc-bios/$* V="$(V)" TARGET_DIR="$*/",)
105 ALL_SUBDIRS=$(TARGET_DIRS) $(patsubst %,pc-bios/%, $(ROMS))
107 recurse-all: $(SUBDIR_RULES) $(ROMSUBDIR_RULES)
109 audio/audio.o audio/fmodaudio.o: QEMU_CFLAGS += $(FMOD_CFLAGS)
111 QEMU_CFLAGS+=$(CURL_CFLAGS)
113 QEMU_CFLAGS+=$(GLIB_CFLAGS)
115 ui/cocoa.o: ui/cocoa.m
117 ui/sdl.o audio/sdlaudio.o ui/sdl_zoom.o baum.o: QEMU_CFLAGS += $(SDL_CFLAGS)
119 ui/vnc.o: QEMU_CFLAGS += $(VNC_TLS_CFLAGS)
121 bt-host.o: QEMU_CFLAGS += $(BLUEZ_CFLAGS)
123 version.o: $(SRC_PATH)/version.rc config-host.h
124 $(call quiet-command,$(WINDRES) -I. -o $@ $<," RC $(TARGET_DIR)$@")
126 version-obj-$(CONFIG_WIN32) += version.o
127 ######################################################################
128 # Support building shared library libcacard
130 .PHONY: libcacard.la install-libcacard
131 ifeq ($(LIBTOOL),)
132 libcacard.la:
133 @echo "libtool is missing, please install and rerun configure"; exit 1
135 install-libcacard:
136 @echo "libtool is missing, please install and rerun configure"; exit 1
137 else
138 libcacard.la: $(GENERATED_HEADERS) $(oslib-obj-y) qemu-timer-common.o $(addsuffix .lo, $(basename $(trace-obj-y)))
139 $(call quiet-command,$(MAKE) $(SUBDIR_MAKEFLAGS) -C libcacard V="$(V)" TARGET_DIR="$*/" libcacard.la,)
141 install-libcacard: libcacard.la
142 $(call quiet-command,$(MAKE) $(SUBDIR_MAKEFLAGS) -C libcacard V="$(V)" TARGET_DIR="$*/" install-libcacard,)
143 endif
144 ######################################################################
146 qemu-img.o: qemu-img-cmds.h
147 qemu-img.o qemu-tool.o qemu-nbd.o qemu-io.o cmd.o qemu-ga.o: $(GENERATED_HEADERS)
149 tools-obj-y = qemu-tool.o $(oslib-obj-y) $(trace-obj-y) \
150 qemu-timer-common.o cutils.o
152 qemu-img$(EXESUF): qemu-img.o $(tools-obj-y) $(block-obj-y)
153 qemu-nbd$(EXESUF): qemu-nbd.o $(tools-obj-y) $(block-obj-y)
154 qemu-io$(EXESUF): qemu-io.o cmd.o $(tools-obj-y) $(block-obj-y)
156 qemu-img-cmds.h: $(SRC_PATH)/qemu-img-cmds.hx
157 $(call quiet-command,sh $(SRC_PATH)/scripts/hxtool -h < $< > $@," GEN $@")
159 check-qint.o check-qstring.o check-qdict.o check-qlist.o check-qfloat.o check-qjson.o test-coroutine.o: $(GENERATED_HEADERS)
161 check-qint: check-qint.o qint.o $(tools-obj-y)
162 check-qstring: check-qstring.o qstring.o $(tools-obj-y)
163 check-qdict: check-qdict.o qdict.o qfloat.o qint.o qstring.o qbool.o qlist.o $(tools-obj-y)
164 check-qlist: check-qlist.o qlist.o qint.o $(tools-obj-y)
165 check-qfloat: check-qfloat.o qfloat.o $(tools-obj-y)
166 check-qjson: check-qjson.o $(qobject-obj-y) $(tools-obj-y)
167 test-coroutine: test-coroutine.o qemu-timer-common.o async.o $(coroutine-obj-y) $(tools-obj-y)
169 $(qapi-obj-y): $(GENERATED_HEADERS)
170 qapi-dir := qapi-generated
171 test-visitor.o test-qmp-commands.o qemu-ga$(EXESUF): QEMU_CFLAGS += -I $(qapi-dir)
172 qemu-ga$(EXESUF): LIBS = $(LIBS_QGA)
174 $(qapi-dir)/test-qapi-types.c: $(qapi-dir)/test-qapi-types.h
175 $(qapi-dir)/test-qapi-types.h: $(SRC_PATH)/qapi-schema-test.json $(SRC_PATH)/scripts/qapi-types.py
176 $(call quiet-command,$(PYTHON) $(SRC_PATH)/scripts/qapi-types.py -o "$(qapi-dir)" -p "test-" < $<, " GEN $@")
177 $(qapi-dir)/test-qapi-visit.c: $(qapi-dir)/test-qapi-visit.h
178 $(qapi-dir)/test-qapi-visit.h: $(SRC_PATH)/qapi-schema-test.json $(SRC_PATH)/scripts/qapi-visit.py
179 $(call quiet-command,$(PYTHON) $(SRC_PATH)/scripts/qapi-visit.py -o "$(qapi-dir)" -p "test-" < $<, " GEN $@")
180 $(qapi-dir)/test-qmp-commands.h: $(qapi-dir)/test-qmp-marshal.c
181 $(qapi-dir)/test-qmp-marshal.c: $(SRC_PATH)/qapi-schema-test.json $(SRC_PATH)/scripts/qapi-commands.py
182 $(call quiet-command,$(PYTHON) $(SRC_PATH)/scripts/qapi-commands.py -o "$(qapi-dir)" -p "test-" < $<, " GEN $@")
184 $(qapi-dir)/qga-qapi-types.c: $(qapi-dir)/qga-qapi-types.h
185 $(qapi-dir)/qga-qapi-types.h: $(SRC_PATH)/qapi-schema-guest.json $(SRC_PATH)/scripts/qapi-types.py
186 $(call quiet-command,$(PYTHON) $(SRC_PATH)/scripts/qapi-types.py -o "$(qapi-dir)" -p "qga-" < $<, " GEN $@")
187 $(qapi-dir)/qga-qapi-visit.c: $(qapi-dir)/qga-qapi-visit.h
188 $(qapi-dir)/qga-qapi-visit.h: $(SRC_PATH)/qapi-schema-guest.json $(SRC_PATH)/scripts/qapi-visit.py
189 $(call quiet-command,$(PYTHON) $(SRC_PATH)/scripts/qapi-visit.py -o "$(qapi-dir)" -p "qga-" < $<, " GEN $@")
190 $(qapi-dir)/qga-qmp-commands.h: $(qapi-dir)/qga-qmp-marshal.c
191 $(qapi-dir)/qga-qmp-marshal.c: $(SRC_PATH)/qapi-schema-guest.json $(SRC_PATH)/scripts/qapi-commands.py
192 $(call quiet-command,$(PYTHON) $(SRC_PATH)/scripts/qapi-commands.py -o "$(qapi-dir)" -p "qga-" < $<, " GEN $@")
194 qapi-types.c: qapi-types.h
195 qapi-types.h: $(SRC_PATH)/qapi-schema.json $(SRC_PATH)/scripts/qapi-types.py
196 $(call quiet-command,$(PYTHON) $(SRC_PATH)/scripts/qapi-types.py -o "." < $<, " GEN $@")
197 qapi-visit.c: qapi-visit.h
198 qapi-visit.h: $(SRC_PATH)/qapi-schema.json $(SRC_PATH)/scripts/qapi-visit.py
199 $(call quiet-command,$(PYTHON) $(SRC_PATH)/scripts/qapi-visit.py -o "." < $<, " GEN $@")
200 qmp-commands.h: qmp-marshal.c
201 qmp-marshal.c: $(SRC_PATH)/qapi-schema.json $(SRC_PATH)/scripts/qapi-commands.py
202 $(call quiet-command,$(PYTHON) $(SRC_PATH)/scripts/qapi-commands.py -m -o "." < $<, " GEN $@")
204 test-visitor.o: $(addprefix $(qapi-dir)/, test-qapi-types.c test-qapi-types.h test-qapi-visit.c test-qapi-visit.h) $(qapi-obj-y)
205 test-visitor: test-visitor.o $(qobject-obj-y) $(qapi-obj-y) $(tools-obj-y) $(qapi-dir)/test-qapi-visit.o $(qapi-dir)/test-qapi-types.o
207 test-qmp-commands.o: $(addprefix $(qapi-dir)/, test-qapi-types.c test-qapi-types.h test-qapi-visit.c test-qapi-visit.h test-qmp-marshal.c test-qmp-commands.h) $(qapi-obj-y)
208 test-qmp-commands: test-qmp-commands.o $(qobject-obj-y) $(qapi-obj-y) $(tools-obj-y) $(qapi-dir)/test-qapi-visit.o $(qapi-dir)/test-qapi-types.o $(qapi-dir)/test-qmp-marshal.o module.o
210 QGALIB_GEN=$(addprefix $(qapi-dir)/, qga-qapi-types.c qga-qapi-types.h qga-qapi-visit.c qga-qmp-marshal.c)
211 $(QGALIB_GEN): $(GENERATED_HEADERS)
212 $(qga-obj-y) qemu-ga.o: $(QGALIB_GEN)
214 qemu-ga$(EXESUF): qemu-ga.o $(qga-obj-y) $(qapi-obj-y) $(tools-obj-y) $(qobject-obj-y) $(version-obj-y) $(addprefix $(qapi-dir)/, qga-qapi-visit.o qga-qapi-types.o qga-qmp-marshal.o)
216 QEMULIBS=libhw32 libhw64 libuser libdis libdis-user
218 clean:
219 # avoid old build problems by removing potentially incorrect old files
220 rm -f config.mak op-i386.h opc-i386.h gen-op-i386.h op-arm.h opc-arm.h gen-op-arm.h
221 rm -f qemu-options.def
222 rm -f *.o *.d *.a *.lo $(TOOLS) $(CHECKS) qemu-ga TAGS cscope.* *.pod *~ */*~
223 rm -Rf .libs
224 rm -f slirp/*.o slirp/*.d audio/*.o audio/*.d block/*.o block/*.d net/*.o net/*.d fsdev/*.o fsdev/*.d ui/*.o ui/*.d qapi/*.o qapi/*.d qga/*.o qga/*.d
225 rm -f qemu-img-cmds.h
226 rm -f trace/*.o trace/*.d
227 rm -f trace.c trace.h trace.c-timestamp trace.h-timestamp
228 rm -f trace-dtrace.dtrace trace-dtrace.dtrace-timestamp
229 rm -f trace-dtrace.h trace-dtrace.h-timestamp
230 rm -rf $(qapi-dir)
231 $(MAKE) -C tests clean
232 for d in $(ALL_SUBDIRS) $(QEMULIBS) libcacard; do \
233 if test -d $$d; then $(MAKE) -C $$d $@ || exit 1; fi; \
234 rm -f $$d/qemu-options.def; \
235 done
237 distclean: clean
238 rm -f config-host.mak config-host.h* config-host.ld $(DOCS) qemu-options.texi qemu-img-cmds.texi qemu-monitor.texi
239 rm -f config-all-devices.mak
240 rm -f roms/seabios/config.mak roms/vgabios/config.mak
241 rm -f qemu-doc.info qemu-doc.aux qemu-doc.cp qemu-doc.cps qemu-doc.dvi
242 rm -f qemu-doc.fn qemu-doc.fns qemu-doc.info qemu-doc.ky qemu-doc.kys
243 rm -f qemu-doc.log qemu-doc.pdf qemu-doc.pg qemu-doc.toc qemu-doc.tp
244 rm -f qemu-doc.vr
245 rm -f config.log
246 rm -f qemu-tech.info qemu-tech.aux qemu-tech.cp qemu-tech.dvi qemu-tech.fn qemu-tech.info qemu-tech.ky qemu-tech.log qemu-tech.pdf qemu-tech.pg qemu-tech.toc qemu-tech.tp qemu-tech.vr
247 for d in $(TARGET_DIRS) $(QEMULIBS); do \
248 rm -rf $$d || exit 1 ; \
249 done
251 KEYMAPS=da en-gb et fr fr-ch is lt modifiers no pt-br sv \
252 ar de en-us fi fr-be hr it lv nl pl ru th \
253 common de-ch es fo fr-ca hu ja mk nl-be pt sl tr
255 ifdef INSTALL_BLOBS
256 BLOBS=bios.bin sgabios.bin vgabios.bin vgabios-cirrus.bin \
257 vgabios-stdvga.bin vgabios-vmware.bin vgabios-qxl.bin \
258 ppc_rom.bin openbios-sparc32 openbios-sparc64 openbios-ppc \
259 pxe-e1000.rom pxe-eepro100.rom pxe-ne2k_pci.rom \
260 pxe-pcnet.rom pxe-rtl8139.rom pxe-virtio.rom \
261 bamboo.dtb petalogix-s3adsp1800.dtb petalogix-ml605.dtb \
262 mpc8544ds.dtb \
263 multiboot.bin linuxboot.bin \
264 s390-zipl.rom \
265 spapr-rtas.bin slof.bin \
266 palcode-clipper
267 else
268 BLOBS=
269 endif
271 install-doc: $(DOCS)
272 $(INSTALL_DIR) "$(DESTDIR)$(docdir)"
273 $(INSTALL_DATA) qemu-doc.html qemu-tech.html "$(DESTDIR)$(docdir)"
274 ifdef CONFIG_POSIX
275 $(INSTALL_DIR) "$(DESTDIR)$(mandir)/man1"
276 $(INSTALL_DATA) qemu.1 qemu-img.1 "$(DESTDIR)$(mandir)/man1"
277 $(INSTALL_DIR) "$(DESTDIR)$(mandir)/man8"
278 $(INSTALL_DATA) qemu-nbd.8 "$(DESTDIR)$(mandir)/man8"
279 endif
281 install-sysconfig:
282 $(INSTALL_DIR) "$(DESTDIR)$(sysconfdir)/qemu"
283 $(INSTALL_DATA) $(SRC_PATH)/sysconfigs/target/target-x86_64.conf "$(DESTDIR)$(sysconfdir)/qemu"
285 install: all $(if $(BUILD_DOCS),install-doc) install-sysconfig
286 $(INSTALL_DIR) "$(DESTDIR)$(bindir)"
287 ifneq ($(TOOLS),)
288 $(INSTALL_PROG) $(STRIP_OPT) $(TOOLS) "$(DESTDIR)$(bindir)"
289 endif
290 ifneq ($(BLOBS),)
291 $(INSTALL_DIR) "$(DESTDIR)$(datadir)"
292 set -e; for x in $(BLOBS); do \
293 $(INSTALL_DATA) $(SRC_PATH)/pc-bios/$$x "$(DESTDIR)$(datadir)"; \
294 done
295 endif
296 $(INSTALL_DIR) "$(DESTDIR)$(datadir)/keymaps"
297 set -e; for x in $(KEYMAPS); do \
298 $(INSTALL_DATA) $(SRC_PATH)/pc-bios/keymaps/$$x "$(DESTDIR)$(datadir)/keymaps"; \
299 done
300 for d in $(TARGET_DIRS); do \
301 $(MAKE) -C $$d $@ || exit 1 ; \
302 done
304 # various test targets
305 test speed: all
306 $(MAKE) -C tests $@
308 .PHONY: check
309 check: $(patsubst %,run-check-%,$(CHECKS))
311 run-check-%: %
312 ./$<
314 .PHONY: TAGS
315 TAGS:
316 find "$(SRC_PATH)" -name '*.[hc]' -print0 | xargs -0 etags
318 cscope:
319 rm -f ./cscope.*
320 find "$(SRC_PATH)" -name "*.[chsS]" -print | sed 's,^\./,,' > ./cscope.files
321 cscope -b
323 # documentation
324 MAKEINFO=makeinfo
325 MAKEINFOFLAGS=--no-headers --no-split --number-sections
326 TEXIFLAG=$(if $(V),,--quiet)
327 %.dvi: %.texi
328 $(call quiet-command,texi2dvi $(TEXIFLAG) -I . $<," GEN $@")
330 %.html: %.texi
331 $(call quiet-command,$(MAKEINFO) $(MAKEINFOFLAGS) --html $< -o $@, \
332 " GEN $@")
334 %.info: %.texi
335 $(call quiet-command,$(MAKEINFO) $< -o $@," GEN $@")
337 %.pdf: %.texi
338 $(call quiet-command,texi2pdf $(TEXIFLAG) -I . $<," GEN $@")
340 qemu-options.texi: $(SRC_PATH)/qemu-options.hx
341 $(call quiet-command,sh $(SRC_PATH)/scripts/hxtool -t < $< > $@," GEN $@")
343 qemu-monitor.texi: $(SRC_PATH)/hmp-commands.hx
344 $(call quiet-command,sh $(SRC_PATH)/scripts/hxtool -t < $< > $@," GEN $@")
346 QMP/qmp-commands.txt: $(SRC_PATH)/qmp-commands.hx
347 $(call quiet-command,sh $(SRC_PATH)/scripts/hxtool -q < $< > $@," GEN $@")
349 qemu-img-cmds.texi: $(SRC_PATH)/qemu-img-cmds.hx
350 $(call quiet-command,sh $(SRC_PATH)/scripts/hxtool -t < $< > $@," GEN $@")
352 qemu.1: qemu-doc.texi qemu-options.texi qemu-monitor.texi
353 $(call quiet-command, \
354 perl -Ww -- $(SRC_PATH)/scripts/texi2pod.pl $< qemu.pod && \
355 pod2man --section=1 --center=" " --release=" " qemu.pod > $@, \
356 " GEN $@")
358 qemu-img.1: qemu-img.texi qemu-img-cmds.texi
359 $(call quiet-command, \
360 perl -Ww -- $(SRC_PATH)/scripts/texi2pod.pl $< qemu-img.pod && \
361 pod2man --section=1 --center=" " --release=" " qemu-img.pod > $@, \
362 " GEN $@")
364 qemu-nbd.8: qemu-nbd.texi
365 $(call quiet-command, \
366 perl -Ww -- $(SRC_PATH)/scripts/texi2pod.pl $< qemu-nbd.pod && \
367 pod2man --section=8 --center=" " --release=" " qemu-nbd.pod > $@, \
368 " GEN $@")
370 dvi: qemu-doc.dvi qemu-tech.dvi
371 html: qemu-doc.html qemu-tech.html
372 info: qemu-doc.info qemu-tech.info
373 pdf: qemu-doc.pdf qemu-tech.pdf
375 qemu-doc.dvi qemu-doc.html qemu-doc.info qemu-doc.pdf: \
376 qemu-img.texi qemu-nbd.texi qemu-options.texi \
377 qemu-monitor.texi qemu-img-cmds.texi
379 VERSION ?= $(shell cat VERSION)
380 FILE = qemu-$(VERSION)
382 # tar release (use 'make -k tar' on a checkouted tree)
383 tar:
384 rm -rf /tmp/$(FILE)
385 cp -r . /tmp/$(FILE)
386 cd /tmp && tar zcvf ~/$(FILE).tar.gz $(FILE) --exclude CVS --exclude .git --exclude .svn
387 rm -rf /tmp/$(FILE)
389 # Include automatically generated dependency files
390 -include $(wildcard *.d audio/*.d slirp/*.d block/*.d net/*.d ui/*.d qapi/*.d qga/*.d)