From 9b1f505537ef13c24a63e66944ed9a7a83d5e9d6 Mon Sep 17 00:00:00 2001 From: ridethepig Date: Sun, 2 Oct 2022 12:54:35 +0800 Subject: [PATCH] before ch3 --- 2020301918-李懋良-试点班第2个报告.docx | Bin 166052 -> 0 bytes Makefile | 156 +++++++--- boot/Makefrag | 31 ++ boot.asm => boot/boot.asm | 21 +- boot/inc/fat12.inc | 301 +++++++++++++++++++ boot/inc/load.inc | 23 ++ boot/inc/pm.inc | 324 ++++++++++++++++++++ boot/linker.ld | 30 ++ boot/loader.asm | 220 ++++++++++++++ boot/loadkernel.c | 164 ++++++++++ i386-32bit.xml | 192 ------------ inc/cmatrix.h | 14 + inc/protect.h | 19 ++ inc/string.h | 9 + inc/terminal.h | 43 +++ inc/type.h | 53 ++++ kern/Makefrag | 42 +++ kern/cmatrix.c | 203 +++++++++++++ kern/kernel.asm | 73 +++++ kern/kprintf.asm | 18 ++ kern/start.c | 56 ++++ lab3-finish.png | Bin 0 -> 24376 bytes lib/string.c | 37 +++ lib/terminal.c | 18 ++ loader.asm | 395 ------------------------- mergedep.pl | 86 ++++++ target.xml | 1 - 实验3-v0.2.md | 293 ++++++++++++++++++ 实验二-v0.3.md | 149 ---------- 29 files changed, 2195 insertions(+), 776 deletions(-) delete mode 100644 2020301918-李懋良-试点班第2个报告.docx create mode 100644 boot/Makefrag rename boot.asm => boot/boot.asm (94%) create mode 100644 boot/inc/fat12.inc create mode 100644 boot/inc/load.inc create mode 100644 boot/inc/pm.inc create mode 100644 boot/linker.ld create mode 100644 boot/loader.asm create mode 100644 boot/loadkernel.c delete mode 100644 i386-32bit.xml create mode 100644 inc/cmatrix.h create mode 100644 inc/protect.h create mode 100644 inc/string.h create mode 100644 inc/terminal.h create mode 100644 inc/type.h create mode 100644 kern/Makefrag create mode 100644 kern/cmatrix.c create mode 100644 kern/kernel.asm create mode 100644 kern/kprintf.asm create mode 100644 kern/start.c create mode 100644 lab3-finish.png create mode 100644 lib/string.c create mode 100644 lib/terminal.c delete mode 100644 loader.asm create mode 100644 mergedep.pl delete mode 100644 target.xml create mode 100644 实验3-v0.2.md delete mode 100644 实验二-v0.3.md diff --git a/2020301918-李懋良-试点班第2个报告.docx b/2020301918-李懋良-试点班第2个报告.docx deleted file mode 100644 index 3abd64c5638827baf8391b552f19c06e541b8b16..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 166052 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%0A!H(AS0+Z|%4BYqEHjJK_+!70)|I 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%0D?f>{$1VWTPDWAp`%_ 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 $@ +.PHONY: FORCE + +# 导入两个文件，两个文件分别编写，方便管理，也让主makefile更加清晰 +include boot/Makefrag +include kern/Makefrag + +# FAT12镜像文件 +IMAGE = $(OBJDIR)/kern/a.img + +# 最后将boot.bin, loader.bin, kernel.bin组装成a.img +$(IMAGE): $(OBJDIR)/boot/boot.bin $(OBJDIR)/boot/loader.bin $(OBJDIR)/kern/kernel.bin + @dd if=/dev/zero of=$@ bs=512 count=2880 + @mkfs.vfat $@ + @dd if=$(OBJDIR)/boot/boot.bin of=$@ bs=512 count=1 conv=notrunc + @sudo mount -o loop $@ /mnt + @sudo cp $(OBJDIR)/boot/loader.bin /mnt -v + @sudo cp $(OBJDIR)/kern/kernel.bin /mnt -v @sudo umount /mnt -clean : - @rm -f $(BOOT_BIN) $(LDR_BIN) +all: $(IMAGE) -$(BOOT_BIN) : $(BOOT) - @nasm $< -o $@ +clean: + @rm -rf $(OBJDIR) -$(LDR_BIN) : $(LDR) - @nasm $< -o $@ - - -run: +run: $(IMAGE) @qemu-system-i386 \ - -boot order=c \ - -drive file=a.img,format=raw \ + -boot order=a \ + -drive file=$(IMAGE),format=raw \ -gdb: +gdb: $(IMAGE) @qemu-system-i386 \ - -boot order=c \ - -drive file=a.img,format=raw \ - -S -s + -boot order=a \ + -drive file=$(IMAGE),format=raw \ + -s -S \ -monitor: - @gdb \ - -ex 'set tdesc filename target.xml' \ - -ex 'target remote localhost:1234' +gdb-no-graphic: $(IMAGE) + @qemu-system-i386 \ + -nographic \ + -boot order=a \ + -drive file=$(IMAGE),format=raw \ + -s -S \ +# 调试的内核代码elf +KERNBIN := $(OBJDIR)/kern/kernel.bin + +monitor: $(KERNBIN) + @gdb \ + -ex 'set confirm off' \ + -ex 'target remote localhost:1234' \ + -ex 'file $(KERNBIN)' + +# 测试%s +tests: + @make DEFS=-DTESTS --no-print-directory + +# xv6黑科技，获取头文件依赖，如果头文件更新则会重新编译所有文件 +$(OBJDIR)/.deps: $(foreach dir, $(OBJDIRS), $(wildcard $(OBJDIR)/$(dir)/*.d)) + @mkdir -p $(@D) + @perl mergedep.pl $@ $^ + +-include $(OBJDIR)/.deps + +.PHONY: all clean run gdb gdb-no-graphic monitor diff --git a/boot/Makefrag b/boot/Makefrag new file mode 100644 index 0000000..8e12f00 --- /dev/null +++ b/boot/Makefrag @@ -0,0 +1,31 @@ +# +# makefile的boot部分， +# 将会导入到根目录的makefile文件 +# + +OBJDIRS += boot + +LOADER_OBJS := $(OBJDIR)/boot/loader.o $(OBJDIR)/boot/loadkernel.o +LOADER_LINKER := boot/linker.ld + +# 根据源文件pattern判断编译的方式 +$(OBJDIR)/boot/%.o: boot/%.c + @echo + cc $< + @mkdir -p $(@D) + @$(CC) $(CFLAGS) -fno-pie -c -o $@ $< + +$(OBJDIR)/boot/%.o: boot/%.asm + @echo + as obj $< + @mkdir -p $(@D) + @$(AS) -f elf -o $@ $< + +# 对于boot，它是特殊的，需要特殊编译 +$(OBJDIR)/boot/boot.bin: boot/boot.asm + @echo + as bin $< + @mkdir -p $(@D) + @$(AS) -o $@ $< +# loader通过一个特定的脚本进行链接，反正可以先不管，将核心放到内核代码上来 +$(OBJDIR)/boot/loader.bin: $(LOADER_OBJS) $(LOADER_LINKER) + @echo + ld $@ + @mkdir -p $(@D) + @$(LD) $(LDFLAGS) -s -T $(LOADER_LINKER) --oformat binary -o $@ $(LOADER_OBJS) diff --git a/boot.asm b/boot/boot.asm similarity index 94% rename from boot.asm rename to boot/boot.asm index c3f7cd8..f88b1df 100644 --- a/boot.asm +++ b/boot/boot.asm @@ -134,13 +134,27 @@ DispDot: ; cx: 读入多少个扇区 ; (es:bx): 读入的缓冲区的起始地址 ; -; 中断调用传入的参数规范请参考本节实验指导书的实验参考LBA部分 +; 这里使用的是bios的扩展读功能,写成C语言的结构体是这样的 +; struct buffer_packet { +; short buffer_packet_size; /* struct's size（可以为 0x10 或 0x18）*/ +; short sectors; /* 读多少个 sectors */ +; char *buffer; /* buffer address */ +; long long start_sectors; /* 从哪个 sector 开始读 */ +; long long *l_buffer; /* 64 位的 buffer address 这个我们不管！！！*/ +; }; +; 需要注意的是，buffer参数的高16位填充的是段地址(es)，低16位填充的是偏移量(bx) +; +; int 13h扩展读功能要求 +; ah = 0x42 +; dl = 驱动号 +; (ds:si)是一个指向buffer_packet的指针 +; 中断结束后有一个状态返回，具体请STFW & RTFM ReadSector: push bp mov bp, sp pusha - mov si, BufferPacket ; ds:si 指向的是BufferPacket的首地址 + mov si, BufferPacket mov word [si + 0], 010h ; buffer_packet_size mov word [si + 2], cx ; sectors mov word [si + 4], bx ; buffer-offset @@ -155,8 +169,7 @@ ReadSector: popa pop bp ret - -.ReadFail +.ReadFail: mov dh, 2 call DispStr jmp $ ; 如果cf位置1，就意味着读入错误，这个时候建议直接开摆 diff --git a/boot/inc/fat12.inc b/boot/inc/fat12.inc new file mode 100644 index 0000000..86e854a --- /dev/null +++ b/boot/inc/fat12.inc @@ -0,0 +1,301 @@ + ; 下面是 FAT12 磁盘的头 + ; 正常情况下，boot是要对磁盘头的数据进行解析的 + ; 但是出于简单考虑，直接将磁盘头硬编码进来，如果要分析可就太麻烦了，汇编本来就看的头大，还搞那么多未知元 + ; 里面很多信息实际上在boot里用不上，请各位别对里面的参数纠结太多，用到了再查也不迟 + BS_OEMName DB 'ForrestY' ; OEM String, 必须 8 个字节 + BPB_BytsPerSec DW 512 ; 每扇区字节数 + BPB_SecPerClus DB 1 ; 每簇多少扇区 + BPB_RsvdSecCnt DW 1 ; Boot 记录占用多少扇区 + BPB_NumFATs DB 2 ; 共有多少 FAT 表 + BPB_RootEntCnt DW 224 ; 根目录文件数最大值 + BPB_TotSec16 DW 2880 ; 逻辑扇区总数 + BPB_Media DB 0xF0 ; 媒体描述符 + BPB_FATSz16 DW 9 ; 每FAT扇区数 + BPB_SecPerTrk DW 18 ; 每磁道扇区数 + BPB_NumHeads DW 2 ; 磁头数(面数) + BPB_HiddSec DD 0 ; 隐藏扇区数 + BPB_TotSec32 DD 0 ; 如果 wTotalSectorCount 是 0 由这个值记录扇区数 + BS_DrvNum DB 80h ; 中断 13 的驱动器号 + BS_Reserved1 DB 0 ; 未使用 + BS_BootSig DB 29h ; 扩展引导标记 (29h) + BS_VolID DD 0 ; 卷序列号 + BS_VolLab DB 'OrangeS0.02' ; 卷标, 必须 11 个字节 + BS_FileSysType DB 'FAT12 ' ; 文件系统类型, 必须 8个字节 + + ; 文件系统信息存放完毕后后面的内容就可以自由调整了，撒花！ + +; 原先Orange的代码是按照 主函数->常量->变量->子函数的顺序给出，逻辑很乱 +; 这次尝试用C语言风格按照 常量->变量->子函数->主函数的顺序给出，更加符合正常的编程逻辑 +;============================================================================ +;常量 +;================================================================================================ + +; 这部分请看手册 +RootDirSectors equ 14 +SectorNoOfRootDirectory equ 19 +SectorNoOfFAT1 equ 1 +DeltaSectorNo equ 31 +;================================================================================================ + +;============================================================================ +;变量 +;---------------------------------------------------------------------------- +LeftRootDirSectors dw RootDirSectors ; 还未搜索的根目录扇区数 +RootDirSectorNow dw SectorNoOfRootDirectory ; 目前正在搜索的根目录扇区 + +;============================================================================ +;字符串 +;---------------------------------------------------------------------------- +KernelFileName db "KERNEL BIN", 0 ; KERNEL.BIN 的文件名(为什么中间有空格请RTFM) +; 为简化代码, 下面每个字符串的长度均为 MessageLength +MessageLength equ 9 +BootMessage: db "Booting " ; 9字节, 不够则用空格补齐. 序号 0 +Message1 db "Ready. " ; 9字节, 不够则用空格补齐. 序号 1 +Message2 db "No KERNEL" ; 9字节, 不够则用空格补齐. 序号 2 +;============================================================================ +; 汇编并不像高级语言一样规范，寄存器忘保存，调用子函数后发现值变了可太痛苦了 +; 所以为了减少这份痛苦，这里的所有函数都保证函数除了返回值寄存器其余的主要寄存器都有保护现场 +; 保证调用之后不用担心寄存器值变了 +;---------------------------------------------------------------------------- +; 函数名: Panic +;---------------------------------------------------------------------------- +; 作用: +; 当遇到一些程序不可解决恢复的事，就建议直接开摆！输出“No KERNEL”后就地死循环开摆！ +Panic: + mov dh, 2 + call DispStr + jmp $ + +;---------------------------------------------------------------------------- +; 函数名: DispStr +;---------------------------------------------------------------------------- +; 作用: +; 显示一个字符串, 函数开始时 dh 中应该是字符串序号(从0开始) +DispStr: + pusha + push es + + mov ax, MessageLength + mul dh + add ax, BootMessage + mov bp, ax + mov ax, ds + mov es, ax ; ES:BP = 串地址 + mov cx, MessageLength ; CX = 串长度 + mov ax, 01301h ; AH = 13, AL = 01h + mov bx, 0007h ; 页号为0(BH = 0) 黑底白字(BL = 07h) + mov dl, 0 + int 10h ; RTFM + + pop es + popa + ret + +;---------------------------------------------------------------------------- +; 函数名: DispDot +;---------------------------------------------------------------------------- +; 作用: +; 打印一个点 +DispDot: + pusha + + mov ah, 0Eh ; `. 每读一个扇区就在 "Booting " 后面 + mov al, '.' ; | 打一个点, 形成这样的效果: + mov bl, 0Fh ; | Booting ...... + int 10h ; / + + popa + ret + +;---------------------------------------------------------------------------- +; 函数名: ReadSector +;---------------------------------------------------------------------------- +; 作用: +; 将磁盘的数据读入到内存中 +; ax: 从哪个扇区开始 +; cx: 读入多少个扇区 +; (es:bx): 读入的缓冲区的起始地址 +; +; 这里使用的是bios的扩展读功能,写成C语言的结构体是这样的 +; struct buffer_packet { +; short buffer_packet_size; /* struct's size（可以为 0x10 或 0x18）*/ +; short sectors; /* 读多少个 sectors */ +; char *buffer; /* buffer address */ +; long long start_sectors; /* 从哪个 sector 开始读 */ +; long long *l_buffer; /* 64 位的 buffer address 这个我们不管！！！*/ +; } buffer; +; 需要注意的是，buffer参数的高4位填充的是段地址(es)，低4位填充的是偏移量(bx) +; +; int 13h扩展读功能要求 +; ah = 0x42 +; dl = 驱动号 +; (ds:si)是一个指向buffer的指针 +; 中断结束后有一个状态返回，具体请STFW & RTFM +ReadSector: + pusha + + push dword 0 + push word 0 + push word ax ; start_sectors + push word es + push word bx ; buffer + push word cx ; sectors + push word 10h ; buffer_packet_size + + mov si, sp ; si <- 指向buffer的地址 + mov dl, [BS_DrvNum] ; 驱动号 + mov ah, 42h ; 扩展读 + int 13h + jc Panic ; 如果cf位置1，就意味着读入错误，这个时候建议直接开摆 + + add sp, 10h + + popa + ret + +;---------------------------------------------------------------------------- +; 函数名: GetNextCluster +;---------------------------------------------------------------------------- +; 作用: +; ax存放的是当前的簇(cluster)号，根据当前的簇号在fat表里查找，找到下一个簇的簇号，并将返回值存放在ax +GetNextCluster: + pusha + mov bp, sp + + mov bx, 3 ; 一个FAT项长度为1.5字节 + mul bx + mov bx, 2 ; ax = floor(clus_number * 1.5) + div bx ; 这个时候ax里面放着的是FAT项基地址相对于FAT表开头的字节偏移量 + ; 如果clus_number为奇数，则dx为1，否则为0 + push dx ; 临时保存奇数标识信息 + mov dx, 0 ; 下面除法要用到 + mov bx, [BPB_BytsPerSec] + div bx ; dx:ax / BPB_BytsPerSec + ; ax <- 商 (基地址在FAT表的第几个扇区) + ; dx <- 余数 (基地址在扇区内的偏移) + mov bx, 0 ; bx <- 0 于是, es:bx = BaseOfKernelFile:0 + add ax, SectorNoOfFAT1 ; 此句之后的 ax 就是FAT项所在的扇区号 + mov cx, 2 ; 读取FAT项所在的扇区, 一次读两个, 避免在边界 + call ReadSector ; 发生错误, 因为一个FAT项可能跨越两个扇区 + + mov bx, dx ; 将偏移量搬回bx + mov ax, [es:bx] + pop bx ; 取回奇数标识信息 + cmp bx, 0 ; 如果是第奇数个FAT项还得右移四位，所以这也是为什么FAT12这么辣鸡的原因， + jz .EvenCluster ; 诶……徒增那么多判断，看看隔壁FAT16，FAT32，exFAT，不会发生FAT项跨扇区的情况，也不需要判断第奇偶个 + shr ax, 4 ; 可能是微软(FAT是微软创建的)第一个亲儿子的原因，有它的历史局限性 +.EvenCluster: + and ax, 0FFFh ; 读完需要与一下，因为高位是未定义的 + mov word [bp + 14], ax ; 这里用了一个技巧，这样在popa的时候ax也顺便更新了 + + popa + ret + +;---------------------------------------------------------------------------- +; 函数名: StringCmp +;---------------------------------------------------------------------------- +; 作用: +; 比较 ds:si 和 es:di 处的字符串（比较长度为11，仅为kernel.bin所用） +; 如果两个字符串相等ax返回1，否则ax返回0 +StringCmp: + pusha + mov bp, sp + + mov cx, 11 ; 比较长度为11 + cld ; 清位保险一下 +.STARTCMP: + lodsb ; ds:si -> al + cmp al, byte [es:di] + jnz .DIFFERENT + inc di + dec cx + cmp cx, 0 + jz .SAME + jmp .STARTCMP +.DIFFERENT: + mov word [bp + 14], 0 ; 这里用了一个技巧，这样在popa的时候ax也顺便更新了 + jmp .ENDCMP +.SAME: + mov word [bp + 14], 1 ; 下一步就是ENDCMP了，就懒得jump了 +.ENDCMP: + popa + ret +;---------------------------------------------------------------------------- +; 函数名: LoadKernelFile +;---------------------------------------------------------------------------- +; 作用: +; 将kernel的elf文件加载到BaseOfKernelFile:OffsetOfKernelFile +LoadKernelFile: + pusha + push es + + mov ax, BaseOfKernelFile + mov es, ax ; es <- BaseOfKernelFile + + ; 清屏 + mov ax, 0600h ; AH = 6, AL = 0h + mov bx, 0700h ; 黑底白字(BL = 07h) + mov cx, 0 ; 左上角: (0, 0) + mov dx, 0184fh ; 右下角: (80, 50) + int 10h ; int 10h + + mov dh, 0 ; "Booting " + call DispStr ; 显示字符串 + + mov ah, 0 ; ┓ + mov dl, [BS_DrvNum] ; ┣ 硬盘复位 + int 13h ; ┛ + +; 下面在 A 盘的根目录寻找 KERNEL.BIN +.FindKernelInRootDir: + mov ax, [RootDirSectorNow] ; ax <- 现在正在搜索的扇区号 + mov bx, OffsetOfKernelFile ; es:bx = BaseOfKernelFile:OffsetOfKernelFile + mov cx, 1 + call ReadSector + + mov si, KernelFileName ; ds:si -> "KERNEL BIN" + mov di, OffsetOfKernelFile ; es:di -> BaseOfKernelFile:400h = BaseOfKernelFile*10h+400h + mov dx, 10h ; 32(目录项大小) * 16(dx) = 512(BPB_BytsPerSec) + +.CompareFilename: + call StringCmp + cmp ax, 1 + jz .KernelFound ; ax == 1 -> 比对成了 + dec dx + cmp dx, 0 + jz .GotoNextRootDirSector ; 该扇区的所有目录项都探索完了，去探索下一个扇区 + add di, 20h ; 32 -> 目录项大小 + jmp .CompareFilename + +.GotoNextRootDirSector: + inc word [RootDirSectorNow] ; 改变正在搜索的扇区号 + dec word [LeftRootDirSectors] ; ┓ + cmp word [LeftRootDirSectors], 0 ; ┣ 判断根目录区是不是已经读完 + jz Panic ; ┛ 如果读完表示没有找到 KERNEL.BIN，就直接开摆 + jmp .FindKernelInRootDir + +.KernelFound: ; 找到 KERNEL.BIN 后便来到这里继续 + add di, 01Ah ; 0x1a = 28 这个 28 在目录项里偏移量对应的数据是起始簇号（RTFM） + mov dx, word [es:di] ; 起始簇号占2字节，读入到dx里 + mov bx, OffsetOfKernelFile ; es:bx = BaseOfKernelFile:OffsetOfKernelFile + +.LoadKernel: + call DispDot + mov ax, dx ; ax <- 数据区簇号 + add ax, DeltaSectorNo ; 数据区的簇号需要加上一个偏移量才能得到真正的扇区号 + mov cx, 1 ; 一个簇就仅有一个扇区 + call ReadSector + mov ax, dx ; ax <- 数据区簇号（在之前ax = 数据区簇号+偏移量） + call GetNextCluster ; 根据数据区簇号获取文件下一个簇的簇号 + mov dx, ax ; dx <- 下一个簇的簇号 + cmp dx, 0FFFh ; 判断是否读完了（根据文档理论上dx只要在0xFF8~0xFFF都行，但是这里直接偷懒只判断0xFFF） + jz .LoadFinished + add bx, [BPB_BytsPerSec] ; 别忘了更新bx，否则你会发现文件发生复写的情况（指来回更新BaseOfKernelFile:OffsetOfKernelFile ~ BaseOfKernelFile:OffsetOfKernelFile+0x200） + jmp .LoadKernel +.LoadFinished: + mov dh, 1 ; "Ready." + call DispStr ; 显示字符串 + + pop es + popa + ret \ No newline at end of file diff --git a/boot/inc/load.inc b/boot/inc/load.inc new file mode 100644 index 0000000..243cb86 --- /dev/null +++ b/boot/inc/load.inc @@ -0,0 +1,23 @@ + +; ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ +; load.inc +; ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ +; Forrest Yu, 2005 +; ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ + +BaseOfLoader equ 09000h ; LOADER.BIN 被加载到的位置 ---- 段地址 +OffsetOfLoader equ 0400h ; LOADER.BIN 被加载到的位置 ---- 偏移地址 +LoaderSegPhyAddr equ 90000h ; LOADER.BIN 被加载到的位置 ---- 物理地址 (= Base * 10h) + +BaseOfKernelFile equ 08000h ; KERNEL.BIN 被加载到的位置 ---- 段地址 +OffsetOfKernelFile equ 0400h ; KERNEL.BIN 被加载到的位置 ---- 偏移地址 +KernelSegPhyAddr equ 80000h ; KERNEL.BIN 被加载到的位置 ---- 偏移地址 (= Base * 10h) + +; 注意：1、必须与 MAKEFILE 中参数 -Ttext 的值相等!! +; 2、这是个地址而非仅仅是个偏移，如果 -Ttext 的值为 0x400400，则它的值也应该是 0x400400。 +KernelEntryPointPhyAddr equ 030400h + +BaseOfStack equ OffsetOfLoader + +PageDirBase equ 200000h ; 页目录开始地址: 2M +PageTblBase equ 201000h ; 页表开始地址: 2M + 4K \ No newline at end of file diff --git a/boot/inc/pm.inc b/boot/inc/pm.inc new file mode 100644 index 0000000..94e1ebf --- /dev/null +++ b/boot/inc/pm.inc @@ -0,0 +1,324 @@ + +; ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ +; pm.inc +; ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ +; Forrest Yu, 2005 +; ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ + + +; 描述符图示 + +; 图示一 +; +; ------ ┏━━┳━━┓高地址 +; ┃ 7 ┃ 段 ┃ +; ┣━━┫ ┃ +; 基 +; 字节 7 ┆ ┆ ┆ +; 址 +; ┣━━┫ ② ┃ +; ┃ 0 ┃ ┃ +; ------ ┣━━╋━━┫ +; ┃ 7 ┃ G ┃ +; ┣━━╉──┨ +; ┃ 6 ┃ D ┃ +; ┣━━╉──┨ +; ┃ 5 ┃ 0 ┃ +; ┣━━╉──┨ +; ┃ 4 ┃ AVL┃ +; 字节 6 ┣━━╉──┨ +; ┃ 3 ┃ ┃ +; ┣━━┫ 段 ┃ +; ┃ 2 ┃ 界 ┃ +; ┣━━┫ 限 ┃ +; ┃ 1 ┃ ┃ +; ┣━━┫ ② ┃ +; ┃ 0 ┃ ┃ +; ------ ┣━━╋━━┫ +; ┃ 7 ┃ P ┃ +; ┣━━╉──┨ +; ┃ 6 ┃ ┃ +; ┣━━┫ DPL┃ +; ┃ 5 ┃ ┃ +; ┣━━╉──┨ +; ┃ 4 ┃ S ┃ +; 字节 5 ┣━━╉──┨ +; ┃ 3 ┃ ┃ +; ┣━━┫ T ┃ +; ┃ 2 ┃ Y ┃ +; ┣━━┫ P ┃ +; ┃ 1 ┃ E ┃ +; ┣━━┫ ┃ +; ┃ 0 ┃ ┃ +; ------ ┣━━╋━━┫ +; ┃ 23 ┃ ┃ +; ┣━━┫ ┃ +; ┃ 22 ┃ ┃ +; ┣━━┫ 段 ┃ +; +; 字节 ┆ ┆ 基 ┆ +; 2, 3, 4 +; ┣━━┫ 址 ┃ +; ┃ 1 ┃ ① ┃ +; ┣━━┫ ┃ +; ┃ 0 ┃ ┃ +; ------ ┣━━╋━━┫ +; ┃ 15 ┃ ┃ +; ┣━━┫ ┃ +; ┃ 14 ┃ ┃ +; ┣━━┫ 段 ┃ +; +; 字节 0,1┆ ┆ 界 ┆ +; +; ┣━━┫ 限 ┃ +; ┃ 1 ┃ ① ┃ +; ┣━━┫ ┃ +; ┃ 0 ┃ ┃ +; ------ ┗━━┻━━┛低地址 +; + + +; 图示二 + +; 高地址………………………………………………………………………低地址 + +; | 7 | 6 | 5 | 4 | 3 | 2 | 1 | 0 | +; |7654321076543210765432107654321076543210765432107654321076543210| <- 共 8 字节 +; |--------========--------========--------========--------========| +; ┏━━━┳━━━━━━━┳━━━━━━━━━━━┳━━━━━━━┓ +; ┃31..24┃ (见下图) ┃ 段基址(23..0) ┃ 段界限(15..0)┃ +; ┃ ┃ ┃ ┃ ┃ +; ┃ 基址2┃③│②│ ①┃基址1b│ 基址1a ┃ 段界限1 ┃ +; ┣━━━╋━━━┳━━━╋━━━━━━━━━━━╋━━━━━━━┫ +; ┃ %6 ┃ %5 ┃ %4 ┃ %3 ┃ %2 ┃ %1 ┃ +; ┗━━━┻━━━┻━━━┻━━━┻━━━━━━━┻━━━━━━━┛ +; │ \_________ +; │ \__________________ +; │ \________________________________________________ +; │ \ +; ┏━━┳━━┳━━┳━━┳━━┳━━┳━━┳━━┳━━┳━━┳━━┳━━┳━━┳━━┳━━┳━━┓ +; ┃ 7 ┃ 6 ┃ 5 ┃ 4 ┃ 3 ┃ 2 ┃ 1 ┃ 0 ┃ 7 ┃ 6 ┃ 5 ┃ 4 ┃ 3 ┃ 2 ┃ 1 ┃ 0 ┃ +; ┣━━╋━━╋━━╋━━╋━━┻━━┻━━┻━━╋━━╋━━┻━━╋━━╋━━┻━━┻━━┻━━┫ +; ┃ G ┃ D ┃ 0 ┃ AVL┃ 段界限 2 (19..16) ┃ P ┃ DPL ┃ S ┃ TYPE ┃ +; ┣━━┻━━┻━━┻━━╋━━━━━━━━━━━╋━━┻━━━━━┻━━┻━━━━━━━━━━━┫ +; ┃ ③: 属性 2 ┃ ②: 段界限 2 ┃ ①: 属性1 ┃ +; ┗━━━━━━━━━━━┻━━━━━━━━━━━┻━━━━━━━━━━━━━━━━━━━━━━━┛ +; 高地址 低地址 +; +; + +; 说明: +; +; (1) P: 存在(Present)位。 +; P=1 表示描述符对地址转换是有效的，或者说该描述符所描述的段存在，即在内存中； +; P=0 表示描述符对地址转换无效，即该段不存在。使用该描述符进行内存访问时会引起异常。 +; +; (2) DPL: 表示描述符特权级(Descriptor Privilege level)，共2位。它规定了所描述段的特权级，用于特权检查，以决定对该段能否访问。 +; +; (3) S: 说明描述符的类型。 +; 对于存储段描述符而言，S=1，以区别与系统段描述符和门描述符(S=0)。 +; +; (4) TYPE: 说明存储段描述符所描述的存储段的具体属性。 +; +; +; 数据段类型 类型值 说明 +; ---------------------------------- +; 0 只读 +; 1 只读、已访问 +; 2 读/写 +; 3 读/写、已访问 +; 4 只读、向下扩展 +; 5 只读、向下扩展、已访问 +; 6 读/写、向下扩展 +; 7 读/写、向下扩展、已访问 +; +; +; 类型值 说明 +; 代码段类型 ---------------------------------- +; 8 只执行 +; 9 只执行、已访问 +; A 执行/读 +; B 执行/读、已访问 +; C 只执行、一致码段 +; D 只执行、一致码段、已访问 +; E 执行/读、一致码段 +; F 执行/读、一致码段、已访问 +; +; +; 系统段类型 类型编码 说明 +; ---------------------------------- +; 0 <未定义> +; 1 可用286TSS +; 2 LDT +; 3 忙的286TSS +; 4 286调用门 +; 5 任务门 +; 6 286中断门 +; 7 286陷阱门 +; 8 未定义 +; 9 可用386TSS +; A <未定义> +; B 忙的386TSS +; C 386调用门 +; D <未定义> +; E 386中断门 +; F 386陷阱门 +; +; (5) G: 段界限粒度(Granularity)位。 +; G=0 表示界限粒度为字节； +; G=1 表示界限粒度为4K 字节。 +; 注意，界限粒度只对段界限有效，对段基地址无效，段基地址总是以字节为单位。 +; +; (6) D: D位是一个很特殊的位，在描述可执行段、向下扩展数据段或由SS寄存器寻址的段(通常是堆栈段)的三种描述符中的意义各不相同。 +; ⑴ 在描述可执行段的描述符中，D位决定了指令使用的地址及操作数所默认的大小。 +; ① D=1表示默认情况下指令使用32位地址及32位或8位操作数，这样的代码段也称为32位代码段； +; ② D=0 表示默认情况下，使用16位地址及16位或8位操作数，这样的代码段也称为16位代码段，它与80286兼容。可以使用地址大小前缀和操作数大小前缀分别改变默认的地址或操作数的大小。 +; ⑵ 在向下扩展数据段的描述符中，D位决定段的上部边界。 +; ① D=1表示段的上部界限为4G； +; ② D=0表示段的上部界限为64K，这是为了与80286兼容。 +; ⑶ 在描述由SS寄存器寻址的段描述符中，D位决定隐式的堆栈访问指令(如PUSH和POP指令)使用何种堆栈指针寄存器。 +; ① D=1表示使用32位堆栈指针寄存器ESP； +; ② D=0表示使用16位堆栈指针寄存器SP，这与80286兼容。 +; +; (7) AVL: 软件可利用位。80386对该位的使用未左规定，Intel公司也保证今后开发生产的处理器只要与80386兼容，就不会对该位的使用做任何定义或规定。 +; + + +;---------------------------------------------------------------------------- +; 描述符类型值说明 +; 其中: +; DA_ : Descriptor Attribute +; D : 数据段 +; C : 代码段 +; S : 系统段 +; R : 只读 +; RW : 读写 +; A : 已访问 +; 其它 : 可按照字面意思理解 +;---------------------------------------------------------------------------- +DA_32 EQU 4000h ; 32 位段 +DA_LIMIT_4K EQU 8000h ; 段界限粒度为 4K 字节 + +DA_DPL0 EQU 00h ; DPL = 0 +DA_DPL1 EQU 20h ; DPL = 1 +DA_DPL2 EQU 40h ; DPL = 2 +DA_DPL3 EQU 60h ; DPL = 3 +;---------------------------------------------------------------------------- +; 存储段描述符类型值说明 +;---------------------------------------------------------------------------- +DA_DR EQU 90h ; 存在的只读数据段类型值 +DA_DRW EQU 92h ; 存在的可读写数据段属性值 +DA_DRWA EQU 93h ; 存在的已访问可读写数据段类型值 +DA_C EQU 98h ; 存在的只执行代码段属性值 +DA_CR EQU 9Ah ; 存在的可执行可读代码段属性值 +DA_CCO EQU 9Ch ; 存在的只执行一致代码段属性值 +DA_CCOR EQU 9Eh ; 存在的可执行可读一致代码段属性值 +;---------------------------------------------------------------------------- +; 系统段描述符类型值说明 +;---------------------------------------------------------------------------- +DA_LDT EQU 82h ; 局部描述符表段类型值 +DA_TaskGate EQU 85h ; 任务门类型值 +DA_386TSS EQU 89h ; 可用 386 任务状态段类型值 +DA_386CGate EQU 8Ch ; 386 调用门类型值 +DA_386IGate EQU 8Eh ; 386 中断门类型值 +DA_386TGate EQU 8Fh ; 386 陷阱门类型值 +;---------------------------------------------------------------------------- + + +; 选择子图示: +; ┏━━┳━━┳━━┳━━┳━━┳━━┳━━┳━━┳━━┳━━┳━━┳━━┳━━┳━━┳━━┳━━┓ +; ┃ 15 ┃ 14 ┃ 13 ┃ 12 ┃ 11 ┃ 10 ┃ 9 ┃ 8 ┃ 7 ┃ 6 ┃ 5 ┃ 4 ┃ 3 ┃ 2 ┃ 1 ┃ 0 ┃ +; ┣━━┻━━┻━━┻━━┻━━┻━━┻━━┻━━┻━━┻━━┻━━┻━━┻━━╋━━╋━━┻━━┫ +; ┃ 描述符索引 ┃ TI ┃ RPL ┃ +; ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┻━━┻━━━━━┛ +; +; RPL(Requested Privilege Level): 请求特权级，用于特权检查。 +; +; TI(Table Indicator): 引用描述符表指示位 +; TI=0 指示从全局描述符表GDT中读取描述符； +; TI=1 指示从局部描述符表LDT中读取描述符。 +; + +;---------------------------------------------------------------------------- +; 选择子类型值说明 +; 其中: +; SA_ : Selector Attribute + +SA_RPL0 EQU 0 ; ┓ +SA_RPL1 EQU 1 ; ┣ RPL +SA_RPL2 EQU 2 ; ┃ +SA_RPL3 EQU 3 ; ┛ + +SA_TIG EQU 0 ; ┓TI +SA_TIL EQU 4 ; ┛ +;---------------------------------------------------------------------------- + + +;---------------------------------------------------------------------------- +; 分页机制使用的常量说明 +;---------------------------------------------------------------------------- +PG_P EQU 1 ; 页存在属性位 +PG_RWR EQU 0 ; R/W 属性位值, 读/执行 +PG_RWW EQU 2 ; R/W 属性位值, 读/写/执行 +PG_USS EQU 0 ; U/S 属性位值, 系统级 +PG_USU EQU 4 ; U/S 属性位值, 用户级 +;---------------------------------------------------------------------------- + + + + +; ========================================= +; FLAGS - Intel 8086 Family Flags Register +; ========================================= +; +; |11|10|F|E|D|C|B|A|9|8|7|6|5|4|3|2|1|0| +; | | | | | | | | | | | | | | | | | '--- CF……Carry Flag +; | | | | | | | | | | | | | | | | '--- 1 +; | | | | | | | | | | | | | | | '--- PF……Parity Flag +; | | | | | | | | | | | | | | '--- 0 +; | | | | | | | | | | | | | '--- AF……Auxiliary Flag +; | | | | | | | | | | | | '--- 0 +; | | | | | | | | | | | '--- ZF……Zero Flag +; | | | | | | | | | | '--- SF……Sign Flag +; | | | | | | | | | '--- TF……Trap Flag (Single Step) +; | | | | | | | | '--- IF……Interrupt Flag +; | | | | | | | '--- DF……Direction Flag +; | | | | | | '--- OF……Overflow flag +; | | | | '----- IOPL……I/O Privilege Level (286+ only) +; | | | '----- NT……Nested Task Flag (286+ only) +; | | '----- 0 +; | '----- RF……Resume Flag (386+ only) +; '------ VM……Virtual Mode Flag (386+ only) +; +; 注: see PUSHF POPF STI CLI STD CLD +; + + +; 宏 ------------------------------------------------------------------------------------------------------ +; +; 描述符 +; usage: Descriptor Base, Limit, Attr +; Base: dd +; Limit: dd (low 20 bits available) +; Attr: dw (lower 4 bits of higher byte are always 0) +%macro Descriptor 3 + dw %2 & 0FFFFh ; 段界限 1 (2 字节) + dw %1 & 0FFFFh ; 段基址 1 (2 字节) + db (%1 >> 16) & 0FFh ; 段基址 2 (1 字节) + dw ((%2 >> 8) & 0F00h) | (%3 & 0F0FFh) ; 属性 1 + 段界限 2 + 属性 2 (2 字节) + db (%1 >> 24) & 0FFh ; 段基址 3 (1 字节) +%endmacro ; 共 8 字节 +; +; 门 +; usage: Gate Selector, Offset, DCount, Attr +; Selector: dw +; Offset: dd +; DCount: db +; Attr: db +%macro Gate 4 + dw (%2 & 0FFFFh) ; 偏移 1 (2 字节) + dw %1 ; 选择子 (2 字节) + dw (%3 & 1Fh) | ((%4 << 8) & 0FF00h) ; 属性 (2 字节) + dw ((%2 >> 16) & 0FFFFh) ; 偏移 2 (2 字节) +%endmacro ; 共 8 字节 +; ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ diff --git a/boot/linker.ld b/boot/linker.ld new file mode 100644 index 0000000..f09c2e2 --- /dev/null +++ b/boot/linker.ld @@ -0,0 +1,30 @@ +OUTPUT_FORMAT("elf32-i386", "elf32-i386", "elf32-i386") +OUTPUT_ARCH(i386) +ENTRY(_start) +BASE_ADDRESS = 0x400; +LOADER_SEG_PHYADDR = 0x90000; + +SECTIONS +{ + . = BASE_ADDRESS; + .text.s16 : { + obj/boot/loader.o(.text.s16) + } + + . = ALIGN(32); + . += LOADER_SEG_PHYADDR; + text_lma = . - LOADER_SEG_PHYADDR; + .text ALIGN(32): AT(text_lma) { + *(.text .stub .text.* .gnu.linkonce.t.* .rodata .rodata.*) + } + + . = ALIGN(32); + data_lma = . - LOADER_SEG_PHYADDR; + .data ALIGN(32): AT(data_lma) { + *(*) + } + + /DISCARD/ : { + *(.eh_frame .note.GNU-stack) + } +} diff --git a/boot/loader.asm b/boot/loader.asm new file mode 100644 index 0000000..f7230b9 --- /dev/null +++ b/boot/loader.asm @@ -0,0 +1,220 @@ + +; ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ +; loader.asm +; ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ +; Forrest Yu, 2005 +; ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ + +[SECTION .text.s16] +ALIGN 16 +[BITS 16] + +%include "./boot/inc/load.inc" + +global _start +_start: + jmp Main ; Start + +%include "./boot/inc/fat12.inc" +%include "./boot/inc/pm.inc" + +ALIGN 4 +; GDT ------------------------------------------------------------------------------------------------------------------------------------------------------------ +; 段基址 段界限 属性 +LABEL_GDT: Descriptor 0, 0, 0 ; 空描述符 +LABEL_DESC_FLAT_C: Descriptor 0, 0fffffh, DA_CR | DA_32 | DA_LIMIT_4K ; 0 ~ 4G +LABEL_DESC_FLAT_RW: Descriptor 0, 0fffffh, DA_DRW | DA_32 | DA_LIMIT_4K ; 0 ~ 4G +LABEL_DESC_VIDEO: Descriptor 0B8000h, 0ffffh, DA_DRW | DA_DPL3 ; 显存首地址 + +; 准备lgdt必要的数据结构 -------------------------------------------------------------------------------------------------------------------------------------------- +GdtLen equ $ - LABEL_GDT +GdtPtr dw GdtLen - 1 ; gdt界限 + dd LoaderSegPhyAddr + LABEL_GDT ; gdt基地址 + +; GDT 选择子 ---------------------------------------------------------------------------------- +SelectorFlatC equ LABEL_DESC_FLAT_C - LABEL_GDT +SelectorFlatRW equ LABEL_DESC_FLAT_RW - LABEL_GDT +SelectorVideo equ LABEL_DESC_VIDEO - LABEL_GDT + SA_RPL3 + +Main: ; <--- 从这里开始 ************* + mov ax, cs + mov ds, ax + mov es, ax + mov ss, ax + mov sp, BaseOfStack + + mov cx, 02000h + mov ah, 01h + int 10h ; 隐藏光标 + + call LoadKernelFile + +; 下面准备跳入保护模式 ------------------------------------------- + +; 加载 GDTR + lgdt [GdtPtr] + +; 关中断 + cli + +; 打开地址线A20 + in al, 92h + or al, 00000010b + out 92h, al + +; 准备切换到保护模式 + mov eax, cr0 + or eax, 1 + mov cr0, eax + +; 真正进入保护模式 + jmp dword SelectorFlatC:LABEL_PM_START + +; 从此以后的代码在保护模式下执行 ---------------------------------------------------- +; 32 位代码段. 由实模式跳入 --------------------------------------------------------- +[SECTION .text] +ALIGN 32 +[BITS 32] + +extern load_kernel + +LABEL_PM_START: + mov ax, SelectorVideo + mov gs, ax + mov ax, SelectorFlatRW + mov ds, ax + mov es, ax + mov fs, ax + mov ss, ax + mov esp, TopOfStack + + call SetupPaging; 启动分页机制，不过在这个实验大家可以不用管，就当是一个能够扩展访存范围的牛逼玩意 + jmp SelectorFlatC:load_kernel + + ;*************************************************************** + ; 内存看上去是这样的： + ; ┃ ┃ + ; ┃ . ┃ + ; ┃ . ┃ + ; ┃ . ┃ + ; ┣━━━━━━━━━━━━━━━━━━┫ + ; ┃■■■■■■■■■■■■■■■■■■┃ + ; ┃■■■■■■Page Tables■■■■■■┃ + ; ┃■■■■■(大小由LOADER决定)■■■■┃ + ; 00101000h ┃■■■■■■■■■■■■■■■■■■┃ PageTblBase + ; ┣━━━━━━━━━━━━━━━━━━┫ + ; ┃■■■■■■■■■■■■■■■■■■┃ + ; 00100000h ┃■■■■Page Directory Table■■■■┃ PageDirBase <- 1M + ; ┣━━━━━━━━━━━━━━━━━━┫ + ; ┃□□□□□□□□□□□□□□□□□□┃ + ; F0000h ┃□□□□□□□System ROM□□□□□□┃ + ; ┣━━━━━━━━━━━━━━━━━━┫ + ; ┃□□□□□□□□□□□□□□□□□□┃ + ; E0000h ┃□□□□Expansion of system ROM □□┃ + ; ┣━━━━━━━━━━━━━━━━━━┫ + ; ┃□□□□□□□□□□□□□□□□□□┃ + ; C0000h ┃□□□Reserved for ROM expansion□□┃ + ; ┣━━━━━━━━━━━━━━━━━━┫ + ; ┃□□□□□□□□□□□□□□□□□□┃ B8000h ← gs + ; A0000h ┃□□□Display adapter reserved□□□┃ + ; ┣━━━━━━━━━━━━━━━━━━┫ + ; ┃□□□□□□□□□□□□□□□□□□┃ + ; 9FC00h ┃□□extended BIOS data area (EBDA)□┃ + ; ┣━━━━━━━━━━━━━━━━━━┫ + ; ┃■■■■■■■■■■■■■■■■■■┃ + ; 90000h ┃■■■■■■■LOADER.BIN■■■■■■┃ somewhere in LOADER ← esp + ; ┣━━━━━━━━━━━━━━━━━━┫ + ; ┃■■■■■■■■■■■■■■■■■■┃ + ; 80000h ┃■■■■■■■KERNEL.BIN■■■■■■┃ + ; ┣━━━━━━━━━━━━━━━━━━┫ + ; ┃■■■■■■■■■■■■■■■■■■┃ + ; 30000h ┃■■■■■■■■KERNEL■■■■■■■┃ 30400h ← KERNEL 入口 (KernelEntryPointPhyAddr) + ; ┣━━━━━━━━━━━━━━━━━━┫ + ; ┃ ┃ + ; 7E00h ┃ F R E E ┃ + ; ┣━━━━━━━━━━━━━━━━━━┫ + ; ┃■■■■■■■■■■■■■■■■■■┃ + ; 7C00h ┃■■■■■■BOOT SECTOR■■■■■■┃ + ; ┣━━━━━━━━━━━━━━━━━━┫ + ; ┃ ┃ + ; 500h ┃ F R E E ┃ + ; ┣━━━━━━━━━━━━━━━━━━┫ + ; ┃□□□□□□□□□□□□□□□□□□┃ + ; 400h ┃□□□□ROM BIOS parameter area □□┃ + ; ┣━━━━━━━━━━━━━━━━━━┫ + ; ┃◇◇◇◇◇◇◇◇◇◇◇◇◇◇◇◇◇◇┃ + ; 0h ┃◇◇◇◇◇◇Int Vectors◇◇◇◇◇◇┃ + ; ┗━━━━━━━━━━━━━━━━━━┛ ← cs, ds, es, fs, ss + ; + ; + ; ┏━━━┓ ┏━━━┓ + ; ┃■■■┃ 我们使用 ┃□□□┃ 不能使用的内存 + ; ┗━━━┛ ┗━━━┛ + ; ┏━━━┓ ┏━━━┓ + ; ┃ ┃ 未使用空间 ┃◇◇◇┃ 可以覆盖的内存 + ; ┗━━━┛ ┗━━━┛ + ; + ; 注：KERNEL 的位置实际上是很灵活的，可以通过同时改变 LOAD.INC 中的 KernelEntryPointPhyAddr 和 MAKEFILE 中参数 -Ttext 的值来改变。 + ; 比如，如果把 KernelEntryPointPhyAddr 和 -Ttext 的值都改为 0x400400，则 KERNEL 就会被加载到内存 0x400000(4M) 处，入口在 0x400400。 + ; + +; 启动分页机制 -------------------------------------------------------------- +SetupPaging: + ; 根据内存大小计算应初始化多少PDE以及多少页表 + xor edx, edx + mov eax, 8000000h ; qemu虚拟机默认内存128MB，这里简化实现省去了实模式代码里中断向BIOS询问可用内存大小的步骤 + mov ebx, 400000h ; 400000h = 4M = 4096 * 1024, 一个页表对应的内存大小 + div ebx + mov ecx, eax ; 此时 ecx 为页表的个数，也即 PDE 应该的个数 + test edx, edx + jz .no_remainder + inc ecx ; 如果余数不为 0 就需增加一个页表 +.no_remainder: + push ecx ; 暂存页表个数 + + ; 为简化处理, 所有线性地址对应相等的物理地址. 并且不考虑内存空洞. + + ; 首先初始化页目录 + mov ax, SelectorFlatRW + mov es, ax + mov edi, PageDirBase ; 此段首地址为 PageDirBase + xor eax, eax + mov eax, PageTblBase | PG_P | PG_USU | PG_RWW +.1: + stosd + add eax, 4096 ; 为了简化, 所有页表在内存中是连续的. + loop .1 + + ; 再初始化所有页表 + pop eax ; 页表个数 + mov ebx, 1024 ; 每个页表 1024 个 PTE + mul ebx + mov ecx, eax ; PTE个数 = 页表个数 * 1024 + mov edi, PageTblBase ; 此段首地址为 PageTblBase + xor eax, eax + mov eax, PG_P | PG_USU | PG_RWW +.2: + stosd + add eax, 4096 ; 每一页指向 4K 的空间 + loop .2 + + mov eax, PageDirBase + mov cr3, eax + mov eax, cr0 + or eax, 80000000h + mov cr0, eax + jmp short .3 +.3: + nop + + ret +; 分页机制启动完毕 ---------------------------------------------------------- + + +; SECTION .data 之开始 --------------------------------------------------------------------------------------------- +[SECTION .data] +ALIGN 32 +[BITS 32] +; 堆栈就在数据段的末尾 +StackSpace: times 1000h db 0 +TopOfStack equ $ ; 栈顶 diff --git a/boot/loadkernel.c b/boot/loadkernel.c new file mode 100644 index 0000000..86c9145 --- /dev/null +++ b/boot/loadkernel.c @@ -0,0 +1,164 @@ +/* + * 类型 + */ +typedef int i32; +typedef unsigned int u32; +typedef short i16; +typedef unsigned short u16; +typedef char i8; +typedef unsigned char u8; + +// 通常描述一个对象的大小，会根据机器的型号变化类型 +typedef u32 size_t; +// elf文件格式会用 +typedef u32 Elf32_Addr; +typedef u16 Elf32_Half; +typedef u32 Elf32_Off; +typedef i32 Elf32_Sword; +typedef u32 Elf32_Word; + +/* + * elf相关 + */ +#define KERNEL_ELF 0x80400 + +#define EI_NIDENT 16 +typedef struct elf32_hdr { + unsigned char e_ident[EI_NIDENT]; + Elf32_Half e_type; + Elf32_Half e_machine; + Elf32_Word e_version; + Elf32_Addr e_entry; /* Entry point */ + Elf32_Off e_phoff; + Elf32_Off e_shoff; + Elf32_Word e_flags; + Elf32_Half e_ehsize; + Elf32_Half e_phentsize; + Elf32_Half e_phnum; + Elf32_Half e_shentsize; + Elf32_Half e_shnum; + Elf32_Half e_shstrndx; +} Elf32_Ehdr; + +#define PT_NULL 0 +#define PT_LOAD 1 +#define PT_DYNAMIC 2 +#define PT_INTERP 3 +#define PT_NOTE 4 +#define PT_SHLIB 5 +#define PT_PHDR 6 + +typedef struct elf32_phdr { + Elf32_Word p_type; + Elf32_Off p_offset; + Elf32_Addr p_vaddr; + Elf32_Addr p_paddr; + Elf32_Word p_filesz; + Elf32_Word p_memsz; + Elf32_Word p_flags; + Elf32_Word p_align; +} Elf32_Phdr; + +/* + * 显示相关 + */ +#define TERMINAL_COLUMN 80 +#define TERMINAL_ROW 25 + +#define TERMINAL_POS(row, column) ((u16)(row) * TERMINAL_COLUMN + (column)) +/* + * 终端默认色，黑底白字 + */ +#define DEFAULT_COLOR 0x0f00 + +/* + * 这个函数将content数据（2字节）写到终端第disp_pos个字符 + * 第0个字符在0行0列，第1个字符在0行1列，第80个字符在1行0列，以此类推 + * 用的是内联汇编，等价于mov word [gs:disp_pos * 2], content + */ +inline static void +write_to_terminal(u16 disp_pos, u16 content) +{ + asm( + "mov %1, %%gs:(%0)" ::"r"(disp_pos * 2), "r"(content) + : "memory"); +} + +/* + * 清屏 + */ +static void +clear_screen() +{ + for (int i = 0; i < TERMINAL_ROW; i++) + for (int j = 0; j < TERMINAL_COLUMN; j++) + write_to_terminal(TERMINAL_POS(i, j), + DEFAULT_COLOR | ' '); +} + +static void * +memset(void *v, int c, size_t n) +{ + char *p; + int m; + + p = v; + m = n; + while (--m >= 0) + *p++ = c; + + return v; +} + +static void * +memcpy(void *dst, const void *src, size_t n) +{ + const char *s; + char *d; + + s = src; + d = dst; + + if (s < d && s + n > d) { + s += n; + d += n; + while (n-- > 0) + *--d = *--s; + } else { + while (n-- > 0) + *d++ = *s++; + } + + return dst; +} + +/* + * 初始化函数，加载kernel.bin的elf文件并跳过去。 + */ +void +load_kernel() +{ + clear_screen(); + for (char *s = "----start loading kernel elf----", *st = s; *s; s++) + write_to_terminal(s - st, DEFAULT_COLOR | *s); + + Elf32_Ehdr *kernel_ehdr = (Elf32_Ehdr *)KERNEL_ELF; + + Elf32_Phdr *kernel_phdr = (void *)kernel_ehdr + kernel_ehdr->e_phoff; + for (u32 i = 0; i < kernel_ehdr->e_phnum; i++, kernel_phdr++) + { + if (kernel_phdr->p_type != PT_LOAD) + continue; + // 将elf的文件数据复制到指定位置 + memcpy( + (void *)kernel_phdr->p_vaddr, + (void *)kernel_ehdr + kernel_phdr->p_offset, + kernel_phdr->p_filesz); + // 将后面的字节清零(p_memsz >= p_filesz) + memset( + (void *)kernel_phdr->p_vaddr + kernel_phdr->p_filesz, + 0, + kernel_phdr->p_memsz - kernel_phdr->p_filesz); + } + ((void (*)(void))(kernel_ehdr->e_entry))(); +} \ No newline at end of file diff --git a/i386-32bit.xml b/i386-32bit.xml deleted file mode 100644 index 872fcea..0000000 --- a/i386-32bit.xml +++ /dev/null @@ -1,192 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/inc/cmatrix.h b/inc/cmatrix.h new file mode 100644 index 0000000..14b559b --- /dev/null +++ b/inc/cmatrix.h @@ -0,0 +1,14 @@ +#ifndef MINIOS_CMATRIX_H +#define MINIOS_CMATRIX_H + +#include "type.h" +struct color_char { + u8 foreground;//输出字符的前景色(0~15) + u8 background;//输出字符的背景色(0~15) + u8 print_char;//输出字符的ASCII码(0~127) + u16 print_pos;//输出字符在终端中的位置 +}; + +void cmatrix_start(); + +#endif /* MINIOS_CMATRIX_H */ \ No newline at end of file diff --git a/inc/protect.h b/inc/protect.h new file mode 100644 index 0000000..df1c734 --- /dev/null +++ b/inc/protect.h @@ -0,0 +1,19 @@ +#ifndef MINIOS_PROTECT_H +#define MINIOS_PROTECT_H + +#include "type.h" + +/* 存储段描述符/系统段描述符 */ +typedef struct s_descriptor { /* 共 8 个字节 */ + u16 limit_low; /* Limit */ + u16 base_low; /* Base */ + u8 base_mid; /* Base */ + u8 attr1; /* P(1) DPL(2) DT(1) TYPE(4) */ + u8 limit_high_attr2; /* G(1) D(1) 0(1) AVL(1) LimitHigh(4) */ + u8 base_high; /* Base */ +}DESCRIPTOR; + +/* GDT 和 IDT 中描述符的个数 */ +#define GDT_SIZE 128 + +#endif /* MINIOS_PROTECT_H */ diff --git a/inc/string.h b/inc/string.h new file mode 100644 index 0000000..3e71713 --- /dev/null +++ b/inc/string.h @@ -0,0 +1,9 @@ +#ifndef MINIOS_STRING_H +#define MINIOS_STRING_H + +#include "type.h" + +void * memset(void *v, int c, size_t n); +void * memcpy(void *dst, const void *src, size_t n); + +#endif /* MINIOS_STRING_H */ \ No newline at end of file diff --git a/inc/terminal.h b/inc/terminal.h new file mode 100644 index 0000000..57a9abd --- /dev/null +++ b/inc/terminal.h @@ -0,0 +1,43 @@ +#ifndef MINIOS_TERMINAL_H +#define MINIOS_TERMINAL_H + +#include "type.h" + +/* + * 终端大小参数 + */ +#define TERMINAL_COLUMN 80 +#define TERMINAL_ROW 25 + +#define TERMINAL_POS(row, column) ((u16)(row) * TERMINAL_COLUMN + (column)) +/* + * 颜色码 + */ +#define BLACK 0x0 +#define BLUE 0x1 +#define GREEN 0x2 +#define CYAN 0x3 +#define RED 0x4 +#define FUCHUSIA 0x5 +#define BROWN 0x6 +#define SILVER 0x7 +#define GRAY 0x8 +#define LIGHT_BLUE 0x9 +#define LIGHT_GREEN 0xa +#define LIGHT_CYAN 0xb +#define LIGHT_RED 0xc +#define LIGHT_FUCHSIA 0xd +#define YELLOW 0xe +#define WHITE 0xf + +#define FOREGROUND(color) ((u16)(color & 0xf) << 8) +#define BACKGROUND(color) ((u16)(color & 0xf) << 12) +/* + * 终端默认色，黑底白字 + */ +#define DEFAULT_COLOR FOREGROUND(WHITE) | BACKGROUND(BLACK) + +void clear_screen(); +void kprintf(u16 disp_pos, const char* format, ...); + +#endif /* MINIOS_TERMINAL_H */ \ No newline at end of file diff --git a/inc/type.h b/inc/type.h new file mode 100644 index 0000000..dd5b060 --- /dev/null +++ b/inc/type.h @@ -0,0 +1,53 @@ +#ifndef MINIOS_TYPE_H +#define MINIOS_TYPE_H + +#define NULL 0 + +typedef int i32; +typedef unsigned int u32; +typedef short i16; +typedef unsigned short u16; +typedef char i8; +typedef unsigned char u8; + +// 通常描述一个对象的大小，会根据机器的型号变化类型 +typedef u32 size_t; +// signed size_t 通常描述系统调用返回值，会根据机器的型号变化类型 +typedef i32 ssize_t; +// 通常描述偏移量，会根据机器的型号变化类型 +typedef i32 off_t; +// 通常描述物理地址 +typedef u32 phyaddr_t; + +#define MIN(_a, _b) \ +({ \ + typeof(_a) __a = (_a); \ + typeof(_b) __b = (_b); \ + __a <= __b ? __a : __b; \ +}) + +#define MAX(_a, _b) \ +({ \ + typeof(_a) __a = (_a); \ + typeof(_b) __b = (_b); \ + __a >= __b ? __a : __b; \ +}) + +#define ROUNDDOWN(a, n) \ +({ \ + u32 __a = (u32) (a); \ + (typeof(a)) (__a - __a % n); \ +}) + +#define ROUNDUP(a, n) \ +({ \ + u32 __n = (u32) (n); \ + (typeof(a)) (ROUNDDOWN((u32) (a) + __n - 1, __n)); \ +}) + +#define ARRAY_SIZE(a) (sizeof(a) / sizeof(a[0])) + +// 求出在结构体中的某个成员的偏移量 +#define offsetof(type, member) ((size_t) (&((type*)0)->member)) + +#endif /* MINIOS_TYPE_H */ diff --git a/kern/Makefrag b/kern/Makefrag new file mode 100644 index 0000000..b2f9f01 --- /dev/null +++ b/kern/Makefrag @@ -0,0 +1,42 @@ +# +# makefile的kernel部分， +# 将会导入到根目录的makefile文件 +# + +OBJDIRS += kern + +KERN_ENTRY := 0x30400 + +# kernel的所有源码文件，如果要添加什么新文件就只需要在这里添加即可，其余makefile都不需要动 +KERN_SRCFEILS:= kern/kernel.asm \ + kern/start.c \ + kern/cmatrix.c \ + kern/kprintf.asm\ + lib/terminal.c \ + lib/string.c + +# 根据KERN_SRCFEILS获取所有需要的可重定位文件 +KERN_OBJFILES := $(patsubst %.c, $(OBJDIR)/%.o, $(KERN_SRCFEILS)) +KERN_OBJFILES := $(patsubst %.asm, $(OBJDIR)/%.o, $(KERN_OBJFILES)) +KERN_OBJFILES := $(patsubst $(OBJDIR)/lib/%, $(OBJDIR)/kern/%, $(KERN_OBJFILES)) + +# 根据源文件pattern判断编译的方式 +$(OBJDIR)/kern/%.o: kern/%.c $(OBJDIR)/.vars.CFLAGS + @echo + cc $< + @mkdir -p $(@D) + @$(CC) $(CFLAGS) -c -o $@ $< + +$(OBJDIR)/kern/%.o: lib/%.c $(OBJDIR)/.vars.CFLAGS + @echo + cc $< + @mkdir -p $(@D) + @$(CC) $(CFLAGS) -c -o $@ $< + +$(OBJDIR)/kern/%.o: kern/%.asm $(OBJDIR)/.vars.CFLAGS + @echo + as obj $< + @mkdir -p $(@D) + @$(AS) -f elf -o $@ $< + +# 将所有可重定位文件链接成kernel.bin +$(OBJDIR)/kern/kernel.bin: $(KERN_OBJFILES) + @echo + ld $@ + @$(LD) $(LDFLAGS) -Ttext $(KERN_ENTRY) -o $@ $^ diff --git a/kern/cmatrix.c b/kern/cmatrix.c new file mode 100644 index 0000000..90b6205 --- /dev/null +++ b/kern/cmatrix.c @@ -0,0 +1,203 @@ +#include "type.h" +#include "cmatrix.h" +#include "terminal.h" + +static size_t random_seed = 114; +static size_t +rand() { + return ( ((random_seed = random_seed * 214013L + + 2531011L) >> 16) & 0x7fff ); +} + +struct cmatrix_node { + u8 row; + u8 character; + struct cmatrix_node *pre; + struct cmatrix_node *nxt; +}; + +struct cmatrix_info { + u8 column; + u8 max_length; + u8 now_length; + struct cmatrix_node *head; + struct cmatrix_node *tail; +}; + +typedef struct cmatrix_node cm_node; +typedef struct cmatrix_info cm_info; + +#define NODE_POOL_SIZE ((TERMINAL_ROW) * (TERMINAL_COLUMN)) +static cm_node node_pool[NODE_POOL_SIZE]; + +static cm_node* +alloc_node() +{ + for (int i = 0; i < NODE_POOL_SIZE; i++) + if (node_pool[i].character == 0) + return &node_pool[i]; + return NULL; +} + +static void +free_node(cm_node *node_ptr) +{ + node_ptr -> row = 0; + node_ptr -> character = 0; + if (node_ptr -> pre != NULL) { + node_ptr -> pre -> nxt = NULL; + node_ptr -> pre = NULL; + } + if (node_ptr -> nxt != NULL) { + node_ptr -> nxt -> pre = NULL; + node_ptr -> nxt = NULL; + } +} + +#define INFO_POOL_SIZE (TERMINAL_COLUMN) +static cm_info info_pool[INFO_POOL_SIZE]; + +static const u8 char_pool[] = { + 'a','b','c','d','e','f','g','h','i','j','k','l','m', + 'n','o','p','q','r','s','t','u','v','w','x','y','z', + 'A','B','C','D','E','F','G','H','I','J','K','L','M', + 'N','O','P','Q','R','S','T','U','V','W','X','Y','Z', + '!','@','#','$','^','&','*','(',')','{','}','[',']', + '|','?','/',':',';','`','~','>','<',',','.','%','-', + '_','+','=','0','1','2','3','4','5','6','7','8','9', +}; + +static void +init_info(cm_info *info_ptr) +{ + info_ptr -> max_length = rand() % (TERMINAL_ROW - 1) + 1; + info_ptr -> head = info_ptr -> tail = NULL; +} + +static void +expand_info(cm_info *info_ptr) +{ + u8 character = char_pool[rand() % ARRAY_SIZE(char_pool)]; + + if (info_ptr -> head == NULL) { + cm_node node = { + .row = 0, + .character = character, + .pre = NULL, + .nxt = NULL, + }; + cm_node *node_ptr = alloc_node(); + *node_ptr = node; + // 修改info + info_ptr -> head = node_ptr; + info_ptr -> tail = node_ptr; + info_ptr -> now_length++; + // 打印字符 +#ifdef TESTS + struct color_char black_green = { + .background = BLACK, + .foreground = GREEN, + .print_char = info_ptr -> head -> character, + .print_pos = TERMINAL_POS(info_ptr -> head -> row, + info_ptr -> column) + }; + kprintf(0, "%s", black_green); +#else + kprintf(TERMINAL_POS(info_ptr -> head -> row, + info_ptr -> column), + "%b%c", GREEN, info_ptr -> head -> character); +#endif + + } else if (info_ptr -> head -> row < TERMINAL_ROW - 1) { + cm_node node = { + .row = info_ptr -> head -> row + 1, + .character = character, + .pre = NULL, + .nxt = info_ptr -> head, + }; + cm_node *node_ptr = alloc_node(); + *node_ptr = node; + // 打印字符 +#ifdef TESTS + struct color_char black_green = { + .background = BLACK, + .foreground = GREEN, + .print_char = info_ptr -> head -> character, + .print_pos = TERMINAL_POS(info_ptr -> head -> row, + info_ptr -> column) + }; + kprintf(0, "%s", black_green); +#else + kprintf(TERMINAL_POS(info_ptr -> head -> row, + info_ptr -> column), + "%f%c", GREEN, info_ptr -> head -> character); +#endif + // 修改info + info_ptr -> head -> pre = node_ptr; + info_ptr -> head = node_ptr; + info_ptr -> now_length++; + // 打印字符 +#ifdef TESTS + struct color_char green_white = { + .background = GREEN, + .foreground = WHITE, + .print_char = info_ptr -> head -> character, + .print_pos = TERMINAL_POS(info_ptr -> head -> row, + info_ptr -> column) + }; + kprintf(0, "%s", green_white); +#else + kprintf(TERMINAL_POS(info_ptr -> head -> row, + info_ptr -> column), + "%b%c", GREEN, info_ptr -> head -> character); +#endif + } else { + // 打印字符 +#ifdef TESTS + struct color_char black_green = { + .background = BLACK, + .foreground = GREEN, + .print_char = info_ptr -> head -> character, + .print_pos = TERMINAL_POS(info_ptr -> head -> row, + info_ptr -> column) + }; + kprintf(0, "%s", black_green); +#else + kprintf(TERMINAL_POS(info_ptr -> head -> row, + info_ptr -> column), + "%f%c", GREEN, info_ptr -> head -> character); +#endif + } + + if (info_ptr -> now_length > info_ptr -> max_length + || info_ptr -> head -> row == TERMINAL_ROW - 1) { + cm_node *node_ptr = info_ptr -> tail; + // 打印字符 + kprintf(TERMINAL_POS(info_ptr -> tail -> row, info_ptr -> column), + "%c", ' '); + // 修改info + info_ptr -> tail = info_ptr -> tail -> pre; + info_ptr -> now_length--; + // 释放内存 + free_node(node_ptr); + } +} + +void +cmatrix_start() +{ + clear_screen(); + for (int i = 0; i < TERMINAL_COLUMN; i++) + info_pool[i].column = i; + while(1) { + for (int i = 0; i < TERMINAL_COLUMN; i++) { + cm_info *info_ptr = &info_pool[i]; + if (info_ptr -> now_length == 0) + init_info(info_ptr); + expand_info(info_ptr); + } + for (int i = 0; i < 1e7; i++) { + // do nothing + } + } +} \ No newline at end of file diff --git a/kern/kernel.asm b/kern/kernel.asm new file mode 100644 index 0000000..6731acb --- /dev/null +++ b/kern/kernel.asm @@ -0,0 +1,73 @@ +SELECTOR_KERNEL_CS equ 8 + +; 导入函数 +extern cstart + +; 导入全局变量 +extern gdt_ptr + +[SECTION .bss] +StackSpace resb 4096 +StackTop: ; 栈顶 + +[section .text] ; 代码在此 + +global _start ; 导出 _start + +_start: + ; 此时内存看上去是这样的（更详细的内存情况在 LOADER.ASM 中有说明）： + ; ┃ ┃ + ; ┃ ... ┃ + ; ┣━━━━━━━━━━━━━━━━━━┫ + ; ┃■■■■■■Page Tables■■■■■■┃ + ; ┃■■■■■(大小由LOADER决定)■■■■┃ PageTblBase + ; 00101000h ┣━━━━━━━━━━━━━━━━━━┫ + ; ┃■■■■Page Directory Table■■■■┃ PageDirBase = 1M + ; 00100000h ┣━━━━━━━━━━━━━━━━━━┫ + ; ┃□□□□ Hardware Reserved □□□□┃ B8000h ← gs + ; 9FC00h ┣━━━━━━━━━━━━━━━━━━┫ + ; ┃■■■■■■■LOADER.BIN■■■■■■┃ somewhere in LOADER ← esp + ; 90000h ┣━━━━━━━━━━━━━━━━━━┫ + ; ┃■■■■■■■KERNEL.BIN■■■■■■┃ + ; 80000h ┣━━━━━━━━━━━━━━━━━━┫ + ; ┃■■■■■■■■KERNEL■■■■■■■┃ 30400h ← KERNEL 入口 (KernelEntryPointPhyAddr) + ; 30000h ┣━━━━━━━━━━━━━━━━━━┫ + ; ┋ ... ┋ + ; ┋ ┋ + ; 0h ┗━━━━━━━━━━━━━━━━━━┛ ← cs, ds, es, fs, ss + ; + ; + ; GDT 以及相应的描述符是这样的： + ; + ; Descriptors Selectors + ; ┏━━━━━━━━━━━━━━━━━━┓ + ; ┃ Dummy Descriptor ┃ + ; ┣━━━━━━━━━━━━━━━━━━┫ + ; ┃ DESC_FLAT_C (0～4G) ┃ 8h = cs + ; ┣━━━━━━━━━━━━━━━━━━┫ + ; ┃ DESC_FLAT_RW (0～4G) ┃ 10h = ds, es, fs, ss + ; ┣━━━━━━━━━━━━━━━━━━┫ + ; ┃ DESC_VIDEO ┃ 1Bh = gs + ; ┗━━━━━━━━━━━━━━━━━━┛ + ; + ; 注意! 在使用 C 代码的时候一定要保证 ds, es, ss 这几个段寄存器的值是一样的 + ; 因为编译器有可能编译出使用它们的代码, 而编译器默认它们是一样的. 比如串拷贝操作会用到 ds 和 es. + ; + ; + + + ; 把 esp 从 LOADER 挪到 KERNEL + mov esp, StackTop ; 堆栈在 bss 段中 + + sgdt [gdt_ptr] ; cstart() 中将会用到 gdt_ptr + call cstart ; 在此函数中改变了gdt_ptr，让它指向新的GDT + lgdt [gdt_ptr] ; 使用新的GDT + + + jmp SELECTOR_KERNEL_CS:csinit +csinit: ; “这个跳转指令强制使用刚刚初始化的结构”——<> P90. + + push 0 + popfd ; Pop top of stack into EFLAGS + + hlt diff --git a/kern/kprintf.asm b/kern/kprintf.asm new file mode 100644 index 0000000..9ffa055 --- /dev/null +++ b/kern/kprintf.asm @@ -0,0 +1,18 @@ +[SECTION .text] + +[BITS 32] + +global kprintf +;=============================================== +; void kprintf(u16 disp_pos, const char *format, ...) +; 参数说明： +; disp_pos: 开始打印的位置，0为0行0列，1为0行1列，80位1行0列 +; format: 需要格式化输出的字符串，默认输出的字符颜色为黑底白字 +; %c: 输出下一个参数的字符信息（保证参数范围在0~127），输出完打印的位置往下移动一位 +; %b: 更改之后输出的字符的背景色（保证参数范围在0~15） +; %f: 更改之后输出的字符的前景色（保证参数范围在0~15） +; %s(提高内容): 参考inc/terminal.h，传进来的是一个结构体，结构体参数足够明确不复赘述， +; 输出是独立的，输出完打印的位置不会往下移动一位，不会影响接下来%c的输出的颜色 +; 其余字符：按照字符输出（保证字符里不会有%，\n等奇奇怪怪的字符，都是常见字符，%后面必会跟上述三个参数之一），输出完打印的位置往下移动一位 +kprintf: + jmp $ \ No newline at end of file diff --git a/kern/start.c b/kern/start.c new file mode 100644 index 0000000..89df120 --- /dev/null +++ b/kern/start.c @@ -0,0 +1,56 @@ +#include "type.h" +#include "protect.h" +#include "string.h" +#include "cmatrix.h" +#include "terminal.h" + +u8 gdt_ptr[6]; /* 0~15:Limit 16~47:Base */ +DESCRIPTOR gdt[GDT_SIZE]; + +void cstart() +{ + /* 将 LOADER 中的 GDT 复制到新的 GDT 中 */ + memcpy(&gdt, /* New GDT */ + (void *)(*((u32 *)(&gdt_ptr[2]))), /* Base of Old GDT */ + *((u16 *)(&gdt_ptr[0])) + 1 /* Limit of Old GDT */ + ); + /* gdt_ptr[6] 共 6 个字节：0~15:Limit 16~47:Base。用作 sgdt/lgdt 的参数。*/ + u16 *p_gdt_limit = (u16 *)(&gdt_ptr[0]); + u32 *p_gdt_base = (u32 *)(&gdt_ptr[2]); + *p_gdt_limit = GDT_SIZE * sizeof(DESCRIPTOR) - 1; + *p_gdt_base = (u32)&gdt; + // 在终端的第1行依次打出N(黑底白字)，W(黑底蓝字)，P(白底蓝字)，U(白底黑字) + kprintf(TERMINAL_POS(1, 0), + "N%fW%bP%fU", LIGHT_BLUE, WHITE, BLACK); + // 在终端的第2行依次输出白底绿紫相间的字符 + for (char *s = "even old new york once Amsterdam", + *st = s ; *s ; s += 4) { + kprintf(TERMINAL_POS(2, s - st), + "%b%f%c%f%c%f%c%f%c", + WHITE, GREEN, *(s + 0), + FUCHUSIA, *(s + 1), GREEN, + *(s + 2), FUCHUSIA, *(s + 3)); + } +#ifdef TESTS + //在终端第3，4行分别输出两句话，而且两行的格式相同 + //第3行为绿底黄字，第4行为黄底绿字 + for (char *s1 = "never gonna give you up ", *st1 = s1, + *s2 = "never gonna let you down" ; *s1 ; s1 += 2, s2 += 2) { + struct color_char c1 = { + .background = YELLOW, + .foreground = GREEN, + .print_char = *(s2 + 0), + .print_pos = TERMINAL_POS(4, s1 - st1 + 0), + }; + struct color_char c2 = { + .background = YELLOW, + .foreground = GREEN, + .print_char = *(s2 + 1), + .print_pos = TERMINAL_POS(4, s1 - st1 + 1), + }; + kprintf(TERMINAL_POS(3, s1 - st1), + "%b%f%c%s%c%s", + GREEN, YELLOW, *(s1 + 0), c1, *(s1 + 1), c2); + } +#endif +} diff --git a/lab3-finish.png b/lab3-finish.png new file mode 100644 index 0000000000000000000000000000000000000000..db0287d0c037a47b34d7621b310da1b18226f557 GIT binary patch literal 24376 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 literal 0 HcmV?d00001 diff --git a/lib/string.c b/lib/string.c new file mode 100644 index 0000000..d8a8233 --- /dev/null +++ b/lib/string.c @@ -0,0 +1,37 @@ +#include "string.h" + +void * +memset(void *v, int c, size_t n) +{ + char *p; + int m; + + p = v; + m = n; + while (--m >= 0) + *p++ = c; + + return v; +} + +void * +memcpy(void *dst, const void *src, size_t n) +{ + const char *s; + char *d; + + s = src; + d = dst; + + if (s < d && s + n > d) { + s += n; + d += n; + while (n-- > 0) + *--d = *--s; + } else { + while (n-- > 0) + *d++ = *s++; + } + + return dst; +} \ No newline at end of file diff --git a/lib/terminal.c b/lib/terminal.c new file mode 100644 index 0000000..3228258 --- /dev/null +++ b/lib/terminal.c @@ -0,0 +1,18 @@ +#include "terminal.h" +#include "cmatrix.h" + +inline static void +write_to_terminal(u16 disp_pos, u16 content) +{ + asm( + "mov %1, %%gs:(%0)" ::"r"(disp_pos * 2), "r"(content) + : "memory"); +} +void +clear_screen() +{ + u16 content = DEFAULT_COLOR | ' '; + for (int i = 0; i < TERMINAL_ROW; i++) + for (int j = 0; j < TERMINAL_COLUMN; j++) + write_to_terminal(TERMINAL_POS(i, j), content); +} \ No newline at end of file diff --git a/loader.asm b/loader.asm deleted file mode 100644 index 005934d..0000000 --- a/loader.asm +++ /dev/null @@ -1,395 +0,0 @@ -org 0400h - jmp MAIN -;---------------------------------------------------------------------------- -; @param bp+8: selector -; @param bp+6: string addr -; @param bp+4: length -;---------------------------------------------------------------------------- -; Display string to current cursor -DispStr: - push bp - mov bp, sp - pusha - push es - mov ax, 0300h - mov bh, 0 - int 10h - mov ax, [bp + 6] - mov cx, [bp + 4] - mov es, [bp + 8] - mov bp, ax - mov ax, 01301h ; AH = 13, AL = 01h - mov bx, 0007h ; 页号为0(BH = 0) 黑底白字(BL = 07h) - mov dl, 0 - int 10h - - pop es - popa - pop bp - ret -;---------------------------------------------------------------------------- -; @param bp + 4: the word to print as uint_16t -;---------------------------------------------------------------------------- -; print a word as decimal to current cursor -DispInt: - push bp - mov bp, sp - pusha - mov di, 0 - mov ax, [bp + 4] -.loop1: - mov dx, 0 - mov bx, 10 - div bx ; {dx, ax} / bx(=10) -> ax ... dx - push dx - inc di - test ax, ax - jnz .loop1 - -.loop2: - pop dx - mov ax, dx - mov ah, 0Eh - add al, '0' - mov bl, 0Fh - int 10H - dec di - test di, di - jnz .loop2 - - popa - pop bp - ret -;---------------------------------------------------------------------------- -; no param -;---------------------------------------------------------------------------- -; give you a new line -DispNewline: - push bp - mov bp, sp - pusha - mov ax, 0300h - mov bh, 0 - int 10h - add dh, 1 - mov dl, 0 - - mov ax, 0200h - int 10h - - popa - pop bp - ret - -;---------------------------------------------------------------------------- -; @param bp + 4: low byte holds the ascii to print -;---------------------------------------------------------------------------- -; putchar to current cursor pos -DispPutchar: - push bp - mov bp, sp - pusha - ; get cursor pos - mov ax, 0300h - mov bh, 0 - int 10h - ; putchar - mov ax, [bp + 4] - mov ah, 0Eh ; no need to set al, ax holds the param - mov bl, 0Fh - int 10H - - popa - pop bp - ret -;---------------------------------------------------------------------------- -; 函数名: StringCmp -;---------------------------------------------------------------------------- -; 作用: -; 比较 ds:si 和 es:di 处的字符串（比较长度为11，仅为loader.bin所用） -; 如果两个字符串相等ax返回1，否则ax返回0 -StringCmp: - push bp - mov bp, sp - pusha - - mov cx, 11 ; 比较长度为11 - cld ; 清位保险一下 -.STARTCMP: - lodsb ; ds:si -> al - cmp al, byte [es:di] - jnz .DIFFERENT - inc di - dec cx - cmp cx, 0 - jz .SAME - jmp .STARTCMP -.DIFFERENT: - mov word [bp - 2], 0 ; 这里用了一个技巧，这样在popa的时候ax也顺便更新了 - jmp .ENDCMP -.SAME: - mov word [bp - 2], 1 ; 下一步就是ENDCMP了，就懒得jump了 -.ENDCMP: - popa - pop bp - ret - -;---------------------------------------------------------------------------- -; 函数名: ReadSector -;---------------------------------------------------------------------------- -; 作用: -; 将磁盘的数据读入到内存中 -; ax: 从哪个扇区开始 -; cx: 读入多少个扇区 -; (es:bx): 读入的缓冲区的起始地址 -; -; 中断调用传入的参数规范请参考本节实验指导书的实验参考LBA部分 -ReadSector: - push bp - mov bp, sp - pusha - - mov si, BufferPacket ; ds:si 指向的是BufferPacket的首地址 - mov word [si + 0], 010h ; buffer_packet_size - mov word [si + 2], cx ; sectors - mov word [si + 4], bx ; buffer-offset - mov word [si + 6], es ; buffer-segment - mov word [si + 8], ax ; start_sectors - - mov dl, BS_DrvNum ; 驱动号 - mov ah, 42h ; 扩展读 - int 13h - jc .ReadFail ; 读取失败，简单考虑就默认bios坏了 - - popa - pop bp - ret -.ReadFail: - jmp $ ; 如果cf位置1，就意味着读入错误，这个时候建议直接开摆 - -;------------------------------------------------------------------------------ -; 函数名: GetNextCluster -; data => BaseOfSectorBuf : 0 -;------------------------------------------------------------------------------ -; 作用: -; ax存放的是当前的簇(cluster)号，根据当前的簇号在fat表里查找，找到下一个簇的簇号，并将返回值存放在ax -GetNextCluster: - push bp - mov bp, sp - pusha - - mov bx, 3 ; 一个FAT项长度为1.5字节 - mul bx - mov bx, 2 ; ax = floor(clus_number * 1.5) - div bx ; 这个时候ax里面放着的是FAT项基地址相对于FAT表开头的字节偏移量 - ; 如果clus_number为奇数，则dx为1，否则为0 - push dx ; 临时保存奇数标识信息 - mov dx, 0 ; 下面除法要用到 - mov bx, BPB_BytsPerSec - div bx ; dx:ax / BPB_BytsPerSec - ; ax <- 商 (基地址在FAT表的第几个扇区) - ; dx <- 余数 (基地址在扇区内的偏移) - mov bx, 0 ; bx <- 0 于是, es:bx = BaseOfSectorBuf:0 - add ax, SectorNoOfFAT1 ; 此句之后的 ax 就是FAT项所在的扇区号 - mov cx, 2 ; 读取FAT项所在的扇区, 一次读两个, 避免在边界 - call ReadSector ; 发生错误, 因为一个FAT项可能跨越两个扇区 - - mov bx, dx ; 将偏移量搬回bx - mov ax, [es:bx] - pop bx ; 取回奇数标识信息 - cmp bx, 0 ; 如果是第奇数个FAT项还得右移四位 - jz .EvenCluster ; 可能是微软(FAT是微软创建的)第一个亲儿子的原因，有它的历史局限性 - shr ax, 4 ; 当时的磁盘很脆弱，经常容易写坏，所以需要两张FAT表备份，而且人们能够制作的存储设备的容量很小 -.EvenCluster: - and ax, 0FFFh ; 读完需要与一下，因为高位是未定义的，防止ax值有误 - mov word [bp - 2], ax ; 这里用了一个技巧，这样在popa的时候ax也顺便更新了 - - popa - pop bp - ret - -;------------------------------------------------------------------------------ -; @param bp + 4: Filename string addr -; @retval ax: first cluster no -;------------------------------------------------------------------------------ -; Find File by name, return first cluster no. -; data => BaseOfSectorBuf:OffsetOfSectorBuf -FuncFindFile: - push bp - mov bp, sp - pusha - - mov word [RootDirSectorNow], SectorNoOfRootDirectory - mov word [LeftRootDirSectors], RootDirSectors -.FindLoaderInRootDir: - mov ax, [RootDirSectorNow] ; ax <- 现在正在搜索的扇区号 - mov bx, OffsetOfSectorBuf ; es:bx = BaseOfSectorBuf:OffsetOfSectorBuf - mov cx, 1 - call ReadSector - - mov si, [bp + 4] ; ds:si - mov di, OffsetOfSectorBuf ; es:di -> BaseOfSectorBuf:400h = BaseOfSectorBuf*10h+400h - mov dx, 10h ; 32(目录项大小) * 16(dx) = 512(BPB_BytsPerSec) - -.CompareFilename: - call StringCmp - cmp ax, 1 - jz .LoaderFound ; ax == 1 -> 比对成了 - dec dx - cmp dx, 0 - jz .GotoNextRootDirSector ; 该扇区的所有目录项都探索完了，去探索下一个扇区 - add di, 20h ; 32 -> 目录项大小 - jmp .CompareFilename - -.GotoNextRootDirSector: - inc word [RootDirSectorNow] ; 改变正在搜索的扇区号 - dec word [LeftRootDirSectors] ; ┓ - cmp word [LeftRootDirSectors], 0 ; ┣ 判断根目录区是不是已经读完 - jz .NoLoader ; ┛ 如果读完表示没有找到 LOADER.BIN，就直接开摆 - jmp .FindLoaderInRootDir - -.NoLoader: - call DispNewline - mov ax, cs - push ax - mov ax, NotFoundString - push ax - mov ax, _endNotFoundString - NotFoundString - push ax - call DispStr - add sp, 6 - jmp $ - -.LoaderFound: ; 找到 LOADER.BIN 后便来到这里继续 - add di, 01Ah ; 0x1a = 26 这个 26 在目录项里偏移量对应的数据是起始簇号（RTFM） - mov dx, word [es:di] ; 起始簇号占2字节，读入到dx里 - - mov word [bp - 2], dx ; set ax([bp-2]) as retval, popa will set that - popa - pop bp - ret - -;------------------------------------------------------------------------------ -; @param bp + 4: first cluster number -;------------------------------------------------------------------------------ -; Find File by name, return first cluster no. -; data => BaseOfSectorBuf:OffsetOfSectorBuf -FuncPrintClusterNumbers: - push bp - mov bp, sp - pusha - mov ax, [bp + 4] -.loop: - mov ax, dx - push ax - call DispInt ; ax now holds the current cluster number - add sp, 2 - push ' ' - call DispPutchar - add sp, 2 - - call GetNextCluster ; 根据数据区簇号获取文件下一个簇的簇号 - mov dx, ax ; dx <- 下一个簇的簇号 - cmp dx, 0FFFh ; 判断是否读完了（根据文档理论上dx只要在0xFF8~0xFFF都行，但是这里直接偷懒只判断0xFFF） - jnz .loop - - popa - pop bp - ret - -MAIN: - mov ax, cs ; cs <- 0 - mov ds, ax ; ds <- 0 - mov ss, ax ; ss <- 0 - mov ax, BaseOfSectorBuf - mov es, ax ; es <- BaseOfSectorBuf -; Display "This is {name}'s boot" - call DispNewline - - push cs - push StudentString - push _endStudentString - StudentString - call DispStr - add sp, 6 ; pop for 3 times - -; Read loader.bin's cluster number - push LoaderFileName - call FuncFindFile - add sp, 2 - - mov dx, ax ; temporarily save read result to dx -; Print first cluster number - call DispNewline - - push cs - push clusternoString - push _endclusternoString - clusternoString - call DispStr - add sp, 6 ; pop for 3 times - - push dx ; dx holds the read result - call FuncPrintClusterNumbers - add sp, 2 - -; Read aA1.txt's cluster number - push AA1FileName - call FuncFindFile - add sp, 2 - - mov dx, ax ; temporarily save read result to dx -; Print first cluster number - call DispNewline - - push cs - push clusternoString - push _endclusternoString - clusternoString - call DispStr - add sp, 6 - - push dx ; dx holds the read result - call FuncPrintClusterNumbers - add sp, 2 - jmp $ - -;============================================================================== -; CONSTANTS -;============================================================================== -BaseOfStack equ 07c00h ; Boot状态下堆栈基地址(栈底, 从这个位置向低地址生长) -; according to osdev, memory from 0x0000:0x7e00 to 0x7000:0xFFFF is free to use -BaseOfSectorBuf equ 07000h ; diff from where we are here -OffsetOfSectorBuf equ 0400h ; the first 400h(=1024d) bytes left for fat1 read buf -RootDirSectors equ 14 ; 19~32 -SectorNoOfRootDirectory equ 19 ; Root Sector starts from 19 -SectorNoOfFAT1 equ 1 -DeltaSectorNo equ 31 -BPB_BytsPerSec equ 512 ; 每扇区字节数 -BPB_SecPerClus equ 1 ; 每簇多少扇区 -BPB_RsvdSecCnt equ 1 ; Boot 记录占用多少扇区 -BPB_NumFATs equ 2 ; 共有多少 FAT 表 -BPB_RootEntCnt equ 224 ; 根目录文件数最大值 -BPB_TotSec16 equ 2880 ; 逻辑扇区总数 -BPB_Media equ 0xF0 ; 媒体描述符 -BPB_FATSz16 equ 9 ; 每FAT扇区数 -BPB_SecPerTrk equ 18 ; 每磁道扇区数 -BPB_NumHeads equ 2 ; 磁头数(面数) -BPB_HiddSec equ 0 ; 隐藏扇区数 -BPB_TotSec32 equ 0 ; 如果 wTotalSectorCount 是 0 由这个值记录扇区数 -BS_DrvNum equ 80h ; 中断 13 的驱动器号 -BS_Reserved1 equ 0 ; 未使用 -BS_BootSig equ 29h ; 扩展引导标记 (29h) -BS_VolID equ 0 ; 卷序列号 -;============================================================================== -; dw means initialized DATA -;============================================================================== -LeftRootDirSectors dw RootDirSectors ; 还未搜索的根目录扇区数 -RootDirSectorNow dw SectorNoOfRootDirectory ; 目前正在搜索的根目录扇区 -BufferPacket times 010h db 0 ; ReadSector函数会用到的，用于向int 13h中断的一个缓冲区 - -LoaderFileName db "LOADER BIN", 0 ; 8:3, fill with whitespace -AA1FileName db "AA1 TXT", 0 ; the 0 at end is for StrCmp -StudentString db "This is LiMaoliang's boot" ; size = 25 -_endStudentString -clusternoString db "cluster no:" -_endclusternoString -NotFoundString db "not found" -_endNotFoundString \ No newline at end of file diff --git a/mergedep.pl b/mergedep.pl new file mode 100644 index 0000000..1730d53 --- /dev/null +++ b/mergedep.pl @@ -0,0 +1,86 @@ +#!/usr/bin/perl +# Copyright 2003 Bryan Ford +# Distributed under the GNU General Public License. +# +# Usage: mergedep [ ...] +# +# This script merges the contents of all specified +# on the command line into the single file , +# which may or may not previously exist. +# Dependencies in the will override +# any existing dependencies for the same targets in . +# The are deleted after is updated. +# +# The are typically generated by GCC with the -MD option, +# and the is typically included from a Makefile, +# as shown here for GNU 'make': +# +# .deps: $(wildcard *.d) +# perl mergedep $@ $^ +# -include .deps +# +# This script properly handles multiple dependencies per , +# including dependencies having no target, +# so it is compatible with GCC3's -MP option. +# + +sub readdeps { + my $filename = shift; + + open(DEPFILE, $filename) or return 0; + while () { + if (/([^:]*):([^\\:]*)([\\]?)$/) { + my $target = $1; + my $deplines = $2; + my $slash = $3; + while ($slash ne '') { + $_ = ; + defined($_) or die + "Unterminated dependency in $filename"; + /(^[ \t][^\\]*)([\\]?)$/ or die + "Bad continuation line in $filename"; + $deplines = "$deplines\\\n$1"; + $slash = $2; + } + #print "DEPENDENCY [[$target]]: [[$deplines]]\n"; + $dephash{$target} = $deplines; + } elsif (/^[#]?[ \t]*$/) { + # ignore blank lines and comments + } else { + die "Bad dependency line in $filename: $_"; + } + } + close DEPFILE; + return 1; +} + + +if ($#ARGV < 0) { + print "Usage: mergedep [ ..]\n"; + exit(1); +} + +%dephash = (); + +# Read the main dependency file +$maindeps = $ARGV[0]; +readdeps($maindeps); + +# Read and merge in the new dependency files +foreach $i (1 .. $#ARGV) { + readdeps($ARGV[$i]) or die "Can't open $ARGV[$i]"; +} + +# Update the main dependency file +open(DEPFILE, ">$maindeps.tmp") or die "Can't open output file $maindeps.tmp"; +foreach $target (keys %dephash) { + print DEPFILE "$target:$dephash{$target}"; +} +close DEPFILE; +rename("$maindeps.tmp", "$maindeps") or die "Can't overwrite $maindeps"; + +# Finally, delete the new dependency files +foreach $i (1 .. $#ARGV) { + unlink($ARGV[$i]) or print "Error removing $ARGV[$i]\n"; +} + diff --git a/target.xml b/target.xml deleted file mode 100644 index 71daae8..0000000 --- a/target.xml +++ /dev/null @@ -1 +0,0 @@ -i8086 diff --git a/实验3-v0.2.md b/实验3-v0.2.md new file mode 100644 index 0000000..24dc490 --- /dev/null +++ b/实验3-v0.2.md @@ -0,0 +1,293 @@ +

+ 实验三 进入保护模式 +
+ +
+ 谷建华 +
+ +
+ 2022-09-29 v0.2 +
+ +#### 实验目的 + +1. 学习x86保护模式编程,以及如何从实模式进入到保护模式. +2. 学习elf文件的组成和格式、加载elf文件格式的kernel. +3. 学习汇编与C之间的相互调用. +4. 学习二进制文件与elf文件之间的区别. + +#### 实验预习内容 + +1. 保护模式之前需要做的准备工作. +2. ELF文件格式. +3. 应用程序二进制接口. + +#### 实验内容以及步骤 + +**2022年试点班需要完成1、2、3三个实验,提高实验想做就做不强求** + +1. 编译构建硬盘启动盘,并挂载到虚拟机上,证实执行流交给了kernel + (1) 修改`kernel.asm`,使之能够在虚拟机终端中显示`kernel`字符串(注意,这个时候bios中断**不能**使用了). + (2) 通过`make`编译,生成`a.img`硬盘镜像. + (3) 通过`make run`运行虚拟机并挂载`a.img`作为硬盘启动盘,观察并记录现象. + +2. 通过修改`initkernel.c`的代码,解析`kernel.bin`elf文件并结合elf文档阅读,回答下面问题： + (1) 凭什么知道`kernel.bin`是一个elf文件？ + (2) 凭什么知道`kernel.bin`运行的环境的指令集为i386？ + (3) `kernel.bin`一共被加载了几个程序段？加载的段在内存中是从什么地址开始？加载的长度有多长？每个段的读/写/可执行标志是怎么设置的？ + +3. 通过修改`kprintf.asm`,完成kprintf的函数的汇编实现,函数调用的参数如下： + (1) 第0个参数为从终端中的第几个字符开始输出,第0个字符是终端0行0列,第1个字符是0行1列,第80个字符是1行0列,以此类推. + (2) 第1个参数为需要格式化输出的字符串,传进去的参数实际是这个字符串的首地址. + (3) 再之后的参数根据第1个参数的字符串决定,每次调用kprintf函数后首先默认输出黑底白字的字符,接下来几条是需要实现的. + + + `%c`在终端输出参数的对应的ASCII字符值（参数保证范围在0~127之间）,在输出字符后输出的位置往下移动一位. + + `%f`更改之后输出的字符的前景色为参数的对应值(参数保证范围在0~15之间,颜色码对应值) + + `%b`更改之后输出的字符的背景色为参数的对应值(参数保证范围在0~15之间,颜色码对应值) + + 其余字符则按照其ASCII码输出（保证字符串不会出现%、换行符、退格符等乱七八糟的字符）,在输出字符后输出的位置往下移动一位. + + 在`start.c`中存放一组测试样例,效果已经写明可以大家可以用于测试. + + (4) 在`start.c`中接入`cmatrix.c`中的启动函数`cmatrix_start`,如果编写正确,会在终端中看到以下效果 + + ![](./lab3-finish.png) + + (5) (自我提高内容,自己想做就做,不用写进报告,**禁止内卷**)增添一个新参数`%s`,对应的参数是一个结构体,结构体的格式如下： + + ```C + struct color_char{ + u8 foreground;//输出字符的前景色(0~15) + u8 background;//输出字符的背景色(0~15) + u8 print_char;//输出字符的ASCII码(0~127) + u16 print_pos;//输出字符在终端中的位置 + }; + ``` + 这种输出方式不影响接下来`%c`输出的前景色、背景色和输出在终端中的位置,相当于是一个独立的输出方式.检验你程序的正确性可以调用`make tests`命令生成专属的测试kernel. + +4. 简单的`nm`工具制作（自我提高内容,自己想做就做,不用写进报告,**禁止内卷**） + (1) 通过分析elf文件的文件头,找到elf文件中的符号表,输出每个符号对应的符号名、符号地址、大小和类型. + (2) 这个操作可以在我们的内核中写,也可以自己独立写一个C/Cpp程序,如何检验自己的程序是否正确,可以通过`nm`和`readelf -s`检查. + +5. 创建FAT32格式的硬盘启动盘（自我提高内容,自己想做就做,不用写进报告,**禁止内卷**） + (1) 之前硬盘启动盘的文件系统格式为FAT12,这次需要将FAT12格式变成FAT32格式,这需要熟读官方文档,了解FAT32的文件格式以及处理方式. + (2) 修改boot/loader代码实现正确加载. + (3) 编译制作硬盘启动盘,启动虚拟机并挂载硬盘启动盘,观察并记录现象. +#### 实验总结 + +1. 在loader阶段都完成了哪些主要功能？X86系统是如何进入保护模式的？在进入保护模式之前需要完成哪些准备工作？ +2. C语言和汇编语言是如何互相调用的？参数如何传递？ + +#### 实验参考 + +##### 进入保护模式 + +在进入了loader后,终于可以不受512字节的代码限制.进入loader之后我们需要干的一件事是：**进入保护模式**. + +为什么要进入保护模式？这个时候这个问题就自然而然问出来了,这不是实模式待着好好地嘛,去啥保护模式.正常情况是这样的,对于我们写的程序来说实模式貌似挺够我们用的,但是如果稍微写个大一点的程序呢？这个时候一个噩梦般的事情发生了：段偏移的寻址方式太弱了,虽说1MB的寻址能力挺强的,但是对于一个固定段,它的偏移寻址能力只有64KB大,只需要128个boot程序般大的程序文件会超过偏移寻址能力,这对程序员来说是极为头疼的,写程序逻辑本身就很麻烦了,还要关心寻址,这程序谁爱写谁写. + +而保护模式解决了这个寻址问题,它扩展了段偏移寻址模式的定义,将偏移范围支持到4GB大,刚好是一个int能够表达的范围,这不爽死XD,所以进入保护模式还是很有必要的. + +保护模式是怎么扩展段偏移寻址模式的定义？这帮硬件工程师商量来商量去最后给出了一种方式`gdt(global descriptor table)`全局描述符.全局描述符抽象来看是一个数据结构,这个数据结构不能说是整齐规整,也可以说是东拼西凑,具体可以到Orange教科书中查询相关的数据结构细节.与实模式的段地址不同,保护模式的“段地址”就是gdt的基地址,而gdt能够表示偏移寻址的范围最多能到4GB,这样就能够支持4GB的寻址. + +回忆实模式,它的基址是一个地址值,很容易用一个寄存器进行存储,但是保护模式的段地址是一个数据结构的基地址,而且由于段寄存器的历史遗留问题仍然只有16位,不能填入32位数据,所以硬件工程师就搞出一条命令`lgdt`,由于我们在一个固定缓冲区按顺序存储一些gdt,亦叫gdt表（数组）,只需要通过`lgdt`指令告诉硬件gdt表的起始地址和长度就能让硬件提前分析gdt表,这样我们只需要将段寄存器改成gdt相对于gdt表的偏移量（亦称选择子）就可以轻松表示.（改成这种方式还能够控制权限,不过本篇不谈） + +在进入保护模式之前,根据硬件厂商的手册,我们需要做三件事 + +1. 加载gdt表 +2. 打开地址线A20 +3. cr0第0位置位 + +这三件事做完之后,通过一个32位长指令的长跳转跳转到`SelectorFlatC:LABEL_PM_START`后,我们执行环境从16位变成了32位,从实模式跳到了保护模式.其中`SelectorFlatC`是希望cs变成的gdt选择子,`LABEL_PM_START`是指希望跳到的地址（不受段偏移限制了）. + +在进入了保护模式后,就可以忘掉落后的段偏移访存方式了,能够更加舒服地写汇编程序了.但惊喜不止于此,我们还能够通过C语言实现我们想要的功能,想必看完那么多汇编大家肯定不想再读汇编了,苦日子终于熬到头了,可以用C了,C比汇编可好读太多了. + +##### 汇编与C之间的交互 + +在进入了C语言的部分之后就需要面临一个问题,如何进行汇编与C之间的交互？这个问题放平时可能想都不会想,大一开始的C语言课程可能根本不会让你意识到程序背后本质可以抽象成一条条汇编指令的执行,就如大家写的汇编程序一样,所以C语言代码本身可以具象为汇编代码,C语言中的函数本身就是一条label标签,这样就可以通过jmp和call进行函数跳转/调用将执行流交给C语言程序. + +但是这么说依然很抽象,你依然会很难理解一个在C语言中的函数调用具体发生了什么,一个带参数的函数跳转是怎么执行的,中间经历了什么？ + +1. 导入/导出符号 + +如何让汇编代码与C代码进行相互调用,首先需要了解什么是符号,符号说人话就是函数名,全局变量名等.我们在编写汇编代码的时候会写一些标签,这些标签成了我们跳转的目标,也可以成为我们访存的目标,从某种意义上,符号就是这些标签. + +先解决第一个问题,如何在汇编中调用C函数/全局变量,对于汇编来说,这个符号是外部的,所以需要引入这个符号,引入到代码中,这样编译器就知道这个就是外部的符号,在跳转/访存的时候就知道这个符号是从哪里来的了.虽然在汇编文件编译的时候不知道确切地址,在链接的时候就能够知道了. + +```c +;nasm汇编程序 +extern foo ; 这个时候通过引入foo符号实现函数的跳转 +call foo ; 通过调用foo函数实现打印 + +//C程序 +#include +void foo() +{ + printf("114514 1919810"); +} +``` + +然后解决第二个问题,如何在C中调用汇编中的函数/全局变量,对于汇编来说,这个符号不仅是汇编文件用,外部也要用,所以汇编文件就需要将符号导出,告诉外界,它们想要的符号在汇编文件里,这样在链接的时候其他文件也知道这个符号在哪. + +```c +;nasm汇编程序 +global foo ; 导出foo符号 +foo: + ... ; 这里是foo函数的实现 + +global foofoo ; 导出foofoo符号 +foofoo dd 0 ; 这个是个全局变量 + +//C程序 +void foo(); //这里类似汇编里面的extern,如果下面没有foo函数的实现就将foo这个函数的符号导入进来 +extern int foofoo; //将foofoo这个全局符号导入进来 + +void bar() +{ + foo(); //这样就能够调用foo函数 + foofoo=1;//这样就能够使用foofoo变量 +} +``` + +这样汇编与C语言代码之间的相互调用就完成了.如果你好奇原理是什么,可以看第3节符号表. + +2. 参数传递 + +刚才解决的是C语言函数与汇编函数相互调用的问题,但是假设有这么个情况,这个C语言函数是一个带输入参数的函数,比如`int foo(int a, int b)`,这个时候如果光调用`call`指令可不好使,`a,b`参数就被吞了,下面的`foo`函数拿着混乱的参数大搞破坏,这肯定是我们所不希望的. + +那么对于`foo`函数,它还有两个参数`a,b`,那么如何将`a,b`“告诉”子函数,对于i386指令集规定了参数传递方式：对于所有参数,按照从右往左的顺序压栈,通过栈传递中间参数. + +对于上面这个例子来说,nasm汇编在调用C函数之前需要先将`b`压栈,然后将`a`压栈,最后才是调用`call`指令跳转到`foo`函数的标签处,C函数同样遵循这个规范,所以会去栈里寻找`a,b`两个变量的值,离栈顶越近的元素在函数定义的时候参数越靠左. + +这种从右往左的压栈方式其实很好,比如`printf`,我们不知道要输入多少个参数,但是会根据其中的字符串中的信息`%d,%s`判断需要多少个参数,然后在栈中找就可以将传入的参数拿出.在这次的实验中大家需要实现一个类似`printf`的函数,来深刻理解这种传参方式. + +通过压栈就能解决参数传递的问题,这种传递方式本质叫**应用程序二进制接口**,在第4节中有介绍. + +3. 符号表 + +可能大家都忘完了大一学的大计基和C程序,这个时候就要需要回忆一下一个C语言程序的编译过程`预处理、编译、汇编、链接`.相信大家在大一的时候把这一过程当文科一样背,现在可能基本记不清这几步具体发生了什么.前面三个步骤还能勉强理解理解,这个链接可能是真的难以理解. + +假设有若干个可重定位文件(.o文件),那么可以使用GNU的工具`ld`对这些可重定位文件进行链接成一个可执行文件. + +```c +//1.c程序内容 +void foo() +{ + int bar=114514; +} +int main() +{ + foo(); +} +//2.c程序内容 +void foo() +{ + int bar=1919810; +} +``` + +将两个程序的内容用gcc(附上-c参数)命令编译成两个可重定位文件,然后尝试将两个可重定位文件用ld命令链接,然后你就会发现一个神奇的现象. + +```shell +$ gcc -c 1.c && gcc -c 2.c +$ ld 1.o 2.o -o test +ld: 2.o: in function `foo': +2.c:(.text+0x0): multiple definition of `foo'; 1.o:1.c:(.text+0x0): first defined here +ld: warning: cannot find entry symbol _start; defaulting to 0000000000401000 +``` + +你会发现不让你链接,原因是foo被两次定义了.那么原因是什么？它凭什么知道foo被两次定义了？我们作为写程序的人肯定知道被两次定义了,但是机器怎么知道？这就涉及到**符号表**了. + +每一个可重定位文件里面存放着一张符号表,它存放所有符号信息.那么如何获取符号信息？GNU里面有一个工具`nm`能够获取对应的符号信息. + +```shell +$ nm 1.o +0000000000000000 T foo +0000000000000012 T main +$ nm 2.o +0000000000000000 T foo +``` + +看到这个的时候,哦,确实有两个foo的符号,所以在链接的时候会发生符号冲突.符号表是用于链接时定位的,在可重定位文件里,可能某个跳转语句的目的地址还是未知的,在链接成可执行文件时才能具体填入地址. + +在大一上C程序的时候大家可能不知道有`nm`命令,所以对链接的学习是迷迷糊糊的（再加上考试是不会考这个的,这个考了不挂一片人）,所以可能仍不会`extern static`等相关关键词的语义.在做这节实验的时候可以尝试结合`nm`复习这些关键词的语义,这会对你对链接的理解有很大帮助. + +4. 应用程序二进制接口(Application Binary Interface) + +ABI本质上是一种约定,它约束外部函数调用的参数规范,每种指令集都有它自己的一套调用规范,类似64-x86,risc-V指令集首先用的是寄存器传参再是栈传参,而32位的i386指令集用的是栈传参.所以只要按照ABI规范写就一定能够正确调用外部函数. + +目前我们的OS用的是32位i386指令集,采取的传参方式是栈传参,就是在调用函数之前将所有参数从右往左依次压入栈中,最后才是函数跳转,不管是调用者还是被调用者都遵循ABI,这样就可以实现正确的函数调用. + +但是实际上有那么多种ABI,我们肯定背不下那么多ABI规范,但是有一种最笨也是最有效的方式就是：读汇编,读汇编,读汇编.因为C语言程序本质上也可以抽象成一个汇编程序,而汇编程序是最基础的,它每条指令的执行会按部就班地执行,而且每句话都是实打实地,不会骗你半点,当你觉得你实现的汇编很对但是链接进去执行错误的时候最好的方式就是反汇编/gdb. + +那么如何反汇编呢？GNU也给了我们一个工具`objdump`,通过调用`objdump -d kernel.bin | less`命令就可以将kernel.bin这个可执行elf文件（也可以是可重定位文件）反汇编,然后就可以愉悦地查看汇编代码了,通过查看实际的汇编代码是很好的,它完全反应了程序指令运行行为,对着它研究ABI准没错. + +当学会了ABI,大家可能就觉得C语言可能也那么神秘,你也可以独立从一个C语言翻译成一段汇编代码,只是需要读文档+花费逝量时间即可. + +##### 二进制文件和ELF文件 + +在进入了保护模式之后剩下loader要做的事就是加载kernel,毕竟loader是一个32位与16位代码混合的二进制文件,有实模式寻址的约束,不太适合扩展32位代码当内核,不如新启一个程序文件作为kernel. + +而这次加载kernel文件并不能像加载loader文件一样直接加载到指定位置然后跳过去,可以通过`file`命令查看两个文件类型： + +```shell +$ file loader.bin | tr ',' '\n' +loader.bin: + code offset 0x1c7+3 + OEM-ID "ForrestY" + root entries 224 + sectors 2880 (volumes <=32 MB) + sectors/FAT 9 + sectors/track 18 + serial number 0x0 + label: "OrangeS0.02" + FAT (12 bit) +$ file kernel.bin | tr ',' '\n' +kernel.bin: ELF 32-bit LSB executable + Intel 80386 + version 1 (SYSV) + statically linked + with debug_info + not stripped +``` + +loader.bin本质上是一个二进制文件,不过带有引导信息（沿用了boot的引导信息所以会被识别成一个文件系统）,所以可以通过跳转跳到文件开头就可以进行loader的执行. + +而kernel.bin本质上是一个elf可执行文件,什么是elf可执行文件？ + +##### ELF文件格式简介 + +试想一个简单的场景,你写的代码有代码数据和普通数据,这两部分数据是不对等的,对于代码数据你希望它不会被改动,所以对这部分数据不应该附上写权限,普通数据应该附上写权限.很明显这两部分数据不应该混在一块,而是应该分成两段存放.而且每一段都有它希望被加载到的地址,整个一个elf文件的入口地址也要指定……这些东西是需要一个数据结构进行管理,维护每一个段所需求的信息,然后在文件开头维护每个段的信息以及整个程序的信息等,这个数据结构就叫ELF文件格式.如果你比较熟悉内核,熟悉execve系统调用,那么[这里](https://www.bilibili.com/video/BV1wL4y1L72C/)会让你对ELF文件格式有更深刻的理解（如果不熟悉别听,绝对听晕）. + +ELF维护了若干个程序段,每个程序段存放了相对应的数据,通过对数据的迁移到指定地址,再跳到入口地址就能实现elf文件的加载执行. + +在知道ELF是啥之后,怎么解析ELF文件,将ELF文件的程序数据迁移就是个问题,讲理论概念谁不会讲,但是在具体做的时候经常会怀疑人生,理论突然就不起用了,那么这个时候该怎么办？**读文档**,对于ELF文件格式,linux里面有写一个专门关于它的文档,可以通过调用`man elf`指令进行查看ELF里面的细节,可以结合`initkernel.c`代码与文档一起阅读,分析其中的具体含义（不要惧怕阅读英语,你们从小学开始学的英语不是仅用来考试的）.需要注意的是`man elf`中是不会给出参数的具体值的,需要阅读`/usr/include/elf.h`头文件获取具体的值. + +当然解析这些玩意肯定折磨人,不过我们万能的GNU又给我们提供了一个工具`readelf`,当你想分析一个elf文件格式的时候,通过调用`readelf -a`获取所有信息,`readelf -l`获取程序头信息,当你觉得你的C程序分析错的时候,用`readelf`能够及时比对. + +##### 加载kernel + +虽然说起来ELF格式很复杂,但是由于kernel没啥权限需求,实际上加载的时候的代码没几行,实际上就遍历所有程序头,然后根据每个程序头的要求将文件数据加载到指定的位置,最后用一个跳转跳入kernel的入口地址. + +在进入了kernel了之后,我们真正有意思的内核就来了,大家会逐渐实现一些有趣的机制,并用这些有趣的机制实现很多有趣的玩意. + +##### 显存 + +进入保护模式后,实模式下能够使用的BIOS中断就不能用了,那么如何往终端打印字符就成了一个难事,不过好在天无绝人之路,在内存的[0xB8000, 0xC0000)处给了我们一个能够往那黑漆漆的终端写字符的途径,我们的终端只有25行*80列,一共2000个字符,每个字符由两字节表示,相当于终端显示的是显存[0xB8000, 0xB8000 + 4000)这部分的内容,这两字节低字节表示ASCII字符内容,高字节字符分成两部分,低4位为前景色,高四位为背景色,颜色码与实验一中的颜色码一致（具体可以到Orange书中7.2.1节中查看）. + +在保护模式中,显存选择子对应的段就是显存的内存.所以在loader中可以通过gs段寄存器对显存进行存取字符,这个可比中断高效多了. + +```nasm +; 段描述符 +LABEL_DESC_VIDEO: Descriptor 0B8000h, 0ffffh, DA_DRW | DA_DPL3 ; 显存首地址 + +; 段选择子 +SelectorVideo equ LABEL_DESC_VIDEO - LABEL_GDT + SA_RPL3 + +; 将选择子加载到gs段寄存器 +mov gs, SelectorVideo +mov ah, 00fh; 黑底白字 +mov al, 041h; 'A' +mov word [gs:0 * 2] ax; 往0行0列写入一个黑底白字的字符A +mov word [gs:1 * 2] ax; 往0行1列写入一个黑底白字的字符A +mov word [gs:80 * 2] ax; 往1行0列写入一个黑底白字的字符A +``` \ No newline at end of file diff --git a/实验二-v0.3.md b/实验二-v0.3.md deleted file mode 100644 index 395dd5f..0000000 --- a/实验二-v0.3.md +++ /dev/null @@ -1,149 +0,0 @@ -
- 实验二 加载loader -
- -
- 谷建华 -
- -
- 2022-09-20 v0.3 -
- -#### 实验目的 - -1. 学习从boot加载loader的过程. -2. 学习FAT12文件系统. - -#### 实验预习内容 - -1. FAT12的基本格式. -2. BIOS读硬盘扇区的调用的使用方法. -3. 硬盘LBA的地址编码. - -#### 实验内容以及步骤 - -**2022年试点班需要做1、2两个实验,第3个实验想做就做不强求** - -1. 编译构建硬盘启动盘,并挂载到虚拟机上,观察并证实执行流交给了loader - (1) 修改`loader.asm`,使之能够在虚拟机终端中显示`This is {学生自己的名字的拼音}’s boot`. - (2) 编译`boot.asm`和`loader.asm`,生成相应的二进制文件. - (3) 通过`dd`和`mkfs`命令制作一个文件镜像盘,挂载到`/mnt`文件夹,将loader二进制文件写入文件镜像后将boot写入第0个扇区. - (4) 将文件镜像盘作为硬盘启动盘挂载到虚拟机,运行虚拟机观察并记录现象. -2. 观察并记录文件所使用的簇号 - (1) 修改loader文件,能够像boot一样寻找loader.bin. - (2) 编写打印功能将簇号打印在终端里. - (3) 制作硬盘启动盘,运行虚拟机观察并记录现象. - (4) 使用`dd`命令创建一个大小为4KB,名字为`aA1.txt`的文件并写入`a.img`,修改loader寻找`aA1.txt`并打印簇号,运行虚拟机观察并记录现象（此项可能较难,好好利用gdb调试和`xxd a.img | less`查看镜像数据）. -3. 修复损坏的镜像文件（自我提高内容,自己想做就做,不用写进报告,**禁止内卷**） - (1) 我们准备了一个未知的损坏了的镜像文件,其文件系统为FAT12.它的第一张FAT表受到了部分损坏,根目录区也被未知数据覆盖,但万幸的是其余部分均未损坏,你需要根据根据剩下的信息恢复出文件系统中的数据. - (2) 此实验很磨时间,很难,做的同学需要好好对照FAT的官方文档进行学习,需要编写一个C程序仔细分析其中的关键信息并一步步恢复,验证你恢复是否成功可以将它用`mount`挂载并查看里面的数据,里面有我们准备的彩蛋. -4. 结合参考代码,请尝试自己重写boot代码,完成系统引导和加载loader的实验. -#### 实验总结 - -1. 在boot阶段都完成了哪些主要功能？这些功能是如何实现的？如何在引导盘中查找文件loader.bin的？ -2. 为什么FAT12在寻找下一个簇的时候要连续读两个扇区,请通过画图的方式画出边界的几种情况. -3. 如果把引导盘的格式换成FAT32,查找文件loader.bin的过程是什么？ - -#### 实验参考 - -##### 从boot到loader - -在上一节成功制作了硬盘启动盘后,实际上512字节远远不能满足我们的需求,这么点随便写点啥就超出去了,在进入真正的内核kernel之前,要做的东西可不少,加载解析内核文件,进入保护模式,向bios询问设备信息（比如剩余内存,设备树）等等,所以需要一个程序loader作为中间缓冲,它不受文件大小512字节限制. - -在有了loader之后boot的任务一下子就轻松了很多了,它只需要加载loader,并将执行流交给loader即可,仅完成一项工作512字节还是能够应付的. - -假设我们有了loader程序,我们怎么进行加载？要知道在第一个实验里我们的硬盘就只有512字节大,往哪里放loader？一个简单的想法就是直接将loader直接接在boot后面,但是这种方式可扩展性极低,无法存放多个文件,文件信息无法很好的管理.为了解决了这个问题需要一个在磁盘上的持久化的数据结构管理文件信息,上世纪七八十年代微软这帮工程师整出了FAT文件系统,FAT12是第一代,如果有兴趣可以在[这里](https://www.bilibili.com/video/BV1oZ4y1t7ce)听听FAT的历史由来. - -利用FAT文件系统可以有效管理文件,boot作为FAT文件系统的一部分放进了磁盘第0个扇区,然后根据第0个扇区的文件系统信息通过bios中断（分CHS和LBA两种模式,预实验简化了读入方式为LBA）读取磁盘其余扇区,完成loader的加载. - -##### 系统镜像文件的创建 - -在编写了boot和loader两个文件后就需要准备一个镜像文件存放,其中boot写入镜像文件的第0个扇区,loader放进文件系统中存放,根据boot里面的信息规范需要创建一个1.44MB大的镜像,通过`dd`命令创建一个1.44MB大的镜像文件. - -```shell -# if (input file) 读取的文件,这里读取的文件是zero抽象文件,这个文件会输出无尽的0 -# of (output file) 输出的文件,这里输出的地方是a.img镜像文件 -# bs 一次读写的数据字节数 -# count 重复多少次读写 -dd if=/dev/zero of=a.img bs=512 count=2880 -# 在命令结束后可以用stat检查a.img的大小确认 -``` - -在创建好镜像文件后,它现在还不是一个FAT文件系统,这个可以通过`file`命令检查,创建文件系统linux里面有一个命令叫`mkfs`（make filesystem）. - -```shell -mkfs.vfat a.img -``` - -`vfat`指定文件系统类型,尽管FAT系列有很多,但是根据官方文档,`mkfs`根据镜像文件的大小判断该是什么类型,这里会默认生成`FAT12`文件系统,可以通过`file`命令检查. - -在创建完文件系统后就该考虑怎么把loader放进去了,镜像文件可以通过`mount`命令进行挂载,挂载到一个文件夹之后,所有对镜像文件的操作可以抽象成对该文件夹的操作.所以可以通过`cp`命令将loader写入镜像文件. - -```shell -# mount要求sudo权限 -sudo mount a.img /mnt -o loop #挂载到根目录的mnt文件夹,-o loop可以暂时不去理会 -sudo cp ./loader.bin /mnt #将loader拷贝过去后文件镜像里就写入了loader的数据 -sudo umount /mnt #解除挂载,可能会失败,如果没成功需要多执行几次 -``` - -将loader写入文件镜像后最后一步就要将boot写入第0个扇区. - -```shell -# conv=notrunc 如果这句命令不加上的话a.img又变回512字节大小了 -# no truncate 不会在写文件前让a.img强制置回0字节 -dd if=boot.bin of=a.img bs=512 count=1 conv=notrunc -``` - -这样`a.img`就可以当做硬盘启动盘,放进qemu虚拟机模拟运行了. - -```shell -qemu-system-i386 \ --boot order=c \ --drive file=a.img,format=raw -``` - -##### 磁盘扇区的读写 - -在boot加载loader的过程中读取磁盘是靠着13h中断命令,通过中断让bios将磁盘中的数据读到内存中,读取方式有CHS（C:柱面,H:磁头,S:扇区）和LBA（Logical Block Addressing）两种.Orange教材用的是软盘CHS读取方式,读取一个扇区需要经过复杂的运算（柱面、磁道、扇区都要计算）.这次使用了更简单的LBA读取方式,它只需要读入的逻辑扇区号就可以直接将磁盘上的文件读入,只需要传入一个结构体指针就可以进行读取. - -LBA读入方式使用的是bios的int 13h扩展读功能,扩展读功能的标识号ah=0x42,LBA最核心的是要往里面传入一个结构体参数,写成C语言的struct类似长这样： - -```c -struct buffer_packet { - short buffer_packet_size; - short sectors; - char *buffer; - long long start_sectors; - long long *l_buffer; -}; -``` - -+ `buffer_packet_size`：描述这个结构体的字节数（值为0x10或0x18,区别在于最后一个`l_buffer`是否启用）.2字节 -+ `sectors`：从`start_sectors`开始需要连续读入的扇区数.2字节 -+ `buffer`：如果结构体大小为0x10,这个参数启用,描述接受磁盘数据的缓冲区地址.4字节,其高2字节为段寄存器值,其低2字节为偏移量 -+ `start_sectors`：磁盘中第几个逻辑扇区开始读入.8字节 -+ `l_buffer`：如果结构体大小为0x18,这个参数启用,描述接受磁盘数据的缓冲区地址.8字节. - -调用int 13h中断时的寄存器参数设置如下： - -+ ah=0x42 -+ dl=驱动号（模拟器里为硬盘镜像,驱动号为0x80） -+ ds:si=指向`buffer_packet`结构体的指针地址 - -通过调用int 13h将数据从持久化设备（磁盘）中读入到内存中,这样可以完成数据的加载. -##### 修复文件系统 - -修复文件系统说简单也简单,说难也难,如果不熟悉文件系统的话学习成本会巨高.在之前的实验,我们使用的是文件系统功能的子集,而修复文件系统需要知道它的全集,要不然从哪里修复都不知道,博客基本上是无法把所有东西讲清楚,所以**RTFM**是最有效的方法. - -当你脑中有一个设计知道怎么去做的时候,你又会发现第二个难题：你的实现能力跟不上了.在你们大学的前几年,可能说自己做了几个项目,但是实际情况上是用高级语言调用几个API就可以完成,难度在于建模,以及怎么跟数据打交道,并没有对底层有过太多的交互. - -大部分情况下我们都是在做计算型的编程,只要运算出来输出就完事了,而这次你需要独自面对系统,python这种高级语言可能会给你帮倒忙,因为它不太适合处理这种情况.你所能做的就只有拿着C/Cpp,以及一堆由glibc（比如printf,puts这些常用函数）包装好的API与内核进行交互. - -虽然同样是API,glibc的API相当的底层,需要`man`命令好好阅读相关函数调用的细节,不要惧怕英文.靠自己查博客绝对会把自己查晕,实现半天发现函数干的跟自己想的不一样 ~~(我曾经相信csdn)~~. - -在你们实现中会遇到另一个可怕的事情就是：struct结构体,如果你直接实现你会惊喜地发现可能结构体跟你想的不那么一致,~~不是语言不行,是你不懂语言~~. - -在实现时推荐大家使用一种防御性编程`assert(expr)`,就是当expr表达式的值为False时程序会及时奔溃并告诉你奔溃的位置.如果不想让自己的程序出太多离谱的错还要花大量时间尝试,就应该使用这种方式,在各种你觉得可能会出问题的地方加上一个`assert`. - -如果你通过一步步翻文档,一步步独立调错终于把镜像文件给恢复正确,你就能够看到我们精心准备的**彩蛋**,这给你的成就感会相当的大,如果会读手册,并有一定的实现能力你会发现你能干更多事,那些看上去很牛逼的玩意实际上你也能够实现. \ No newline at end of file