kerf-multikernel 0.3.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.3.0 → kerf_multikernel-0.4.0}/PKG-INFO +17 -3
- {kerf_multikernel-0.3.0 → kerf_multikernel-0.4.0}/README.md +15 -2
- kerf_multikernel-0.4.0/build.py +21 -0
- {kerf_multikernel-0.3.0 → kerf_multikernel-0.4.0}/pyproject.toml +11 -2
- 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.3.0 → kerf_multikernel-0.4.0}/src/kerf/__init__.py +1 -3
- {kerf_multikernel-0.3.0 → kerf_multikernel-0.4.0}/src/kerf/cli.py +5 -1
- {kerf_multikernel-0.3.0 → kerf_multikernel-0.4.0}/src/kerf/console/main.py +1 -1
- {kerf_multikernel-0.3.0 → kerf_multikernel-0.4.0}/src/kerf/create/main.py +5 -70
- {kerf_multikernel-0.3.0 → kerf_multikernel-0.4.0}/src/kerf/dtc/overlay.py +44 -23
- {kerf_multikernel-0.3.0 → kerf_multikernel-0.4.0}/src/kerf/dtc/parser.py +5 -4
- 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.3.0 → kerf_multikernel-0.4.0}/src/kerf/load/main.py +36 -6
- {kerf_multikernel-0.3.0 → kerf_multikernel-0.4.0}/src/kerf/resources.py +85 -52
- 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.3.0/src/kerf/exec → kerf_multikernel-0.4.0/src/kerf/start}/__init__.py +3 -3
- {kerf_multikernel-0.3.0/src/kerf/exec → kerf_multikernel-0.4.0/src/kerf/start}/main.py +6 -6
- {kerf_multikernel-0.3.0 → kerf_multikernel-0.4.0}/src/kerf/update/main.py +44 -56
- kerf_multikernel-0.3.0/src/kerf/data/kerf-init +0 -0
- {kerf_multikernel-0.3.0 → kerf_multikernel-0.4.0}/LICENSE +0 -0
- {kerf_multikernel-0.3.0 → kerf_multikernel-0.4.0}/src/kerf/baseline.py +0 -0
- {kerf_multikernel-0.3.0 → kerf_multikernel-0.4.0}/src/kerf/console/__init__.py +0 -0
- {kerf_multikernel-0.3.0 → kerf_multikernel-0.4.0}/src/kerf/create/__init__.py +0 -0
- {kerf_multikernel-0.3.0 → kerf_multikernel-0.4.0}/src/kerf/data/__init__.py +0 -0
- {kerf_multikernel-0.3.0 → kerf_multikernel-0.4.0}/src/kerf/daxfs/__init__.py +0 -0
- {kerf_multikernel-0.3.0 → kerf_multikernel-0.4.0}/src/kerf/daxfs/mkdaxfs.py +0 -0
- {kerf_multikernel-0.3.0 → kerf_multikernel-0.4.0}/src/kerf/delete/__init__.py +0 -0
- {kerf_multikernel-0.3.0 → kerf_multikernel-0.4.0}/src/kerf/delete/main.py +0 -0
- {kerf_multikernel-0.3.0 → kerf_multikernel-0.4.0}/src/kerf/devices.py +0 -0
- {kerf_multikernel-0.3.0 → kerf_multikernel-0.4.0}/src/kerf/docker/__init__.py +0 -0
- {kerf_multikernel-0.3.0 → kerf_multikernel-0.4.0}/src/kerf/docker/image.py +0 -0
- {kerf_multikernel-0.3.0 → kerf_multikernel-0.4.0}/src/kerf/dtc/__init__.py +0 -0
- {kerf_multikernel-0.3.0 → kerf_multikernel-0.4.0}/src/kerf/dtc/cells.py +0 -0
- {kerf_multikernel-0.3.0 → kerf_multikernel-0.4.0}/src/kerf/dtc/extractor.py +0 -0
- {kerf_multikernel-0.3.0 → kerf_multikernel-0.4.0}/src/kerf/dtc/reporter.py +0 -0
- {kerf_multikernel-0.3.0 → kerf_multikernel-0.4.0}/src/kerf/dtc/validator.py +0 -0
- {kerf_multikernel-0.3.0 → kerf_multikernel-0.4.0}/src/kerf/dump/__init__.py +0 -0
- {kerf_multikernel-0.3.0 → kerf_multikernel-0.4.0}/src/kerf/dump/main.py +0 -0
- {kerf_multikernel-0.3.0 → kerf_multikernel-0.4.0}/src/kerf/exceptions.py +0 -0
- {kerf_multikernel-0.3.0 → kerf_multikernel-0.4.0}/src/kerf/init/__init__.py +0 -0
- {kerf_multikernel-0.3.0 → kerf_multikernel-0.4.0}/src/kerf/init/main.py +0 -0
- {kerf_multikernel-0.3.0 → kerf_multikernel-0.4.0}/src/kerf/kill/__init__.py +0 -0
- {kerf_multikernel-0.3.0 → kerf_multikernel-0.4.0}/src/kerf/kill/main.py +0 -0
- {kerf_multikernel-0.3.0 → kerf_multikernel-0.4.0}/src/kerf/load/__init__.py +0 -0
- {kerf_multikernel-0.3.0 → kerf_multikernel-0.4.0}/src/kerf/metadata.py +0 -0
- {kerf_multikernel-0.3.0 → kerf_multikernel-0.4.0}/src/kerf/models.py +0 -0
- {kerf_multikernel-0.3.0 → kerf_multikernel-0.4.0}/src/kerf/pool_diff.py +0 -0
- {kerf_multikernel-0.3.0 → kerf_multikernel-0.4.0}/src/kerf/runtime.py +0 -0
- {kerf_multikernel-0.3.0 → kerf_multikernel-0.4.0}/src/kerf/show/__init__.py +0 -0
- {kerf_multikernel-0.3.0 → kerf_multikernel-0.4.0}/src/kerf/show/main.py +0 -0
- {kerf_multikernel-0.3.0 → kerf_multikernel-0.4.0}/src/kerf/topology.py +0 -0
- {kerf_multikernel-0.3.0 → kerf_multikernel-0.4.0}/src/kerf/unload/__init__.py +0 -0
- {kerf_multikernel-0.3.0 → kerf_multikernel-0.4.0}/src/kerf/unload/main.py +0 -0
- {kerf_multikernel-0.3.0 → kerf_multikernel-0.4.0}/src/kerf/update/__init__.py +0 -0
- {kerf_multikernel-0.3.0 → kerf_multikernel-0.4.0}/src/kerf/utils.py +0 -0
- {kerf_multikernel-0.3.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,6 +11,7 @@ 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)
|
|
@@ -167,8 +168,18 @@ kerf create database --cpu-count=8 --memory=16GB
|
|
|
167
168
|
kerf load --kernel=/boot/vmlinuz --initrd=/boot/initrd.img \
|
|
168
169
|
--cmdline="root=/dev/sda1 ro" --id=1
|
|
169
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
|
+
|
|
170
176
|
# Boot a kernel instance
|
|
171
|
-
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
|
|
172
183
|
|
|
173
184
|
# Show kernel instance information
|
|
174
185
|
kerf show
|
|
@@ -323,6 +334,7 @@ The kernel exposes a filesystem interface (mounted at `/sys/fs/multikernel/`) th
|
|
|
323
334
|
[tool.poetry.dependencies]
|
|
324
335
|
python = "^3.8"
|
|
325
336
|
pylibfdt = "^1.7.0" # Device tree parsing (from dtc project)
|
|
337
|
+
cryptography = ">=3.1" # Signing spawn kernels (kerf sign)
|
|
326
338
|
```
|
|
327
339
|
|
|
328
340
|
### Installation
|
|
@@ -335,7 +347,9 @@ pip install kerf-multikernel
|
|
|
335
347
|
# Or isolated with pipx, avoiding conflicts with other packages
|
|
336
348
|
pipx install kerf-multikernel
|
|
337
349
|
|
|
338
|
-
# 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.
|
|
339
353
|
git clone https://github.com/multikernel/kerf.git
|
|
340
354
|
cd kerf
|
|
341
355
|
# Installs 'kerf' command to ~/.local/bin/kerf
|
|
@@ -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,21 +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"
|
|
30
|
+
cryptography = ">=3.1"
|
|
22
31
|
|
|
23
32
|
[tool.poetry.group.dev.dependencies]
|
|
24
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
|
|
@@ -0,0 +1,510 @@
|
|
|
1
|
+
/*
|
|
2
|
+
* Copyright 2026 Multikernel Technologies, Inc.
|
|
3
|
+
*
|
|
4
|
+
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
5
|
+
* you may not use this file except in compliance with the License.
|
|
6
|
+
* You may obtain a copy of the License at
|
|
7
|
+
*
|
|
8
|
+
* http://www.apache.org/licenses/LICENSE-2.0
|
|
9
|
+
*
|
|
10
|
+
* Unless required by applicable law or agreed to in writing, software
|
|
11
|
+
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
12
|
+
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
13
|
+
* See the License for the specific language governing permissions and
|
|
14
|
+
* limitations under the License.
|
|
15
|
+
*
|
|
16
|
+
* Minimal init process for spawn kernel.
|
|
17
|
+
*
|
|
18
|
+
*/
|
|
19
|
+
|
|
20
|
+
#define _GNU_SOURCE
|
|
21
|
+
#include <errno.h>
|
|
22
|
+
#include <fcntl.h>
|
|
23
|
+
#include <poll.h>
|
|
24
|
+
#include <signal.h>
|
|
25
|
+
#include <stdio.h>
|
|
26
|
+
#include <stdlib.h>
|
|
27
|
+
#include <string.h>
|
|
28
|
+
#include <sys/ioctl.h>
|
|
29
|
+
#include <sys/mount.h>
|
|
30
|
+
#include <sys/signalfd.h>
|
|
31
|
+
#include <sys/socket.h>
|
|
32
|
+
#include <sys/stat.h>
|
|
33
|
+
#include <sys/wait.h>
|
|
34
|
+
#include <termios.h>
|
|
35
|
+
#include <unistd.h>
|
|
36
|
+
|
|
37
|
+
#include "proto.h"
|
|
38
|
+
#include "session.h"
|
|
39
|
+
|
|
40
|
+
#define CMDLINE_PATH "/proc/cmdline"
|
|
41
|
+
#define ENTRYPOINT_KEY "kerf.entrypoint="
|
|
42
|
+
#define CONSOLE_KEY "console="
|
|
43
|
+
#define MAX_CMDLINE_LEN 4096
|
|
44
|
+
#define MAX_ENTRYPOINT_LEN 4096
|
|
45
|
+
#define MAX_CONSOLE_LEN 64
|
|
46
|
+
#define MAX_ARGS 64
|
|
47
|
+
|
|
48
|
+
static pid_t child_pid = -1;
|
|
49
|
+
static char console_device[MAX_CONSOLE_LEN];
|
|
50
|
+
|
|
51
|
+
static void log_msg(const char *msg)
|
|
52
|
+
{
|
|
53
|
+
int fd = open("/dev/kmsg", O_WRONLY);
|
|
54
|
+
if (fd >= 0) {
|
|
55
|
+
write(fd, "kerf-init: ", 11);
|
|
56
|
+
write(fd, msg, strlen(msg));
|
|
57
|
+
write(fd, "\n", 1);
|
|
58
|
+
close(fd);
|
|
59
|
+
}
|
|
60
|
+
}
|
|
61
|
+
|
|
62
|
+
static void log_error(const char *msg)
|
|
63
|
+
{
|
|
64
|
+
char buf[256];
|
|
65
|
+
snprintf(buf, sizeof(buf), "ERROR: %s: %s", msg, strerror(errno));
|
|
66
|
+
log_msg(buf);
|
|
67
|
+
}
|
|
68
|
+
|
|
69
|
+
static int do_mount(const char *source, const char *target,
|
|
70
|
+
const char *fstype, unsigned long flags)
|
|
71
|
+
{
|
|
72
|
+
if (mount(source, target, fstype, flags, NULL) < 0) {
|
|
73
|
+
if (errno != EBUSY) {
|
|
74
|
+
log_error(target);
|
|
75
|
+
return -1;
|
|
76
|
+
}
|
|
77
|
+
}
|
|
78
|
+
return 0;
|
|
79
|
+
}
|
|
80
|
+
|
|
81
|
+
static int do_mkdir(const char *path, mode_t mode)
|
|
82
|
+
{
|
|
83
|
+
if (mkdir(path, mode) < 0) {
|
|
84
|
+
if (errno != EEXIST) {
|
|
85
|
+
log_error(path);
|
|
86
|
+
return -1;
|
|
87
|
+
}
|
|
88
|
+
}
|
|
89
|
+
return 0;
|
|
90
|
+
}
|
|
91
|
+
|
|
92
|
+
static int mount_filesystems(void)
|
|
93
|
+
{
|
|
94
|
+
if (do_mount("proc", "/proc", "proc", MS_NOSUID | MS_NODEV | MS_NOEXEC) < 0)
|
|
95
|
+
return -1;
|
|
96
|
+
|
|
97
|
+
if (do_mount("sysfs", "/sys", "sysfs", MS_NOSUID | MS_NODEV | MS_NOEXEC) < 0)
|
|
98
|
+
return -1;
|
|
99
|
+
|
|
100
|
+
/* Mount devtmpfs to populate /dev with kernel device nodes */
|
|
101
|
+
if (do_mount("devtmpfs", "/dev", "devtmpfs", MS_NOSUID) < 0)
|
|
102
|
+
return -1;
|
|
103
|
+
|
|
104
|
+
if (do_mkdir("/dev/pts", 0755) < 0)
|
|
105
|
+
return -1;
|
|
106
|
+
|
|
107
|
+
if (do_mount("devpts", "/dev/pts", "devpts", MS_NOSUID | MS_NOEXEC) < 0)
|
|
108
|
+
return -1;
|
|
109
|
+
|
|
110
|
+
return 0;
|
|
111
|
+
}
|
|
112
|
+
|
|
113
|
+
static int read_entrypoint(char *buf, size_t bufsize)
|
|
114
|
+
{
|
|
115
|
+
char cmdline[MAX_CMDLINE_LEN];
|
|
116
|
+
int fd = open(CMDLINE_PATH, O_RDONLY);
|
|
117
|
+
if (fd < 0) {
|
|
118
|
+
log_error("open " CMDLINE_PATH);
|
|
119
|
+
return -1;
|
|
120
|
+
}
|
|
121
|
+
|
|
122
|
+
ssize_t n = read(fd, cmdline, sizeof(cmdline) - 1);
|
|
123
|
+
close(fd);
|
|
124
|
+
|
|
125
|
+
if (n < 0) {
|
|
126
|
+
log_error("read " CMDLINE_PATH);
|
|
127
|
+
return -1;
|
|
128
|
+
}
|
|
129
|
+
|
|
130
|
+
cmdline[n] = '\0';
|
|
131
|
+
|
|
132
|
+
/* Find kerf.entrypoint= in cmdline */
|
|
133
|
+
char *start = strstr(cmdline, ENTRYPOINT_KEY);
|
|
134
|
+
if (!start) {
|
|
135
|
+
log_msg("kerf.entrypoint= not found in cmdline");
|
|
136
|
+
return -1;
|
|
137
|
+
}
|
|
138
|
+
|
|
139
|
+
start += strlen(ENTRYPOINT_KEY);
|
|
140
|
+
|
|
141
|
+
char *end;
|
|
142
|
+
if (*start == '"') {
|
|
143
|
+
/* Quoted value: find closing quote */
|
|
144
|
+
start++; /* Skip opening quote */
|
|
145
|
+
end = strchr(start, '"');
|
|
146
|
+
if (!end) {
|
|
147
|
+
log_msg("unterminated quote in kerf.entrypoint");
|
|
148
|
+
return -1;
|
|
149
|
+
}
|
|
150
|
+
} else {
|
|
151
|
+
/* Unquoted value: find space or end of string */
|
|
152
|
+
end = start;
|
|
153
|
+
while (*end && *end != ' ' && *end != '\n')
|
|
154
|
+
end++;
|
|
155
|
+
}
|
|
156
|
+
|
|
157
|
+
size_t len = end - start;
|
|
158
|
+
if (len == 0) {
|
|
159
|
+
log_msg("empty kerf.entrypoint value");
|
|
160
|
+
return -1;
|
|
161
|
+
}
|
|
162
|
+
|
|
163
|
+
if (len >= bufsize) {
|
|
164
|
+
log_msg("kerf.entrypoint value too long");
|
|
165
|
+
return -1;
|
|
166
|
+
}
|
|
167
|
+
|
|
168
|
+
memcpy(buf, start, len);
|
|
169
|
+
buf[len] = '\0';
|
|
170
|
+
|
|
171
|
+
return 0;
|
|
172
|
+
}
|
|
173
|
+
|
|
174
|
+
static int read_console(char *buf, size_t bufsize)
|
|
175
|
+
{
|
|
176
|
+
char cmdline[MAX_CMDLINE_LEN];
|
|
177
|
+
int fd = open(CMDLINE_PATH, O_RDONLY);
|
|
178
|
+
if (fd < 0)
|
|
179
|
+
return -1;
|
|
180
|
+
|
|
181
|
+
ssize_t n = read(fd, cmdline, sizeof(cmdline) - 1);
|
|
182
|
+
close(fd);
|
|
183
|
+
|
|
184
|
+
if (n < 0)
|
|
185
|
+
return -1;
|
|
186
|
+
|
|
187
|
+
cmdline[n] = '\0';
|
|
188
|
+
|
|
189
|
+
/* Find console= in cmdline */
|
|
190
|
+
char *start = strstr(cmdline, CONSOLE_KEY);
|
|
191
|
+
if (!start)
|
|
192
|
+
return -1;
|
|
193
|
+
|
|
194
|
+
start += strlen(CONSOLE_KEY);
|
|
195
|
+
|
|
196
|
+
/* Find the end of the value (space, comma, or end of string) */
|
|
197
|
+
char *end = start;
|
|
198
|
+
while (*end && *end != ' ' && *end != ',' && *end != '\n')
|
|
199
|
+
end++;
|
|
200
|
+
|
|
201
|
+
size_t len = end - start;
|
|
202
|
+
if (len == 0 || len >= bufsize)
|
|
203
|
+
return -1;
|
|
204
|
+
|
|
205
|
+
/* Build /dev/<console> path */
|
|
206
|
+
if (len + 5 >= bufsize) /* "/dev/" is 5 chars */
|
|
207
|
+
return -1;
|
|
208
|
+
|
|
209
|
+
snprintf(buf, bufsize, "/dev/%.*s", (int)len, start);
|
|
210
|
+
|
|
211
|
+
return 0;
|
|
212
|
+
}
|
|
213
|
+
|
|
214
|
+
static void setup_console(const char *tty)
|
|
215
|
+
{
|
|
216
|
+
int fd;
|
|
217
|
+
struct termios term;
|
|
218
|
+
|
|
219
|
+
/* Create new session (detach from current terminal) */
|
|
220
|
+
setsid();
|
|
221
|
+
|
|
222
|
+
/* Open the TTY */
|
|
223
|
+
fd = open(tty, O_RDWR | O_NOCTTY);
|
|
224
|
+
if (fd < 0) {
|
|
225
|
+
log_error(tty);
|
|
226
|
+
return;
|
|
227
|
+
}
|
|
228
|
+
|
|
229
|
+
/* Make it the controlling terminal */
|
|
230
|
+
ioctl(fd, TIOCSCTTY, 1);
|
|
231
|
+
|
|
232
|
+
/* Set up termios */
|
|
233
|
+
if (tcgetattr(fd, &term) == 0) {
|
|
234
|
+
term.c_iflag = ICRNL | IXON;
|
|
235
|
+
term.c_oflag = OPOST | ONLCR;
|
|
236
|
+
term.c_cflag = B115200 | CS8 | CREAD | HUPCL | CLOCAL;
|
|
237
|
+
term.c_lflag = ISIG | ICANON | ECHO | ECHOE | ECHOK;
|
|
238
|
+
tcsetattr(fd, TCSANOW, &term);
|
|
239
|
+
}
|
|
240
|
+
|
|
241
|
+
/* Redirect stdin/stdout/stderr */
|
|
242
|
+
dup2(fd, STDIN_FILENO);
|
|
243
|
+
dup2(fd, STDOUT_FILENO);
|
|
244
|
+
dup2(fd, STDERR_FILENO);
|
|
245
|
+
if (fd > STDERR_FILENO)
|
|
246
|
+
close(fd);
|
|
247
|
+
}
|
|
248
|
+
|
|
249
|
+
static int parse_args(char *cmdline, char **argv, int max_args)
|
|
250
|
+
{
|
|
251
|
+
int argc = 0;
|
|
252
|
+
char *p = cmdline;
|
|
253
|
+
int in_quote = 0;
|
|
254
|
+
char quote_char = 0;
|
|
255
|
+
|
|
256
|
+
while (*p && argc < max_args - 1) {
|
|
257
|
+
/* Skip whitespace */
|
|
258
|
+
while (*p == ' ' || *p == '\t')
|
|
259
|
+
p++;
|
|
260
|
+
|
|
261
|
+
if (*p == '\0')
|
|
262
|
+
break;
|
|
263
|
+
|
|
264
|
+
argv[argc++] = p;
|
|
265
|
+
|
|
266
|
+
/* Find end of argument */
|
|
267
|
+
while (*p) {
|
|
268
|
+
if (!in_quote) {
|
|
269
|
+
if (*p == '"' || *p == '\'') {
|
|
270
|
+
in_quote = 1;
|
|
271
|
+
quote_char = *p;
|
|
272
|
+
memmove(p, p + 1, strlen(p));
|
|
273
|
+
continue;
|
|
274
|
+
}
|
|
275
|
+
if (*p == ' ' || *p == '\t') {
|
|
276
|
+
*p++ = '\0';
|
|
277
|
+
break;
|
|
278
|
+
}
|
|
279
|
+
} else {
|
|
280
|
+
if (*p == quote_char) {
|
|
281
|
+
in_quote = 0;
|
|
282
|
+
memmove(p, p + 1, strlen(p));
|
|
283
|
+
continue;
|
|
284
|
+
}
|
|
285
|
+
}
|
|
286
|
+
p++;
|
|
287
|
+
}
|
|
288
|
+
}
|
|
289
|
+
|
|
290
|
+
argv[argc] = NULL;
|
|
291
|
+
return argc;
|
|
292
|
+
}
|
|
293
|
+
|
|
294
|
+
/* musl ships no <linux/vm_sockets.h>; these mirror the kernel uapi. */
|
|
295
|
+
#define SO_VM_SOCKETS_TRANSPORT 9
|
|
296
|
+
#define VSOCK_TRANSPORT_MULTIKERNEL 1
|
|
297
|
+
#define VMADDR_CID_ANY 0xffffffffU
|
|
298
|
+
#define HOST_CID 0
|
|
299
|
+
|
|
300
|
+
struct sockaddr_vm {
|
|
301
|
+
sa_family_t svm_family;
|
|
302
|
+
unsigned short svm_reserved1;
|
|
303
|
+
unsigned int svm_port;
|
|
304
|
+
unsigned int svm_cid;
|
|
305
|
+
unsigned char svm_flags;
|
|
306
|
+
unsigned char svm_zero[3];
|
|
307
|
+
};
|
|
308
|
+
|
|
309
|
+
static int setup_signalfd(void)
|
|
310
|
+
{
|
|
311
|
+
sigset_t mask;
|
|
312
|
+
|
|
313
|
+
sigemptyset(&mask);
|
|
314
|
+
sigaddset(&mask, SIGCHLD);
|
|
315
|
+
sigaddset(&mask, SIGTERM);
|
|
316
|
+
sigaddset(&mask, SIGINT);
|
|
317
|
+
sigaddset(&mask, SIGHUP);
|
|
318
|
+
sigprocmask(SIG_BLOCK, &mask, NULL);
|
|
319
|
+
return signalfd(-1, &mask, SFD_CLOEXEC | SFD_NONBLOCK);
|
|
320
|
+
}
|
|
321
|
+
|
|
322
|
+
static void reap_children(void)
|
|
323
|
+
{
|
|
324
|
+
int status;
|
|
325
|
+
pid_t pid;
|
|
326
|
+
|
|
327
|
+
while ((pid = waitpid(-1, &status, WNOHANG)) > 0) {
|
|
328
|
+
if (pid == child_pid) {
|
|
329
|
+
char msg[64];
|
|
330
|
+
int code = WIFSIGNALED(status) ? 128 + WTERMSIG(status) : WEXITSTATUS(status);
|
|
331
|
+
|
|
332
|
+
snprintf(msg, sizeof(msg), "child exited with status %d", code);
|
|
333
|
+
log_msg(msg);
|
|
334
|
+
child_pid = -1;
|
|
335
|
+
}
|
|
336
|
+
}
|
|
337
|
+
}
|
|
338
|
+
|
|
339
|
+
static void handle_signals(int sfd)
|
|
340
|
+
{
|
|
341
|
+
struct signalfd_siginfo si;
|
|
342
|
+
|
|
343
|
+
while (read(sfd, &si, sizeof(si)) == sizeof(si)) {
|
|
344
|
+
if (si.ssi_signo == SIGCHLD)
|
|
345
|
+
reap_children();
|
|
346
|
+
else if (child_pid > 0)
|
|
347
|
+
kill(child_pid, si.ssi_signo);
|
|
348
|
+
}
|
|
349
|
+
}
|
|
350
|
+
|
|
351
|
+
static int open_listener(void)
|
|
352
|
+
{
|
|
353
|
+
struct sockaddr_vm addr = {
|
|
354
|
+
.svm_family = AF_VSOCK,
|
|
355
|
+
.svm_port = KERF_AGENT_PORT,
|
|
356
|
+
.svm_cid = VMADDR_CID_ANY,
|
|
357
|
+
};
|
|
358
|
+
int transport = VSOCK_TRANSPORT_MULTIKERNEL;
|
|
359
|
+
int fd = socket(AF_VSOCK, SOCK_STREAM | SOCK_CLOEXEC | SOCK_NONBLOCK, 0);
|
|
360
|
+
|
|
361
|
+
if (fd < 0) {
|
|
362
|
+
log_error("exec listener socket");
|
|
363
|
+
return -1;
|
|
364
|
+
}
|
|
365
|
+
if (setsockopt(fd, AF_VSOCK, SO_VM_SOCKETS_TRANSPORT, &transport, sizeof(transport)) < 0 ||
|
|
366
|
+
bind(fd, (struct sockaddr *)&addr, sizeof(addr)) < 0 ||
|
|
367
|
+
listen(fd, 16) < 0) {
|
|
368
|
+
log_error("exec listener");
|
|
369
|
+
close(fd);
|
|
370
|
+
return -1;
|
|
371
|
+
}
|
|
372
|
+
return fd;
|
|
373
|
+
}
|
|
374
|
+
|
|
375
|
+
static void accept_session(int lfd, int sfd)
|
|
376
|
+
{
|
|
377
|
+
struct sockaddr_vm peer;
|
|
378
|
+
socklen_t len = sizeof(peer);
|
|
379
|
+
int fd = accept4(lfd, (struct sockaddr *)&peer, &len, SOCK_CLOEXEC);
|
|
380
|
+
pid_t pid;
|
|
381
|
+
|
|
382
|
+
if (fd < 0)
|
|
383
|
+
return;
|
|
384
|
+
|
|
385
|
+
/* Ports up to 1023 need CAP_NET_BIND_SERVICE, so this admits host root only. */
|
|
386
|
+
if (peer.svm_cid != HOST_CID || peer.svm_port > KERF_AGENT_PORT) {
|
|
387
|
+
char msg[96];
|
|
388
|
+
|
|
389
|
+
snprintf(msg, sizeof(msg), "rejected exec from cid %u port %u",
|
|
390
|
+
peer.svm_cid, peer.svm_port);
|
|
391
|
+
log_msg(msg);
|
|
392
|
+
close(fd);
|
|
393
|
+
return;
|
|
394
|
+
}
|
|
395
|
+
|
|
396
|
+
pid = fork();
|
|
397
|
+
if (pid == 0) {
|
|
398
|
+
close(lfd);
|
|
399
|
+
close(sfd);
|
|
400
|
+
session_run(fd);
|
|
401
|
+
}
|
|
402
|
+
if (pid < 0)
|
|
403
|
+
log_error("fork exec session");
|
|
404
|
+
close(fd);
|
|
405
|
+
}
|
|
406
|
+
|
|
407
|
+
/* Pipes and sockets must not land on 0-2 if the kernel gave PID 1 no console. */
|
|
408
|
+
static void ensure_std_fds(void)
|
|
409
|
+
{
|
|
410
|
+
int fd;
|
|
411
|
+
|
|
412
|
+
do {
|
|
413
|
+
fd = open("/dev/null", O_RDWR);
|
|
414
|
+
} while (fd >= 0 && fd <= STDERR_FILENO);
|
|
415
|
+
if (fd > STDERR_FILENO)
|
|
416
|
+
close(fd);
|
|
417
|
+
}
|
|
418
|
+
|
|
419
|
+
int main(int argc, char *argv[])
|
|
420
|
+
{
|
|
421
|
+
(void)argc;
|
|
422
|
+
(void)argv;
|
|
423
|
+
|
|
424
|
+
char entrypoint[MAX_ENTRYPOINT_LEN];
|
|
425
|
+
char *ep_argv[MAX_ARGS];
|
|
426
|
+
|
|
427
|
+
if (mount_filesystems() < 0) {
|
|
428
|
+
log_msg("failed to mount filesystems");
|
|
429
|
+
return 1;
|
|
430
|
+
}
|
|
431
|
+
|
|
432
|
+
ensure_std_fds();
|
|
433
|
+
|
|
434
|
+
if (read_entrypoint(entrypoint, sizeof(entrypoint)) < 0) {
|
|
435
|
+
log_msg("failed to read entrypoint");
|
|
436
|
+
return 1;
|
|
437
|
+
}
|
|
438
|
+
|
|
439
|
+
{
|
|
440
|
+
char msg[256];
|
|
441
|
+
snprintf(msg, sizeof(msg), "entrypoint: '%.200s'", entrypoint);
|
|
442
|
+
log_msg(msg);
|
|
443
|
+
}
|
|
444
|
+
|
|
445
|
+
/* Read console device (optional) */
|
|
446
|
+
if (read_console(console_device, sizeof(console_device)) == 0) {
|
|
447
|
+
char msg[128];
|
|
448
|
+
snprintf(msg, sizeof(msg), "console: %s", console_device);
|
|
449
|
+
log_msg(msg);
|
|
450
|
+
} else {
|
|
451
|
+
console_device[0] = '\0';
|
|
452
|
+
}
|
|
453
|
+
|
|
454
|
+
int ep_argc = parse_args(entrypoint, ep_argv, MAX_ARGS);
|
|
455
|
+
if (ep_argc == 0) {
|
|
456
|
+
log_msg("no entrypoint arguments");
|
|
457
|
+
return 1;
|
|
458
|
+
}
|
|
459
|
+
|
|
460
|
+
{
|
|
461
|
+
char msg[512];
|
|
462
|
+
int off = snprintf(msg, sizeof(msg), "executing:");
|
|
463
|
+
for (int i = 0; i < ep_argc && off < (int)sizeof(msg) - 1; i++)
|
|
464
|
+
off += snprintf(msg + off, sizeof(msg) - off, " %s", ep_argv[i]);
|
|
465
|
+
log_msg(msg);
|
|
466
|
+
}
|
|
467
|
+
|
|
468
|
+
int sfd = setup_signalfd();
|
|
469
|
+
if (sfd < 0) {
|
|
470
|
+
log_error("signalfd");
|
|
471
|
+
return 1;
|
|
472
|
+
}
|
|
473
|
+
|
|
474
|
+
child_pid = fork();
|
|
475
|
+
if (child_pid < 0) {
|
|
476
|
+
log_error("fork");
|
|
477
|
+
return 1;
|
|
478
|
+
}
|
|
479
|
+
|
|
480
|
+
if (child_pid == 0) {
|
|
481
|
+
sigset_t none;
|
|
482
|
+
|
|
483
|
+
sigemptyset(&none);
|
|
484
|
+
sigprocmask(SIG_SETMASK, &none, NULL);
|
|
485
|
+
close(sfd);
|
|
486
|
+
if (console_device[0] != '\0')
|
|
487
|
+
setup_console(console_device);
|
|
488
|
+
|
|
489
|
+
execv(ep_argv[0], ep_argv);
|
|
490
|
+
log_error("execv");
|
|
491
|
+
_exit(127);
|
|
492
|
+
}
|
|
493
|
+
|
|
494
|
+
int lfd = open_listener();
|
|
495
|
+
|
|
496
|
+
/* PID 1 must never exit or the kernel will panic. */
|
|
497
|
+
for (;;) {
|
|
498
|
+
struct pollfd pfd[2] = {
|
|
499
|
+
{ .fd = sfd, .events = POLLIN },
|
|
500
|
+
{ .fd = lfd, .events = POLLIN },
|
|
501
|
+
};
|
|
502
|
+
|
|
503
|
+
if (poll(pfd, 2, -1) < 0)
|
|
504
|
+
continue;
|
|
505
|
+
if (pfd[0].revents)
|
|
506
|
+
handle_signals(sfd);
|
|
507
|
+
if (pfd[1].revents)
|
|
508
|
+
accept_session(lfd, sfd);
|
|
509
|
+
}
|
|
510
|
+
}
|