Linux下 fcntl 函数用法说明

功能描述：根据文件描述词来操做文件的特性。 
文件控制函数
         fcntl -- file control

LIBRARY
         Standard C Library (libc, -lc)

SYNOPSIS
         #include <fcntl.h>; 
         int fcntl(int fd, int cmd); 
         int fcntl(int fd, int cmd, long arg); 
         int fcntl(int fd, int cmd, struct flock *lock); 

[描述]
            Fcntl()针对(文件)描述符提供控制.参数fd 是被参数cmd操做(以下面的描述)的描述符.
            针对cmd的值,fcntl可以接受第三个参数int arg

fcntl函数有5种功能： 
1.复制一个现有的描述符（cmd=F_DUPFD）. 
2.得到／设置文件描述符标记(cmd=F_GETFD或F_SETFD). 
3.得到／设置文件状态标记(cmd=F_GETFL或F_SETFL). 
4.得到／设置异步I/O全部权(cmd=F_GETOWN或F_SETOWN). 
5.得到／设置记录锁(cmd=F_GETLK,F_SETLK或F_SETLKW).

     cmd值：
            F_DUPFD            返回一个以下描述的(文件)描述符:
                            o            最小的大于或等于arg的一个可用的描述符
                            o            与原始操做符同样的某对象的引用
                            o            若是对象是文件(file)的话,返回一个新的描述符,这个描述符与arg 共享相同的偏移量(offset)
                            o            相同的访问模式(读,写或读/写)
                            o            相同的文件状态标志(如:两个文件描述符共享相同的状态标志)
                            o            与新的文件描述符结合在一块儿的close-on-exec 标志被设置成交叉式访问execve(2)的系统调用
     
    
            F_GETFD            取得与文件描述符fd联合close-on-exec标志,相似FD_CLOEXEC.若是返回值和FD_CLOEXEC进行与运算结果是0的话,文件保 持交叉式访问exec(),不然若是经过exec运行的话,文件将被关闭(arg 被忽略)
     
    
            F_SETFD            设置close-on-exec 旗标。该旗标以参数arg 的FD_CLOEXEC位决定。     
   
            F_GETFL            取得fd的文件状态标志,如同下面的描述同样(arg被忽略)
     
   
            F_SETFL            设置给arg描述符状态标志,能够更改的几个标志是： O_APPEND， O_NONBLOCK，O_SYNC和O_ASYNC。

     
     
            F_GETOWN             取得当前正在接收SIGIO或者SIGURG信号的进程id或进程组id,进程组id返回成负值(arg被忽略)
     
   
            F_SETOWN            设置将接收SIGIO和SIGURG信号的进程id或进程组id,进程组id经过提供负值的arg来讲明,不然,arg将被认为是进程id

   
            命令字(cmd)F_GETFL和F_SETFL的标志以下面的描述:
            O_NONBLOCK            非阻塞I/O;若是read(2)调用没有可读取的数据,或者若是write(2)操做将阻塞,read或write调用返回-1和EAGAIN错误
            O_APPEND                    强制每次写(write)操做都添加在文件大的末尾,至关于open(2)的O_APPEND标志
            O_DIRECT                    最小化或去掉reading和writing的缓存影响.系统将企图避免缓存你的读或写的数据.若是不可以避免缓存,那么它将最小化已经被缓存了的数据造 成的影响.若是这个标志用的不够好,将大大的下降性能
            O_ASYNC                    当I/O可用的时候,容许SIGIO信号发送到进程组,例如:当有数据能够读的时候

在修改文件描述符标志或文件状态标志时必须谨慎，先要取得如今的标志值，而后按照但愿修改它，最后设置新标志值。不能只是执行F_SETFD或F_SETFL命令，这样会关闭之前设置的标志位。

fcntl的返回值与命令有关。若是出错，全部命令都返回－1，若是成功则返回某个其余值。下列三个命令有特定返回值：F_DUPFD,F_GETFD,F_GETFL以及F_GETOWN。第一个返回新
的文件描述符，第二个返回相应标志，最后一个返回一个正的进程ID或负的进程组ID。

控制fd的例程以下：

#include

/**三个存取方式标志(O_RDONLY,O_WRONLY,以及O_RDWR)并不各占1位。(这三种标志的值各是0、1和2，因为历 史缘由。这三种值互斥—一个文件只能有这三种值之一。)所以首先必须用屏蔽字O_ACCMODE取得存取方式位，而后将结果与这三种值相比较。

****/

switch(var & O_ACCMODE) 
{ 
case O_RDONLY : cout<<"Read only.."<

.得到／设置记录锁的功能：(cmd=F_GETLK,F_SETLK或F_SETLKW).

          F_GETLK          经过第三个参数arg(一个指向flock的结构体)取得第一个阻塞lock description指向的的锁.取得的信息将覆盖传到fcntl()的flock结构的信息.若是没有发现可以阻止本次锁(flock)生成的锁,这 个结构将不被改变,除非锁的类型被设置成F_UNLCK.

     
          F_SETLK          按照指向结构体flock的指针的第三个参数arg所描述的锁的信息设置或者清除一个文件segment锁.F_SETLK被用来实现共享(或读)锁 (F_RDLCK)或独占(写)锁(F_WRLCK),一样能够去掉这两种锁(F_UNLCK).若是共享锁或独占锁不能被设置,fcntl()将当即返 回EAGAIN.

     
          F_SETLKW          除了共享锁或独占锁被其余的锁阻塞这种状况外,这个命令和F_SETLK是同样的.若是共享锁或独占锁被其余的锁阻塞,进程将等待直到这个请求可以完成. 当fcntl()正在等待文件的某个区域的时候捕捉到一个信号,若是这个信号没有被指定SA_RESTART,fcntl将被中断.

     
          当一个共享锁被set到一个文件的某段的时候,其余的进程能够set 共享锁到这个段或这个段的一部分.共享所阻止任何其余进程set独占锁到这段保护区域的任何部分.若是文件描述符没有以读的访问方式打开的话,共享锁的设置请求会失败

    
          独占锁阻止任何其余的进程在这段保护区域任何位置设置共享锁或独占锁.若是文件描述符不是以写的访问方式打开的话,独占锁的请求会失败

结构体flock的指针：

struct flcok 
{ 
short int l_type; /* 锁定的状态*/

//这三个参数用于分段对文件加锁，若对整个文件加锁，则：l_whence=SEEK_SET,l_start=0,l_len=0;
short int l_whence;/*决定l_start位置*/ 
off_t l_start; /*锁定区域的开头位置*/ 
off_t l_len; /*锁定区域的大小*/

pid_t l_pid; /*锁定动做的进程*/ 
};

l_type 有三种状态: 
F_RDLCK 创建一个供读取用的锁定 
F_WRLCK 创建一个供写入用的锁定 
F_UNLCK 删除以前创建的锁定

l_whence 也有三种方式: SEEK_SET 以文件开头为锁定的起始位置。 SEEK_CUR 以目前文件读写位置为锁定的起始位置 SEEK_END 以文件结尾为锁定的起始位置。   返回值      成功则返回0，如有错误则返回-1，错误缘由存于errno.