Provided by: manpages-zh_1.5.1-2_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);

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

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

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

       O_EXCL 通過 O_CREAT, 生成 檔案 , Y 檔案 已經 存在 , 則 open 出錯 , 調用
              失敗  .  Y是  存在 符號聯接 , 將會 把 它的 聯接指針 的 指向 檔案
              忽略.  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 模式 打開 的) , 就把 檔案 的  長度
              設置  為  零  ,  丟棄  其中  的  現有 內容.Y 檔案 是 一 FIFO 或
              終端設備 檔案 , O_TRUNC 標誌 被 忽略.  其他 O_TRUNC 的  作用  是
              不  具體  指定 的 (在 釵h Linux 版本 中 , 通常 會 被 忽略 , 其他
              的 一些 版本 將 返回 一 錯誤)

       O_APPEND
              檔案 以 追加 模式 打開 . 在g 以前 , 檔案 讀寫 指針  被  置  在
              檔案  的  末尾  .   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) 模式 打開 . 此時 檔案
              並 沒有 打開 , 也 不能 使用 返回 的 檔案描z符 進行 後續  操作  ,
              而是 使 調用 程式 等待 . 此 模式 是 為了 FIFO (命名管道) 的 處理
              , 參考 fifo(4).  這種 模式 對 除了 FIFO 外 沒有 任何 影響 .

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

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

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

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

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

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

       後 是 一些 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  都  返回  一 新的 檔案描z符 (Y是 有 錯誤 發生 返回 -1
       ,並在 errno 設置 錯誤 信息).  注意 open 可以 打開 設備 專用 檔案 , 但是
       creat 不能創建,需n用 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.

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

ERRORS~T息
       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 的 一羒ug - ENXIO 一定 會 被 返回
              .)

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

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

       EFAULT pathname 在一荍A不能訪問的地址空間.

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

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

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

       EMFILE 程式打開的檔案數已經達到最大F

       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.

RESTRICTIONSL制
       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

mlinuxan:
       http://cmpp.linuxforum.net