Provided by: manpages-zh_1.5.2-1_all bug

NAME

       open, creat - 用來 打開和創建 一個 檔案或設備

SYNOPSIS 總覽

       #includ e <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);

描述 (DESCRIPTION)

       open()  通常 用於 將 路徑名 轉換為 一個 檔案描述符 (一個 非負的 小 整數, 在 read  ,  write
       等 I/O操作中 將會被使用). 當 open() 調用 成功, 它會 返回 一個 新的 檔案描述符 (永遠取 未用
       描述符的  最小值).   這個調用  創建  一個  新的  打開檔案,  即  分配 一個 新的 獨一無 二的
       檔案描述符, 不會與 運行中的 任何 其他程式 共享 (但 可以 通過 fork (2) 系統調用 實現 共享).
       這個  新的  檔案描述符 在其後 對 打開檔案操作 的函數 中 使用.(參考 fcntl(2)).  檔案的 讀寫
       指針 被 置於 檔案頭

       參數 flags 是通過 O_RDONLY, O_WRONLYO_RDWR (指明 檔案 是以 只讀 , 只寫  或  讀寫  方式
       打開的) 與 下面的 零個 或 多個 可選模式 按位 -or 操作 得到的:

       O_CREAT
              若檔案  不存在 將 創建 一個 新 檔案.  新 檔案 的 屬主 (使用者ID) 被 設置 為 此 程式
              的 有效 使用者 的 ID.  同樣 檔案 所屬 分組 也 被 設置 為 此 程式 的 有效 分組 的 ID
              或者  上層  目錄  的  分組 ID (這 依賴 檔案系統 類型 ,裝載選項 和 上層目錄 的 模式,
              參考,在 mount(8) 中 描述 的 ext2 檔案系統 的 裝載選項 bsdgroupssysvgroups )

       O_EXCL 通過 O_CREAT, 生成 檔案 , 若 檔案 已經 存在 , 則 open 出錯 , 調用 失敗 . 若是  存在
              符號聯接  ,  將會 把 它的 聯接指針 的 指向 檔案 忽略.  O_EXCL is broken on NFS file
              systems, programs which rely on it for performing locking tasks will contain a race
              condition.   The solution for performing atomic file locking using a lockfile is to
              create a unique file on the same fs (e.g., incorporating  hostname  and  pid),  use
              link(2)  to  make  a  link  to  the  lockfile.  If  link()  returns  0, the lock is
              successful.  Otherwise, use stat(2) on the unique file to check if its  link  count
              has increased to 2, in which case the lock is also successful.

       O_NOCTTY
              假如 pathname 引用 一個 終端設備 — 參考 tty(4) — 即使 進程 沒有 控制終端 ,這個 終端
              也 不會 變成 進程 的 控制 終端.

       O_TRUNC
              假如 檔案 已經 存在 , 且是 一個 普通 檔案 ,打開 模式 又是 可寫(即 檔案 是 用 O_RDWR
              或  O_WRONLY  模式  打開  的)  ,  就把  檔案 的 長度 設置 為 零 , 丟棄 其中 的 現有
              內容.若 檔案 是 一個 FIFO 或 終端設備 檔案 , O_TRUNC 標誌 被 忽略.  其他 O_TRUNC 的
              作用  是  不  具體  指定 的 (在 許多 Linux 版本 中 , 通常 會 被 忽略 , 其他 的 一些
              版本 將 返回 一個 錯誤)

       O_APPEND
              檔案 以 追加 模式 打開 . 在  以前 , 檔案 讀寫 指針 被 置 在 檔案 的 末尾 .  as if
              with  lseek.  O_APPEND may lead to corrupted files on NFS file systems if more than
              one process appends data to a file at once.  This is because NFS does  not  support
              appending  to  a file, so the client kernel has to simulate it, which can't be done
              without a race condition.

       O_NONBLOCKO_NDELAY
              打開(open) 檔案 可以 以 非塊(non-blocking) 模式 打開 . 此時 檔案 並 沒有 打開 ,  也
              不能  使用  返回 的 檔案描述符 進行 後續 操作 , 而是 使 調用 程式 等待 . 此 模式 是
              為了 FIFO (命名管道) 的 處理 , 參考 fifo(4).  這種 模式 對 除了 FIFO 外  沒有  任何
              影響 .

       O_SYNC 打開  檔案 實現 I/O 的 同步 . 任何 通過 檔案描述符 對 檔案 的 write 都會 使 調用 的
              進程 中斷 , 直到 數據 被 真正 寫入 硬體 中 .  其他 , 參考 RESTRICTIONS.

       O_NOFOLLOW
              假如 pathname 是 一個 符號 聯接 , 則 打開 失敗 . 這是 FreeBSD 的 擴充 , 從  2.1.126
              版本 以來 被 引入 到 Linux 中來 .  從 glibc2.0.100 庫 以來 , 頭檔案 中 包括 了 這個
              參數 的 定義;
                kernel 2.1.126 以前  忽略 它的 使用.

       O_DIRECTORY
              假如 pathname 不是 目錄 , 打開 就 失敗 . 這個 參數 是 Linux 特有  的  ,  在  kernel
              2.1.126 中 加入 , 為了 避免 在 調用 FIFO 或 磁帶設備 時 的 denial-of-service 問題 ,
              但是 不應該 在 執行 opendir 以外 使用.

       O_LARGEFILE
              在 32位 系統 中 支持 大 檔案系統 , 允許 打開 那些 用 31位 都 不能 表示 其  長度  的
              大 檔案 .

       在 檔案 打開 後 , 這些 可選 參數 可以 通過 fcntl 來 改變 .

       在  新檔案  被  創建 時 , 參數 mode 具體 指明 了 使用 權限 . 他 通常 也 會 被 umask 修改 .
       所以 一般 新建 檔案 的 權限 為 (mode & ~umask).  注意 模式 只 被 應用 於 將來 對 這 新檔案
       的 使用 中; open 調用 創建 一個 新的 只讀 檔案 , 但 仍 將 返回 一個 可 讀寫 檔案 描述符.

       後面 是 一些 mode 的 具體 參數:

       S_IRWXU
              00700 允許 檔案 的 屬主 讀 , 寫 和 執行 檔案

       S_IRUSR (S_IREAD)
              00400 允許 檔案 的 屬主 讀 檔案

       S_IWUSR (S_IWRITE)
              00200 允許 檔案 的 屬主 寫 檔案

       S_IXUSR (S_IEXEC)
              00100 允許 檔案 的 屬主 執行 檔案

       S_IRWXG
              00070 允許 檔案 所在 的 分組 讀 , 寫 和 執行 檔案

       S_IRGRP
              00040 允許 檔案 所在 的 分組 讀 檔案

       S_IWGRP
              00020 允許 檔案 所在 的 分組 寫 檔案

       S_IXGRP
              00010 允許 檔案 所在 的 分組 執行 檔案

       S_IRWXO
              00007 允許 其他 使用者 讀 , 寫 和 執行 檔案

       S_IROTH
              00004 允許 其他 使用者 讀 檔案

       S_IWOTH
              00002 允許 其他 使用者 寫 檔案

       S_IXOTH
              00001 允許 其他 使用者 執行 檔案

       mode 只有 當 在 flags 中 使用 O_CREAT 時 才 有效 , 否則 被 忽略.

       creat 相當 於 open 的 參數 flags 等於 O_CREAT|O_WRONLY|O_TRUNC.

RETURN VALUE 返回值

       opencreat  都  返回 一個 新的 檔案描述符 (若是 有 錯誤 發生 返回 -1 ,並在 errno 設置
       錯誤 信息).  注意 open 可以 打開 設備 專用 檔案  ,  但是  creat  不能創建,需要用  mknod(2)
       來代替.

       On  NFS  file systems with UID mapping enabled, open may return a file descriptor but e.g.
       read(2) requests are denied with EACCES.  This is because  the  client  performs  open  by
       checking  the  permissions, but UID mapping is performed by the server upon read and write
       requests.

       若 檔案 是 新 建立 的 , 他 的 atime(上次訪問時間), ctime(創建時間), mtime(修改時間) 都  被
       修改  為  當前 時間 , 上層 目錄 的atime , ctime 也 被 同樣 修改 . 其他的 , 假如 檔案 是 由
       O_TRUNC 參數 修改 的 ,它的 ctime , mtime 域 也 被 設置 為 當前 時間.

ERRORS 錯誤訊息

       EEXIST 參數 O_CREAT and O_EXCL 被 使用,但是檔案( pathname )已經存在.

       EISDIR 檔名 ( pathname ) 是 一個 目錄 , 而 又 涉及 到 寫 操作.

       EACCES
               訪問 請求 不 允許 (權限不夠) , 在 檔名 ( pathname )中 有 一 目錄 不允許 搜索 (沒有
              執行權限) , 或者 檔案 還 不存在 且 對 上層目錄 的 寫 操作 又 不允許.

       ENAMETOOLONG
              檔名 ( pathname ) 太 長 了

       ENOENT 目錄 ( pathname ) 不存在 或者 是 一個 懸空 的 符號 聯接.

       ENOTDIR
              pathname 不是 一個 子目錄

       ENXIO  使用 O_NONBLOCK | O_WRONLY, 命名 的 檔案 是 FIFO , 所讀 檔案 還 沒有 打開 的 檔案 ,
              或者 , 打開 一個 設備 專用 檔案 而 相應 的 設備 不存在

       ENODEV 檔案 ( pathname ) 引用 了 一個 設備 專用 檔案 , 而 相應 的 設備 又  不存在.   (這是
              linux kernel 的 一個bug - ENXIO 一定 會 被 返回 .)

       EROFS  檔案 ( pathname ) 是 一個 只讀 檔案 , 又有 寫 操作 被 請求.

       ETXTBSY
              檔案 ( pathname ) 是 一個 正在 被 執行 的 可 執行 檔案 ,又有 寫 操作 被 請求.

       EFAULT pathname 在一個你不能訪問的地址空間.

       ELOOP  在 分解 pathname 時 , 遇到 太多 符號聯接 或者 指明 O_NOFOLLOW 但是 pathname 是 一個
              符號聯接

       ENOSPC pathname 將要被創建,但是設備又沒有空間儲存 pathname 檔案了

       ENOMEM 可 獲得 的 核心記憶體(kernel memory) 不夠

       EMFILE 程式打開的檔案數已經達到最大值了

       ENFILE 系統打開的總檔案數已經達到了極限

CONFORMING TO

       SVr4, SVID, POSIX, X/OPEN, BSD  4.3  The  O_NOFOLLOW  and  O_DIRECTORY  flags  are  Linux-
       specific.  One may have to define the _GNU_SOURCE macro to get their definitions.

RESTRICTIONS 無限制

       There  are  many  infelicities  in  the  protocol underlying NFS, affecting amongst others
       O_SYNC and O_NDELAY.

       POSIX provides for three different variants of  synchronised  I/O,  corresponding  to  the
       flags  O_SYNC,  O_DSYNC  and  O_RSYNC.  Currently (2.1.130) these are all synonymous under
       Linux.

SEE ALSO 參見

       read(2), write(2), fcntl(2), close(2), link(2),  mknod(2),  mount(2),  stat(2),  umask(2),
       unlink(2), socket(2), fopen(3), fifo(4)

[中文版維護人]

       Daniel <badlong@163.com>

[中文版最新更新]

       2002/01/10

《中國linux論壇man手冊頁翻譯計劃》:

       http://cmpp.linuxforum.net