Documentation
¶
Index ¶
- Constants
- Variables
- func CommonOpts(ctx context.Context, sshExe SSHExe, useDotSSH bool) ([]string, error)
- func DetectOpenSSHVersion(ctx context.Context, sshExe SSHExe) semver.Version
- func DisableControlMasterOptsFromSSHArgs(sshArgs []string) []string
- func Format(w io.Writer, sshPath, instName string, format FormatT, opts []string) error
- func IsControlMasterExisting(instDir string) bool
- func IsControlMasterRunning(ctx context.Context, instDir string) bool
- func ParseOpenSSHVersion(version []byte) *semver.Version
- func RemoveStaleControlMaster(ctx context.Context, instDir string) (bool, error)
- func SSHArgsFromOpts(opts []string) []string
- func SSHOpts(ctx context.Context, sshExe SSHExe, instDir, username string, ...) ([]string, error)
- func SSHOptsRemovingControlPath(opts []string) []string
- type FormatT
- type PubKey
- type SSHExe
Constants ¶
const ( // FormatCmd prints the full ssh command line. // // ssh -o IdentityFile="/Users/example/.lima/_config/user" -o User=example -o Hostname=127.0.0.1 -o Port=60022 lima-default FormatCmd = FormatT("cmd") // FormatArgs is similar to FormatCmd but omits "ssh" and the destination address. // // -o IdentityFile="/Users/example/.lima/_config/user" -o User=example -o Hostname=127.0.0.1 -o Port=60022 FormatArgs = FormatT("args") // FormatOptions prints the ssh option key value pairs. // // IdentityFile="/Users/example/.lima/_config/user" // User=example // Hostname=127.0.0.1 // Port=60022 FormatOptions = FormatT("options") // FormatConfig uses the ~/.ssh/config format // // Host lima-default // IdentityFile "/Users/example/.lima/_config/user " // User example // Hostname 127.0.0.1 // Port 60022 FormatConfig = FormatT("config") )
const EnvShellSSH = "SSH"
Environment variable that allows configuring the command (alias) to execute in place of the 'ssh' executable.
Variables ¶
var Formats = []FormatT{FormatCmd, FormatArgs, FormatOptions, FormatConfig}
Formats is the list of the supported formats.
Functions ¶
func CommonOpts ¶
CommonOpts returns ssh option key-value pairs like {"IdentityFile=/path/to/id_foo"}. The result may contain different values with the same key.
The result always contains the IdentityFile option. The result never contains the Port option.
func DetectOpenSSHVersion ¶
func DisableControlMasterOptsFromSSHArgs ¶
DisableControlMasterOptsFromSSHArgs returns ssh args that disable ControlMaster, ControlPath, and ControlPersist.
func IsControlMasterExisting ¶
IsControlMasterExisting returns true if the control socket file exists.
func IsControlMasterRunning ¶
IsControlMasterRunning reports whether an SSH ControlMaster process is actively listening on the instance's control socket. Unlike IsControlMasterExisting, which only checks that the socket file is present, this dials the socket to verify that a master is alive. A stale socket left behind by an unclean master exit (kill -9, OOM, host crash, or the Cygwin emulation file outliving its process) has no listener and returns false.
func ParseOpenSSHVersion ¶
func RemoveStaleControlMaster ¶
RemoveStaleControlMaster removes the SSH control socket only when no master process is listening on it. It returns true when a stale socket was removed. A live master's socket is never touched (returns false), and a missing socket is treated as a no-op (returns false). This lets callers recover from a wedged session without clobbering a healthy ControlMaster.
func SSHArgsFromOpts ¶
SSHArgsFromOpts returns ssh args from opts. The result always contains {"-F", "/dev/null} in addition to {"-o", "KEY=VALUE", ...}.
func SSHOpts ¶
func SSHOpts(ctx context.Context, sshExe SSHExe, instDir, username string, useDotSSH, forwardAgent, forwardX11, forwardX11Trusted bool) ([]string, error)
SSHOpts adds the following options to CommonOptions: User, ControlMaster, ControlPath, ControlPersist.
func SSHOptsRemovingControlPath ¶
SSHOptsRemovingControlPath removes ControlMaster, ControlPath, and ControlPersist options from SSH options.
Types ¶
type PubKey ¶
func DefaultPubKeys ¶
DefaultPubKeys returns the public key from $LIMA_HOME/_config/user.pub. The key will be created if it does not yet exist.
When loadDotSSH is true, ~/.ssh/*.pub will be appended to make the VM accessible without specifying an identity explicitly.
Source Files