'\" t
.\"     Title: libblkid
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.23
.\"      Date: 2025-03-29
.\"    Manual: Manualul programatorului
.\"    Source: util-linux 2.41
.\"  Language: English
.\"
.TH "LIBBLKID" "3" "2025-03-29" "util\-linux 2.41" "Manualul programatorului"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "NUME"
libblkid \- biblioteca de identificare a dispozitivelor de bloc
.SH "REZUMAT"
.sp
\fB#include <blkid.h>\fP
.sp
\fBcc\fP \fIfile.c\fP \fB\-lblkid\fP
.SH "DESCRIERE"
.sp
Biblioteca \fBlibblkid\fP este utilizată pentru a identifica dispozitivele de bloc (discuri) în ceea ce privește conținutul lor (de exemplu, tipul de sistem de fișiere), precum și pentru a extrage informații suplimentare, cum ar fi etichetele sistemului de fișiere/numele volumelor, identificatorii unici/numerele de serie. O utilizare obișnuită este aceea de a permite utilizarea etichetelor \fBLABEL=\fP și \fBUUID=\fP în loc de a codifica în fișiere de configurare numele dispozitivelor de bloc specifice. A se vedea lista tuturor etichetelor disponibile în secțiunea \fBMARCAJE\fP.
.sp
Partea de nivel scăzut a bibliotecii permite, de asemenea, extragerea de informații despre partiții și topologia dispozitivelor de bloc.
.sp
Partea de nivel înalt a bibliotecii păstrează informații despre dispozitivele de bloc într\-un fișier de zonă de prestocare (cache) și se verifică dacă acestea sunt încă valabile înainte de a fi returnate utilizatorului (dacă utilizatorul are permisiunea de citire pe dispozitivul de bloc brut, altfel nu). Fișierul de zonă de prestocare permite, de asemenea, utilizatorilor neprivilegiați (în mod normal, oricine altcineva în afară de root sau cei care nu fac parte din grupul "disk") să localizeze dispozitivele după etichetă/identificator. Locația standard a fișierului de zonă de prestocare poate fi înlocuită de variabila de mediu \fBBLKID_FILE\fP.
.sp
În situațiile în care se obțin informații despre un singur dispozitiv cunoscut, utilizarea sau nu a zonei de prestocare (cache) nu are niciun impact asupra performanței (cu excepția cazului în care nu se poate citi direct dispozitivul de bloc).
.sp
Partea de nivel înalt a bibliotecii suportă două metode pentru a determina \fBLABEL/UUID\fP. Aceasta citește informațiile direct de la un dispozitiv de bloc sau citește informațiile legăturilor simbolice «udev» din /dev/disk/by\-*. Metoda udev este metoda preferată în mod implicit.
.sp
Dacă aveți de\-a face cu mai multe dispozitive, utilizarea zonei de prestocare (cache) este foarte recomandată (chiar dacă este goală), deoarece dispozitivele vor fi scanate cel mult o singură dată, iar zona de prestocare de pe disc va fi actualizată, dacă este posibil.
.sp
În unele cazuri (nuclee modulare), dispozitivele de bloc nu sunt vizibile decât după ce sunt accesate pentru prima dată, astfel încât este esențial să existe o modalitate de a localiza aceste dispozitive fără a enumera numai dispozitivele vizibile, astfel încât utilizarea fișierului de zonă de prestocare este \fBnecesară\fP în această situație.
.SH "FIȘIER DE CONFIGURARE"
.sp
Locația standard a fișierului de configurare \fI/etc/blkid.conf\fP poate fi suprascrisă de variabila de mediu \fBBLKID_CONF\fP. Pentru mai multe detalii despre fișierul de configurare, consultați pagina de manual \fBblkid\fP(8).
.SH "MARCAJE"
.sp
Toate marcajele disponibile sunt enumerate mai jos. Nu toate marcajele sunt acceptate pentru toate sistemele de fișiere. Pentru a activa un marcaj, activați unul dintre următoarele fanioane cu \fBblkid_probe_set_superblocks_flags\fP():
.sp
BLKID_SUBLKS_TYPE
.RS 4
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
TYPE \- tipul sistemului de fișiere
.RE
.RE
.sp
BLKID_SUBLKS_SECTYPE
.RS 4
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
SEC_TYPE \- tipul sistemului de fișiere secundar
.RE
.RE
.sp
BLKID_SUBLKS_LABEL
.RS 4
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
LABEL \- eticheta sistemului de fișiere
.RE
.RE
.sp
BLKID_SUBLKS_LABELRAW
.RS 4
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
LABEL_RAW \- eticheta brută din superblocul sistemului de fișiere
.RE
.RE
.sp
BLKID_SUBLKS_UUID
.RS 4
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
UUID \- UUID\-ul sistemului de fișiere (în minuscule)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
UUID_SUB \- uuid\-ul subvolumului (de exemplu, btrfs)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
LOGUUID \- UUID\-ul jurnalului extern (de exemplu, xfs)
.RE
.RE
.sp
BLKID_SUBLKS_UUIDRAW
.RS 4
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
UUID_RAW \- UUID\-ul brut din superblocul sistemului de fișiere
.RE
.RE
.sp
BLKID_SUBLKS_USAGE
.RS 4
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
USAGE \- șir utilizare: „raid”, „filesystem”, etc.
.RE
.RE
.sp
BLKID_SUBLKS_VERSION
.RS 4
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
VERSION \- versiunea sistemului de fișiere
.RE
.RE
.sp
BLKID_SUBLKS_MAGIC
.RS 4
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
SBMAGIC \- șir magic de super\-bloc
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
SBMAGIC_OFFSET \- poziția din SBMAGIC
.RE
.RE
.sp
BLKID_SUBLKS_FSINFO
.RS 4
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
FSSIZE \- dimensiunea sistemului de fișiere. Rețineți că pentru XFS va returna aceeași valoare ca și lsblk (fără metadatele XFS), dar pentru ext4 va returna dimensiunea cu metadatele și pentru BTRFS nu va lua în considerare costurile suplimentare ale configurației RAID (date redundante).
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
FSLASTBLOCK \- ultimul bloc al sistemului de fișiere/numărul total de blocuri ale sistemului de fișiere
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
FSBLOCKSIZE \- dimensiunea blocului sistemului de fișiere
.RE
.RE
.sp
Următoarele marcaje sunt întotdeauna activate
.RS 4
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
BLOCK_SIZE \- dimensiunea minimă a blocului pe care sistemul de fișiere o poate accesa
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
MOUNT \- numele de montare a clusterului (numai ocfs)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
EXT_JOURNAL \- jurnal extern UUID
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
SYSTEM_ID \- identificatorul sistemului ISO9660
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
VOLUME_SET_ID \- identificatorul setului de volume ISO9660
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
DATA_PREPARER_ID \- identificatorul datelor ISO9660
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
PUBLISHER_ID \- identificatorul editorului ISO9660
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
APPLICATION_ID \- identificatorul aplicației ISO9660
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
BOOT_SYSTEM_ID \- identificatorul sistemului de pornire ISO9660
.RE
.RE
.SH "AUTORI"
.sp
\fBlibblkid\fP a fost scris de Andreas Dilger pentru utilitățile sistemului de fișiere ext2, cu contribuția lui Ted Ts\(cqo. Ulterior, biblioteca a fost puternic modificată de Ted Ts\(cqo.
.sp
Codul de testare de nivel scăzut a fost rescris de Karel Zak.
.SH "COPIEREA"
.sp
\fBlibblkid\fP este disponibil în conformitate cu termenii licenței publice generale de bibliotecă GNU (LGPL), versiunea 2 (sau, la alegerea dumneavoastră, orice versiune ulterioară).
.SH "CONSULTAȚI ȘI"
.sp
\fBblkid\fP(8), \fBfindfs\fP(8)
.SH "RAPORTAREA ERORILOR"
.sp
Pentru rapoarte de eroare, folosiți \c
.URL "https://github.com/util\-linux/util\-linux/issues" "sistemul de urmărire al erorilor" "."
.SH "DISPONIBILITATE"
.sp
Biblioteca \fBlibblkid\fP face parte din pachetul util\-linux începând cu versiunea 2.15. Acesta poate fi descărcat de la \c
.URL "https://www.kernel.org/pub/linux/utils/util\-linux/" "Linux Kernel Archive" "."