execve - 执行程序

总览 (SYNOPSIS)

#include <unistd.h>

int execve (const char *filename, char *const argv [], char *const envp[]);

描述 (DESCRIPTION)

execve() 执行 filename 指出的程序. filename 必须是二进制可执行文件, 或者以 "#! interpreter [arg]" 行开始的脚本文件. 后者的 interpreter 必须是某个可执行文件的有效路径, 这个可执行文件自身不能是脚本程序, 调用形式是 "interpreter [arg] filename".

execve() 调用成功后不会返回, 其进程的正文(text), 数据(data), bss 和堆栈(stack) 段被调入程序覆盖. 调入程序继承了调用程序的 PID 和所有打开的文件描述符, 他们不会因为 exec 过程而关闭. 父进程的未决信号被清除. 所有被调用进程设置过的信号重置为缺省行为.

如果当前程序正在被 ptrace 跟踪, 成功的调用 execve() 后将收到一个 SIGTRAP 信号.

如果可执行文件是动态连接的 a.out 二进制程序, 含有共享库的 stub, 开始执行程序的时候, Linux 动态连接器(linker) ld.so(8) 把所需的共享库调入核心, 并且和程序相连.

如果可执行文件是动态连接的 ELF 二进制程序, 定义在 PT_INTERP 字段的解释器(interpreter) 调入所需的共享库. 连接 libc5 的程序的典型解释器是 /lib/ld-linux.so.1, 而连接 GNU libc2 (libc6) 的程序则为 /lib/ld-linux.so.2.

返回值 (RETURN VALUE)

调用成功的时候 execve() 不会返回, 调用失败时返回 -1, 并设置 errno 为相应的值.

错误 (ERRORS)

EACCES: 文件或脚本解释器不正确.
EACCES: 没有文件或脚本解释器的执行权限.
EACCES: 文件系统挂载(mount) 为 noexec.
EPERM: 文件系统挂载为 nosuid, 使用者不是超级用户, 以及文件设置了 SUID 或 SGID 位.
EPERM: 进程正被跟踪, 使用者不是超级用户, 以及文件设置了 SUID 或 SGID 位.
E2BIG: 参数列表过长.
ENOEXEC: 可执行文件的文件格式无法识别, 误用在不同的体系结构, 或者其他格式错误导致程序无法执行.
EFAULT: filename 指针超出可访问的地址空间.
ENAMETOOLONG: filename 太长.
ENOENT: filename , 脚本解释器, 或 ELF 解释器不存在.
ENOMEM: 内核空间不足.
ENOTDIR: 在 filename , 脚本解释器或 ELF 解释器的前缀路径中, 某些成员不是目录.
EACCES: 在 filename 或脚本解释器的前缀路径中, 对某些目录没有访问许可.
ELOOP: 解析 filename , 脚本解释器或 ELF 解释器时遇到过多的符号连接.
ETXTBUSY: 可执行文件被一个或多个进程以写方式打开.
EIO: 发生 I/O 错误.
ENFILE: 达到系统定义的同时打开文件数限制.
EMFILE: 进程打开了最大数量的文件.
EINVAL: 该 ELF 可执行文件拥有多个 PT_INTERP 字段 (就是说, 试图定义多个解释器).
EISDIR: ELF 解释器是目录.
ELIBBAD: 无法识别 ELF 解释器的格式.

CONFORMING TO

SVr4, SVID, X/OPEN, BSD 4.3. POSIX 没有对 #! 行为的文档, 但有其他的兼容形式. SVr4 记录了额外的错误情况 EAGAIN, EINTR, ELIBACC, ENOLINK, EMULTIHOP; POSIX 没有关于 ETXTBSY, EPERM, EFAULT, ELOOP, EIO, ENFILE, EMFILE, EINVAL, EISDIR 或 ELIBBAD 错误情况的文档.

注意 (NOTES)

SUID and SGID processes can not be ptrace()d SUID or SGID.

在 #! 格式的 shell 可执行脚本中, 第一行的长度不得超过 127 字节.

Linux 忽略脚本程序的 SUID 和 SGID 位.