LOSETUP(8)

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

REZUMAT

Configurează un dispozitiv de buclă:

losetup [options] -f|loopdev file

Obține informații:

losetup [-l] [-a|loopdev]

losetup -j fișier [-o poziția]

Recalibrate the size of a loop device:

losetup -c dispozitiv-buclă

Detach loop devices:

losetup -d dispozitiv-buclă ...

losetup -D

Prevent loop devices from getting listed:

losetup --remove loopdev ...

DESCRIERE

losetup 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 dispozitiv-buclă, se afișează starea dispozitivului de buclă corespunzător. Dacă nu se dă nicio opțiune, sunt afișate toate dispozitivele de buclă.

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.

It is possible to create multiple independent loop devices for the same backing file. This setup may be dangerous, can cause data loss, corruption, and overwrites. Use --nooverlap with --find during setup to avoid this 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ă...
    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 EBUSY 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 udevadm settle după 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
    Set the reference string. The backwardly compatible default is to use the backing filename as a reference in the loop setup ioctl (aka lo_file_name). This option overrides this default behavior and sets the reference to the string. The reference may be used by udevd in /dev/loop/by-ref. The Linux kernel does not use the reference at all, but it could be used by some old utils that cannot read the backing file from sysfs. The reference is readable only for the root user (see --output +REF) and it is restricted to 64 bytes.

--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.

-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.

--remove loopdev...
    Remove the specified loop device(s). The loop device must be unused (not associated with any backing file). This option removes the device node from the system. In most cases, --detach is sufficient for normal use. See the LOOP DEVICE LIFECYCLE section below.

-h, --help
    Afișează acest mesaj de ajutor și iese.

-V, --version
    Afișează versiunea și iese.

LOOP DEVICE LIFECYCLE

Loop devices go through several states during their lifecycle:

Creation
    When losetup associates a loop device with a backing file, it automatically creates the device node (e.g., /dev/loop0) if it doesn’t already exist. This happens on-demand when you use options like -f or specify a loop device explicitly. The device is created using the LOOP_CTL_ADD ioctl.

Detachment
    The -d (--detach) option disassociates the backing file from the loop device using the LOOP_CLR_FD ioctl. After detachment, the loop device node remains in /dev and can be reused for another backing file. Use lsblk -a to see all loop device nodes, including unused ones.

Removal
    The --remove option completely removes the loop device node from the system using the LOOP_CTL_REMOVE ioctl. The device must be detached first (not associated with any backing file). After removal, the device node disappears from /dev.

CRIPTARE

Cryptoloop nu mai este acceptat în favoarea dm-crypt. Pentru mai multe detalii, consultați cryptsetup(8).

STARE DE IEȘIRE

losetup returnează 0 în caz de succes, diferit de zero în caz de eșec. Atunci când losetup 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.

NOTE

Since version 2.37 losetup uses LOOP_CONFIGURE ioctl to set up a new loop device by one ioctl call. The old versions use LOOP_SET_FD and LOOP_SET_STATUS64 ioctls to do the same.

MEDIU

LOOPDEV_DEBUG=all
    activează ieșirea de depanare.

LIBSMARTCOLS_DEBUG=all
    activează ieșirea de depanare a libsmartcols.

LIBSMARTCOLS_DEBUG_PADDING=on
    utilizează caractere de umplutură vizibile.

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

DISPONIBILITATE

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