Makefile 63 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358
  1. # NebOS top-level build.
  2. #
  3. # Source tree:
  4. # boot/ real-mode boot sector, MBR, VESA stage, UEFI loader (boot/efi)
  5. # kernel/ the 32-bit kernel (kernel.ld, drivers, services)
  6. # common/ freestanding code linked into both the kernel and userland
  7. # include/ ABI headers shared by boot, kernel, userland and host tools
  8. # user/apps/<n>/ one directory per ring-3 program (ucmd_<n>.c + its modules)
  9. # user/lib/<l>/ ring-3 libraries (libc, ngui, ufont, img, tls, uhttp, ...)
  10. # tools/ host-side tools (mkpack, mkrootfs, kexec_send, ...)
  11. # host/ Linux SDL3 browser harness
  12. #
  13. # Intermediate objects go to build/ (mirroring the source paths). The images
  14. # and the artifacts the dev workflow uses (kernel.elf, kernel.bin, floppy.img,
  15. # usb.img, usb-efi.img, BOOTX64.EFI, cmds.pack, browser.elf, ...) stay at the
  16. # top level, so every make target and command line works as before.
  17. CC = gcc
  18. AS = as
  19. LD = ld
  20. OBJCOPY = objcopy
  21. B = build
  22. # -march=i586: first-gen Pentium (P5); avoids CMOV etc. (P6+)
  23. CFLAGS = -ffreestanding -fno-pie -m32 -march=i586 -nostdlib -fno-stack-protector \
  24. -fno-asynchronous-unwind-tables -mno-sse -mno-sse2 -mno-mmx \
  25. -Wall -Wextra -O2 -c
  26. # Ring-3 objects are compiled with function sections so the browser link can
  27. # drop code it never reaches; the legacy rootfs pack is close to its cap.
  28. SECTION_CFLAGS = -ffunction-sections -fdata-sections
  29. # Header dependencies are generated by the compiler (build/**/*.d).
  30. DEPFLAGS = -MMD -MP
  31. ASFLAGS = --32
  32. # NOWM=1 builds a diagnostic kernel that boots to the console without the
  33. # window manager (make nowm).
  34. NOWM ?= 0
  35. ifeq ($(NOWM),1)
  36. CFLAGS += -DNOWM
  37. endif
  38. # Include paths. The kernel sees only its own headers plus the shared ABI and
  39. # common code; ring-3 code sees the user libraries. Quoted includes of a
  40. # file's own directory need no -I (e.g. an app's private headers).
  41. USER_LIB_DIRS = $(sort $(dir $(wildcard user/lib/*/)))
  42. USER_LIB_DIRS := $(filter-out user/lib/libc/,$(USER_LIB_DIRS))
  43. KERNEL_INC = -Iinclude -Icommon -Ikernel
  44. USER_INC = -Iinclude -Icommon -Iuser $(patsubst %/,-I%,$(USER_LIB_DIRS))
  45. LIBC_INC = -Iuser/lib/libc/include
  46. # QuickJS (third_party/quickjs, see its VENDOR file) is the browser's
  47. # JavaScript engine. -nostdinc keeps host headers from leaking into the
  48. # freestanding build; __nebos__ selects the local patches.
  49. QJS_DIR = third_party/quickjs
  50. QJS_CFLAGS = $(CFLAGS) -O1 $(SECTION_CFLAGS) -nostdinc $(LIBC_INC) \
  51. -I$(QJS_DIR) -fno-builtin -w -D__nebos__ -U__linux__ \
  52. -U__gnu_linux__ -U__unix__ -U__GLIBC__ -DNDEBUG \
  53. -DCONFIG_VERSION='"2026-06-04"'
  54. QJS_OBJS = $(addprefix $(B)/$(QJS_DIR)/,quickjs.o cutils.o dtoa.o \
  55. libregexp.o libunicode.o)
  56. # UEFI loader: a PE32+ x86-64 EFI application built with the mingw toolchain.
  57. # The kernel itself stays 32-bit; the loader leaves long mode before jumping.
  58. EFI_CC ?= x86_64-w64-mingw32-gcc
  59. EFI_AS ?= x86_64-w64-mingw32-as
  60. EFI_CFLAGS = -ffreestanding -fno-stack-protector -mno-red-zone -fno-builtin \
  61. -fno-asynchronous-unwind-tables -fno-unwind-tables -O2 \
  62. -Wall -Wextra -Iinclude -Ikernel -Iboot/efi -I$(B)/boot/efi
  63. EFI_LDFLAGS = -nostdlib -Wl,--subsystem,10 -Wl,-e,efi_main \
  64. -Wl,--image-base,0x0 -Wl,--dynamicbase \
  65. -Wl,--enable-reloc-section -Wl,--no-insert-timestamp
  66. .PHONY: all clean run run-smp run-floppy run-usb run-uhci run-ehci run-ehci-asix run-xhci run-xhci-asix run-net run-rndis run-e1000 run-ahci run-amd test-amd test-usb test-install run-serial floppy usb uefi run-uefi test-uefi flash dev net-dev net-install cmds-dev net-cmds browser-dev gallery-dev compat-serve netmon monitor test-crypto test-wpa test-ccmp test-images test-images-asan test-libc test-js test-font test-font-asan test-svg test-touchpad test-hid test-chat test-chat-e2e test-wifi-store test-cursors fonts appicons kernel-dev kernel-net-dev rootfs nowm
  67. all: floppy.img usb.img final.bin root.img image.bin
  68. # ---- Generic compile rules -------------------------------------------------
  69. #
  70. # Per-object variations are target-specific variables on the .o:
  71. # OPT optimisation override appended after CFLAGS' -O2 (-Os, -Oz)
  72. # XFLAGS extra flags (function sections, libc headers, -fwrapv, ...)
  73. $(B)/kernel/%.o: kernel/%.c
  74. @mkdir -p $(@D)
  75. $(CC) $(CFLAGS) $(OPT) $(XFLAGS) $(KERNEL_INC) $(DEPFLAGS) -o $@ $<
  76. $(B)/common/%.o: common/%.c
  77. @mkdir -p $(@D)
  78. $(CC) $(CFLAGS) $(SECTION_CFLAGS) -Icommon $(DEPFLAGS) -o $@ $<
  79. # Ring-3 C: by default the libc headers are visible (the old ucmd_%.o rule);
  80. # objects that were always built freestanding clear XFLAGS below.
  81. $(B)/user/%.o: XFLAGS = $(LIBC_INC)
  82. $(B)/user/%.o: user/%.c
  83. @mkdir -p $(@D)
  84. $(CC) $(CFLAGS) $(OPT) $(XFLAGS) $(USER_INC) $(DEPFLAGS) -o $@ $<
  85. $(B)/%.o: %.S
  86. @mkdir -p $(@D)
  87. $(AS) $(ASFLAGS) -I$(<D) -o $@ $<
  88. $(B)/$(QJS_DIR)/%.o: $(QJS_DIR)/%.c
  89. @mkdir -p $(@D)
  90. $(CC) $(QJS_CFLAGS) $(DEPFLAGS) -o $@ $<
  91. # ---- Kernel ----------------------------------------------------------------
  92. # Link order is part of the image layout: keep it stable. vesa_stage comes
  93. # from boot/ (it is the 0x7E00 entry), font_8x16/inflate from common/.
  94. KERNEL_LINK_ORDER = vesa_stage entry kernel timer switch sched process init mm \
  95. kmalloc paging elf tss syscall sys_wm syscall_stub screen io tty rtc \
  96. terminal wm reboot poweroff disk fat serial serial_ring_buf serial_loop \
  97. vga blit cpu thermal it87 tpec ec cros_ec ideapad power_src power vga_copy \
  98. gfxbench gpu backlight ati cirrus intel nvidia nv50 radeon mtrr \
  99. font_8x8 font_8x16 fbtext gfx display cursor mouse i2c touchpad \
  100. touchpad_gesture uhci ohci ehci xhci asix rndis iwl_trans iwl_mvm \
  101. iwl_dvm wifi_fw rtl8821au wifi ccmp usb usbmsc hid_report usbhid lsusb panic \
  102. bootcon blkdev sdhci ata ahci fatdetect fatformat format install vfs \
  103. sys_fs sys_info sys_mem sys_net idle kexec kexec_tramp dbg lspci peek \
  104. ne2000 r8168 e1000e netdev net netcore netkexec netlog dhcp dns ntp tcp \
  105. acpi ioapic lapic smp ap_tramp_embed inflate ramfs share payload
  106. kobj = $(if $(filter vesa_stage,$(1)),$(B)/boot/$(1).o,$(if $(filter \
  107. font_8x16 inflate,$(1)),$(B)/common/$(1).o,$(B)/kernel/$(1).o))
  108. KERNEL_OBJS = $(foreach n,$(KERNEL_LINK_ORDER),$(call kobj,$(n)))
  109. # Size-sensitive kernel objects build -Os. wm/sys_wm carry the settings
  110. # ABI; at -O2 their extra .text/.data pushed the .data end across a page
  111. # boundary and moved the 4 KB-aligned BSS by a whole page.
  112. KERNEL_OS = terminal disk fat nvidia nv50 uhci ohci ehci xhci asix rndis \
  113. iwl_trans iwl_mvm iwl_dvm wifi_fw rtl8821au wifi ccmp usb lsusb lspci \
  114. peek ne2000 r8168 blkdev fatdetect fatformat format install usbmsc dbg vfs \
  115. wm sys_wm ideapad i2c touchpad hid_report usbhid
  116. $(addprefix $(B)/kernel/,$(addsuffix .o,$(KERNEL_OS))): OPT = -Os
  117. # bootcon.c carries the unified boot/serial/scan log reader; at -O2 its extra
  118. # text moved the .data end across a page boundary and shifted the 4 KB-aligned
  119. # BSS by a whole page, which the 0x90000 wall cannot afford.
  120. $(B)/kernel/bootcon.o: OPT = -Os
  121. $(B)/kernel/e1000e.o: OPT = -Oz
  122. # The ACPI table/S5 parser and the poweroff path are cold boot/shutdown code
  123. # and the kernel is close to the low-memory wall; squeeze them hard.
  124. $(B)/kernel/acpi.o: OPT = -Oz
  125. $(B)/kernel/poweroff.o: OPT = -Oz
  126. $(B)/kernel/reboot.o: OPT = -Oz
  127. $(B)/kernel/terminal.o: OPT = -Oz
  128. # process.o is the largest -O2 object and not on a drawing path; -Oz keeps
  129. # the kernel under the 0x90000 wall now that S5/reset live in it.
  130. $(B)/kernel/process.o: OPT = -Oz
  131. # The AP trampoline is linked at 0x6000 and embedded as a binary blob; ld
  132. # names its symbols after the input path, so run it inside the build dir
  133. # (smp.c expects _binary_ap_tramp_bin_start).
  134. $(B)/kernel/ap_tramp.elf: $(B)/kernel/ap_tramp.o kernel/ap_tramp.ld
  135. $(LD) -T kernel/ap_tramp.ld -nostdlib -m elf_i386 -o $@ $<
  136. $(B)/kernel/ap_tramp.bin: $(B)/kernel/ap_tramp.elf
  137. $(OBJCOPY) -O binary $< $@
  138. $(B)/kernel/ap_tramp_embed.o: $(B)/kernel/ap_tramp.bin
  139. cd $(B)/kernel && $(LD) -m elf_i386 -r -b binary -o ap_tramp_embed.o ap_tramp.bin
  140. kernel.elf: kernel/kernel.ld $(KERNEL_OBJS)
  141. $(LD) -T kernel/kernel.ld -nostdlib -m elf_i386 -o $@ $(KERNEL_OBJS)
  142. kernel.bin: kernel.elf
  143. $(OBJCOPY) -O binary $< $@
  144. # ---- Boot sector and MBR ---------------------------------------------------
  145. $(B)/boot/boot.elf: $(B)/boot/boot.o boot/linker.ld
  146. $(LD) -T boot/linker.ld -nostdlib -m elf_i386 -o $@ $<
  147. $(B)/boot/mbr.elf: $(B)/boot/mbr.o boot/mbr.ld
  148. $(LD) -T boot/mbr.ld -nostdlib -m elf_i386 -o $@ $<
  149. mbr.bin: $(B)/boot/mbr.elf
  150. $(OBJCOPY) -O binary $< $@
  151. boot.bin: $(B)/boot/boot.elf
  152. $(OBJCOPY) -O binary --only-section=.boot $< $@.tmp
  153. dd if=$@.tmp of=$@ bs=1 count=510 2>/dev/null
  154. printf '\x55\xaa' >> $@
  155. rm -f $@.tmp
  156. # Byte offsets inside boot.bin (see boot.S). Keep decimal: dd's seek= does not
  157. # parse 0x… literals (it silently treats them as 0) and the error is hidden by
  158. # the 2>/dev/null below.
  159. # 62 = kernel_sectors field (0x3E)
  160. # 64 = kernel_lba field (0x40, word; LBA 64 fits in the low byte)
  161. # 66 = pack_lba field (0x42, dword; rootfs image LBA)
  162. KERNEL_SECTORS_OFFSET = 62
  163. BOOT_SECTOR_START_OFFSET = 64
  164. PACK_LBA_OFFSET = 66
  165. # USB rootfs partition (type 0x7F) and UEFI ESP (type 0xEF). Partition 1
  166. # has room for a 512 KB kernel; the rootfs starts after it at LBA 1088.
  167. # The header and the 242 KB gzip pack are still inside the first 1.44 MB.
  168. ROOTFS_LBA = 1088
  169. ROOTFS_SECTORS = 16384
  170. ESP_LBA = 18432
  171. # Patch a little-endian 16/32-bit value into a boot-sector copy. Usage:
  172. # $(call patch16,file,offset,value)
  173. # (shell snippets are inlined below because make functions cannot easily
  174. # expand `$$(...)` arithmetic; the helpers keep the rules readable.)
  175. patch32 = printf "$$(printf '\\x%02x\\x%02x\\x%02x\\x%02x' \
  176. $$(( ( ($(2)) >> 0) & 0xFF )) $$(( ( ($(2)) >> 8) & 0xFF )) \
  177. $$(( ( ($(2)) >> 16) & 0xFF )) $$(( ( ($(2)) >> 24) & 0xFF )))" | \
  178. dd of=$(1) bs=1 seek=$(3) conv=notrunc 2>/dev/null
  179. patch16 = printf "$$(printf '\\x%02x\\x%02x' \
  180. $$(( ( ($(2)) >> 0) & 0xFF )) $$(( ( ($(2)) >> 8) & 0xFF )))" | \
  181. dd of=$(1) bs=1 seek=$(3) conv=notrunc 2>/dev/null
  182. floppy.img: boot.bin kernel.bin rootfs.bin
  183. SECTORS=$$(( ($$(stat -c%s kernel.bin) + 511) / 512 )); \
  184. cp boot.bin $@.boot.tmp; \
  185. $(call patch16,$@.boot.tmp,$$SECTORS,$(KERNEL_SECTORS_OFFSET)); \
  186. $(call patch32,$@.boot.tmp,1 + SECTORS,$(PACK_LBA_OFFSET)); \
  187. cat $@.boot.tmp kernel.bin > $@; \
  188. PAD=$$(( SECTORS * 512 - $$(stat -c%s kernel.bin) )); \
  189. dd if=/dev/zero bs=1 count=$$PAD 2>/dev/null >> $@; \
  190. cat rootfs.bin >> $@; \
  191. SIZE=$$(stat -c%s $@); \
  192. if [ $$SIZE -gt 1474560 ]; then \
  193. echo "error: floppy.img is $$SIZE bytes; max is 1474560"; \
  194. rm -f $@; exit 1; \
  195. fi; \
  196. truncate -s 1474560 $@; \
  197. rm -f $@.boot.tmp
  198. usb.img: mbr.bin boot.bin kernel.bin cmds.img
  199. SECTORS=$$(( ($$(stat -c%s kernel.bin) + 511) / 512 )); \
  200. cp boot.bin $@.boot.tmp; \
  201. $(call patch16,$@.boot.tmp,$$SECTORS,$(KERNEL_SECTORS_OFFSET)); \
  202. printf '\x40' | dd of=$@.boot.tmp bs=1 seek=$(BOOT_SECTOR_START_OFFSET) conv=notrunc 2>/dev/null; \
  203. $(call patch32,$@.boot.tmp,$(ROOTFS_LBA),$(PACK_LBA_OFFSET)); \
  204. cat mbr.bin > $@; \
  205. dd if=/dev/zero bs=512 count=62 2>/dev/null >> $@; \
  206. cat $@.boot.tmp kernel.bin >> $@; \
  207. truncate -s 9M $@; \
  208. dd if=cmds.img of=$@ bs=512 seek=$(ROOTFS_LBA) conv=notrunc 2>/dev/null; \
  209. printf '\x00\x11\x12\x00\x7f\x16\x15\x01\x40\x04\x00\x00\x00\x40\x00\x00' | \
  210. dd of=$@ bs=1 seek=462 conv=notrunc 2>/dev/null; \
  211. rm -f $@.boot.tmp
  212. image.bin: floppy.img
  213. cp floppy.img image.bin
  214. final.bin: boot.bin kernel.bin rootfs.bin
  215. SECTORS=$$(( ($$(stat -c%s kernel.bin) + 511) / 512 )); \
  216. cp boot.bin $@.boot.tmp; \
  217. $(call patch16,$@.boot.tmp,$$SECTORS,$(KERNEL_SECTORS_OFFSET)); \
  218. $(call patch32,$@.boot.tmp,1 + SECTORS,$(PACK_LBA_OFFSET)); \
  219. cat $@.boot.tmp kernel.bin > $@; \
  220. PAD=$$(( SECTORS * 512 - $$(stat -c%s kernel.bin) )); \
  221. dd if=/dev/zero bs=1 count=$$PAD 2>/dev/null >> $@; \
  222. cat rootfs.bin >> $@; \
  223. rm -f $@.boot.tmp
  224. # ---- UEFI loader and dual-boot USB image -------------------------------
  225. #
  226. # The legacy image (usb.img) is left byte-for-byte alone. usb-efi.img copies
  227. # it, adds a third MBR partition (type 0xEF, starting at the old 64 MB end)
  228. # and writes a small FAT16 ESP there. BIOS booting still uses the active
  229. # partition 1 at LBA 63; UEFI finds BOOTX64.EFI in the ESP.
  230. $(B)/boot/efi/efi_entry.h: kernel.elf
  231. @mkdir -p $(@D)
  232. @entry=$$(nm kernel.elf | awk '/ T kernel_entry$$/{print $$1}'); \
  233. if [ -z "$$entry" ]; then echo "efi: kernel_entry not found" >&2; exit 1; fi; \
  234. printf '#define KERNEL_ENTRY 0x%s\n' "$$entry" > $@
  235. $(B)/boot/efi/main.o: boot/efi/main.c $(B)/boot/efi/efi_entry.h
  236. @mkdir -p $(@D)
  237. $(EFI_CC) $(EFI_CFLAGS) $(DEPFLAGS) -c -o $@ $<
  238. # payload.S embeds kernel.bin and cmds_pack_gz.bin (top level) and tramp.bin.
  239. $(B)/boot/efi/payload.o: boot/efi/payload.S kernel.bin cmds_pack_gz.bin $(B)/boot/efi/tramp.bin
  240. $(EFI_AS) --64 -I$(B)/boot/efi -o $@ $<
  241. $(B)/boot/efi/tramp.o: boot/efi/tramp.S
  242. @mkdir -p $(@D)
  243. $(AS) --64 -o $@ $<
  244. $(B)/boot/efi/tramp.elf: $(B)/boot/efi/tramp.o boot/efi/tramp.ld
  245. $(LD) -T boot/efi/tramp.ld -nostdlib -m elf_x86_64 -o $@ $<
  246. $(B)/boot/efi/tramp.bin: $(B)/boot/efi/tramp.elf
  247. $(OBJCOPY) -O binary $< $@
  248. BOOTX64.EFI: $(B)/boot/efi/main.o $(B)/boot/efi/payload.o
  249. $(EFI_CC) $(EFI_LDFLAGS) -o $@ $^
  250. ESP_SECTORS = 16384
  251. esp.img: BOOTX64.EFI
  252. truncate -s $$(( $(ESP_SECTORS) * 512 )) $@
  253. mkfs.fat -F 16 -s 2 -n NEBOSESP $@
  254. mmd -i $@ ::/EFI
  255. mmd -i $@ ::/EFI/BOOT
  256. mcopy -i $@ BOOTX64.EFI ::/EFI/BOOT/BOOTX64.EFI
  257. usb-efi.img: usb.img esp.img
  258. cp usb.img $@
  259. # The legacy partition is a raw kernel blob with a deliberately empty
  260. # BPB (boot.S), so neither UEFI firmware nor VFS mistakes it for FAT.
  261. # Partition 3: ESP at LBA 18432, type 0xEF, 8 MB (partition 2 is the
  262. # rootfs at LBA 1088 written by usb.img).
  263. printf '\x00\xfe\xff\xff\xef\xfe\xff\xff\x00\x48\x00\x00\x00\x40\x00\x00' | \
  264. dd of=$@ bs=1 seek=478 conv=notrunc 2>/dev/null
  265. dd if=esp.img of=$@ bs=512 seek=$(ESP_LBA) conv=notrunc 2>/dev/null
  266. truncate -s $$(( ($(ESP_LBA) + $(ESP_SECTORS)) * 512 )) $@
  267. uefi: usb-efi.img
  268. # ---- Ring-3 libraries ------------------------------------------------------
  269. U = $(B)/user
  270. UL = $(B)/user/lib
  271. # libc: a static archive linked only into commands that use it. The archive
  272. # means apps that never reference malloc/string keep paying nothing, and
  273. # --gc-sections drops unused functions from the members that are pulled.
  274. LIBC_OBJS = $(addprefix $(UL)/libc/,malloc.o string.o strdup.o stdlib.o \
  275. ucmd_mem.o setjmp.o errno.o div64.o dtoa.o stdio.o \
  276. stdio_file.o math.o time.o)
  277. LIBC_A = $(UL)/libc/libc.a
  278. $(filter-out %/setjmp.o,$(LIBC_OBJS)): OPT = -Os
  279. $(filter-out %/setjmp.o,$(LIBC_OBJS)): XFLAGS = $(SECTION_CFLAGS) -fno-builtin $(LIBC_INC)
  280. $(LIBC_A): $(LIBC_OBJS)
  281. rm -f $@
  282. ar rcs $@ $^
  283. # 8x16 bitmap font and DEFLATE: shared with the kernel (common/).
  284. FONT16 = $(B)/common/font_8x16.o
  285. INFLATE = $(B)/common/inflate.o
  286. # Fixed-point TrueType text engine, linked only into GUI commands.
  287. UFONT_OBJS = $(addprefix $(UL)/ufont/,ufont.o ufont_ttf.o ufont_draw.o ufont_file.o)
  288. $(UFONT_OBJS): OPT = -Os
  289. $(UFONT_OBJS): XFLAGS = $(SECTION_CFLAGS) $(LIBC_INC)
  290. $(UL)/ufont/ufont_ttf.o: OPT = -O2
  291. # WOFF 1.0 unwrapping needs inflate, so only the browser links it.
  292. UFONT_WOFF = $(UL)/ufont/ufont_woff.o
  293. $(UFONT_WOFF): OPT = -Os
  294. $(UFONT_WOFF): XFLAGS = $(SECTION_CFLAGS) $(LIBC_INC)
  295. # ngui: the userland immediate-mode GUI toolkit. -Os: every GUI app links
  296. # the whole toolkit, and the rootfs pack has a cap.
  297. NGUI = $(UL)/ngui/ngui.o
  298. $(NGUI): OPT = -Os
  299. $(NGUI): XFLAGS = $(SECTION_CFLAGS) $(LIBC_INC)
  300. NGUI_FILE = $(UL)/ngui/ngui_file.o
  301. $(NGUI_FILE): OPT = -Os
  302. $(NGUI_FILE): XFLAGS = $(SECTION_CFLAGS) $(LIBC_INC)
  303. NGUI_APP = $(NGUI) $(NGUI_FILE) $(FONT16) $(UFONT_OBJS)
  304. # Window-manager/terminal drawing helpers (wm and term).
  305. UWM = $(UL)/uwm/uwm_lib.o
  306. $(UWM): OPT = -Os
  307. $(UWM): XFLAGS = $(SECTION_CFLAGS) $(LIBC_INC)
  308. # Image library: pure freestanding decoders + RGB565 compositing.
  309. IMGLIB_OBJS = $(addprefix $(UL)/img/,img.o img_mem.o img_blit.o img_png.o \
  310. img_bmp.o img_gif.o img_jpeg.o img_tga.o img_pnm.o img_ico.o \
  311. img_pam.o img_gif_anim.o img_file.o)
  312. IMG_DECODE_OBJS = $(addprefix $(UL)/img/,img.o img_mem.o img_blit.o img_png.o \
  313. img_bmp.o img_gif.o img_jpeg.o img_tga.o img_pnm.o img_ico.o \
  314. img_pam.o)
  315. $(IMGLIB_OBJS): XFLAGS = $(SECTION_CFLAGS)
  316. # The integer IDCT deliberately relies on 32-bit wrap-around.
  317. $(UL)/img/img_jpeg.o: XFLAGS = $(SECTION_CFLAGS) -fwrapv
  318. # TLS 1.3/1.2 client library (curl, chat and the browser; see tls.h). The
  319. # crypto files are pure freestanding C, so tls_test exercises them on the
  320. # host (make test-crypto). TLS 1.2 adds AES-128-GCM (on wpa_crypto.c's AES)
  321. # and P-256 ECDH.
  322. TLSLIB_OBJS = $(addprefix $(UL)/tls/,tls_sha256.o tls_chacha20.o tls_x25519.o \
  323. tls_gcm.o tls_p256.o wpa_crypto.o tls_rng.o tls.o)
  324. $(TLSLIB_OBJS): XFLAGS = $(SECTION_CFLAGS)
  325. $(UL)/tls/wpa_crypto.o: OPT = -O2
  326. # Shared HTTP/TLS client (curl, the browser and chat), its cookie jar and the
  327. # JSON parser. The jar and the parser have host tests (make test-chat).
  328. UHTTP_OBJS = $(UL)/uhttp/uhttp.o $(UL)/uhttp/uhttp_cookie.o
  329. UJSON = $(UL)/ujson/ujson.o
  330. $(UHTTP_OBJS) $(UJSON): XFLAGS = $(SECTION_CFLAGS)
  331. $(UL)/uhttp/uhttp_cookie.o $(UJSON): OPT = -Os
  332. # WiFi saved-network list (wifi, netmenu) and the WPA2-PSK supplicant.
  333. WIFI_STORE = $(UL)/wifi/wifi_store.o
  334. WPA_OBJS = $(UL)/wifi/wpa.o $(UL)/tls/wpa_crypto.o
  335. $(UL)/wifi/wpa.o: OPT = -Os
  336. $(UL)/wifi/wpa.o: XFLAGS = $(SECTION_CFLAGS)
  337. # ---- Ring-3 programs -------------------------------------------------------
  338. #
  339. # Every program lives in user/apps/<name>/ with its entry file ucmd_<name>.c
  340. # and is packed as bin/<name>. New command: create user/apps/<name>/
  341. # ucmd_<name>.c and add <name> to UCMDS (the order is the pack order). A
  342. # single-file command needs nothing else; one that links libraries gets an
  343. # explicit .elf rule below.
  344. UCMDS = cpuinfo ls cat save rm mkdir rmdir \
  345. meminfo mouseinfo storage top process bootscan \
  346. clock colors edit textedit wm term spin \
  347. netinfo netip netdns host dhcp \
  348. netsend netrecv ping pong netlog \
  349. netconsole netregs netloop netreset net100 netmac curl \
  350. files view sensors powerinfo mines solitaire \
  351. settime date gallery websrv browser chat \
  352. wifi netmenu settings disks membench init service
  353. app = $(U)/apps/$(1)/ucmd_$(1)
  354. UCMD_ELFS = $(foreach a,$(UCMDS),$(call app,$(a)).elf)
  355. .PRECIOUS: $(UCMD_ELFS)
  356. UCMD_LD = user/ucmd.ld
  357. # Link a ring-3 ELF at USER_BASE, dropping unreferenced sections.
  358. ULINK = $(LD) -T $(UCMD_LD) -z max-page-size=0x100 --gc-sections -nostdlib \
  359. -m elf_i386 -o $@ $(filter-out $(UCMD_LD),$^) && \
  360. $(OBJCOPY) --strip-all $@ $@
  361. # Single-file commands: no libc, no section GC.
  362. $(U)/apps/%.elf: $(U)/apps/%.o $(UCMD_LD)
  363. $(LD) -T $(UCMD_LD) -z max-page-size=0x100 -nostdlib -m elf_i386 -o $@ $<
  364. $(OBJCOPY) --strip-all $@ $@
  365. # Objects that were always compiled without the libc headers.
  366. $(call app,edit).o $(call app,textedit).o $(call app,wm).o \
  367. $(call app,files).o $(call app,mines).o \
  368. $(call app,settime).o $(call app,solitaire).o $(U)/apps/gallery/gallery.o \
  369. $(U)/apps/hello/hello.o: XFLAGS =
  370. $(call app,textedit).o $(call app,settime).o $(call app,solitaire).o: OPT = -Os
  371. # Both link with --gc-sections; the section-per-function build lets the pack
  372. # drop their unreachable helpers (the rootfs cap is tight).
  373. $(call app,wm).o: XFLAGS = $(SECTION_CFLAGS)
  374. $(call app,view).o: XFLAGS = $(SECTION_CFLAGS) $(LIBC_INC)
  375. $(call app,wm).o $(call app,view).o: OPT = -Os
  376. # membench times memcpy/memset over a libc heap buffer.
  377. $(call app,membench).elf: $(call app,membench).o $(UCMD_LD) $(LIBC_A)
  378. $(ULINK)
  379. # websrv buffers its whole PUT/GET body on the libc heap.
  380. $(call app,websrv).elf: $(call app,websrv).o $(UCMD_LD) $(LIBC_A)
  381. $(ULINK)
  382. # edit draws text itself, so it links the 8x16 font into its ELF.
  383. $(call app,edit).elf: $(call app,edit).o $(FONT16) $(UCMD_LD)
  384. $(LD) -T $(UCMD_LD) -z max-page-size=0x100 -nostdlib -m elf_i386 -o $@ $(filter %.o,$^)
  385. $(OBJCOPY) --strip-all $@ $@
  386. # The ring-3 WM draws its own chrome; term renders its own cells. term also
  387. # reads the kernel's key codes (io.h) and VFS_PATH_MAX (vfs.h).
  388. $(call app,term).o: XFLAGS = $(LIBC_INC) -Ikernel
  389. $(call app,wm).elf: $(call app,wm).o $(UWM) $(FONT16) $(UFONT_OBJS) $(UCMD_LD) $(LIBC_A)
  390. $(ULINK)
  391. $(call app,term).elf: $(call app,term).o $(UWM) $(FONT16) $(UFONT_OBJS) $(UCMD_LD) $(LIBC_A)
  392. $(ULINK)
  393. # ngui canvas apps.
  394. $(call app,files).elf: $(call app,files).o $(NGUI_APP) $(UCMD_LD) $(LIBC_A)
  395. $(ULINK)
  396. # Textedit: Notepad-like plain text editor built on ngui_text_area().
  397. $(call app,textedit).elf: $(call app,textedit).o $(NGUI_APP) $(UCMD_LD) $(LIBC_A)
  398. $(ULINK)
  399. # Task manager: process table with CPU, memory and network history graphs.
  400. $(call app,process).elf: $(call app,process).o $(NGUI_APP) $(UCMD_LD) $(LIBC_A)
  401. $(ULINK)
  402. # Boot scan window: live tail of the bootscan kernel thread's serial output.
  403. $(call app,bootscan).elf: $(call app,bootscan).o $(NGUI_APP) $(UCMD_LD) $(LIBC_A)
  404. $(ULINK)
  405. $(call app,bootscan).o: OPT = -Os
  406. $(call app,mines).elf: $(call app,mines).o $(NGUI_APP) $(UCMD_LD) $(LIBC_A)
  407. $(ULINK)
  408. $(call app,settime).elf: $(call app,settime).o $(NGUI_APP) $(UCMD_LD) $(LIBC_A)
  409. $(ULINK)
  410. $(call app,solitaire).elf: $(call app,solitaire).o $(NGUI_APP) $(UCMD_LD) $(LIBC_A)
  411. $(ULINK)
  412. $(call app,view).elf: $(call app,view).o $(IMGLIB_OBJS) $(INFLATE) $(NGUI_APP) $(UCMD_LD) $(LIBC_A)
  413. $(ULINK)
  414. $(call app,curl).elf: $(call app,curl).o $(UHTTP_OBJS) $(IMG_DECODE_OBJS) $(INFLATE) $(TLSLIB_OBJS) $(UCMD_LD) $(LIBC_A)
  415. $(ULINK)
  416. $(call app,wifi).elf: $(call app,wifi).o $(WIFI_STORE) $(WPA_OBJS) $(UL)/tls/tls_rng.o $(UL)/tls/tls_sha256.o $(UCMD_LD) $(LIBC_A)
  417. $(ULINK)
  418. # Control panel: battery/clock summary, brightness and the Settings pills.
  419. $(call app,netmenu).elf: $(call app,netmenu).o $(NGUI_APP) $(UCMD_LD) $(LIBC_A)
  420. $(ULINK)
  421. # Settings: sidebar sections, network/WiFi management, clock, power,
  422. # appearance (wallpaper picker) and window-manager preferences.
  423. $(call app,settings).o: OPT = -Os
  424. $(call app,settings).o: XFLAGS = $(SECTION_CFLAGS) $(LIBC_INC)
  425. $(call app,settings).elf: $(call app,settings).o $(WIFI_STORE) $(IMG_DECODE_OBJS) $(UL)/img/img_file.o $(INFLATE) $(NGUI_APP) $(UCMD_LD) $(LIBC_A)
  426. $(ULINK)
  427. # Storage manager: devices, partitions, mount policies, format/install.
  428. $(call app,disks).elf: $(call app,disks).o $(NGUI_APP) $(UCMD_LD) $(LIBC_A)
  429. $(ULINK)
  430. # Init manager and its CLI/GUI client. The shared service table/state/control
  431. # code is linked into both binaries.
  432. SERVICE_COMMON = $(U)/apps/service/service_proto.o \
  433. $(U)/apps/service/service_defs.o
  434. $(call app,init).elf: $(call app,init).o $(SERVICE_COMMON) $(UCMD_LD) $(LIBC_A)
  435. $(ULINK)
  436. $(call app,service).elf: $(call app,service).o $(SERVICE_COMMON) $(NGUI_APP) $(UCMD_LD) $(LIBC_A)
  437. $(ULINK)
  438. $(call app,init).o $(call app,service).o $(SERVICE_COMMON): OPT = -Os
  439. $(call app,init).o $(call app,service).o $(SERVICE_COMMON): XFLAGS = $(SECTION_CFLAGS) $(LIBC_INC)
  440. # chat: native Cloudron Chat client (ngui + uhttp/TLS + cookie jar + JSON +
  441. # the native OIDC login driver).
  442. CHAT_LOGIN = $(U)/apps/chat/chat_login.o
  443. $(CHAT_LOGIN): OPT = -Os
  444. $(CHAT_LOGIN): XFLAGS = $(SECTION_CFLAGS)
  445. $(call app,chat).o: OPT = -Os
  446. $(call app,chat).o: XFLAGS = $(SECTION_CFLAGS) $(LIBC_INC)
  447. $(call app,chat).elf: $(call app,chat).o $(CHAT_LOGIN) $(UJSON) $(UHTTP_OBJS) $(NGUI_APP) $(IMG_DECODE_OBJS) $(INFLATE) $(TLSLIB_OBJS) $(UCMD_LD) $(LIBC_A)
  448. $(ULINK)
  449. # gallery: a live showcase of every ngui widget and primitive. The real ELF
  450. # ships in the rootfs pack as bin/gallery.app; ucmd_gallery.c (in UCMDS) is
  451. # the tiny PATH launcher (which also accepts /share/GALLERY).
  452. gallery.elf: $(U)/apps/gallery/gallery.o $(NGUI_APP) $(UCMD_LD) $(LIBC_A)
  453. $(ULINK)
  454. # browser: the real app ships as bin/browser.app in the full pack (and
  455. # BROWSER on root.img, which floppy boots use)
  456. # because it links ngui, the image library, TLS, uhttp and QuickJS;
  457. # ucmd_browser.c is the tiny PATH launcher. Compiled with function sections
  458. # and linked with --gc-sections: unreachable image, TLS and UI paths are
  459. # dropped.
  460. BR = $(U)/apps/browser
  461. BROWSER_OBJS = $(BR)/browser.o $(BR)/browser_html.o $(BR)/svg_raster.o \
  462. $(BR)/js_browser.o $(BR)/js_mu.o
  463. $(BROWSER_OBJS): OPT = -Os
  464. $(BROWSER_OBJS): XFLAGS = $(SECTION_CFLAGS) $(LIBC_INC)
  465. $(BR)/browser_html.o: XFLAGS = $(SECTION_CFLAGS)
  466. $(BR)/js_mu.o: XFLAGS = $(SECTION_CFLAGS) -Wno-unused-parameter $(LIBC_INC) -I$(QJS_DIR)
  467. browser.elf: $(BR)/browser.o $(BR)/browser_html.o $(BR)/svg_raster.o $(BR)/js_browser.o $(BR)/js_prelude.o $(UHTTP_OBJS) $(NGUI_APP) $(UFONT_WOFF) $(IMGLIB_OBJS) $(INFLATE) $(TLSLIB_OBJS) $(BR)/js_mu.o $(QJS_OBJS) $(UCMD_LD) $(LIBC_A)
  468. $(ULINK)
  469. # hello: the first ring-3 test program (its own linker script).
  470. $(U)/apps/hello/hello.elf: $(U)/apps/hello/hello.o user/apps/hello/hello.ld
  471. $(LD) -T user/apps/hello/hello.ld -nostdlib -m elf_i386 -o $@ $<
  472. $(OBJCOPY) --strip-all $@ $@
  473. # ---- Linux host browser harness (browser-host / host-curl) -------------------
  474. #
  475. # The browser talks to the same small SYS_* ABI as on NebOS; host/syscall.c
  476. # implements it with Linux files, BSD sockets, fork/exec and an SDL3 window.
  477. # The target images and browser.elf are not involved. Build 32-bit so the
  478. # pointer-through-int syscall ABI and the ring-3 allocator behave like the
  479. # board. SDL3 is only a development dependency for the window backend.
  480. HOST_CC ?= gcc
  481. HOST_BUILD = host/build
  482. HOST_CFLAGS = -m32 -O1 -g -Wall -Wextra -Wno-unused-parameter \
  483. -Wno-sign-compare -Wno-unused-function -Wno-format-truncation \
  484. -fno-strict-aliasing -fno-omit-frame-pointer $(USER_INC) \
  485. -Ihost/include -Ithird_party/quickjs -I/usr/include/SDL3 \
  486. -DUCMD_HOST -DJS_MU_HOST -D__nebos__ -D_GNU_SOURCE \
  487. -DCONFIG_VERSION='"2026-06-04"'
  488. # The ring-3 allocator is reused on the host: rename its entry points so
  489. # glibc and SDL keep their own malloc. libc/malloc.c and every app object
  490. # must use the same set.
  491. HOST_APP_MALLOC_DEFS = -Dmalloc=libc_malloc -Dfree=libc_free \
  492. -Dcalloc=libc_calloc -Drealloc=libc_realloc \
  493. -Dmalloc_usable_size=libc_malloc_usable_size \
  494. -Dheap_reset=libc_heap_reset
  495. HOST_APP_CFLAGS = $(HOST_CFLAGS) $(HOST_APP_MALLOC_DEFS)
  496. HOST_LDFLAGS = -m32 -no-pie -L/usr/lib32
  497. HOST_LDLIBS = -lSDL3 -lm -lpthread -ldl
  498. HOST_IMGLIB_SRCS = $(addprefix user/lib/img/,img.c img_mem.c img_blit.c \
  499. img_png.c img_bmp.c img_gif.c img_jpeg.c img_tga.c img_pnm.c \
  500. img_ico.c img_pam.c img_gif_anim.c img_file.c)
  501. HOST_TLS_SRCS = $(addprefix user/lib/tls/,tls_sha256.c tls_chacha20.c \
  502. tls_x25519.c tls_gcm.c tls_p256.c wpa_crypto.c tls_rng.c tls.c)
  503. HOST_QUERY_SRCS = $(addprefix $(QJS_DIR)/,quickjs.c cutils.c dtoa.c \
  504. libregexp.c libunicode.c)
  505. HOST_UHTTP_SRCS = user/lib/uhttp/uhttp.c user/lib/uhttp/uhttp_cookie.c
  506. HOST_BROWSER_APP_SRCS = $(addprefix user/apps/browser/,browser.c \
  507. browser_html.c svg_raster.c js_browser.c) \
  508. $(HOST_UHTTP_SRCS) user/lib/ngui/ngui.c \
  509. common/font_8x16.c \
  510. $(addprefix user/lib/ufont/,ufont.c ufont_ttf.c \
  511. ufont_draw.c ufont_file.c ufont_woff.c) \
  512. $(HOST_IMGLIB_SRCS) common/inflate.c $(HOST_TLS_SRCS) \
  513. user/apps/browser/js_mu.c user/lib/libc/malloc.c \
  514. $(HOST_QUERY_SRCS)
  515. HOST_CURL_APP_SRCS = user/apps/curl/ucmd_curl.c $(HOST_UHTTP_SRCS) \
  516. $(HOST_IMGLIB_SRCS) common/inflate.c $(HOST_TLS_SRCS) \
  517. user/lib/libc/malloc.c
  518. HOST_COMMON_SRCS = host/host.c host/syscall.c host/fs.c host/net.c \
  519. host/proc.c host/heap.c host/window.c \
  520. host/window_sdl3.c host/window_headless.c
  521. HOST_COMMON_OBJS = $(addprefix $(HOST_BUILD)/,$(HOST_COMMON_SRCS:.c=.o))
  522. HOST_BROWSER_APP_OBJS = $(addprefix $(HOST_BUILD)/,$(HOST_BROWSER_APP_SRCS:.c=.o))
  523. HOST_CURL_APP_OBJS = $(addprefix $(HOST_BUILD)/,$(HOST_CURL_APP_SRCS:.c=.o))
  524. HOST_BROWSER_OBJS = $(HOST_BUILD)/host/main.o $(HOST_COMMON_OBJS) \
  525. $(HOST_BROWSER_APP_OBJS) $(HOST_BUILD)/js_prelude.o
  526. HOST_CURL_OBJS = $(HOST_BUILD)/host/curl_main.o $(HOST_COMMON_OBJS) \
  527. $(HOST_CURL_APP_OBJS)
  528. $(HOST_BUILD)/%.o: %.c
  529. @mkdir -p $(dir $@)
  530. $(HOST_CC) $(HOST_APP_CFLAGS) $(HOST_EXTRA) $(DEPFLAGS) -c -o $@ $<
  531. # Host support files use glibc malloc directly, never the renamed arena.
  532. $(HOST_BUILD)/host/%.o: host/%.c
  533. @mkdir -p $(dir $@)
  534. $(HOST_CC) $(HOST_CFLAGS) $(DEPFLAGS) -c -o $@ $<
  535. $(HOST_BUILD)/js_prelude.o: user/apps/browser/js_prelude.S $(BR)/js_prelude.min.js
  536. @mkdir -p $(dir $@)
  537. $(HOST_CC) -m32 -Wa,-I$(BR) -c -o $@ $<
  538. $(HOST_BUILD)/user/apps/browser/browser.o: HOST_EXTRA = -D_start=browser_start
  539. $(HOST_BUILD)/user/apps/curl/ucmd_curl.o: HOST_EXTRA = -D_start=curl_start
  540. browser-host: host-curl $(HOST_BROWSER_OBJS) | icons/adwaita16.icn
  541. $(HOST_CC) $(HOST_LDFLAGS) -o $@ $(filter-out host-curl,$^) $(HOST_LDLIBS)
  542. host-curl: $(HOST_CURL_OBJS)
  543. $(HOST_CC) $(HOST_LDFLAGS) -o $@ $^ $(HOST_LDLIBS)
  544. # ---- Host tests (no kernel needed) -----------------------------------------
  545. UFONT_TEST_SRCS = $(addprefix user/lib/ufont/,ufont_test.c ufont.c ufont_ttf.c ufont_draw.c ufont_woff.c) common/inflate.c
  546. ufont_test: $(UFONT_TEST_SRCS) user/lib/ufont/ufont.h user/lib/ufont/ufont_internal.h fonts/emoji.ttf testdata/fonts/sans.woff
  547. gcc -O2 -Wall -Wextra -Iinclude -Icommon -o $@ $(UFONT_TEST_SRCS)
  548. test-font: ufont_test
  549. ./ufont_test
  550. test-font-asan: $(UFONT_TEST_SRCS) user/lib/ufont/ufont.h user/lib/ufont/ufont_internal.h fonts/emoji.ttf testdata/fonts/sans.woff
  551. gcc -O1 -g -fsanitize=address,undefined -Iinclude -Icommon -o ufont_test_asan $(UFONT_TEST_SRCS)
  552. ./ufont_test_asan
  553. fonts:
  554. tools/subset_fonts.sh
  555. SVG_SRCS = user/apps/browser/svg_test.c user/apps/browser/svg_raster.c
  556. svg_test: $(SVG_SRCS) user/apps/browser/svg_raster.h
  557. gcc -O1 -g -Wall -Wextra -fsanitize=address,undefined -o $@ $(SVG_SRCS) -lm
  558. test-svg: svg_test
  559. ./svg_test
  560. touchpad_gesture_test: kernel/touchpad_gesture_test.c kernel/touchpad_gesture.c kernel/touchpad_gesture.h
  561. gcc -O2 -Wall -Wextra -o $@ kernel/touchpad_gesture_test.c kernel/touchpad_gesture.c
  562. test-touchpad: touchpad_gesture_test
  563. ./touchpad_gesture_test
  564. # Host tests for the HID report-descriptor parser: field bit offsets for
  565. # padded/12-bit/16-bit mice, report IDs, buttons, the wheel and decoding.
  566. hid_report_test: kernel/hid_report_test.c kernel/hid_report.c kernel/hid_report.h
  567. gcc -O2 -Wall -Wextra -o $@ kernel/hid_report_test.c kernel/hid_report.c
  568. test-hid: hid_report_test
  569. ./hid_report_test
  570. # Host tests for the chat client's pure modules: JSON, cookie jar and the
  571. # login page/reply/config parsers.
  572. CHAT_TEST_CFLAGS = -O1 -g -Wall -Wextra -fsanitize=address,undefined $(USER_INC)
  573. ujson_test: user/lib/ujson/ujson_test.c user/lib/ujson/ujson.c user/lib/ujson/ujson.h
  574. gcc $(CHAT_TEST_CFLAGS) -o $@ user/lib/ujson/ujson_test.c user/lib/ujson/ujson.c
  575. uhttp_cookie_test: user/lib/uhttp/uhttp_cookie_test.c user/lib/uhttp/uhttp_cookie.c user/lib/uhttp/uhttp_cookie.h
  576. gcc $(CHAT_TEST_CFLAGS) -o $@ user/lib/uhttp/uhttp_cookie_test.c user/lib/uhttp/uhttp_cookie.c
  577. chat_login_test: user/apps/chat/chat_login_test.c user/apps/chat/chat_login.c user/apps/chat/chat_login.h user/lib/ujson/ujson.c
  578. gcc $(CHAT_TEST_CFLAGS) -DCHAT_LOGIN_PURE -o $@ user/apps/chat/chat_login_test.c user/apps/chat/chat_login.c user/lib/ujson/ujson.c
  579. test-chat: ujson_test uhttp_cookie_test chat_login_test
  580. ./ujson_test
  581. ./uhttp_cookie_test
  582. ./chat_login_test
  583. # QEMU end-to-end chat test against tools/mock_chat.py (ports 18080/18081 on
  584. # the host, 10.0.2.2 in the guest). CHAT_E2E=--totp|--consent|--passkey|
  585. # --wrong selects a login variant; screenshots land in chat-test-out/.
  586. CHAT_E2E ?=
  587. test-chat-e2e: floppy.img root.img
  588. python3 tools/qmp_chat_test.py $(CHAT_E2E)
  589. TLS_TEST_SRCS = $(addprefix user/lib/tls/,tls_test.c tls_sha256.c tls_chacha20.c \
  590. tls_x25519.c tls_gcm.c tls_p256.c wpa_crypto.c)
  591. tls_test: $(TLS_TEST_SRCS) $(wildcard user/lib/tls/*.h)
  592. gcc -O2 -o $@ $(TLS_TEST_SRCS)
  593. test-crypto: tls_test
  594. ./tls_test
  595. wpa_test: user/lib/wifi/wpa_test.c user/lib/wifi/wpa.c user/lib/tls/wpa_crypto.c user/lib/wifi/wpa.h user/lib/tls/wpa_crypto.h
  596. gcc -O2 -Wall -Wextra -Iuser/lib/tls -o $@ user/lib/wifi/wpa_test.c user/lib/wifi/wpa.c user/lib/tls/wpa_crypto.c
  597. test-wpa: wpa_test
  598. ./wpa_test
  599. wifi_store_test: user/lib/wifi/wifi_store_test.c user/lib/wifi/wifi_store.c user/lib/wifi/wifi_store.h include/wifi_cfg.h include/syscall.h
  600. gcc -m32 -O2 -Wall -Wextra -Iinclude -Iuser -o $@ user/lib/wifi/wifi_store_test.c
  601. test-wifi-store: wifi_store_test
  602. ./wifi_store_test
  603. ccmp_test: kernel/ccmp_test.c kernel/ccmp.c kernel/ccmp.h
  604. gcc -O2 -Wall -Wextra -o $@ kernel/ccmp_test.c
  605. test-ccmp: ccmp_test
  606. ./ccmp_test
  607. # Host image-library tests. The corpus and expected hashes are committed;
  608. # tools/gen_img_tests.py regenerates them.
  609. IMGLIB_SRCS = $(addprefix user/lib/img/,img.c img_mem.c img_blit.c \
  610. img_png.c img_bmp.c img_gif.c img_gif_anim.c img_jpeg.c img_tga.c \
  611. img_pnm.c img_ico.c img_pam.c) common/inflate.c
  612. IMGTEST_SRCS = user/lib/img/img_test.c $(IMGLIB_SRCS)
  613. IMGTEST_DEPS = $(wildcard user/lib/img/*.h) common/inflate.h testdata/images/expected.h
  614. IMGTEST_INC = -I. -Icommon -Iinclude -Iuser
  615. img_test: $(IMGTEST_SRCS) $(IMGTEST_DEPS)
  616. gcc -O2 -fwrapv -Wall -Wextra $(IMGTEST_INC) -o $@ $(IMGTEST_SRCS)
  617. # mkappicons decodes the committed 96 px app icon PNGs with the same image
  618. # library and writes the NBAPP1 bundle (include/app_icon_abi.h).
  619. mkappicons: tools/mkappicons.c include/app_icon_abi.h $(IMGLIB_SRCS) $(IMGTEST_DEPS)
  620. gcc -O2 -fwrapv -Wall -Wextra $(IMGTEST_INC) -o $@ tools/mkappicons.c $(IMGLIB_SRCS)
  621. test-images: img_test
  622. ./img_test
  623. test-images-asan: $(IMGTEST_SRCS) $(IMGTEST_DEPS)
  624. # -fwrapv: the integer IDCT deliberately relies on 32-bit wrap-around.
  625. gcc -O1 -g -fwrapv -fsanitize=address,undefined $(IMGTEST_INC) -o img_test_asan $(IMGTEST_SRCS)
  626. ./img_test_asan
  627. # Host tests for the ring-3 libc. The malloc/free names are renamed so the
  628. # host libc (printf, rand, write) keeps working normally.
  629. HOST_MALLOC_DEFS = -Dmalloc=libc_malloc -Dfree=libc_free \
  630. -Dcalloc=libc_calloc -Drealloc=libc_realloc \
  631. -Dheap_reset=libc_heap_reset
  632. LT = $(B)/host-test/libc
  633. LSRC = user/lib/libc
  634. $(LT)/malloc_host.o: $(LSRC)/malloc.c
  635. @mkdir -p $(@D)
  636. gcc -O2 -Wall -Wextra $(LIBC_INC) -fno-builtin $(HOST_MALLOC_DEFS) $(DEPFLAGS) -c -o $@ $<
  637. $(LT)/test_host_mem.o: $(LSRC)/test_host_mem.c
  638. @mkdir -p $(@D)
  639. gcc -O2 -Wall -Wextra $(DEPFLAGS) -c -o $@ $<
  640. malloc_test: $(LSRC)/test_malloc.c $(LT)/malloc_host.o $(LT)/test_host_mem.o
  641. gcc -O2 -Wall -Wextra -o $@ $^
  642. $(LT)/stdio_host.o: $(LSRC)/stdio.c
  643. @mkdir -p $(@D)
  644. gcc -O2 -Wall -Wextra $(LIBC_INC) -fno-builtin $(DEPFLAGS) -c -o $@ $<
  645. $(LT)/dtoa_host.o: $(LSRC)/dtoa.c
  646. @mkdir -p $(@D)
  647. gcc -O2 -Wall -Wextra $(LIBC_INC) -fno-builtin $(DEPFLAGS) -c -o $@ $<
  648. $(LT)/math_host.o: $(LSRC)/math.c
  649. @mkdir -p $(@D)
  650. gcc -O2 -Wall -Wextra $(LIBC_INC) -fno-builtin $(DEPFLAGS) -c -o $@ $<
  651. $(LT)/div64_host.o: $(LSRC)/div64.c
  652. @mkdir -p $(@D)
  653. gcc -O2 -Wall -Wextra $(DEPFLAGS) -c -o $@ $<
  654. format_test: $(LSRC)/test_format.c $(LT)/stdio_host.o $(LT)/dtoa_host.o
  655. gcc -O2 -Wall -Wextra -Wno-format-truncation $(LIBC_INC) -o $@ $^
  656. math_test: $(LSRC)/test_math.c $(LT)/math_host.o
  657. gcc -O2 -Wall -Wextra -o $@ $^ -lm
  658. div64_test: $(LSRC)/test_div64.c $(LT)/div64_host.o
  659. gcc -O2 -Wall -Wextra -o $@ $^
  660. setjmp_test: $(LSRC)/test_setjmp.c $(UL)/libc/setjmp.o
  661. gcc -m32 -O2 -Wall -Wextra $(LIBC_INC) -o $@ $^
  662. test-libc: malloc_test format_test math_test div64_test setjmp_test
  663. ./malloc_test
  664. ./format_test
  665. ./math_test
  666. ./div64_test
  667. ./setjmp_test
  668. QJS_HOST_SRCS = $(addprefix $(QJS_DIR)/,quickjs.c cutils.c dtoa.c libregexp.c libunicode.c)
  669. JS_TEST_SRCS = user/apps/browser/js_test.c user/apps/browser/js_mu.c
  670. js_test: $(JS_TEST_SRCS) user/apps/browser/js_mu.h $(QJS_HOST_SRCS) $(wildcard $(QJS_DIR)/*.h)
  671. gcc -O1 -g -w -fsanitize=address,undefined -fno-sanitize=shift -Iinclude -Iuser -I$(QJS_DIR) -D__nebos__ -DJS_MU_HOST \
  672. -DCONFIG_VERSION='"2026-06-04"' -o $@ $(JS_TEST_SRCS) $(QJS_HOST_SRCS) -lm
  673. test-js: js_test
  674. ./js_test
  675. # ---- Host tools ------------------------------------------------------------
  676. mkpack: tools/mkpack.c
  677. gcc -O2 -o $@ $<
  678. mkrootfs: tools/mkrootfs.c include/rootfs.h
  679. gcc -O2 -Iinclude -o $@ $<
  680. mkrtwtbl: tools/mkrtwtbl.c include/rtl8821a_tbl.h third_party/rtw88/rtw8821a_table.inc
  681. gcc -O2 -Wall -Wextra -I. -Iinclude -o $@ $<
  682. kexec_send: tools/kexec_send.c
  683. gcc -O2 -o $@ $<
  684. netkexec_send: tools/netkexec_send.c
  685. gcc -O2 -o $@ $<
  686. netmonitor: tools/netmonitor.c
  687. gcc -O2 -o $@ $<
  688. mkicons: tools/mkicons.c include/icon_abi.h user/apps/browser/svg_raster.c user/apps/browser/svg_raster.h
  689. gcc -O2 -Wall -Wextra -Iinclude -o $@ tools/mkicons.c user/apps/browser/svg_raster.c -lm
  690. jsstrip: tools/jsstrip.c
  691. gcc -O2 -Wall -Wextra -o $@ $<
  692. # The browser prelude is embedded without its comments and indentation
  693. # (tools/jsstrip.c): ~3.5 KB of gzip in the rootfs pack.
  694. $(BR)/js_prelude.min.js: user/apps/browser/js_prelude.js jsstrip
  695. @mkdir -p $(@D)
  696. ./jsstrip $< $@
  697. $(BR)/js_prelude.o: user/apps/browser/js_prelude.S $(BR)/js_prelude.min.js
  698. @mkdir -p $(@D)
  699. $(AS) $(ASFLAGS) -I$(BR) -o $@ $<
  700. mkcursors: tools/mkcursors.c include/cursor_abi.h
  701. gcc -O2 -Wall -Wextra -Iinclude -o $@ $<
  702. cursor_test: tools/cursor_test.c include/cursor_abi.h
  703. gcc -O1 -g -Wall -Wextra -fsanitize=address,undefined -Iinclude -o $@ $<
  704. # ---- Command pack (the system rootfs) ---------------------------------------
  705. #
  706. # The ring-3 command ELFs plus hello and the browser/gallery apps, packed
  707. # into bin/<name>. See tools/mkpack.c, include/rootfs.h and kernel/ramfs.h.
  708. FONT_FILES = fonts/sans.ttf fonts/sans-b.ttf fonts/sans-i.ttf \
  709. fonts/sans-bi.ttf fonts/mono.ttf fonts/emoji.ttf
  710. # Mouse cursors: the Adwaita theme's 24 px images (assets/cursors/adwaita/,
  711. # LGPL-3 / CC-BY-SA-3.0) converted to one NBCUR1 bundle (include/cursor_abi.h)
  712. # that kernel/cursor.c loads from /ramfs/cursors/adwaita24.cur. Full pack
  713. # only (~18 KB gzip): the floppy lite pack has no room, and its kernel keeps
  714. # the built-in 16x16 arrow.
  715. CURSOR_THEME = assets/cursors/adwaita
  716. CURSOR_FILE = cursors/adwaita24.cur
  717. $(CURSOR_FILE): mkcursors $(filter-out %/README %/COPYING%,$(wildcard $(CURSOR_THEME)/*))
  718. @mkdir -p cursors
  719. ./mkcursors $(CURSOR_THEME) 24 $@
  720. # Defined after CURSOR_FILE: make expands a rule's prerequisites at once.
  721. test-cursors: cursor_test $(CURSOR_FILE)
  722. ./cursor_test $(CURSOR_FILE)
  723. # UI icons: the Adwaita symbolic SVGs (assets/icons/adwaita/, LGPL-3 /
  724. # CC-BY-SA-3.0) rasterized by mkicons (with the browser's svg_raster.c) into
  725. # one NBICO1 bundle of 16 px coverage masks (include/icon_abi.h) that ngui
  726. # loads from /ramfs/icons/adwaita16.icn and tints. ~3.3 KB (~0.8 KB gzip),
  727. # so the floppy lite pack carries it as well.
  728. ICON_THEME = assets/icons/adwaita
  729. ICON_FILE = icons/adwaita16.icn
  730. $(ICON_FILE): mkicons $(wildcard $(ICON_THEME)/*.svg)
  731. @mkdir -p icons
  732. ./mkicons $(ICON_THEME) 16 $@
  733. # Full-colour app icons: upstream GNOME app SVGs and their committed 96 px
  734. # PNG renders (assets/icons/apps/) converted by mkappicons into one NBAPP1
  735. # bundle (include/app_icon_abi.h). The WM loads it from
  736. # /ramfs/icons/apps96.icn; both the full and the floppy lite pack carry it.
  737. # ~415 KB inflated, ~30 KB in the gzip pack. render_appicons.sh is the
  738. # maintainer-only SVG -> PNG step and is not part of the build.
  739. APPICON_THEME = assets/icons/apps
  740. APPICON_FILE = icons/apps96.icn
  741. appicons: $(APPICON_FILE)
  742. $(APPICON_FILE): mkappicons $(filter-out %/README %/COPYING%,$(wildcard $(APPICON_THEME)/*.png)) include/app_icon_abi.h
  743. @mkdir -p icons
  744. ./mkappicons $(APPICON_THEME) 96 $@
  745. HELLO_ELF = $(U)/apps/hello/hello.elf
  746. PACK_FILES = $(foreach a,$(UCMDS),bin/$(a)=$(call app,$(a)).elf) \
  747. bin/hello=$(HELLO_ELF) \
  748. bin/gallery.app=gallery.elf \
  749. $(foreach f,$(FONT_FILES),$(f)=$(f)) \
  750. $(ICON_FILE)=$(ICON_FILE) \
  751. $(APPICON_FILE)=$(APPICON_FILE)
  752. PACK_DEPS = $(UCMD_ELFS) $(HELLO_ELF) browser.elf gallery.elf $(FONT_FILES) \
  753. $(ICON_FILE) $(APPICON_FILE) mkpack
  754. PACK_CURSOR_FILES = $(CURSOR_FILE)=$(CURSOR_FILE)
  755. # The browser (~500 KB gzip) is in the full pack only: a floppy boot runs it
  756. # from BROWSER on root.img, which the bin/browser launcher already tries.
  757. PACK_BROWSER_FILES = bin/browser.app=browser.elf
  758. # `install self` reads the flat kernel from the full pack. The lite/floppy
  759. # pack deliberately omits it (no room on a 1.44 MB disk).
  760. PACK_INSTALL_FILES = install/kernel.bin=kernel.bin
  761. # WiFi firmware (kernel/iwl_trans.c): the Intel 7265D/3165 (Chromebook, MVM),
  762. # the 8265 (Yoga 720, 8000 MVM) and the 6200/6300 (ThinkPad X201, DVM).
  763. # Taken from the host's linux-firmware (`.zst` or plain); WIFI_FW_7265D /
  764. # WIFI_FW_8265 / WIFI_FW_6000 override the search. A machine without one
  765. # still builds: the pack then has no firmware/ entry for that card and
  766. # `wifi` reports it missing.
  767. fw_search = $(firstword $(wildcard \
  768. /usr/lib/firmware/intel/iwlwifi/$(1).zst /usr/lib/firmware/$(1).zst \
  769. /usr/lib/firmware/intel/iwlwifi/$(1) /usr/lib/firmware/$(1) \
  770. /lib/firmware/$(1)))
  771. WIFI_FW_7265D ?= $(call fw_search,iwlwifi-7265D-29.ucode)
  772. WIFI_FW_8265 ?= $(call fw_search,iwlwifi-8265-36.ucode)
  773. WIFI_FW_6000 ?= $(call fw_search,iwlwifi-6000-4.ucode)
  774. WIFI_FW_FILE =
  775. PACK_FW_FILES =
  776. # $(1) = file name in the pack, $(2) = host source.
  777. define wifi_fw_rule
  778. ifneq ($(2),)
  779. WIFI_FW_FILE += firmware/$(1)
  780. PACK_FW_FILES += firmware/$(1)=firmware/$(1)
  781. firmware/$(1): $(2)
  782. @mkdir -p firmware
  783. case "$$<" in *.zst) zstd -q -d -c "$$<" > $$@ ;; *) cp "$$<" $$@ ;; esac
  784. else
  785. $$(info note: $(1) not found; building the pack without it)
  786. endif
  787. endef
  788. $(eval $(call wifi_fw_rule,iwlwifi-7265D-29.ucode,$(WIFI_FW_7265D)))
  789. $(eval $(call wifi_fw_rule,iwlwifi-8265-36.ucode,$(WIFI_FW_8265)))
  790. $(eval $(call wifi_fw_rule,iwlwifi-6000-4.ucode,$(WIFI_FW_6000)))
  791. # Realtek RTL8821AU USB sticks (kernel/rtl8821au.c): the rtw88 8051 firmware
  792. # from linux-firmware (WIFI_FW_8821A overrides the search) and the register
  793. # tables, generated from third_party/rtw88 by the host tool mkrtwtbl. Both
  794. # are only in the full pack, like the Intel firmware.
  795. WIFI_FW_8821A ?= $(firstword $(wildcard \
  796. /usr/lib/firmware/rtw88/rtw8821a_fw.bin.zst \
  797. /usr/lib/firmware/rtw88/rtw8821a_fw.bin \
  798. /lib/firmware/rtw88/rtw8821a_fw.bin))
  799. $(eval $(call wifi_fw_rule,rtw8821a_fw.bin,$(WIFI_FW_8821A)))
  800. WIFI_FW_FILE += firmware/rtl8821a.tbl
  801. PACK_FW_FILES += firmware/rtl8821a.tbl=firmware/rtl8821a.tbl
  802. firmware/rtl8821a.tbl: mkrtwtbl
  803. @mkdir -p firmware
  804. ./mkrtwtbl $@
  805. cmds.pack: $(PACK_DEPS) $(WIFI_FW_FILE) $(CURSOR_FILE) kernel.bin
  806. ./mkpack $@ $(PACK_FILES) $(PACK_BROWSER_FILES) $(PACK_CURSOR_FILES) \
  807. $(PACK_INSTALL_FILES) \
  808. $(PACK_FW_FILES)
  809. # The floppy images cannot hold the ~1 MB firmware: they get the same pack
  810. # without firmware/* (and without the cursor bundle or bin/browser.app).
  811. cmds-lite.pack: $(PACK_DEPS)
  812. ./mkpack $@ $(PACK_FILES)
  813. # The boot-time rootfs is gzip-compressed; the raw cmds.pack is still what
  814. # cmds-dev/net-cmds send for a runtime replacement. Prefer libdeflate's
  815. # level 12 when it is installed: it saves about 8 KB over gzip -9 on the
  816. # current pack. The high-memory rootfs loader supports up to 2 MB; the
  817. # floppy images use the firmware-less lite pack (rootfs.bin).
  818. CMDS_GZ = $(shell command -v libdeflate-gzip >/dev/null 2>&1 && \
  819. echo "libdeflate-gzip -12 -c" || echo "gzip -9 -n -c")
  820. # The compressed rootfs cap: PACK_MAX in boot/vesa_stage.S (the legacy stage
  821. # copies the pack to 0x900000..0xD00000) and the embedded cap in
  822. # boot/efi/main.c must match.
  823. CMDS_GZ_MAX = 4194304
  824. cmds_lite_gz.bin: cmds-lite.pack
  825. $(CMDS_GZ) $< > $@
  826. cmds_pack_gz.bin: cmds.pack
  827. $(CMDS_GZ) $< > $@
  828. @sz=$$(stat -c%s $@); \
  829. if [ $$sz -gt $(CMDS_GZ_MAX) ]; then \
  830. echo "error: cmds_pack_gz.bin is $$sz bytes; the legacy rootfs cap is $(CMDS_GZ_MAX)"; \
  831. rm -f $@; exit 1; \
  832. fi
  833. # Rootfs image: one NBROOT1 header sector + the gzip pack (rootfs.h).
  834. # rootfs.bin (the lite pack, no firmware) is appended to the floppy images;
  835. # cmds.img is the 8 MB image flashed into the USB rootfs partition.
  836. rootfs.bin: cmds_lite_gz.bin mkrootfs
  837. ./mkrootfs $@ cmds_lite_gz.bin
  838. # Full NBROOT1 image (header + gzip pack, no partition padding) for the
  839. # network install path. `install self` uses the retained boot image instead.
  840. rootfs-full.bin: cmds_pack_gz.bin mkrootfs
  841. ./mkrootfs $@ cmds_pack_gz.bin
  842. rootfs: cmds.img
  843. cmds.img: cmds_pack_gz.bin mkrootfs
  844. ./mkrootfs $@ cmds_pack_gz.bin $$(( $(ROOTFS_SECTORS) * 512 ))
  845. # Diagnostic: no WM, boot console stays visible. Rebuild normally with
  846. # `make -B ...` afterwards (the objects carry -DNOWM).
  847. nowm:
  848. $(MAKE) NOWM=1 -B kernel.elf kernel.bin floppy.img usb.img usb-efi.img final.bin
  849. @echo "nowm: WM disabled; flash usb.img or usb-efi.img."
  850. root.img: browser.elf gallery.elf testdata/browser/demo.html testdata/browser/js.html testdata/browser/jsext.js testdata/images/rgb.bmp
  851. dd if=/dev/zero of=$@ bs=512 count=2880 2>/dev/null
  852. mkfs.fat -F 12 -n "ROOTDISK" $@
  853. echo "Hello from the second floppy!" | mcopy -i $@ - ::HELLO.TXT
  854. echo "This is a test file on drive 1." | mcopy -i $@ - ::TEST.TXT
  855. mcopy -i $@ browser.elf ::BROWSER
  856. mcopy -i $@ gallery.elf ::GALLERY
  857. mcopy -i $@ testdata/browser/demo.html ::DEMO.HTM
  858. mcopy -i $@ testdata/browser/js.html ::JS.HTM
  859. mcopy -i $@ testdata/browser/jsext.js ::JSEXT.JS
  860. mcopy -i $@ testdata/images/rgb.bmp ::PIC.BMP
  861. OVMF ?= $(firstword $(wildcard /usr/share/ovmf/x64/OVMF.4m.fd /usr/share/OVMF/OVMF.4m.fd))
  862. # Guest RAM for the QEMU targets, matching the 1 GB kernel ceiling (phys.h);
  863. # override with e.g. `make run QEMU_MEM=512M` (RAM above 1 GB is ignored).
  864. QEMU_MEM ?= 1G
  865. # root.img is deliberately not attached: a running QEMU may hold its write
  866. # lock, and the UEFI boot test does not need a second filesystem.
  867. run-uefi: usb-efi.img
  868. @test -n "$(OVMF)" || { echo "OVMF not found; set OVMF=/path/to/OVMF.4m.fd" >&2; exit 1; }
  869. qemu-system-x86_64 -M pc -m $(QEMU_MEM) -smp 4 -bios $(OVMF) -snapshot \
  870. -drive file=usb-efi.img,format=raw,if=ide \
  871. -device pci-ohci -device usb-mouse \
  872. -device ne2k_pci,netdev=n0 -netdev user,id=n0 \
  873. -serial file:/tmp/opencode/nebos-uefi-serial.log
  874. test-uefi: usb-efi.img
  875. @test -n "$(OVMF)" || { echo "OVMF not found; set OVMF=/path/to/OVMF.4m.fd" >&2; exit 1; }
  876. @rm -f /tmp/opencode/nebos-uefi-serial.log
  877. timeout 40 qemu-system-x86_64 -M pc -m $(QEMU_MEM) -smp 4 -bios $(OVMF) -snapshot \
  878. -drive file=usb-efi.img,format=raw,if=ide \
  879. -device pci-ohci -device usb-mouse \
  880. -device ne2k_pci,netdev=n0 -netdev user,id=n0 \
  881. -display none -serial file:/tmp/opencode/nebos-uefi-serial.log \
  882. -no-reboot >/dev/null 2>&1 || true
  883. @grep -q "booted" /tmp/opencode/nebos-uefi-serial.log && \
  884. echo "UEFI boot: OK (/tmp/opencode/nebos-uefi-serial.log)" || \
  885. { echo "UEFI boot: FAILED"; tail -c 4000 /tmp/opencode/nebos-uefi-serial.log; exit 1; }
  886. run: image.bin root.img
  887. $(MAKE) run-floppy
  888. # Four logical CPUs (the Atom 330 topology). UP is still the default so a
  889. # machine without ACPI/MADT boots exactly as before.
  890. run-smp: floppy.img root.img
  891. qemu-system-i386 -M pc -m $(QEMU_MEM) -smp 4 -device pci-ohci -device usb-mouse -drive file=floppy.img,format=raw,if=floppy -drive file=root.img,format=raw,if=floppy 2>/dev/null || \
  892. qemu-system-x86_64 -M pc -m $(QEMU_MEM) -smp 4 -device pci-ohci -device usb-mouse -drive file=floppy.img,format=raw,if=floppy -drive file=root.img,format=raw,if=floppy
  893. floppy: floppy.img
  894. usb: usb.img
  895. # Write the dual-boot USB image (legacy BIOS + UEFI) to a stick; prompts
  896. # before destroying anything.
  897. # make flash USB=/dev/sdX FORCE=1 skips the removable-device check.
  898. # make flash FLASH_IMG=usb.img legacy-only image
  899. # The UEFI half needs the mingw toolchain (EFI_CC); the legacy half does not.
  900. FLASH_IMG ?= usb-efi.img
  901. flash: $(FLASH_IMG)
  902. @tools/flash.sh "$(USB)" "$(FORCE)" "$(FLASH_IMG)"
  903. run-floppy: floppy.img root.img
  904. qemu-system-i386 -M pc -m $(QEMU_MEM) -device pci-ohci -device usb-mouse -drive file=floppy.img,format=raw,if=floppy -drive file=root.img,format=raw,if=floppy 2>/dev/null || \
  905. qemu-system-x86_64 -M pc -m $(QEMU_MEM) -device pci-ohci -device usb-mouse -drive file=floppy.img,format=raw,if=floppy -drive file=root.img,format=raw,if=floppy
  906. run-usb: usb.img root.img
  907. qemu-system-i386 -M pc -m $(QEMU_MEM) -boot c -device pci-ohci -device usb-mouse -drive file=usb.img,format=raw,if=ide -drive file=root.img,format=raw,if=floppy 2>/dev/null || \
  908. qemu-system-x86_64 -M pc -m $(QEMU_MEM) -boot c -device pci-ohci -device usb-mouse -drive file=usb.img,format=raw,if=ide -drive file=root.img,format=raw,if=floppy
  909. # UHCI variant (machines with an Intel/VIA-style controller, and the
  910. # regression test for the UHCI backend of the USB core).
  911. run-uhci: floppy.img root.img
  912. qemu-system-i386 -M pc -m $(QEMU_MEM) -device piix3-usb-uhci -device usb-mouse -drive file=floppy.img,format=raw,if=floppy -drive file=root.img,format=raw,if=floppy 2>/dev/null || \
  913. qemu-system-x86_64 -M pc -m $(QEMU_MEM) -device piix3-usb-uhci -device usb-mouse -drive file=floppy.img,format=raw,if=floppy -drive file=root.img,format=raw,if=floppy
  914. # xHCI variant (Braswell/Intel PCH and other USB 3.0-only machines).
  915. run-xhci: floppy.img root.img
  916. qemu-system-i386 -M pc -m $(QEMU_MEM) -device qemu-xhci -device usb-mouse -device usb-kbd -drive file=floppy.img,format=raw,if=floppy -drive file=root.img,format=raw,if=floppy 2>/dev/null || \
  917. qemu-system-x86_64 -M pc -m $(QEMU_MEM) -device qemu-xhci -device usb-mouse -device usb-kbd -drive file=floppy.img,format=raw,if=floppy -drive file=root.img,format=raw,if=floppy
  918. # RNDIS variant: QEMU's usb-net is a full-speed RNDIS function. It sits on
  919. # xHCI (QEMU's USB2 root ports), and `-nic none` keeps the PCI e1000 out of
  920. # the way so the phone/tethering link is the active NIC.
  921. run-rndis: floppy.img root.img
  922. qemu-system-i386 -M pc -m $(QEMU_MEM) -nic none -device qemu-xhci -device usb-mouse -device usb-kbd -device usb-net,netdev=n1 -netdev user,id=n1 -drive file=floppy.img,format=raw,if=floppy -drive file=root.img,format=raw,if=floppy 2>/dev/null || \
  923. qemu-system-x86_64 -M pc -m $(QEMU_MEM) -nic none -device qemu-xhci -device usb-mouse -device usb-kbd -device usb-net,netdev=n1 -netdev user,id=n1 -drive file=floppy.img,format=raw,if=floppy -drive file=root.img,format=raw,if=floppy
  924. # EHCI variant (USB 2.0 high-speed root ports). usb-storage is high-speed
  925. # and lands on EHCI; the mouse/keyboard are full-speed and use the UHCI
  926. # companion, exercising the multi-controller USB core.
  927. run-ehci: floppy.img root.img
  928. qemu-system-i386 -M pc -m $(QEMU_MEM) -boot a -device usb-ehci,id=ehci0 -device piix3-usb-uhci,id=uhci0 \
  929. -device usb-storage,bus=ehci0.0,drive=usbstick \
  930. -drive if=none,id=usbstick,file=root.img,format=raw \
  931. -device usb-mouse,bus=uhci0.0 -device usb-kbd,bus=uhci0.0 \
  932. -drive file=floppy.img,format=raw,if=floppy 2>/dev/null || \
  933. qemu-system-x86_64 -M pc -m $(QEMU_MEM) -boot a -device usb-ehci,id=ehci0 -device piix3-usb-uhci,id=uhci0 \
  934. -device usb-storage,bus=ehci0.0,drive=usbstick \
  935. -drive if=none,id=usbstick,file=root.img,format=raw \
  936. -device usb-mouse,bus=uhci0.0 -device usb-kbd,bus=uhci0.0 \
  937. -drive file=floppy.img,format=raw,if=floppy
  938. # Passthrough of the real ASIX AX88772 dongle (requires the host's asix
  939. # driver to be unbound and permission on /dev/bus/usb/...; typically run with
  940. # sudo). `-nic none` keeps the QEMU e1000 out of the way so the USB NIC is
  941. # the only netdev.
  942. ASIX_HOST ?= vendorid=0x0b95,productid=0x7720
  943. run-ehci-asix: floppy.img root.img
  944. qemu-system-i386 -M pc -m $(QEMU_MEM) -nic none -device usb-ehci -device usb-host,$(ASIX_HOST) -serial file:/tmp/opencode/serial-asix.log -drive file=floppy.img,format=raw,if=floppy -drive file=root.img,format=raw,if=floppy 2>/dev/null || \
  945. qemu-system-x86_64 -M pc -m $(QEMU_MEM) -nic none -device usb-ehci -device usb-host,$(ASIX_HOST) -serial file:/tmp/opencode/serial-asix.log -drive file=floppy.img,format=raw,if=floppy -drive file=root.img,format=raw,if=floppy
  946. run-xhci-asix: floppy.img root.img
  947. qemu-system-i386 -M pc -m $(QEMU_MEM) -nic none -device qemu-xhci -device usb-host,$(ASIX_HOST) -serial file:/tmp/opencode/serial-asix.log -drive file=floppy.img,format=raw,if=floppy -drive file=root.img,format=raw,if=floppy 2>/dev/null || \
  948. qemu-system-x86_64 -M pc -m $(QEMU_MEM) -nic none -device qemu-xhci -device usb-host,$(ASIX_HOST) -serial file:/tmp/opencode/serial-asix.log -drive file=floppy.img,format=raw,if=floppy -drive file=root.img,format=raw,if=floppy
  949. # Network variant: a PCI NE2000 (RTL8029, the driver's QEMU match) on QEMU's
  950. # user-mode network (slirp). DHCP/DNS come from slirp, the host is 10.0.2.2
  951. # (e.g. `python3 -m http.server` + `curl http://10.0.2.2:8000/` in a window).
  952. run-net: floppy.img root.img
  953. qemu-system-i386 -M pc -m $(QEMU_MEM) -device pci-ohci -device usb-mouse -device ne2k_pci,netdev=n0 -netdev user,id=n0,hostfwd=tcp::8080-:8080 -drive file=floppy.img,format=raw,if=floppy -drive file=root.img,format=raw,if=floppy 2>/dev/null || \
  954. qemu-system-x86_64 -M pc -m $(QEMU_MEM) -device pci-ohci -device usb-mouse -device ne2k_pci,netdev=n0 -netdev user,id=n0,hostfwd=tcp::8080-:8080 -drive file=floppy.img,format=raw,if=floppy -drive file=root.img,format=raw,if=floppy
  955. # Intel e1000 variant: QEMU's 82540EM exercises the e1000e driver's MAC/DMA
  956. # path. (The X201's 82577LM uses the same registers; only its PCH PHY is
  957. # different.) usb-kbd is there for headless QMP `send-key` typing.
  958. run-e1000: floppy.img root.img
  959. qemu-system-i386 -M pc -m $(QEMU_MEM) -device pci-ohci -device usb-mouse -device usb-kbd \
  960. -device e1000,netdev=n0 -netdev user,id=n0,hostfwd=tcp::8080-:8080 \
  961. -drive file=floppy.img,format=raw,if=floppy \
  962. -drive file=root.img,format=raw,if=floppy 2>/dev/null || \
  963. qemu-system-x86_64 -M pc -m $(QEMU_MEM) -device pci-ohci -device usb-mouse -device usb-kbd \
  964. -device e1000,netdev=n0 -netdev user,id=n0,hostfwd=tcp::8080-:8080 \
  965. -drive file=floppy.img,format=raw,if=floppy \
  966. -drive file=root.img,format=raw,if=floppy
  967. # SATA/AHCI variant: an ICH9 AHCI controller with a test disk on port 0.
  968. # The disk image lives outside the repo and is created on first use; boot
  969. # stays on the floppy (order=a), the SATA disk shows up as sata0.
  970. SATA_IMG ?= /tmp/opencode/nebos-sata.img
  971. run-ahci: floppy.img root.img
  972. @test -f $(SATA_IMG) || truncate -s 512M $(SATA_IMG)
  973. qemu-system-i386 -M pc -m $(QEMU_MEM) -boot order=a -device pci-ohci -device usb-mouse \
  974. -drive file=floppy.img,format=raw,if=floppy \
  975. -drive file=root.img,format=raw,if=floppy \
  976. -device ich9-ahci,id=sata \
  977. -drive file=$(SATA_IMG),format=raw,if=none,id=satadisk \
  978. -device ide-hd,drive=satadisk,bus=sata.0 2>/dev/null || \
  979. qemu-system-x86_64 -M pc -m $(QEMU_MEM) -boot order=a -device pci-ohci -device usb-mouse \
  980. -drive file=floppy.img,format=raw,if=floppy \
  981. -drive file=root.img,format=raw,if=floppy \
  982. -device ich9-ahci,id=sata \
  983. -drive file=$(SATA_IMG),format=raw,if=none,id=satadisk \
  984. -device ide-hd,drive=satadisk,bus=sata.0
  985. # AMD Piledriver regression: QEMU's Opteron_G5 is the FX-6350's family 15h
  986. # model 2 CPU. Exercises the AMD CPUID/MTRR/xAPIC paths, the AMD thermal
  987. # probe, the IOAPIC mask and six-core ACPI SMP. QEMU has no SB950 or
  988. # RTL8111E, so the e1000/OHCI devices cover the rest of the boot path.
  989. run-amd: floppy.img root.img
  990. qemu-system-x86_64 -M pc -cpu Opteron_G5 -smp 6 -m $(QEMU_MEM) \
  991. -device pci-ohci -device usb-mouse -device usb-kbd \
  992. -device e1000,netdev=n0 -netdev user,id=n0 \
  993. -drive file=floppy.img,format=raw,if=floppy \
  994. -drive file=root.img,format=raw,if=floppy
  995. test-amd: floppy.img root.img
  996. @rm -f /tmp/opencode/nebos-amd-serial.log
  997. timeout 40 qemu-system-x86_64 -M pc -cpu Opteron_G5 -smp 6 -m $(QEMU_MEM) \
  998. -device pci-ohci -device usb-mouse -device usb-kbd \
  999. -device e1000,netdev=n0 -netdev user,id=n0 \
  1000. -drive file=floppy.img,format=raw,if=floppy \
  1001. -drive file=root.img,format=raw,if=floppy \
  1002. -display none -serial file:/tmp/opencode/nebos-amd-serial.log \
  1003. -no-reboot >/dev/null 2>&1 || true
  1004. @grep -q "booted" /tmp/opencode/nebos-amd-serial.log && \
  1005. grep -q "smp cpus: 6" /tmp/opencode/nebos-amd-serial.log && \
  1006. grep -q "ioapic: masked" /tmp/opencode/nebos-amd-serial.log && \
  1007. grep -q "thermal: AMD family 15h" /tmp/opencode/nebos-amd-serial.log && \
  1008. ! grep -q "PIT NOT TICKING" /tmp/opencode/nebos-amd-serial.log && \
  1009. echo "AMD boot: OK (/tmp/opencode/nebos-amd-serial.log)" || \
  1010. { echo "AMD boot: FAILED"; tail -c 4000 /tmp/opencode/nebos-amd-serial.log; exit 1; }
  1011. # Headless USB HID regression tests (QEMU + python3): cursor movement via
  1012. # injected USB mouse reports and keyboard input via injected key events,
  1013. # including hotplug. See tools/*.py.
  1014. test-usb: floppy.img root.img
  1015. python3 tools/qmp_cursor_test.py
  1016. python3 tools/qmp_cursor_test.py --uhci
  1017. python3 tools/qmp_cursor_test.py --uhci72
  1018. python3 tools/qmp_cursor_test.py --hotplug
  1019. python3 tools/qmp_cursor_test.py --xhci
  1020. python3 tools/qmp_cursor_test.py --xhci2
  1021. python3 tools/qmp_cursor_test.py --xhci2hub
  1022. python3 tools/qmp_cursor_test.py --hub
  1023. python3 tools/qmp_cursor_test.py --ehci
  1024. python3 tools/qmp_keyboard_test.py
  1025. python3 tools/qmp_keyboard_test.py --hotplug
  1026. python3 tools/qmp_keyboard_test.py --xhci
  1027. python3 tools/qmp_keyboard_test.py --ehci
  1028. # End-to-end installer test: boot the dual-boot USB image as an IDE disk,
  1029. # attach the same image as a USB mass-storage source, type `install ide1`
  1030. # on the terminal and verify + boot the cloned target.
  1031. test-install: usb-efi.img
  1032. python3 tools/qmp_install_test.py
  1033. scp-final: final.bin
  1034. scp final.bin root@192.168.0.136:
  1035. ssh root@192.168.0.136 dd if=final.bin of=/dev/fd0 bs=512
  1036. scp-root: root.img
  1037. scp root.img root@192.168.0.136:
  1038. ssh root@192.168.0.136 dd if=root.img of=/dev/fd0 bs=512
  1039. SERIAL_DEV ?= /dev/ttyUSB0
  1040. SERIAL_BAUD ?= 115200
  1041. run-serial:
  1042. @echo "Starting serial monitor on $(SERIAL_DEV) at $(SERIAL_BAUD) baud..."
  1043. @echo "Type 'serial test' in the nebos terminal."
  1044. @echo "Press Ctrl-A Ctrl-X to exit picocom."
  1045. picocom $(SERIAL_DEV) --baud $(SERIAL_BAUD)
  1046. monitor:
  1047. @echo "Watching $(SERIAL_DEV) @ $(SERIAL_BAUD) baud (Ctrl-A Ctrl-X to exit)."
  1048. @echo "Each 'make dev' reload prints: NebOS v<version> booted"
  1049. picocom $(SERIAL_DEV) --baud $(SERIAL_BAUD)
  1050. dev: kernel.bin cmds_pack_gz.bin kexec_send
  1051. @entry=$$(nm kernel.elf | awk '/ T kernel_entry$$/{print $$1}'); \
  1052. if [ -z "$$entry" ]; then echo "error: kernel_entry symbol not found"; exit 1; fi; \
  1053. echo "Sending kernel.bin + cmds_pack_gz.bin (entry 0x$$entry) via $(SERIAL_DEV) @ $(SERIAL_BAUD)..."; \
  1054. ./kexec_send $(SERIAL_DEV) $(SERIAL_BAUD) $$entry kernel.bin cmds_pack_gz.bin
  1055. # Kernel-only fast path: the board keeps its running rootfs.
  1056. kernel-dev: kernel.bin kexec_send
  1057. @entry=$$(nm kernel.elf | awk '/ T kernel_entry$$/{print $$1}'); \
  1058. if [ -z "$$entry" ]; then echo "error: kernel_entry symbol not found"; exit 1; fi; \
  1059. echo "Sending kernel.bin only (entry 0x$$entry) via $(SERIAL_DEV) @ $(SERIAL_BAUD)..."; \
  1060. ./kexec_send $(SERIAL_DEV) $(SERIAL_BAUD) $$entry kernel.bin
  1061. # Push just the command pack (cmds.pack) to a running board: no kernel
  1062. # reload, the /ramfs contents are replaced in place. The board must be idle
  1063. # at a prompt (the WM loop auto-detects the transfer).
  1064. cmds-dev: cmds.pack kexec_send
  1065. @echo "Sending cmds.pack via $(SERIAL_DEV) @ $(SERIAL_BAUD)..."
  1066. ./kexec_send --payload $(SERIAL_DEV) $(SERIAL_BAUD) cmds.pack
  1067. net-cmds: cmds.pack netkexec_send
  1068. @echo "Sending cmds.pack to $(BOARD_IP):$(NETKEXEC_PORT)..."
  1069. ./netkexec_send --payload $(BOARD_IP) $(NETKEXEC_PORT) cmds.pack
  1070. # Development override: upload the real browser to the board's writable
  1071. # /share; the bin/browser launcher prefers it over the pack copy. The board
  1072. # must be running `websrv`; stop it before browsing HTTP, since the WebDAV
  1073. # server owns the NIC.
  1074. browser-dev: browser.elf
  1075. @echo "Uploading browser.elf to http://$(BOARD_IP):8080/share/BROWSER..."
  1076. curl -f -T browser.elf http://$(BOARD_IP):8080/share/BROWSER
  1077. # gallery follows the same development-override model.
  1078. gallery-dev: gallery.elf
  1079. @echo "Uploading gallery.elf to http://$(BOARD_IP):8080/share/GALLERY..."
  1080. curl -f -T gallery.elf http://$(BOARD_IP):8080/share/GALLERY
  1081. # Browser compatibility ladder: serve testdata/browser/compat so the board
  1082. # or a QEMU guest can open http://<host>:$(COMPAT_PORT)/.
  1083. COMPAT_PORT ?= 8000
  1084. compat-serve:
  1085. @echo "Serving the browser compatibility ladder on port $(COMPAT_PORT)"
  1086. python3 -m http.server -d testdata/browser/compat $(COMPAT_PORT)
  1087. # Show the board's netlog stream (kernel debug + terminal text) like `make
  1088. # monitor` does over serial.
  1089. netmon: netmonitor
  1090. @echo "Listening for netlog on UDP $(NETLOG_PORT) (Ctrl-C to exit)."
  1091. ./netmonitor $(NETLOG_PORT)
  1092. # Push a fresh kernel over Ethernet (the board auto-detects it from its idle
  1093. # loop; no serial and no USB stick involved).
  1094. BOARD_IP ?= 192.168.178.240
  1095. NETLOG_PORT ?= 19290
  1096. NETKEXEC_PORT ?= 19288
  1097. net-dev: kernel.bin cmds_pack_gz.bin netkexec_send
  1098. @entry=$$(nm kernel.elf | awk '/ T kernel_entry$$/{print $$1}'); \
  1099. if [ -z "$$entry" ]; then echo "error: kernel_entry symbol not found"; exit 1; fi; \
  1100. echo "Sending kernel.bin + cmds_pack_gz.bin (entry 0x$$entry) to $(BOARD_IP):$(NETKEXEC_PORT)..."; \
  1101. ./netkexec_send $(BOARD_IP) $(NETKEXEC_PORT) 0x$$entry kernel.bin cmds_pack_gz.bin
  1102. # Kernel-only fast path: the board keeps its running rootfs.
  1103. kernel-net-dev: kernel.bin netkexec_send
  1104. @entry=$$(nm kernel.elf | awk '/ T kernel_entry$$/{print $$1}'); \
  1105. if [ -z "$$entry" ]; then echo "error: kernel_entry symbol not found"; exit 1; fi; \
  1106. echo "Sending kernel.bin only (entry 0x$$entry) to $(BOARD_IP):$(NETKEXEC_PORT)..."; \
  1107. ./netkexec_send $(BOARD_IP) $(NETKEXEC_PORT) 0x$$entry kernel.bin
  1108. # Persistent update: write P1/P2 on the target disk (P4/data is untouched),
  1109. # then jump into the new kernel. TARGET=auto picks the only non-USB NebOS
  1110. # disk; use NETINSTALL_TARGET=mmc0/sata0/... to override.
  1111. NETINSTALL_TARGET ?= auto
  1112. net-install: kernel.bin rootfs-full.bin netkexec_send
  1113. @entry=$$(nm kernel.elf | awk '/ T kernel_entry$$/{print $$1}'); \
  1114. if [ -z "$$entry" ]; then echo "error: kernel_entry symbol not found"; exit 1; fi; \
  1115. echo "Persisting kernel.bin + rootfs-full.bin to $(NETINSTALL_TARGET) on $(BOARD_IP):$(NETKEXEC_PORT)..."; \
  1116. ./netkexec_send --install $(NETINSTALL_TARGET) $(BOARD_IP) $(NETKEXEC_PORT) 0x$$entry kernel.bin rootfs-full.bin
  1117. clean:
  1118. rm -rf $(B) host/build
  1119. rm -f kernel.elf kernel.bin boot.bin mbr.bin boot.bin.tmp image.bin \
  1120. floppy.img usb.img usb-efi.img esp.img final.bin root.img \
  1121. BOOTX64.EFI browser.elf gallery.elf *.boot.tmp \
  1122. cmds.pack cmds-lite.pack cmds_pack_gz.bin cmds_lite_gz.bin \
  1123. rootfs.bin rootfs-full.bin cmds.img \
  1124. firmware/*.ucode firmware/*.tbl firmware/*.bin cursors/*.cur icons/*.icn \
  1125. mkpack mkrootfs mkrtwtbl mkcursors mkicons mkappicons jsstrip cursor_test kexec_send netkexec_send netmonitor \
  1126. browser-host host-curl \
  1127. ufont_test ufont_test_asan svg_test touchpad_gesture_test hid_report_test \
  1128. ujson_test uhttp_cookie_test chat_login_test tls_test wpa_test \
  1129. wifi_store_test ccmp_test img_test img_test_asan malloc_test \
  1130. format_test math_test div64_test setjmp_test js_test
  1131. # Compiler-generated header dependencies.
  1132. -include $(shell find $(B) host/build -name '*.d' 2>/dev/null)