# 最大句柄数限制<a name="ZH-CN_TOPIC_0184808025"></a>

## 功能描述<a name="zh-cn_topic_0182200840_section976415526246"></a>

系统容器支持对容器内使用文件句柄数进行限制，文件句柄包括普通文件句柄和网络套接字，启动容器时，可以通过指定--files-limit参数限制容器内打开的最大句柄数。

## 参数说明<a name="zh-cn_topic_0182200840_section14494191892512"></a>

<a name="zh-cn_topic_0182200840_table1869210387418"></a>
<table><thead align="left"><tr id="zh-cn_topic_0182200840_row1569373816419"><th class="cellrowborder" valign="top" width="16.77%" id="mcps1.1.4.1.1"><p id="zh-cn_topic_0182200840_p106936387415"><a name="zh-cn_topic_0182200840_p106936387415"></a><a name="zh-cn_topic_0182200840_p106936387415"></a>命令</p>
</th>
<th class="cellrowborder" valign="top" width="38.47%" id="mcps1.1.4.1.2"><p id="zh-cn_topic_0182200840_p15693173814112"><a name="zh-cn_topic_0182200840_p15693173814112"></a><a name="zh-cn_topic_0182200840_p15693173814112"></a>参数</p>
</th>
<th class="cellrowborder" valign="top" width="44.76%" id="mcps1.1.4.1.3"><p id="zh-cn_topic_0182200840_p1626682291619"><a name="zh-cn_topic_0182200840_p1626682291619"></a><a name="zh-cn_topic_0182200840_p1626682291619"></a>参数指定值说明</p>
</th>
</tr>
</thead>
<tbody><tr id="zh-cn_topic_0182200840_row12693163810415"><td class="cellrowborder" valign="top" width="16.77%" headers="mcps1.1.4.1.1 "><p id="zh-cn_topic_0182200840_p66931838134110"><a name="zh-cn_topic_0182200840_p66931838134110"></a><a name="zh-cn_topic_0182200840_p66931838134110"></a>isula create/run</p>
</td>
<td class="cellrowborder" valign="top" width="38.47%" headers="mcps1.1.4.1.2 "><p id="zh-cn_topic_0182200840_p08101647154218"><a name="zh-cn_topic_0182200840_p08101647154218"></a><a name="zh-cn_topic_0182200840_p08101647154218"></a>--files-limit</p>
<p id="zh-cn_topic_0182200840_p5810124718426"><a name="zh-cn_topic_0182200840_p5810124718426"></a><a name="zh-cn_topic_0182200840_p5810124718426"></a></p>
</td>
<td class="cellrowborder" valign="top" width="44.76%" headers="mcps1.1.4.1.3 "><a name="zh-cn_topic_0182200840_ul2964134315162"></a><a name="zh-cn_topic_0182200840_ul2964134315162"></a><ul id="zh-cn_topic_0182200840_ul2964134315162"><li>整数值，不能为负数。</li><li>指定为0表示不受限制，最大值限制由当前内核files cgroup决定。</li></ul>
</td>
</tr>
</tbody>
</table>

## 约束限制<a name="zh-cn_topic_0182200840_section11526131712"></a>

-   如果--files-limit指定的值太小，可能会导致系统容器无法通过exec执行命令，报"open too many  files"错误，所以files limit的值应该设置大一些。
-   文件句柄包括普通文件句柄和网络套接字。

## 使用示例<a name="zh-cn_topic_0182200840_section193833162512"></a>

使用--files-limit限制容器内打开文件句柄数需要内核支持files cgroup，可以执行以下命令查看：

```
[root@localhost ~]# cat /proc/1/cgroup | grep files
10:files:/
```

结果显示files，说明内核支持files cgroup。

容器启动指定--files-limit参数，并检查files.limit参数是否成功写入：

```
[root@localhost ~]# isula run  -tid --files-limit 1024 --system-container  --external-rootfs /tmp/root-fs  empty init 01e82fcf97d4937aa1d96eb8067f9f23e4707b92de152328c3fc0ecb5f64e91d 
[root@localhost ~]# isula exec -it 01e82fcf97d4 bash 
[root@localhost ~]# cat /sys/fs/cgroup/files/files.limit 
1024 

```

可以看出，容器内文件句柄数被成功限制。

