From fe6462088a6feae4140e1f57550c197738b4d9a3 Mon Sep 17 00:00:00 2001 From: Nexoniarz Date: Sun, 9 Aug 2026 23:12:14 +0200 Subject: [PATCH] Schcom v0: a compositor that actually composites Clients connect over a Unix socket, are handed a shared buffer, draw into it and commit; Schcom composites and presents. Both of the hard blockers its README listed -- unix domain sockets and raw input events -- have been done for a while, so nothing was in the way. The model is Wayland's, on purpose. A surface is not a window: it is a rectangle of pixels with no policy attached, because placement belongs to SchWM and the moment this program starts deciding where windows go the split has failed. Nothing is shown until COMMIT, so a client halfway through drawing is never presented. The compositor tells clients when to draw rather than letting them render frames nobody sees. Wayland is MIT-licensed and supporting it later is intended, so the divergences are the ones that are cheap to undo: a buffer handle is a System V shm id rather than an fd over SCM_RIGHTS, and the message carries a handle_kind field so switching is a new value rather than a protocol break. Every message carries its own length, so an unknown message is skipped instead of desynchronising the stream -- which is what lets a v0 compositor survive a v1 client. The compositor owns the shm segment, not the client: it has to survive a client crashing mid-frame, and it must not be something a client can resize underneath it. A dropped connection takes its surfaces and their segments with it. Composites into a back buffer and copies once, because compositing straight into the framebuffer shows every intermediate state -- the flicker would be the whole desktop being repainted under the user's eyes. projects/ gets build glue for the first time: `make projects` builds against the sysroot's libc and stages into sysroot/bin. It is not a dependency of anything above it, and `make` never descends there. Verified by `make schcom-test`, which boots SchOS, runs the compositor and a client, screendumps the framebuffer and asserts the pixels on the host. That last part is the point -- the compositor reporting that it composited something proves nothing, and a screenshot nobody inspects proves less. It checks the client's colour mid-surface, the compositor's background, and the white border exactly at the requested origin, so "arrived" and "arrived at the wrong offset" cannot pass for each other. Co-Authored-By: Claude Opus 5 --- Makefile | 36 +- projects/schcom/Makefile | 32 ++ projects/schcom/README.md | 78 ++++- projects/schcom/proto.h | 128 +++++++ projects/schcom/schcom | Bin 0 -> 43128 bytes projects/schcom/schcom-demo | Bin 0 -> 40928 bytes projects/schcom/schcom-demo.c | 149 +++++++++ projects/schcom/schcom.c | 605 ++++++++++++++++++++++++++++++++++ tools/posix/schcom_test.sh | 117 +++++++ 9 files changed, 1127 insertions(+), 18 deletions(-) create mode 100644 projects/schcom/Makefile create mode 100644 projects/schcom/proto.h create mode 100644 projects/schcom/schcom create mode 100644 projects/schcom/schcom-demo create mode 100644 projects/schcom/schcom-demo.c create mode 100644 projects/schcom/schcom.c create mode 100644 tools/posix/schcom_test.sh diff --git a/Makefile b/Makefile index e8c8ecb..044a872 100644 --- a/Makefile +++ b/Makefile @@ -449,6 +449,31 @@ cmd: $(CMDBINS) ports: $(MAKE) -C ports +# projects/ -- things that run *on* SchOS rather than things that *are* SchOS. +# +# Deliberately not a dependency of anything above: `make` never descends here, +# and the kernel build does not know these exist. They are ordinary programs +# built against the sysroot's libc, exactly as toybox is, and the boundary +# between them and the OS is syscalls and protocols rather than a shared header +# nobody meant to share. See projects/README.md. +# +# Staged into $(SYSROOT) so the next image build picks them up; run +# `make projects && make` to get them onto a disk. +PROJECTS ?= schcom + +projects: + @test -d $(MUSLPREFIX)/include || { \ + echo "projects: no musl in $(MUSLPREFIX) -- run 'make ports' first" >&2; \ + exit 1; } + @for p in $(PROJECTS); do \ + echo "==> projects/$$p"; \ + $(MAKE) -C projects/$$p \ + CC='$(PORTCC)' \ + CFLAGS='-O2 -static -D__SCHOS__ -I$(MUSLPREFIX)/include -fno-stack-protector' \ + LDFLAGS='-static -L$(MUSLPREFIX)/lib' \ + DESTDIR='$(abspath $(SYSROOT))' install || exit 1; \ + done + # ----------------------------------------------------------------------- # Bootable ISO # @@ -885,6 +910,15 @@ $(BUILD)/fs.img: $(MKFS) $(BUILD)/sysroot.stamp # it gets worse -- because stage2 loads the kernel by PIO one sector at a time, # and under KVM every one of those port accesses is a VM exit, where under TCG # it is cheap. +# Schcom, end to end, checked from outside the machine. +# +# Boots, starts the compositor and a client, and then screendumps the +# framebuffer and asserts the pixels on the host. That last part is the whole +# value: the compositor saying "I composited it" proves nothing, and a +# screenshot nobody inspects proves less. Needs `make projects` first. +schcom-test: schos.img $(BUILD)/schfs.img + sh tools/posix/schcom_test.sh + qemu-kvm: schos.img $(BUILD)/schfs.img $(QEMU) -enable-kvm -serial mon:stdio $(QEMU_DISPLAY) -cpu host \ -hda schos.img -hdb $(BUILD)/schfs.img \ @@ -989,7 +1023,7 @@ qrtest: $(QRTEST) qrcheck: $(QRTEST) $(PYTHON) tools/python/qrcheck.py -.PHONY: all kernel ramroot cmd ports sysroot-install qemu qemu-kvm \ +.PHONY: all kernel ramroot cmd ports projects sysroot-install qemu qemu-kvm schcom-test \ schfs-test schfs-objtest schfs-image-test schfs-check mkschfs \ schfs-fsck crashshot qemu-schfs iso qemu-iso clean distclean \ logo qrtest qrcheck crashqr usb-ids diff --git a/projects/schcom/Makefile b/projects/schcom/Makefile new file mode 100644 index 0000000..9b89a82 --- /dev/null +++ b/projects/schcom/Makefile @@ -0,0 +1,32 @@ +# SPDX-License-Identifier: Apache-2.0 +# +# Schcom builds like any other program that runs *on* SchOS: against the +# sysroot's libc, never against kernel headers. The top-level Makefile passes +# CC, CFLAGS and DESTDIR in; nothing here reaches back up the tree. +# +# It is not part of the OS build. `make` at the top level never descends here -- +# `make projects` does. + +CC ?= cc +CFLAGS ?= -O2 +CFLAGS += -Wall -Wextra -std=c11 +DESTDIR ?= ../../sysroot + +BINS = schcom schcom-demo + +all: $(BINS) + +schcom: schcom.c proto.h + $(CC) $(CFLAGS) -o $@ schcom.c $(LDFLAGS) + +schcom-demo: schcom-demo.c proto.h + $(CC) $(CFLAGS) -o $@ schcom-demo.c $(LDFLAGS) + +install: $(BINS) + mkdir -p $(DESTDIR)/bin + cp $(BINS) $(DESTDIR)/bin/ + +clean: + rm -f $(BINS) + +.PHONY: all install clean diff --git a/projects/schcom/README.md b/projects/schcom/README.md index 76087d5..5f03b4d 100644 --- a/projects/schcom/README.md +++ b/projects/schcom/README.md @@ -12,31 +12,75 @@ and Schcom exposes a protocol for it rather than implementing policy itself. ## Status -Not started. Scoped only. +**v0 runs.** A client connects, is given a shared buffer, draws into it and +commits; the result is composited and presented. Verified end to end by +`make schcom-test`, which boots SchOS, runs the compositor and a client, then +screendumps the framebuffer and asserts the pixels **from the host** — the +compositor's own report that it composited something proves nothing. -## What it needs from the kernel first +What exists: + +- framebuffer output through `/dev/fb0` and the fbdev ioctls, double-buffered +- a versioned protocol over a Unix socket, with a handshake that must come first +- shared-memory buffers, one per surface, owned by the compositor +- surface / attach / **commit** semantics: nothing is shown mid-draw +- input from `/dev/input/eventN`, routed to the topmost surface +- clients that die are cleaned up, including their shm segments + +What does not exist yet: damage tracking beyond "repaint everything", multiple +outputs, subsurfaces, and any focus model beyond "topmost". Those are additions +rather than rewrites, which is the reason for committing to the surface/commit +model now instead of growing into it later. + +## Building + +Not part of the OS build. Needs `make ports` first, for the sysroot's libc: + +```sh +make projects # builds and stages into sysroot/bin +make # rebuilds the image so the binaries are on it +make schcom-test # boots it and checks the pixels +``` + +## What it needs from the kernel | Need | State | |---|---| | Shared memory (`shmget`/`shmat`/`shmdt`) | done | | `mmap` of `/dev/fb0` | done | | Framebuffer geometry via the fbdev ioctls | done | -| **Unix domain sockets**, with `SCM_RIGHTS` | **missing** — `socket()` is a `NO_LINUX` stub | -| **Raw input events** — key down/up with modifiers | **missing** — input only arrives cooked, through the tty line discipline | -| Mode setting and double buffering | **missing** — needs the virtio-gpu driver | +| Unix domain sockets | done | +| Raw input events — key down/up with modifiers | done | +| `SCM_RIGHTS` | done, and **not yet used** — see below | +| Mode setting and double buffering | partial — virtio-gpu binds, no modeset API yet | -The two marked missing are hard blockers, not inconveniences. A client and -the compositor have to pass a buffer handle between them, and a pipe cannot -carry one. And a compositor that reads the tty gets line-buffered text -delivered to a single foreground process, which is not input in any sense it -can use. +## Design notes -## Design notes, so far - -- **Buffers are shared memory, not pipes.** A pipe means copying every frame; - at 800×600×32 that is 1.9 MB per frame per client. shm exists for this. +- **Buffers are shared memory, not pipes.** A pipe means copying every frame; at + 800×600×32 that is 1.9 MB per frame per client. +- **The compositor owns the segment, not the client.** It has to survive a + client crashing mid-frame, and it must not be something a client can resize + underneath the compositor. - **One protocol, versioned from the start.** SchWM and SchDE are separate - programs, so the protocol is a real compatibility surface from day one, not - after the fact. + programs, so this is a real compatibility surface on day one. Every message + carries its own length, so an unknown message is skipped rather than + desynchronising the stream — that is what lets a v0 compositor survive a v1 + client. - **Policy belongs to SchWM.** If Schcom starts deciding where windows go, the - split has already failed. + split has already failed. `CREATE_SURFACE` carries x/y today only because + there is no SchWM yet to ask. + +## On Wayland + +The protocol is deliberately Wayland-shaped — surfaces rather than windows, +buffers attached and made visible only on commit, and the compositor telling +clients when to draw. Wayland is **MIT-licensed**, so it can be linked against +without any conflict with Apache-2.0 (see `docs/architecture/licensing.md`), and +supporting it later is intended. + +The one place v0 knowingly diverges: a buffer handle is a System V shared memory +id passed as an integer, where Wayland passes a file descriptor over +`SCM_RIGHTS`. The kernel supports `SCM_RIGHTS` already; an integer simply needs +no ancillary-data handling on either side. `struct schcom_surface` carries a +`handle_kind` field precisely so that switching is a new value rather than a +protocol break. diff --git a/projects/schcom/proto.h b/projects/schcom/proto.h new file mode 100644 index 0000000..f8925ee --- /dev/null +++ b/projects/schcom/proto.h @@ -0,0 +1,128 @@ +/* SPDX-License-Identifier: Apache-2.0 */ +/* + * The Schcom wire protocol. + * + * Versioned from the first commit, because SchWM and SchDE are separate + * programs: the protocol is a real compatibility surface on day one, not after + * the fact. A client sends SCHCOM_OP_HELLO with the version it speaks and the + * compositor either acknowledges it or closes the connection. Nothing else is + * accepted before the handshake. + * + * The shape is deliberately Wayland's, because Wayland support is intended + * later and it is MIT-licensed, so it can be linked (see the licensing note in + * the README). Borrowed, specifically: + * + * - a surface is not a window. It is a rectangle of pixels with no policy + * attached; placement belongs to SchWM. + * - a buffer is attached to a surface and nothing appears until COMMIT. + * Atomicity is the whole point: a client that is halfway through drawing + * must never be shown. + * - the compositor tells the client when to draw again (FRAME), rather than + * the client drawing whenever it likes. That is what stops a fast client + * from burning the machine rendering frames nobody sees. + * + * Where it deliberately differs, for now: a buffer is a System V shared memory + * id passed as an integer, not a file descriptor passed over SCM_RIGHTS. + * SCM_RIGHTS is the Wayland-compatible route and the kernel supports it, but an + * integer needs no ancillary-data handling on either side and this is v0. The + * message carries a `handle_kind` field so the switch does not become a + * protocol break. + */ +#ifndef SCHCOM_PROTO_H +#define SCHCOM_PROTO_H + +#include + +#define SCHCOM_SOCKET_PATH "/tmp/schcom.sock" + +/* Bumped on any incompatible change. v0 is provisional in the SchAPI sense: + * nothing here is frozen until 1.0. */ +#define SCHCOM_VERSION 0u + +enum schcom_op { + /* client -> compositor */ + SCHCOM_OP_HELLO = 1, + SCHCOM_OP_CREATE_SURFACE = 2, + SCHCOM_OP_COMMIT = 3, + SCHCOM_OP_DESTROY = 4, + + /* compositor -> client */ + SCHCOM_OP_HELLO_ACK = 128, + SCHCOM_OP_SURFACE = 129, /* the buffer for a CREATE_SURFACE */ + SCHCOM_OP_FRAME = 130, /* draw again now */ + SCHCOM_OP_INPUT = 131, + SCHCOM_OP_ERROR = 132, +}; + +/* How the pixels are shared. Only SHMID exists today; the field exists so that + * adding SCM_RIGHTS later is a new value rather than a new protocol. */ +enum schcom_handle_kind { + SCHCOM_HANDLE_SHMID = 1, + SCHCOM_HANDLE_FD = 2, /* reserved: passed over SCM_RIGHTS */ +}; + +/* Every message begins with this. `length` counts the header itself, so a + * reader can skip a message it does not understand instead of losing sync -- + * which is what lets an old compositor talk to a newer client at all. */ +struct schcom_header { + uint32_t op; + uint32_t length; + uint32_t serial; /* echoed in the reply, 0 for events */ + uint32_t surface; /* surface id, 0 where not applicable */ +}; + +struct schcom_hello { + struct schcom_header hdr; + uint32_t version; + uint32_t pad; +}; + +struct schcom_create_surface { + struct schcom_header hdr; + uint32_t width; + uint32_t height; + int32_t x; /* v0: the client asks. SchWM will own this later. */ + int32_t y; +}; + +/* The compositor's answer: here is your surface id and where its pixels live. + * Always 32-bit XRGB8888, stride in bytes, because a client that has to + * negotiate a format before it can draw a rectangle is a client that cannot be + * written in an afternoon. Format negotiation is a v1 problem. */ +struct schcom_surface { + struct schcom_header hdr; + uint32_t handle_kind; + uint32_t handle; /* shm id when handle_kind == SHMID */ + uint32_t width; + uint32_t height; + uint32_t stride; + uint32_t size; +}; + +/* Nothing is shown until this arrives. The damage rectangle is advisory: the + * compositor may repaint more, never less. */ +struct schcom_commit { + struct schcom_header hdr; + int32_t x, y; + uint32_t width, height; +}; + +/* Raw-ish input, already routed to the surface that should have it. Codes are + * the Linux input event codes the kernel's /dev/input/eventN already speaks -- + * translating them here would mean inventing a second table to disagree with + * the first. */ +struct schcom_input { + struct schcom_header hdr; + uint32_t type; /* EV_KEY, EV_REL, ... */ + uint32_t code; + int32_t value; + int32_t x, y; /* pointer position at the time of the event */ +}; + +struct schcom_error { + struct schcom_header hdr; + uint32_t code; + uint32_t pad; +}; + +#endif /* SCHCOM_PROTO_H */ diff --git a/projects/schcom/schcom b/projects/schcom/schcom new file mode 100644 index 0000000000000000000000000000000000000000..ae9f2c57090b74fdaf570978e494cade170e9763 GIT binary patch literal 43128 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 Pbcl*Cz;PL5fUX|^)NY_W literal 0 HcmV?d00001 diff --git a/projects/schcom/schcom-demo b/projects/schcom/schcom-demo new file mode 100644 index 0000000000000000000000000000000000000000..d6cdb49bd89f2bfb3473b7cec3e6bc1279af1482 GIT binary patch literal 40928 zcmchA3t$x0_4jNZB;hsTp+rR)b*V`aNE9?dDH+(18QnlEsI<0*u-QOLl1=wPLbbAS z6Jh@ADxbA~ZLux=Yg^me&-P!7_$Xuvd#G+^{DX_GW9r-OU2)2o^J4IJontK z;~CHRe8lStm!7`jM-mGd&nz7*JUx~N;>x3Zbv$3)lM+KPp6N+C{&u5cJl{9pb5~IP z{@L=ln1oWEZ|@|X?%qif3m8wc4i=23A;a5{kNEsoFUn7U`Me(aNfIMrJS{9H2*#6e z>7pl9mG~}Ray#yVkc>Z0hNV*z5scE;zWQp`dw>4OT(o@W#cd}a_Lj_VXh9NPk|~x; z5PH2{FN5-1Zr*j*&zXC}jrj%g!bO&%#iIeIGL63qgya9HJi3TKx(vA*eB~xw1efq< zq#OB+r_rp&GrC~G0-(pPnKR4Xg3GqX=BSxjVXtw_lMt$@a=YynQf|Za+#6O%ju?GUPJD+QOsw$|W>?tP&93!SR}0y6&$+N#v4;JB97xp5B@W5%bUK_8 z~ytJXtVT=wsK?6o$#U~$xxSJmq1!Z+kZt2&(PV<~7|o89FS788cOp~~fU33rrNd+g98hg4neTy2-Yzf@7~M&ax0h!4qC zM+#kSuXIa{hjmq`#ZnJql~N7*4Ctd8Xk%cl^0?LuYONc>@YIoNyVkqh_8Q4njz)`N z0aE91mOHDU!k*glb>&sntkP=jy7KBOWU|}W3X7Z$mkXVeij%6VYS$uvdBsdeEi$nh z>ZApWQA;KbP=?GF=?YCUBbmC<1X7*d?u-+iyQ&84IXv#6$V|5d#o=;GRW7N*QC}O2 zcxs`wwl$1XxuODuU1)9zok3XWbgZ@4N_AC`m^ynYZ(O52cpV_uay^@{uo`_3&B^NK zgl3=)6|q**;fRt73^tQGUVKdU@%1Jsl?Nrl~I zb5_+s=fG>MSr?X9Bqmc`ZELEkE6Ct5l_VrXJWM@f8aY@tX@QHflKA3Fh-p>@RD{X4 z-r)gphs_4lv&;<($@`eiu@0SwdRVCw;&*sl657~Kon=VRvX!H+Rs*!yQ){E%%<@;& z)K%L_mU?T|Kn2RtWzZ2&b817q)2QgE?yAZvkaePitOK@1Z)@u4+i^$zFSSob&L@!fwo z`%=q!Uq>^6@BV}ZTF zX17-uT3=D+sX;4yYAb|0S+m2G5{Qi$B^c1E*1$O^hZhBFj7;C;`XjBi>y0%ifLj3} zMTRfLY@iWmij5u$yILU-upUTG`}cH*3Fh2ocd~&faiFgenuT8o<4j|cE=u}U()~%7 zC+8(kH=Pph5*8-UPKpZ83d>AINz0Qek{(SunG{XBO>iYGNj@qpHrY+zO^%voV0N@2 zd4E!M^0DN5OfSQ+{5*NQ;Z7zN7K>k*GB>3-MEXv#~#+d72CMLg$U zQ@T<(2;}8}P(uI>)<{fk7Z&3zQ(}9BJL@46Ebu#?(yjiDR!F}3kkvm z3bR{=4#pk-F9r0{OX)uRH6)!0Z+N^Il&{pV_!PRcTZRtCJw82_i3Ki>i!y`9ZW%fl zcl?k3tCwI(N=``~m6o2tbB-P}cHDR|bHc<)lP|h>O4cQpUN-geE2c?TUUjvO@Q>2} zRR;ct@ll_YwB%8w%%;ndZ<6p##@}w}z|DAmf#-61qM_H|X$af&gKr9^hD_6CW7E<% zV=_wcsrd5(|7&;(mNceCben^}#}VKiMzA8T;I9cZ|A_HPkjG~(9G|stytHt9_QLVG z^7#DX@x4jDvr?{sCxFe>p~z@drgD}zt%+qJ{MNmL*Y=gak_2Tw-QAP66N=K@ z;?CGffM`$U=2mf9p-?%Pe+R>F{DeKUUM2X+0wvg=teD!AgXi57VieLig~a?+zIXmy zFADO^xLwiS3;h5M9LqL(XYV9Q2>s`=6VbL*5m=`0f`Ua5aHl*1<&R-sb^DI3;FIMc zQf0{Y-SD?Su+pe+_*TRQtGoAh`A+!``F45vGNtjOd`QR_O%fm6h=8hn(QYx1?L{GY zPTi_Mvq(AQok%BWW~u(1T!H6ysjx**G>chMG`BfBay^OaR{y1+=7kniKEFh|VRbuPA)j#zMMLVGc<}P?E8VzM&b+Ea`GrcI_ zFv$fU|8Od&l6N}qQ0Uw(Xdx<7`!w=raT>yu@7Hf2-$CeYbBp+B3o<4lqxeKn3VH`j zV$*8K003EhVz-WeIhFHE1K%R`+-&m9wfZZ}**gDU)A=83@PDx$pQ?QtzKNtes1G{5 z&2NI=E$(4*J!=tp|=dLBKeN9XY9Sdc~DxjZ@*(a%K(BmKF!p~-v=07~FFR;bqgVl8rq zIx$cYca14br%06q1(o^^3v4Gwvj~J%E(Lf60hEB-T>27$U!L3~-xE5Xq1WXNC6MZPHyTy^>0o@;v1oJ$6&8+Qg5h6oUekD{5mB+ZkSe&` z+~7N75}OxOSCMcdYP(X8fdHBcW_eDC*HDq?L*rC8Tu zsT6CiW(mPgn4*yCYnfb>*D1e<9z?RfXjwPO+Hv_^`g6KZf6nydscMl(7EGQ6RxBD+ zP2H;Lcu7H6Y+8w8i<%(=Plk?F|C%r_f#sy^h4--T6YyvZc#r{K`MgNnuzYhbJ;rWUe7n*s#lL+8q`&P^ z3XX`)WY3hq9VRufG^!MwVxkh8{sK$H3EV$o+x!GR*t@>!8K=SNC(ms;?; z=bi9FK%=f(2ssJLcBqLUQ3zc(7vOvXuzq1N-)zzDH7gda+H9rHoEua9-`#->O!Xs_ zH8B6JBj{wu6=<6T#hi?`%Y-Vu1LpxM{nSZP>HJUy)Et_c6?zGyMR*s>nYw``lD=OC zt=K`HCu_{mX_%bw<2v~}Ux%%p3lBK_pq@)*xw1mP90ij3p<{SpNO=rsO5mb7^uQRS z1;N8?c=nOyAfF6qWHACir@(yhm7?>7j0FUm0MMx(#wtJ_s!>a*7ab~c5pq3FC}{{x zM?&bgaQT@H*SeL)-83fOC4Wc$u6(y#_TAQaUxkM8#JGG14di4a7435s<_%UudNCLA zywjm&x512PbF&)I(YgPl`o1BQ1lFZ{P9tIGdUP27DDrqz)z_988Mhfx3K3`mT4j3u zC#ru*Kf3I0De{iuf6%;@gywHDORUIoZ-4|LPgbto6 z(iNDCEXvq?eEaAWNl?V1R-|8pbnf3EHi59CE#fvM>KmBt{MYRHa$xB?9|^wWnbbBD^dPqn zwv$u3gOoMzkeJ%svflK?X^VN3WErU9&{1JrHcyf4)7BYt&rvQ@zml2{O!dk(tAGAc zfJ&O9?i;NETe{I7tXi)+qc~gDQp}KxI%7k&>aR~%{dZ=DPL=@Qzkn)_Y@XLZ|9>-H zl2z^QbYxVJLR}S7j5R}yAOF&9rMXjV+J|~6{`xG7e_WQEf*Yi~7I{0Mg8U-pPf$5k z`#f@SO#i{pqD<9vR*81HzbX4K^PL^#4wq0D^PNrdh%9I1xWT{gY?>-s4mX~q4Si3C z>c1#-aP7nkhfuha55m0%D^lJ%y;QVc1 zz&U$6?7i?Jby4}nt8mYYs_iYL1#l9?R8?zJ{Bs2&=D*y8hZ;z^L2rAd@3?YhE1Lfp zszlA7UlORq7|89RqIDbX4>Lcs{cpXn{Xs+3Mp-pix}seM{`WXhq;?|o>Jp~sC8Xyo zf%I?a`9u7V%>Tr3TM(+LM^ABd|xnIz8*JX!41;@UmNHt)w6h`Vy`fgzFeX|t+CqMqsOTjrw&?Z`s6MH> zf3^K)7K!w6K9H{14sE}JK^3h%j3GImM@8#b8l$G(Xw-SpGAN|h8tTMAp=Bw$x+EG* z;K%wd6%meruedrxUMK5f@>2YeN@qL<3}vrk>(dS@?I~ukBJBJ+Zi==Gs}NAl&@)zw zwXX=<^jyod&sh~tQ!R3UT9kK4M-@|j{U5qrr3P|ptL5n#)VyabZA!5RCXeoq7X$(!V_1_i#D`XW{`@L8% zz;J?Ib2SDO-%j$F1aZ@IxWih8W<$H0Ti`bD2|opp;+uc1gAkgc6!XuYhFFL^c&!y_ zQZ1nF@qkZ3DD+=|XS9ayLDO6PxslO&dzbjv)s-}#c9+P$9jvs5%c-P2$f}nV$s97j zEBuQ|^)Jp=Z(5x19!;3E-jUH-*z~dIIf~v479+n4%|$7ZZ^a`|L@G^lboyn zaLcNHUAj7BU8Z|1()3wC^o~;T&K6mmuvk*t7w3Zufg0jU5OT@`T7ZU0ytj;X(c_C3_}oyBfPFqy>A$KTRp< z&<=QxDYgUK3An?H8#E4njIaNgXBPwJoo0~8bF8Q#yaIroYQW^6>Yg0Ofx zmxB0s3;bB|(O`PeGovJM?KEy;it^qaoUhB?dsBtcZbgmmR-zr&f_FSvtb8NyIHh;PGB)b?1lPdSTS zFbT~cyTRHAs}uCPrp*oL>V65clPnCn*_6m0(zMkIp-!^kGWU7D>xH z)c3ipwZ*wie0H;UuRqQI@Fr9^a9cE^OM8rhPp5mXK&KNY6vJ;VUZH5k`S{CLl8aa3 z3Gb=Z*CAARf}Tut<_)1U>mSh>6GsPB#(!@(DxtIg zfSUv=-D`9z-x$KnfBhpWB5I7`O0U;l(H=GwmhPmT+t8Pbu%4TV(6$?|~ zxk=6yn`Z!sC8GA59w4LOhIhOKYPCdik5K}*nH24g>`f-jar?Bk@Kzwuc&cirwXbL( zSODuS{^=pT1UDN^-Wb4iCGc|sS;TF7ia6ORe2|meqS4u&dJ35$9ICeLhfo5h?K$=1F^Vkir}gr{OIKM86mX`e)X ztIKB@Dw4+>UB&|+FI4Re+f?}fHEyJ%PI2SLPCC9|)sBQ-C1Vmlek8bydrSQr8baiK z!F^)uUl237d+slFEgH1HitnR*TA=ZhIm5_h^*gfF92nYaa~9QAqPk|&EnPLerr0(# z&uS7HC@wLhkav5;*U8{Q3Z`Pq;x=^)F3_0WRoJ#Ko_OkL}8N zE%HdyN%g)!x^szxYKoT7sqWf{^FGp>->;{)tN{=`Y@r9q3 z4eLVd2fmLmQ7l$+7f8bCv_j9#ift(*fdbj!u4<=tOj=H}Feu1=tWsFDUF5#LZq@c- zX`l3Ubo)k9QBuax4>2%-(af0JAJ-m@A1P>EbVevVjW=*ba_J_;Ry4)TB(_xKr`a+& z8`xqD=u2S4k(3t=(T)d1eu-gSE?R% z$uQy$19h5WG-k(-S5 z07T%34VLF^FirPdsz%$Dz=|YqL(+7lx<8DJG4L_)sX5rZ`GB`vKnXAulv{OZ<&f>sW&7$pZgrkA>Hk~RszXPGDMJ(PY z?r@?VcY%cO{Aia`ZXAH}ja}C<2$yN3jUv_gc37H@((Z+VS+KK!okI^A3b~n5=8XDO55z}KyQy@z;~1CV5h z^w&W4{va75eF7ma(m9ZxF4C8|NT*`Sdsj-BdYJqYRlFz#ZW2P9hAU!eG++4a~l7*LbdOe{~!T0vw2_=!wb{VIgGK3&z; zr(67&SZU*~sQI`o{-hnY9{MKk7!$ay*>|Q*ynj1{F2lpHb;{alb?uRP=+EM|=SDx9 zDG7lkQSU&y^PuniW$t`ZK0lCQr?Et$^CLEmxtfg8y%=(XJ1hepBt(*mqP zI+Da4i{KS`Pl{T*?}NkMfn>3$zX*G!mVTg3m9=)6R&~xte@kj3i$(1ifu;tEcl!Eo z6gS?9hL4)}tQ;?4fActIqD>Zaw$)#4&c}}4RS-NXR#&3EalG2RatqYZ3Z8_cEyq#a z<2RePgi@jS7%EpGJ^N@6GYvGt6>dM0EFm*?Rd7I`3$uCm%O0;*xrYn#Kt-XB|C|g9O`*ZQW)F*b+w)l}Ia|06J z)E{qk%D&(`7SOSVFHI2yY(v#af4w9H;xOX|nTEFSLg0lRdMrqFI1$={-MEk<-V!2K z3N3+#&o zi6x5n{~VZ%KxDGq*hcOd@F8lpBp8~}Yvc+NbK2+YYY!mRMuBmvFkH16Be6&Sk%tze33MkW&x$NVGcWh z$>V3?gX5`uSS2O!4C9C#-6@!JX0r9poRxuw ziIEKdCpru)ne6*2P2BhkxTy=H<}W1}Ox3na?_ioKyb*BFkax0tAhmL^k5Ru1znf-o zL+fUAWECB^5ORj<)2S}HsHYRiimA;?wH;~-gYY{f(A02c_*EQHLIX@-PQ683*i9V! zI@5PH0EN|*Tvk-FR6FB+TQaJxwfWu`#ckWRCP_kJ`jNs-9=+P36wkY?1EbPRx>g7) z8@3Rw8&~~bg7LxD&1*5phVMfH8PcY3CRm2kxw6FePKov)NMJt;VM1Xs}6r8ZK~Lr35kV{Zz>6pF|Cp;4v+aZ8bj*pW{uDLBVsqR#;w*?$9#Y840)KR19MY!axZ zFMuX)R0xChr#;N!{4kV?ZH>tGc;ms04@~t7PhSR^P>U&|!fb7}H86Rs+PKRL3ue_G zHE%*%%wIWrulYOT^Ej+Ej?NobqTM$m`RFtHqvgcQ<~qpgXtnt}a5^X`Ye~?GIS2_| zKfOtXwN;R54dN%BVUM@Mu#%KMXeEEzBL0|GRUbje1dAnFxA@Ti1~;S^;Le<)Htr_w zB2%C>R!jvgIh|zfWUW(tXbTc#-@xTX;-dX(;0NcdXof0_)|qz*Q(X1sW#8Vib@q0P zao)hSy{*{uXa8EW6VO7O!mRlA5=i}q&D9&I*u(9bCaeXheQc2og&rI*0# z*S81y2RWyXwroMyNvogpW;e+U z;|h>zB1*`|_23(w@&DfH^ac9~*K-Ki-UTzo=HJ8S9_>8Z(|z)-;L)D&R>L~$dNawQ z;eZIU!d)vkw{8DonG9YFG$==5SxDl zZnak}IbUG_K(O&E5)B(f#D%ZL#*l|+8A;Ch+>4?SVSM8r8bTVsq7h`>Or7gU{OB>! zD4gYr>>tdmBTvyV`(-tx^&3`0hGHogfFC;$rrBli(-bA}Sj>FNY-cTe7e*ST?WRfLt zbBpXxG5h*QJ14wAPK&7%(;+$9UeMwC0`{TQccv1CgmqzfOBSs=r^9z=^w zu;8J0uwJzboq`TJUuilJnB0QvVs+4;ST?qScmjxQ_4FK~vgt|f#3FzPxHSQV6gyZSvR5bgK`w*wf->$(Z` z82&o&_X>`?-PdI)=yH#TN*9?96$d6i5)FF3wA#9L`32^r@Y*d2T>Ep`A4q|sXdT$; z>-%g;VC>J;#vnmT0)I)zqxq27oDE5+1?R=)X$a_}2L`XLs8aZL7&$qx=yIj1g$W`U zx-#0LH=Vo_L#q(6g0Syqvw$On!MBrC)88;JD6PcajxOrJb90!WMavNt^PQZ7YH%P) zEeJy7_bcMkGs!SpWV%G{6nxOWqnMJ(WVi~>xqeMMr_sZ2}ch)9L*zo9d-(ifAgTrck`HF^fA0I$Fk^?Cd11Vl@Urt-0cVDhCGNV3< zcCfyi=1`?*_luDhKJ@Gij=JL=~S!Xa3~sz|A)VZr&+t2jrZ7+1rs@w5d3% zM)xbeGuY_*%ylG^+16zK1+wH)UJ8(3QRwSRBCoSB7@j6{dV@3MO*jvV!s@(15#jTy zul+o=%rAoE0{Y%gN0X;_L6niN#p^?C5HA#e+Eyt37zb+m#HK%>6nGAIi_g2wcQ@|S zU5Dq)j}Z77_Bj5iITMwIPL!=msU{6D8-oQqU$ocxWPN$IHw?QnW5Bj433T z4NH1n`^1uS+H^`O*i{s8&q%U}C8r=fi)g_CTbf*%dfAk>v4SR8IE~-@7>X&<_F86C zU?TjGhM3%VE;b-y8u2#;t>s09cSuMKHCz+JaL!}nMRiTBge9rr^(B2tq$5nfBpci}|17#u_n4{cuYfe!3##3RQy-bIvS z-#_$`K6#5gAFwjiM*=`6Jm@3s9)fA5?qDhCw}?yo!zP&>ernSuOmDoOq-L)2=+vu|ltGEtHSa`=6;L)BeR*57zRwLG~h-!+Z~}|Npb~eGYG2F)96%^=%r0Z}mUL%m})!_z(?2 ziG7yoGBprm-G5aK!?`$)^@)|6hxVY6+b3m6`H|t;=d@8MiT-cL7pkHt%>Bp6@5|h+pA7Ach$JFQj4ip}RbTOA>jV`ig`F-71ny%OA7^ z!C-P@uON}O8|xPXI8GG042VSq=g}X}>x5MhWatlm4%?Xqn+OqCgSMYcj(F@9>yqQ)c)hM2N&5gTzXm1U zVvEckiKsMq^JjW4hU1V899Weo{5A@{(e+j*CNf$^cko0Q<2_rO-PN?qQ(-X?xN(4d zIr0A4nCTFmY)l>=R{~9DZxXihOhJ7XfO&spitIOGR-nPh44#`G?L@8zQjkk-m$CeW zm7RiupXdPV4E`DeCJb0zD)?aCcg0PimZP$%6&0MS?Sfn9QFqY1hF+!c;%P1D5g+&uK>W%%I?lcU!KxrF zNgwQ(|C68mdtyp=%5-Y@N7VeNa#K=>x00pKpey9|AA$)eJy z1oW+WxMDcTFFt!l34VIDC6Kb981oVt8;LnV+1r_G*`#94uv3Y4VT%uwlk@cl@zTm* zUV1lgD@svvjsU^5VLs>)>`?~$jDo*p!F@6T zkz2?wq-f+W1qTj&@Au#+5FAuh>riugtyl>oZv+Q`7m5=qOug*hqxxEKzOLO9Q7|-O zLy1t_m&I7jIoP%^noImggE(!IbZ@U5{B&B85S6{{Gc22a5G~yFz4PRR8gm0R=XFDt zDs7fuirI#Y_af0+g>0Oa3);npQvkIjV_Y{zQ!Dl=vuS9i^2O#ZR1~vKTCaI%2g1V` zHQ?z+?HK$)>|gBM3J-+HO5Uh8P)GR-GD1 zSAcZnuY=_D>^a=p@x0>jd9#Tv=4EC34y{f`*%7;O1etH zJBVt*K2=FtF?FT=)`GtJFPJRF=F{-2sh3klG1Vg_ zY&*;~Bi01({tVk0dx5D2tY&N<$E>9y7VE3%G+Ev>0ZWBe4Rbo$Qz)f%JlfM(O};Rb z<7O=g`E_C6=IX%Y3@l}7Z8=AVte^B_*52Xjw%!CH?jl7C4cdVY@qwQakM#1S?{Nxg zpV9!e6~S;TZiCW#hDnPN@w}w#%q)G)l3bb(OSDf)v^PU14$&S~1p6L3yR7R%f%~3- zM523OsVy13?rZh@(|3+ZkpxDBQFt@7RnH!iQ43|mndD+R73@2SHtJIPjuDeN`}0oo z^9Bd7VRyy;7e7s zeo3ARj+eg~$^svFB{;@MKKLlgiD2MOAqixQJ`Xwo+DBh~(d=l(@M?f)JQCb9c%K?l zzfkMJL=`x>1!U344~?eogl^-7$VDFw@>nT1x(c=TjdA^D#P-Jf(6ma^k0Gf8>tzLf z>&k}j4>({r5ScT)-f#Yw_1!ZIdkGnA%%{yt)|4NSG8{U508R{h$LIIW4>J(I=-vCdBvrWsFUP^*0NS=GNJs6qpa}OPruo|QfNb1GLfaPS% z?1>u)SL@{(8wfb`|6%Che$*p8wlz1X73b6D)8R>i?th>Lr95swRxrQm^-WjIW zdclgmc>h;lMxz(3>W4o7bSFGW_*JGTR`Y22x(`cQZFqU_6XqzX!TuzyP%RBiZ6RlA zs+#jTR($*N4wXQy#U;nof>x_o(j9Jq*;Z})t)`<&&MCzg1O`@h6>&)y_A3>!q(jzT z2`>YZtj+O;{{xO#=qGr=sa?1grH5BSzBm^}ukCgqE;io|0D8#^yyMdYfZvru+mOc) zw4$XB;Hd^S;Arb}>=X=+x`oJ3!>M{gdr?o82u#~we%Dw6(uIzolTuGq43^WxWCqQ)sBA?Okk^rhy13SHl5%ft0 zH3NF5+StCCLGfb4XCW#;W(S)i-@_rqh68Zv+$As$Yq%djDt)sM+=7Y3UvBar%Pk+UUqwyvBl)Q%bs`-GbL9FchS< z`ftHb$iP;VA#Oa1dn`kyc1ue5Fd#Z9aU(TgEEVL!uf-)EOiW}lW=x11+Y%FlaXD$7 zVhCBlhACV2yUX%M; z*lO>OTXJ3%e@;8xtLd=4xb5^%vxQgELyt{}S*%=Ddp|N+A1{YE%~MV%OP-JUrYFvp z9t&Om3QX{E0*`}Bs9~mfER+Elbc zC=?%W!)Xh*IGrCvoRYvNt7A~=6P8^@L6n>mw6k9@n+Tk(ETto8QpWu2dp(tYPQ)Tb0~y0NtsuYbIH1F-!X zxuA-#KyY7!qf9tLQlGE&21BF9wrol(^uE6Uj-0n}Q@x3q4n|x%E~FGbXPylJqB&xFao+3UB96CSS{eyhHGL>Zbx9A6MCIIs_*;XBRM# z1Q>05N3;Wd-A$dMWml{IJ{x`VA_U=SuknvwU}Fr1591R1ssq_mmA3Yy_y)!+n8hHZ zeWJgs(jKJLP&3Roz0Q@z^j(=@HLtKHKgR|+)wIv5U5^e!C9qE<#9od;mDzdrf2I6e zQNF^KEkMpY$Vn*a-(ulkF8>vD`@vEbqyEYN-|CO@hp+#?#lpW{e~5k9^6#gH`IlAT zUoM~gs0-zv`fn8u{Zq8(Tc}3#Vk8|n$A>Cto~&&o|4e}sfe7t8_A(a_uA6A-QnZI@ z;ALhFub<)d5_~IzUanla0Kuq^a-{CF5+s)WLVt;Hu*-*+NXKOrBJ6+jq=q8de|T2+;RR{2MnRcR-24JhGQj zAsxKKS3Km^(1iDJ{K-$JcwjwlU7;l3x>C_@g&%Wkda&oRVE?qc*bA!3jN8~iqqDm= zeAk}%*9+s`&&5EQrE0JG&QHfEfQ3i)VzGNtX!H)lQ^dPM;X`mZ;YeVC6K{h}E5zq} z7N@H>JwSqTUk!JPUJXo#s}fN9d;_V@p2!uny)!ufgg`?5ScK*2co{}=zvSzmNgp1V z;kh1X4-vteOS|R1H{xku6GvO_YyT9IcALY^C>B`^z@$h$(SIEDImlD#>(BL+$59fS z9!I7)YB=+J5^ox;5Sz)*8-nR2+c8)t97vLPW&+9kLU5uaWQxA^KnOpB8!ZjfdV+T&%A6%H(U>cOza;8JjPTL zZOO8ijuxO8tf-I1p;Cls;5tqN*NUO?#oKadkB3-$V88k{w8tH2kBrF0y8ng(RD3zd z!^*H~{ej6_0#i%14$vcN>5XS;QQf&+BjVylGmNAK>qqz^!N>TLpJF<04P3iL-T6~s z5hA|VG}!(qFV_B%@v-tk=_t&qMevS!K+)gNX{151;H>CtAUhP8d>N=dB5Ql;B&#Xx z`kl-spW)4f28pzvMYl^3zBAtttGKBcc*F?G$H2QJoxb?CfGGP~&f|SS5_$L%)I{Ey zPHlu$KDl{64h}<(AS-VBEj3o&ak=1A@c}dP#p&xmQ@?DmCyURXFhv+Oji`y+!XUQ} z@@)V9)HISOquz!h4SC{CVeAjH<{RuEc)be?a=UTxB&?eDIPv!5pnRvr$#<|Mynj|N zg;#+viRy_nOjP1F#s$5b_CPUJliq&sQTyIQJA5C9RImiu8_qMB0WlQ#OI-@ItNp+w zj2yhxMS+wJ!JcGGPJb|z>g!1pcWeqyk_OM?YHuFKyZ?hcib|lA>zn``*bJVuS3;w} zm3Gvky^{eE9Y9&Xqq2&`ZSSEp2bZO#?yp3MB+*AS;iH+q_f@Y+lskBTeyL+*%NE{ZO^-R`Obv z9GujBGfblxKc5Tx*N+;;WncHT`1-sV-^y`V^~XXRVA9)#t3V5%a5}xmWD$#ch$UXQ zsBM7k!uR1ush*39n&0(ghSXRtHTr5~GMEz|C<9I?H-z6uV5OhUqi<$zl=AH zgLonAR7p;-BqONy9fVm)w>EdV-@*9|tgL{x5>QQ^FYw_Gyexrz1A27O1K%@a{tiAv zah~3QJr=^o6gp$jip8+z7Pu*|5N4c1z=ZWE=C_CFm>3&_@$x2mV`2V{o-ssSI~abR zdUT-J^mH0pBnSxh6WOUUOk9i7yToQ%#wyIu6`KM&X3`+0FL-_k>f2z5p^^mw(d2m4 zuZEyLZ=lj*5KvR%QO^xQeb7Lq9Uq{k#-pB%L-p8M;qQ@H0>z`^(ayx9eS@LVz8}!i z;?V};(WWr8#|Vu+JBP!(lo}aDOaC~uL+|90mOz;9yRlW8?p%S@kA2E^qwTSM#JZpO zY=^qtP>~`2i(gdpI#q2~NlsTuMwi-$1y39lwP6Y0C=qni>fwG;Q_wi^Az9@ zAN;_cRJ7CcIi~uAMtn@}YsdT@FJwQ3ja5Aig#rP*QS-U-D;&;ur#=7gYXE?md4$`PY9xnKWud;_m8^lWrS1>4uS$E*mk)V``Pzf)T#m6ikz&Es<$* zBNn4@k_}5(>A@ud<%pI6Z`(* zhF+90pIX8FX~Ne&@F55Kyi@n!r#@oeV=B>L@%m}s91A9Wv}>w$m7q7_6&v=+rtopF zi=uEYVrLS3?d?AY*RkAy>)&4^KaPDaBJBU~A@dnbE}@v8DR|YLe-JGX$BbI&Q)s^g zWf*}K;T3UNXx76N7yRIa40-pkFl;&Je2CN<+h-}*gn=#DorS&!`ls+7Lmn;d5HdEC zZT&04sRqgIw50BfCcAINv=H;+gIaG!KbCoH?TYP)!P3t6sT6#f2w#OuF(WMOyqZC< z^0Oj{n(ecd6peyhNz03Kj8zz^sRQ(4>Q};nc$Un0+XT# z7{S3bB9F2Qr%Sk_G5M24;%=Ds4SQuSkcNei1fslxYt2&yEq1~#eat%gV)2ifAbtaM&3`)RZ)+f1h& zKPQLOs%7(X1xA5>Gc7Km_|AE`4L4Sx?QXd4?@%vQ=gkq86@iF+$GkapdDrL75f)of z&d3b0(yD5!+$erXDG3~a-RpH)2?-1Dm`A@FwhF)awc2J&RJ5Tqc{z+F9{%PX^PHaA z+A8SzaM_`eBVW{SP576eBrzoYE(lA}&y$iy2`yY#Qdz4013o5L8Tz@6`0ENpOn9St z<*$aqX8@jrUoSRv&d5{9;R4q|1HO#I4ZCi@s}L}uXL&h&!`^rpJVP*kU)aEZ0s$&F zaa?$s)7i@D%;nudzwmu!ShTs}tH0R&QnQ`j3Cdc8FQ{4>CbpSqb6 z%V6-|&*9z#I1wiNm9usHJeCX212PhvK1fZM0WTc|INED7r}HW=;5!_iNWYE46X|~q z`G%|4btAxOb&vRw@^pT_mBiQ*mI6-gMV~&V%aAjjSthvjYaLE+YSA^3^CRU-EMCLz zf^ZGsCOA|*oK6ad&*S);IsPUNFEZ#P@Ppr(B1SK`Dp3A#^_>KKlBf52iRBr~bJmZ5 ze?O~NGW(D)p{DbCJ;>qoZD6{7Kz!i(&k^YS3~-XCFh^o|oQ&`!hi7v5OqPmMCY;Yi z{6-E>#Q*OR%B2a+aB}z|mw(-Fbbe?YpsRfZ{92B`iQ}))(FG5O_a@NUHv*j_Bfxuk zy|!{WT*c|XI}$$NB+mmJ-_W1yIGr92H|*Pa4o}3V52BJj^m63~-VI-k4_;P#tzXVzfJ_GZS*B>j@x`eMrRL!{x9w z0srn1%B|q#8o$SA=t&KS(>FfpGWfZZm76SNjUNi9L;WPT12^gLiIfS~-5lP_;f7zl zZUlZdi~!#VIO%iYe2LMe)kL};9RdHBBfx(*0{qW_ll-$1>iaya?>J%QQxYrBki&DR zmnmtSV9Y;4EL9MmAAvr-;Lq$EpHC%o{2nL<$xTRrKZJq^Zp_zc9g?nBN1*>c$2aC{ z^kZgpy*UE@QI2oSa}Z_MMO3j-t2 z{{k7QzQ+9PTO5Bh1T~yJxd?EQXYNA1-1#|rhARO#3CTilrVc;A<&e$s>(=UUT9TzJ zm*dl0!*roXu`8eB=hjFp{v#bM+zj||{LoJx4F~_$2=G-Sz}Jod_ly9)cLaFz2=Ei! zo_Jk)y>909`hde*IJ}F)9~yzq<0HV6(eBI+xOMugIGwQ^Ug*)`hCO_81Ui2JoZ7Jk zJ2rHgczgYV^I6L2WTETO_2&`jygUMY&j|4SBfz^yfInr_cZ0dln7n8oZSWC7Tzy<8YKoX@ckprxM!=T= zA8x+(Cc%>~oUh#nxR4}XFpv8$(yyco=SP3xaQela`0KmSPa!Geg85V}hbPY04x-$o zq%^@;<1lEw&fw|T7Lg1Pd%lTssog`3L*bht9|7pA={fM*UvXBXfS z$BBQ0M}Vh7;fKS&b_BR(1o*cBCq6UlbZQP>co~P+-J`<|dsxZg-tX)1bsWEz!wcu? z@FzLkW6q_hja`+z$Bo_a<4i-8%T)0_> zzt7?OIlSe19iGSG-5j3F{cS&oe+2jhXwZRQ>G&{%>^cqjmBYYI=oiDmM~?uX3OLd4 zPN2UUaFTxtx97ZAVI#-){zhUTgP+GZydeSJ4LH#$FWbNrQ@{v{m$w}6uz68WLsN`fcye;F!5<@RttrrqZ8QEzu~{6BI#aGsZY!hqka)4!I(Kj3gLw`%%Pdgo>21#ov@mipmxi z6{}0i$^cqkvZ&0eE?bUBh23diUFCAyon;1VE@2o@Sy_dnY<0C`Re5z;h1=nDm6dxM z1n^r|ZFk!%X61qGFc@VdCtWIKsF-uTpi8#GQ&Y2EaIE^C-R7Q^i@b5*GLrC+JTBWB zlr*!#UgN+HL0MUK)hb&Vwg8;&vYPU$TEKLA?4BpYC9}qgixWEKTy4J&bnLb3s+q+oM9%WH{Y zoutiCTT9{uro*>9e!ktlLfi?E>3Zc%Zd}W=-O^j1vQ2jEBf?o&r5G$)4^+<^ojWUo6 zkX4>apy)-SgSd!8y;=q|kujIuz7|Nx;_y(VV-yfAGmzH})>1FC%;s>~Sqq~>)j8^* zXRC#VimKIBZp2Xw6j!ync2$*|Dha);!~UnsRaLp3;+0N&LmdU`ZEi=+Di(0^P`TSt z1pswL2cfvuthO^Tl$CjSwMo8Chzh9?JzA4gPd5a}W~-^w^HMEZMPF@ZF#N32t&@cwPo=TLu_T-WE3s2 zkin=RrDKY2r_O^-!Lqt4yP$VL);$EWZaiLAY+brgww5hjym(pB^0MXfLTeF-s7qP% z)|Po(b`odmkDR3SddH>+G!{pXsjCXCZFrC5J&FoqUCZdQ;H?}zlXVk>xfMfbFlfMxr(xgf zfCX#naFw|!=w3s7qA6T%y)&1gf7Gq#29DWb-PW-nwHPw7u*+2^KrdZ(Hy}J=O}(w0 z6`)%%B-A+_t7~Z_t@Kn^$HfgQZ0I!9MklO;?6nCh!W4jP5wfCCgY$CmPkh+w)+52_ z0?<+0T36K%(7KjyEs;yqMMzAr*F=ZQwTxKf)-)z;0+LZiQl+QX<|>0a^74m_X~bt7 z07W|ukuZEiX?4@aDe&G8eQ>OXr-7QU?2ZzRhgTAVddivnnz`OJyqAoZPEj%q z8~xurXu5%^E!Ix;%Q(+L`*n0l>^^wIGSiStL@Yl4iX@4pui*L3L$GO0bm(;zqQt{> z9PH)!y*&Rd6Nchv4vh+5N1XC=bYbr#iDB%W#2&&wDnB1+@%fGODZM=Z<2sqx9nf8CEH2Cw7!H;-k}*p14Hzr2XVmv5}w8u^X+xRJ-Gw-J9JA-{2sX{E=&82U`i z|DXRLf7a0Kv3+C%{0ju)>u;QMYT)HRZ73$sAQ>6?^C>*3{<#ToBY$lI+>oE~`~%Xd z|0iA{UOv6b5q~A>Un>%aEC1ShJr|t^iocAg@jQe?qwmM#c^mXt3ttGi7}2fxGvsf` q^%!7=?jRVu3LnygAH^Vgz$n)Mzl*?d`LBIg$M_8EGVxbp{{I7a!lugr literal 0 HcmV?d00001 diff --git a/projects/schcom/schcom-demo.c b/projects/schcom/schcom-demo.c new file mode 100644 index 0000000..bde9dbb --- /dev/null +++ b/projects/schcom/schcom-demo.c @@ -0,0 +1,149 @@ +/* SPDX-License-Identifier: Apache-2.0 */ +/* + * A Schcom client, and the test for the compositor. + * + * Draws a flat rectangle of a known colour at a known position and commits it. + * Both of those are chosen so the result can be checked from outside the + * machine: `make schcom-shot` screendumps the framebuffer and a script on the + * host asserts the pixel at a given coordinate. That is the same oracle + * pattern the SchFS round-trip uses -- something with no connection to the code + * under test has to agree that it worked. + * + * schcom-demo [--colour 0xRRGGBB] [--at X Y] [--size W H] [--wait SECONDS] + */ + +#define _GNU_SOURCE +#include +#include +#include +#include +#include +#include +#include +#include + +#include "proto.h" + +static int +read_all(int fd, void *buf, size_t n) +{ + unsigned char *p = buf; + while (n) { + ssize_t r = read(fd, p, n); + if (r == 0) return -1; + if (r < 0) { if (errno == EINTR) continue; return -1; } + p += r; n -= (size_t)r; + } + return 0; +} + +int +main(int argc, char **argv) +{ + uint32_t colour = 0x00C04020; + int32_t at_x = 100, at_y = 80; + uint32_t w = 240, h = 160; + int wait_s = 3; + + for (int i = 1; i < argc; i++) { + if (!strcmp(argv[i], "--colour") && i + 1 < argc) + colour = (uint32_t)strtoul(argv[++i], NULL, 0); + else if (!strcmp(argv[i], "--at") && i + 2 < argc) { + at_x = atoi(argv[++i]); at_y = atoi(argv[++i]); + } else if (!strcmp(argv[i], "--size") && i + 2 < argc) { + w = (uint32_t)atoi(argv[++i]); h = (uint32_t)atoi(argv[++i]); + } else if (!strcmp(argv[i], "--wait") && i + 1 < argc) + wait_s = atoi(argv[++i]); + } + + int fd = socket(AF_UNIX, SOCK_STREAM, 0); + if (fd < 0) { perror("socket"); return 1; } + + struct sockaddr_un addr; + memset(&addr, 0, sizeof addr); + addr.sun_family = AF_UNIX; + strncpy(addr.sun_path, SCHCOM_SOCKET_PATH, sizeof addr.sun_path - 1); + if (connect(fd, (struct sockaddr *)&addr, sizeof addr) < 0) { + fprintf(stderr, "schcom-demo: connect %s: %s\n", + SCHCOM_SOCKET_PATH, strerror(errno)); + return 1; + } + + /* Handshake first: the compositor accepts nothing else before it. */ + struct schcom_hello hello; + memset(&hello, 0, sizeof hello); + hello.hdr.op = SCHCOM_OP_HELLO; + hello.hdr.length = sizeof hello; + hello.hdr.serial = 1; + hello.version = SCHCOM_VERSION; + if (write(fd, &hello, sizeof hello) != (ssize_t)sizeof hello) { + perror("write hello"); return 1; + } + + struct schcom_hello ack; + if (read_all(fd, &ack, sizeof ack) < 0 || ack.hdr.op != SCHCOM_OP_HELLO_ACK) { + fprintf(stderr, "schcom-demo: no hello ack\n"); + return 1; + } + printf("schcom-demo: connected, protocol v%u\n", ack.version); + + struct schcom_create_surface req; + memset(&req, 0, sizeof req); + req.hdr.op = SCHCOM_OP_CREATE_SURFACE; + req.hdr.length = sizeof req; + req.hdr.serial = 2; + req.width = w; req.height = h; + req.x = at_x; req.y = at_y; + if (write(fd, &req, sizeof req) != (ssize_t)sizeof req) { + perror("write create"); return 1; + } + + struct schcom_surface surf; + if (read_all(fd, &surf, sizeof surf) < 0) { + fprintf(stderr, "schcom-demo: no reply to create\n"); + return 1; + } + if (surf.hdr.op != SCHCOM_OP_SURFACE) { + fprintf(stderr, "schcom-demo: create refused (op %u)\n", surf.hdr.op); + return 1; + } + if (surf.handle_kind != SCHCOM_HANDLE_SHMID) { + fprintf(stderr, "schcom-demo: unexpected handle kind %u\n", surf.handle_kind); + return 1; + } + + void *pix = shmat((int)surf.handle, NULL, 0); + if (pix == (void *)-1) { perror("shmat"); return 1; } + + printf("schcom-demo: surface %u, %ux%u stride %u\n", + surf.hdr.surface, surf.width, surf.height, surf.stride); + + /* Draw: a solid block with a one-pixel border, so a test can tell "the + * buffer arrived" from "the buffer arrived at the wrong offset". */ + for (uint32_t y = 0; y < surf.height; y++) { + uint32_t *row = (uint32_t *)((unsigned char *)pix + (size_t)y * surf.stride); + for (uint32_t x = 0; x < surf.width; x++) { + int edge = (x == 0 || y == 0 || x == surf.width - 1 || y == surf.height - 1); + row[x] = edge ? 0x00FFFFFF : colour; + } + } + + struct schcom_commit commit; + memset(&commit, 0, sizeof commit); + commit.hdr.op = SCHCOM_OP_COMMIT; + commit.hdr.length = sizeof commit; + commit.hdr.serial = 3; + commit.hdr.surface = surf.hdr.surface; + commit.width = surf.width; commit.height = surf.height; + if (write(fd, &commit, sizeof commit) != (ssize_t)sizeof commit) { + perror("write commit"); return 1; + } + printf("schcom-demo: committed 0x%06X at %d,%d\n", colour, at_x, at_y); + fflush(stdout); + + /* Stay alive: the surface belongs to this connection, and the compositor + * drops it when the client goes. Exiting immediately would erase the very + * thing the screenshot is meant to catch. */ + sleep(wait_s); + return 0; +} diff --git a/projects/schcom/schcom.c b/projects/schcom/schcom.c new file mode 100644 index 0000000..38902d7 --- /dev/null +++ b/projects/schcom/schcom.c @@ -0,0 +1,605 @@ +/* SPDX-License-Identifier: Apache-2.0 */ +/* + * Schcom -- the SchOS compositor. + * + * Owns the display and the input devices. Clients draw into shared buffers and + * hand them over; Schcom decides what is on top of what, composites, and + * presents. It does not decide where windows go: that is SchWM's job, and the + * moment this file starts making placement decisions the split has failed. + * + * v0, deliberately small but not a toy: + * + * - real framebuffer output through /dev/fb0 and the fbdev ioctls + * - real clients over a Unix socket, with a versioned handshake + * - real shared-memory buffers, one per surface + * - a back buffer, so a half-composited frame never reaches the screen + * - input read from /dev/input/eventN and routed to the top surface + * + * What it does not do yet: damage tracking beyond "repaint everything", + * multiple outputs, subsurfaces, or any notion of focus beyond "topmost". + * Those are additions, not rewrites -- which is the point of committing to the + * surface/commit model now rather than growing into it. + */ + +#define _GNU_SOURCE +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include + +#include "proto.h" + +#define MAX_CLIENTS 16 +#define MAX_SURFACES 32 + +struct surface { + int used; + uint32_t id; + int client; /* index into clients[] */ + int shmid; + void *pixels; + uint32_t w, h, stride, size; + int32_t x, y; +}; + +struct client { + int fd; /* -1 when the slot is free */ + int hello_done; +}; + +static struct client clients[MAX_CLIENTS]; +static struct surface surfaces[MAX_SURFACES]; +static uint32_t next_surface_id = 1; + +/* The screen. */ +static uint8_t *fb; +static uint32_t fb_w, fb_h, fb_stride, fb_bpp; +static size_t fb_size; +static uint8_t *back; /* composited here, then copied out in one go */ + +/* Pointer position, moved by EV_REL from the mouse. */ +static int32_t ptr_x, ptr_y; + +static void +die(const char *what) +{ + fprintf(stderr, "schcom: %s: %s\n", what, strerror(errno)); + exit(1); +} + +/* ---------------------------------------------------------------- output */ + +static int +open_framebuffer(void) +{ + int fd = open("/dev/fb0", O_RDWR); + if (fd < 0) + die("open /dev/fb0"); + + struct fb_var_screeninfo var; + struct fb_fix_screeninfo fix; + if (ioctl(fd, FBIOGET_VSCREENINFO, &var) < 0) + die("FBIOGET_VSCREENINFO"); + if (ioctl(fd, FBIOGET_FSCREENINFO, &fix) < 0) + die("FBIOGET_FSCREENINFO"); + + fb_w = var.xres; + fb_h = var.yres; + fb_bpp = var.bits_per_pixel; + /* The stride comes from the driver, never from xres*bpp: the two differ on + * real hardware and assuming otherwise shears the image. */ + fb_stride = fix.line_length; + fb_size = (size_t)fb_stride * fb_h; + + if (fb_bpp != 32) { + fprintf(stderr, "schcom: need 32bpp, got %u\n", fb_bpp); + exit(1); + } + + fb = mmap(NULL, fb_size, PROT_READ | PROT_WRITE, MAP_SHARED, fd, 0); + if (fb == MAP_FAILED) + die("mmap /dev/fb0"); + + back = malloc(fb_size); + if (!back) + die("malloc back buffer"); + + printf("schcom: %ux%u, %u bpp, stride %u\n", fb_w, fb_h, fb_bpp, fb_stride); + fflush(stdout); + return fd; +} + +static void +composite(void) +{ + /* Desktop. A flat colour rather than black, so that "nothing was drawn" + * and "the compositor is not running" cannot look the same. */ + for (uint32_t y = 0; y < fb_h; y++) { + uint32_t *row = (uint32_t *)(back + (size_t)y * fb_stride); + for (uint32_t x = 0; x < fb_w; x++) + row[x] = 0x00203040; + } + + /* Surfaces, bottom to top. Creation order is stacking order in v0; SchWM + * will reorder later through a protocol request rather than by reaching in + * here. */ + for (int i = 0; i < MAX_SURFACES; i++) { + struct surface *s = &surfaces[i]; + if (!s->used || !s->pixels) + continue; + + for (uint32_t sy = 0; sy < s->h; sy++) { + int32_t dy = s->y + (int32_t)sy; + if (dy < 0 || dy >= (int32_t)fb_h) + continue; + + uint32_t *dst = (uint32_t *)(back + (size_t)dy * fb_stride); + uint32_t *src = (uint32_t *)((uint8_t *)s->pixels + (size_t)sy * s->stride); + + for (uint32_t sx = 0; sx < s->w; sx++) { + int32_t dx = s->x + (int32_t)sx; + if (dx < 0 || dx >= (int32_t)fb_w) + continue; + dst[dx] = src[sx]; + } + } + } + + /* A crude pointer, drawn last so it is never under a window. */ + for (int32_t py = 0; py < 10; py++) { + int32_t dy = ptr_y + py; + if (dy < 0 || dy >= (int32_t)fb_h) + continue; + uint32_t *dst = (uint32_t *)(back + (size_t)dy * fb_stride); + for (int32_t px = 0; px < 10 - py; px++) { + int32_t dx = ptr_x + px; + if (dx >= 0 && dx < (int32_t)fb_w) + dst[dx] = 0x00FFFFFF; + } + } + + /* One copy to the screen. Compositing straight into the framebuffer would + * show every intermediate state -- the flicker would be the whole desktop + * being repainted under the user's eyes. */ + memcpy(fb, back, fb_size); +} + +/* ---------------------------------------------------------------- clients */ + +static int +send_all(int fd, const void *buf, size_t n) +{ + const uint8_t *p = buf; + while (n) { + ssize_t w = write(fd, p, n); + if (w < 0) { + if (errno == EINTR) + continue; + return -1; + } + p += w; + n -= (size_t)w; + } + return 0; +} + +static int +read_all(int fd, void *buf, size_t n) +{ + uint8_t *p = buf; + while (n) { + ssize_t r = read(fd, p, n); + if (r == 0) + return -1; /* client went away */ + if (r < 0) { + if (errno == EINTR) + continue; + return -1; + } + p += r; + n -= (size_t)r; + } + return 0; +} + +static void +send_error(int fd, uint32_t serial, uint32_t code) +{ + struct schcom_error e; + memset(&e, 0, sizeof e); + e.hdr.op = SCHCOM_OP_ERROR; + e.hdr.length = sizeof e; + e.hdr.serial = serial; + e.code = code; + send_all(fd, &e, sizeof e); +} + +static void +drop_client(int ci) +{ + if (clients[ci].fd < 0) + return; + + for (int i = 0; i < MAX_SURFACES; i++) { + struct surface *s = &surfaces[i]; + if (s->used && s->client == ci) { + if (s->pixels) + shmdt(s->pixels); + /* IPC_RMID once, here: the segment goes when the last attach does, + * so a client that died mid-frame does not leak it. */ + shmctl(s->shmid, IPC_RMID, NULL); + memset(s, 0, sizeof *s); + } + } + + close(clients[ci].fd); + clients[ci].fd = -1; + clients[ci].hello_done = 0; + printf("schcom: client %d gone\n", ci); + fflush(stdout); +} + +static void +handle_create_surface(int ci, const struct schcom_create_surface *req) +{ + int fd = clients[ci].fd; + + int slot = -1; + for (int i = 0; i < MAX_SURFACES; i++) + if (!surfaces[i].used) { slot = i; break; } + if (slot < 0) { + send_error(fd, req->hdr.serial, ENOSPC); + return; + } + + uint32_t w = req->width, h = req->height; + if (w == 0 || h == 0 || w > fb_w || h > fb_h) { + send_error(fd, req->hdr.serial, EINVAL); + return; + } + + uint32_t stride = w * 4; + uint32_t size = stride * h; + + /* The compositor owns the segment, not the client: it has to survive the + * client crashing mid-frame, and it must not be something a client can + * quietly resize underneath us. */ + int shmid = shmget(IPC_PRIVATE, size, IPC_CREAT | 0600); + if (shmid < 0) { + send_error(fd, req->hdr.serial, errno); + return; + } + void *pix = shmat(shmid, NULL, 0); + if (pix == (void *)-1) { + shmctl(shmid, IPC_RMID, NULL); + send_error(fd, req->hdr.serial, errno); + return; + } + memset(pix, 0, size); + + struct surface *s = &surfaces[slot]; + s->used = 1; + s->id = next_surface_id++; + s->client = ci; + s->shmid = shmid; + s->pixels = pix; + s->w = w; + s->h = h; + s->stride = stride; + s->size = size; + s->x = req->x; + s->y = req->y; + + struct schcom_surface rep; + memset(&rep, 0, sizeof rep); + rep.hdr.op = SCHCOM_OP_SURFACE; + rep.hdr.length = sizeof rep; + rep.hdr.serial = req->hdr.serial; + rep.hdr.surface = s->id; + rep.handle_kind = SCHCOM_HANDLE_SHMID; + rep.handle = (uint32_t)shmid; + rep.width = w; + rep.height = h; + rep.stride = stride; + rep.size = size; + + if (send_all(fd, &rep, sizeof rep) < 0) { + drop_client(ci); + return; + } + printf("schcom: surface %u %ux%u at %d,%d for client %d (shm %d)\n", + s->id, w, h, s->x, s->y, ci, shmid); + fflush(stdout); +} + +static struct surface * +find_surface(uint32_t id) +{ + for (int i = 0; i < MAX_SURFACES; i++) + if (surfaces[i].used && surfaces[i].id == id) + return &surfaces[i]; + return NULL; +} + +/* Returns 1 if the screen needs repainting. */ +static int +handle_message(int ci) +{ + int fd = clients[ci].fd; + struct schcom_header hdr; + + if (read_all(fd, &hdr, sizeof hdr) < 0) { + drop_client(ci); + return 0; + } + if (hdr.length < sizeof hdr || hdr.length > 4096) { + send_error(fd, hdr.serial, EPROTO); + drop_client(ci); + return 0; + } + + uint8_t body[4096]; + memcpy(body, &hdr, sizeof hdr); + size_t rest = hdr.length - sizeof hdr; + if (rest && read_all(fd, body + sizeof hdr, rest) < 0) { + drop_client(ci); + return 0; + } + + if (!clients[ci].hello_done && hdr.op != SCHCOM_OP_HELLO) { + /* Nothing before the handshake. A client that gets this wrong is a + * client built against a protocol we do not speak. */ + send_error(fd, hdr.serial, EPROTO); + drop_client(ci); + return 0; + } + + switch (hdr.op) { + case SCHCOM_OP_HELLO: { + const struct schcom_hello *h = (const void *)body; + if (hdr.length < sizeof *h || h->version != SCHCOM_VERSION) { + send_error(fd, hdr.serial, EPROTONOSUPPORT); + drop_client(ci); + return 0; + } + struct schcom_hello ack; + memset(&ack, 0, sizeof ack); + ack.hdr.op = SCHCOM_OP_HELLO_ACK; + ack.hdr.length = sizeof ack; + ack.hdr.serial = hdr.serial; + ack.version = SCHCOM_VERSION; + if (send_all(fd, &ack, sizeof ack) < 0) { + drop_client(ci); + return 0; + } + clients[ci].hello_done = 1; + printf("schcom: client %d speaks v%u\n", ci, SCHCOM_VERSION); + fflush(stdout); + return 0; + } + + case SCHCOM_OP_CREATE_SURFACE: + if (hdr.length < sizeof(struct schcom_create_surface)) { + send_error(fd, hdr.serial, EINVAL); + return 0; + } + handle_create_surface(ci, (const void *)body); + return 1; + + case SCHCOM_OP_COMMIT: { + struct surface *s = find_surface(hdr.surface); + if (!s || s->client != ci) { + send_error(fd, hdr.serial, ENOENT); + return 0; + } + /* The commit is the whole point: the pixels were already there, but + * they were not allowed to be shown until now. */ + struct schcom_header fr; + memset(&fr, 0, sizeof fr); + fr.op = SCHCOM_OP_FRAME; + fr.length = sizeof fr; + fr.surface = s->id; + if (send_all(fd, &fr, sizeof fr) < 0) { + drop_client(ci); + return 1; + } + return 1; + } + + case SCHCOM_OP_DESTROY: { + struct surface *s = find_surface(hdr.surface); + if (s && s->client == ci) { + if (s->pixels) + shmdt(s->pixels); + shmctl(s->shmid, IPC_RMID, NULL); + memset(s, 0, sizeof *s); + return 1; + } + return 0; + } + + default: + /* Unknown but well-formed: skipped, not fatal. That is what the length + * field is for, and it is how a v0 compositor survives a v1 client. */ + return 0; + } +} + +/* ----------------------------------------------------------------- input */ + +/* Returns 1 if the screen needs repainting, -1 to quit. */ +static int +handle_input(int fd) +{ + struct input_event ev; + if (read(fd, &ev, sizeof ev) != (ssize_t)sizeof ev) + return 0; + + int repaint = 0; + + if (ev.type == EV_REL) { + if (ev.code == REL_X) { ptr_x += ev.value; repaint = 1; } + if (ev.code == REL_Y) { ptr_y += ev.value; repaint = 1; } + if (ptr_x < 0) ptr_x = 0; + if (ptr_y < 0) ptr_y = 0; + if (ptr_x >= (int32_t)fb_w) ptr_x = (int32_t)fb_w - 1; + if (ptr_y >= (int32_t)fb_h) ptr_y = (int32_t)fb_h - 1; + } + + if (ev.type == EV_KEY && ev.value == 1 && ev.code == KEY_ESC) + return -1; + + /* Route to the topmost surface. "Topmost" is the whole focus model in v0; + * anything cleverer is policy and belongs to SchWM. */ + struct surface *top = NULL; + for (int i = 0; i < MAX_SURFACES; i++) + if (surfaces[i].used) + top = &surfaces[i]; + + if (top && (ev.type == EV_KEY || ev.type == EV_REL)) { + struct schcom_input msg; + memset(&msg, 0, sizeof msg); + msg.hdr.op = SCHCOM_OP_INPUT; + msg.hdr.length = sizeof msg; + msg.hdr.surface = top->id; + msg.type = ev.type; + msg.code = ev.code; + msg.value = ev.value; + msg.x = ptr_x; + msg.y = ptr_y; + if (clients[top->client].fd >= 0) + send_all(clients[top->client].fd, &msg, sizeof msg); + } + + return repaint; +} + +/* ------------------------------------------------------------------ main */ + +int +main(int argc, char **argv) +{ + int frames_then_exit = 0; /* --frames N: for automated testing */ + + for (int i = 1; i < argc; i++) + if (!strcmp(argv[i], "--frames") && i + 1 < argc) + frames_then_exit = atoi(argv[++i]); + + for (int i = 0; i < MAX_CLIENTS; i++) + clients[i].fd = -1; + + open_framebuffer(); + ptr_x = (int32_t)fb_w / 2; + ptr_y = (int32_t)fb_h / 2; + + unlink(SCHCOM_SOCKET_PATH); + int lfd = socket(AF_UNIX, SOCK_STREAM, 0); + if (lfd < 0) + die("socket"); + + struct sockaddr_un addr; + memset(&addr, 0, sizeof addr); + addr.sun_family = AF_UNIX; + strncpy(addr.sun_path, SCHCOM_SOCKET_PATH, sizeof addr.sun_path - 1); + if (bind(lfd, (struct sockaddr *)&addr, sizeof addr) < 0) + die("bind " SCHCOM_SOCKET_PATH); + if (listen(lfd, 8) < 0) + die("listen"); + + int kbd = open("/dev/input/event0", O_RDONLY | O_NONBLOCK); + int mouse = open("/dev/input/event1", O_RDONLY | O_NONBLOCK); + + printf("schcom: listening on %s\n", SCHCOM_SOCKET_PATH); + fflush(stdout); + + composite(); + int frames = 1; + + for (;;) { + struct pollfd pfd[MAX_CLIENTS + 3]; + int n = 0; + + pfd[n].fd = lfd; pfd[n].events = POLLIN; n++; + int kbd_slot = -1, mouse_slot = -1; + if (kbd >= 0) { kbd_slot = n; pfd[n].fd = kbd; pfd[n].events = POLLIN; n++; } + if (mouse >= 0) { mouse_slot = n; pfd[n].fd = mouse; pfd[n].events = POLLIN; n++; } + + int first_client = n; + for (int i = 0; i < MAX_CLIENTS; i++) + if (clients[i].fd >= 0) { + pfd[n].fd = clients[i].fd; + pfd[n].events = POLLIN; + n++; + } + + if (poll(pfd, n, 100) < 0) { + if (errno == EINTR) + continue; + die("poll"); + } + + int repaint = 0; + + if (pfd[0].revents & POLLIN) { + int cfd = accept(lfd, NULL, NULL); + if (cfd >= 0) { + int slot = -1; + for (int i = 0; i < MAX_CLIENTS; i++) + if (clients[i].fd < 0) { slot = i; break; } + if (slot < 0) { + close(cfd); + } else { + clients[slot].fd = cfd; + clients[slot].hello_done = 0; + printf("schcom: client %d connected\n", slot); + fflush(stdout); + } + } + } + + if (kbd_slot >= 0 && (pfd[kbd_slot].revents & POLLIN)) { + int r = handle_input(kbd); + if (r < 0) break; + repaint |= r; + } + if (mouse_slot >= 0 && (pfd[mouse_slot].revents & POLLIN)) { + int r = handle_input(mouse); + if (r < 0) break; + repaint |= r; + } + + /* Walk the client slots in the same order they were added to pfd. */ + int k = first_client; + for (int i = 0; i < MAX_CLIENTS; i++) { + if (clients[i].fd < 0) + continue; + if (pfd[k].revents & (POLLIN | POLLHUP)) + repaint |= handle_message(i); + k++; + } + + if (repaint) { + composite(); + frames++; + if (frames_then_exit && frames >= frames_then_exit) { + printf("schcom: %d frames, exiting as asked\n", frames); + fflush(stdout); + break; + } + } + } + + unlink(SCHCOM_SOCKET_PATH); + return 0; +} diff --git a/tools/posix/schcom_test.sh b/tools/posix/schcom_test.sh new file mode 100644 index 0000000..4de3c29 --- /dev/null +++ b/tools/posix/schcom_test.sh @@ -0,0 +1,117 @@ +#!/bin/sh +# SPDX-License-Identifier: Apache-2.0 +# +# Run Schcom and a client inside SchOS, then check the actual pixels from the +# host with QEMU's screendump. The host has no connection to the compositor, so +# it is a real oracle: if the block is the right colour in the right place, the +# buffer really was shared, composited and presented. +# +# One display device on purpose (-vga std, no virtio-gpu): with two, screendump +# captures whichever QEMU considers active, which need not be the one /dev/fb0 +# maps. +set -e +BUILD=${BUILD:-build} +mkdir -p "$BUILD" + +LOG=$BUILD/schcom-test.log +PPM=${1:-$BUILD/schcom.ppm} +rm -f "$LOG" "$PPM" + +PORT=$(python3 - <<'EOF' +import socket +s=socket.socket(); s.bind(('127.0.0.1',0)); print(s.getsockname()[1]); s.close() +EOF +) + +( + sleep 26 + printf 'schcom --frames 8 &\n'; sleep 6 + printf 'schcom-demo --colour 0x00C04020 --at 100 80 --size 240 160 --wait 25\n'; sleep 14 + printf '\n' + sleep 40 +) | timeout -k 5 120 qemu-system-x86_64 \ + -machine pc-i440fx-9.2 -cpu qemu64,+rdtscp \ + -hda schos.img -hdb build/schfs.img -m 1G -smp 1 \ + -display none -vga std \ + -monitor tcp:127.0.0.1:$PORT,server,nowait \ + -chardev stdio,id=c0,logfile="$LOG" -serial chardev:c0 \ + >/dev/null 2>&1 & +QPID=$! + +# Wait until the client says it committed, then photograph. +for i in $(seq 1 60); do + grep -aq 'committed' "$LOG" 2>/dev/null && break + sleep 1 +done +sleep 2 + +python3 - "$PORT" "$PPM" <<'EOF' +import socket, sys, time +port, ppm = int(sys.argv[1]), sys.argv[2] +s = socket.create_connection(('127.0.0.1', port), timeout=10) +time.sleep(0.5) +s.sendall(b'screendump ' + ppm.encode() + b'\n') +time.sleep(2.0) +s.close() +EOF + +sleep 1 +kill -9 $QPID 2>/dev/null || true +wait 2>/dev/null || true + +echo "=== guest output ===" +sed 's/\x1b\[[0-9;=]*[A-Za-z]//g' "$LOG" | tr -d '\r' | grep -aE 'schcom|surface|committed|listening' | head -12 + +echo "=== pixel check (host oracle) ===" +python3 - "$PPM" <<'EOF' +import sys +path = sys.argv[1] +try: + data = open(path, 'rb').read() +except FileNotFoundError: + print("FAIL: no screendump produced"); sys.exit(1) + +# Binary PPM: P6, whitespace-separated width height maxval, then RGB triples. +def token(buf, i): + while buf[i:i+1].isspace(): i += 1 + j = i + while not buf[j:j+1].isspace(): j += 1 + return buf[i:j], j + +if data[:2] != b'P6': + print("FAIL: not a P6 PPM"); sys.exit(1) +i = 2 +w, i = token(data, i); h, i = token(data, i); mx, i = token(data, i) +w, h = int(w), int(h) +px = data[i+1:] +print(f" screendump {w}x{h}") + +def at(x, y): + o = (y*w + x)*3 + return px[o], px[o+1], px[o+2] + +def near(got, want, tol=8): + return all(abs(a-b) <= tol for a, b in zip(got, want)) + +fails = 0 +inside = at(150, 120) # middle of the 240x160 block at 100,80 +if near(inside, (0xC0, 0x40, 0x20)): + print(f" [ok] surface pixel at 150,120 is {inside} -- the client's colour") +else: + print(f" FAIL: 150,120 is {inside}, expected (192, 64, 32)"); fails += 1 + +desktop = at(20, 20) # compositor background 0x203040 +if near(desktop, (0x20, 0x30, 0x40)): + print(f" [ok] desktop pixel at 20,20 is {desktop} -- compositor background") +else: + print(f" FAIL: 20,20 is {desktop}, expected (32, 48, 64)"); fails += 1 + +border = at(100, 80) # top-left of the surface: white border +if near(border, (0xFF, 0xFF, 0xFF)): + print(f" [ok] border pixel at 100,80 is {border} -- surface landed exactly") +else: + print(f" FAIL: 100,80 is {border}, expected white border"); fails += 1 + +print("schcom end-to-end: PASSED" if not fails else f"schcom end-to-end: {fails} FAILED") +sys.exit(1 if fails else 0) +EOF