目錄 搜尋
archive archive/tar archive/zip bufio bufio(缓存) builtin builtin(内置包) bytes bytes(包字节) compress compress/bzip2(压缩/bzip2) compress/flate(压缩/flate) compress/gzip(压缩/gzip) compress/lzw(压缩/lzw) compress/zlib(压缩/zlib) container container/heap(容器数据结构heap) container/list(容器数据结构list) container/ring(容器数据结构ring) context context(上下文) crypto crypto(加密) crypto/aes(加密/aes) crypto/cipher(加密/cipher) crypto/des(加密/des) crypto/dsa(加密/dsa) crypto/ecdsa(加密/ecdsa) crypto/elliptic(加密/elliptic) crypto/hmac(加密/hmac) crypto/md5(加密/md5) crypto/rand(加密/rand) crypto/rc4(加密/rc4) crypto/rsa(加密/rsa) crypto/sha1(加密/sha1) crypto/sha256(加密/sha256) crypto/sha512(加密/sha512) crypto/subtle(加密/subtle) crypto/tls(加密/tls) crypto/x509(加密/x509) crypto/x509/pkix(加密/x509/pkix) database database/sql(数据库/sql) database/sql/driver(数据库/sql/driver) debug debug/dwarf(调试/dwarf) debug/elf(调试/elf) debug/gosym(调试/gosym) debug/macho(调试/macho) debug/pe(调试/pe) debug/plan9obj(调试/plan9obj) encoding encoding(编码) encoding/ascii85(编码/ascii85) encoding/asn1(编码/asn1) encoding/base32(编码/base32) encoding/base64(编码/base64) encoding/binary(编码/binary) encoding/csv(编码/csv) encoding/gob(编码/gob) encoding/hex(编码/hex) encoding/json(编码/json) encoding/pem(编码/pem) encoding/xml(编码/xml) errors errors(错误) expvar expvar flag flag(命令行参数解析flag包) fmt fmt go go/ast(抽象语法树) go/build go/constant(常量) go/doc(文档) go/format(格式) go/importer go/parser go/printer go/scanner(扫描仪) go/token(令牌) go/types(类型) hash hash(散列) hash/adler32 hash/crc32 hash/crc64 hash/fnv html html html/template(模板) image image(图像) image/color(颜色) image/color/palette(调色板) image/draw(绘图) image/gif image/jpeg image/png index index/suffixarray io io io/ioutil log log log/syslog(日志系统) math math math/big math/big math/bits math/bits math/cmplx math/cmplx math/rand math/rand mime mime mime/multipart(多部分) mime/quotedprintable net net net/http net/http net/http/cgi net/http/cookiejar net/http/fcgi net/http/httptest net/http/httptrace net/http/httputil net/http/internal net/http/pprof net/mail net/mail net/rpc net/rpc net/rpc/jsonrpc net/smtp net/smtp net/textproto net/textproto net/url net/url os os os/exec os/signal os/user path path path/filepath(文件路径) plugin plugin(插件) reflect reflect(反射) regexp regexp(正则表达式) regexp/syntax runtime runtime(运行时) runtime/debug(调试) runtime/internal/sys runtime/pprof runtime/race(竞争) runtime/trace(执行追踪器) sort sort(排序算法) strconv strconv(转换) strings strings(字符串) sync sync(同步) sync/atomic(原子操作) syscall syscall(系统调用) testing testing(测试) testing/iotest testing/quick text text/scanner(扫描文本) text/tabwriter text/template(定义模板) text/template/parse time time(时间戳) unicode unicode unicode/utf16 unicode/utf8 unsafe unsafe
文字

  • import "os/exec"

  • Overview

  • Index

  • Examples

概观

包 exec 执行外部命令。它包装了 os.StartProcess ,以便重新映射 stdin 和 stdout ,使用管道连接 I/O 并进行其他调整。

与来自 C 和其他语言的“系统”库调用不同,os/exec 包有意不调用系统shell,并且不会扩展任何 glob 模式或处理通常由 shell 执行的其他扩展,管道或重定向。该软件包的行为更像 C 的 “exec” 系列功能。要扩展 glob 模式,请直接调用外壳,注意避开任何危险输入,或者使用 path/filepath 包的 Glob 函数。要扩展环境变量,请使用 package os 的 ExpandEnv 。

请注意,此包中的示例假定为Unix系统。它们可能无法在Windows上运行,并且它们不会在golang.org和godoc.org使用的Go Playground中运行。

Index

  • Variables

  • func LookPath(file string) (string, error)

  • type Cmd

  • func Command(name string, arg ...string) *Cmd

  • func CommandContext(ctx context.Context, name string, arg ...string) *Cmd

  • func (c *Cmd) CombinedOutput() ([]byte, error)

  • func (c *Cmd) Output() ([]byte, error)

  • func (c *Cmd) Run() error

  • func (c *Cmd) Start() error

  • func (c *Cmd) StderrPipe() (io.ReadCloser, error)

  • func (c *Cmd) StdinPipe() (io.WriteCloser, error)

  • func (c *Cmd) StdoutPipe() (io.ReadCloser, error)

  • func (c *Cmd) Wait() error

  • type Error

  • func (e *Error) Error() string

  • type ExitError

  • func (e *ExitError) Error() string

例子

Cmd.CombinedOutput Cmd.Output Cmd.Run Cmd.Start Cmd.StderrPipe Cmd.StdinPipe Cmd.StdoutPipe Command CommandContext Command (Environment) LookPath

包文件

exec.go exec_unix.go lp_unix.go

变量

ErrNotFound 是如果路径搜索未能找到可执行文件导致的错误。

var ErrNotFound = errors.New("executable file not found in $PATH")

func LookPath

func LookPath(file string) (string, error)

LookPath 在由 PATH 环境变量命名的目录中搜索名为 file 的可执行二进制文件。如果文件包含斜线,则直接尝试并且不会咨询 PATH 。结果可能是相对于当前目录的绝对路径或路径。

package mainimport ("fmt""log""os/exec")func main() {
	path, err := exec.LookPath("fortune")if err != nil {
		log.Fatal("installing fortune is in your future")}
	fmt.Printf("fortune is available at %s\n", path)}

type Cmd

Cmd 代表正在准备或运行的外部命令。

调用它的 Run,Output 或 CombinedOutput 方法后,Cmd 不能重用。

type Cmd struct {        // Path is the path of the command to run.        //        // This is the only field that must be set to a non-zero        // value. If Path is relative, it is evaluated relative        // to Dir.
        Path string        // Args holds command line arguments, including the command as Args[0].        // If the Args field is empty or nil, Run uses {Path}.        //        // In typical use, both Path and Args are set by calling Command.
        Args []string        // Env specifies the environment of the process.        // Each entry is of the form "key=value".        // If Env is nil, the new process uses the current process's        // environment.        // If Env contains duplicate environment keys, only the last        // value in the slice for each duplicate key is used.
        Env []string        // Dir specifies the working directory of the command.        // If Dir is the empty string, Run runs the command in the        // calling process's current directory.
        Dir string        // Stdin specifies the process's standard input.        // If Stdin is nil, the process reads from the null device (os.DevNull).        // If Stdin is an *os.File, the process's standard input is connected        // directly to that file.        // Otherwise, during the execution of the command a separate        // goroutine reads from Stdin and delivers that data to the command        // over a pipe. In this case, Wait does not complete until the goroutine        // stops copying, either because it has reached the end of Stdin        // (EOF or a read error) or because writing to the pipe returned an error.
        Stdin io.Reader        // Stdout and Stderr specify the process's standard output and error.        //        // If either is nil, Run connects the corresponding file descriptor        // to the null device (os.DevNull).        //        // If Stdout and Stderr are the same writer, and have a type that can be compared with ==,        // at most one goroutine at a time will call Write.
        Stdout io.Writer
        Stderr io.Writer        // ExtraFiles specifies additional open files to be inherited by the        // new process. It does not include standard input, standard output, or        // standard error. If non-nil, entry i becomes file descriptor 3+i.
        ExtraFiles []*os.File        // SysProcAttr holds optional, operating system-specific attributes.        // Run passes it to os.StartProcess as the os.ProcAttr's Sys field.
        SysProcAttr *syscall.SysProcAttr        // Process is the underlying process, once started.
        Process *os.Process        // ProcessState contains information about an exited process,        // available after a call to Wait or Run.
        ProcessState *os.ProcessState        // contains filtered or unexported fields}

func Command

func Command(name string, arg ...string) *Cmd

命令返回 Cmd 结构来执行具有给定参数的命名程序。

它仅在返回的结构中设置 Path 和 Args 。

如果名称不包含路径分隔符,Command 将尽可能使用 LookPath 将名称解析为完整路径。否则,它直接使用名称作为路径。

返回的 Cmd 的 Args 字段由命令名称和后面的 arg 元素构成,所以 arg 不应包含命令名称本身。例如,Command(“echo”,“hello”)。Args0 始终是名称,而不是可能解析的路径。

package mainimport ("bytes""fmt""log""os/exec""strings")func main() {
	cmd := exec.Command("tr", "a-z", "A-Z")
	cmd.Stdin = strings.NewReader("some input")var out bytes.Buffer
	cmd.Stdout = &out
	err := cmd.Run()if err != nil {
		log.Fatal(err)}
	fmt.Printf("in all caps: %q\n", out.String())}

示例(环境)

package mainimport ("log""os""os/exec")func main() {
	cmd := exec.Command("prog")
	cmd.Env = append(os.Environ(),"FOO=duplicate_value", // ignored"FOO=actual_value",    // this value is used)if err := cmd.Run(); err != nil {
		log.Fatal(err)}}

func CommandContext

func CommandContext(ctx context.Context, name string, arg ...string) *Cmd

CommandContext 与 Command 相似,但包含一个上下文。

如果上下文在命令完成之前完成,则提供的上下文用于终止进程(通过调用 os.Process.Kill )。

package mainimport ("context""os/exec""time")func main() {
	ctx, cancel := context.WithTimeout(context.Background(), 100*time.Millisecond)
	defer cancel()if err := exec.CommandContext(ctx, "sleep", "5").Run(); err != nil {// This will fail after 100 milliseconds. The 5 second sleep// will be interrupted.}}

func (*Cmd) CombinedOutput

func (c *Cmd) CombinedOutput() ([]byte, error)

CombinedOutput 运行该命令并返回其组合标准输出和标准错误。

package mainimport ("fmt""log""os/exec")func main() {
	cmd := exec.Command("sh", "-c", "echo stdout; echo 1>&2 stderr")
	stdoutStderr, err := cmd.CombinedOutput()if err != nil {
		log.Fatal(err)}
	fmt.Printf("%s\n", stdoutStderr)}

func (*Cmd) Output

func (c *Cmd) Output() ([]byte, error)

输出运行该命令并返回其标准输出。任何返回的错误通常都是 * ExitError 类型。如果 c.Stderr 为零,则输出填充 ExitError.Stderr 。

package mainimport ("fmt""log""os/exec")func main() {
	out, err := exec.Command("date").Output()if err != nil {
		log.Fatal(err)}
	fmt.Printf("The date is %s\n", out)}

func (*Cmd) Run

func (c *Cmd) Run() error

运行开始指定的命令并等待它完成。

如果命令运行,则返回的错误为零,在复制 stdin,stdout 和 stderr 时没有问题,并以零退出状态退出。

如果该命令启动但未成功完成,则错误类型为 * ExitError 。其他错误类型可能会返回其他情况。

package mainimport ("log""os/exec")func main() {
	cmd := exec.Command("sleep", "1")
	log.Printf("Running command and waiting for it to finish...")
	err := cmd.Run()
	log.Printf("Command finished with error: %v", err)}

func (*Cmd) Start

func (c *Cmd) Start() error

开始启动指定的命令,但不等待它完成。

一旦命令退出,Wait 方法将返回退出代码并释放相关资源。

package mainimport ("log""os/exec")func main() {
	cmd := exec.Command("sleep", "5")
	err := cmd.Start()if err != nil {
		log.Fatal(err)}
	log.Printf("Waiting for command to finish...")
	err = cmd.Wait()
	log.Printf("Command finished with error: %v", err)}

func (*Cmd) StderrPipe

func (c *Cmd) StderrPipe() (io.ReadCloser, error)

当命令启动时,StderrPipe 将返回一个将连接到命令标准错误的管道。

等待会在看到命令退出后关闭管道,因此大多数呼叫者不需要关闭管道; 但是,含义是在从管道读取完成之前调用 Wait 是不正确的。出于同样的原因,在使用 StderrPipe 时使用 Run 是不正确的。查看 StdoutPipe 示例了解惯用用法。

package mainimport ("fmt""io/ioutil""log""os/exec")func main() {
	cmd := exec.Command("sh", "-c", "echo stdout; echo 1>&2 stderr")
	stderr, err := cmd.StderrPipe()if err != nil {
		log.Fatal(err)}if err := cmd.Start(); err != nil {
		log.Fatal(err)}

	slurp, _ := ioutil.ReadAll(stderr)
	fmt.Printf("%s\n", slurp)if err := cmd.Wait(); err != nil {
		log.Fatal(err)}}

func (*Cmd) StdinPipe

func (c *Cmd) StdinPipe() (io.WriteCloser, error)

当命令启动时,StdinPipe 返回一个将连接到命令标准输入的管道。在 Wait 看到命令退出后,管道将自动关闭。呼叫者只需调用 Close 即可更快地关闭管道。例如,如果正在运行的命令在标准输入关闭之前不会退出,则调用者必须关闭管道。

package mainimport ("fmt""io""log""os/exec")func main() {
	cmd := exec.Command("cat")
	stdin, err := cmd.StdinPipe()if err != nil {
		log.Fatal(err)}

	go func() {
		defer stdin.Close()
		io.WriteString(stdin, "values written to stdin are passed to cmd's standard input")}()

	out, err := cmd.CombinedOutput()if err != nil {
		log.Fatal(err)}

	fmt.Printf("%s\n", out)}

func (*Cmd) StdoutPipe

func (c *Cmd) StdoutPipe() (io.ReadCloser, error)

当命令启动时,StdoutPipe 返回一个将连接到命令标准输出的管道。

等待会在看到命令退出后关闭管道,因此大多数呼叫者不需要关闭管道; 但是,含义是在从管道读取完成之前调用 Wait 是不正确的。出于同样的原因,使用 StdoutPipe 时调用 Run 是不正确的。查看习惯用法的例子。

package mainimport ("encoding/json""fmt""log""os/exec")func main() {
	cmd := exec.Command("echo", "-n", `{"Name": "Bob", "Age": 32}`)
	stdout, err := cmd.StdoutPipe()if err != nil {
		log.Fatal(err)}if err := cmd.Start(); err != nil {
		log.Fatal(err)}var person struct {
		Name string
		Age  int}if err := json.NewDecoder(stdout).Decode(&person); err != nil {
		log.Fatal(err)}if err := cmd.Wait(); err != nil {
		log.Fatal(err)}
	fmt.Printf("%s is %d years old\n", person.Name, person.Age)}

func (*Cmd) Wait

func (c *Cmd) Wait() error

等待等待命令退出并等待任何复制到标准输入或从标准输出或标准错误复制完成。

该命令必须由 Start 启动。

如果命令运行,则返回的错误为零,在复制 stdin,stdout 和 stderr 时没有问题,并以零退出状态退出。

如果该命令无法运行或未成功完成,则错误类型为 * ExitError 。其他错误类型可能会返回 I/O 问题。

如果 c.Stdin 不是 * os.File,则 Wait 还会等待从 c.Stdin 复制到流程的标准输入的 I/O 循环完成。

等待释放与 Cmd 相关的任何资源。

type Error

错误记录了未能执行的二进制文件的名称及其失败的原因。

type Error struct {
        Name string
        Err  error}

func (*Error) Error

func (e *Error) Error() string

type ExitError

ExitError 通过命令报告不成功的退出。

type ExitError struct {        *os.ProcessState        // Stderr holds a subset of the standard error output from the        // Cmd.Output method if standard error was not otherwise being        // collected.        //        // If the error output is long, Stderr may contain only a prefix        // and suffix of the output, with the middle replaced with        // text about the number of omitted bytes.        //        // Stderr is provided for debugging, for inclusion in error messages.        // Users with other needs should redirect Cmd.Stderr as needed.
        Stderr []byte}

func (*ExitError) Error

func (e *ExitError) Error() string
上一篇: 下一篇: