总览 (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 位.