Makefile 62 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350
  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-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 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 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 chat client's pure modules: JSON, cookie jar and the
  565. # login page/reply/config parsers.
  566. CHAT_TEST_CFLAGS = -O1 -g -Wall -Wextra -fsanitize=address,undefined $(USER_INC)
  567. ujson_test: user/lib/ujson/ujson_test.c user/lib/ujson/ujson.c user/lib/ujson/ujson.h
  568. gcc $(CHAT_TEST_CFLAGS) -o $@ user/lib/ujson/ujson_test.c user/lib/ujson/ujson.c
  569. uhttp_cookie_test: user/lib/uhttp/uhttp_cookie_test.c user/lib/uhttp/uhttp_cookie.c user/lib/uhttp/uhttp_cookie.h
  570. gcc $(CHAT_TEST_CFLAGS) -o $@ user/lib/uhttp/uhttp_cookie_test.c user/lib/uhttp/uhttp_cookie.c
  571. 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
  572. 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
  573. test-chat: ujson_test uhttp_cookie_test chat_login_test
  574. ./ujson_test
  575. ./uhttp_cookie_test
  576. ./chat_login_test
  577. # QEMU end-to-end chat test against tools/mock_chat.py (ports 18080/18081 on
  578. # the host, 10.0.2.2 in the guest). CHAT_E2E=--totp|--consent|--passkey|
  579. # --wrong selects a login variant; screenshots land in chat-test-out/.
  580. CHAT_E2E ?=
  581. test-chat-e2e: floppy.img root.img
  582. python3 tools/qmp_chat_test.py $(CHAT_E2E)
  583. TLS_TEST_SRCS = $(addprefix user/lib/tls/,tls_test.c tls_sha256.c tls_chacha20.c \
  584. tls_x25519.c tls_gcm.c tls_p256.c wpa_crypto.c)
  585. tls_test: $(TLS_TEST_SRCS) $(wildcard user/lib/tls/*.h)
  586. gcc -O2 -o $@ $(TLS_TEST_SRCS)
  587. test-crypto: tls_test
  588. ./tls_test
  589. 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
  590. 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
  591. test-wpa: wpa_test
  592. ./wpa_test
  593. 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
  594. gcc -m32 -O2 -Wall -Wextra -Iinclude -Iuser -o $@ user/lib/wifi/wifi_store_test.c
  595. test-wifi-store: wifi_store_test
  596. ./wifi_store_test
  597. ccmp_test: kernel/ccmp_test.c kernel/ccmp.c kernel/ccmp.h
  598. gcc -O2 -Wall -Wextra -o $@ kernel/ccmp_test.c
  599. test-ccmp: ccmp_test
  600. ./ccmp_test
  601. # Host image-library tests. The corpus and expected hashes are committed;
  602. # tools/gen_img_tests.py regenerates them.
  603. IMGLIB_SRCS = $(addprefix user/lib/img/,img.c img_mem.c img_blit.c \
  604. img_png.c img_bmp.c img_gif.c img_gif_anim.c img_jpeg.c img_tga.c \
  605. img_pnm.c img_ico.c img_pam.c) common/inflate.c
  606. IMGTEST_SRCS = user/lib/img/img_test.c $(IMGLIB_SRCS)
  607. IMGTEST_DEPS = $(wildcard user/lib/img/*.h) common/inflate.h testdata/images/expected.h
  608. IMGTEST_INC = -I. -Icommon -Iinclude -Iuser
  609. img_test: $(IMGTEST_SRCS) $(IMGTEST_DEPS)
  610. gcc -O2 -fwrapv -Wall -Wextra $(IMGTEST_INC) -o $@ $(IMGTEST_SRCS)
  611. # mkappicons decodes the committed 96 px app icon PNGs with the same image
  612. # library and writes the NBAPP1 bundle (include/app_icon_abi.h).
  613. mkappicons: tools/mkappicons.c include/app_icon_abi.h $(IMGLIB_SRCS) $(IMGTEST_DEPS)
  614. gcc -O2 -fwrapv -Wall -Wextra $(IMGTEST_INC) -o $@ tools/mkappicons.c $(IMGLIB_SRCS)
  615. test-images: img_test
  616. ./img_test
  617. test-images-asan: $(IMGTEST_SRCS) $(IMGTEST_DEPS)
  618. # -fwrapv: the integer IDCT deliberately relies on 32-bit wrap-around.
  619. gcc -O1 -g -fwrapv -fsanitize=address,undefined $(IMGTEST_INC) -o img_test_asan $(IMGTEST_SRCS)
  620. ./img_test_asan
  621. # Host tests for the ring-3 libc. The malloc/free names are renamed so the
  622. # host libc (printf, rand, write) keeps working normally.
  623. HOST_MALLOC_DEFS = -Dmalloc=libc_malloc -Dfree=libc_free \
  624. -Dcalloc=libc_calloc -Drealloc=libc_realloc \
  625. -Dheap_reset=libc_heap_reset
  626. LT = $(B)/host-test/libc
  627. LSRC = user/lib/libc
  628. $(LT)/malloc_host.o: $(LSRC)/malloc.c
  629. @mkdir -p $(@D)
  630. gcc -O2 -Wall -Wextra $(LIBC_INC) -fno-builtin $(HOST_MALLOC_DEFS) $(DEPFLAGS) -c -o $@ $<
  631. $(LT)/test_host_mem.o: $(LSRC)/test_host_mem.c
  632. @mkdir -p $(@D)
  633. gcc -O2 -Wall -Wextra $(DEPFLAGS) -c -o $@ $<
  634. malloc_test: $(LSRC)/test_malloc.c $(LT)/malloc_host.o $(LT)/test_host_mem.o
  635. gcc -O2 -Wall -Wextra -o $@ $^
  636. $(LT)/stdio_host.o: $(LSRC)/stdio.c
  637. @mkdir -p $(@D)
  638. gcc -O2 -Wall -Wextra $(LIBC_INC) -fno-builtin $(DEPFLAGS) -c -o $@ $<
  639. $(LT)/dtoa_host.o: $(LSRC)/dtoa.c
  640. @mkdir -p $(@D)
  641. gcc -O2 -Wall -Wextra $(LIBC_INC) -fno-builtin $(DEPFLAGS) -c -o $@ $<
  642. $(LT)/math_host.o: $(LSRC)/math.c
  643. @mkdir -p $(@D)
  644. gcc -O2 -Wall -Wextra $(LIBC_INC) -fno-builtin $(DEPFLAGS) -c -o $@ $<
  645. $(LT)/div64_host.o: $(LSRC)/div64.c
  646. @mkdir -p $(@D)
  647. gcc -O2 -Wall -Wextra $(DEPFLAGS) -c -o $@ $<
  648. format_test: $(LSRC)/test_format.c $(LT)/stdio_host.o $(LT)/dtoa_host.o
  649. gcc -O2 -Wall -Wextra -Wno-format-truncation $(LIBC_INC) -o $@ $^
  650. math_test: $(LSRC)/test_math.c $(LT)/math_host.o
  651. gcc -O2 -Wall -Wextra -o $@ $^ -lm
  652. div64_test: $(LSRC)/test_div64.c $(LT)/div64_host.o
  653. gcc -O2 -Wall -Wextra -o $@ $^
  654. setjmp_test: $(LSRC)/test_setjmp.c $(UL)/libc/setjmp.o
  655. gcc -m32 -O2 -Wall -Wextra $(LIBC_INC) -o $@ $^
  656. test-libc: malloc_test format_test math_test div64_test setjmp_test
  657. ./malloc_test
  658. ./format_test
  659. ./math_test
  660. ./div64_test
  661. ./setjmp_test
  662. QJS_HOST_SRCS = $(addprefix $(QJS_DIR)/,quickjs.c cutils.c dtoa.c libregexp.c libunicode.c)
  663. JS_TEST_SRCS = user/apps/browser/js_test.c user/apps/browser/js_mu.c
  664. js_test: $(JS_TEST_SRCS) user/apps/browser/js_mu.h $(QJS_HOST_SRCS) $(wildcard $(QJS_DIR)/*.h)
  665. gcc -O1 -g -w -fsanitize=address,undefined -fno-sanitize=shift -Iinclude -Iuser -I$(QJS_DIR) -D__nebos__ -DJS_MU_HOST \
  666. -DCONFIG_VERSION='"2026-06-04"' -o $@ $(JS_TEST_SRCS) $(QJS_HOST_SRCS) -lm
  667. test-js: js_test
  668. ./js_test
  669. # ---- Host tools ------------------------------------------------------------
  670. mkpack: tools/mkpack.c
  671. gcc -O2 -o $@ $<
  672. mkrootfs: tools/mkrootfs.c include/rootfs.h
  673. gcc -O2 -Iinclude -o $@ $<
  674. mkrtwtbl: tools/mkrtwtbl.c include/rtl8821a_tbl.h third_party/rtw88/rtw8821a_table.inc
  675. gcc -O2 -Wall -Wextra -I. -Iinclude -o $@ $<
  676. kexec_send: tools/kexec_send.c
  677. gcc -O2 -o $@ $<
  678. netkexec_send: tools/netkexec_send.c
  679. gcc -O2 -o $@ $<
  680. netmonitor: tools/netmonitor.c
  681. gcc -O2 -o $@ $<
  682. mkicons: tools/mkicons.c include/icon_abi.h user/apps/browser/svg_raster.c user/apps/browser/svg_raster.h
  683. gcc -O2 -Wall -Wextra -Iinclude -o $@ tools/mkicons.c user/apps/browser/svg_raster.c -lm
  684. jsstrip: tools/jsstrip.c
  685. gcc -O2 -Wall -Wextra -o $@ $<
  686. # The browser prelude is embedded without its comments and indentation
  687. # (tools/jsstrip.c): ~3.5 KB of gzip in the rootfs pack.
  688. $(BR)/js_prelude.min.js: user/apps/browser/js_prelude.js jsstrip
  689. @mkdir -p $(@D)
  690. ./jsstrip $< $@
  691. $(BR)/js_prelude.o: user/apps/browser/js_prelude.S $(BR)/js_prelude.min.js
  692. @mkdir -p $(@D)
  693. $(AS) $(ASFLAGS) -I$(BR) -o $@ $<
  694. mkcursors: tools/mkcursors.c include/cursor_abi.h
  695. gcc -O2 -Wall -Wextra -Iinclude -o $@ $<
  696. cursor_test: tools/cursor_test.c include/cursor_abi.h
  697. gcc -O1 -g -Wall -Wextra -fsanitize=address,undefined -Iinclude -o $@ $<
  698. # ---- Command pack (the system rootfs) ---------------------------------------
  699. #
  700. # The ring-3 command ELFs plus hello and the browser/gallery apps, packed
  701. # into bin/<name>. See tools/mkpack.c, include/rootfs.h and kernel/ramfs.h.
  702. FONT_FILES = fonts/sans.ttf fonts/sans-b.ttf fonts/sans-i.ttf \
  703. fonts/sans-bi.ttf fonts/mono.ttf fonts/emoji.ttf
  704. # Mouse cursors: the Adwaita theme's 24 px images (assets/cursors/adwaita/,
  705. # LGPL-3 / CC-BY-SA-3.0) converted to one NBCUR1 bundle (include/cursor_abi.h)
  706. # that kernel/cursor.c loads from /ramfs/cursors/adwaita24.cur. Full pack
  707. # only (~18 KB gzip): the floppy lite pack has no room, and its kernel keeps
  708. # the built-in 16x16 arrow.
  709. CURSOR_THEME = assets/cursors/adwaita
  710. CURSOR_FILE = cursors/adwaita24.cur
  711. $(CURSOR_FILE): mkcursors $(filter-out %/README %/COPYING%,$(wildcard $(CURSOR_THEME)/*))
  712. @mkdir -p cursors
  713. ./mkcursors $(CURSOR_THEME) 24 $@
  714. # Defined after CURSOR_FILE: make expands a rule's prerequisites at once.
  715. test-cursors: cursor_test $(CURSOR_FILE)
  716. ./cursor_test $(CURSOR_FILE)
  717. # UI icons: the Adwaita symbolic SVGs (assets/icons/adwaita/, LGPL-3 /
  718. # CC-BY-SA-3.0) rasterized by mkicons (with the browser's svg_raster.c) into
  719. # one NBICO1 bundle of 16 px coverage masks (include/icon_abi.h) that ngui
  720. # loads from /ramfs/icons/adwaita16.icn and tints. ~3.3 KB (~0.8 KB gzip),
  721. # so the floppy lite pack carries it as well.
  722. ICON_THEME = assets/icons/adwaita
  723. ICON_FILE = icons/adwaita16.icn
  724. $(ICON_FILE): mkicons $(wildcard $(ICON_THEME)/*.svg)
  725. @mkdir -p icons
  726. ./mkicons $(ICON_THEME) 16 $@
  727. # Full-colour app icons: upstream GNOME app SVGs and their committed 96 px
  728. # PNG renders (assets/icons/apps/) converted by mkappicons into one NBAPP1
  729. # bundle (include/app_icon_abi.h). The WM loads it from
  730. # /ramfs/icons/apps96.icn; both the full and the floppy lite pack carry it.
  731. # ~415 KB inflated, ~30 KB in the gzip pack. render_appicons.sh is the
  732. # maintainer-only SVG -> PNG step and is not part of the build.
  733. APPICON_THEME = assets/icons/apps
  734. APPICON_FILE = icons/apps96.icn
  735. appicons: $(APPICON_FILE)
  736. $(APPICON_FILE): mkappicons $(filter-out %/README %/COPYING%,$(wildcard $(APPICON_THEME)/*.png)) include/app_icon_abi.h
  737. @mkdir -p icons
  738. ./mkappicons $(APPICON_THEME) 96 $@
  739. HELLO_ELF = $(U)/apps/hello/hello.elf
  740. PACK_FILES = $(foreach a,$(UCMDS),bin/$(a)=$(call app,$(a)).elf) \
  741. bin/hello=$(HELLO_ELF) \
  742. bin/gallery.app=gallery.elf \
  743. $(foreach f,$(FONT_FILES),$(f)=$(f)) \
  744. $(ICON_FILE)=$(ICON_FILE) \
  745. $(APPICON_FILE)=$(APPICON_FILE)
  746. PACK_DEPS = $(UCMD_ELFS) $(HELLO_ELF) browser.elf gallery.elf $(FONT_FILES) \
  747. $(ICON_FILE) $(APPICON_FILE) mkpack
  748. PACK_CURSOR_FILES = $(CURSOR_FILE)=$(CURSOR_FILE)
  749. # The browser (~500 KB gzip) is in the full pack only: a floppy boot runs it
  750. # from BROWSER on root.img, which the bin/browser launcher already tries.
  751. PACK_BROWSER_FILES = bin/browser.app=browser.elf
  752. # `install self` reads the flat kernel from the full pack. The lite/floppy
  753. # pack deliberately omits it (no room on a 1.44 MB disk).
  754. PACK_INSTALL_FILES = install/kernel.bin=kernel.bin
  755. # WiFi firmware (kernel/iwl_trans.c): the Intel 7265D/3165 (Chromebook, MVM),
  756. # the 8265 (Yoga 720, 8000 MVM) and the 6200/6300 (ThinkPad X201, DVM).
  757. # Taken from the host's linux-firmware (`.zst` or plain); WIFI_FW_7265D /
  758. # WIFI_FW_8265 / WIFI_FW_6000 override the search. A machine without one
  759. # still builds: the pack then has no firmware/ entry for that card and
  760. # `wifi` reports it missing.
  761. fw_search = $(firstword $(wildcard \
  762. /usr/lib/firmware/intel/iwlwifi/$(1).zst /usr/lib/firmware/$(1).zst \
  763. /usr/lib/firmware/intel/iwlwifi/$(1) /usr/lib/firmware/$(1) \
  764. /lib/firmware/$(1)))
  765. WIFI_FW_7265D ?= $(call fw_search,iwlwifi-7265D-29.ucode)
  766. WIFI_FW_8265 ?= $(call fw_search,iwlwifi-8265-36.ucode)
  767. WIFI_FW_6000 ?= $(call fw_search,iwlwifi-6000-4.ucode)
  768. WIFI_FW_FILE =
  769. PACK_FW_FILES =
  770. # $(1) = file name in the pack, $(2) = host source.
  771. define wifi_fw_rule
  772. ifneq ($(2),)
  773. WIFI_FW_FILE += firmware/$(1)
  774. PACK_FW_FILES += firmware/$(1)=firmware/$(1)
  775. firmware/$(1): $(2)
  776. @mkdir -p firmware
  777. case "$$<" in *.zst) zstd -q -d -c "$$<" > $$@ ;; *) cp "$$<" $$@ ;; esac
  778. else
  779. $$(info note: $(1) not found; building the pack without it)
  780. endif
  781. endef
  782. $(eval $(call wifi_fw_rule,iwlwifi-7265D-29.ucode,$(WIFI_FW_7265D)))
  783. $(eval $(call wifi_fw_rule,iwlwifi-8265-36.ucode,$(WIFI_FW_8265)))
  784. $(eval $(call wifi_fw_rule,iwlwifi-6000-4.ucode,$(WIFI_FW_6000)))
  785. # Realtek RTL8821AU USB sticks (kernel/rtl8821au.c): the rtw88 8051 firmware
  786. # from linux-firmware (WIFI_FW_8821A overrides the search) and the register
  787. # tables, generated from third_party/rtw88 by the host tool mkrtwtbl. Both
  788. # are only in the full pack, like the Intel firmware.
  789. WIFI_FW_8821A ?= $(firstword $(wildcard \
  790. /usr/lib/firmware/rtw88/rtw8821a_fw.bin.zst \
  791. /usr/lib/firmware/rtw88/rtw8821a_fw.bin \
  792. /lib/firmware/rtw88/rtw8821a_fw.bin))
  793. $(eval $(call wifi_fw_rule,rtw8821a_fw.bin,$(WIFI_FW_8821A)))
  794. WIFI_FW_FILE += firmware/rtl8821a.tbl
  795. PACK_FW_FILES += firmware/rtl8821a.tbl=firmware/rtl8821a.tbl
  796. firmware/rtl8821a.tbl: mkrtwtbl
  797. @mkdir -p firmware
  798. ./mkrtwtbl $@
  799. cmds.pack: $(PACK_DEPS) $(WIFI_FW_FILE) $(CURSOR_FILE) kernel.bin
  800. ./mkpack $@ $(PACK_FILES) $(PACK_BROWSER_FILES) $(PACK_CURSOR_FILES) \
  801. $(PACK_INSTALL_FILES) \
  802. $(PACK_FW_FILES)
  803. # The floppy images cannot hold the ~1 MB firmware: they get the same pack
  804. # without firmware/* (and without the cursor bundle or bin/browser.app).
  805. cmds-lite.pack: $(PACK_DEPS)
  806. ./mkpack $@ $(PACK_FILES)
  807. # The boot-time rootfs is gzip-compressed; the raw cmds.pack is still what
  808. # cmds-dev/net-cmds send for a runtime replacement. Prefer libdeflate's
  809. # level 12 when it is installed: it saves about 8 KB over gzip -9 on the
  810. # current pack. The high-memory rootfs loader supports up to 2 MB; the
  811. # floppy images use the firmware-less lite pack (rootfs.bin).
  812. CMDS_GZ = $(shell command -v libdeflate-gzip >/dev/null 2>&1 && \
  813. echo "libdeflate-gzip -12 -c" || echo "gzip -9 -n -c")
  814. # The compressed rootfs cap: PACK_MAX in boot/vesa_stage.S (the legacy stage
  815. # copies the pack to 0x900000..0xD00000) and the embedded cap in
  816. # boot/efi/main.c must match.
  817. CMDS_GZ_MAX = 4194304
  818. cmds_lite_gz.bin: cmds-lite.pack
  819. $(CMDS_GZ) $< > $@
  820. cmds_pack_gz.bin: cmds.pack
  821. $(CMDS_GZ) $< > $@
  822. @sz=$$(stat -c%s $@); \
  823. if [ $$sz -gt $(CMDS_GZ_MAX) ]; then \
  824. echo "error: cmds_pack_gz.bin is $$sz bytes; the legacy rootfs cap is $(CMDS_GZ_MAX)"; \
  825. rm -f $@; exit 1; \
  826. fi
  827. # Rootfs image: one NBROOT1 header sector + the gzip pack (rootfs.h).
  828. # rootfs.bin (the lite pack, no firmware) is appended to the floppy images;
  829. # cmds.img is the 8 MB image flashed into the USB rootfs partition.
  830. rootfs.bin: cmds_lite_gz.bin mkrootfs
  831. ./mkrootfs $@ cmds_lite_gz.bin
  832. # Full NBROOT1 image (header + gzip pack, no partition padding) for the
  833. # network install path. `install self` uses the retained boot image instead.
  834. rootfs-full.bin: cmds_pack_gz.bin mkrootfs
  835. ./mkrootfs $@ cmds_pack_gz.bin
  836. rootfs: cmds.img
  837. cmds.img: cmds_pack_gz.bin mkrootfs
  838. ./mkrootfs $@ cmds_pack_gz.bin $$(( $(ROOTFS_SECTORS) * 512 ))
  839. # Diagnostic: no WM, boot console stays visible. Rebuild normally with
  840. # `make -B ...` afterwards (the objects carry -DNOWM).
  841. nowm:
  842. $(MAKE) NOWM=1 -B kernel.elf kernel.bin floppy.img usb.img usb-efi.img final.bin
  843. @echo "nowm: WM disabled; flash usb.img or usb-efi.img."
  844. root.img: browser.elf gallery.elf testdata/browser/demo.html testdata/browser/js.html testdata/browser/jsext.js testdata/images/rgb.bmp
  845. dd if=/dev/zero of=$@ bs=512 count=2880 2>/dev/null
  846. mkfs.fat -F 12 -n "ROOTDISK" $@
  847. echo "Hello from the second floppy!" | mcopy -i $@ - ::HELLO.TXT
  848. echo "This is a test file on drive 1." | mcopy -i $@ - ::TEST.TXT
  849. mcopy -i $@ browser.elf ::BROWSER
  850. mcopy -i $@ gallery.elf ::GALLERY
  851. mcopy -i $@ testdata/browser/demo.html ::DEMO.HTM
  852. mcopy -i $@ testdata/browser/js.html ::JS.HTM
  853. mcopy -i $@ testdata/browser/jsext.js ::JSEXT.JS
  854. mcopy -i $@ testdata/images/rgb.bmp ::PIC.BMP
  855. OVMF ?= $(firstword $(wildcard /usr/share/ovmf/x64/OVMF.4m.fd /usr/share/OVMF/OVMF.4m.fd))
  856. # Guest RAM for the QEMU targets, matching the 1 GB kernel ceiling (phys.h);
  857. # override with e.g. `make run QEMU_MEM=512M` (RAM above 1 GB is ignored).
  858. QEMU_MEM ?= 1G
  859. # root.img is deliberately not attached: a running QEMU may hold its write
  860. # lock, and the UEFI boot test does not need a second filesystem.
  861. run-uefi: usb-efi.img
  862. @test -n "$(OVMF)" || { echo "OVMF not found; set OVMF=/path/to/OVMF.4m.fd" >&2; exit 1; }
  863. qemu-system-x86_64 -M pc -m $(QEMU_MEM) -smp 4 -bios $(OVMF) -snapshot \
  864. -drive file=usb-efi.img,format=raw,if=ide \
  865. -device pci-ohci -device usb-mouse \
  866. -device ne2k_pci,netdev=n0 -netdev user,id=n0 \
  867. -serial file:/tmp/opencode/nebos-uefi-serial.log
  868. test-uefi: usb-efi.img
  869. @test -n "$(OVMF)" || { echo "OVMF not found; set OVMF=/path/to/OVMF.4m.fd" >&2; exit 1; }
  870. @rm -f /tmp/opencode/nebos-uefi-serial.log
  871. timeout 40 qemu-system-x86_64 -M pc -m $(QEMU_MEM) -smp 4 -bios $(OVMF) -snapshot \
  872. -drive file=usb-efi.img,format=raw,if=ide \
  873. -device pci-ohci -device usb-mouse \
  874. -device ne2k_pci,netdev=n0 -netdev user,id=n0 \
  875. -display none -serial file:/tmp/opencode/nebos-uefi-serial.log \
  876. -no-reboot >/dev/null 2>&1 || true
  877. @grep -q "booted" /tmp/opencode/nebos-uefi-serial.log && \
  878. echo "UEFI boot: OK (/tmp/opencode/nebos-uefi-serial.log)" || \
  879. { echo "UEFI boot: FAILED"; tail -c 4000 /tmp/opencode/nebos-uefi-serial.log; exit 1; }
  880. run: image.bin root.img
  881. $(MAKE) run-floppy
  882. # Four logical CPUs (the Atom 330 topology). UP is still the default so a
  883. # machine without ACPI/MADT boots exactly as before.
  884. run-smp: floppy.img root.img
  885. 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 || \
  886. 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
  887. floppy: floppy.img
  888. usb: usb.img
  889. # Write the dual-boot USB image (legacy BIOS + UEFI) to a stick; prompts
  890. # before destroying anything.
  891. # make flash USB=/dev/sdX FORCE=1 skips the removable-device check.
  892. # make flash FLASH_IMG=usb.img legacy-only image
  893. # The UEFI half needs the mingw toolchain (EFI_CC); the legacy half does not.
  894. FLASH_IMG ?= usb-efi.img
  895. flash: $(FLASH_IMG)
  896. @tools/flash.sh "$(USB)" "$(FORCE)" "$(FLASH_IMG)"
  897. run-floppy: floppy.img root.img
  898. 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 || \
  899. 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
  900. run-usb: usb.img root.img
  901. 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 || \
  902. 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
  903. # UHCI variant (machines with an Intel/VIA-style controller, and the
  904. # regression test for the UHCI backend of the USB core).
  905. run-uhci: floppy.img root.img
  906. 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 || \
  907. 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
  908. # xHCI variant (Braswell/Intel PCH and other USB 3.0-only machines).
  909. run-xhci: floppy.img root.img
  910. 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 || \
  911. 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
  912. # RNDIS variant: QEMU's usb-net is a full-speed RNDIS function. It sits on
  913. # xHCI (QEMU's USB2 root ports), and `-nic none` keeps the PCI e1000 out of
  914. # the way so the phone/tethering link is the active NIC.
  915. run-rndis: floppy.img root.img
  916. 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 || \
  917. 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
  918. # EHCI variant (USB 2.0 high-speed root ports). usb-storage is high-speed
  919. # and lands on EHCI; the mouse/keyboard are full-speed and use the UHCI
  920. # companion, exercising the multi-controller USB core.
  921. run-ehci: floppy.img root.img
  922. qemu-system-i386 -M pc -m $(QEMU_MEM) -boot a -device usb-ehci,id=ehci0 -device piix3-usb-uhci,id=uhci0 \
  923. -device usb-storage,bus=ehci0.0,drive=usbstick \
  924. -drive if=none,id=usbstick,file=root.img,format=raw \
  925. -device usb-mouse,bus=uhci0.0 -device usb-kbd,bus=uhci0.0 \
  926. -drive file=floppy.img,format=raw,if=floppy 2>/dev/null || \
  927. qemu-system-x86_64 -M pc -m $(QEMU_MEM) -boot a -device usb-ehci,id=ehci0 -device piix3-usb-uhci,id=uhci0 \
  928. -device usb-storage,bus=ehci0.0,drive=usbstick \
  929. -drive if=none,id=usbstick,file=root.img,format=raw \
  930. -device usb-mouse,bus=uhci0.0 -device usb-kbd,bus=uhci0.0 \
  931. -drive file=floppy.img,format=raw,if=floppy
  932. # Passthrough of the real ASIX AX88772 dongle (requires the host's asix
  933. # driver to be unbound and permission on /dev/bus/usb/...; typically run with
  934. # sudo). `-nic none` keeps the QEMU e1000 out of the way so the USB NIC is
  935. # the only netdev.
  936. ASIX_HOST ?= vendorid=0x0b95,productid=0x7720
  937. run-ehci-asix: floppy.img root.img
  938. 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 || \
  939. 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
  940. run-xhci-asix: floppy.img root.img
  941. 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 || \
  942. 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
  943. # Network variant: a PCI NE2000 (RTL8029, the driver's QEMU match) on QEMU's
  944. # user-mode network (slirp). DHCP/DNS come from slirp, the host is 10.0.2.2
  945. # (e.g. `python3 -m http.server` + `curl http://10.0.2.2:8000/` in a window).
  946. run-net: floppy.img root.img
  947. 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 || \
  948. 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
  949. # Intel e1000 variant: QEMU's 82540EM exercises the e1000e driver's MAC/DMA
  950. # path. (The X201's 82577LM uses the same registers; only its PCH PHY is
  951. # different.) usb-kbd is there for headless QMP `send-key` typing.
  952. run-e1000: floppy.img root.img
  953. qemu-system-i386 -M pc -m $(QEMU_MEM) -device pci-ohci -device usb-mouse -device usb-kbd \
  954. -device e1000,netdev=n0 -netdev user,id=n0,hostfwd=tcp::8080-:8080 \
  955. -drive file=floppy.img,format=raw,if=floppy \
  956. -drive file=root.img,format=raw,if=floppy 2>/dev/null || \
  957. qemu-system-x86_64 -M pc -m $(QEMU_MEM) -device pci-ohci -device usb-mouse -device usb-kbd \
  958. -device e1000,netdev=n0 -netdev user,id=n0,hostfwd=tcp::8080-:8080 \
  959. -drive file=floppy.img,format=raw,if=floppy \
  960. -drive file=root.img,format=raw,if=floppy
  961. # SATA/AHCI variant: an ICH9 AHCI controller with a test disk on port 0.
  962. # The disk image lives outside the repo and is created on first use; boot
  963. # stays on the floppy (order=a), the SATA disk shows up as sata0.
  964. SATA_IMG ?= /tmp/opencode/nebos-sata.img
  965. run-ahci: floppy.img root.img
  966. @test -f $(SATA_IMG) || truncate -s 512M $(SATA_IMG)
  967. qemu-system-i386 -M pc -m $(QEMU_MEM) -boot order=a -device pci-ohci -device usb-mouse \
  968. -drive file=floppy.img,format=raw,if=floppy \
  969. -drive file=root.img,format=raw,if=floppy \
  970. -device ich9-ahci,id=sata \
  971. -drive file=$(SATA_IMG),format=raw,if=none,id=satadisk \
  972. -device ide-hd,drive=satadisk,bus=sata.0 2>/dev/null || \
  973. qemu-system-x86_64 -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
  979. # AMD Piledriver regression: QEMU's Opteron_G5 is the FX-6350's family 15h
  980. # model 2 CPU. Exercises the AMD CPUID/MTRR/xAPIC paths, the AMD thermal
  981. # probe, the IOAPIC mask and six-core ACPI SMP. QEMU has no SB950 or
  982. # RTL8111E, so the e1000/OHCI devices cover the rest of the boot path.
  983. run-amd: floppy.img root.img
  984. qemu-system-x86_64 -M pc -cpu Opteron_G5 -smp 6 -m $(QEMU_MEM) \
  985. -device pci-ohci -device usb-mouse -device usb-kbd \
  986. -device e1000,netdev=n0 -netdev user,id=n0 \
  987. -drive file=floppy.img,format=raw,if=floppy \
  988. -drive file=root.img,format=raw,if=floppy
  989. test-amd: floppy.img root.img
  990. @rm -f /tmp/opencode/nebos-amd-serial.log
  991. timeout 40 qemu-system-x86_64 -M pc -cpu Opteron_G5 -smp 6 -m $(QEMU_MEM) \
  992. -device pci-ohci -device usb-mouse -device usb-kbd \
  993. -device e1000,netdev=n0 -netdev user,id=n0 \
  994. -drive file=floppy.img,format=raw,if=floppy \
  995. -drive file=root.img,format=raw,if=floppy \
  996. -display none -serial file:/tmp/opencode/nebos-amd-serial.log \
  997. -no-reboot >/dev/null 2>&1 || true
  998. @grep -q "booted" /tmp/opencode/nebos-amd-serial.log && \
  999. grep -q "smp cpus: 6" /tmp/opencode/nebos-amd-serial.log && \
  1000. grep -q "ioapic: masked" /tmp/opencode/nebos-amd-serial.log && \
  1001. grep -q "thermal: AMD family 15h" /tmp/opencode/nebos-amd-serial.log && \
  1002. ! grep -q "PIT NOT TICKING" /tmp/opencode/nebos-amd-serial.log && \
  1003. echo "AMD boot: OK (/tmp/opencode/nebos-amd-serial.log)" || \
  1004. { echo "AMD boot: FAILED"; tail -c 4000 /tmp/opencode/nebos-amd-serial.log; exit 1; }
  1005. # Headless USB HID regression tests (QEMU + python3): cursor movement via
  1006. # injected USB mouse reports and keyboard input via injected key events,
  1007. # including hotplug. See tools/*.py.
  1008. test-usb: floppy.img root.img
  1009. python3 tools/qmp_cursor_test.py
  1010. python3 tools/qmp_cursor_test.py --uhci
  1011. python3 tools/qmp_cursor_test.py --uhci72
  1012. python3 tools/qmp_cursor_test.py --hotplug
  1013. python3 tools/qmp_cursor_test.py --xhci
  1014. python3 tools/qmp_cursor_test.py --xhci2
  1015. python3 tools/qmp_cursor_test.py --xhci2hub
  1016. python3 tools/qmp_cursor_test.py --hub
  1017. python3 tools/qmp_cursor_test.py --ehci
  1018. python3 tools/qmp_keyboard_test.py
  1019. python3 tools/qmp_keyboard_test.py --hotplug
  1020. python3 tools/qmp_keyboard_test.py --xhci
  1021. python3 tools/qmp_keyboard_test.py --ehci
  1022. # End-to-end installer test: boot the dual-boot USB image as an IDE disk,
  1023. # attach the same image as a USB mass-storage source, type `install ide1`
  1024. # on the terminal and verify + boot the cloned target.
  1025. test-install: usb-efi.img
  1026. python3 tools/qmp_install_test.py
  1027. scp-final: final.bin
  1028. scp final.bin root@192.168.0.136:
  1029. ssh root@192.168.0.136 dd if=final.bin of=/dev/fd0 bs=512
  1030. scp-root: root.img
  1031. scp root.img root@192.168.0.136:
  1032. ssh root@192.168.0.136 dd if=root.img of=/dev/fd0 bs=512
  1033. SERIAL_DEV ?= /dev/ttyUSB0
  1034. SERIAL_BAUD ?= 115200
  1035. run-serial:
  1036. @echo "Starting serial monitor on $(SERIAL_DEV) at $(SERIAL_BAUD) baud..."
  1037. @echo "Type 'serial test' in the nebos terminal."
  1038. @echo "Press Ctrl-A Ctrl-X to exit picocom."
  1039. picocom $(SERIAL_DEV) --baud $(SERIAL_BAUD)
  1040. monitor:
  1041. @echo "Watching $(SERIAL_DEV) @ $(SERIAL_BAUD) baud (Ctrl-A Ctrl-X to exit)."
  1042. @echo "Each 'make dev' reload prints: NebOS v<version> booted"
  1043. picocom $(SERIAL_DEV) --baud $(SERIAL_BAUD)
  1044. dev: kernel.bin cmds_pack_gz.bin kexec_send
  1045. @entry=$$(nm kernel.elf | awk '/ T kernel_entry$$/{print $$1}'); \
  1046. if [ -z "$$entry" ]; then echo "error: kernel_entry symbol not found"; exit 1; fi; \
  1047. echo "Sending kernel.bin + cmds_pack_gz.bin (entry 0x$$entry) via $(SERIAL_DEV) @ $(SERIAL_BAUD)..."; \
  1048. ./kexec_send $(SERIAL_DEV) $(SERIAL_BAUD) $$entry kernel.bin cmds_pack_gz.bin
  1049. # Kernel-only fast path: the board keeps its running rootfs.
  1050. kernel-dev: kernel.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 only (entry 0x$$entry) via $(SERIAL_DEV) @ $(SERIAL_BAUD)..."; \
  1054. ./kexec_send $(SERIAL_DEV) $(SERIAL_BAUD) $$entry kernel.bin
  1055. # Push just the command pack (cmds.pack) to a running board: no kernel
  1056. # reload, the /ramfs contents are replaced in place. The board must be idle
  1057. # at a prompt (the WM loop auto-detects the transfer).
  1058. cmds-dev: cmds.pack kexec_send
  1059. @echo "Sending cmds.pack via $(SERIAL_DEV) @ $(SERIAL_BAUD)..."
  1060. ./kexec_send --payload $(SERIAL_DEV) $(SERIAL_BAUD) cmds.pack
  1061. net-cmds: cmds.pack netkexec_send
  1062. @echo "Sending cmds.pack to $(BOARD_IP):$(NETKEXEC_PORT)..."
  1063. ./netkexec_send --payload $(BOARD_IP) $(NETKEXEC_PORT) cmds.pack
  1064. # Development override: upload the real browser to the board's writable
  1065. # /share; the bin/browser launcher prefers it over the pack copy. The board
  1066. # must be running `websrv`; stop it before browsing HTTP, since the WebDAV
  1067. # server owns the NIC.
  1068. browser-dev: browser.elf
  1069. @echo "Uploading browser.elf to http://$(BOARD_IP):8080/share/BROWSER..."
  1070. curl -f -T browser.elf http://$(BOARD_IP):8080/share/BROWSER
  1071. # gallery follows the same development-override model.
  1072. gallery-dev: gallery.elf
  1073. @echo "Uploading gallery.elf to http://$(BOARD_IP):8080/share/GALLERY..."
  1074. curl -f -T gallery.elf http://$(BOARD_IP):8080/share/GALLERY
  1075. # Browser compatibility ladder: serve testdata/browser/compat so the board
  1076. # or a QEMU guest can open http://<host>:$(COMPAT_PORT)/.
  1077. COMPAT_PORT ?= 8000
  1078. compat-serve:
  1079. @echo "Serving the browser compatibility ladder on port $(COMPAT_PORT)"
  1080. python3 -m http.server -d testdata/browser/compat $(COMPAT_PORT)
  1081. # Show the board's netlog stream (kernel debug + terminal text) like `make
  1082. # monitor` does over serial.
  1083. netmon: netmonitor
  1084. @echo "Listening for netlog on UDP $(NETLOG_PORT) (Ctrl-C to exit)."
  1085. ./netmonitor $(NETLOG_PORT)
  1086. # Push a fresh kernel over Ethernet (the board auto-detects it from its idle
  1087. # loop; no serial and no USB stick involved).
  1088. BOARD_IP ?= 192.168.178.240
  1089. NETLOG_PORT ?= 19290
  1090. NETKEXEC_PORT ?= 19288
  1091. net-dev: kernel.bin cmds_pack_gz.bin netkexec_send
  1092. @entry=$$(nm kernel.elf | awk '/ T kernel_entry$$/{print $$1}'); \
  1093. if [ -z "$$entry" ]; then echo "error: kernel_entry symbol not found"; exit 1; fi; \
  1094. echo "Sending kernel.bin + cmds_pack_gz.bin (entry 0x$$entry) to $(BOARD_IP):$(NETKEXEC_PORT)..."; \
  1095. ./netkexec_send $(BOARD_IP) $(NETKEXEC_PORT) 0x$$entry kernel.bin cmds_pack_gz.bin
  1096. # Kernel-only fast path: the board keeps its running rootfs.
  1097. kernel-net-dev: kernel.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 only (entry 0x$$entry) to $(BOARD_IP):$(NETKEXEC_PORT)..."; \
  1101. ./netkexec_send $(BOARD_IP) $(NETKEXEC_PORT) 0x$$entry kernel.bin
  1102. # Persistent update: write P1/P2 on the target disk (P4/data is untouched),
  1103. # then jump into the new kernel. TARGET=auto picks the only non-USB NebOS
  1104. # disk; use NETINSTALL_TARGET=mmc0/sata0/... to override.
  1105. NETINSTALL_TARGET ?= auto
  1106. net-install: kernel.bin rootfs-full.bin netkexec_send
  1107. @entry=$$(nm kernel.elf | awk '/ T kernel_entry$$/{print $$1}'); \
  1108. if [ -z "$$entry" ]; then echo "error: kernel_entry symbol not found"; exit 1; fi; \
  1109. echo "Persisting kernel.bin + rootfs-full.bin to $(NETINSTALL_TARGET) on $(BOARD_IP):$(NETKEXEC_PORT)..."; \
  1110. ./netkexec_send --install $(NETINSTALL_TARGET) $(BOARD_IP) $(NETKEXEC_PORT) 0x$$entry kernel.bin rootfs-full.bin
  1111. clean:
  1112. rm -rf $(B) host/build
  1113. rm -f kernel.elf kernel.bin boot.bin mbr.bin boot.bin.tmp image.bin \
  1114. floppy.img usb.img usb-efi.img esp.img final.bin root.img \
  1115. BOOTX64.EFI browser.elf gallery.elf *.boot.tmp \
  1116. cmds.pack cmds-lite.pack cmds_pack_gz.bin cmds_lite_gz.bin \
  1117. rootfs.bin rootfs-full.bin cmds.img \
  1118. firmware/*.ucode firmware/*.tbl firmware/*.bin cursors/*.cur icons/*.icn \
  1119. mkpack mkrootfs mkrtwtbl mkcursors mkicons mkappicons jsstrip cursor_test kexec_send netkexec_send netmonitor \
  1120. browser-host host-curl \
  1121. ufont_test ufont_test_asan svg_test touchpad_gesture_test \
  1122. ujson_test uhttp_cookie_test chat_login_test tls_test wpa_test \
  1123. wifi_store_test ccmp_test img_test img_test_asan malloc_test \
  1124. format_test math_test div64_test setjmp_test js_test
  1125. # Compiler-generated header dependencies.
  1126. -include $(shell find $(B) host/build -name '*.d' 2>/dev/null)