.\" -*- coding: UTF-8 -*-
'\" t
.\"     Title: losetup
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.15
.\"      Date: 2022-07-20
.\"    Manual: System Administration
.\"    Source: util-linux 2.38.1
.\"  Language: English
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH LOSETUP 8 "20 lipca 2022 r." "util\-linux 2.38.1" "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 \- konfiguracja i sterowanie urządzeniami pętli (loop)
.SH SKŁADNIA
.sp
Pobieranie informacji:
.sp
\fBlosetup\fP [\fIurządzenie_loop\fP]
.sp
\fBlosetup\fP \fB\-l\fP [\fB\-a\fP]
.sp
\fBlosetup\fP \fB\-j\fP \fIplik\fP [\fB\-o\fP \fIofset\fP]
.sp
Odłączenie urządzenia loop:
.sp
\fBlosetup\fP \fB\-d\fP \fIurządzenie_loop\fP ...
.sp
Odłączenie wszystkich przypisanych urządzeń loop:
.sp
\fBlosetup\fP \fB\-D\fP
.sp
Konfigurowanie urządzenia loop:
.sp
\fBlosetup\fP [\fB\-o\fP \fIoffset\fP] [\fB\-\-sizelimit\fP \fIsize\fP] [\fB\-\-sector\-size\fP
\fIsize\fP] [\fB\-Pr\fP] [\fB\-\-show\fP] \fB\-f\fP|\fIloopdev file\fP
.sp
Zmiana rozmiaru urządzenia loop:
.sp
\fBlosetup\fP \fB\-c\fP \fIurządzenie_loop\fP
.SH OPIS
.sp
\fBlosetup\fP służy do kojarzenia urządzeń loop (pętli) z plikami zwykłymi lub
urządzeniami blokowymi, do odłączania urządzeń loop i sprawdzania ich
stanu. Jeżeli podano tylko argument \fIurządzenie_loop\fP, to pokazywany jest
stan odpowiedniego urządzenia loop. Jeśli nie podano żadnej opcji, to
wyświetlane są wszystkie urządzenia loop.
.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\(cqs possible to create more 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
The loop device setup is not an atomic operation when used with \fB\-\-find\fP,
and \fBlosetup\fP does not protect this operation by any lock. The number of
attempts is internally restricted to a maximum of 16. It is recommended to
use for example \fBflock\fP(1) to avoid a collision in heavily parallel use
cases.
.SH OPCJE
.sp
Po argumentach \fIrozmiar\fP i \fIofset\fP mogą występować sufiksy binarne (2^N):
KiB (=1024), MiB (=1024*1024) i tak dalej dla GiB, TiB, PiB, EiB, ZiB oraz
YiB (część "iB" jest opcjonalna, na przykład "K" ma to samo znaczenie, co
"KiB") lub decymalne (10^N): KB (=1000), MB (=1000*1000) i podobnie dla GB,
PB, EB, ZB oraz YB.
.sp
\fB\-a\fP, \fB\-\-all\fP
.RS 4
Show the status of all loop devices. Note that not all information is
accessible for non\-root users. See also \fB\-\-list\fP. The old output format (as
printed without \fB\-\-list\fP) is deprecated.
.RE
.sp
\fB\-d\fP, \fB\-\-detach\fP \fIurządzenie_loop\fP...
.RS 4
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 \fBEBUSY\fP error anymore if device is actively used
by system, but it is marked by autoclear flag and destroyed later.
.RE
.sp
\fB\-D\fP, \fB\-\-detach\-all\fP
.RS 4
Odłącza wszystkie przypisane urządzenia loop.
.RE
.sp
\fB\-f\fP, \fB\-\-find\fP [\fIplik\fP]
.RS 4
Szuka pierwszego nieużywanego urządzenia loop. Jeśli podano argument
\fIplik\fP, to używa tego znalezionego urządzenia jako urządzenia loop. W
przeciwnym wypadku wyświetla jego nazwę.
.RE
.sp
\fB\-\-show\fP
.RS 4
Wyświetla nazwę przypisanego urządzenia loop, jeśli podano opcję \fB\-f\fP i
argument \fIplik\fP.
.RE
.sp
\fB\-L\fP, \fB\-\-nooverlap\fP
.RS 4
Check for conflicts between loop devices to avoid situation when the same
backing file is shared between more loop devices. If the file is already
used by another device then re\-use the device rather than a new one. The
option makes sense only with \fB\-\-find\fP.
.RE
.sp
\fB\-j\fP, \fB\-\-associated\fP \fIplik\fP [\fB\-o\fP \fIofset\fP]
.RS 4
Wwyświetla stan wszystkich urządzeń loop skojarzonym z podanym \fIplik\fPiem.
.RE
.sp
\fB\-o\fP, \fB\-\-offset\fP \fIofset\fP
.RS 4
The data start is moved \fIoffset\fP bytes into the specified file or
device. The \fIoffset\fP may be followed by the multiplicative suffixes; see
above.
.RE
.sp
\fB\-\-sizelimit\fP \fIrozmiar\fP
.RS 4
The data end is set to no more than \fIsize\fP bytes after the data start. The
\fIsize\fP may be followed by the multiplicative suffixes; see above.
.RE
.sp
\fB\-b\fP, \fB\-\-sector\-size\fP \fIrozmiar\fP
.RS 4
Set the logical sector size of the loop device in bytes (since Linux
4.14). The option may be used when creating a new loop device as well as a
stand\-alone command to modify sector size of the already existing loop
device.
.RE
.sp
\fB\-c\fP, \fB\-\-set\-capacity\fP \fIurządzenie_loop\fP
.RS 4
Wymusza na sterowniku loop ponowne odczytanie rozmiaru pliku skojarzonego z
podanym urządzeniem loop.
.RE
.sp
\fB\-P\fP, \fB\-\-partscan\fP
.RS 4
Force the kernel to scan the partition table on a newly created loop
device. Note that the partition table parsing depends on sector sizes. The
default is sector size is 512 bytes, otherwise you need to use the option
\fB\-\-sector\-size\fP together with \fB\-\-partscan\fP.
.RE
.sp
\fB\-r\fP, \fB\-\-read\-only\fP
.RS 4
Konfiguruje urządzenie loop jako tylko do odczytu.
.RE
.sp
\fB\-\-direct\-io\fP[\fB=on\fP|\fBoff\fP]
.RS 4
Enable or disable direct I/O for the backing file. The optional argument can
be either \fBon\fP or \fBoff\fP. If the optional argument is omitted, it defaults
to \fBon\fP.
.RE
.sp
\fB\-v\fP, \fB\-\-verbose\fP
.RS 4
Tryb szczegółowy (verbose).
.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 \fIcolumn\fP[,\fIcolumn\fP]...
.RS 4
Specify the columns that are to be printed for the \fB\-\-list\fP output. Use
\fB\-\-help\fP to get a list of all supported columns.
.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
.SH SZYFROWANIE
.sp
\fBCryptoloop jest przestarzały, zamiast niego zalecany jest dm\-crypt.\fP
Szczegóły można znaleźć w \fBcryptsetup\fP(8).
.SH "KOD 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 loop, 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 setup 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
.SH PLIKI
.sp
\fI/dev/loop[0..N]\fP
.RS 4
urządzenia blokowe urządzenia loop
.RE
.sp
\fI/dev/loop\-control\fP
.RS 4
urządzenie kontrolne urządzenia loop
.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=~/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
.fam
.fi
.if  n .RE
.SH AUTORZY
.sp
.MTO kzak\(atredhat.com "Karel Zak" ,
based on the original version from
.MTO tytso\(atathena.mit.edu "Theodore Ts\(cqo" .
.SH ZGŁASZANIE\ BŁĘDÓW
.sp
Raporty o błędach proszę zgłaszać pod adresem
.URL https://github.com/util\-linux/util\-linux/issues "" .
.SH DOSTĘPNOŚĆ
.sp
The \fBlosetup\fP command is part of the util\-linux package which can be
downloaded from
.URL https://www.kernel.org/pub/linux/utils/util\-linux/ "Linux Kernel Archive" .
.PP
.SH TŁUMACZENIE
Autorami polskiego tłumaczenia niniejszej strony podręcznika są:
Wojtek Kotwica <wkotwica@post.pl>
i
Robert Luberda <robert@debian.org>
.
.PP
Niniejsze tłumaczenie jest wolną dokumentacją. Bliższe informacje o warunkach
licencji można uzyskać zapoznając się z
.UR https://www.gnu.org/licenses/gpl-3.0.html
GNU General Public License w wersji 3
.UE
lub nowszej. Nie przyjmuje się ŻADNEJ ODPOWIEDZIALNOŚCI.
.PP
Błędy w tłumaczeniu strony podręcznika prosimy zgłaszać na adres listy
dyskusyjnej
.MT manpages-pl-list@lists.sourceforge.net
.ME .