Package osutil provides operating system-specific path information, and other utility functions.
ErrNotSupported is returned by functions (like Mkfifo and Mksocket) when the underlying operating system or environment doesn't support the operation.
AddSecretRingFlag registers the "secret-keyring" flag, accessible via ExplicitSecretRingFile.
CPUUsage returns how much cumulative user CPU time the process has used. On unsupported operating systems, it returns zero.
DefaultLetsEncryptCache returns the path to the default Let's Encrypt cache directory (or file, depending on the ACME implementation).
DefaultSecretRingFile returns the path to the default GPG secret keyring. It is not influenced by any flag or CAMLI* env var.
DefaultTLSCert returns the path to the default TLS certificate file that is used (creating if necessary) when TLS is specified without the cert file.
DefaultTLSKey returns the path to the default TLS key file that is used (creating if necessary) when TLS is specified without the key file.
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.
DirExists reports whether dir exists. Errors are ignored and are reported as false.
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.
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.
HasSecretRingFlag reports whether the "secret-keywring" command-line flag was registered. If so, it is safe to use ExplicitSecretRingFile.
HomeDir returns the path to the user's home directory. It returns the empty string if the value isn't known.
MaxFD returns the maximum number of open file descriptors allowed. It returns ErrNotSupported on unsupported systems.
MemUsage returns the number of bytes used by the process. On unsupported operating systems, it returns zero.
Mkfifo creates a FIFO file named path. It returns ErrNotSupported on unsupported systems.
Mksocket creates a socket file (a Unix Domain Socket) named path. It returns ErrNotSupported on unsupported systems.
NewJSONConfigParser returns a jsonconfig.ConfigParser with its IncludeDirs set with CamliConfigDir and the contents of CAMLI_INCLUDE_PATH.
RegisterConfigDirFunc registers a func f to return the Camlistore configuration directory. It may skip by returning the empty string.
RegisterLetsEncryptCacheFunc registers a func f to return the path to the default Let's Encrypt cache. It may skip by returning the empty string.
RestartProcess restarts the process with the given arguments, if any, replacing the original process's arguments. It defaults to os.Args otherwise. It returns an error if things couldn't be restarted. On success, this function never returns because the process becomes the new process.
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.
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.
Username returns the current user's username, as reported by the relevant environment variable.
|gce||Package gce configures hooks for running Camlistore for Google Compute Engine.|