.\" -*- coding: UTF-8 -*-
.\" Copyright (c) 2016, Oracle.  All rights reserved.
.\"
.\" SPDX-License-Identifier: GPL-2.0-or-later
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH ioctl_ficlonerange 2 "30 марта 2023 г." "Linux man\-pages 6.05.01" 
.SH ИМЯ
ioctl_ficlonerange, ioctl_ficlone \- сделать некоторые данные одного файла
общими с другим файлом
.SH LIBRARY
Standard C library (\fIlibc\fP, \fI\-lc\fP)
.SH СИНТАКСИС
.nf
\fB#include <linux/fs.h>\fP        /* определения констант \fBFICLONE*\fP */
\fB#include <sys/ioctl.h>\fP
.PP
\fBint ioctl(int \fP\fIdest_fd\fP\fB, FICLONERANGE, struct file_clone_range *\fP\fIarg\fP\fB);\fP
\fBint ioctl(int \fP\fIdest_fd\fP\fB, FICLONE, int \fP\fIsrc_fd\fP\fB);\fP
.fi
.SH ОПИСАНИЕ
Если файловая система поддерживает общее файловое физическое хранилище для
файлов («reflink»), то эту операцию \fBioctl\fP(2) можно использовать для того,
чтобы часть данных файла \fIsrc_fd\fP появилась в файле \fIdest_fd\fP в виде
общего пространства на носителе, что быстрее по сравнению с созданием
отдельной физической копии данных. Оба файла должны располагаться в одной
файловой системе. Если выполняется запись в эту общую область, то файловая
система должна гарантировать, что изменения будут видны только в файле, в
который производится запись. Такое поведение часто называют как «копирование
при записи» (copy on write).
.PP
Данный ioctl создаёт ссылку (reflink) на не более \fIsrc_length\fP байт из
файлового дескриптора \fIsrc_fd\fP по смещению \fIsrc_offset\fP в файл \fIdest_fd\fP
по смещению \fIdest_offset\fP, предоставляя её обоим файлам. Если \fIsrc_length\fP
равно нулю, то ioctl делает ссылку на конец файла\-источника. Данная
информация передаётся в структуре следующего вида:
.PP
.in +4n
.EX
struct file_clone_range {
    __s64 src_fd;
    __u64 src_offset;
    __u64 src_length;
    __u64 dest_offset;
};
.EE
.in
.PP
Клоны атомарны для одновременной записи, поэтому для получения корректной
копии не нужно получать блокировки.
.PP
Операция \fBFICLONE\fP ioctl клонирует файлы полностью.
.SH "ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ"
В случае ошибки возвращается \-1, а \fIerrno\fP устанавливается в значение
ошибки.
.SH ОШИБКИ
Возможные коды ошибок (помимо прочих):
.TP 
\fBEBADF\fP
Дескриптор \fIsrc_fd\fP не открыт на чтение; \fIdest_fd\fP не открыт на запись или
открыт только для добавления; файловая система, в которой находится
\fIsrc_fd\fP, не поддерживает reflink.
.TP 
\fBEINVAL\fP
Файловая система не поддерживает создание ссылок диапазонов в заданных
файлах. Эта ошибка также может возникнуть, если файловый дескриптор
представляет устройство, FIFO или сокет. Обычно, для дисковых файловых
систем требуются, чтобы аргументы смещения и длины были выровнены по
основному размеру блока. В XFS и Btrfs нет поддержки ссылок перекрывающихся
диапазонов в одном и том же файле.
.TP 
\fBEISDIR\fP
Один из файлов является каталогом и файловая система не поддерживает
диапазоны для каталогов.
.TP 
\fBEOPNOTSUPP\fP
Может возникать, если файловая система не поддерживает ссылки для файловых
дескрипторов или когда файловый дескриптор ссылается на специальные иноды.
.TP 
\fBEPERM\fP
Дескриптор \fIdest_fd\fP является неизменным.
.TP 
\fBETXTBSY\fP
Один из файлов является файлом подкачки. Файлы подкачки не могут содержаться
в совместных хранилищах.
.TP 
\fBEXDEV\fP
Дескрипторы \fIdest_fd\fP и \fIsrc_fd\fP находятся на разных смонтированных
файловых системах.
.SH СТАНДАРТЫ
Linux.
.SH ИСТОРИЯ
Linux 4.5.
.PP
They were previously known as \fBBTRFS_IOC_CLONE\fP and
\fBBTRFS_IOC_CLONE_RANGE\fP, and were private to Btrfs.
.SH ЗАМЕЧАНИЯ
Так как для операции копирования\-при\-записи требуется выделение нового
пространства в хранилище, операция \fBfallocate\fP(2) может отменить совместное
использование общих блоков для гарантии того, что последующие операции
записи не завершатся ошибкой из\-за нехватки места на диске.
.SH "СМ. ТАКЖЕ"
\fBioctl\fP(2)
.PP
.SH ПЕРЕВОД
Русский перевод этой страницы руководства был сделан
Azamat Hackimov <azamat.hackimov@gmail.com>,
Dmitriy S. Seregin <dseregin@59.ru>,
Yuri Kozlov <yuray@komyakino.ru>
и
Иван Павлов <pavia00@gmail.com>
.
.PP
Этот перевод является бесплатной документацией; прочитайте
.UR https://www.gnu.org/licenses/gpl-3.0.html
Стандартную общественную лицензию GNU версии 3
.UE
или более позднюю, чтобы узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ.
.PP
Если вы обнаружите ошибки в переводе этой страницы руководства,
пожалуйста, отправьте электронное письмо на
.MT man-pages-ru-talks@lists.sourceforge.net
.ME .