ioctl_fslabel - obține sau definește o etichetă de sistem de fișiere
Biblioteca C standard (libc, -lc)
#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]);
Dacă un sistem de fișiere acceptă manipularea în timpul funcționării a etichetelor, aceste operații ioctl(2)EN 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).
În caz de succes, se returnează zero. În caz de eroare, se returnează -1, iar errno este configurată pentru a indica eroarea.
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.
Aceste operații ioctl(2)EN 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.
Această API (interfață de programare a aplicațiilor) este specifică pentru Linux.
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ă.
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 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.