install

Documentation

Index

• Variables
• func AfterUpdateApply(context Context, willRestart bool, force bool, log Log) error
• func AutoInstall(context Context, _ string, _ bool, timeout time.Duration, log Log) (newProc bool, err error)
• func BinPath() (string, error)
• func CheckIfValidLocation() error
• func GetNeedUpdate() (bool, error)
• func Install(context Context, binPath string, sourcePath string, components []string, ...) keybase1.InstallResult
• func InstallLogPath() (string, error)
• func IsInUse(mountDir string, log Log) bool
• func KBFSBinPath(runMode libkb.RunMode, binPath string) (string, error)
• func KBFSBundleVersion(context Context, binPath string) (string, error)
• func KeybaseFuseStatus(bundleVersion string, log Log) keybase1.FuseStatus
• func ResolveInstallStatus(version string, bundleVersion string, lastExitStatus string, log Log) (installStatus keybase1.InstallStatus, installAction keybase1.InstallAction, ...)
• func RunApp(context Context, log Log) error
• func StartUpdateIfNeeded(context.Context, logger.Logger) error
• func StopAllButService(mctx libkb.MetaContext, exitCode keybase1.ExitCode)
• func SystemLogPath() string
• func TerminateApp(context Context, log Log) error
• func ToggleAutostart(context Context, on bool, forAutoinstall bool) error
• func Uninstall(context Context, components []string, log Log) keybase1.UninstallResult
• func UpdaterBinPath() (string, error)
• func WatchdogLogPath(string) (string, error)
• type CommonLsofResult
  • func LsofMount(mountDir string, log Log) ([]CommonLsofResult, error)
• type ComponentName
  • func ComponentNameFromString(s string) ComponentName
  • func (c ComponentName) Description() string
  • func (c ComponentName) String() string
• type Context
• type Log

Variables

var ComponentNames = []ComponentName{ComponentNameCLI, ComponentNameService, ComponentNameKBFS, ComponentNameUpdater, ComponentNameFuse, ComponentNameHelper, ComponentNameApp, ComponentNameKBNM, ComponentNameRedirector, ComponentNameCLIPaths}

ComponentNames are all the valid component names

Functions

func AfterUpdateApply

func AfterUpdateApply(context Context, willRestart bool, force bool, log Log) error

func AutoInstall

func AutoInstall(context Context, _ string, _ bool, timeout time.Duration, log Log) (newProc bool, err error)

AutoInstall installs auto start on unix

func BinPath

func BinPath() (string, error)

BinPath returns path to the keybase executable. If the executable path is a symlink, the target path is returned.

func CheckIfValidLocation

func CheckIfValidLocation() error

CheckIfValidLocation is not used on unix

func GetNeedUpdate

func GetNeedUpdate() (bool, error)

GetNeedUpdate always returns false, nil on this platform.

func Install

func Install(context Context, binPath string, sourcePath string, components []string, force bool, timeout time.Duration, log Log) keybase1.InstallResult

Install empty implementation for unsupported platforms

func InstallLogPath

func InstallLogPath() (string, error)

func IsInUse

func IsInUse(mountDir string, log Log) bool

IsInUse returns true if the mount is in use. This may be used by the updater to determine if it's safe to apply an update and restart.

func KBFSBinPath

func KBFSBinPath(runMode libkb.RunMode, binPath string) (string, error)

KBFSBinPath returns the path to the KBFS executable

func KBFSBundleVersion

func KBFSBundleVersion(context Context, binPath string) (string, error)

KBFSBundleVersion returns the bundle (not installed) version for KBFS

func KeybaseFuseStatus

func KeybaseFuseStatus(bundleVersion string, log Log) keybase1.FuseStatus

func ResolveInstallStatus

func ResolveInstallStatus(version string, bundleVersion string, lastExitStatus string, log Log) (installStatus keybase1.InstallStatus, installAction keybase1.InstallAction, status keybase1.Status)

ResolveInstallStatus will determine necessary install actions for the current environment

func RunApp

func RunApp(context Context, log Log) error

RunApp starts the app

func StartUpdateIfNeeded

func StartUpdateIfNeeded(context.Context, logger.Logger) error

StartUpdateIfNeeded is a no-op on this platform.

func StopAllButService

func StopAllButService(mctx libkb.MetaContext, exitCode keybase1.ExitCode)

func SystemLogPath

func SystemLogPath() string

func TerminateApp

func TerminateApp(context Context, log Log) error

TerminateApp will stop the Keybase (UI) app

func ToggleAutostart

func ToggleAutostart(context Context, on bool, forAutoinstall bool) error

func Uninstall

func Uninstall(context Context, components []string, log Log) keybase1.UninstallResult

Uninstall empty implementation for unsupported platforms

func UpdaterBinPath

func UpdaterBinPath() (string, error)

UpdaterBinPath returns the path to the updater executable, by default is in the same directory as the keybase executable.

func WatchdogLogPath

func WatchdogLogPath(string) (string, error)

WatchdogLogPath doesn't exist on linux as an independent log file

Types

type CommonLsofResult

type CommonLsofResult struct {
	PID     string
	Command string
}

func LsofMount

func LsofMount(mountDir string, log Log) ([]CommonLsofResult, error)

LsofMount does not return an error if it was unable to lsof the mountpoint or the mountpoint does not exist.

type ComponentName

type ComponentName string

ComponentName defines a component name

const (
	// ComponentNameCLI is the command line component
	ComponentNameCLI ComponentName = "cli"
	// ComponentNameService is the service component
	ComponentNameService ComponentName = "service"
	// ComponentNameKBFS is the KBFS component
	ComponentNameKBFS ComponentName = "kbfs"
	// ComponentNameKBNM is the Keybase NativeMessaging client component
	ComponentNameKBNM ComponentName = "kbnm"
	// ComponentNameUpdater is the updater component
	ComponentNameUpdater ComponentName = "updater"
	// ComponentNameApp is the UI app
	ComponentNameApp ComponentName = "app"
	// ComponentNameFuse is the Fuse component
	ComponentNameFuse ComponentName = "fuse"
	// ComponentNameHelper is the privileged helper tool
	ComponentNameHelper ComponentName = "helper"
	// ComponentNameMountDir is the mount directory
	ComponentNameMountDir ComponentName = "mountdir"
	// ComponentNameCLIPaths is for /etc/paths.d/Keybase
	ComponentNameCLIPaths ComponentName = "clipaths"
	// ComponentNameRedirector is the KBFS redirector
	ComponentNameRedirector ComponentName = "redirector"
	// ComponentNameUnknown is placeholder for unknown components
	ComponentNameUnknown ComponentName = "unknown"
)

func ComponentNameFromString

func ComponentNameFromString(s string) ComponentName

ComponentNameFromString returns ComponentName from a string

func (ComponentName) Description

func (c ComponentName) Description() string

Description returns description for component name

func (ComponentName) String

func (c ComponentName) String() string

String returns string for ComponentName

type Context

type Context interface {
	GetConfigDir() string
	GetCacheDir() string
	GetRuntimeDir() string
	GetMountDir() (string, error)
	GetLogDir() string
	GetRunMode() libkb.RunMode
	GetServiceInfoPath() string
	GetKBFSInfoPath() string
}

Context is the environment for this package

type Log

type Log interface {
	Debug(s string, args ...interface{})
	Info(s string, args ...interface{})
	Warning(s string, args ...interface{})
	Errorf(s string, args ...interface{})
}

Log is the logging interface for this package