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.
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¶
Karel Zak <kzak@redhat.com>, pe baza versiunii
originale de la Theodore Ts’o
<tytso@athena.mit.edu>.
