From f10cd386fd85386303253287d3e0c5e2a7d52124 Mon Sep 17 00:00:00 2001 From: Claude Date: Wed, 2 Sep 2026 21:07:32 -0500 Subject: Use the go meta-port instead of a hand-rolled go/gofmt symlink FreeBSD's lang/go is a real meta-port (installs as package name "go") that depends on whichever goNNN is current and installs the go/gofmt symlinks itself, tracked and upgradeable - `pkg install go` replaces both the go125 install and the manual `ln -sf` steps in one command. Verified against a real base image and rebuild: same resulting symlinks, now pkg-owned instead of orphaned files pkg doesn't know about. Docs updated to check for an unversioned meta-port first, falling back to a manual symlink only when a toolchain doesn't have one. Co-Authored-By: Claude Sonnet 5 --- README.md | 24 ++++++++++++------------ 1 file changed, 12 insertions(+), 12 deletions(-) (limited to 'README.md') diff --git a/README.md b/README.md index 006d67a..88b1d93 100644 --- a/README.md +++ b/README.md @@ -28,9 +28,10 @@ needs to provide](#what-an-app-needs-to-provide). on the host itself. `make` itself is already in FreeBSD base (bmake), so it's the one build tool Skiff never asks you to install. Watch for versioned port names (`go125`, `python312`, ...) - FreeBSD installs the - literal versioned binary, not a bare `go`/`python3`, so symlink a default - into the base image's `/usr/local/bin` if a Makefile invokes the - unversioned name. + literal versioned binary, not a bare `go`/`python3`. Check for an + unversioned meta-port first (`go` itself is one - see [ZFS + layout](#zfs-layout)); only symlink a default by hand if no meta-port + exists for what you need. - The build step needs real outbound network access from inside the jail (module/package downloads) - see the `--ip` note under [First deploy](#first-deploy). @@ -63,17 +64,16 @@ wants `/dev/null` and `/dev/random`.) Now install whatever your apps' Makefiles actually need to build: ``` -# pkg -c /skiff/base install -y go125 +# pkg -c /skiff/base install -y go ``` -Watch for versioned port names - FreeBSD installs `go125` as literally -`go125`, not `go`, so a Makefile invoking the bare command needs a default -symlinked in: - -``` -# ln -sf go125 /skiff/base/usr/local/bin/go -# ln -sf gofmt125 /skiff/base/usr/local/bin/gofmt -``` +FreeBSD's versioned language ports (`go125`, `python312`, ...) install as +that literal binary name, not a bare `go`/`python3` - a Makefile invoking +the unversioned command needs one. Check for an unversioned meta-port +first: `go` is exactly that - it depends on whichever `goNNN` is current +and installs the `go`/`gofmt` symlinks itself (`pkg install -y go`, not +`go125` directly, is the whole fix). If no meta-port exists for what you +need, symlink a default into `/usr/local/bin` by hand instead. Unmount devfs and snapshot once the image can actually build and run apps: -- cgit v1.3