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

NAME

       flockfile, ftrylockfile, funlockfile - 為標準輸入輸出鎖定檔案 FILE

SYNOPSIS`覽
       #include <stdio.h>

       void flockfile(FILE *filehandle);
       int ftrylockfile(FILE *filehandle);
       void funlockfile(FILE *filehandle);

DESCRIPTIONyz
       標準輸入輸出庫   stdio   函數是線程安全的。這是通過為每蚗仵袡龠H   FILE
       賦予一蚋磡wp數和     (當鎖定p數非零時)     一茤狾釭抻u程來實現的。對每-
       荇w函數調用,這些函數等待直到檔案對象           FILE          不再被一-
       茪ㄕP的線程鎖定,然後鎖定它,進行所需的 I/O 操作,再次對它解鎖。

       (注意:這蚋磡w與由函數 flock(2) 和 lockf(3) 實現的鎖定無關。)

       所有這些操作對       C       程式來說都是不可見的,但是有兩種理由,需-
       n進行更加細節的控制。其一,也閉Y蚑u程需n進行不可分割的一系列        I/O
       操作,不應當被其他線程的                                            I/O
       所終端。其二,出於效率因素,應當避免進行過多的鎖定來提高效率。

       為此,一蚑u程可以顯式地鎖定檔案對象     FILE,接著進行它的一系列    I/O
       操作,然後解鎖。這樣可以避免其他線程幹擾。如果這樣做的鴞]是需-
       n達到更高的效率,應當使用  stdio  函數的非鎖定版本來進行 I/O 操作:使用
       getc_unlocked() 和 putc_unlocked() 來代替 getc() 和 putc()。

       函數             flockfile()              等待              *filehandle
       不再被其他的線程鎖定,然後使當前線程成為                    *filehandle
       的所有者,然後增加鎖定p數 lockcount。

       函數 funlockfile() 減少鎖定p數。

       函數  ftrylockfile()flockfile()   的非鎖定版本。它在其他線程擁有
       *filehandle 時不做任何處理,否則取得所有權並增加鎖定p數。

RETURN VALUE^
       函數                 ftrylockfile()                 返回零,如果成左爾
       (獲得了鎖定);如果失敗就返回非零。

ERRORS

       無。

AVAILABILITY

       這些函數當定義了  _POSIX_THREAD_SAFE_FUNCTIONS  時可用。它怞s在於  libc
       5.1.1 之後的 libc 版本中,以及 glibc 2.0 之後的 glibc 版本中

CONFORMING TO考
       POSIX.1

SEE ALSO見
       unlocked_stdio(3)

                                  2001-10-18                       LOCKFILE(3)