EXECVE(2)

NAME
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 位.

另見 (SEE ALSO)
ld.so(8), execl(3), fork(2)

[中文版維護人]
徐明 <xuming@users.sourceforge.net>

[中文版最新更新]
2003/05/13

《中國Linux論壇man手冊頁翻譯計劃》
http://cmpp.linuxforum.net

跋
本頁面中文版由中文 man 手冊頁計劃提供。
中文 man 手冊頁計劃：https://github.com/man-pages-zh/manpages-zh