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.
- kerf_multikernel-0.4.0/Makefile +15 -0
- {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/PKG-INFO +18 -5
- {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/README.md +16 -3
- kerf_multikernel-0.4.0/build.py +21 -0
- {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/pyproject.toml +11 -3
- kerf_multikernel-0.4.0/src/init/Makefile +19 -0
- kerf_multikernel-0.4.0/src/init/init.c +510 -0
- kerf_multikernel-0.4.0/src/init/proto.h +75 -0
- kerf_multikernel-0.4.0/src/init/session.c +618 -0
- kerf_multikernel-0.4.0/src/init/session.h +23 -0
- kerf_multikernel-0.4.0/src/init/session_test.c +24 -0
- {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/src/kerf/__init__.py +1 -3
- {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/src/kerf/cli.py +5 -1
- {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/src/kerf/console/main.py +1 -1
- {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/src/kerf/create/main.py +21 -83
- kerf_multikernel-0.4.0/src/kerf/devices.py +87 -0
- {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/src/kerf/dtc/extractor.py +12 -0
- {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/src/kerf/dtc/overlay.py +73 -33
- {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/src/kerf/dtc/parser.py +93 -19
- {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/src/kerf/dtc/validator.py +3 -2
- kerf_multikernel-0.4.0/src/kerf/exec/__init__.py +17 -0
- kerf_multikernel-0.4.0/src/kerf/exec/client.py +131 -0
- kerf_multikernel-0.4.0/src/kerf/exec/main.py +210 -0
- kerf_multikernel-0.4.0/src/kerf/exec/protocol.py +139 -0
- kerf_multikernel-0.4.0/src/kerf/exec/user.py +85 -0
- {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/src/kerf/init/main.py +109 -47
- {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/src/kerf/kill/main.py +8 -1
- {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/src/kerf/load/main.py +36 -6
- {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/src/kerf/models.py +18 -1
- {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/src/kerf/pool_diff.py +17 -4
- {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/src/kerf/resources.py +85 -52
- {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/src/kerf/runtime.py +28 -1
- {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/src/kerf/show/main.py +2 -0
- kerf_multikernel-0.4.0/src/kerf/sign/__init__.py +21 -0
- kerf_multikernel-0.4.0/src/kerf/sign/main.py +77 -0
- kerf_multikernel-0.4.0/src/kerf/signature.py +221 -0
- {kerf_multikernel-0.2.0/src/kerf/exec → kerf_multikernel-0.4.0/src/kerf/start}/__init__.py +3 -3
- {kerf_multikernel-0.2.0/src/kerf/exec → kerf_multikernel-0.4.0/src/kerf/start}/main.py +6 -9
- {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/src/kerf/update/main.py +85 -150
- kerf_multikernel-0.2.0/src/kerf/data/kerf-init +0 -0
- {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/LICENSE +0 -0
- {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/src/kerf/baseline.py +0 -0
- {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/src/kerf/console/__init__.py +0 -0
- {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/src/kerf/create/__init__.py +0 -0
- {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/src/kerf/data/__init__.py +0 -0
- {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/src/kerf/daxfs/__init__.py +0 -0
- {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/src/kerf/daxfs/mkdaxfs.py +0 -0
- {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/src/kerf/delete/__init__.py +0 -0
- {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/src/kerf/delete/main.py +0 -0
- {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/src/kerf/docker/__init__.py +0 -0
- {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/src/kerf/docker/image.py +0 -0
- {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/src/kerf/dtc/__init__.py +0 -0
- {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/src/kerf/dtc/cells.py +0 -0
- {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/src/kerf/dtc/reporter.py +0 -0
- {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/src/kerf/dump/__init__.py +0 -0
- {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/src/kerf/dump/main.py +0 -0
- {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/src/kerf/exceptions.py +0 -0
- {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/src/kerf/init/__init__.py +0 -0
- {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/src/kerf/kill/__init__.py +0 -0
- {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/src/kerf/load/__init__.py +0 -0
- {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/src/kerf/metadata.py +0 -0
- {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/src/kerf/show/__init__.py +0 -0
- {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/src/kerf/topology.py +0 -0
- {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/src/kerf/unload/__init__.py +0 -0
- {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/src/kerf/unload/main.py +0 -0
- {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/src/kerf/update/__init__.py +0 -0
- {kerf_multikernel-0.2.0 → kerf_multikernel-0.4.0}/src/kerf/utils.py +0 -0
- {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.
|
|
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
|

|
|
@@ -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=
|
|
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
|
|
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=
|
|
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
|
|
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.
|
|
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 = ["
|
|
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
|
-
|
|
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
|