kerf-multikernel 0.2.0__tar.gz → 0.4.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (68) hide show
  1. kerf_multikernel-0.4.0/Makefile +15 -0
  2. {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/PKG-INFO +18 -5
  3. {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/README.md +16 -3
  4. kerf_multikernel-0.4.0/build.py +21 -0
  5. {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/pyproject.toml +11 -3
  6. kerf_multikernel-0.4.0/src/init/Makefile +19 -0
  7. kerf_multikernel-0.4.0/src/init/init.c +510 -0
  8. kerf_multikernel-0.4.0/src/init/proto.h +75 -0
  9. kerf_multikernel-0.4.0/src/init/session.c +618 -0
  10. kerf_multikernel-0.4.0/src/init/session.h +23 -0
  11. kerf_multikernel-0.4.0/src/init/session_test.c +24 -0
  12. {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/src/kerf/__init__.py +1 -3
  13. {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/src/kerf/cli.py +5 -1
  14. {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/src/kerf/console/main.py +1 -1
  15. {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/src/kerf/create/main.py +21 -83
  16. kerf_multikernel-0.4.0/src/kerf/devices.py +87 -0
  17. {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/src/kerf/dtc/extractor.py +12 -0
  18. {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/src/kerf/dtc/overlay.py +73 -33
  19. {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/src/kerf/dtc/parser.py +93 -19
  20. {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/src/kerf/dtc/validator.py +3 -2
  21. kerf_multikernel-0.4.0/src/kerf/exec/__init__.py +17 -0
  22. kerf_multikernel-0.4.0/src/kerf/exec/client.py +131 -0
  23. kerf_multikernel-0.4.0/src/kerf/exec/main.py +210 -0
  24. kerf_multikernel-0.4.0/src/kerf/exec/protocol.py +139 -0
  25. kerf_multikernel-0.4.0/src/kerf/exec/user.py +85 -0
  26. {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/src/kerf/init/main.py +109 -47
  27. {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/src/kerf/kill/main.py +8 -1
  28. {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/src/kerf/load/main.py +36 -6
  29. {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/src/kerf/models.py +18 -1
  30. {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/src/kerf/pool_diff.py +17 -4
  31. {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/src/kerf/resources.py +85 -52
  32. {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/src/kerf/runtime.py +28 -1
  33. {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/src/kerf/show/main.py +2 -0
  34. kerf_multikernel-0.4.0/src/kerf/sign/__init__.py +21 -0
  35. kerf_multikernel-0.4.0/src/kerf/sign/main.py +77 -0
  36. kerf_multikernel-0.4.0/src/kerf/signature.py +221 -0
  37. {kerf_multikernel-0.2.0/src/kerf/exec → kerf_multikernel-0.4.0/src/kerf/start}/__init__.py +3 -3
  38. {kerf_multikernel-0.2.0/src/kerf/exec → kerf_multikernel-0.4.0/src/kerf/start}/main.py +6 -9
  39. {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/src/kerf/update/main.py +85 -150
  40. kerf_multikernel-0.2.0/src/kerf/data/kerf-init +0 -0
  41. {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/LICENSE +0 -0
  42. {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/src/kerf/baseline.py +0 -0
  43. {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/src/kerf/console/__init__.py +0 -0
  44. {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/src/kerf/create/__init__.py +0 -0
  45. {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/src/kerf/data/__init__.py +0 -0
  46. {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/src/kerf/daxfs/__init__.py +0 -0
  47. {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/src/kerf/daxfs/mkdaxfs.py +0 -0
  48. {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/src/kerf/delete/__init__.py +0 -0
  49. {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/src/kerf/delete/main.py +0 -0
  50. {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/src/kerf/docker/__init__.py +0 -0
  51. {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/src/kerf/docker/image.py +0 -0
  52. {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/src/kerf/dtc/__init__.py +0 -0
  53. {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/src/kerf/dtc/cells.py +0 -0
  54. {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/src/kerf/dtc/reporter.py +0 -0
  55. {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/src/kerf/dump/__init__.py +0 -0
  56. {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/src/kerf/dump/main.py +0 -0
  57. {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/src/kerf/exceptions.py +0 -0
  58. {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/src/kerf/init/__init__.py +0 -0
  59. {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/src/kerf/kill/__init__.py +0 -0
  60. {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/src/kerf/load/__init__.py +0 -0
  61. {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/src/kerf/metadata.py +0 -0
  62. {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/src/kerf/show/__init__.py +0 -0
  63. {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/src/kerf/topology.py +0 -0
  64. {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/src/kerf/unload/__init__.py +0 -0
  65. {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/src/kerf/unload/main.py +0 -0
  66. {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/src/kerf/update/__init__.py +0 -0
  67. {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/src/kerf/utils.py +0 -0
  68. {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/src/kerf/vmlinuz.py +0 -0
@@ -0,0 +1,15 @@
1
+ # Top-level Makefile for kerf
2
+ # Builds the C init binary and copies it to package data
3
+
4
+ all: init
5
+
6
+ init:
7
+ $(MAKE) -C src/init
8
+ mkdir -p src/kerf/data
9
+ cp src/init/kerf-init src/kerf/data/
10
+
11
+ clean:
12
+ $(MAKE) -C src/init clean
13
+ rm -f src/kerf/data/kerf-init
14
+
15
+ .PHONY: all init clean
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.1
2
2
  Name: kerf-multikernel
3
- Version: 0.2.0
3
+ Version: 0.4.0
4
4
  Summary: Multikernel Management CLI tool
5
5
  Author: Cong Wang
6
6
  Requires-Python: >=3.9,<4.0
@@ -11,10 +11,10 @@ Classifier: Programming Language :: Python :: 3.11
11
11
  Classifier: Programming Language :: Python :: 3.12
12
12
  Classifier: Programming Language :: Python :: 3.13
13
13
  Requires-Dist: click (>=8.0.0,<9.0.0)
14
+ Requires-Dist: cryptography (>=3.1)
14
15
  Requires-Dist: pylibfdt (>=1.7.0,<2.0.0)
15
16
  Requires-Dist: pyudev (>=0.24.0,<0.25.0)
16
17
  Requires-Dist: pyyaml (>=6.0,<7.0)
17
- Requires-Dist: rdtsc (>=0.2.1,<0.3.0)
18
18
  Description-Content-Type: text/markdown
19
19
 
20
20
  ![Kerf Logo](logo.png)
@@ -151,7 +151,7 @@ Baseline DTB (static)
151
151
  kerf init --cpus=4-7 --memory=2GB
152
152
 
153
153
  # Initialize with CPUs, per-node memory and devices
154
- kerf init --cpus=4-31 --memory=8GB@0,8GB@1 --devices=enp9s0_dev,nvme0
154
+ kerf init --cpus=4-31 --memory=8GB@0,8GB@1 --devices=nvme0n1,enp9s0
155
155
 
156
156
  # Re-run to reshape the live pool; "none" asks for none of a resource
157
157
  kerf init --cpus=4-15 --memory=4GB
@@ -168,8 +168,18 @@ kerf create database --cpu-count=8 --memory=16GB
168
168
  kerf load --kernel=/boot/vmlinuz --initrd=/boot/initrd.img \
169
169
  --cmdline="root=/dev/sda1 ro" --id=1
170
170
 
171
+ # Sign a spawn kernel where the signing key is kept, not on the host;
172
+ # the host kernel must trust the certificate, for example as a MOK
173
+ kerf sign /boot/vmlinuz -o vmlinux.signed --key signing_key.pem --cert signing_cert.pem
174
+ kerf load --kernel=vmlinux.signed --id=1
175
+
171
176
  # Boot a kernel instance
172
- kerf exec web-server
177
+ kerf start web-server
178
+
179
+ # Run a command inside a running instance (docker exec style)
180
+ kerf exec web-server ls /
181
+ kerf exec -it web-server sh
182
+ kerf exec -u nobody web-server id
173
183
 
174
184
  # Show kernel instance information
175
185
  kerf show
@@ -324,6 +334,7 @@ The kernel exposes a filesystem interface (mounted at `/sys/fs/multikernel/`) th
324
334
  [tool.poetry.dependencies]
325
335
  python = "^3.8"
326
336
  pylibfdt = "^1.7.0" # Device tree parsing (from dtc project)
337
+ cryptography = ">=3.1" # Signing spawn kernels (kerf sign)
327
338
  ```
328
339
 
329
340
  ### Installation
@@ -336,7 +347,9 @@ pip install kerf-multikernel
336
347
  # Or isolated with pipx, avoiding conflicts with other packages
337
348
  pipx install kerf-multikernel
338
349
 
339
- # From source (recommended for development)
350
+ # From source (recommended for development). Installing builds the
351
+ # static kerf-init with musl-gcc (e.g. apt install musl-tools), so
352
+ # rerunning pip install after a pull also picks up kerf-init changes.
340
353
  git clone https://github.com/multikernel/kerf.git
341
354
  cd kerf
342
355
  # Installs 'kerf' command to ~/.local/bin/kerf
@@ -132,7 +132,7 @@ Baseline DTB (static)
132
132
  kerf init --cpus=4-7 --memory=2GB
133
133
 
134
134
  # Initialize with CPUs, per-node memory and devices
135
- kerf init --cpus=4-31 --memory=8GB@0,8GB@1 --devices=enp9s0_dev,nvme0
135
+ kerf init --cpus=4-31 --memory=8GB@0,8GB@1 --devices=nvme0n1,enp9s0
136
136
 
137
137
  # Re-run to reshape the live pool; "none" asks for none of a resource
138
138
  kerf init --cpus=4-15 --memory=4GB
@@ -149,8 +149,18 @@ kerf create database --cpu-count=8 --memory=16GB
149
149
  kerf load --kernel=/boot/vmlinuz --initrd=/boot/initrd.img \
150
150
  --cmdline="root=/dev/sda1 ro" --id=1
151
151
 
152
+ # Sign a spawn kernel where the signing key is kept, not on the host;
153
+ # the host kernel must trust the certificate, for example as a MOK
154
+ kerf sign /boot/vmlinuz -o vmlinux.signed --key signing_key.pem --cert signing_cert.pem
155
+ kerf load --kernel=vmlinux.signed --id=1
156
+
152
157
  # Boot a kernel instance
153
- kerf exec web-server
158
+ kerf start web-server
159
+
160
+ # Run a command inside a running instance (docker exec style)
161
+ kerf exec web-server ls /
162
+ kerf exec -it web-server sh
163
+ kerf exec -u nobody web-server id
154
164
 
155
165
  # Show kernel instance information
156
166
  kerf show
@@ -305,6 +315,7 @@ The kernel exposes a filesystem interface (mounted at `/sys/fs/multikernel/`) th
305
315
  [tool.poetry.dependencies]
306
316
  python = "^3.8"
307
317
  pylibfdt = "^1.7.0" # Device tree parsing (from dtc project)
318
+ cryptography = ">=3.1" # Signing spawn kernels (kerf sign)
308
319
  ```
309
320
 
310
321
  ### Installation
@@ -317,7 +328,9 @@ pip install kerf-multikernel
317
328
  # Or isolated with pipx, avoiding conflicts with other packages
318
329
  pipx install kerf-multikernel
319
330
 
320
- # From source (recommended for development)
331
+ # From source (recommended for development). Installing builds the
332
+ # static kerf-init with musl-gcc (e.g. apt install musl-tools), so
333
+ # rerunning pip install after a pull also picks up kerf-init changes.
321
334
  git clone https://github.com/multikernel/kerf.git
322
335
  cd kerf
323
336
  # Installs 'kerf' command to ~/.local/bin/kerf
@@ -0,0 +1,21 @@
1
+ # Copyright 2026 Multikernel Technologies, Inc.
2
+ #
3
+ # Licensed under the Apache License, Version 2.0 (the "License");
4
+ # you may not use this file except in compliance with the License.
5
+ # You may obtain a copy of the License at
6
+ #
7
+ # http://www.apache.org/licenses/LICENSE-2.0
8
+ #
9
+ # Unless required by applicable law or agreed to in writing, software
10
+ # distributed under the License is distributed on an "AS IS" BASIS,
11
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12
+ # See the License for the specific language governing permissions and
13
+ # limitations under the License.
14
+
15
+ """
16
+ Poetry build script: rebuild kerf-init so a wheel never ships a stale one.
17
+ """
18
+
19
+ import subprocess
20
+
21
+ subprocess.run(["make", "init"], check=True)
@@ -4,22 +4,30 @@ build-backend = "poetry.core.masonry.api"
4
4
 
5
5
  [tool.poetry]
6
6
  name = "kerf-multikernel"
7
- version = "0.2.0"
7
+ version = "0.4.0"
8
8
  description = "Multikernel Management CLI tool"
9
9
  authors = ["Cong Wang"]
10
10
  readme = "README.md"
11
11
  packages = [{include = "kerf", from = "src"}]
12
12
  include = [
13
- { path = "src/kerf/data/kerf-init", format = ["sdist", "wheel"] },
13
+ { path = "src/kerf/data/kerf-init", format = ["wheel"] },
14
+ { path = "Makefile", format = ["sdist"] },
15
+ { path = "src/init/Makefile", format = ["sdist"] },
16
+ { path = "src/init/*.c", format = ["sdist"] },
17
+ { path = "src/init/*.h", format = ["sdist"] },
14
18
  ]
15
19
 
20
+ [tool.poetry.build]
21
+ script = "build.py"
22
+ generate-setup-file = false
23
+
16
24
  [tool.poetry.dependencies]
17
25
  python = "^3.9"
18
26
  pylibfdt = "^1.7.0"
19
27
  click = "^8.0.0"
20
28
  pyyaml = "^6.0"
21
29
  pyudev = "^0.24.0"
22
- rdtsc = "^0.2.1"
30
+ cryptography = ">=3.1"
23
31
 
24
32
  [tool.poetry.group.dev.dependencies]
25
33
  pytest = "^7.0.0"
@@ -0,0 +1,19 @@
1
+ # Makefile for kerf-init
2
+ # Builds statically-linked binaries using musl-gcc
3
+
4
+ CC = musl-gcc
5
+ CFLAGS = -Wall -Wextra -Werror -O2 -static
6
+
7
+ all: kerf-init session-test
8
+
9
+ kerf-init: init.c session.c session.h proto.h
10
+ $(CC) $(CFLAGS) -o $@ init.c session.c
11
+
12
+ # Runs one exec session on fd 0 for tests/test_exec_session.py; not shipped.
13
+ session-test: session_test.c session.c session.h proto.h
14
+ $(CC) $(CFLAGS) -o $@ session_test.c session.c
15
+
16
+ clean:
17
+ rm -f kerf-init session-test
18
+
19
+ .PHONY: all clean