From eb5ee4fece0327b1183ae823d68e4cf4e3e1ced0 Mon Sep 17 00:00:00 2001
From: Ophestra <cat@gensokyo.uk>
Date: Sun, 5 Oct 2025 02:42:41 +0900
Subject: internal/app: modularise outcome finalise

This is the initial effort of splitting up host and container side of finalisation for params to shim. The new layout also enables much finer grained unit testing of each step, as well as partition access to per-app state for each step.

Signed-off-by: Ophestra <cat@gensokyo.uk>
---
 internal/app/spaccount.go | 55 +++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 55 insertions(+)
 create mode 100644 internal/app/spaccount.go

(limited to 'internal/app/spaccount.go')

diff --git a/internal/app/spaccount.go b/internal/app/spaccount.go
new file mode 100644
index 00000000..dbe3b03c
--- /dev/null
+++ b/internal/app/spaccount.go
@@ -0,0 +1,55 @@
+package app
+
+import (
+	"fmt"
+	"syscall"
+
+	"hakurei.app/container"
+	"hakurei.app/hst"
+)
+
+// spAccountOp sets up user account emulation inside the container.
+type spAccountOp struct {
+	// Inner directory to use as the home directory of the emulated user.
+	Home *container.Absolute
+	// String matching the default NAME_REGEX value from adduser to use as the username of the emulated user.
+	Username string
+	// Pathname of shell to use for the emulated user.
+	Shell *container.Absolute
+}
+
+func (s *spAccountOp) toSystem(*outcomeStateSys, *hst.Config) error {
+	const fallbackUsername = "chronos"
+
+	// do checks here to fail before fork/exec
+	if s.Home == nil || s.Shell == nil {
+		// unreachable
+		return syscall.ENOTRECOVERABLE
+	}
+	if s.Username == "" {
+		s.Username = fallbackUsername
+	} else if !isValidUsername(s.Username) {
+		return newWithMessage(fmt.Sprintf("invalid user name %q", s.Username))
+	}
+	return nil
+}
+
+func (s *spAccountOp) toContainer(state *outcomeStateParams) error {
+	state.params.Dir = s.Home
+	state.env["HOME"] = s.Home.String()
+	state.env["USER"] = s.Username
+	state.env["SHELL"] = s.Shell.String()
+
+	state.params.
+		Place(container.AbsFHSEtc.Append("passwd"),
+			[]byte(s.Username+":x:"+
+				state.mapuid.String()+":"+
+				state.mapgid.String()+
+				":Hakurei:"+
+				s.Home.String()+":"+
+				s.Shell.String()+"\n")).
+		Place(container.AbsFHSEtc.Append("group"),
+			[]byte("hakurei:x:"+state.mapgid.String()+":\n"))
+
+	return nil
+}
-- 
cgit v1.3.1