'\" t
.\"     Title: losetup
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-09-02
.\"    Manual: Administrare sistem
.\"    Source: util-linux 2.42.3
.\"  Language: English
.\"
.TH "LOSETUP" "8" "2026-09-02" "util\-linux 2.42.3" "Administrare sistem"
.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"
losetup \- configurează și controlează dispozitivele de buclă
.SH "REZUMAT"
.sp
Configurează un dispozitiv de buclă:
.sp
\fBlosetup\fP [opțiuni] \fB\-f\fP|\fIdispozitiv\-buclă\fP
.sp
Obține informații:
.sp
\fBlosetup\fP [\fB\-l\fP] [\fB\-a\fP|\fIdispozitiv\-buclă\fP
.sp
\fBlosetup\fP \fB\-j\fP \fIfișier\fP [\fB\-o\fP \fIpoziția\fP]
.sp
Recalibrează dimensiunea unui dispozitiv de buclă:
.sp
\fBlosetup\fP \fB\-c\fP \fIdispozitiv\-buclă\fP
.sp
Detașează dispozitivul de buclă:
.sp
\fBlosetup\fP \fB\-d\fP \fIdispozitiv\-buclă\fP .\|.\|.
.sp
\fBlosetup\fP \fB\-D\fP
.sp
Împiedică afișarea dispozitivelor de buclă:
.sp
\fBlosetup\fP \fB\-\-remove\fP \fIdispozitiv\-buclă\fP .\|.\|.
.SH "DESCRIERE"
.sp
\fBlosetup\fP este utilizat pentru a asocia dispozitive de buclă cu fișiere obișnuite sau dispozitive de bloc, pentru a detașa dispozitive de buclă și pentru a interoga starea unui dispozitiv de buclă. Dacă se furnizează doar argumentul \fIdispozitiv\-buclă\fP, se afișează starea dispozitivului de buclă corespunzător. Dacă nu se dă nicio opțiune, sunt afișate toate dispozitivele de buclă.
.sp
Rețineți că vechiul format de ieșire (adică \fBlosetup \-a\fP) cu șiruri de caractere delimitate prin virgule este depreciat în favoarea formatului de ieșire \fB\-\-list\fP.
.sp
Este posibil să se creeze mai multe dispozitive de buclă independente pentru același fișier suport. \fBAceastă configurare poate fi periculoasă, putând duce la pierderea datelor, coruperea acestora și suprascrierea lor.\fP Utilizați opțiunea \fB\-\-nooverlap\fP împreună cu \fB\-\-find\fP în timpul configurării pentru a evita această problemă.
.sp
Configurarea dispozitivului în buclă nu este o operație atomică atunci când este utilizată cu \fB\-\-find\fP, iar \fBlosetup\fP nu protejează această operație prin nici un sistem de blocare. Numărul de încercări este restricționat intern la un maxim de 16. Se recomandă să se utilizeze, de exemplu, \fBflock\fP(1) pentru a evita o coliziune în cazurile de utilizare foarte paralelă.
.SH "OPȚIUNI"
.sp
Argumentele \fIdimensiunea\fP și \fIpoziția\fP pot fi urmate de sufixele multiplicative KiB (=1024), MiB (=1024*1024), și așa mai departe pentru GiB, TiB, PiB, EiB, ZiB și YiB („iB” este opțional, de exemplu, „K” are aceeași semnificație ca și „KiB”), sau sufixele KB (=1000), MB (=1000*1000) și așa mai departe pentru GB, TB, PB, EB, ZB și YB.
.sp
\fB\-a\fP, \fB\-\-all\fP
.RS 4
Afișează starea tuturor dispozitivelor de buclă. Rețineți că nu toate informațiile sunt accesibile pentru utilizatorii non\-root. A se vedea și \fB\-\-list\fP. Vechiul format de ieșire (așa cum este afișat fără \fB\-\-list\fP) este depreciat.
.RE
.sp
\fB\-d\fP, \fB\-\-detach\fP \fIdispozitiv\-buclă\fP.\|.\|.
.RS 4
Detașează fișierul sau dispozitivul asociat cu dispozitivul (dispozitivele) de buclă specificat(e). Rețineți că, începând cu Linux v3.7, nucleul utilizează „distrugerea leneșă a dispozitivelor”. Operația de detașare nu mai returnează eroarea \fBEBUSY\fP dacă dispozitivul este utilizat în mod activ de sistem, dar este marcat prin fanionul „autoclear” și distrus ulterior. Chiar dacă dispozitivul nu este utilizat, dispozitivul buclă poate fi distrus ulterior. Dacă trebuie să așteptați o eliminare completă a dispozitivului de buclă, apelați \fBudevadm settle\fP după \fBlosetup\fP.
.RE
.sp
\fB\-D\fP, \fB\-\-detach\-all\fP
.RS 4
Detașează toate dispozitivele de buclă asociate.
.RE
.sp
\fB\-f\fP, \fB\-\-find\fP [\fIfișier\fP]
.RS 4
Găsește primul dispozitiv de buclă neutilizat. Dacă este prezent un argument \fIfișier\fP, se utilizează dispozitivul găsit ca dispozitiv de buclă. În caz contrar, se afișează doar numele acestuia.
.RE
.sp
\fB\-\-show\fP
.RS 4
Afișează numele dispozitivului de buclă atribuit dacă sunt prezente opțiunea \fB\-f\fP și un argument \fIfișier\fP.
.RE
.sp
\fB\-L\fP, \fB\-\-nooverlap\fP
.RS 4
Verifică dacă există conflicte între dispozitivele de buclă pentru a evita situația în care același fișier de rezervă este partajat între mai multe dispozitive de buclă. Dacă fișierul este deja utilizat de un alt dispozitiv, se reutilizează acest dispozitiv în loc să se creeze unul nou. Opțiunea are sens numai cu \fB\-\-find\fP.
.RE
.sp
\fB\-j\fP, \fB\-\-associated\fP \fIfișier\fP [\fB\-o\fP \fIpoziția\fP]
.RS 4
Afișează starea tuturor dispozitivelor de buclă asociate cu \fIfișierul\fP dat.
.RE
.sp
\fB\-o\fP, \fB\-\-offset\fP \fIpoziția\fP
.RS 4
Începutul datelor este mutat \fIpoziție\fP octeți în fișierul sau dispozitivul specificat. \fIpoziția\fP poate fi urmată de sufixe multiplicative; a se vedea mai sus.
.RE
.sp
\fB\-\-loop\-ref\fP \fIșir\fP
.RS 4
Stabilește șirul de referință. Valoarea implicită retro\-compatibilă este de a utiliza numele fișierului de copie de rezervă ca referință în apelul ioctl de configurare a buclei (aka nume_fișier_lo). Această opțiune poate suprascrie acest comportament implicit și poate stabili referința la \fIșir\fP. Referința poate fi utilizată de «udevd» în „/dev/loop/by\-ref”. Nucleul Linux nu utilizează deloc referința, dar ar putea fi utilizată de unele utilități vechi care nu pot citi fișierul de copie de rezervă din sysfs. Referința poate fi citită numai de utilizatorul root (a se vedea \fB\-\-output\fP +REF) și este limitată la 64 de octeți.
.RE
.sp
\fB\-\-sizelimit\fP \fIdimensiunea\fP
.RS 4
Sfârșitul datelor este fixat la cel mult \fIdimensiunea\fP octeți după începutul datelor. \fIdimensiunea\fP poate fi urmată de sufixe multiplicative; a se vedea mai sus.
.RE
.sp
\fB\-b\fP, \fB\-\-sector\-size\fP \fIdimensiunea\fP
.RS 4
Stabilește dimensiunea sectorului logic al dispozitivului de buclă în octeți (de la Linux 4.14). Opțiunea poate fi utilizată la crearea unui nou dispozitiv de buclă, precum și ca o comandă de sine stătătoare pentru a modifica dimensiunea sectorului unui dispozitiv de buclă deja existent.
.RE
.sp
\fB\-c\fP, \fB\-\-set\-capacity\fP \fIdispozitiv\-buclă\fP
.RS 4
Forțează controlorul de buclă să recitească dimensiunea fișierului asociat cu dispozitivul de buclă specificat.
.RE
.sp
\fB\-P\fP, \fB\-\-partscan\fP
.RS 4
Forțează nucleul să scaneze tabelul de partiții pe un dispozitiv de buclă nou creat. Rețineți că analizarea tabelului de partiții depinde de dimensiunile sectoarelor. În mod implicit, dimensiunea sectorului este de 512 octeți, în caz contrar trebuie să utilizați opțiunea \fB\-\-sector\-size\fP împreună cu \fB\-\-partscan\fP.
.RE
.sp
\fB\-r\fP, \fB\-\-read\-only\fP
.RS 4
Configurează un dispozitiv de buclă numai\-pentru\-citire.
.RE
.sp
\fB\-\-direct\-io\fP[\fB=on\fP|\fBoff\fP]
.RS 4
Activează sau dezactivează In/Ieș directă pentru fișierul de rezervă. Valoarea implicită este \fBoff\fP. Dacă se specifică fie \fB\-\-direct\-io\fP, fie \fB\-\-direct\-io=on\fP, se activează. Dar se poate furniza \fB\-\-direct\-io=off\fP pentru a o dezactiva în mod explicit.
.RE
.sp
\fB\-l\fP, \fB\-\-list\fP
.RS 4
Dacă se specifică un dispozitiv de buclă sau opțiunea \fB\-a\fP, se afișează coloanele implicite fie pentru dispozitivul de buclă specificat, fie pentru toate dispozitivele de buclă; valoarea implicită este de a afișa informații despre toate dispozitivele. A se vedea, de asemenea, \fB\-\-output\fP, \fB\-\-noheadings\fP, \fB\-\-raw\fP și \fB\-\-json\fP.
.RE
.sp
\fB\-O\fP, \fB\-\-output\fP \fIcoloana\fP[,\fIcoloana\fP].\|.\|.
.RS 4
Specifică coloanele care urmează să fie afișate pentru ieșirea \fB\-\-list\fP. Utilizați \fB\-\-help\fP pentru a obține o listă cu toate coloanele acceptate.
.RE
.sp
\fB\-\-output\-all\fP
.RS 4
Afișează toate coloanele disponibile.
.RE
.sp
\fB\-n\fP, \fB\-\-noheadings\fP
.RS 4
Nu afișează titlurile pentru formatul de ieșire \fB\-\-list\fP.
.RE
.sp
\fB\-\-raw\fP
.RS 4
Utilizează formatul de ieșire brut \fB\-\-list\fP.
.RE
.sp
\fB\-J\fP, \fB\-\-json\fP
.RS 4
Utilizează formatul JSON pentru ieșirea \fB\-\-list\fP.
.RE
.sp
\fB\-\-remove\fP \fIdispozitiv\-buclă\fP.\|.\|.
.RS 4
Elimină dispozitivul/dispozitivele de buclă specificat(e). Dispozitivul de buclă trebuie să fie nefolosit (să nu fie asociat cu niciun fișier de suport). Această opțiune elimină nodul dispozitivului din sistem. În majoritatea cazurilor, opțiunea \fB\-\-detach\fP este suficientă pentru utilizarea normală. Consultați secțiunea \fBCICLUL DE VIAȚĂ AL DISPOZITIVELOR DE BUCLĂ\fP de mai jos.
.RE
.sp
\fB\-h\fP, \fB\-\-help\fP
.RS 4
Afișează acest mesaj de ajutor și iese.
.RE
.sp
\fB\-V\fP, \fB\-\-version\fP
.RS 4
Afișează versiunea și iese.
.RE
.SH "CICLUL DE VIAȚĂ AL DISPOZITIVELOR DE BUCLĂ"
.sp
Dispozitivele de buclă trec prin mai multe stări pe parcursul ciclului lor de viață:
.sp
\fBCrearea\fP
.RS 4
Când \fBlosetup\fP asociază un dispozitiv de buclă cu un fișier de suport, acesta creează automat nodul de dispozitiv (de exemplu, \fI/dev/loop0\fP) dacă acesta nu există deja. Acest lucru se întâmplă la cerere atunci când utilizați opțiuni precum \fB\-f\fP sau când specificați în mod explicit un dispozitiv buclă. Dispozitivul este creat folosind comanda ioctl \fBLOOP_CTL_ADD\fP.
.RE
.sp
\fBDetaşarea\fP
.RS 4
Opțiunea \fB\-d\fP (\fB\-\-detach\fP) dezactivează asocierea fișierului de suport cu dispozitivul de buclă folosind comanda ioctl \fBLOOP_CLR_FD\fP. După dezactivare, nodul dispozitivului buclă rămâne în \fI/dev\fP și poate fi reutilizat pentru un alt fișier de suport. Folosiți \fBlsblk \-a\fP pentru a afișa toate nodurile dispozitivelor buclă, inclusiv cele neutilizate.
.RE
.sp
\fBEliminarea\fP
.RS 4
Opțiunea \fB\-\-remove\fP elimină complet nodul dispozitivului de buclă din sistem folosind comanda ioctl \fBLOOP_CTL_REMOVE\fP. Dispozitivul trebuie mai întâi detașat (să nu fie asociat cu niciun fișier de suport). După eliminare, nodul dispozitivului dispare din \fI/dev\fP.
.RE
.SH "CRIPTARE"
.sp
\fBCryptoloop nu mai este acceptat în favoarea dm\-crypt.\fP Pentru mai multe detalii, consultați \fBcryptsetup\fP(8).
.SH "STARE DE IEȘIRE"
.sp
\fBlosetup\fP returnează 0 în caz de succes, diferit de zero în caz de eșec. Atunci când \fBlosetup\fP afișează starea unui dispozitiv în buclă, acesta returnează 1 dacă dispozitivul nu este configurat și 2 dacă a apărut o eroare care a împiedicat determinarea stării dispozitivului.
.SH "NOTE"
.sp
Începând cu versiunea 2.37, \fBlosetup\fP utilizează ioctl \fBLOOP_CONFIGURE\fP pentru a configura un nou dispozitiv de buclă printr\-un singur apel ioctl. Versiunile vechi folosesc ioctlurile \fBLOOP_SET_FD\fP și \fBLOOP_SET_STATUS64\fP pentru a face același lucru.
.SH "MEDIU"
.sp
\fBLOOPDEV_DEBUG\fP=all
.RS 4
activează ieșirea de depanare.
.RE
.sp
\fBLIBSMARTCOLS_DEBUG\fP=all
.RS 4
activează ieșirea de depanare a libsmartcols.
.RE
.sp
\fBLIBSMARTCOLS_DEBUG_PADDING\fP=on
.RS 4
utilizează caractere de umplutură vizibile.
.RE
.SH "FIȘIERE"
.sp
\fI/dev/loop[0..N]\fP
.RS 4
dispozitive de bloc buclă
.RE
.sp
\fI/dev/loop\-control\fP
.RS 4
dispozitiv de control al buclei
.RE
.SH "EXEMPLU"
.sp
Următoarele comenzi pot fi folosite ca exemplu de utilizare a dispozitivului de buclă.
.sp
.if n .RS 4
.nf
.fam C
# dd if=/dev/zero of=~/file.img bs=1024k count=10
# losetup \-\-find \-\-show ~/file.img
/dev/loop0
# mkfs \-t ext2 /dev/loop0
# mount /dev/loop0 /mnt
\&...
# umount /dev/loop0
# losetup \-\-detach /dev/loop0
.fam
.fi
.if n .RE
.SH "AUTORI"
.sp
.MTO "kzak\(atredhat.com" "Karel Zak" ","
pe baza versiunii originale de la
.MTO "tytso\(atathena.mit.edu" "Theodore Ts\(cqo" "."
.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
Comanda \fBlosetup\fP face parte din pachetul util\-linux care poate fi descărcat de la \c
.URL "https://www.kernel.org/pub/linux/utils/util\-linux/" "Linux Kernel Archive" "."