.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.\" This file is distributed under the same license as original manpage
.\" Copyright of the original manpage:
.\" Copyright © 1993 Theodore Ts'o, Eric Young (GPL-2+)
.\" Copyright © of Polish translation:
.\" Wojtek Kotwica (PTM) <wkotwica@post.pl>, 2000.
.\" Robert Luberda <robert@debian.org>, 2014.
.TH LOSETUP 8 "lipiec 2003" util\-linux "Administracja systemem"
.SH NAZWA
losetup \- konfiguracja i sterowanie urządzeniami pętli (loop)
.SH SKŁADNIA
.ad l
Pobieranie informacji:
.sp
.in +5
\fBlosetup\fP \fIurządzenie_loop\fP
.sp
\fBlosetup \-a\fP
.sp
\fBlosetup \-j\fP \fIplik\fP [\fB\-o\fP \fIofset\fP]
.sp
.in -5
Usuwanie urządzenia loop:
.sp
.in +5
\fBlosetup \-d\fP \fIurządzenie_loop\fP...
.sp
.in -5
Wyświetlanie nazwy pierwszego nieużywanego urządzenia loop:
.sp
.in +5
\fBlosetup \-f\fP
.sp
.in -5
Konfigurowanie urządzenia loop:
.sp
.in +5
\fBlosetup\fP [{\fB\-e\fP|\fB\-E\fP} \fIszyfrowanie\fP] [\fB\-o\fP \fIofset\fP] [\fB\-\-sizelimit\fP
\fIrozmiar\fP]
.in +8
[\fB\-p\fP \fIpfd\fP] [\fB\-r\fP] {\fB\-f\fP[\fB\-\-show\fP]|\fIurządzenie_loop\fP} \fIplik\fP
.sp
.in -13
Zmiana rozmiaru urządzenia loop:
.sp
.in +5
\fBlosetup \-c\fP \fIurządzenie_loop\fP
.in -5
.ad b
.SH OPIS
\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.

.SS Szyfrowanie
Jest możliwe podanie funkcji przesyłu (do szyfrowania/odszyfrowywania lub
innych celów) za pomocą opcji \fB\-E\fP lub \fB\-e\fP. Istnieją dwa mechanizmy
umożliwiające podanie wybranego sposobu szyfrowania: przez numer i przez
nazwę. Jeśli szyfrowanie jest podawane przez numer, to należy się upewnić,
że jądro Linuksa zna szyfrowanie o danym numerze, być może będzie potrzebne
nałożenie łaty na jądro. Standardowe numery, które zawsze są obecne to 0
(brak szyfrowania) i 1 (szyfrowanie XOR). Gdy załadowany (lub wkompilowany)
jest moduł cryptoloop, to używa numeru 18. Moduł cryptoloop pobierze nazwę
typu szyfrowania i wyszuka moduł, nadający się do przeprowadzenia
szyfrowania.
.SH OPCJE
Po argumentach \fIrozmiar\fP i \fIofset\fP mogą występować sufiksy binarne (2^N):
KiB, MiB, GiB, TiB, PiB oraz EiB (część "iB" jest opcjonalna, na przykład
"K" ma to samo znaczenie, co "KiB") lub decymalne (10^N):  KB, MB, GB, PB
oraz EB.

.IP "\fB\-a, \-\-all\fP"
pokazuje stan wszystkich urządzeń loop
.IP "\fB\-c, \-\-set\-capacity\fP \fIurządzenie_loop\fP"
wymusza na sterowniku loop ponowne odczytanie rozmiaru pliku skojarzonego z
podanym urządzeniem loop
.IP "\fB\-d, \-\-detach\fP \fIurządzenie_loop\fP..."
odłącza plik lub urządzenie skojarzone z podanym urządzeniem (urządzeniami)
loop.
.IP "\fB\-e, \-E, \-\-encryption \fP\fItyp_szyfrowania\fP"
włącza szyfrowanie danych z podaną nazwą lub numerem
.IP "\fB\-f, \-\-find\fP"
szuka pierwszego nieużywanego urządzenia loop. Jeśli podano argument
\fIplik\fP, to używa tego znalezionego urządzenia. W przeciwnym wypadku
wyświetla jego nazwę.
.IP "\fB\-h, \-\-help\fP"
wyświetla pomoc
.IP "\fB\-j, \-\-associated \fP\fIplik\fP"
wyświetla stan wszystkich urządzeń loop skojarzonym z podanym \fIplik\fPiem.
.IP "\fB\-k, \-\-keybits \fP\fInum\fP"
ustawia na \fInum\fP liczbę\ bitów używanych w kluczu
.IP "\fB\-N, \-\-nohashpass\fP"
nie używa funkcji mieszającej (hash) do haseł. Domyślnie systemy Debiana
używają funkcji mieszającej do haseł, inne systemy zazwyczaj tego nie robią.
.IP "\fB\-o, \-\-offset \fP\fIofset\fP"
początek danych przesuwany jest \fIofset\fP bajtów w podanego pliku lub
urządzenia
.IP "\fB\-\-sizelimit \fP\fIrozmiar\fP"
koniec danych jest ustawiany na nie więcej niż\ \fIrozmiar\fP bajtów, licząc od
początku danych
.IP "\fB\-p, \-\-pass\-fd \fP\fInum\fP"
czyta hasło z deskryptora pliku o podanym numerze \fInum\fP, zamiast czytać je
z terminalu
.IP "\fB\-r, \-\-read\-only\fP"
konfiguruje urządzenie loop jako tylko do odczytu
.IP \fB\-\-show\fP
wyświetla nazwę urządzenia, jeśli podano opcję \fI\-f\fP i argument \fIplik\fP.

Krótka postać tej opcji (\fB\-s\fP) jest przestarzała, gdyż koliduje z
implementacją Loop\-AES, w której oznacza to samo co \fB\-\-sizelimit\fP.
.IP "\fB\-v, \-\-verbose\fP"
tryb szczegółowy

.SH "WARTOŚĆ ZWRACANA"
\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 programowi \fBlosetup\fP określenie stanu urządzenia.

.SH PLIKI
.nf
/dev/loop0,/dev/loop1,...   urządzenia loop (numer główny=7)
.fi
.SH PRZYKŁAD
Przy posługiwaniu się modułem ładowalnym konieczne jest wcześniejsze
załadowanie go poleceniem
.IP
# modprobe loop
.LP
Być może potrzebne będą moduły szyfrowania.
.IP
# modprobe des # modprobe cryptoloop
.LP
Jako przykład użycia urządzenia loop posłużą poniższe polecenia:
.nf
.IP
# dd if=/dev/zero of=/file bs=1k count=100
# losetup \-e des /dev/loop0 /file
Hasło:
Inicjacja (do 16 cyfr heksadecymalnych):
# mkfs \-t ext2 /dev/loop0 100
# mount \-t ext2 /dev/loop0 /mnt
 ...
# umount /dev/loop0
# losetup \-d /dev/loop0
.fi
.LP
Przy posługiwaniu się modułem ładowalnym można usunąć z pamięci załadowany
moduł poleceniem
.IP
# rmmod loop
.LP
.fi
.SH OGRANICZENIE
Szyfrowanie DES jest nieznośnie powolne. Z kolei XOR jest strasznie
słabe. Obecnie oba nie są bezpieczne. Niektóre z metod szyfrowania mogą
wymagać licencji, by móc ich używać.

Cryptoloop jest przestarzały, zamiast niego zalecany jest
dm\-crypt. Szczegóły można znaleźć w \fBcryptsetup\fP(8).
.SH DOSTĘPNOŚĆ
Polecenie losetup jest częścią pakietu util\-linux i jest dostępne pod
adresem ftp://ftp.kernel.org/pub/linux/utils/util\-linux/.
.\" .SH AUTHORS
.\" .nf
.\" Original version: Theodore Ts'o <tytso@athena.mit.edu>
.\" Original DES by: Eric Young <eay@psych.psy.uq.oz.au>
.\" .fi
.SH TŁUMACZENIE
Autorami polskiego tłumaczenia niniejszej strony podręcznika man są:
Wojtek Kotwica (PTM) <wkotwica@post.pl>
i
Robert Luberda <robert@debian.org>.
.PP
Polskie tłumaczenie jest częścią projektu manpages-pl; uwagi, pomoc, zgłaszanie błędów na stronie http://sourceforge.net/projects/manpages-pl/. Jest zgodne z wersją \fB 2.20.1 \fPoryginału.
