go.os.exec
1.23.1.3
dotnet add package go.os.exec --version 1.23.1.3
NuGet\Install-Package go.os.exec -Version 1.23.1.3
<PackageReference Include="go.os.exec" Version="1.23.1.3" />
<PackageVersion Include="go.os.exec" Version="1.23.1.3" />
<PackageReference Include="go.os.exec" />
paket add go.os.exec --version 1.23.1.3
#r "nuget: go.os.exec, 1.23.1.3"
#:package go.os.exec@1.23.1.3
#addin nuget:?package=go.os.exec&version=1.23.1.3
#tool nuget:?package=go.os.exec&version=1.23.1.3
go.os.exec
C# package converted from the Go standard library by go2cs. Go version: 1.23.1
Package exec runs external commands. It wraps os.StartProcess to make it easier to remap stdin and stdout, connect I/O with pipes, and do other adjustments.
Unlike the "system" library call from C and other languages, the os/exec package intentionally does not invoke the system shell and does not expand any glob patterns or handle other expansions, pipelines, or redirections typically done by shells. The package behaves more like C's "exec" family of functions. To expand glob patterns, either call the shell directly, taking care to escape any dangerous input, or use the path/filepath package's Glob function. To expand environment variables, use package os's ExpandEnv.
Note that the examples in this package assume a Unix system. They may not run on Windows, and they do not run in the Go Playground used by golang.org and godoc.org.
Executables in the current directory
The functions [Command] and [LookPath] look for a program in the directories listed in the current path, following the conventions of the host operating system. Operating systems have for decades included the current directory in this search, sometimes implicitly and sometimes configured explicitly that way by default. Modern practice is that including the current directory is usually unexpected and often leads to security problems.
To avoid those security problems, as of Go 1.19, this package will not resolve a program using an implicit or explicit path entry relative to the current directory. That is, if you run [LookPath]("go"), it will not successfully return ./go on Unix nor .\go.exe on Windows, no matter how the path is configured. Instead, if the usual path algorithms would result in that answer, these functions return an error err satisfying errors.Is(err, [ErrDot]).
For example, consider these two program snippets:
path, err := exec.LookPath("prog")
if err != nil {
log.Fatal(err)
}
use(path)
and
cmd := exec.Command("prog")
if err := cmd.Run(); err != nil {
log.Fatal(err)
}
These will not find and run ./prog or .\prog.exe, no matter how the current path is configured.
Code that always wants to run a program from the current directory can be rewritten to say "./prog" instead of "prog".
Code that insists on including results from relative path entries can instead override the error using an errors.Is check:
path, err := exec.LookPath("prog")
if errors.Is(err, exec.ErrDot) {
err = nil
}
if err != nil {
log.Fatal(err)
}
use(path)
and
cmd := exec.Command("prog")
if errors.Is(cmd.Err, exec.ErrDot) {
cmd.Err = nil
}
if err := cmd.Run(); err != nil {
log.Fatal(err)
}
Setting the environment variable GODEBUG=execerrdot=0 disables generation of ErrDot entirely, temporarily restoring the pre-Go 1.19 behavior for programs that are unable to apply more targeted fixes. A future version of Go may remove support for this variable.
Before adding such overrides, make sure you understand the security implications of doing so. See https://go.dev/blog/path-security for more information.
Part of the go2cs converted Go standard library. See the repository for usage and details.
Copyright 2009 The Go Authors. All rights reserved. This C# package is converted from Go standard library source; use of that source is governed by a BSD-style license that can be found in the LICENSE file. The go2cs conversion itself is distributed under the MIT license.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net9.0 is compatible. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. net10.0 was computed. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
-
net9.0
- go.bytes (>= 1.23.1.3)
- go.context (>= 1.23.1.3)
- go.errors (>= 1.23.1.3)
- go.internal.godebug (>= 1.23.1.3)
- go.internal.syscall.execenv (>= 1.23.1.3)
- go.io (>= 1.23.1.3)
- go.io.fs (>= 1.23.1.3)
- go.lib (>= 1.23.1.3)
- go.os (>= 1.23.1.3)
- go.path.filepath (>= 1.23.1.3)
- go.runtime (>= 1.23.1.3)
- go.strconv (>= 1.23.1.3)
- go.strings (>= 1.23.1.3)
- go.syscall (>= 1.23.1.3)
- go.time (>= 1.23.1.3)
NuGet packages (10)
Showing the top 5 NuGet packages that depend on go.os.exec:
| Package | Downloads |
|---|---|
|
go.internal.goroot
internal.goroot (net9.0 - Release) -- C# project converted from Go source |
|
|
go.go.build
go.build (net9.0 - Release) -- C# project converted from Go source |
|
|
go.go.internal.gcimporter
go.internal.gcimporter (net9.0 - Release) -- C# project converted from Go source |
|
|
go.internal.fuzz
internal.fuzz (net9.0 - Release) -- C# project converted from Go source |
|
|
go.go.internal.srcimporter
go.internal.srcimporter (net9.0 - Release) -- C# project converted from Go source |
GitHub repositories
This package is not used by any popular GitHub repositories.