Linux程序员手册 第2部分
更新日期： 2020-04-20

名称

ioctl_fslabel-获取或设置文件系统标签

语法

＃包括
＃包括

int ioctl(int fd，FS_IOC_GETFSLABEL，字符标签[FSLABEL_MAX]);
int ioctl(int fd，FS_IOC_SETFSLABEL，char label [FSLABEL_MAX]);

说明

如果文件系统支持联机标签操作，则这些ioctl(2)操作可用于获取或设置fd所在的文件系统的文件系统标签。 FS_IOC_SETFSLABEL操作需要特权(CAP_SYS_ADMIN)。

返回值

成功时返回零。如果出错，则返回-1，并且将errno设置为指示错误。

错误说明

错误可以包括(但不限于)以下内容：

EFAULT

标签引用了无法访问的存储区域。

EINVAL

指定的标签超过了文件系统的最大标签长度。

ENOTTY

如果文件系统不支持在线标签操作，则可能会出现。

EPERM

调用过程没有足够的权限来设置标签。

版本

这些ioctl(2)操作首先出现在Linux 4.18中。它们以前被称为BTRFS_IOC_GET_FSLABEL和BTRFS_IOC_SET_FSLABEL，并且是Btrfs专用的。

遵循规范

该API是特定于Linux的。

备注

该接口的最大字符串长度为FSLABEL_MAX，包括终止空字节(aq \ 0aq)。文件系统具有不同的最大标签长度，可以包含也可以不包含终止null。提供给FS_IOC_SETFSLABEL的字符串必须始终以null终止，而FS_IOC_GETFSLABEL返回的字符串将始终以null终止。

另外参见

ioctl(2)，blkid(8)

出版信息

这个页面是Linux手册页项目5.08版的一部分。有关项目的说明、有关报告错误的信息以及此页面的最新版本，请访问https://www.kernel.org/doc/man-pages/。