fcntl

fcntl函数可以改变已打开的文件性质

目录

1表头文件

2函数类型

3参数介绍

▪ 参数fd

▪ 参数cmd

▪ 参数lock指针

4功能介绍

5函数返回值

6使用实例

1表头文件编辑

#include <sys/types.h>

#include <unistd.h>

#include <fcntl.h>

2函数类型编辑

定义函数 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

3参数介绍编辑

参数fd

参数fd代表欲设置的文件描述符。

参数cmd

参数cmd代表打算操作的指令。

有以下几种情况:

F_DUPFD用来查找大于或等于参数arg的最小且仍未使用的文件描述词，并且复制参数fd的文件描述词。执行成功则返回新复制的文件描述词。新描述符与fd共享同一文件表项，但是新描述符有它自己的一套文件描述符标志，其中FD_CLOEXEC文件描述符标志被清除。请参考dup2()。

F_GETFD取得close-on-exec旗标。若此旗标的FD_CLOEXEC位为0，代表在调用exec()相关函数时文件将不会关闭。

F_SETFD 设置close-on-exec 旗标。该旗标以参数arg 的FD_CLOEXEC位决定。

F_GETFL 取得文件描述词状态旗标，此旗标为open（）的参数flags。

F_SETFL 设置文件描述词状态旗标，参数arg为新旗标，但只允许O_APPEND、O_NONBLOCK和O_ASYNC位的改变，其他位的改变将不受影响。

F_GETLK 取得文件锁定的状态。

F_SETLK 设置文件锁定的状态。此时flcok 结构的l_type 值必须是F_RDLCK、F_WRLCK或F_UNLCK。如果无法建立锁定，则返回-1，错误代码为EACCES 或EAGAIN。

F_SETLKW F_SETLK 作用相同，但是无法建立锁定时，此调用会一直等到锁定动作成功为止。若在等待锁定的过程中被信号中断时，会立即返回-1，错误代码为EINTR。

参数lock指针

参数lock指针为flock 结构指针，定义如下

struct flock

{

short int l_type;

short int l_whence;

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 以文件结尾为锁定的起始位置。

l_start 表示相对l_whence位置的偏移量，两者一起确定锁定区域的开始位置。

l_len表示锁定区域的长度，若果为0表示从起点(由l_whence和 l_start决定的开始位置)开始直到最大可能偏移量为止。即不管在后面增加多少数据都在锁的范围内。

返回值 成功则返回0，若有错误则返回-1，错误原因存于errno.

4功能介绍编辑

fcntl()用来操作文件描述符的一些特性。fcntl 不仅可以施加建议性锁，还可以施加强制锁。同时，fcntl还能对文件的某一记录进行上锁，也就是记录锁。

5函数返回值编辑

fcntl的返回值与命令有关。如果出错，所有命令都返回-1，如果成功则返回某个其他值。下列四个命令有特定返回值：F_DUPFD、F_GETFD、F_GETFL、F_GETOWN.第一个返回新的文件描述符，接下来的两个返回相应标志，最后一个返回一个正的进程ID或负的进程组ID。

6使用实例编辑

[1] 

int flags = fcntl(socket, F_GETFL, 0);

/* 设置为非阻塞*/

if (fcntl(socket_descriptor, F_SETFL, flags | O_NONBLOCK) < 0)

{

/* Handle error */

}

/* 设置为阻塞 */

if ((flags = fcntl(sock_descriptor, F_SETFL, 0)) < 0)

{

/* Handle error */

}