table of contents
- bookworm 4.18.1-1
- bookworm-backports 4.24.0-2~bpo12+1
- testing 4.24.0-2
- unstable 4.24.0-2
ioctl_ficlonerange(2) | System Calls Manual | ioctl_ficlonerange(2) |
ИМЯ¶
ioctl_ficlonerange, ioctl_ficlone - сделать некоторые данные одного файла общими с другим файлом
БИБЛИОТЕКА¶
Стандартная библиотека языка C (libc, -lc)
СИНТАКСИС¶
#include <linux/fs.h> /* определения констант FICLONE* */ #include <sys/ioctl.h>
int ioctl(int dest_fd, FICLONERANGE, struct file_clone_range *arg); int ioctl(int dest_fd, FICLONE, int src_fd);
ОПИСАНИЕ¶
Если файловая система поддерживает общее файловое физическое хранилище для файлов («reflink»), то эту операцию ioctl(2) можно использовать для того, чтобы часть данных файла src_fd появилась в файле dest_fd в виде общего пространства на носителе, что быстрее по сравнению с созданием отдельной физической копии данных. Оба файла должны располагаться в одной файловой системе. Если выполняется запись в эту общую область, то файловая система должна гарантировать, что изменения будут видны только в файле, в который производится запись. Такое поведение часто называют как «копирование при записи» (copy on write).
Данный ioctl создаёт ссылку (reflink) на не более src_length байт из файлового дескриптора src_fd по смещению src_offset в файл dest_fd по смещению dest_offset, предоставляя её обоим файлам. Если src_length равно нулю, то ioctl делает ссылку на конец файла-источника. Данная информация передаётся в структуре следующего вида:
struct file_clone_range {
__s64 src_fd;
__u64 src_offset;
__u64 src_length;
__u64 dest_offset; };
Клоны атомарны для одновременной записи, поэтому для получения корректной копии не нужно получать блокировки.
Операция FICLONE ioctl клонирует файлы полностью.
ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ¶
В случае ошибки возвращается -1, а errno устанавливается в значение ошибки.
ОШИБКИ¶
Возможные коды ошибок (помимо прочих):
- EBADF
- Дескриптор src_fd не открыт на чтение; dest_fd не открыт на запись или открыт только для добавления; файловая система, в которой находится src_fd, не поддерживает reflink.
- EINVAL
- Файловая система не поддерживает создание ссылок диапазонов в заданных файлах. Эта ошибка также может возникнуть, если файловый дескриптор представляет устройство, FIFO или сокет. Обычно, для дисковых файловых систем требуются, чтобы аргументы смещения и длины были выровнены по основному размеру блока. В XFS и Btrfs нет поддержки ссылок перекрывающихся диапазонов в одном и том же файле.
- EISDIR
- Один из файлов является каталогом и файловая система не поддерживает диапазоны для каталогов.
- EOPNOTSUPP
- Может возникать, если файловая система не поддерживает ссылки для файловых дескрипторов или когда файловый дескриптор ссылается на специальные иноды.
- EPERM
- Дескриптор dest_fd является неизменным.
- ETXTBSY
- Один из файлов является файлом подкачки. Файлы подкачки не могут содержаться в совместных хранилищах.
- EXDEV
- Дескрипторы dest_fd и src_fd находятся на разных смонтированных файловых системах.
СТАНДАРТЫ¶
Linux.
ИСТОРИЯ¶
Linux 4.5.
They were previously known as BTRFS_IOC_CLONE and BTRFS_IOC_CLONE_RANGE, and were private to Btrfs.
ПРИМЕЧАНИЯ¶
Так как для операции копирования-при-записи требуется выделение нового пространства в хранилище, операция fallocate(2) может отменить совместное использование общих блоков для гарантии того, что последующие операции записи не завершатся ошибкой из-за нехватки места на диске.
СМОТРИТЕ ТАКЖЕ¶
ПЕРЕВОД¶
Русский перевод этой страницы руководства разработал(и) Azamat Hackimov <azamat.hackimov@gmail.com>, Dmitriy S. Seregin <dseregin@59.ru>, Yuri Kozlov <yuray@komyakino.ru> и Иван Павлов <pavia00@gmail.com>
Этот перевод является свободной программной документацией; он распространяется на условиях общедоступной лицензии GNU (GNU General Public License - GPL, https://www.gnu.org/licenses/gpl-3.0.html версии 3 или более поздней) в отношении авторского права, но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ.
Если вы обнаружите какие-либо ошибки в переводе этой страницы руководства, пожалуйста, сообщите об этом разработчику(ам) по его(их) адресу(ам) электронной почты или по адресу списка рассылки русских переводчиков.
2 мая 2024 г. | Справочные страницы Linux 6.8 |