Linux内核API put_unused_fd

put_unused_fd()函数的功能是设置未使用的文件描述符。它调用了__put_unused_fd()函数，并在其中调用了FD_CLR函数，实现对文件描述表中的位标志open_fds与fd相对应的位清零，也就是对应文件在此进程运行时关闭。如果传入的参数fd小于files->next_fd（文件中的下一个文件描述符），则将fd的值赋给files->next_fd。反之，则不赋值。

put_unused_fd文件包含

#include <linux/file.h>

put_unused_fd函数定义

在内核源码中的位置：linux-3.19.3/fs/file.c

函数定义格式：

void put_unused_fd(unsigned int fd)

put_unused_fd输入参数说明

• fd：被设置的文件描述符。

put_unused_fd返回参数说明

• put_unused_fd()函数无返回值。

put_unused_fd实例解析

编写测试文件：put_unused_fd.c

头文件声明如下：

#include <linux/init.h>
#include <linux/module.h>
#include <linux/fs.h>
#include <linux/path.h>
#include <linux/mount.h>
#include <linux/dcache.h>
#include <linux/sched.h>
#include <linux/fs_struct.h>
#include <linux/file.h>
#include <linux/fdtable.h>
MODULE_LICENSE("GPL");

模块初始化函数：

int put_unused_fd_init(void)
{
    struct files_struct *fs = current->files;   //获取当前文件的描述符
    printk("Current  \"next_fd\" is :%d\n", fs->next_fd); //输出当前文件的next_fd值
    // 设置新的next_fd值为2
    put_unused_fd(2);
    printk("After setting \"fd=2\", \"next_fd\" is :%d\n", fs->next_fd);
                                                  // 输出当前文件的next_fd值
    // 设置新的next_fd值为4
    put_unused_fd(4);
    printk("After setting \"fd=4\", \"next_fd\" is :%d\n", fs->next_fd);
                                                  // 输出当前文件的next_fd值
    return 0;
}

模块退出函数：

void put_unused_fd_exit(void)
{
    printk("Goodbye put_unused_fd\n");
}

模块初始化及退出函数调用：

module_init(put_unused_fd_init);
module_exit(put_unused_fd_exit);

实例运行结果及分析：

首先编译模块，执行命令insmod put_unused_fd.ko插入模块，然后执行命令dmesg -c，会出现如图所示的结果。

结果分析：

原有的最大文件描述符next_fd值为4，第一次传入参数fd的值2小于原来的next_fd的值，则next_fd的值被更新为2，第二次传入参数fd的值4不小于next_fd的值，那么next_fd的值不被更新，因此fd的值还是2。