Make signal handler functions vcore-ctx-safe
[akaros.git] / Makefile
1 # Top-level Makefile for Akaros
2 # Barret Rhoden
3 #
4 #
5 # Notes:
6 #       - I downloaded the kbuild guts from git://github.com/lacombar/kconfig.git,
7 #       and added things from a recent linux makefile.  It is from aug 2011, so
8 #       some things might not match up.
9 #       - Kernel output in obj/: So Linux has the ability to output into another
10 #       directory, via the KBUILD_OUTPUT variable.  This induces a recursive make
11 #       in the output directory.  I mucked with it for a little, but didn't get it
12 #       to work quite right.  Also, there will be other Akaros issues since this
13 #       makefile is also used for userspace and tests.  For now, I'm leaving things
14 #       the default Linux way.
15 #       - Kconfig wants to use include/ in the root directory.  We can change some
16 #       of the default settings that silentoldconfig uses, but I'll leave it as-is
17 #       for now, and just symlink that into kern/include.  It'll be easier for us,
18 #       and also potentially easier if we ever move kern/ up a level.  Similarly,
19 #       there are default Kconfigs in arch/, not in kern/arch.  I just symlinked
20 #       arch->kern/arch to keep everything simple.
21 #
22 # TODO:
23 #       - Consider merging the two target-detection bits (Linux's config, mixed, or
24 #       dot target, and the symlink handling).  Also, could consider moving around
25 #       the KFS and EXT2 targets.  Clean doesn't need to know about them, for
26 #       instance.
27 #
28 #       - Review, with an eye for being better about $(srctree).  It might only be
29 #       necessary in this file, if we every do the KBUILD_OUTPUT option.  But we
30 #       don't always want it (like for the implicit rule for Makefile)
31 #
32 #       - It's a bit crazy that we build symlinks for parlib, instead of it
33 #       managing its own links based on $(ARCH)
34 #
35 #       - Consider using Kbuild to build userspace and tests
36 #
37 #       - There are a few other TODOs sprinkled throughout the makefile.
38
39 # Allow people to override our setting of the --no-print-directory option in
40 # their Makelocal. This is useful, for example, to allow emacs to find the
41 # correct file when errors are encountered using its builtin 'M-x compile'
42 # command.
43 VERSION = 0
44 PATCHLEVEL = 1
45 SUBLEVEL = 0
46 EXTRAVERSION =
47 VERNAME = Nanwan
48
49 KERNELVERSION = $(VERSION)$(if $(PATCHLEVEL),.$(PATCHLEVEL)$(if $(SUBLEVEL),.$(SUBLEVEL)))$(EXTRAVERSION)
50
51 export KERNELVERSION VERNAME
52
53 NO_PRINT_DIRECTORY ?= --no-print-directory
54
55 # Save the ability to export the parent's original environment for future use
56 export_parent_env := $(shell export | sed 's/$$/;/')
57
58 # Save the ability to clear the current environment for future use
59 clear_current_env := for c in $$(env | cut -d '=' -f 1); do unset $$c; done;
60
61 define export_user_variables
62         CROSS_COMPILE="$(CROSS_COMPILE)"\
63         CROSS_INCLUDE="$(XCC_TARGET_INCLUDE)"\
64         ROS_CFLAGS="$(CFLAGS_USER)"\
65         ROS_LDFLAGS="$(LDFLAGS_USER)"
66 endef
67
68 # Define a set of commands to reset the environment to the parent's environment
69 # and then run a local make target
70 define make_as_parent
71         $(clear_current_env)\
72         $(export_parent_env)\
73         $(call export_user_variables)\
74         $(MAKE) $(NO_PRINT_DIRECTORY) $(1)
75 endef
76
77 # Do not:
78 # o  use make's built-in rules and variables
79 #    (this increases performance and avoids hard-to-debug behaviour);
80 # o  print "Entering directory ...";
81 MAKEFLAGS += -rR $(NO_PRINT_DIRECTORY)
82
83 # That's our default target when none is given on the command line
84 # This can be overriden with a Makelocal
85 PHONY := all
86 all: akaros-kernel
87
88 # Export the location of this top level directory
89 AKAROS_ROOT = $(CURDIR)
90 export AKAROS_ROOT
91
92 # Setup dumping ground for object files and any temporary files we need to
93 # generate for non-kbuild targets
94 OBJDIR ?= obj
95
96 # Don't need to export these, since the Makelocal is included.
97 KERNEL_OBJ := $(OBJDIR)/kern/akaros-kernel
98 CMP_KERNEL_OBJ := $(KERNEL_OBJ).gz
99
100 # Symlinks
101 # =========================================================================
102 # We have a few symlinks so that code can include <arch/whatever.h>.  This
103 # section builds and maintains those, as best we can.
104 #
105 # When invoking make, we can pass in ARCH=some-arch.  This value gets 'saved'
106 # in the symlink, so that later invocations do not need ARCH=.  If this value
107 # differs from the symlink, it appears like we are changing arches, which
108 # triggers a clean and symlink reconstruction.
109 #
110 # When the user changes from one arch to another, they ought to reconfig, since
111 # many of the CONFIG_ vars will depend on the arch.  If they try anything other
112 # than one of the "non-build-goals" (cleans or configs), we'll abort.
113 #
114 # Make targets that need these symlinks (like building userspace, the kernel,
115 # configs, etc, should depend on symlinks.
116
117 clean-goals := clean mrproper realclean userclean testclean doxyclean objclean
118 non-build-goals := %config $(clean-goals)
119 ifeq ($(filter $(non-build-goals), $(MAKECMDGOALS)),)
120 goals-has-build-targets := 1
121 endif
122
123 PHONY += symlinks clean_symlinks
124 clean_symlinks: objclean
125         @rm -f kern/include/arch kern/boot user/parlib/include/parlib/arch
126
127 arch-link := $(notdir $(shell readlink kern/include/arch))
128 valid-arches := $(notdir $(wildcard kern/arch/*))
129
130 ifneq ($(ARCH),)
131     ifeq ($(filter $(valid-arches), $(ARCH)),)
132         $(error ARCH $(ARCH) invalid, must be one of: $(valid-arches))
133     endif
134     ifneq ($(ARCH),$(arch-link))
135         ifeq ($(goals-has-build-targets),1)
136             $(error Attempted to make [$(MAKECMDGOALS)] while changing ARCH. \
137                     You need to make *config.)
138         endif
139 symlinks: clean_symlinks
140         @echo Making symlinks...
141         $(Q)ln -fs ../arch/$(ARCH) kern/include/arch
142         $(Q)ln -fs arch/$(ARCH)/boot kern/boot
143         $(Q)ln -fs $(ARCH) user/parlib/include/parlib/arch
144         $(Q)$(MAKE) -f $(srctree)/Makefile clean
145
146     else
147 symlinks:
148
149     endif # ifneq ($(ARCH),$(arch-link))
150 else # $(ARCH) is empty
151     ifneq ($(arch-link),)
152         ARCH := $(arch-link)
153 symlinks:
154
155     else
156         # Only allow a clean
157         ifeq ($(filter $(clean-goals), $(MAKECMDGOALS)),)
158             $(error No arch saved or specified.  Make *config with ARCH=arch. \
159                     'arch' must be one of: $(valid-arches))
160         endif
161         ARCH := none # catch bugs
162     endif # ifneq ($(arch-link),)
163 endif # ifeq ($(ARCH),)
164
165 SRCARCH := $(ARCH)
166 export ARCH SRCARCH
167
168 # Generic Kbuild Environment
169 # =========================================================================
170
171 # To put more focus on warnings, be less verbose as default
172 # Use 'make V=1' to see the full commands
173
174 ifeq ("$(origin V)", "command line")
175   KBUILD_VERBOSE = $(V)
176 endif
177 ifndef KBUILD_VERBOSE
178   KBUILD_VERBOSE = 0
179 endif
180
181 srctree         := $(if $(KBUILD_SRC),$(KBUILD_SRC),$(CURDIR))
182 objtree         := $(CURDIR)
183
184 export srctree objtree
185
186 CONFIG_SHELL := $(shell if [ -x "$$BASH" ]; then echo $$BASH; \
187           else if [ -x /bin/bash ]; then echo /bin/bash; \
188           else echo sh; fi ; fi)
189
190 HOSTCC       = gcc
191 HOSTCXX      = g++
192 HOSTCFLAGS   = -Wall -Wno-char-subscripts -Wmissing-prototypes \
193                -Wstrict-prototypes -O2 -fomit-frame-pointer
194 HOSTCXXFLAGS = -O2
195
196 export CONFIG_SHELL HOSTCC HOSTCXX HOSTCFLAGS HOSTCXXFLAGS
197
198 # Beautify output
199 # ---------------------------------------------------------------------------
200 #
201 # Normally, we echo the whole command before executing it. By making
202 # that echo $($(quiet)$(cmd)), we now have the possibility to set
203 # $(quiet) to choose other forms of output instead, e.g.
204 #
205 #         quiet_cmd_cc_o_c = Compiling $(RELDIR)/$@
206 #         cmd_cc_o_c       = $(CC) $(c_flags) -c -o $@ $<
207 #
208 # If $(quiet) is empty, the whole command will be printed.
209 # If it is set to "quiet_", only the short version will be printed. 
210 # If it is set to "silent_", nothing will be printed at all, since
211 # the variable $(silent_cmd_cc_o_c) doesn't exist.
212 #
213 # A simple variant is to prefix commands with $(Q) - that's useful
214 # for commands that shall be hidden in non-verbose mode.
215 #
216 #       $(Q)ln $@ :<
217 #
218 # If KBUILD_VERBOSE equals 0 then the above command will be hidden.
219 # If KBUILD_VERBOSE equals 1 then the above command is displayed.
220
221 ifeq ($(KBUILD_VERBOSE),1)
222   quiet =
223   Q =
224 else
225   quiet=quiet_
226   Q = @
227 endif
228 export quiet Q KBUILD_VERBOSE
229
230 # We need some generic definitions (do not try to remake the file).
231 $(srctree)/scripts/Kbuild.include: ;
232 include $(srctree)/scripts/Kbuild.include
233
234 # Kbuild Target/Goals Parsing
235 # =========================================================================
236 # Need to figure out if we're a config or not, and whether or not to include
237 # our .config / auto.conf.  Configs are basically their own makefile, (ifeq),
238 # and cleans are allowed to proceed without worrying about the dot-config.
239
240 # Basic helpers built in scripts/
241 PHONY += scripts_basic
242 scripts_basic:
243         $(Q)$(MAKE) $(build)=scripts/basic
244
245 PHONY += scripts
246
247 scripts: scripts_basic include/config/auto.conf include/config/tristate.conf
248         $(Q)$(MAKE) $(build)=$(@)
249
250 config-targets := 0
251 mixed-targets  := 0
252 dot-config     := 1
253
254 no-dot-config-targets := $(clean-goals)
255
256 ifneq ($(filter $(no-dot-config-targets), $(MAKECMDGOALS)),)
257     ifeq ($(filter-out $(no-dot-config-targets), $(MAKECMDGOALS)),)
258         dot-config := 0
259     endif
260 endif
261
262 ifneq ($(filter config %config,$(MAKECMDGOALS)),)
263     config-targets := 1
264     ifneq ($(filter-out config %config,$(MAKECMDGOALS)),)
265         mixed-targets := 1
266     endif
267 endif
268
269 ifeq ($(mixed-targets),1)
270 # ===========================================================================
271 # We're called with mixed targets (*config and build targets).
272 # Handle them one by one.
273
274 %:: FORCE
275         $(Q)$(MAKE) -C $(srctree) KBUILD_SRC= $@
276
277 else
278 ifeq ($(config-targets),1)
279 # ===========================================================================
280 # *config targets only - make sure prerequisites are updated, and descend
281 # in scripts/kconfig to make the *config target
282
283 # Default config file, per arch.  This path will resolve to
284 # arch/$ARCH/configs/defconfig (arch -> kern/arch).  Each arch can override
285 # this if they want, or just symlink to one in the main root directory.
286 KBUILD_DEFCONFIG := defconfig
287 export KBUILD_DEFCONFIG
288
289 config: scripts_basic symlinks FORCE
290         $(Q)mkdir -p include/config
291         $(Q)$(MAKE) $(build)=scripts/kconfig $@
292
293 %config: scripts_basic symlinks FORCE
294         $(Q)mkdir -p include/config
295         $(Q)$(MAKE) $(build)=scripts/kconfig $@
296
297 else
298 # ===========================================================================
299 # Build targets only - this includes vmlinux, arch specific targets, clean
300 # targets and others. In general all targets except *config targets.
301
302 ifeq ($(dot-config),1)
303 KCONFIG_CONFIG ?= .config
304 export KCONFIG_CONFIG
305
306 # Read in config
307 -include include/config/auto.conf
308
309 # Read in dependencies to all Kconfig* files, make sure to run
310 # oldconfig if changes are detected.
311 -include include/config/auto.conf.cmd
312
313 # To avoid any implicit rule to kick in, define an empty command
314 $(KCONFIG_CONFIG) include/config/auto.conf.cmd: ;
315
316 # If .config is newer than include/config/auto.conf, someone tinkered
317 # with it and forgot to run make oldconfig.
318 # if auto.conf.cmd is missing then we are probably in a cleaned tree so
319 # we execute the config step to be sure to catch updated Kconfig files
320 include/config/%.conf: $(KCONFIG_CONFIG) include/config/auto.conf.cmd
321         $(Q)$(MAKE) -f $(srctree)/Makefile silentoldconfig
322
323 else
324 # Dummy target needed, because used as prerequisite
325 include/config/auto.conf: ;
326 endif # $(dot-config)
327
328 # Akaros Build Environment
329 # =========================================================================
330 AKAROSINCLUDE   := -I$(srctree)/kern/include/
331
332 # CROSS_COMPILE is defined per-arch.  Each arch can set other makeflags, kbuild
333 # directories, etc. 
334 -include $(srctree)/kern/arch/$(ARCH)/Makefile
335
336 CC          := $(CROSS_COMPILE)gcc 
337 CPP         := $(CROSS_COMPILE)g++
338 AS          := $(CROSS_COMPILE)as
339 AR          := $(CROSS_COMPILE)ar
340 LD          := $(CROSS_COMPILE)ld
341 OBJCOPY := $(CROSS_COMPILE)objcopy
342 OBJDUMP := $(CROSS_COMPILE)objdump
343 NM          := $(CROSS_COMPILE)nm
344 STRIP   := $(CROSS_COMPILE)strip
345 KERNEL_LD ?= kernel.ld
346
347 # These may have bogus values if there is no compiler.  The kernel and user
348 # build targets will check cc-exists.  Hopefully no cleaning targets rely on
349 # these.  Note that if you change configs, these will get computed once, before
350 # silentoldconfig kicks in to regenerate auto.conf, and these values will
351 # temporarily be stale.
352 gcc-lib := $(shell $(CC) -print-libgcc-file-name 2>/dev/null)
353 NOSTDINC_FLAGS += -nostdinc -isystem \
354                   $(shell $(CC) -print-file-name=include 2>/dev/null)
355 XCC_TARGET_ROOT := $(shell $(CC) --print-sysroot 2> /dev/null)
356 XCC_TARGET_LIB := $(XCC_TARGET_ROOT)/usr/lib/
357 XCC_TARGET_INCLUDE := $(XCC_TARGET_ROOT)/usr/include/
358
359 CFLAGS_KERNEL += -O2 -pipe -MD
360 CFLAGS_KERNEL += -std=gnu99 -fgnu89-inline
361 CFLAGS_KERNEL += -fno-strict-aliasing -fno-omit-frame-pointer
362 CFLAGS_KERNEL += -fno-stack-protector
363 CFLAGS_KERNEL += -Wall -Wno-format -Wno-unused -Werror
364 CFLAGS_KERNEL += -DROS_KERNEL 
365 CFLAGS_KERNEL += -include include/generated/autoconf.h -include include/common.h
366 CFLAGS_KERNEL += -fplan9-extensions
367 ifeq ($(CONFIG_64BIT),y)
368 CFLAGS_KERNEL += -m64 -g
369 else
370 CFLAGS_KERNEL += -m32 -gstabs
371 endif
372 ifeq ($(CONFIG_BETTER_BACKTRACE),y)
373 CFLAGS_KERNEL += -fno-optimize-sibling-calls
374 endif
375
376 # TODO: do we need this, or can we rely on the compiler's defines?
377 CFLAGS_KERNEL += -D$(ARCH)
378
379 # TODO: this requires our own strchr (kern/src/stdio.c), which is a potential
380 # source of bugs/problems.
381 # note we still pull in stdbool and stddef from the compiler
382 CFLAGS_KERNEL += -fno-builtin
383
384 AFLAGS_KERNEL := $(CFLAGS_KERNEL)
385
386 KBUILD_BUILTIN := 1
387 KBUILD_CHECKSRC := 0
388
389 export AKAROSINCLUDE CROSS_COMPILE
390 export CC CPP AS AR LD OBJCOPY OBJDUMP NM STRIP
391 export CFLAGS_KERNEL AFLAGS_KERNEL
392 export NOSTDINC_FLAGS XCC_TARGET_ROOT XCC_TARGET_LIB XCC_TARGET_INCLUDE
393 export KBUILD_BUILTIN KBUILD_CHECKSRC
394
395 CFLAGS_USER += -O2 -std=gnu99 -fno-stack-protector -fgnu89-inline \
396                -Wsystem-headers
397 CXXFLAGS_USER += -O2
398 CFLAGS_USER_LIBS += -fPIC -static -fno-omit-frame-pointer -g
399
400 export CFLAGS_USER CXXFLAGS_USER CFLAGS_USER_LIBS
401
402 # Akaros include stuff (includes custom make targets and user overrides)
403 # =========================================================================
404
405 # The user can override this, though it won't apply for any of the in-tree
406 # kernel build output.  Right now, it's only passed down to tests/
407 dummy-1 := $(shell mkdir -p $(OBJDIR)/kern/)
408
409 # Since we're doing this outside of the dot-config part, some targets, such as
410 # clean, won't read in our .config/auto.conf, and won't know about the
411 # KFS_PATH.  Future rules related to KFS will have issues (mkdir with no
412 # argument, or a find of the entire pwd).  It's also possible someone provided
413 # an empty path.  To deal with both, we'll just have a sensible default.
414 kfs-paths :=  $(subst $\",,$(CONFIG_KFS_PATHS))
415 ifeq ($(kfs-paths),)
416 kfs-paths := kern/kfs
417 endif
418
419 FIRST_KFS_PATH = $(firstword $(kfs-paths))
420 ABS_KFS_PATH = $(abspath $(FIRST_KFS_PATH))
421
422 export OBJDIR FIRST_KFS_PATH ABS_KFS_PATH
423
424 # Avoiding implicit rules
425 $(srctree)/Makelocal: ;
426 # TODO: one issue is that we import all types of targets: build, clean, etc.
427 # That makes it a bit tougher to reorganize with ifeqs.
428 -include $(srctree)/Makelocal
429
430 # Akaros Kernel Build
431 # =========================================================================
432 # Add top level directories, either to an existing entry (core-y) or to its
433 # own. 
434 #
435 # From these, we determine deps and dirs.  We recursively make through the
436 # dirs, generating built-in.o at each step, which are the deps from which we
437 # link akaros.
438 #
439 # We have all-arch-dirs and all-dirs, so that we can still clean even without
440 # an arch symlink.
441
442 core-y += kern/src/ kern/drivers/ kern/lib/ $(AKAROS_EXTERNAL_DIRS)
443 arch-y += kern/arch/$(ARCH)/
444
445 akaros-dirs     := $(patsubst %/,%,$(filter %/, $(core-y) $(arch-y)))
446
447 all-arch-dirs   := $(patsubst %,kern/arch/%/,$(valid-arches))
448 akaros-all-dirs := $(patsubst %/,%,$(filter %/, $(core-y) $(all-arch-dirs)))
449
450 core-y          := $(patsubst %/, %/built-in.o, $(core-y))
451 arch-y          := $(patsubst %/, %/built-in.o, $(arch-y))
452
453 kbuild_akaros_main := $(core-y) $(arch-y)
454 akaros-deps := $(kbuild_akaros_main)  kern/arch/$(ARCH)/$(KERNEL_LD)
455
456 kern_cpio := $(OBJDIR)/kern/initramfs.cpio
457 kern_cpio_obj := $(kern_cpio).o
458
459 # ext2 will crash at runtime if we don't have a block device.  try to catch the
460 # errors now.  if it is a bad one, you're just out of luck.
461 ifneq ($(CONFIG_EXT2FS),)
462 ext2-bdev := $(patsubst "%",%,$(CONFIG_EXT2_BDEV))
463 ifeq ($(ext2-bdev),)
464 $(error EXT2 selected with no block device [$(ext2-bdev)], fix your .config)
465 endif
466 ext2_bdev_obj = $(OBJDIR)/kern/$(shell basename $(ext2-bdev)).o
467 endif
468
469 # a bit hacky: we want to make sure the directories exist, and error out
470 # otherwise.  we also want to error out before the initramfs target, otherwise
471 # we might not get the error (if initramfs files are all up to date).  the
472 # trickiest thing here is that kfs-paths-check could be stale and require an
473 # oldconfig.  running make twice should suffice.
474 kfs-paths-check := $(shell for i in $(kfs-paths); do \
475                                if [ ! -d "$$i" ]; then \
476                                    echo "Can't find KFS directory $$i"; \
477                                        $(MAKE) -f $(srctree)/Makefile \
478                                                                            silentoldconfig > /dev/null; \
479                                    exit -1; \
480                                fi; \
481                            done; echo "ok")
482
483 ifneq (ok,$(kfs-paths-check))
484 $(error $(kfs-paths-check), try make one more time in case of stale configs)
485 endif
486
487 kern_initramfs_files := $(shell find $(kfs-paths))
488
489 # Need to make an empty cpio, then append each kfs-path's contents
490 $(kern_cpio) initramfs: $(kern_initramfs_files)
491         @echo "  Building initramfs:"
492         @if [ "$(CONFIG_KFS_CPIO_BIN)" != "" ]; then \
493         sh $(CONFIG_KFS_CPIO_BIN); \
494     fi
495         @cat /dev/null | cpio --quiet -oH newc -O $(kern_cpio)
496         $(Q)for i in $(kfs-paths); do cd $$i; \
497         echo "    Adding $$i to initramfs..."; \
498         find -L . | cpio --quiet -oAH newc -O $(CURDIR)/$(kern_cpio); \
499         cd $$OLDPWD; \
500     done;
501
502 ld_emulation = $(shell $(OBJDUMP) -i 2>/dev/null | \
503                        grep -v BFD | grep ^[a-z] | head -n1)
504 ld_arch = $(shell $(OBJDUMP) -i 2>/dev/null |\
505                   grep -v BFD | grep "^  [a-z]" | head -n1)
506
507 # Our makefile doesn't detect a change in subarch, and old binary objects that
508 # don't need to be updated won't get rebuilt, but they also can't link with the
509 # new subarch (32 bit vs 64 bit).  If we detect the wrong type, we'll force a
510 # rebuild.
511 existing-cpio-emul := $(shell objdump -f $(kern_cpio_obj) 2> /dev/null | \
512                         grep format | sed 's/.*format //g')
513 ifneq ($(existing-cpio-emul),)
514 ifneq ($(existing-cpio-emul),$(ld_emulation))
515 $(kern_cpio_obj): cpio-rebuild
516 cpio-rebuild:
517         $(Q)rm $(kern_cpio_obj)
518 endif
519 endif
520
521 $(kern_cpio_obj): $(kern_cpio)
522         $(Q)$(OBJCOPY) -I binary -B $(ld_arch) -O $(ld_emulation) $< $@
523
524 existing-ext2b-emul := $(shell objdump -f $(kern_cpio_obj) 2> /dev/null | \
525                          grep format | sed 's/.*format //g')
526 ifneq ($(existing-ext2b-emul),)
527 ifneq ($(existing-ext2b-emul),$(ld_emulation))
528 $(ext2_bdev_obj): ext2b-rebuild
529 ext2b-rebuild:
530         $(Q)rm $(ext2_bdev_obj)
531 endif
532 endif
533
534 $(ext2_bdev_obj): $(ext2-bdev)
535         $(Q)$(OBJCOPY) -I binary -B $(ld_arch) -O $(ld_emulation) $< $@
536
537 # Not the worlds most elegant link command.  link-kernel takes the obj output
538 # name, then the linker script, then everything else you'd dump on the ld
539 # command line, including linker options and objects to link together.
540
541 # After the script is done, we run the arch-specific command directly.
542 quiet_cmd_link-akaros = LINK    $@
543       cmd_link-akaros = $(CONFIG_SHELL) scripts/link-kernel.sh $@ \
544                         kern/arch/$(ARCH)/$(KERNEL_LD) $(LDFLAGS_KERNEL) \
545                         --build-id=sha1 \
546                         $(akaros-deps) $(gcc-lib) $(kern_cpio_obj) \
547                         $(ext2_bdev_obj); \
548                         $(ARCH_POST_LINK_CMD)
549
550 # For some reason, the if_changed doesn't work with FORCE (like it does in
551 # Linux).  It looks like it can't find the .cmd file or something (also
552 # complaints of $(targets), so that all is probably messed up).
553 $(KERNEL_OBJ): $(akaros-deps) $(kern_cpio_obj) $(ext2_bdev_obj)
554         $(call if_changed,link-akaros)
555
556 akaros-kernel: $(KERNEL_OBJ)
557
558 $(sort $(akaros-deps)): $(akaros-dirs) ;
559
560 # Recursively Kbuild all of our directories.  If we're changing arches
561 # mid-make, we might have issues ( := on akaros-dirs, etc).
562 PHONY += $(akaros-dirs) cc_exists
563 $(akaros-dirs): scripts symlinks cc-exists
564         $(Q)$(MAKE) $(build)=$@
565
566 cc-exists:
567         @if [ "`which $(CROSS_COMPILE)gcc`" = "" ]; then echo \
568             Could not find a $(CROSS_COMPILE) version of GCC/binutils. \
569             Be sure to build the cross-compiler and update your PATH; exit 1; fi
570
571 $(CMP_KERNEL_OBJ): $(KERNEL_OBJ)
572         @echo "Compressing kernel image"
573         $(Q)gzip -c $^ > $@
574
575 # TODO: not sure what all we want to have available for config targets
576 # (anything after this is allowed.  We currently need clean targets available
577 # (config->symlinks->clean).
578 endif #ifeq ($(config-targets),1)
579 endif #ifeq ($(mixed-targets),1)
580
581 # Akaros Userspace Building and Misc Helpers
582 # =========================================================================
583 # Recursively make user libraries and tests.
584 #
585 # User library makefiles are built to expect to be called from their own
586 # directories.  The test code can be called from the root directory.
587
588 # List all userspace directories here, and state any dependencies between them,
589 # such as how pthread depends on parlib.
590
591 user-dirs = parlib pthread benchutil iplib ndblib vmm perfmon
592 benchutil: parlib
593 pthread: parlib benchutil
594 iplib: parlib
595 ndblib: iplib
596 vmm: parlib benchutil
597
598 PHONY += install-libs $(user-dirs)
599 install-libs: $(user-dirs) symlinks cc-exists
600
601 $(user-dirs):
602         @$(MAKE) -C user/$@ DEPLIBS="$^" && $(MAKE) -C user/$@ install
603
604 user: $(user-dirs)
605
606 PHONY += userclean $(clean-user-dirs)
607 clean-user-dirs := $(addprefix _clean_user_,$(user-dirs))
608 userclean: $(clean-user-dirs) testclean utestclean
609
610 $(clean-user-dirs):
611         @$(MAKE) -C user/$(patsubst _clean_user_%,%,$@) clean
612
613 tests/: tests
614 tests: install-libs
615         @$(MAKE) -f tests/Makefile
616
617 PHONY += utest
618 utest: $(user-dirs)
619         @$(MAKE) -C user/$@
620
621 testclean:
622         @$(MAKE) -f tests/Makefile clean
623
624 utestclean:
625         @$(MAKE) -C user/utest clean
626
627 # KFS related stuff
628 PHONY += fill-kfs unfill-kfs
629 xcc-gcc-libs = $(XCC_TARGET_ROOT)/../lib/
630 xcc-so-files = $(addprefix $(XCC_TARGET_LIB), *.so*) \
631                $(addprefix $(xcc-gcc-libs), *.so*)
632
633 $(OBJDIR)/.dont-force-fill-kfs:
634         $(Q)rm -rf $(addprefix $(FIRST_KFS_PATH)/lib/, $(notdir $(xcc-so-files)))
635         @echo "Cross Compiler 'so' files removed from KFS"
636         @$(MAKE) -f tests/Makefile uninstall
637         @echo "Apps from /test removed from KFS"
638         @$(MAKE) -C user/utest uninstall
639         @echo "User space tests removed from KFS"
640         @touch $(OBJDIR)/.dont-force-fill-kfs
641
642 fill-kfs: $(OBJDIR)/.dont-force-fill-kfs install-libs tests
643         @mkdir -p $(FIRST_KFS_PATH)/lib
644         $(Q)cp -uP $(xcc-so-files) $(FIRST_KFS_PATH)/lib
645         @echo "Cross Compiler 'so' files installed to KFS"
646         @$(MAKE) -f tests/Makefile install
647         @echo "Apps from /test installed to KFS"
648         @$(MAKE) -C user/utest install
649         @echo "User space tests installed to KFS"
650
651 # Use doxygen to make documentation for ROS (Untested since 2010 or so)
652 doxygen-dir := $(CUR_DIR)/Documentation/doxygen
653 docs: 
654         @echo "  Making doxygen"
655         @doxygen-dir=$(doxygen-dir) doxygen $(doxygen-dir)/rosdoc.cfg
656         @if [ ! -d $(doxygen-dir)/rosdoc/html/img ]; \
657          then \
658                 ln -s ../../img $(doxygen-dir)/rosdoc/html; \
659          fi
660
661 doxyclean:
662         @echo + clean [ROSDOC]
663         @rm -rf $(doxygen-dir)/rosdoc
664
665 objclean:
666         @echo + clean [OBJDIR]
667         @rm -rf $(OBJDIR)
668
669 realclean: userclean mrproper doxyclean objclean
670
671 # Bundled apps
672 # =========================================================================
673
674 app-dirs =
675 tagged-app-dirs := $(subst /,__,$(app-dirs))
676 app-dirs-install := $(addprefix _install_,$(tagged-app-dirs))
677 app-dirs-clean := $(addprefix _clean_,$(tagged-app-dirs))
678
679 PHONY += $(app-dirs-install) $(app-dirs-clean)
680
681 $(app-dirs-install):
682         @$(MAKE) -C $(patsubst _install_%,%,$(subst __,/,$@)) install
683
684 $(app-dirs-clean):
685         @$(MAKE) -C $(patsubst _clean_%,%,$(subst __,/,$@)) clean
686
687 PHONY +=  apps-install
688 apps-install: $(app-dirs-install)
689         @$(call make_as_parent, -C tools/apps/busybox)
690         @$(call make_as_parent, -C tools/apps/ipconfig install)
691         @$(call make_as_parent, -C tools/dev-libs/elfutils install)
692         @$(call make_as_parent, -C tools/dev-util/perf install)
693         @$(call make_as_parent, -C tools/sys-apps/bash install)
694
695 PHONY += apps-clean
696 apps-clean: $(app-dirs-clean)
697         @$(call make_as_parent, -C tools/apps/busybox clean)
698         @$(call make_as_parent, -C tools/apps/ipconfig clean)
699         @$(call make_as_parent, -C tools/dev-libs/elfutils clean)
700         @$(call make_as_parent, -C tools/dev-util/perf clean)
701
702 # Cross Compiler
703 # =========================================================================
704
705 xcc_build_dir := tools/compilers/gcc-glibc
706 xcc_target := $(ARCH)
707 ifeq ($(xcc_target),x86)
708     xcc_target := $(xcc_target)_64
709 endif
710 xcc_cleans := $(shell $(MAKE) -C $(xcc_build_dir) -pn |\
711                       grep "VALID_CLEANS := " |\
712                       sed -e 's/VALID_CLEANS := //')
713 xcc_subcmds := $(shell $(MAKE) -C $(xcc_build_dir) -pn |\
714                        grep "VALID_SUBCMDS := " |\
715                        sed -e 's/VALID_SUBCMDS := //')
716 xcc_clean_goals := $(patsubst %, xcc-%, $(xcc_cleans))
717 xcc_subcmd_goals := $(patsubst %, xcc-%, $(xcc_subcmds))
718
719 PHONY += xcc
720 xcc: xcc-build
721
722 PHONY += $(xcc_clean_goals)
723 $(xcc_clean_goals):
724         @target="$(patsubst xcc-%,%,$(@))";\
725         $(call make_as_parent, -C $(xcc_build_dir) $${target})
726
727 PHONY += $(xcc_subcmd_goals)
728 $(xcc_subcmd_goals):
729         @subcmd="$(patsubst xcc-%,%,$(@))";\
730         target="$(xcc_target) $${subcmd}";\
731         $(call make_as_parent, -C $(xcc_build_dir) $${target})
732
733 PHONY += xcc-upgrade
734 xcc-upgrade: xcc
735         @$(MAKE) userclean
736         @$(MAKE) install-libs
737         @$(MAKE) testclean utestclean
738         @$(MAKE) tests utest
739         @$(call make_as_parent, apps-clean)
740         @$(call make_as_parent, apps-install)
741         @$(MAKE) fill-kfs
742         @$(MAKE) akaros-kernel
743
744 PHONY += xcc-upgrade-from-scratch
745 xcc-upgrade-from-scratch: xcc-clean xcc-uninstall
746         @$(call make_as_parent, xcc-upgrade)
747
748 # Cleaning
749 # =========================================================================
750 # This is mostly the Linux kernel cleaning.  We could hook in to the userspace
751 # cleaning with the 'userclean' target attached to clean, though historically
752 # 'clean' means the kernel.
753
754 # Shorthand for $(Q)$(MAKE) -f scripts/Makefile.clean obj=dir
755 # Usage:
756 # $(Q)$(MAKE) $(clean)=dir
757 clean := -f $(if $(KBUILD_SRC),$(srctree)/)scripts/Makefile.clean obj
758
759 # clean - Delete all generated files
760 #
761 clean-dirs         := $(addprefix _clean_,$(akaros-all-dirs))
762
763 PHONY += $(clean-dirs) clean
764 $(clean-dirs):
765         $(Q)$(MAKE) $(clean)=$(patsubst _clean_%,%,$@)
766
767 RCS_FIND_IGNORE := \( -name SCCS -o -name BitKeeper -o -name .svn -o -name CVS \
768                    -o -name .pc -o -name .hg -o -name .git \) -prune -o
769 clean: $(clean-dirs)
770         @find $(patsubst _clean_%,%,$(clean-dirs)) $(RCS_FIND_IGNORE) \
771             \( -name '*.[oas]' -o -name '*.ko' -o -name '.*.cmd' \
772             -o -name '*.ko.*' \
773             -o -name '.*.d' -o -name '.*.tmp' -o -name '*.mod.c' \
774             -o -name '*.symtypes' -o -name 'modules.order' \
775             -o -name modules.builtin -o -name '.tmp_*.o.*' \
776             -o -name '*.gcno' \) -type f -print | xargs rm -f
777
778 # Could add in an archclean if we need arch-specific cleanup, or a userclean if
779 # we want to start cleaning that too.
780 #clean: archclean
781 #clean: userclean
782
783 # mrproper - Delete all generated files, including .config, and reset ARCH
784 #
785 mrproper-dirs      := $(addprefix _mrproper_,scripts)
786
787 PHONY += $(mrproper-dirs) mrproper
788 $(mrproper-dirs):
789         $(Q)$(MAKE) $(clean)=$(patsubst _mrproper_%,%,$@)
790
791 mrproper: $(mrproper-dirs) clean clean_symlinks
792         @-rm -f .config
793         @find $(patsubst _mrproper_%,%,$(mrproper-dirs)) $(RCS_FIND_IGNORE) \
794             \( -name '*.[oas]' -o -name '*.ko' -o -name '.*.cmd' \
795             -o -name '*.ko.*' \
796             -o -name '.*.d' -o -name '.*.tmp' -o -name '*.mod.c' \
797             -o -name '*.symtypes' -o -name 'modules.order' \
798             -o -name modules.builtin -o -name '.tmp_*.o.*' \
799             -o -name '*.gcno' \) -type f -print | xargs rm -f
800
801 # Epilogue
802 # =========================================================================
803
804 PHONY += FORCE
805 FORCE:
806
807 # Don't put the srctree on this, make is looking for Makefile, not
808 # /full/path/to/Makefile.
809 Makefile: ; # avoid implicit rule on Makefile
810
811 # Declare the contents of the .PHONY variable as phony.  We keep that
812 # information in a variable so we can use it in if_changed and friends.
813 .PHONY: $(PHONY)