#
# 在UltraEdit下注釋
# 2010/2/9
#
#
# if you want the ram-disk device, define this to be the
# size in blocks.
#
RAMDISK = #-DRAMDISK=512
#
#8086匯編編譯器和連接器. -0生成8086目標程序;-a生成與gas和gld部分兼容的代碼???zzz
#
AS86 =as86 -0 -a
LD86 =ld86 -0
#
#GNU匯編編譯器和連接器
#
AS =gas
LD =gld
#
#GNU連接器gld運行時用到的選項
#-s 輸出文件中省略所有的符號信息
#-x 刪除所有的局部符號
#-M 在標準輸出設備(顯示器)上打印連接映象(link map).
#連接映象:由連接程序產生的一種內存地址映象，其中列出了程序裝入到內存中的位置信息，具體有如下信息：
#目標文件及符號信息映射到內存中的位置
#公共符號如何放置
#連接中包含的所有文件成員及其引用的符號
#
LDFLAGS =-s -x -M
#
#gcc是GNU C程序編譯器，對于UNIX類的腳本程序而言，
#在引用定義的標識符時，需在前面加上$符號并用括號括住標識符
#
CC =gcc $(RAMDISK)
#
#GCC的選項.
#-Wall 打印所有的警告信息
#-O 對代碼進行優化
#-fstrength-reduce 優化循環語句
#-msting-insns Linus在學習gcc編譯器時為gcc增加的選項，
#用于gcc-1.40在復制結構等操作時使用386CPU的字符串指令，可以去掉
#
CFLAGS =-Wall -O -fstrength-reduce -fomit-frame-pointer \
-fcombine-regs -mstring-insns
#
#CPP是gcc的預處理程序
#-nostdinc -Iinclude 不要搜索標準的頭文件目錄中的文件，
#而是使用-I選項指定的目錄或者是在當前的目錄里搜索頭文件
#
CPP =cpp -nostdinc -Iinclude
#
# ROOT_DEV specifies the default root-device when making the image.
# ROOT_DEV 指定在創建內核映象文件時所使用的默認根文件系統所在的設備
# This can be either FLOPPY, /dev/xxxx or empty, in which case the
# default of /dev/hd6 is used by 'build'.
#
ROOT_DEV=/dev/hd6
#
# kernel 目錄,mm目錄,fs目錄所產生的目標代碼文件。
# 為了方便引用，在這里將它們用ARCHIVES(歸檔文件) 標識符表示
#
ARCHIVES=kernel/kernel.o mm/mm.o fs/fs.o
#
# 塊和字符設備庫文件
# .a表示該文檔是個歸檔文檔，也即包含有許多可執行二進制代碼子程序集合的庫文件，通常是用GNU的ar程序生成。
# ar是GNU的二進制文件處理程序，用于創建、修改以及從歸檔文件中抽取文件
#
DRIVERS =kernel/blk_drv/blk_drv.a kernel/chr_drv/chr_drv.a
#
# 數學運算庫文件
#
MATH =kernel/math/math.a
#
# 由lib/目錄中生成的通用庫文件
#
LIBS =lib/lib.a
#
# make老式的隱式后綴規則
# 指示make利用下面的命令將所有的.c文件編譯生成.s匯編程序
# ':'表示下面是該規則的命令
#
.c.s:
#
# 指使gcc采用前面CFLAGS所指定的選項以及僅使用include/目錄中的頭文件，
# 在適當的編譯后不進行匯編就停止(-S)，從而產生與輸入的各個C文件對應的匯編語言形式的代碼文件。
# 默認情況下所產生的匯編程序文件是原C文件名去掉.c而加上.s后綴。
# -o表示其后是輸出文件的形式。
# 其中$*.s(或$@)是自動目標變量,$<代表第一個先決條件，這里即是符合條件*.c的文件。
#
$(CC) $(CFLAGS) \
-nostdinc -Iinclude -S -o $*.s $<
#
# 將所有.s匯編程序文件編譯成.o目標文件。下一條是實現該操作的具體命令
#
.s.o:
#
# 使用gas編譯器將匯編程序編譯成.o目標文件。-c表示只編譯或匯編，但不進行連接操作
#
$(AS) -c -o $*.o $<
.c.o:
#
# 使用gcc將c語言編譯成目標文件但不連接
#
$(CC) $(CFLAGS) \
-nostdinc -Iinclude -c -o $*.o $<
#
# all表示創建Makefile所知的最頂層目標。這里即是image文件
#
all: Image
#
# 第一行說明：目標文件(Image文件)是由分號后面的4個元素產生
# 下面兩行是執行的命令
# 第一行表示使用tools目錄下的build工具程序將bootsect,setup,system文件以$(ROOT_DEV)為根文件系統設備組裝成內核映象文件Image
# 第二行的sysn同步命令是迫使緩沖塊數據立即寫盤并更新超級塊
#
Image: boot/bootsect boot/setup tools/system tools/build
tools/build boot/bootsect boot/setup tools/system $(ROOT_DEV) > Image
sync
#
# 表明disk這個目標要由Image產生
# dd為UNIX標準命令：復制一個文件，根據選項進行轉換和格式化
# bs=表示一次讀/寫的字節數,if=表示輸入的文件.of=表示輸出到的文件
# /dev/PS0指第一個軟盤驅動器(設備文件)
#
disk: Image
dd bs=8192 if=Image of=/dev/PS0
tools/build: tools/build.c
$(CC) $(CFLAGS) \
-o tools/build tools/build.c
#
# 利用上面的.s.o規則生成head.o文件
#
boot/head.o: boot/head.s
#
# 最后的>System.map表示gld需要將連接映象重定向存放在System.map文件中
#
tools/system: boot/head.o init/main.o \
$(ARCHIVES) $(DRIVERS) $(MATH) $(LIBS)
$(LD) $(LDFLAGS) boot/head.o init/main.o \
$(ARCHIVES) \
$(DRIVERS) \
$(MATH) \
$(LIBS) \
-o tools/system > System.map
#
# 數學協處理函數文件math.a由下一行上的命令實現
# 進入kernel/math/目錄，運行make工具程序
#
kernel/math/math.a:
(cd kernel/math; make)
#
# 塊設備函數文件 blk_drv.a
#
kernel/blk_drv/blk_drv.a:
(cd kernel/blk_drv; make)
#
# 字符備函數文件 chr_drv.a
#
kernel/chr_drv/chr_drv.a:
(cd kernel/chr_drv; make)
#
# 內核目標模塊kernel.o
#
kernel/kernel.o:
(cd kernel; make)
#
# 內核管理模塊mm.o
#
mm/mm.o:
(cd mm; make)
#
# 文件系統目標模塊fs.o
#
fs/fs.o:
(cd fs; make)
#
# 庫函數lib.a
#
lib/lib.a:
(cd lib; make)
#
# 用8086匯編和連接器對setup.s文件進行編譯生成setup文件
# -s表示要取出目標文件中的符號信息
#
boot/setup: boot/setup.s
$(AS86) -o boot/setup.o boot/setup.s
$(LD86) -s -o boot/setup boot/setup.o
#
# 生成bootsect.o磁盤引導塊
#
boot/bootsect: boot/bootsect.s
$(AS86) -o boot/bootsect.o boot/bootsect.s
$(LD86) -s -o boot/bootsect boot/bootsect.o
#
# 在bootsect.s程序開口添加一行有關system文件長度信息
# 首先生成含有 "SYSSIZE = 文件實際長度"一行信息的tmp.s文件，然后將bootsect.s文件添加在其后。
# 取得system長度的方法是：
# 利用ls命令對system文件進行長列表顯示
# 用grep命令取得列表上文件字節數字段信息，并定向保存在tmp.s臨時文件中
# cut命令用于剪切字符串
# tr用于去除行尾的回車符
# (實際長度 + 15)/16用于獲得'節'表示的長度信息，1節=16字節
#
tmp.s: boot/bootsect.s tools/system
(echo -n "SYSSIZE = (";ls -l tools/system | grep system \
| cut -c25-31 | tr '\012' ' '; echo "+ 15 ) / 16") > tmp.s
cat boot/bootsect.s >> tmp.s
#
# 當執行"make clean"時，就會執行以下命令，去除所有編譯連接生成的文件
# "rm"是文件刪除命令，選項-f含義是忽略不存在的文件，并且不顯示刪除信息
# (cd mm;make clean)表示進入mm/目錄，執行該目錄Makefile文件中的clean規則
clean:
rm -f Image System.map tmp_make core boot/bootsect boot/setup
rm -f init/*.o tools/system tools/build boot/*.o
(cd mm;make clean)
(cd fs;make clean)
(cd kernel;make clean)
(cd lib;make clean)
#
# 該規則首先執行上面的clean規則，然后對linux/目錄進行壓縮，生成backup.Z壓縮文件。
# "cd .."表示退到linux/的上一級(父)目錄
# "tar cf - linux"表示對linux/目錄執行tar歸檔程序，-cf表示需要創建新的歸檔文件
# "| compress -"表示將tar程序的執行通過管道操作('|')傳遞給壓縮程序compress，并將壓縮程序的輸出存成backup.Z文件
# sysn同步命令迫使緩沖塊數據立即寫盤并更新超級塊
#
backup: clean
(cd .. ; tar cf - linux | compress - > backup.Z)
sync
#
# ???zzz
# 該規則用于各文件的依賴關系。創建這些依賴關系是為了給make用來確定是否需要重建一個目標對象
# 比如當某個文件頭被改動過后，make就通過生成的依賴關系，重新編譯與該頭文件有關的所有*.c文件。
# 具體方法如下：
# 使用字符串編輯程序sed對Makefile文件(這里即是自己)進行處理，
# 輸出為刪除Makefile文件中"### Dependencies"行后面的所有行，并生成tmp_make臨時文件
# 然后對init/目錄下的每一個C文件(其實只有一個C文件main.c)執行gcc預處理操作
# -M標志告訴預處理程序輸出描述每個目標文件相關性的規則，并且這些規則符合make語法
# 對于每一個源文件，預處理程序輸出一個make規則，其結果形式是相應源程序文件的目標文件名加上其依賴關系--該源文件中包含的所有頭文件列表
# "$$i"實際上是$($i)的意思，"$i"是前面shell變量的值
# 然后把預處理結果都加到臨時文件tmp_make中，然后將該臨時文件復制成新的makefile文件
#
dep:
sed '/\#\#\# Dependencies/q' < Makefile > tmp_make
(for i in init/*.c;do echo -n "init/";$(CPP) -M $$i;done) >> tmp_make
cp tmp_make Makefile
(cd fs; make dep)
(cd kernel; make dep)
(cd mm; make dep)
### Dependencies:
init/main.o : init/main.c include/unistd.h include/sys/stat.h \
include/sys/types.h include/sys/times.h include/sys/utsname.h \
include/utime.h include/time.h include/linux/tty.h include/termios.h \
include/linux/sched.h include/linux/head.h include/linux/fs.h \
include/linux/mm.h include/signal.h include/asm/system.h include/asm/io.h \
include/stddef.h include/stdarg.h include/fcntl.h