LOSETUP(8)                    Administrare sistem                   LOSETUP(8)

NUME
       losetup - configureaza <?>i controleaza dispozitivele de bucla

REZUMAT
       Ob<?>ine informa<?>ii:

       losetup [dispozitiv-bucla]

       losetup -l [-a]

       losetup -j fi<?>ier [-o pozi<?>ia]

       Deta<?>eaza un dispozitiv de bucla:

       losetup -d dispozitiv-bucla ...

       Deta<?>eaza toate dispozitivele de bucla asociate:

       losetup -D

       Configureaza un dispozitiv de bucla:

       losetup [-o pozi<?>ia] [--sizelimit dimensiunea] [--sector-size
       dimensiunea] [--loop-ref nume] [-Pr] [--show] -f|fi<?>ier
       dispozitiv-bucla

       Redimensioneaza un dispozitiv de bucla:

       losetup -c dispozitiv-bucla

DESCRIERE
       losetup este utilizat pentru a asocia dispozitive de bucla cu fi<?>iere
       obi<?>nuite sau dispozitive de bloc, pentru a deta<?>a dispozitive de
       bucla <?>i pentru a interoga starea unui dispozitiv de bucla. Daca se
       furnizeaza doar argumentul dispozitiv-bucla, se afi<?>eaza starea
       dispozitivului de bucla corespunzator. Daca nu se da nicio op<?>iune,
       sunt afi<?>ate toate dispozitivele de bucla.

       Re<?>ine<?>i ca vechiul format de ie<?>ire (adica losetup -a) cu
       <?>iruri de caractere delimitate prin virgule este depreciat in
       favoarea formatului de ie<?>ire --list.

       Este posibil sa se creeze mai multe dispozitive de bucla independente
       pentru acela<?>i fi<?>ier suport. Aceasta configura<?>ie poate fi
       periculoasa, poate cauza pierderi de date, corup<?>ie <?>i
       suprascrieri. Folosi<?>i --nooverlap cu --find in timpul configurarii
       pentru a evita aceasta problema.

       Configurarea dispozitivului in bucla nu este o opera<?>ie atomica
       atunci cand este utilizata cu --find, iar losetup nu protejeaza aceasta
       opera<?>ie prin nici un sistem de blocare. Numarul de incercari este
       restric<?>ionat intern la un maxim de 16. Se recomanda sa se utilizeze,
       de exemplu, flock(1) pentru a evita o coliziune in cazurile de
       utilizare foarte paralela.

OP<?>IUNI
       Argumentele dimensiunea <?>i pozi<?>ia 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.

       -a, --all
           Afi<?>eaza starea tuturor dispozitivelor de bucla. Re<?>ine<?>i ca
           nu toate informa<?>iile sunt accesibile pentru utilizatorii
           non-root. A se vedea <?>i --list. Vechiul format de ie<?>ire (a<?>a
           cum este afi<?>at fara --list) este depreciat.

       -d, --detach dispozitiv-bucla...
           Deta<?>eaza fi<?>ierul sau dispozitivul asociat cu dispozitivul
           (dispozitivele) de bucla specificat(e). Re<?>ine<?>i ca, incepand
           cu Linux v3.7, nucleul utilizeaza ,,distrugerea lene<?>a a
           dispozitivelor". Opera<?>ia de deta<?>are nu mai returneaza eroarea
           EBUSY daca dispozitivul este utilizat in mod activ de sistem, dar
           este marcat prin fanionul ,,autoclear" <?>i distrus ulterior. Chiar
           daca dispozitivul nu este utilizat, dispozitivul bucla poate fi
           distrus ulterior. Daca trebuie sa a<?>tepta<?>i o eliminare
           completa a dispozitivului de bucla, apela<?>i udevadm settle dupa
           losetup.

       -D, --detach-all
           Deta<?>eaza toate dispozitivele de bucla asociate.

       -f, --find [fi<?>ier]
           Gase<?>te primul dispozitiv de bucla neutilizat. Daca este prezent
           un argument fi<?>ier, se utilizeaza dispozitivul gasit ca
           dispozitiv de bucla. In caz contrar, se afi<?>eaza doar numele
           acestuia.

       --show
           Afi<?>eaza numele dispozitivului de bucla atribuit daca sunt
           prezente op<?>iunea -f <?>i un argument fi<?>ier.

       -L, --nooverlap
           Verifica daca exista conflicte intre dispozitivele de bucla pentru
           a evita situa<?>ia in care acela<?>i fi<?>ier de rezerva este
           partajat intre mai multe dispozitive de bucla. Daca fi<?>ierul este
           deja utilizat de un alt dispozitiv, se reutilizeaza acest
           dispozitiv in loc sa se creeze unul nou. Op<?>iunea are sens numai
           cu --find.

       -j, --associated fi<?>ier [-o pozi<?>ia]
           Afi<?>eaza starea tuturor dispozitivelor de bucla asociate cu
           fi<?>ierul dat.

       -o, --offset pozi<?>ia
           Inceputul datelor este mutat pozi<?>ie octe<?>i in fi<?>ierul sau
           dispozitivul specificat. pozi<?>ia poate fi urmata de sufixe
           multiplicative; a se vedea mai sus.

       --loop-ref <?>ir
           Stabile<?>te <?>irul de referin<?>a. Valoarea implicita
           retrocompatibila este de a utiliza numele fi<?>ierului de copie de
           rezerva ca referin<?>a in apelul ioctl de configurare a buclei (aka
           nume_fi<?>ier_lo). Aceasta op<?>iune poate suprascrie acest
           comportament implicit <?>i poate stabili referin<?>a la <?>ir.
           Referin<?>a poate fi utilizata de <<udevd>> in ,,/dev/loop/by-ref".
           Nucleul Linux nu utilizeaza deloc referin<?>a, dar ar putea fi
           utilizata de unele utilita<?>i vechi care nu pot citi fi<?>ierul de
           copie de rezerva din sysfs. Referin<?>a poate fi citita numai de
           utilizatorul root (a se vedea --output +REF) <?>i este limitata la
           64 de octe<?>i.

       --sizelimit dimensiunea
           Sfar<?>itul datelor este fixat la cel mult dimensiunea octe<?>i
           dupa inceputul datelor. dimensiunea poate fi urmata de sufixe
           multiplicative; a se vedea mai sus.

       -b, --sector-size dimensiunea
           Stabile<?>te dimensiunea sectorului logic al dispozitivului de
           bucla in octe<?>i (de la Linux 4.14). Op<?>iunea poate fi utilizata
           la crearea unui nou dispozitiv de bucla, precum <?>i ca o comanda
           de sine statatoare pentru a modifica dimensiunea sectorului unui
           dispozitiv de bucla deja existent.

       -c, --set-capacity dispozitiv-bucla
           For<?>eaza controlorul de bucla sa reciteasca dimensiunea
           fi<?>ierului asociat cu dispozitivul de bucla specificat.

       -P, --partscan
           For<?>eaza nucleul sa scaneze tabelul de parti<?>ii pe un
           dispozitiv de bucla nou creat. Re<?>ine<?>i ca analizarea tabelului
           de parti<?>ii depinde de dimensiunile sectoarelor. In mod implicit,
           dimensiunea sectorului este de 512 octe<?>i, in caz contrar trebuie
           sa utiliza<?>i op<?>iunea --sector-size impreuna cu --partscan.

       -r, --read-only
           Configureaza un dispozitiv de bucla numai-pentru-citire.

       --direct-io[=on|off]
           Activeaza sau dezactiveaza In/Ie<?> directa pentru fi<?>ierul de
           rezerva. Valoarea implicita este off. Daca se specifica fie
           --direct-io, fie --direct-io=on, se activeaza. Dar se poate furniza
           --direct-io=off pentru a o dezactiva in mod explicit.

       -v, --verbose
           Modul super-descriptiv.

       -l, --list
           Daca se specifica un dispozitiv de bucla sau op<?>iunea -a, se
           afi<?>eaza coloanele implicite fie pentru dispozitivul de bucla
           specificat, fie pentru toate dispozitivele de bucla; valoarea
           implicita este de a afi<?>a informa<?>ii despre toate
           dispozitivele. A se vedea, de asemenea, --output, --noheadings,
           --raw <?>i --json.

       -O, --output coloana[,coloana]...
           Specifica coloanele care urmeaza sa fie afi<?>ate pentru ie<?>irea
           --list. Utiliza<?>i --help pentru a ob<?>ine o lista cu toate
           coloanele acceptate.

       --output-all
           Afi<?>eaza toate coloanele disponibile.

       -n, --noheadings
           Nu afi<?>eaza titlurile pentru formatul de ie<?>ire --list.

       --raw
           Utilizeaza formatul de ie<?>ire brut --list.

       -J, --json
           Utilizeaza formatul JSON pentru ie<?>irea --list.

CRIPTARE
       Cryptoloop nu mai este acceptat in favoarea dm-crypt. Pentru mai multe
       detalii, consulta<?>i cryptsetup(8).

STARE DE IE<?>IRE
       losetup returneaza 0 in caz de succes, diferit de zero in caz de
       e<?>ec. Atunci cand losetup afi<?>eaza starea unui dispozitiv in bucla,
       acesta returneaza 1 daca dispozitivul nu este configurat <?>i 2 daca a
       aparut o eroare care a impiedicat determinarea starii dispozitivului.

NOTE
       Incepand cu versiunea 2.37, losetup utilizeaza ioctl LOOP_CONFIGURE
       pentru a configura un nou dispozitiv de bucla printr-un singur apel
       ioctl. Versiunile vechi folosesc ioctlurile LOOP_SET_FD <?>i
       LOOP_SET_STATUS64 pentru a face acela<?>i lucru.

MEDIU
       LOOPDEV_DEBUG=all
           activeaza ie<?>irea de depanare.

FI<?>IERE
       /dev/loop[0..N]
           dispozitive de bloc bucla

       /dev/loop-control
           dispozitiv de control al buclei

EXEMPLU
       Urmatoarele comenzi pot fi folosite ca exemplu de utilizare a
       dispozitivului de bucla.

           # 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

AUTORI
       Karel Zak <kzak@redhat.com>, pe baza versiunii originale de la Theodore
       Ts'o <tytso@athena.mit.edu>.

RAPORTAREA ERORILOR
       Pentru rapoarte de eroare, folosi<?>i sistemul de urmarire al erorilor
       <https://github.com/util-linux/util-linux/issues>.

DISPONIBILITATE
       Comanda losetup face parte din pachetul util-linux care poate fi
       descarcat de la Linux Kernel Archive
       <https://www.kernel.org/pub/linux/utils/util-linux/>.

util-linux 2.41                   2025-03-29                        LOSETUP(8)