LOSETUP(8)

NUME
losetup - configurează și controlează dispozitivele de buclă

REZUMAT

Obține informații:

losetup [loopdev]

losetup -l [-a]

losetup -j file [-o offset]

Detașează un dispozitiv de buclă:

losetup -d loopdev ...

Detașează toate dispozitivele de buclă asociate:

losetup -D

Configurează un dispozitiv de buclă:

losetup [-o offset] [--sizelimit size] [--sector-size size] [--loop-ref name] [-Pr] [--show] -f|loopdev file

Redimensionează un dispozitiv de buclă:

losetup -c loopdev

DESCRIERE

losetup is used to associate loop devices with regular files or block devices, to detach loop devices, and to query the status of a loop device. If only the loopdev argument is given, the status of the corresponding loop device is shown. If no option is given, all loop devices are shown.

Rețineți că vechiul format de ieșire (adică losetup -a) cu șiruri de caractere delimitate prin virgule este depreciat în favoarea formatului de ieșire --list.

Este posibil să se creeze mai multe dispozitive de buclă independente pentru același fișier suport. Această configurație poate fi periculoasă, poate cauza pierderi de date, corupție și suprascrieri. Folosiți --nooverlap cu --find în timpul configurării pentru a evita această problemă.

Configurarea dispozitivului în buclă nu este o operație atomică atunci când este utilizată cu --find, iar losetup 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, flock(1) pentru a evita o coliziune în cazurile de utilizare foarte paralelă.

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șează starea tuturor dispozitivelor de buclă. Rețineți că 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 fără --list) este depreciat.

-d, --detach dispozitiv-buclă...
    Detach the file or device associated with the specified loop device(s). Note that since Linux v3.7 kernel uses "lazy device destruction". The detach operation does not return EBUSY error anymore if device is actively used by system, but it is marked by autoclear flag and destroyed later. Even if the device is not used, the loop device can be destroyed later. If you need to wait for a complete removal of the loop device, call udevadm settle after losetup.

-D, --detach-all
    Detașează toate dispozitivele de buclă asociate.

-f, --find [fișier]
    Găsește primul dispozitiv de buclă neutilizat. Dacă este prezent un argument fișier, se utilizează dispozitivul găsit ca dispozitiv de buclă. În caz contrar, se afișează doar numele acestuia.

--show
    Afișează numele dispozitivului de buclă atribuit dacă sunt prezente opțiunea -f și un argument fișier.

-L, --nooverlap
    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 --find.

-j, --associated fișier [-o poziția]
    Afișează starea tuturor dispozitivelor de buclă asociate cu fișierul dat.

-o, --offset poziția
    Începutul datelor este mutat poziție octeți în fișierul sau dispozitivul specificat. poziția poate fi urmată de sufixe multiplicative; a se vedea mai sus.

--loop-ref șir
    Stabilește șirul de referință. Valoarea implicită retrocompatibilă 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 șir. 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 --output +REF) și este limitată la 64 de octeți.

--sizelimit dimensiunea
    Sfârșitul datelor este fixat la cel mult dimensiunea octeți după începutul datelor. dimensiunea poate fi urmată de sufixe multiplicative; a se vedea mai sus.

-b, --sector-size dimensiunea
    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.

-c, --set-capacity dispozitiv-buclă
    Forțează controlorul de buclă să recitească dimensiunea fișierului asociat cu dispozitivul de buclă specificat.

-P, --partscan
    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 --sector-size împreună cu --partscan.

-r, --read-only
    Configurează un dispozitiv de buclă numai-pentru-citire.

--direct-io[=on|off]
    Activează sau dezactivează In/Ieș directă pentru fișierul de rezervă. Valoarea implicită este off. Dacă se specifică fie --direct-io, fie --direct-io=on, se activează. Dar se poate furniza --direct-io=off pentru a o dezactiva în mod explicit.

-v, --verbose
    Modul super-descriptiv.

-l, --list
    Dacă se specifică un dispozitiv de buclă sau opțiunea -a, 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, --output, --noheadings, --raw și --json.

-O, --output coloana[,coloana]...
    Specifică coloanele care urmează să fie afișate pentru ieșirea --list. Utilizați --help pentru a obține o listă cu toate coloanele acceptate.

--output-all
    Afișează toate coloanele disponibile.

-n, --noheadings
    Nu afișează titlurile pentru formatul de ieșire --list.

--raw
    Utilizează formatul de ieșire brut --list.

-J, --json
    Utilizează formatul JSON pentru ieșirea --list.

CRIPTARE

Cryptoloop is no longer supported in favor of dm-crypt. For more details see cryptsetup(8).

STARE DE IEȘIRE

losetup returns 0 on success, nonzero on failure. When losetup displays the status of a loop device, it returns 1 if the device is not configured and 2 if an error occurred which prevented determining the status of the device.

NOTE

Începând cu versiunea 2.37, losetup utilizează ioctl LOOP_CONFIGURE pentru a configura un nou dispozitiv de buclă 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
    activează ieșirea de depanare.

FIȘIERE

/dev/loop[0..N]
    dispozitive de bloc buclă

/dev/loop-control
    dispozitiv de control al buclei

EXEMPLU

Următoarele comenzi pot fi folosite ca exemplu de utilizare a dispozitivului de buclă.

    # 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

pe baza versiunii originale de la

RAPORTAREA ERORILOR

Pentru rapoarte de eroare, folosiți sistemul de urmărire al erorilor la

DISPONIBILITATE

Comanda losetup face parte din pachetul util-linux care poate fi descărcat de la