1 # Makefile for GeekOS kernel, userspace, and tools
3 # Northwestern University
4 # (c) 2008, Jack Lange <jarusl@cs.northwestern.edu>
5 # (c) 2008, Peter Dinda <pdinda@northwestern.edu>
6 # (c) 2008, Lei Xia <xiaxlei@gmail.com>
7 # (c) 2008, The V3VEE Project <http://www.v3vee.org>
9 # Based on GeekOS Makefile:
10 # Copyright (c) 2004,2005 David H. Hovemeyer <daveho@cs.umd.edu>
14 # This is free software. You are permitted to use,
15 # redistribute, and modify it as specified in the file "COPYING".
17 # Required software to build GeekOS:
18 # - GNU Make (http://www.gnu.org/software/make)
19 # - gcc 2.95.2 generating code for target (i386/ELF) and host platforms
20 # - nasm (http://nasm.sourceforge.net)
21 # - Perl5, AWK (any version), egrep
23 # Cygwin (http://cygwin.com) may be used to build GeekOS.
24 # Make sure that gcc, binutils, nasm, and perl are installed.
27 # - This makefile has been written carefully to work correctly
28 # with the -j (parallel make) option. I regularly use "make -j 2"
29 # to speed the build process on 2 processor systems.
32 # Base address of kernel
34 # Note: at top of memory minus three pages (GDT/TSS/IDT)
38 # Note that the code will initially load at 0x10000
40 # The setup code needs to copy it up to this address and jump there
42 KERNEL_BASE_ADDR := 0x00100000
44 # Kernel entry point function
45 KERNEL_ENTRY = $(SYM_PFX)Main
49 VPATH := $(PROJECT_ROOT)/src
51 #when -DNDEBUG is set the kassert functions are disabled
54 # DEBUG=1 means VMM_DEBUG, VMM_INFO, and VMM_TRACE are enabled
55 # as are SERIAL_PRINT_DEBUG
61 DEBUG_SECTIONS:= $(DEBUG_SECTIONS) -DDEBUG_SHADOW_PAGING -DDEBUG_CTRL_REGS -DDEBUG_INTERRUPTS -DDEBUG_IO -DDEBUG_KEYBOARD -DDEBUG_PIC -DDEBUG_PIT -DDEBUG_NVRAM -DDEBUG_EMULATOR -DDEBUG_GENERIC -DDEBUG_RAMDISK
64 ifeq ($(DEBUG_SHADOW_PAGING),1)
65 DEBUG_SECTIONS := $(DEBUG_SECTIONS) -DDEBUG_SHADOW_PAGING
67 ifeq ($(DEBUG_SHADOW_PAGING),0)
68 DEBUG_SECTIONS := $(DEBUG_SECTIONS) -UDEBUG_SHADOW_PAGING
72 ifeq ($(DEBUG_CTRL_REGS),1)
73 DEBUG_SECTIONS := $(DEBUG_SECTIONS) -DDEBUG_CTRL_REGS
75 ifeq ($(DEBUG_CTRL_REGS),0)
76 DEBUG_SECTIONS := $(DEBUG_SECTIONS) -UDEBUG_CTRL_REGS
80 ifeq ($(DEBUG_INTERRUPTS),1)
81 DEBUG_SECTIONS := $(DEBUG_SECTIONS) -DDEBUG_INTERRUPTS
83 ifeq ($(DEBUG_DEBUG_INTERRUPTS),0)
84 DEBUG_SECTIONS := $(DEBUG_SECTIONS) -UDEBUG_INTERRUPTS
89 DEBUG_SECTIONS := $(DEBUG_SECTIONS) -DDEBUG_IO
92 DEBUG_SECTIONS := $(DEBUG_SECTIONS) -UDEBUG_IO
96 ifeq ($(DEBUG_KEYBOARD),1)
97 DEBUG_SECTIONS := $(DEBUG_SECTIONS) -DDEBUG_KEYBOARD
99 ifeq ($(DEBUG_KEYBOARD),0)
100 DEBUG_SECTIONS := $(DEBUG_SECTIONS) -UDEBUG_KEYBOARD
104 ifeq ($(DEBUG_PIC),1)
105 DEBUG_SECTIONS := $(DEBUG_SECTIONS) -DDEBUG_PIC
107 ifeq ($(DEBUG_PIC),0)
108 DEBUG_SECTIONS := $(DEBUG_SECTIONS) -UDEBUG_PIC
112 ifeq ($(DEBUG_PIT),1)
113 DEBUG_SECTIONS := $(DEBUG_SECTIONS) -DDEBUG_PIT
115 ifeq ($(DEBUG_PIT),0)
116 DEBUG_SECTIONS := $(DEBUG_SECTIONS) -UDEBUG_PIT
120 ifeq ($(DEBUG_NVRAM),1)
121 DEBUG_SECTIONS := $(DEBUG_SECTIONS) -DDEBUG_NVRAM
123 ifeq ($(DEBUG_NVRAM),0)
124 DEBUG_SECTIONS := $(DEBUG_SECTIONS) -UDEBUG_NVRAM
128 ifeq ($(DEBUG_GENERIC),1)
129 DEBUG_SECTIONS := $(DEBUG_SECTIONS) -DDEBUG_GENERIC
131 ifeq ($(DEBUG_GENERIC),0)
132 DEBUG_SECTIONS := $(DEBUG_SECTIONS) -UDEBUG_GENERIC
136 ifeq ($(DEBUG_EMULATOR),1)
137 DEBUG_SECTIONS := $(DEBUG_SECTIONS) -DDEBUG_EMULATOR
139 ifeq ($(DEBUG_EMULATOR),0)
140 DEBUG_SECTIONS := $(DEBUG_SECTIONS) -UDEBUG_EMULATOR
144 ifeq ($(DEBUG_RAMDISK),1)
145 DEBUG_SECTIONS := $(DEBUG_SECTIONS) -DDEBUG_RAMDISK
147 ifeq ($(DEBUG_RAMDISK),0)
148 DEBUG_SECTIONS := $(DEBUG_SECTIONS) -UDEBUG_RAMDISK
153 #DEBUG_SECTIONS := $(DEBUG_SECTIONS) -DTEST_NE2K
156 JRLDEBUG= -DSERIAL_PRINT_DEBUG=1 -DSERIAL_PRINT_DEBUG_LEVEL=10 -DSERIAL_PRINT=1 -DVMM_DEBUG=1 -DVMM_INFO=1 -DVMM_TRACE=1 $(DEBUG_SECTIONS)
159 JRLDEBUG= -DSERIAL_PRINT_DEBUG=0 -DSERIAL_PRINT_DEBUG_LEVEL=999999 -DSERIAL_PRINT=0 -DVMM_DEBUG=0 -DVMM_INFO=0 -DVMM_TRACE=0
164 # DECODER is the decoder that will be used
165 # currently we only support xed
173 ifeq ($(DECODER),XED)
174 DECODER_SRCS := vmm_xed.c
175 DECODER_FLAGS := -L../lib/xed
176 DECODER_LIBS := -lxed
182 #TCPSTACK, uIP is used currently
192 ifeq ($(RAMDISK_BOOT),1)
193 BOOT_FLAGS := $(BOOT_FLAGS) -DRAMDISK_BOOT
194 RAMDISK_SRCS := ramdisk.c cdrom.c
200 # This is wrong for current cygwin - no changes needed
202 # Figure out if we're compiling with cygwin, http://cygwin.com
205 #SYSTEM_NAME := $(shell uname -s)
206 #ifeq ($(findstring CYGWIN,$(SYSTEM_NAME)),CYGWIN)
208 #EXTRA_C_OPTS := -DNEED_UNDERSCORE -DGNU_WIN32
209 #EXTRA_NASM_OPTS := -DNEED_UNDERSCORE
210 #NON_ELF_SYSTEM := yes
211 #EXTRA_CC_USER_OPTS := -Dmain=geekos_main
217 # ----------------------------------------------------------------------
219 # Various options specifying how GeekOS should be built,
220 # what source files to build, which user programs to build,
221 # etc. This is generally the only section of the makefile
222 # that will need to be modified.
223 # ----------------------------------------------------------------------
225 # List of targets to build by default.
226 # These targets encompass everything needed to boot
228 ALL_TARGETS := vmm.img vm_kernel
231 # Kernel source files
232 KERNEL_C_SRCS := idt.c int.c trap.c irq.c io.c \
233 blockdev.c ide.c ne2k.c \
234 keyboard.c screen.c timer.c \
236 gdt.c tss.c segment.c \
241 debug.c vmm_stubs.c vm.c pci.c\
242 queue.c socket.c net.c ring_buffer.c \
246 # Kernel object files built from C source files
247 KERNEL_C_OBJS := $(KERNEL_C_SRCS:%.c=geekos/%.o)
249 # Kernel assembly files
250 KERNEL_ASM_SRCS := lowlevel.asm
252 KERNEL_GAS_SRCS := testvm.s udivdi3.s
254 # Kernel object files build from assembler source files
255 KERNEL_ASM_OBJS := $(KERNEL_ASM_SRCS:%.asm=geekos/%.o)
257 KERNEL_GAS_OBJS := $(KERNEL_GAS_SRCS:%.s=geekos/%.o)
260 # All kernel object files
261 KERNEL_OBJS := $(KERNEL_C_OBJS) \
262 $(KERNEL_ASM_OBJS) $(KERNEL_GAS_OBJS)
264 # Common library source files.
265 # This library is linked into both the kernel and user programs.
266 # It provides string functions and generic printf()-style
268 COMMON_C_SRCS := fmtout.c string.c memmove.c
270 # Common library object files.
271 COMMON_C_OBJS := $(COMMON_C_SRCS:%.c=common/%.o)
273 VMM_ASM_SRCS := svm_lowlevel.asm \
276 VMM_ASM_OBJS := $(VMM_ASM_SRCS:%.asm=palacios/%.o)
279 VMM_C_SRCS := vm_guest.c \
280 svm.c svm_handler.c vmm.c vmm_util.c vmm_ctrl_regs.c \
281 vmcb.c vmm_mem.c vmm_paging.c vmm_io.c vmm_debug.c svm_io.c \
282 vmm_intr.c vmm_time.c \
283 vmm_shadow_paging.c vm_guest_mem.c \
284 vm_dev.c vmm_dev_mgr.c vmm_decoder.c \
285 svm_halt.c svm_pause.c svm_wbinvd.c \
286 vmm_config.c vmm_hashtable.c \
287 vmm_string.c vmm_emulator.c vmm_queue.c\
289 # vmx.c vmcs_gen.c vmcs.c
291 VMM_C_OBJS := $(VMM_C_SRCS:%.c=palacios/%.o)
293 VMM_OBJS := $(VMM_C_OBJS) $(VMM_ASM_OBJS)
298 DEVICE_C_SRCS := generic.c keyboard.c nvram.c timer.c simple_pic.c 8259a.c 8254.c serial.c $(RAMDISK_SRCS)
300 DEVICE_C_OBJS := $(DEVICE_C_SRCS:%.c=devices/%.o)
302 DEVICE_OBJS := $(DEVICE_C_OBJS)
304 V3LIBS := $(DECODER_LIBS)
307 TCPSTACK_C_SRCS := psock.c timer.c uip_arp.c uip.c uip-fw.c uiplib.c uip-neighbor.c uip-split.c resolv.c
309 TCPSTACK_C_OBJS := $(TCPSTACK_C_SRCS:%.c=net/%.o)
311 TCPSTACK_OBJS := $(TCPSTACK_C_OBJS)
316 # ----------------------------------------------------------------------
318 # This section defines programs that are used to build GeekOS.
319 # ----------------------------------------------------------------------
321 # Uncomment if cross compiling
322 TARGET_CC_PREFIX := $(PROJECT_ROOT)/../devtools/i386/bin/i386-elf-
323 #TARGET_CC_PREFIX := i386-elf-
325 # Target C compiler. gcc 2.95.2 or later should work.
326 TARGET_CC := $(TARGET_CC_PREFIX)gcc
327 #TARGET_CC := $(TARGET_CC_PREFIX)gcc34 -m32
329 # Host C compiler. This is used to compile programs to execute on
330 # the host platform, not the target (x86) platform. On x86/ELF
331 # systems, such as Linux and FreeBSD, it can generally be the same
332 # as the target C compiler.
335 # Target linker. GNU ld is probably to only one that will work.
336 TARGET_LD := $(TARGET_CC_PREFIX)ld -melf_i386
339 TARGET_AR := $(TARGET_CC_PREFIX)ar
342 TARGET_RANLIB := $(TARGET_CC_PREFIX)ranlib
345 TARGET_NM := $(TARGET_CC_PREFIX)nm
348 TARGET_OBJCOPY := $(TARGET_CC_PREFIX)objcopy
350 # Nasm (http://nasm.sourceforge.net)
351 NASM := $(PROJECT_ROOT)/../devtools/bin/nasm
352 #NASM := /opt/vmm-tools/bin/nasm
356 # Tool to build PFAT filesystem images.
357 BUILDFAT := tools/builtFat.exe
362 # Pad a file so its size is a multiple of some unit (i.e., sector size)
363 PAD := $(PERL) $(PROJECT_ROOT)/scripts/pad
365 # Create a file filled with zeroes.
366 ZEROFILE := $(PERL) $(PROJECT_ROOT)/scripts/zerofile
368 # Calculate size of file in sectors
369 NUMSECS := $(PERL) $(PROJECT_ROOT)/scripts/numsecs
372 FD_SECTORS_PER_TRACK := $(PERL) $(PROJECT_ROOT)/scripts/numsecs_per_track
375 # ----------------------------------------------------------------------
377 # Options passed to the tools.
378 # ----------------------------------------------------------------------
380 # Flags used for all C source files
381 GENERAL_OPTS := -O -Wall $(EXTRA_C_OPTS) $(VMM_FLAGS) $(BOOT_FLAGS) -fPIC
382 CC_GENERAL_OPTS := $(GENERAL_OPTS) -Werror
384 # Flags used for kernel C source files
385 CC_KERNEL_OPTS := -g -DGEEKOS -I$(PROJECT_ROOT)/include
387 # Flags used for VMM C source files
388 CC_VMM_OPTS := -g -I$(PROJECT_ROOT)/include -D__V3VEE__ -D__V3_32BIT__ $(DECODER_FLAGS) $(JRLDEBUG)
390 # Flags used for VMM C ASM files
391 NASM_VMM_OPTS := -I$(PROJECT_ROOT)/src/palacios/ -f elf $(EXTRA_NASM_OPTS)
393 # Flags user for kernel assembly files
394 NASM_KERNEL_OPTS := -I$(PROJECT_ROOT)/src/geekos/ -f elf $(EXTRA_NASM_OPTS)
396 # Flags used for common library and libc source files
397 CC_USER_OPTS := -I$(PROJECT_ROOT)/include -I$(PROJECT_ROOT)/include/libc \
398 $(EXTRA_CC_USER_OPTS)
400 # Flags passed to objcopy program (strip unnecessary sections from kernel.exe)
401 OBJCOPY_FLAGS := -R .dynamic -R .note -R .comment
403 # ----------------------------------------------------------------------
405 # Describes how to compile the source files.
406 # ----------------------------------------------------------------------
408 # Compilation of kernel C source files
410 geekos/%.o : geekos/%.c
411 $(TARGET_CC) -c $(CC_GENERAL_OPTS) $(CC_KERNEL_OPTS) $< -o geekos/$*.o
414 # Compilation of kernel assembly source files
415 geekos/%.o : geekos/%.asm
416 $(NASM) $(NASM_KERNEL_OPTS) $< -o geekos/$*.o
418 # Compilation of test VM
419 geekos/%.o : geekos/%.s
420 $(AS) $< -o geekos/$*.o
422 geekos/%.o : geekos/%.S
423 $(TARGET_CC) -c $(CC_GENERAL_OPTS) $(CC_KERNEL_OPTS) $< -o geekos/$*.o
425 # Compilation of common library C source files
426 common/%.o : common/%.c
427 $(TARGET_CC) -c $(CC_GENERAL_OPTS) $(CC_USER_OPTS) $< -o common/$*.o
429 palacios/%.o : palacios/%.c
430 $(TARGET_CC) -c $(CC_GENERAL_OPTS) $(CC_VMM_OPTS) $< -o palacios/$*.o
432 palacios/%.o : palacios/%.asm
433 $(NASM) $(NASM_VMM_OPTS) $< -o palacios/$*.o
435 devices/%.o : devices/%.c
436 $(TARGET_CC) -c $(CC_GENERAL_OPTS) $(CC_VMM_OPTS) $< -o devices/$*.o
438 devices/%.o : devices/%.asm
439 $(NASM) $(NASM_VMM_OPTS) $< -o devices/$*.o
442 $(TARGET_CC) -c $(CC_GENERAL_OPTS) $(CC_USER_OPTS) $< -o net/$*.o
444 # ----------------------------------------------------------------------
446 # Specifies files to be built
447 # ----------------------------------------------------------------------
449 # Default target - see definition of ALL_TARGETS in Configuration section
453 #geekos/vmx_lowlevel.o: $(PROJECT_ROOT)/src/geekos/vmx_lowlevel.asm
456 # -I$(PROJECT_ROOT)/src/geekos/ \
457 # $(PROJECT_ROOT)/src/geekos/vmx_lowlevel.asm \
461 #geekos/test: geekos/test.o geekos/vmcs.o geekos/vmx_lowlevel.o
462 # $(CC) geekos/test.o geekos/vmcs.o geekos/vmx_lowlevel.o -o geekos/test
464 # Standard floppy image - just boots the kernel
465 fd.img : geekos/fd_boot.bin geekos/setup.bin geekos/kernel.bin
466 cat geekos/fd_boot.bin geekos/setup.bin geekos/kernel.bin > _temp
472 $(PAD) vmm.img 1474560
475 ln -s -f ../src/vmboot/rombios/BIOS-bochs-latest rombios
478 ln -s -f ../src/vmboot/vgabios/VGABIOS-lgpl-latest.bin vgabios
480 force_rombios: rombios_link
481 (cd ../src/vmboot/rombios; make clean; make)
483 force_vgabios: vgabios_link
484 (cd ../src/vmboot/vgabios; make clean; make)
486 force_payload: force_rombios force_vgabios
487 ../scripts/make_payload.pl payload_layout.txt vm_kernel
489 inter1: force_payload
492 world: inter1 vmm.img
494 # make ready to boot over PXE
496 cp vmm.img /tftpboot/vmm.img
499 /usr/local/qemu/bin/qemu-system-x86_64 -m 1024 -serial file:serial.out -cdrom puppy.iso -fda vmm.img
504 # Floppy boot sector (first stage boot loader).
505 geekos/fd_boot.bin : geekos/setup.bin geekos/kernel.bin $(PROJECT_ROOT)/src/geekos/fd_boot.asm
507 -I$(PROJECT_ROOT)/src/geekos/ \
508 -DNUM_SETUP_SECTORS=`$(NUMSECS) geekos/setup.bin` \
509 -DNUM_KERN_SECTORS=`$(NUMSECS) geekos/kernel.bin` \
510 -DSECTORS_PER_TRACK=`$(FD_SECTORS_PER_TRACK) geekos/kernel.bin geekos/setup.bin` \
511 $(PROJECT_ROOT)/src/geekos/fd_boot.asm \
514 # Setup program (second stage boot loader).
515 geekos/setup.bin : geekos/kernel.bin $(PROJECT_ROOT)/src/geekos/setup.asm
517 -I$(PROJECT_ROOT)/src/geekos/ \
518 -DENTRY_POINT=0x`egrep 'Main$$' geekos/kernel.syms |awk '{print $$1}'` \
519 -DVMM_SIZE=`$(NUMSECS) geekos/kernel.bin` \
520 $(PROJECT_ROOT)/src/geekos/setup.asm \
524 # Loadable (flat) kernel image.
525 geekos/kernel.bin : geekos/kernel.exe
526 $(TARGET_OBJCOPY) $(OBJCOPY_FLAGS) -S -O binary geekos/kernel.exe geekos/kernel.bin
529 # The kernel executable and symbol map.
530 geekos/kernel.exe : $(KERNEL_OBJS) $(COMMON_C_OBJS) $(VMM_OBJS) $(DEVICE_OBJS) $(TCPSTACK_OBJS) vm_kernel
531 $(TARGET_LD) -o geekos/kernel.exe -Ttext $(KERNEL_BASE_ADDR) -e $(KERNEL_ENTRY) \
533 $(KERNEL_OBJS) $(COMMON_C_OBJS) $(VMM_OBJS) $(DEVICE_OBJS) $(V3LIBS) $(TCPSTACK_OBJS) -b binary vm_kernel
534 $(TARGET_NM) geekos/kernel.exe > geekos/kernel.syms
541 # $(PAD) vm_kernel 512
542 # @echo "VM kernel lives at 0x100000 and is" `$(NUMSECS) vm_kernel` "sectors long"
547 # Clean build directories of generated files
549 for d in geekos common libc user tools palacios devices net; do \
550 (cd $$d && rm -f *); \
554 # Build header file dependencies, so source files are recompiled when
555 # header files they depend on are modified.
556 depend : $(GENERATED_LIBC_SRCS)
557 $(TARGET_CC) -M $(CC_GENERAL_OPTS) $(CC_KERNEL_OPTS) \
558 $(KERNEL_C_SRCS:%.c=$(PROJECT_ROOT)/src/geekos/%.c) \
559 | $(PERL) -n -e 's,^(\S),geekos/$$1,;print' \
561 $(TARGET_CC) -M $(CC_GENERAL_OPTS) $(CC_USER_OPTS) \
562 $(COMMON_C_SRCS:%.c=$(PROJECT_ROOT)/src/common/%.c) \
563 | $(PERL) -n -e 's,^(\S),common/$$1,;print' \
565 $(TARGET_CC) -M $(CC_GENERAL_OPTS) $(CC_KERNEL_OPTS) \
566 $(VMM_C_SRCS:%.c=$(PROJECT_ROOT)/src/palacios/%.c) \
567 | $(PERL) -n -e 's,^(\S),palacios/$$1,;print' \
569 $(TARGET_CC) -M $(CC_GENERAL_OPTS) $(CC_KERNEL_OPTS) \
570 $(DEVICE_C_SRCS:%.c=$(PROJECT_ROOT)/src/devices/%.c) \
571 | $(PERL) -n -e 's,^(\S),devices/$$1,;print' \
574 # By default, there are no header file dependencies.