ioctl_fslabel(2)

NUME
ioctl_fslabel - obține sau definește o etichetă de sistem de fișiere

BIBLIOTECA
Biblioteca C standard (libc, -lc)

REZUMAT
#include <linux/fs.h>       /* Definirea constantelor *FSLABEL* */
#include <sys/ioctl.h>

int ioctl(int descriptor-fișier, FS_IOC_GETFSLABEL, char eticheta[FSLABEL_MAX]);
int ioctl(int descriptor-fișier, FS_IOC_SETFSLABEL, char eticheta[FSLABEL_MAX]);

DESCRIERE
Dacă un sistem de fișiere acceptă manipularea în timpul funcționării a etichetelor, aceste operații ioctl(2) pot fi utilizate pentru a obține sau defini eticheta sistemului de fișiere pentru sistemul de fișiere pe care se află descriptor-fișier. Operația FS_IOC_SETFSLABEL necesită privilegii (CAP_SYS_ADMIN).

VALOAREA RETURNATĂ
În caz de succes, se returnează zero. În caz de eroare, se returnează -1, iar errno este configurată pentru a indica eroarea.

ERORI
Posibilele erori includ (dar nu se limitează la) următoarele:

EFAULT
    eticheta face referire la o zonă de memorie inaccesibilă.

EINVAL
    Eticheta specificată depășește lungimea maximă a etichetei pentru sistemul de fișiere.

ENOTTY
    Aceasta poate apărea în cazul în care sistemul de fișiere nu acceptă manipularea în timpul funcționării a etichetelor.

EPERM
    Procesul de apelare nu are suficiente permisiuni pentru a defini eticheta.

VERSIUNI
Aceste operații ioctl(2) au apărut pentru prima dată în Linux 4.18. Acestea erau cunoscute anterior sub numele de BTRFS_IOC_GET_FSLABEL și BTRFS_IOC_SET_FSLABEL și erau private pentru Btrfs.

STANDARDE
Această API (interfață de programare a aplicațiilor) este specifică pentru Linux.

NOTE
Lungimea maximă a șirului de caractere pentru această interfață este FSLABEL_MAX, inclusiv octetul null de terminare ('\0'). Sistemele de fișiere au lungimi maxime diferite pentru etichete, care pot include sau nu octetul null de terminare. Șirul de caractere furnizat la FS_IOC_SETFSFSLABEL trebuie să fie întotdeauna cu terminație nulă, iar șirul de caractere returnat de FS_IOC_GETFSFSLABEL va fi întotdeauna cu terminație nulă.

CONSULTAȚI ȘI
ioctl(2), blkid(8)

TRADUCERE
Traducerea în limba română a acestui manual a fost creată de Remus-Gabriel Chelu <remusgabriel.chelu@disroot.org>

Această traducere este documentație gratuită; citiți Licența publică generală GNU Versiunea 3 (https://www.gnu.org/licenses/gpl-3.0.html) sau o versiune ulterioară cu privire la condiții privind drepturile de autor. NU se asumă Nicio RESPONSABILITATE.

Dacă găsiți erori în traducerea acestui manual, vă rugăm să trimiteți un e-mail la translation-team-ro@lists.sourceforge.net.