'\" t
.\"     Title: losetup
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-06-16
.\"    Manual: Administracja systemem
.\"    Source: util-linux 2.42.2
.\"  Language: English
.\"
.TH "LOSETUP" "8" "2026-06-16" "util\-linux 2.42.2" "Administracja systemem"
.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 "NAZWA"
losetup \- konfiguruje i steruje urządzeniami pętli (loop)
.SH "SKŁADNIA"
.sp
Konfigurowanie urządzenia pętli:
.sp
\fBlosetup\fP [options] \fB\-f\fP|\fIloopdev file\fP
.sp
Pobieranie informacji:
.sp
\fBlosetup\fP [\fB\-l\fP] [\fB\-a\fP|\fIloopdev\fP]
.sp
\fBlosetup\fP \fB\-j\fP \fIplik\fP [\fB\-o\fP \fIprzesunięcie\fP]
.sp
Recalibrate the size of a loop device:
.sp
\fBlosetup\fP \fB\-c\fP \fIurządzenie\-pętli\fP
.sp
Detach loop devices:
.sp
\fBlosetup\fP \fB\-d\fP \fIurządzenie\-pętli\fP .\|.\|.
.sp
\fBlosetup\fP \fB\-D\fP
.sp
Prevent loop devices from getting listed:
.sp
\fBlosetup\fP \fB\-\-remove\fP \fIloopdev\fP .\|.\|.
.SH "OPIS"
.sp
\fBlosetup\fP służy do kojarzenia urządzeń pętli (loop) z plikami zwykłymi lub urządzeniami blokowymi, do odłączania urządzeń pętli i sprawdzania ich stanu. Jeżeli podano tylko argument \fIurządzenie\-pętli\fP, to pokazywany jest stan odpowiedniego urządzenia pętli. Jeśli nie podano żadnej opcji, to wyświetlane są wszystkie urządzenia pętli.
.sp
Proszę zauważyć, że stary format wyjściowy (tj. \fBlosetup \-a\fP), z łańcuchami znaków oddzielonymi od siebie przecinkami, jest przestarzały. Zamiast niego preferowanym formatem jest format \fB\-\-list\fP.
.sp
It is possible to create multiple independent loop devices for the same backing file. \fBThis setup may be dangerous, can cause data loss, corruption, and overwrites.\fP Use \fB\-\-nooverlap\fP with \fB\-\-find\fP during setup to avoid this problem.
.sp
Konfiguracja urządzenia pętli nie jest operacją niepodzielną, gdy korzysta się z opcji \fB\-\-find\fP, a \fBlosetup\fP nie chroni tej operacji żadną blokadą. Liczba prób jest wewnętrznie ograniczona do 16. Zaleca się korzystanie np. z \fBflock\fP(1), aby uniknąć kolizji w przypadku intensywnego korzystania równoległego.
.SH "OPCJE"
.sp
Po argumentach \fIrozmiar\fP i \fIprzesunięcie\fP mogą występować przyrostki oznaczające wielokrotność: KiB (=1024), MiB (=1024*1024), itd. dla GiB, TiB, PiB, EiB, ZiB i YiB (cząstka "iB" jest opcjonalna, tzn. np. "K" znaczy to samo co "KiB") lub przyrostki KB (=1000), MB (=1000*1000), itd. dla GB, TB, PB, EB, ZB i YB.
.sp
\fB\-a\fP, \fB\-\-all\fP
.RS 4
Wyświetla stan wszystkich urządzeń pętli. Proszę zauważyć, że nie wszystkie informacje są dostępne dla użytkowników niebędących administratorami. Patrz także \fB\-\-list\fP. Stary format wyjściowy (wypisywany, jeśli nie podano \fB\-\-list\fP) jest niezalecany.
.RE
.sp
\fB\-d\fP, \fB\-\-detach\fP \fIurządzenie\-pętli\fP.\|.\|.
.RS 4
Odłącza plik lub urządzenie związane z podanym(i) urządzeniem(\-ami) pętli. Proszę zauważyć, że Linux od v3.7 korzysta z "leniwego niszczenia urządzeń". Operacja odłączenia nie zwróci obecnie błędu \fBEBUSY\fP, gdy urządzenie jest aktywnie używane przez system, lecz jest znakowane znacznikiem automatycznego wyczyszczenia i jest niszczone później. Nawet jeśli urządzenie nie jest używane, urządzenie pętli może zostać zniszczone dopiero później. Jeśli konieczne jest poczekanie na całkowite usunięcie urządzenia pętli, po \fBlosetup\fP należy wywołać \fBudevadm settle\fP.
.RE
.sp
\fB\-D\fP, \fB\-\-detach\-all\fP
.RS 4
Odłącza wszystkie przypisane urządzenia pętli.
.RE
.sp
\fB\-f\fP, \fB\-\-find\fP [\fIplik\fP]
.RS 4
Szuka pierwszego nieużywanego urządzenia pętli. Jeśli podano argument \fIplik\fP, to używa tego znalezionego urządzenia jako urządzenia pętli. W przeciwnym wypadku wyświetla jego nazwę.
.RE
.sp
\fB\-\-show\fP
.RS 4
Wyświetla nazwę przypisanego urządzenia pętli, jeśli podano opcję \fB\-f\fP i argument \fIplik\fP.
.RE
.sp
\fB\-L\fP, \fB\-\-nooverlap\fP
.RS 4
Sprawdza pod kątem konfliktów, aby uniknąć sytuacji, gdy ten sam powiązany plik jest dzielony pomiędzy większą liczbą urządzeń pętli. Jeśli plik jest już używany przez inne urządzenie, to zamiast użyć nowego, program skorzysta ponownie z istniejącego urządzenia. Opcja ma sens tylko w połączeniu z \fB\-\-find\fP.
.RE
.sp
\fB\-j\fP, \fB\-\-associated\fP \fIplik\fP [\fB\-o\fP \fIprzesunięcie\fP]
.RS 4
Wyświetla stan wszystkich urządzeń pętli skojarzonych z podanych \fIplikiem\fP.
.RE
.sp
\fB\-o\fP, \fB\-\-offset\fP \fIprzesunięcie\fP
.RS 4
Początek danych przesuwany jest o \fIprzesunięcie\fP bajtów podanego pliku lub urządzenia. Po \fIprzesunięciu\fP można podać przyrostki oznaczające wielokrotność; zob. wyżej.
.RE
.sp
\fB\-\-loop\-ref\fP \fIłańcuch\fP
.RS 4
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 \fIstring\fP. 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 \fB\-\-output\fP +REF) and it is restricted to 64 bytes.
.RE
.sp
\fB\-\-sizelimit\fP \fIrozmiar\fP
.RS 4
Koniec danych jest ustawiany na nie więcej niż \fIrozmiar\fP bajtów, licząc od początku danych. Po \fIrozmiarze\fP można podać przyrostki oznaczające wielokrotność; zob. wyżej.
.RE
.sp
\fB\-b\fP, \fB\-\-sector\-size\fP \fIrozmiar\fP
.RS 4
Ustawia rozmiar sektora logicznego urządzenia pętli w bajtach (od Linuksa 4.14). Opcję można podać przy tworzeniu nowego urządzenia pętli, jak również jako samodzielne polecenie, służące do modyfikacji rozmiaru sektora istniejącego urządzenia pętli.
.RE
.sp
\fB\-c\fP, \fB\-\-set\-capacity\fP \fIurządzenie\-pętli\fP
.RS 4
Wymusza na sterowniku pętli ponowne odczytanie rozmiaru pliku skojarzonego z podanym urządzeniem pętli.
.RE
.sp
\fB\-P\fP, \fB\-\-partscan\fP
.RS 4
Zmusza jądro do przeskanowania tablicy partycji na tworzonym urządzeniu pętli. Proszę zauważyć, że przetwarzanie tablicy partycji jest zależne od rozmiarów sektora. Domyślnym rozmiarem sektora są 512 bajty, w innych przypadkach konieczne jest użycie opcji \fB\-\-sector\-size\fP łącznie z \fB\-\-partscan\fP.
.RE
.sp
\fB\-r\fP, \fB\-\-read\-only\fP
.RS 4
Konfiguruje urządzenie pętli jako tylko do odczytu.
.RE
.sp
\fB\-\-direct\-io\fP[\fB=on\fP|\fBoff\fP]
.RS 4
Włącza lub wyłącza bezpośredni dostęp wejścia/wyjścia do powiązanego pliku. Domyślnym ustawieniem jest wyłączenie (\fBoff\fP). Podanie \fB\-\-direct\-io\fP lub \fB\-\-direct\-io=on\fP włączy tę opcję. Aby jawnie ją wyłączyć, można podać \fB\-\-direct\-io=off\fP.
.RE
.sp
\fB\-l\fP, \fB\-\-list\fP
.RS 4
Jeśli podano urządzenie loop lub opcję \fB\-a\fP, to wyświetla domyślne kolumny albo dla podanego urządzenia, albo dla wszystkich urządzeń loop. Domyślnie wyświetla informacje o wszystkich urządzeniach. Patrz także \fB\-\-output\fP, \fB\-\-noheadings\fP \fB\-\-raw\fP oraz \fB\-\-json\fP.
.RE
.sp
\fB\-O\fP, \fB\-\-output\fP \fIkolumna\fP[,\fIkolumna\fP].\|.\|.
.RS 4
Określa kolumny, które będą wypisane przez opcję \fB\-\-list\fP. Opcja \fB\-\-help\fP wypisze listę wszystkich obsługiwanych kolumn.
.RE
.sp
\fB\-\-output\-all\fP
.RS 4
Wypisuje wszystkie dostępne kolumny.
.RE
.sp
\fB\-n\fP, \fB\-\-noheadings\fP
.RS 4
Nie wyświetla nagłówków w wyjściu formatu opcji \fB\-\-list\fP.
.RE
.sp
\fB\-\-raw\fP
.RS 4
Używa surowego formatu wyjściowego w \fB\-\-list\fP.
.RE
.sp
\fB\-J\fP, \fB\-\-json\fP
.RS 4
Używa formatu JSON w wyjściu \fB\-\-list\fP.
.RE
.sp
\fB\-\-remove\fP \fIloopdev\fP.\|.\|.
.RS 4
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, \fB\-\-detach\fP is sufficient for normal use. See the \fBLOOP DEVICE LIFECYCLE\fP section below.
.RE
.sp
\fB\-h\fP, \fB\-\-help\fP
.RS 4
Wyświetla ten tekst i wychodzi.
.RE
.sp
\fB\-V\fP, \fB\-\-version\fP
.RS 4
Wyświetla wersję i wychodzi.
.RE
.SH "LOOP DEVICE LIFECYCLE"
.sp
Loop devices go through several states during their lifecycle:
.sp
\fBCreation\fP
.RS 4
When \fBlosetup\fP associates a loop device with a backing file, it automatically creates the device node (e.g., \fI/dev/loop0\fP) if it doesn\(cqt already exist. This happens on\-demand when you use options like \fB\-f\fP or specify a loop device explicitly. The device is created using the \fBLOOP_CTL_ADD\fP ioctl.
.RE
.sp
\fBDetachment\fP
.RS 4
The \fB\-d\fP (\fB\-\-detach\fP) option disassociates the backing file from the loop device using the \fBLOOP_CLR_FD\fP ioctl. After detachment, the loop device node remains in \fI/dev\fP and can be reused for another backing file. Use \fBlsblk \-a\fP to see all loop device nodes, including unused ones.
.RE
.sp
\fBRemoval\fP
.RS 4
The \fB\-\-remove\fP option completely removes the loop device node from the system using the \fBLOOP_CTL_REMOVE\fP ioctl. The device must be detached first (not associated with any backing file). After removal, the device node disappears from \fI/dev\fP.
.RE
.SH "SZYFROWANIE"
.sp
\fBCryptoloop jest przestarzały, zamiast niego zalecany jest dm\-crypt\fP. Szczegóły można znaleźć w podręczniku \fBcryptsetup\fP(8).
.SH "STATUS ZAKOŃCZENIA"
.sp
\fBlosetup\fP zwraca 0, jeśli zakończyło się pomyślnie, a wartość niezerową w przypadku błędu. Gdy \fBlosetup\fP wyświetla stan urządzenia pętli, to zwraca 1, jeśli urządzenie nie jest skonfigurowane, lub 2, gdy wystąpił błąd uniemożliwiający określenie stanu urządzenia.
.SH "UWAGI"
.sp
Since version 2.37 \fBlosetup\fP uses \fBLOOP_CONFIGURE\fP ioctl to set up a new loop device by one ioctl call. The old versions use \fBLOOP_SET_FD\fP and \fBLOOP_SET_STATUS64\fP ioctls to do the same.
.SH "ŚRODOWISKO"
.sp
\fBLOOPDEV_DEBUG\fP=all
.RS 4
włącza wyjście debugowania.
.RE
.sp
\fBLIBSMARTCOLS_DEBUG\fP=all
.RS 4
włącza wyjście debugowania libsmartcols.
.RE
.sp
\fBLIBSMARTCOLS_DEBUG_PADDING\fP=on
.RS 4
używa widocznych znaków wypełnienia.
.RE
.SH "PLIKI"
.sp
\fI/dev/loop[0..N]\fP
.RS 4
urządzenia blokowe pętli
.RE
.sp
\fI/dev/loop\-control\fP
.RS 4
urządzenie kontrolne pętli
.RE
.SH "PRZYKŁAD"
.sp
Jako przykład użycia urządzenia loop posłużą poniższe polecenia:
.sp
.if n .RS 4
.nf
.fam C
# dd if=/dev/zero of=~/plik.img bs=1024k count=10
# losetup \-\-find \-\-show ~/plik.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 "AUTORZY"
.sp
.MTO "kzak\(atredhat.com" "Karel Zak" ","
korzystając z pierwotnej wersji
.MTO "tytso\(atathena.mit.edu" "Theodore\(cqa Ts\(cqo" "."
.SH "ZGŁASZANIE BŁĘDÓW"
.sp
Problemy należy zgłaszać w \c
.URL "https://github.com/util\-linux/util\-linux/issues" "systemie śledzenia błędów" "."
.SH "DOSTĘPNOŚĆ"
.sp
Polecenie \fBlosetup\fP jest częścią pakietu util\-linux, który można pobrać ze strony \c
.URL "https://www.kernel.org/pub/linux/utils/util\-linux/" "Archiwum jądra Linux" "."