C++中fcntl.h函數(shù)說明說明書

1/1C++中fcntl.h函數(shù)說明-說明書

C++

close（關閉文件）

相關函數(shù)open，fcntl，shutdown，unlink，fclose

表頭文件#includeunistd.h

定義函數(shù)intclose(intfd);

函數(shù)說明當使用完文件后若已不再需要則可使用close關閉該文件，二close會讓數(shù)據(jù)寫回磁盤，并釋放該文件所占用的資源。參數(shù)fd為從前由open或creat所返回的文件描述詞。

返回值若文件順當關閉則返回0，發(fā)生錯誤時返回-1。

錯誤代碼EBADF參數(shù)fd非有效的文件描述詞或該文件已關閉。

附加說明雖然在進程結束時，系統(tǒng)會自動關閉已打開的文件，但仍建議自行關閉文件，并的確檢查返回值。

范例參考open

creat（建立文件）

相關函數(shù)read，write，fcntl，close，link，stat，umask，unlink，fopen

表頭文件#includesys/types.h

#includesys/stat.h

#includefcntl.h

定義函數(shù)intcreat(constchar*pathname,mode_tmode);

函數(shù)說明參數(shù)pathname指向欲建立的文件路徑字符串。Creat相當于使用下列的調(diào)用方式調(diào)用open

open(constchar*pathname,(O_CREAT|O_WRONLY|O_TRUNC));

錯誤代碼關于參數(shù)mode請參考open函數(shù)。

返回值creat會返回新的文件描述詞，若有錯誤發(fā)生則會返回-1，并把錯誤代碼設給errno。

C++

EEXIST參數(shù)pathname所指的文件已存在。

EACCESS參數(shù)pathname所指定的文件不符合所要求測試的權限

EROFS欲打開寫入權限的文件存在于只讀文件系統(tǒng)內(nèi)

EFAULT參數(shù)pathname指針超出可存取的內(nèi)存空間

EINVAL參數(shù)mode不正確。

ENAMETOOLONG參數(shù)pathname太長。

ENOTDIR參數(shù)pathname為一名目

ENOMEM核心內(nèi)存不足

ELOOP參數(shù)pathname有過多符號連接問題。

EMFILE已達到進程可同時打開的文件數(shù)上限

ENFILE已達到系統(tǒng)可同時打開的文件數(shù)上限

附加說明creat無法建立特殊的裝置文件，假如需要請使用mknod。

范例請參考open。

dup（復制文件描述詞）

相關函數(shù)open，close，fcntl，dup2

表頭文件#includeunistd.h

定義函數(shù)intdup(intoldfd);

函數(shù)說明dup用來復制參數(shù)oldfd所指的文件描述詞，并將它返回。此新的文件描述詞和參數(shù)oldfd指的是同一個文件，共享全部的鎖定、讀寫位置和各項權限或旗標。例如，當利用lseek對某個文件描述詞作用時，另一個文件描述詞的讀寫位置也會隨著轉變。不過，文件描述詞之間并不共享close-on-exec旗標。

返回值當復制勝利時，則返回最小及尚未使用的文件描述詞。若有錯誤則返回-1，errno會存放錯誤代碼。錯誤代碼EBADF參數(shù)fd非有效的文件描述詞，或該文件已關閉。

dup2（復制文件描述詞）

C++

相關函數(shù)open，close，fcntl，dup

表頭文件#includeunistd.h

定義函數(shù)intdup2(intodlfd,intnewfd);

函數(shù)說明dup2用來復制參數(shù)oldfd所指的文件描述詞，并將它拷貝至參數(shù)newfd后一塊返回。若參數(shù)newfd為一已打開的文件描述詞，則newfd所指的文件會先被關閉。dup2所復制的文件描述詞，與原來的文件描述詞共享各種文件狀態(tài)，詳情可參考dup。

返回值當復制勝利時，則返回最小及尚未使用的文件描述詞。若有錯誤則返回-1，errno會存放錯誤代碼。

附加說明dup2相當于調(diào)用fcntl(oldfd，F(xiàn)_DUPFD，newfd)；請參考fcntl。

錯誤代碼EBADF參數(shù)fd非有效的文件描述詞，或該文件已關閉

fcntl（文件描述詞操作）

相關函數(shù)open，flock

表頭文件#includeunistd.h

#includefcntl.h

定義函數(shù)intfcntl(intfd,intcmd);

intfcntl(intfd,intcmd,longarg);

intfcntl(intfd,intcmd,structflock*lock);

函數(shù)說明fcntl用來操作文件描述詞的一些特性。參數(shù)fd代表欲設置的文件描述詞，參數(shù)cmd代表欲操作的指令。

有以下幾種狀況:

F_DUPFD用來查找大于或等于參數(shù)arg的最小且仍未使用的文件描述詞，并且復制參數(shù)fd的文件描述詞。執(zhí)行勝利則返回新復制的文件描述詞。請參考dup2。F_GETFD取得close-on-exec旗標。若此旗標的FD_CLOEXEC位為0，代表在調(diào)用exec相關函數(shù)時文件將不會關閉。

F_SETFD設置close-on-exec旗標。該旗標以參數(shù)arg的FD_CLOEXEC位打算。F_GETFL取得文件描述詞狀態(tài)旗標，此旗標為open的參數(shù)flags。

C++

F_SETFL設置文件描述詞狀態(tài)旗標，參數(shù)arg為新旗標，但只允許O_APPEND、O_NONBLOCK和O_ASYNC位的轉變，其他位的轉變將不受影響。

F_GETLK取得文件鎖定的狀態(tài)。

F_SETLK設置文件鎖定的狀態(tài)。此時flcok結構的l_type值必需是F_RDLCK、F_WRLCK或F_UNLCK。假如無法建立鎖定，則返回-1，錯誤代碼為EACCES或EAGAIN。

F_SETLKWF_SETLK作用相同，但是無法建立鎖定時，此調(diào)用會始終等到鎖定動作勝利為止。若在等待鎖定的過程中被信號中斷時，會馬上返回-1，錯誤代碼為EINTR。參數(shù)lock指針為flock結構指針，定義如下

structflcok

{

shortintl_type;/*鎖定的狀態(tài)*/

shortintl_whence;/*打算l_start位置*/

off_tl_start;/*鎖定區(qū)域的開頭位置*/

off_tl_len;/*鎖定區(qū)域的大小*/

pid_tl_pid;/*鎖定動作的進程*/

};

l_type有三種狀態(tài):

F_RDLCK建立一個供讀取用的鎖定

F_WRLCK建立一個供寫入用的鎖定

F_UNLCK刪除之前建立的鎖定

l_whence也有三種方式:

SEEK_SET以文件開頭為鎖定的起始位置。

SEEK_CUR以目前文件讀寫位置為鎖定的起始位置

SEEK_END以文件結尾為鎖定的起始位置。

返回值勝利則返回0，若有錯誤則返回-1，錯誤緣由存于errno.

flock（鎖定文件或解除鎖定）

相關函數(shù)open,fcntl

表頭文件#includesys/file.h

定義函數(shù)intflock(intfd,intoperation);

函數(shù)說明flock會依參數(shù)operation所指定的方式對參數(shù)fd所指的文件做各種鎖定或解除鎖定的動作。此函數(shù)只能鎖定整個文件，無法鎖定文件的某一區(qū)域。

C++

參數(shù)operation有下列四種狀況:

LOCK_SH建立共享鎖定。多個進程可同時對同一個文件作共享鎖定。

LOCK_EX建立互斥鎖定。一個文件同時只有一個互斥鎖定。

LOCK_UN解除文件鎖定狀態(tài)。

LOCK_NB無法建立鎖定時，此操作可不被阻斷，立刻返回進程。通常與LOCK_SH或LOCK_EX做OR(|)組合。

單一文件無法同時建立共享鎖定和互斥鎖定，而當使用dup或fork時文件描述詞不會繼承此種鎖定。

返回值返回0表示勝利，若有錯誤則返回-1，錯誤代碼存于errno。

fsync（將緩沖區(qū)數(shù)據(jù)寫回磁盤）

相關函數(shù)sync

表頭文件#includeunistd.h

定義函數(shù)intfsync(intfd);

函數(shù)說明fsync負責將參數(shù)fd所指的文件數(shù)據(jù)，由系統(tǒng)緩沖區(qū)寫回磁盤，以確保數(shù)據(jù)同步。

返回值勝利則返回0，失敗返回-1，errno為錯誤代碼。

lseek（移動文件的讀寫位置）

相關函數(shù)dup，open，fseek

表頭文件#includesys/types.h

#includeunistd.h

定義函數(shù)off_tlseek(intfildes,off_toffset,intwhence);

C++

函數(shù)說明每一個已打開的文件都有一個讀寫位置，當打開文件時通常其讀寫位置是指向文件開頭，若是以附加的方式打開文件(如O_APPEND)，則讀寫位置會指向文件尾。當read或write時，讀寫位置會隨之增加，lseek便是用來掌握該文件的讀寫位置。參數(shù)fildes為已打開的文件描述詞，參數(shù)offset為依據(jù)參數(shù)whence來移動讀寫位置的位移數(shù)。

參數(shù)whence為下列其中一種:

SEEK_SET參數(shù)offset即為新的讀寫位置。

SEEK_CUR以目前的讀寫位置往后增加offset個位移量。

SEEK_END將讀寫位置指向文件尾后再增加offset個位移量。

當whence值為SEEK_CUR或SEEK_END時，參數(shù)offet允許負值的消失。

下列是教特殊的使用方式:

1)欲將讀寫位置移到文件開頭時:lseek（intfildes,0,SEEK_SET）；

2)欲將讀寫位置移到文件尾時:lseek（intfildes，0,SEEK_END）；

3)想要取得目前文件位置時:lseek（intfildes，0,SEEK_CUR）；

返回值當調(diào)用勝利時則返回目前的讀寫位置，也就是距離文件開頭多少個字節(jié)。若有錯誤則返回-1，errno會存放錯誤代碼。

附加說明Linux系統(tǒng)不允許lseek對tty裝置作用，此項動作會令lseek返回ESPIPE。

范例參考本函數(shù)說明

mkstemp（建立唯一的臨時文件）

相關函數(shù)mktemp

表頭文件#includestdlib.h

定義函數(shù)intmkstemp(char*template);

函數(shù)說明mkstemp用來建立唯一的臨時文件。參數(shù)template所指的文件名稱字符串中最終六個字符必需是XXXXXX。Mkstemp會以可讀寫模式和0600權限來打開該文件，假如該文件不存在則會建立該文件。打開該文件后其文件描述詞會返回。文件順當打開后返回可讀寫的文件描述詞。若果文件打開失敗則返回NULL，并把錯誤代碼存在errno中。

錯誤代碼EINVAL參數(shù)template字符串最終六個字符非XXXXXX。EEXIST無法建立臨時文件。

C++

附加說明參數(shù)template所指的文件名稱字符串必需聲明為數(shù)組，如:

chartemplate[]=”template-XXXXXX”;

千萬不行以使用下列的表達方式

char*template=“template-XXXXXX”;

范例#includestdlib.h

main()

{

intfd;

chartemplate[]=”template-XXXXXX”;

fd=mkstemp(template);

printf(“template=%s\n”,template);

close(fd);

}

執(zhí)行template=template-lgZcbo

open（打開文件）

相關函數(shù)read，write，fcntl，close，link，stat，umask，unlink，fopen

表頭文件#includesys/types.h

#includesys/stat.h

#includefcntl.h

定義函數(shù)intopen(constchar*pathname,intflags);

intopen(constchar*pathname,intflags,mode_tmode);

函數(shù)說明參數(shù)pathname指向欲打開的文件路徑字符串。下列是參數(shù)flags所能使用的旗標:

O_RDONLY以只讀方式打開文件

O_WRONLY以只寫方式打開文件

O_RDWR以可讀寫方式打開文件。上述三種旗標是互斥的，也就是不行同時使用，但可與下列的旗標利用OR(|)運算符組合。

O_CREAT若欲打開的文件不存在則自動建立該文件。

O_EXCL假如O_CREAT也被設置，此指令會去檢查文件是否存在。文件若不存在則建立該文件，否則將導致打開文件錯誤。此外，若O_CREAT與O_EXCL同時設置，并且欲打開的文件為符號連接，則會打開文件失敗。

C++

O_NOCTTY假如欲打開的文件為終端機設備時，則不會將該終端機當成進程掌握終端機。O_TRUNC若文件存在并且以可寫的方式打開時，此旗標會令文件長度清為0，而原來存于該文件的資料也會消逝。

O_APPEND當讀寫文件時會從文件尾開頭移動，也就是所寫入的數(shù)據(jù)會以附加的方式加入到文件后面。

O_NONBLOCK以不行阻斷的方式打開文件，也就是無論有很多據(jù)讀取或等待，都會馬上返回進程之中。

O_NDELAY同O_NONBLOCK。

O_SYNC以同步的方式打開文件。

O_NOFOLLOW假如參數(shù)pathname所指的文件為一符號連接，則會令打開文件失敗。O_DIRECTORY假如參數(shù)pathname所指的文件并非為一名目，則會令打開文件失敗。此為Linux2.2以后特有的旗標，以避開一些系統(tǒng)平安問題。參數(shù)mode則有下列數(shù)種組合，只有在建立新文件時才會生效，此外真正建文件時的權限會受到umask值所影響，因此該文件權限應當為（mode-umaks）。

S_IRWXU00700權限，代表該文件全部者具有可讀、可寫及可執(zhí)行的權限。

S_IRUSR或S_IREAD，00400權限，代表該文件全部者具有可讀取的權限。

S_IWUSR或S_IWRITE，00200權限，代表該文件全部者具有可寫入的權限。S_IXUSR或S_IEXEC，00100權限，代表該文件全部者具有可執(zhí)行的權限。

S_IRWXG00070權限，代表該文件用戶組具有可讀、可寫及可執(zhí)行的權限。

S_IRGRP00040權限，代表該文件用戶組具有可讀的權限。

S_IWGRP00020權限，代表該文件用戶組具有可寫入的權限。

S_IXGRP00010權限，代表該文件用戶組具有可執(zhí)行的權限。

S_IRWXO00007權限，代表其他用戶具有可讀、可寫及可執(zhí)行的權限。

S_IROTH00004權限，代表其他用戶具有可讀的權限

S_IWOTH00002權限，代表其他用戶具有可寫入的權限。

S_IXOTH00001權限，代表其他用戶具有可執(zhí)行的權限。

返回值若全部欲核查的權限都通過了檢查則返回0值，表示勝利，只要有一個權限被禁止則返回-1。

錯誤代碼EEXIST參數(shù)pathname所指的文件已存在，卻使用了O_CREAT和O_EXCL旗標。

EACCESS參數(shù)pathname所指的文件不符合所要求測試的權限。

EROFS欲測試寫入權限的文件存在于只讀文件系統(tǒng)內(nèi)。

EFAULT參數(shù)pathname指針超出可存取內(nèi)存空間。

EINVAL參數(shù)mode不正確。

ENAMETOOLONG參數(shù)pathname太長。

ENOTDIR參數(shù)pathname不是名目。

ENOMEM核心內(nèi)存不足。

ELOOP參數(shù)pathname有過多符號連接問題。

EIOI/O存取錯誤。

C++

附加說明使用access作用戶認證方面的推斷要特殊當心，例如在access后再作open空文件可能會造成系統(tǒng)平安上的問題。

范例#includeunistd.h

#includesys/types.h

#includesys/stat.h

#includefcntl.h

main

{

intfd,size;

chars[]=”LinuxProgrammer!\n”,buffer[80];

fd=open(“/tmp/temp”,O_WRONLY|O_CREAT);

write(fd,s,sizeof(s));

close(fd);

fd=open(“/tmp/temp”,O_RDONLY);

size=read(fd,buffer,sizeof(buffer));

close(fd);

printf(“%s”,buffer);

}

執(zhí)行LinuxProgrammer!

read（由已打開的文件讀取數(shù)據(jù)）

相關函數(shù)readdir，write，fcntl，close，lseek，readlink，fread

表頭文件#includeunistd.h

定義函數(shù)ssize_tread(intfd,void*buf,size_tcount);

函數(shù)說明read會把參數(shù)fd所指的文件傳送count個字節(jié)到buf指針所指的內(nèi)存中。若參數(shù)count為0，則read不會有作用并返回0。返回值為實際讀取到的字節(jié)數(shù)，假如返回0，表示已到達文件尾或是無可讀取的數(shù)據(jù)，此外