fcntl

一时失言乱红尘 2022-08-10 03:51 188阅读 0赞

功能描述：根据文件描述词来操作文件的特性。  
  
用法：  
int fcntl(int fd, int cmd);  
int fcntl(int fd, int cmd, long arg);  
int fcntl(int fd, int cmd, struct flock \*lock);  
  
  
参数：  
fd：文件描述词。  
cmd：操作命令。  
arg：供命令使用的参数。  
lock：同上。  
  
有以下操作命令可供使用  
  
一. F\_DUPFD ：复制文件描述词 。  
  
二. FD\_CLOEXEC ：设置close-on-exec标志。如果FD\_CLOEXEC位是0，执行execve的过程中，文件保持打开。反之则关闭。  
  
三. F\_GETFD ：读取文件描述词标志。  
  
四. F\_SETFD ：设置文件描述词标志。  
  
五. F\_GETFL ：读取文件状态标志。  
  
六. F\_SETFL ：设置文件状态标志。  
其中O\_RDONLY， O\_WRONLY， O\_RDWR， O\_CREAT， O\_EXCL， O\_NOCTTY 和 O\_TRUNC不受影响，  
可以更改的标志有 O\_APPEND，O\_ASYNC， O\_DIRECT， O\_NOATIME 和 O\_NONBLOCK。  
  
七. F\_GETLK, F\_SETLK 和 F\_SETLKW ：获取，释放或测试记录锁，使用到的参数是以下结构体指针：  
F\_SETLK：在指定的字节范围获取锁（F\_RDLCK, F\_WRLCK）或者释放锁（F\_UNLCK）。如果与另一个进程的锁操作发生冲突，返回 -1并将errno设置为EACCES或EAGAIN。  
  
F\_SETLKW：行为如同F\_SETLK，除了不能获取锁时会睡眠等待外。如果在等待的过程中接收到信号，会立即返回并将errno置为EINTR。  
  
F\_GETLK：获取文件锁信息。  
  
F\_UNLCK：释放文件锁。  
  
为了设置读锁，文件必须以读的方式打开。为了设置写锁，文件必须以写的方式打开。为了设置读写锁，文件必须以读写的方式打开。  
  
八. 信号管理  
F\_GETOWN, F\_SETOWN, F\_GETSIG 和 F\_SETSIG 被用于IO可获取的信号。  
  
F\_GETOWN：获取当前在文件描述词 fd上接收到SIGIO 或 SIGURG事件信号的进程或进程组标识 。  
  
F\_SETOWN：设置将要在文件描述词fd上接收SIGIO 或 SIGURG事件信号的进程或进程组标识 。  
  
F\_GETSIG：获取标识输入输出可进行的信号。  
  
F\_SETSIG：设置标识输入输出可进行的信号。  
  
使用以上命令，大部分时间程序无须使用select()或poll()即可实现完整的异步I/O。  
  
九. 租约（ Leases）  
F\_SETLEASE 和 F\_GETLEASE 被用于当前进程在文件上的租约。文件租约提供当一个进程试图打开或折断文件内容时，拥有文件租约的进程将会被通告的机制。  
  
F\_SETLEASE：根据以下符号值设置或者删除文件租约  
  
1.F\_RDLCK设置读租约，当文件由另一个进程以写的方式打开或折断内容时，拥有租约的当前进程会被通告。  
2.F\_WRLCK设置写租约，当文件由另一个进程以读或以写的方式打开或折断内容时，拥有租约的当前进程会被通告。  
3.F\_UNLCK删除文件租约。  
  
F\_GETLEASE：获取租约类型。  
  
十.文件或目录改变通告  
（linux 2.4以上）当fd索引的目录或目录中所包含的某一文件发生变化时，将会向进程发出通告。arg参数指定的通告事件有以下，两个或多个值可以通过或运算组合。  
1.DN\_ACCESS 文件被访问 (read, pread, readv)  
2.DN\_MODIFY 文件被修改(write, pwrite,writev, truncate, ftruncate)  
3.DN\_CREATE 文件被建立(open, creat, mknod, mkdir, link, symlink, rename)  
4.DN\_DELETE 文件被删除(unlink, rmdir)  
5.DN\_RENAME 文件被重命名(rename)  
6.DN\_ATTRIB 文件属性被改变(chown, chmod, utime\[s\])  
  
返回说明：  
成功执行时，对于不同的操作，有不同的返回值  
F\_DUPFD： 新文件描述词  
F\_GETFD： 标志值  
F\_GETFL： 标志值  
F\_GETOWN： 文件描述词属主  
F\_GETSIG： 读写变得可行时将要发送的通告信号，或者0对于传统的SIGIO行为  
  
对于其它命令返回0。  
  
失败返回-1，errno被设为以下的某个值  
EACCES/EAGAIN: 操作不被允许，尚未可行  
EBADF: 文件描述词无效  
EDEADLK: 探测到可能会发生死锁  
EFAULT: 锁操作发生在可访问的地址空间外  
EINTR: 操作被信号中断  
EINVAL： 参数无效  
EMFILE: 进程已超出文件的最大可使用范围  
ENOLCK: 锁已被用尽  
EPERM:权能不允许