golang中os/exec包用法


原文链接: golang中os/exec包用法

golang中os/exec包用法

exec包执行外部命令,它将os.StartProcess进行包装使得它更容易映射到stdin和stdout,并且利用pipe连接i/o.

func LookPath(file string) (string, error) //LookPath在环境变量中查找科执行二进制文件,如果file中包含一个斜杠,则直接根据绝对路径或者相对本目录的相对路径去查找

func main() {
    f, err := exec.LookPath("ls")
    if err != nil {
        fmt.Println(err)
    }
    fmt.Println(f) //  /bin/ls
}

type Cmd   //表示一个正在准备或者正在运行的外部命令

type Cmd struct {
    Path         string   //运行命令的路径,绝对路径或者相对路径
    Args         []string   // 命令参数
    Env          []string         //进程环境,如果环境为空,则使用当前进程的环境
    Dir          string   //指定command的工作目录,如果dir为空,则comman在调用进程所在当前目录中运行
    Stdin        io.Reader  //标准输入,如果stdin是nil的话,进程从null device中读取(os.DevNull),stdin也可以时一个文件,否则的话则在运行过程中再开一个goroutine去
             //读取标准输入
    Stdout       io.Writer       //标准输出
    Stderr       io.Writer  //错误输出,如果这两个(Stdout和Stderr)为空的话,则command运行时将响应的文件描述符连接到os.DevNull
    ExtraFiles   []*os.File   
    SysProcAttr  *syscall.SysProcAttr
    Process      *os.Process    //Process是底层进程,只启动一次
    ProcessState *os.ProcessState  //ProcessState包含一个退出进程的信息,当进程调用Wait或者Run时便会产生该信息.
}

func Command(name string, arg ...string) *Cmd    //command返回cmd结构来执行带有相关参数的命令,它仅仅设定cmd结构中的Path和Args参数,如果name参数中不包含路径分隔符,command使用LookPath来解决路径问题,否则的话就直接使用name;Args直接跟在command命令之后,所以在Args中不许要添加命令.

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())  //in all caps: "SOME INPUT"
}

func (c *Cmd) CombinedOutput() ([]byte, error) //运行命令,并返回标准输出和标准错误

func main() {
    cmd := exec.Command("ls")  //查看当前目录下文件
    out, err := cmd.CombinedOutput()
    if err != nil {
        fmt.Println(err)
    }
    fmt.Println(string(out))
}

func (c *Cmd) Output() ([]byte, error)     //运行命令并返回其标准输出

func main() {
    cmd := exec.Command("ls") ///查看当前目录下文件
    out, err := cmd.Output()
    if err != nil {
        fmt.Println(err)
    }
    fmt.Println(string(out))
}

注意:Output()和CombinedOutput()不能够同时使用,因为command的标准输出只能有一个,同时使用的话便会定义了两个,便会报错
func (c *Cmd) Run() error          //开始指定命令并且等待他执行结束,如果命令能够成功执行完毕,则返回nil,否则的话边会产生错误
func (c *Cmd) Start() error          //使某个命令开始执行,但是并不等到他执行结束,这点和Run命令有区别.然后使用Wait方法等待命令执行完毕并且释放响应的资源

func main() {
    cmd := exec.Command("ls")
    cmd.Stdout = os.Stdout //
    cmd.Run()
    fmt.Println(cmd.Start()) //exec: already started
}

注:一个command只能使用Start()或者Run()中的一个启动命令,不能两个同时使用.
func (c *Cmd) StderrPipe() (io.ReadCloser, error)  //StderrPipe返回一个pipe,这个管道连接到command的标准错误,当command命令退出时,Wait将关闭这些pipe
func (c *Cmd) StdinPipe() (io.WriteCloser, error)   //StdinPipe返回一个连接到command标准输入的管道pipe

package main

import (
    "fmt"
    "os"
    "os/exec"
)

func main() {
    cmd := exec.Command("cat")
    stdin, err := cmd.StdinPipe()
    if err != nil {
        fmt.Println(err)
    }
    _, err = stdin.Write([]byte("tmp.txt"))
    if err != nil {
        fmt.Println(err)
    }
    stdin.Close()
    cmd.Stdout = os.Stdout     //终端标准输出tmp.txt
    cmd.Start()
}

func (c *Cmd) StdoutPipe() (io.ReadCloser, error)        //StdoutPipe返回一个连接到command标准输出的管道pipe

func main() {
    cmd := exec.Command("ls")
    stdout, err := cmd.StdoutPipe()  //指向cmd命令的stdout
    cmd.Start()
    content, err := ioutil.ReadAll(stdout)
    if err != nil {
        fmt.Println(err)
    }
    fmt.Println(string(content))     //输出ls命令查看到的内容
}

func (c *Cmd) Wait() error             //Wait等待command退出,他必须和Start一起使用,如果命令能够顺利执行完并顺利退出则返回nil,否则的话便会返回error,其中Wait会是放掉所有与cmd命令相关的资源

type Error    //Error返回科执行二进制文件名字不能够执行的原因的错误

type Error struct {
    Name string
    Err  error
}

func (e *Error) Error() string

type ExitError  //一个command不能够正常退出的error

type ExitError struct {
    *os.ProcessState
}

func (e *ExitError) Error() string

参考:http://golang.org/pkg/os/exec/#pkg-variables

`