diff options
Diffstat (limited to 'Makefile')
| -rw-r--r-- | Makefile | 319 |
1 files changed, 319 insertions, 0 deletions
diff --git a/Makefile b/Makefile new file mode 100644 index 0000000..67353ce --- /dev/null +++ b/Makefile @@ -0,0 +1,319 @@ +# +# Makefile for the 20245 operating system. +# + +######################################## +# Compilation/assembly definable options +######################################## + +# +# General options: +# CLEAR_BSS include code to clear all BSS space +# GET_MMAP get BIOS memory map via int 0x15 0xE820 +# OS_CONFIG OS-related (vs. just standalone) variations +# FORCE_INLINING force "inline" functions to be inlined even if +# we aren't compiling with at least -O2 +# MAKE_IDENTITY_MAP Compile vmtables.c with an "identity" page +# map table for the first 4MB of the address space. +# + +GEN_OPTIONS = -DCLEAR_BSS -DGET_MMAP -DOS_CONFIG + +# +# Debugging options: +# ANNOUNCE_ENTRY announce entry and exit from kernel functions +# RPT_INT_UNEXP report any 'unexpected' interrupts +# RPT_INT_MYSTERY report interrupt 0x27 specifically +# TRACE_CX context restore tracing +# SANITY=n enable "sanity check" level 'n' (0/1/2/3/4) +# T_* tracing options (see below) +# +# Some modules have their own internal debugging options, described +# in their introductory comments. +# +# Define SANITY as 0 for minimal runtime checking (critical errors only). +# If not defined, SANITY defaults to 9999. +# + +DBG_OPTIONS = -DRPT_INT_UNEXP +# DBG_OPTIONS += -DTRACE_CX + +# +# T_ options are used to define bits in a "tracing" bitmask, to allow +# checking of individual conditions. The following are defined: +# +# T_PCB PCB alloc/dealloc +# T_VM VM-related tasks +# T_QUE PCB queue manipulation +# T_SCH, T_DSP Scheduler and dispatcher +# T_SCALL, T_SRET System call entry and exit +# T_EXIT Process exit actions +# T_FORK, T_EXEC Fork and exec actions +# T_INIT Module init function tracing +# T_KM, T_KMFR, T_KMIN Kmem module tracing +# T_SIO, T_SIOR, T_SIOW General SIO module checks +# T_USER, T_ELF User module operations +# +# You can add compilation options "on the fly" by using EXTRAS=thing +# on the command line. For example, to compile with -H (to show the +# hierarchy of #includes): +# +# make EXTRAS=-H +# + +TRACE_OPTIONS = -DT_INIT -DT_USER -DT_ELF -DT_KMIN -DT_VM + +USER_OPTIONS = $(GEN_OPTIONS) $(DBG_OPTIONS) $(TRACE_OPTIONS) $(EXTRAS) + +############################################################## +# YOU SHOULD NOT NEED TO CHANGE ANYTHING BELOW THIS POINT!!! # +############################################################## + +# +# Compilation/assembly control +# + +# +# We only want to include from the common header directory +# +INCLUDES = -I./include + +# +# All our object code will live here +# +BUILDDIR = build +LIBDIR = $(BUILDDIR)/lib + +# +# Things we need to convert to object form +# +SUBDIRS := + +# +# Compilation/assembly/linking commands and options +# +CPP = cpp +CPPFLAGS = $(USER_OPTIONS) -nostdinc $(INCLUDES) + +# +# Compiler/assembler/etc. settings for 32-bit binaries +# +CC = gcc -pipe +CFLAGS = -m32 -fno-pie -std=c99 -fno-stack-protector -fno-builtin -Wall -Wstrict-prototypes -MD $(CPPFLAGS) +# CFLAGS += -O2 + +AS = as +ASFLAGS = --32 + +LD = ld +LDFLAGS = -melf_i386 -no-pie -nostdlib -L$(LIBDIR) + +AR = ar +#ARFLAGS = rvU +ARFLAGS = rsU + +# other programs we use +OBJDUMP = objdump +OBJCOPY = objcopy +NM = nm +READELF = readelf +PERL = perl + +# delete target files if there is an error, or if make is interrupted +.DELETE_ON_ERROR: + +# don't delete intermediate files +.PRECIOUS: %.o $(BUILDDIR)/boot/%.o $(BUILDDIR)/kernel/%.o \ + $(BUILDDIR)/lib/%.o $(BUILDDIR)/user/%.o + +# +# Update $(BUILDDIR)/.vars.X if variable X has changed since the last time +# 'make' was run. +# +# Rules that use variable X should depend on $(BUILDDIR)/.vars.X. If +# the variable's value has changed, this will update the vars file and +# force a rebuild of the rule that depends on it. +# + +$(BUILDDIR)/.vars.%: FORCE + echo "$($*)" | cmp -s $@ || echo "$($*)" > $@ + +.PRECIOUS: $(BUILDDIR)/.vars.% + +.PHONY: FORCE + +# +# Transformation rules - these ensure that all necessary compilation +# flags are specified +# +# Note use of 'cpp' to convert .S files to temporary .s files: this allows +# use of #include/#define/#ifdef statements. However, the line numbers of +# error messages reflect the .s file rather than the original .S file. +# (If the .s file already exists before a .S file is assembled, then +# the temporary .s file is not deleted. This is useful for figuring +# out the line numbers of error messages, but take care not to accidentally +# start fixing things by editing the .s file.) +# +# The .c.X rule produces a .X file which contains the original C source +# code from the file being compiled mixed in with the generated +# assembly language code. Can be helpful when you need to figure out +# exactly what C statement generated which assembly statements! +# + +.SUFFIXES: .S .b .X .i + +.c.X: + $(CC) $(CFLAGS) -g -c -Wa,-adhln $*.c > $*.X + +.c.s: + $(CC) $(CFLAGS) -S $*.c + +#.S.s: +# $(CPP) $(CPPFLAGS) -o $*.s $*.S + +#.S.o: +# $(CPP) $(CPPFLAGS) -o $*.s $*.S +# $(AS) $(ASFLAGS) -o $*.o $*.s -a=$*.lst +# $(RM) -f $*.s + +.s.b: + $(AS) $(ASFLAGS) -o $*.o $*.s -a=$*.lst + $(LD) $(LDFLAGS) -Ttext 0x0 -s --oformat binary -e begtext -o $*.b $*.o + +#.c.o: +# $(CC) $(CFLAGS) -c $*.c + +.c.i: + $(CC) -E $(CFLAGS) -c $*.c > $*.i + +# +# Location of the QEMU binary +# +QEMU = /home/course/csci352/bin/qemu-system-i386 + +# try to generate a unique GDB port +GDBPORT = $(shell expr `id -u` % 5000 + 25000) + +# QEMU's gdb stub command line changed in 0.11 +QEMUGDB = $(shell if $(QEMU) -help | grep -q '^-gdb'; \ + then echo "-gdb tcp::$(GDBPORT)"; \ + else echo "-s -p $(GDBPORT)"; fi) + +# options for QEMU +# +# run 'make' with -DQEMUEXTRA=xxx to add option 'xxx' when QEMU is run +# +# does not include a '-serial' option, as that may or may not be needed +QEMUOPTS = -drive file=disk.img,index=0,media=disk,format=raw $(QEMUEXTRA) + +######################################## +# RULES SECTION +######################################## + +# +# All the individual parts +# + +# +# We have a bit of a chicken/egg problem here. When we create the +# user.img file, a new version of include/userids.h is generated +# in build/new_userids.h; this is compared to the existing userids.h +# file, and if they differ, it is copied into include/userids.h. +# This, unfortunately, should trigger a rebuild of anything that +# includes <userids.h>, but that is all of the user/*.c files along +# with kernel/kernel.c. We could move the user.img creation earlier, +# which would automatically be incorporated into the build of the +# kernel, but it wouldn't automatically trigger recreating the +# userland stuff. We settle for having the build process tell the +# user that a rebuild is required. +# + +all: lib bootstrap kernel userland util user.img disk.img + +# Rules etc. for the various sections of the system +include lib/Make.mk +include boot/Make.mk +include user/Make.mk +include kernel/Make.mk +include util/Make.mk + +# +# Rules for building the disk image +# + +disk.img: $(BUILDDIR)/kernel/kernel.b $(BUILDDIR)/boot/boot user.img BuildImage + ./BuildImage -d usb -o disk.img -b $(BUILDDIR)/boot/boot \ + $(BUILDDIR)/kernel/kernel.b 0x10000 \ + user.img 0x30000 + +# +# Rules for running with QEMU +# + +# how to create the .gdbinit config file if we need it +.gdbinit: util/gdbinit.tmpl + sed "s/localhost:1234/localhost:$(GDBPORT)/" < $^ > $@ + +# "ordinary" gdb +gdb: + gdb -q -n -x .gdbinit + +# gdb with the super-fancy Text User Interface +gdb-tui: + gdb -q -n -x .gdbinit -tui + +qemu: disk.img + $(QEMU) -serial mon:stdio $(QEMUOPTS) + +qemu-nox: disk.img + $(QEMU) -nographic $(QEMUOPTS) + +qemu-gdb: disk.img .gdbinit + @echo "*** Now run 'gdb'." 1>&2 + $(QEMU) -serial mon:stdio $(QEMUOPTS) -S $(QEMUGDB) + +qemu-nox-gdb: disk.img .gdbinit + @echo "*** Now run 'gdb'." 1>&2 + $(QEMU) -nographic $(QEMUOPTS) -S $(QEMUGDB) + +# +# Create a printable namelist from the kernel file +# +# kernel.nl: only global symbols +# kernel.nll: all symbols +# + +kernel.nl: $(BUILDDIR)/kernel/kernel + nm -Bng $(BUILDDIR)/kernel/kernel.o | pr -w80 -3 > kernel.nl + +kernel.nll: $(BUILDDIR)/kernel/kernel + nm -Bn $(BUILDDIR)/kernel/kernel.o | pr -w80 -3 > kernel.nll + +# +# Generate a disassembly +# + +kernel.dis: $(BUILDDIR)/kernel/kernel + objdump -d $(BUILDDIR)/kernel/kernel > kernel.dis + +# +# Cleanup etc. +# + +clean: + rm -rf $(BUILDDIR) .gdbinit *.nl *.nll *.lst *.i *.X *.dis + +realclean: clean + rm -f LOG *.img $(UTIL_BIN) + +# +# Automatically generate dependencies for header files included +# from C source files. +# +$(BUILDDIR)/.deps: $(foreach dir, $(SUBDIRS), $(wildcard $(BUILDDIR)/$(dir)/*.d)) + @mkdir -p $(@D) + $(PERL) util/mergedep.pl $@ $^ + +-include $(BUILDDIR)/.deps + +.PHONY: all clean realclean |