ioctl_fslabel — get or set a filesystem label
#include <sys/ioctl.h> #include <linux/fs.h>
int
ioctl( |
int fd, |
| FS_IOC_GETFSLABEL, | |
char
label[FSLABEL_MAX]); |
int
ioctl( |
int fd, |
| FS_IOC_SETFSLABEL, | |
char
label[FSLABEL_MAX]); |
If a filesystem supports online label manipulation, these
ioctl(2) operations can be
used to get or set the filesystem label for the filesystem on
which fd resides. The
FS_IOC_SETFSLABEL
operation requires privilege (CAP_SYS_ADMIN).
On success zero is returned. On error, −1 is
returned, and errno is set to
indicate the error.
Possible errors include (but are not limited to) the following:
label
references an inaccessible memory area.
The specified label exceeds the maximum label length for the filesystem.
This can appear if the filesystem does not support online label manipulation.
The calling process does not have sufficient permissions to set the label.
These ioctl(2) operations first
appeared in Linux 4.18. They were previously known as
BTRFS_IOC_GET_FSLABEL and
BTRFS_IOC_SET_FSLABEL and were
private to Btrfs.
The maximum string length for this interface is
FSLABEL_MAX, including the
terminating null byte ('\0'). Filesystems have differing
maximum label lengths, which may or may not include the
terminating null. The string provided to FS_IOC_SETFSLABEL must always
be null-terminated, and the string returned by FS_IOC_GETFSLABEL will always
be null-terminated.
This page is part of release 5.11 of the Linux man-pages project. A
description of the project, information about reporting bugs,
and the latest version of this page, can be found at
https://www.kernel.org/doc/man−pages/.
|
Copyright (c) 2018, Red Hat, Inc. All rights reserved. %%%LICENSE_START(GPLv2+_DOC_FULL) This is free documentation; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. The GNU General Public License's references to "object code" and "executables" are to be interpreted as the output of any document formatting or typesetting system, including intermediate and printed output. This manual is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this manual; if not, see <http://www.gnu.org/licenses/>. %%%LICENSE_END |