Introduces the headline feature of the kernel catalog: pulling a kernel
bundle over HTTP without any local build step.
Catalog format (internal/kernelcat/catalog.go):
- Catalog { Version, Entries } + CatEntry { Name, Distro, Arch,
KernelVersion, TarballURL, TarballSHA256, SizeBytes, Description }.
- catalog.json is embedded via go:embed and ships with each banger
binary. It starts empty (Phase 5's CI pipeline will populate it).
- Lookup(name) returns the matching entry or os.ErrNotExist.
Fetch (internal/kernelcat/fetch.go):
- HTTP GET with streaming SHA256 over the response body.
- zstd-decode (github.com/klauspost/compress/zstd) -> tar extract into
<kernelsDir>/<name>/.
- Hardens against path-traversal tarball entries (members whose
normalised path escapes the target dir, and unsafe symlink
targets) and sha256-mismatch downloads; any failure removes the
partially-populated target dir.
- Regular files, directories, and safe symlinks are supported; other
tar types (hardlinks, devices, fifos) are silently skipped.
- After extraction, recomputes sha256 over the on-disk vmlinux and
writes the manifest with Source="pull:<url>".
Daemon methods (internal/daemon/kernels.go):
- KernelPull(ctx, {Name, Force}) - lookup in embedded catalog, refuse
overwrite unless Force, delegate to kernelcat.Fetch.
- KernelCatalog(ctx) - return the embedded catalog annotated per-entry
with whether it has been pulled locally.
RPC: kernel.pull, kernel.catalog dispatch cases.
CLI:
- `banger kernel pull <name> [--force]`.
- `banger kernel list --available` prints the catalog with a
pulled/available STATE column and a human-readable size.
Tests: fetch round-trip (extract + manifest + sha256), sha256 mismatch
rejection with cleanup, missing-vmlinux rejection, path-traversal
rejection, HTTP error propagation, catalog parsing, lookup,
pulled-status reconciliation. All 20 packages green.
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
221 lines
7.1 KiB
Go
221 lines
7.1 KiB
Go
package daemon
|
|
|
|
import (
|
|
"context"
|
|
"errors"
|
|
"fmt"
|
|
"os"
|
|
"path/filepath"
|
|
"strings"
|
|
"time"
|
|
|
|
"banger/internal/api"
|
|
"banger/internal/kernelcat"
|
|
"banger/internal/system"
|
|
)
|
|
|
|
func (d *Daemon) KernelList(_ context.Context) (api.KernelListResult, error) {
|
|
entries, err := kernelcat.ListLocal(d.layout.KernelsDir)
|
|
if err != nil {
|
|
return api.KernelListResult{}, err
|
|
}
|
|
result := api.KernelListResult{Entries: make([]api.KernelEntry, 0, len(entries))}
|
|
for _, entry := range entries {
|
|
result.Entries = append(result.Entries, kernelEntryToAPI(entry))
|
|
}
|
|
return result, nil
|
|
}
|
|
|
|
func (d *Daemon) KernelShow(_ context.Context, name string) (api.KernelEntry, error) {
|
|
entry, err := kernelcat.ReadLocal(d.layout.KernelsDir, name)
|
|
if err != nil {
|
|
return api.KernelEntry{}, kernelNotFoundIfMissing(name, err)
|
|
}
|
|
return kernelEntryToAPI(entry), nil
|
|
}
|
|
|
|
func (d *Daemon) KernelDelete(_ context.Context, name string) error {
|
|
if err := kernelcat.ValidateName(name); err != nil {
|
|
return err
|
|
}
|
|
return kernelcat.DeleteLocal(d.layout.KernelsDir, name)
|
|
}
|
|
|
|
// KernelImport copies the kernel / initrd / modules artifacts produced by
|
|
// scripts/make-*-kernel.sh (under params.FromDir) into the local catalog
|
|
// under params.Name and writes the manifest. It is the primary bridge from
|
|
// "I built a kernel with the helper scripts" to "banger kernel list shows
|
|
// it and image register --kernel-ref works."
|
|
func (d *Daemon) KernelImport(ctx context.Context, params api.KernelImportParams) (api.KernelEntry, error) {
|
|
name := strings.TrimSpace(params.Name)
|
|
if err := kernelcat.ValidateName(name); err != nil {
|
|
return api.KernelEntry{}, err
|
|
}
|
|
fromDir := strings.TrimSpace(params.FromDir)
|
|
if fromDir == "" {
|
|
return api.KernelEntry{}, errors.New("--from <dir> is required")
|
|
}
|
|
|
|
discovered, err := kernelcat.DiscoverPaths(fromDir)
|
|
if err != nil {
|
|
return api.KernelEntry{}, fmt.Errorf("discover artifacts under %s: %w", fromDir, err)
|
|
}
|
|
|
|
targetDir := kernelcat.EntryDir(d.layout.KernelsDir, name)
|
|
// Overwrite-by-default: clear any prior entry so a re-import is clean.
|
|
if err := kernelcat.DeleteLocal(d.layout.KernelsDir, name); err != nil {
|
|
return api.KernelEntry{}, fmt.Errorf("clear prior catalog entry %q: %w", name, err)
|
|
}
|
|
if err := os.MkdirAll(targetDir, 0o755); err != nil {
|
|
return api.KernelEntry{}, err
|
|
}
|
|
|
|
kernelTarget := filepath.Join(targetDir, "vmlinux")
|
|
if err := system.CopyFilePreferClone(discovered.KernelPath, kernelTarget); err != nil {
|
|
return api.KernelEntry{}, fmt.Errorf("copy kernel: %w", err)
|
|
}
|
|
if discovered.InitrdPath != "" {
|
|
initrdTarget := filepath.Join(targetDir, "initrd.img")
|
|
if err := system.CopyFilePreferClone(discovered.InitrdPath, initrdTarget); err != nil {
|
|
return api.KernelEntry{}, fmt.Errorf("copy initrd: %w", err)
|
|
}
|
|
}
|
|
if discovered.ModulesDir != "" {
|
|
modulesTarget := filepath.Join(targetDir, "modules")
|
|
if err := os.MkdirAll(modulesTarget, 0o755); err != nil {
|
|
return api.KernelEntry{}, err
|
|
}
|
|
if err := system.CopyDirContents(ctx, d.runner, discovered.ModulesDir, modulesTarget, false); err != nil {
|
|
return api.KernelEntry{}, fmt.Errorf("copy modules: %w", err)
|
|
}
|
|
}
|
|
|
|
sum, err := kernelcat.SumFile(kernelTarget)
|
|
if err != nil {
|
|
return api.KernelEntry{}, fmt.Errorf("sha256 kernel: %w", err)
|
|
}
|
|
|
|
entry := kernelcat.Entry{
|
|
Name: name,
|
|
Distro: strings.TrimSpace(params.Distro),
|
|
Arch: strings.TrimSpace(params.Arch),
|
|
KernelVersion: inferKernelVersion(discovered.KernelPath, discovered.ModulesDir),
|
|
SHA256: sum,
|
|
Source: "import:" + fromDir,
|
|
ImportedAt: time.Now().UTC(),
|
|
}
|
|
if err := kernelcat.WriteLocal(d.layout.KernelsDir, entry); err != nil {
|
|
return api.KernelEntry{}, fmt.Errorf("write manifest: %w", err)
|
|
}
|
|
stored, err := kernelcat.ReadLocal(d.layout.KernelsDir, name)
|
|
if err != nil {
|
|
return api.KernelEntry{}, err
|
|
}
|
|
return kernelEntryToAPI(stored), nil
|
|
}
|
|
|
|
// KernelPull downloads a catalog entry by name into the local catalog. It
|
|
// refuses to overwrite an existing entry unless params.Force is set.
|
|
func (d *Daemon) KernelPull(ctx context.Context, params api.KernelPullParams) (api.KernelEntry, error) {
|
|
name := strings.TrimSpace(params.Name)
|
|
if err := kernelcat.ValidateName(name); err != nil {
|
|
return api.KernelEntry{}, err
|
|
}
|
|
|
|
if !params.Force {
|
|
if _, err := kernelcat.ReadLocal(d.layout.KernelsDir, name); err == nil {
|
|
return api.KernelEntry{}, fmt.Errorf("kernel %q already pulled; pass --force to re-pull", name)
|
|
} else if !os.IsNotExist(err) {
|
|
return api.KernelEntry{}, err
|
|
}
|
|
}
|
|
|
|
catalog, err := kernelcat.LoadEmbedded()
|
|
if err != nil {
|
|
return api.KernelEntry{}, err
|
|
}
|
|
catEntry, err := catalog.Lookup(name)
|
|
if err != nil {
|
|
return api.KernelEntry{}, fmt.Errorf("kernel %q not in catalog (run 'banger kernel list --available' to browse)", name)
|
|
}
|
|
|
|
stored, err := kernelcat.Fetch(ctx, nil, d.layout.KernelsDir, catEntry)
|
|
if err != nil {
|
|
return api.KernelEntry{}, err
|
|
}
|
|
return kernelEntryToAPI(stored), nil
|
|
}
|
|
|
|
// KernelCatalog returns every entry from the embedded catalog annotated
|
|
// with whether it has already been pulled locally.
|
|
func (d *Daemon) KernelCatalog(_ context.Context) (api.KernelCatalogResult, error) {
|
|
catalog, err := kernelcat.LoadEmbedded()
|
|
if err != nil {
|
|
return api.KernelCatalogResult{}, err
|
|
}
|
|
local, _ := kernelcat.ListLocal(d.layout.KernelsDir)
|
|
pulled := make(map[string]bool, len(local))
|
|
for _, entry := range local {
|
|
pulled[entry.Name] = true
|
|
}
|
|
result := api.KernelCatalogResult{Entries: make([]api.KernelCatalogEntry, 0, len(catalog.Entries))}
|
|
for _, entry := range catalog.Entries {
|
|
result.Entries = append(result.Entries, api.KernelCatalogEntry{
|
|
Name: entry.Name,
|
|
Distro: entry.Distro,
|
|
Arch: entry.Arch,
|
|
KernelVersion: entry.KernelVersion,
|
|
SizeBytes: entry.SizeBytes,
|
|
Description: entry.Description,
|
|
Pulled: pulled[entry.Name],
|
|
})
|
|
}
|
|
return result, nil
|
|
}
|
|
|
|
// inferKernelVersion makes a best-effort guess at the kernel version from
|
|
// the source filename (e.g. "vmlinux-6.12.79_1") or falls back to the
|
|
// modules directory basename. Returns "" if nothing looks useful.
|
|
func inferKernelVersion(kernelPath, modulesDir string) string {
|
|
if modulesDir != "" {
|
|
if base := filepath.Base(modulesDir); base != "." && base != string(filepath.Separator) {
|
|
return base
|
|
}
|
|
}
|
|
base := filepath.Base(kernelPath)
|
|
for _, prefix := range []string{"vmlinux-", "vmlinuz-"} {
|
|
if strings.HasPrefix(base, prefix) {
|
|
return strings.TrimPrefix(base, prefix)
|
|
}
|
|
}
|
|
return ""
|
|
}
|
|
|
|
func kernelEntryToAPI(entry kernelcat.Entry) api.KernelEntry {
|
|
importedAt := ""
|
|
if !entry.ImportedAt.IsZero() {
|
|
importedAt = entry.ImportedAt.UTC().Format(time.RFC3339)
|
|
}
|
|
return api.KernelEntry{
|
|
Name: entry.Name,
|
|
Distro: entry.Distro,
|
|
Arch: entry.Arch,
|
|
KernelVersion: entry.KernelVersion,
|
|
SHA256: entry.SHA256,
|
|
Source: entry.Source,
|
|
ImportedAt: importedAt,
|
|
KernelPath: entry.KernelPath,
|
|
InitrdPath: entry.InitrdPath,
|
|
ModulesDir: entry.ModulesDir,
|
|
}
|
|
}
|
|
|
|
func kernelNotFoundIfMissing(name string, err error) error {
|
|
if err == nil {
|
|
return nil
|
|
}
|
|
if os.IsNotExist(err) {
|
|
return fmt.Errorf("kernel %q not found", name)
|
|
}
|
|
return err
|
|
}
|