.\" -*- coding: UTF-8 -*- .\" Copyright 2002 Urs Thuermann (urs@isnogud.escape.de) .\" and Copyright 2015 Michael Kerrisk .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH loop 4 "3 мая 2023 г." "Linux man\-pages 6.05.01" .SH ИМЯ loop, loop\-control \- закольцованные устройства .SH СИНТАКСИС .nf #include .fi .SH ОПИСАНИЕ Закольцованное устройство — это блочное устройство, которое отображает блоки данных обычного файла в файловой системе или другое блочное устройство. Это может быть полезно, например, для получения образа файловой системы, хранящегося в файле, в виде блочного устройства, которое может быть смонтировано с помощью команды \fBmount\fP(8). Это можно сделать так: .PP .in +4n .EX $ \fBdd if=/dev/zero of=file.img bs=1MiB count=10\fP $ \fBsudo losetup /dev/loop4 file.img\fP $ \fBsudo mkfs \-t ext4 /dev/loop4\fP $ \fBsudo mkdir /myloopdev\fP $ \fBsudo mount /dev/loop4 /myloopdev\fP .EE .in .PP Другой пример смотрите в \fBlosetup\fP(8). .PP Для шифрования и расшифровки каждому закольцованному устройству может быть назначена функция обмена. .PP Для закольцованного блочного устройства доступны следующие операции \fBioctl\fP(2): .TP \fBLOOP_SET_FD\fP Связывает закольцованное устройство с открытым файлом, чей файловый дескриптор передаётся в третьем аргументе \fBioctl\fP(2). .TP \fBLOOP_CLR_FD\fP Отвязывает закольцованное устройство от файлового дескриптора. .TP \fBLOOP_SET_STATUS\fP Назначает состояние (передаваемое в третьем аргументе \fBioctl\fP(2)) закольцованному устройству. Данный аргумент представляет собой указатель на структуру \fIloop_info\fP, определённую в \fI\fP следующим образом: .IP .in +4n .EX struct loop_info { int lo_number; /* ioctl r/o */ dev_t lo_device; /* ioctl r/o */ unsigned long lo_inode; /* ioctl r/o */ dev_t lo_rdevice; /* ioctl r/o */ int lo_offset; int lo_encrypt_type; int lo_encrypt_key_size; /* ioctl w/o */ int lo_flags; /* ioctl r/w (r/o before Linux 2.6.25) */ char lo_name[LO_NAME_SIZE]; unsigned char lo_encrypt_key[LO_KEY_SIZE]; /* ioctl w/o */ unsigned long lo_init[2]; char reserved[4]; }; .EE .in .IP Типом шифрования (\fIlo_encrypt_type\fP) должно быть одно из значений: \fBLO_CRYPT_NONE\fP, \fBLO_CRYPT_XOR\fP, \fBLO_CRYPT_DES\fP, \fBLO_CRYPT_FISH2\fP, \fBLO_CRYPT_BLOW\fP, \fBLO_CRYPT_CAST128\fP, \fBLO_CRYPT_IDEA\fP, \fBLO_CRYPT_DUMMY\fP, \fBLO_CRYPT_SKIPJACK\fP или \fBLO_CRYPT_CRYPTOAPI\fP (начиная с Linux 2.6.0). .IP Поле \fIlo_flags\fP представляет собой битовую маску, в которой может быть ноль или несколько следующих значений: .RS .TP \fBLO_FLAGS_READ_ONLY\fP Закольцованное устройство доступно только для чтения. .TP \fBLO_FLAGS_AUTOCLEAR\fP (начиная с Linux 2.6.25) .\" commit 96c5865559cee0f9cbc5173f3c949f6ce3525581 Закольцованное устройство автоматически уничтожится после закрытия. .TP \fBLO_FLAGS_PARTSCAN\fP (начиная с Linux 3.2) .\" commit e03c8dd14915fabc101aa495828d58598dc5af98 Разрешено автоматическое сканирования разделов. .TP \fBLO_FLAGS_DIRECT_IO\fP (начиная с Linux 4.10) .\" commit 2e5ab5f379f96a6207c45be40c357ebb1beb8ef3 Use direct I/O mode to access the backing file. .RE .IP The only \fIlo_flags\fP that can be modified by \fBLOOP_SET_STATUS\fP are \fBLO_FLAGS_AUTOCLEAR\fP and \fBLO_FLAGS_PARTSCAN\fP. .TP \fBLOOP_GET_STATUS\fP Получить состояние закольцованного устройства. В третьем аргументе \fBioctl\fP(2) должен быть задан указатель на структуру \fIstruct loop_info\fP. .TP \fBLOOP_CHANGE_FD\fP (начиная с Linux 2.6.5) Поменять источник данных (backing store) закольцованного устройства на новый файл, определяемый файловым дескриптором, указанным в третьем аргументе \fBioctl\fP(2), представленный целым числом. Данная операция допустима только, если закольцованное устройство доступно только на чтение и новый источник данных имеет тот же размер и тип, использованный ранее. .TP \fBLOOP_SET_CAPACITY\fP (начиная с Linux 2.6.30) .\" commit 53d6660836f233df66490707365ab177e5fb2bb4 Изменить размер используемого (live) закольцованного устройства. Можно изменить размер используемого источника данных, а затем применить эту операцию для того, чтобы драйвер закольцованных устройств учёл новый размер. У этой операции нет аргументов. .TP \fBLOOP_SET_DIRECT_IO\fP (начиная с Linux 4.10) .\" commit ab1cb278bc7027663adbfb0b81404f8398437e11 Set DIRECT I/O mode on the loop device, so that it can be used to open backing file. The (third) \fBioctl\fP(2) argument is an unsigned long value. A nonzero represents direct I/O mode. .TP \fBLOOP_SET_BLOCK_SIZE\fP (начиная с Linux 4.14) .\" commit 89e4fdecb51cf5535867026274bc97de9480ade5 Set the block size of the loop device. The (third) \fBioctl\fP(2) argument is an unsigned long value. This value must be a power of two in the range [512,pagesize]; otherwise, an \fBEINVAL\fP error results. .TP \fBLOOP_CONFIGURE\fP (начиная с Linux 5.8) .\" commit 3448914e8cc550ba792d4ccc74471d1ca4293aae Setup and configure all loop device parameters in a single step using the (third) \fBioctl\fP(2) argument. This argument is a pointer to a \fIloop_config\fP structure, defined in \fI\fP as: .IP .in +4n .EX struct loop_config { __u32 fd; __u32 block_size; struct loop_info64 info; __u64 __reserved[8]; }; .EE .in .IP In addition to doing what \fBLOOP_SET_STATUS\fP can do, \fBLOOP_CONFIGURE\fP can also be used to do the following: .RS .IP \[bu] 3 set the correct block size immediately by setting \fIloop_config.block_size\fP; .IP \[bu] explicitly request direct I/O mode by setting \fBLO_FLAGS_DIRECT_IO\fP in \fIloop_config.info.lo_flags\fP; and .IP \[bu] explicitly request read\-only mode by setting \fBLO_FLAGS_READ_ONLY\fP in \fIloop_config.info.lo_flags\fP. .RE .PP Начиная с Linux 2.6, появилось две новые операции \fBioctl\fP(2): .TP \fBLOOP_SET_STATUS64\fP, \fBLOOP_GET_STATUS64\fP Они подобны описанным выше \fBLOOP_SET_STATUS\fP и \fBLOOP_GET_STATUS\fP, но используют структуру \fIloop_info64\fP, в которой есть несколько дополнительных полей, а некоторым другим полям назначены типы с большим диапазоном значений: .IP .in +4n .EX struct loop_info64 { uint64_t lo_device; /* ioctl r/o */ uint64_t lo_inode; /* ioctl r/o */ uint64_t lo_rdevice; /* ioctl r/o */ uint64_t lo_offset; uint64_t lo_sizelimit; /* bytes, 0 == max available */ uint32_t lo_number; /* ioctl r/o */ uint32_t lo_encrypt_type; uint32_t lo_encrypt_key_size; /* ioctl w/o */ uint32_t lo_flags; i /* ioctl r/w (r/o before Linux 2.6.25) */ uint8_t lo_file_name[LO_NAME_SIZE]; uint8_t lo_crypt_name[LO_NAME_SIZE]; uint8_t lo_encrypt_key[LO_KEY_SIZE]; /* ioctl w/o */ uint64_t lo_init[2]; }; .EE .in .SS /dev/loop\-control .\" commit 770fe30a46a12b6fb6b63fbe1737654d28e84844 Начиная с Linux 3.1, ядро предоставляет устройство \fI/dev/loop\-control\fP, которое позволяет приложению динамически находить свободное устройство, добавлять и удалять закольцованные устройства из системы. Для выполнения этих операций сначала открывается \fI/dev/loop\-control\fP, а затем выполняется одна из следующих операций \fBioctl\fP(2): .TP \fBLOOP_CTL_GET_FREE\fP Выделяет или ищет свободное закольцованное устройства для работы. При успешном выполнении возвращается номер устройства. У операции нет аргументов. .TP \fBLOOP_CTL_ADD\fP Добавляет новое закольцованное устройство; номер устройства передаётся в виде длинного целого в третьем аргументе \fBioctl\fP(2). При успешном выполнении возвращается индекс устройства. Если устройство уже выделено, то вызов завершается с ошибкой \fBEEXIST\fP. .TP \fBLOOP_CTL_REMOVE\fP Удаляет закольцованное устройство; номер устройства передаётся в виде длинного целого в третьем аргументе \fBioctl\fP(2). При успешном выполнении возвращается номер устройства. Если устройство используется, то вызов завершается с ошибкой \fBEBUSY\fP. .SH ФАЙЛЫ .TP \fI/dev/loop*\fP Специальные закольцованные файлы устройств. .SH ПРИМЕРЫ Программа, представленная ниже, используется устройство \fI/dev/loop\-control\fP для поиска свободного закольцованного устройства, открывает закольцованное устройство, открывает файл, который нужно использовать в качестве источника данных, и связывает закольцованное устройство с источником. Демонстрация работы программы: .PP .in +4n .EX $ \fBdd if=/dev/zero of=file.img bs=1MiB count=10\fP 10+0 records in 10+0 records out 10485760 bytes (10 MB) copied, 0.00609385 s, 1.7 GB/s $ \fBsudo ./mnt_loop file.img\fP loopname = /dev/loop5 .EE .in .SS "Исходный код программы" \& .EX #include #include #include #include #include #include \& #define errExit(msg) do { perror(msg); exit(EXIT_FAILURE); \e } while (0) \& int main(int argc, char *argv[]) { int loopctlfd, loopfd, backingfile; long devnr; char loopname[4096]; \& if (argc != 2) { fprintf(stderr, "Usage: %s backing\-file\en", argv[0]); exit(EXIT_FAILURE); } \& loopctlfd = open("/dev/loop\-control", O_RDWR); if (loopctlfd == \-1) errExit("open: /dev/loop\-control"); \& devnr = ioctl(loopctlfd, LOOP_CTL_GET_FREE); if (devnr == \-1) errExit("ioctl\-LOOP_CTL_GET_FREE"); \& sprintf(loopname, "/dev/loop%ld", devnr); printf("loopname = %s\en", loopname); \& loopfd = open(loopname, O_RDWR); if (loopfd == \-1) errExit("open: loopname"); \& backingfile = open(argv[1], O_RDWR); if (backingfile == \-1) errExit("open: backing\-file"); \& if (ioctl(loopfd, LOOP_SET_FD, backingfile) == \-1) errExit("ioctl\-LOOP_SET_FD"); \& exit(EXIT_SUCCESS); } .EE .SH "СМ. ТАКЖЕ" \fBlosetup\fP(8), \fBmount\fP(8) .PP .SH ПЕРЕВОД Русский перевод этой страницы руководства был сделан Artyom Kunyov , Azamat Hackimov , Dmitry Bolkhovskikh , Katrin Kutepova , Konstantin Shvaykovskiy , Yuri Kozlov и Иван Павлов . .PP Этот перевод является бесплатной документацией; прочитайте .UR https://www.gnu.org/licenses/gpl-3.0.html Стандартную общественную лицензию GNU версии 3 .UE или более позднюю, чтобы узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ. .PP Если вы обнаружите ошибки в переводе этой страницы руководства, пожалуйста, отправьте электронное письмо на .MT man-pages-ru-talks@lists.sourceforge.net .ME .