Documentation
¶
Overview ¶
Package execabs is a drop-in replacement for os/exec that requires PATH lookups to find absolute paths. That is, execabs.Command("cmd") runs the same PATH lookup as exec.Command("cmd"), but if the result is a path which is relative, the Run and Start methods will report an error instead of running the executable.
See https://blog.golang.org/path-security for more information about when it may be necessary or appropriate to use this package.
Index ¶
Constants ¶
This section is empty.
Variables ¶
var ErrNotFound = exec.ErrNotFound
ErrNotFound is the error resulting if a path search failed to find an executable file. It is an alias for exec.ErrNotFound.
Functions ¶
func Command ¶
Command returns the Cmd struct to execute the named program with the given arguments. See exec.Command for most details.
Command differs from exec.Command in its handling of PATH lookups, which are used when the program name contains no slashes. If exec.Command would have returned an exec.Cmd configured to run an executable from the current directory, Command instead returns an exec.Cmd that will return an error from Start or Run.
func CommandContext ¶
CommandContext is like Command but includes a context.
The provided context is used to kill the process (by calling os.Process.Kill) if the context becomes done before the command completes on its own.
func LookPath ¶
LookPath searches for an executable named file in the directories named by the PATH environment variable. If file contains a slash, it is tried directly and the PATH is not consulted. The result will be an absolute path.
LookPath differs from exec.LookPath in its handling of PATH lookups, which are used for file names without slashes. If exec.LookPath's PATH lookup would have returned an executable from the current directory, LookPath instead returns an error.
Source Files