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