open() - Unix，Linux系統呼叫

名稱

概要

#include <sys/types.h> 
#include <sys/stat.h> 
#include <fcntl.h> 

int open(const char *pathname, int flags); 
int open(const char *pathname, int flags, mode_t mode); 
int creat(const char *pathname, mode_t mode); 

描述

新的檔案描述符設定為在 execve(2) 中保持開啟狀態（即，fcntl(2) 中描述的 FD_CLOEXEC 檔案描述符標誌最初被停用）。檔案偏移量設定為檔案的開頭（參見 lseek(2)）。

呼叫 open() 會建立一個新的開啟的檔案描述，這是系統範圍內開啟檔案表中的一個條目。此條目記錄檔案偏移量和檔案狀態標誌（可透過 fcntl() F_SETFL 操作進行修改）。檔案描述符是對這些條目之一的引用；如果隨後刪除路徑名或將其修改為引用不同的檔案，則此引用不受影響。新的開啟的檔案描述最初不與任何其他程序共享，但可以透過 fork(2) 實現共享。

引數flags必須包含以下訪問模式之一：O_RDONLY、O_WRONLY 或 O_RDWR。這些分別請求以只讀、只寫或讀寫方式開啟檔案。

此外，零個或多個檔案建立標誌和檔案狀態標誌可以按位或在flags中。檔案建立標誌是 O_CREAT、O_EXCL、O_NOCTTY 和 O_TRUNC。檔案狀態標誌是下面列出的所有其餘標誌。這兩組標誌的區別在於，可以使用 fcntl(2) 檢索和（在某些情況下）修改檔案狀態標誌。檔案建立標誌和檔案狀態標誌的完整列表如下所示

creat() 等效於 open()，其中flags等於 O_CREAT|O_WRONLY|O_TRUNC。

返回值

備註

在啟用了 UID 對映的 NFS 檔案系統上，open() 可能會返回檔案描述符，但例如 read(2) 請求會被 EACCES 拒絕。這是因為客戶端透過檢查許可權來執行 open()，但 UID 對映是在讀取和寫入請求時由伺服器執行的。

如果檔案是新建立的，則其st_atime、st_ctime、st_mtime欄位（分別為上次訪問時間、上次狀態更改時間和上次修改時間；參見stat(2)）將設定為當前時間，其父目錄的st_ctime和st_mtime欄位也是如此。否則，如果由於O_TRUNC標誌修改了檔案，則其st_ctime和st_mtime欄位將設定為當前時間。

錯誤

注意

符合標準

O_RDONLY | O_TRUNC的（未定義的）效果在不同的實現中有所不同。在許多系統上，檔案實際上會被截斷。

O_DIRECT標誌是在SGI IRIX中引入的，它具有與Linux 2.4類似的對齊限制。IRIX還有一個fcntl(2)呼叫來查詢適當的對齊方式和大小。FreeBSD 4.x引入了相同名稱的標誌，但沒有對齊限制。Linux核心版本2.4.10中添加了對它的支援。較舊的Linux核心會忽略此標誌。可能需要定義_GNU_SOURCE宏才能獲得它的定義。

錯誤

當前，呼叫open()時無法透過指定O_ASYNC來啟用訊號驅動的I/O；使用fcntl(2)來啟用此標誌。

限制

POSIX提供了三種不同型別的同步I/O，分別對應於標誌O_SYNC、O_DSYNC和O_RSYNC。目前（2.1.130）在Linux下它們都是同義詞。

參見

• close (2)

• dup (2)

• fcntl (2)

• link (2)

• lseek (2)

• mknod (2)

• mount (2)

• mmap (2)

• openat (2)

• path_resolution (2)

• read (2)

• socket (2)

• stat (2)

• umask (2)

• unlink (2)

• write (2)