Documentation
¶
Index ¶
- func AptGet() func(context.Context) *exec.Cmd
- func Dnf() func(context.Context) *exec.Cmd
- func Ip() func(context.Context) *exec.Cmd
- func IsTextFileBusy(err error) bool
- func MachineRun(ctx context.Context, log *slog.Logger, machine string, args ...string) (string, error)
- func Machinectl() func(context.Context) *exec.Cmd
- func Mountpoint() func(context.Context) *exec.Cmd
- func OutputCmd(ctx context.Context, logger *slog.Logger, name string, args ...string) (string, error)
- func OutputCmdAt(ctx context.Context, logger *slog.Logger, stderrLevel slog.Level, name string, ...) (string, error)
- func RetryWhileTextFileBusy(ctx context.Context, logger *slog.Logger, attempt func() error) error
- func RunCmd(ctx context.Context, logger *slog.Logger, ...) error
- func RunCmdAt(ctx context.Context, logger *slog.Logger, stderrLevel slog.Level, ...) error
- func Sysctl() func(context.Context) *exec.Cmd
- func Systemctl() func(context.Context) *exec.Cmd
- func Tdnf() func(context.Context) *exec.Cmd
- func Umount() func(context.Context) *exec.Cmd
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func IsTextFileBusy ¶ added in v0.2.4
IsTextFileBusy reports whether an error is the transient ETXTBSY described above, so callers doing their own exec can make the same allowance.
func MachineRun ¶
func MachineRun(ctx context.Context, log *slog.Logger, machine string, args ...string) (string, error)
MachineRun executes a command inside the named nspawn machine using systemd-run --machine=<machine> --pipe --wait. It streams stdout at Debug and stderr at Error, and returns the captured stdout.
func Machinectl ¶
Machinectl returns a command factory for machinectl.
func Mountpoint ¶ added in v0.1.11
Mountpoint returns a command factory for mountpoint.
func OutputCmd ¶
func OutputCmd(ctx context.Context, logger *slog.Logger, name string, args ...string) (string, error)
OutputCmd runs the command specified by name and args, streams stdout at Debug and stderr at Info, and returns the captured stdout as a string. Unlike RunCmd it does not require a command factory - just a binary path.
func OutputCmdAt ¶
func OutputCmdAt(ctx context.Context, logger *slog.Logger, stderrLevel slog.Level, name string, args ...string) (string, error)
OutputCmdAt is like OutputCmd but streams stderr at stderrLevel instead of Info. Use a lower level (e.g. Debug) when stderr output is known to be benign or an error exit is expected and already handled by the caller.
func RetryWhileTextFileBusy ¶ added in v0.2.4
RetryWhileTextFileBusy runs attempt until it does not fail with ETXTBSY.
attempt must build everything it needs each time it is called, including the exec.Cmd: an exec.Cmd cannot be reused once started, and any pipes it created must be released before the next attempt. Nothing outside attempt constructs a command, so a caller-supplied command factory is invoked exactly once per attempt and never merely to inspect it.
The path of the binary is deliberately not a parameter. Every error this can return already names it, because a failed start is wrapped with the command path and the underlying os.PathError carries it as well.
func RunCmd ¶
func RunCmd(ctx context.Context, logger *slog.Logger, newCmd func(context.Context) *exec.Cmd, args ...string) error
RunCmd creates a command from the given factory, appends args, streams stdout at Debug and stderr at Info, and waits for it to finish.
func RunCmdAt ¶
func RunCmdAt(ctx context.Context, logger *slog.Logger, stderrLevel slog.Level, newCmd func(context.Context) *exec.Cmd, args ...string) error
RunCmdAt is like RunCmd but streams stderr at stderrLevel instead of Info. Use a lower level (e.g. Debug) when stderr output is known to be benign or when a failure is expected and already handled by the caller.
Types ¶
This section is empty.
Source Files