Documentation ¶
Overview ¶
Package osutil provides operating system-specific path information, and other utility functions.
Index ¶
- Variables
- func AddSecretRingFlag()
- func CPUUsage() time.Duration
- func CacheDir() string
- func CamliBlobRoot() string
- func CamliConfigDir() string
- func CamliVarDir() string
- func DefaultSecretRingFile() string
- func DefaultTLSCert() string
- func DefaultTLSKey() string
- func DieOnParentDeath()
- func DirExists(dir string) bool
- func ExplicitSecretRingFile() (string, bool)
- func FindCamliInclude(configFile string) (absPath string, err error)
- func GoPackagePath(pkg string) (path string, err error)
- func HomeDir() string
- func MemUsage() int64
- func Mkfifo(path string, mode uint32) error
- func Mksocket(path string) error
- func OpenURL(url string) error
- func RegisterConfigDirFunc(f func() string)
- func RestartProcess() error
- func SecretRingFile() string
- func SelfPath() (string, error)
- func UserClientConfigPath() string
- func UserServerConfigPath() string
- func Username() string
Constants ¶
This section is empty.
Variables ¶
var ErrNotSupported = errors.New("operation not supported")
ErrNotSupported is returned by functions (like Mkfifo and Mksocket) when the underlying operating system or environment doesn't support the operation.
Functions ¶
func AddSecretRingFlag ¶
func AddSecretRingFlag()
func CPUUsage ¶
CPUUsage returns how much cumulative user CPU time the process has used. On unsupported operating systems, it returns zero.
func CamliBlobRoot ¶
func CamliBlobRoot() string
func CamliConfigDir ¶
func CamliConfigDir() string
func CamliVarDir ¶
func CamliVarDir() string
func DefaultSecretRingFile ¶
func DefaultSecretRingFile() string
DefaultSecretRingFile returns the path to the default GPG secret keyring. It is not influenced by any flag or CAMLI* env var.
func DefaultTLSCert ¶
func DefaultTLSCert() string
DefaultTLSCert returns the path to the default TLS certificate file that is used (creating if necessary) when TLS is specified without the cert file.
func DefaultTLSKey ¶
func DefaultTLSKey() string
DefaultTLSKey returns the path to the default TLS key file that is used (creating if necessary) when TLS is specified without the key file.
func DieOnParentDeath ¶
func DieOnParentDeath()
DieOnParentDeath starts a goroutine that regularly checks that the current process can find its parent, and calls os.Exit(0) as soon as it cannot.
func DirExists ¶
DirExists reports whether dir exists. Errors are ignored and are reported as false.
func ExplicitSecretRingFile ¶
ExplicitSecretRingFile returns the path to the user's GPG secret ring file and true if it was ever set through the --secret-keyring flag or the CAMLI_SECRET_RING var. It returns "", false otherwise. Use of this function requires the program to call AddSecretRingFlag, and before flag.Parse is called.
func FindCamliInclude ¶
Find the correct absolute path corresponding to a relative path, searching the following sequence of directories: 1. Working Directory 2. CAMLI_CONFIG_DIR (deprecated, will complain if this is on env) 3. (windows only) APPDATA/camli 4. All directories in CAMLI_INCLUDE_PATH (standard PATH form for OS)
func GoPackagePath ¶
GoPackagePath returns the path to the provided Go package's source directory. pkg may be a path prefix without any *.go files. The error is os.ErrNotExist if GOPATH is unset or the directory doesn't exist in any GOPATH component.
func HomeDir ¶
func HomeDir() string
HomeDir returns the path to the user's home directory. It returns the empty string if the value isn't known.
func MemUsage ¶
func MemUsage() int64
MemUsage returns the number of bytes used by the process. On unsupported operating systems, it returns zero.
func RegisterConfigDirFunc ¶
func RegisterConfigDirFunc(f func() string)
RegisterConfigDirFunc registers a func f to return the Camlistore configuration directory. It may skip by returning the empty string.
func RestartProcess ¶
func RestartProcess() error
RestartProcess returns an error if things couldn't be restarted. On success, this function never returns because the process becomes the new process.
func SecretRingFile ¶
func SecretRingFile() string
SecretRingFile returns the path to the user's GPG secret ring file. The value comes from either the --secret-keyring flag (if previously registered with AddSecretRingFlag), or the CAMLI_SECRET_RING environment variable, or the operating system default location.
func SelfPath ¶
SelfPath returns the path of the executable for the currently running process. At least on linux, the returned path is a symlink to the actual executable.
func UserClientConfigPath ¶
func UserClientConfigPath() string
func UserServerConfigPath ¶
func UserServerConfigPath() string
Types ¶
This section is empty.