Makefile 58 KB

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