Scroll to navigation

ioctl_fslabel(2) System Calls Manual ioctl_fslabel(2)

NUME

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

BIBLIOTECA

Biblioteca C standard (libc, -lc)

SINOPSIS

#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-IEȘIRE

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

eticheta face referire la o zonă de memorie inaccesibilă.
Eticheta specificată depășește lungimea maximă a etichetei pentru sistemul de fișiere.
Aceasta poate apărea în cazul în care sistemul de fișiere nu acceptă manipularea în timpul funcționării a etichetelor.
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 făcută 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.

5 februarie 2023 Pagini de manual de Linux 6.03