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 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.