.\" -*- coding: UTF-8 -*- .\" Copyright (c) 2006 Andrew Morton .\" and Copyright 2006 Michael Kerrisk .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" 2006-07-05 Initial creation, Michael Kerrisk based on .\" Andrew Morton's comments in fs/sync.c .\" 2010-10-09, mtk, Document sync_file_range2() .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH sync_file_range 2 "2 мая 2024 г." "Linux man\-pages 6.8" .SH ИМЯ sync_file_range \- синхронизирует сегмент файла на диске .SH LIBRARY Standard C library (\fIlibc\fP, \fI\-lc\fP) .SH СИНТАКСИС .nf \fB#define _GNU_SOURCE\fP /* See feature_test_macros(7) */ \fB#define _FILE_OFFSET_BITS 64\fP \fB#include \fP .P \fBint sync_file_range(int \fP\fIfd\fP\fB, off_t \fP\fIoffset\fP\fB, off_t \fP\fInbytes\fP\fB,\fP \fB unsigned int \fP\fIflags\fP\fB);\fP .fi .SH ОПИСАНИЕ Вызов \fBsync_file_range\fP() позволяет точно контролировать синхронизацию открытого файла, задаваемого файловым дескриптором \fIfd\fP, с диском. .P В \fIoffset\fP задаётся начальный байт диапазона файла, который нужно синхронизировать. В \fInbytes\fP указывается длина синхронизируемого диапазона (в байтах); если \fInbytes\fP равно нулю, то синхронизируются все байты, начиная с \fIoffset\fP и до конца файла. Синхронизация выполняется в единицах размера системной страницы: значение \fIoffset\fP округляется к меньшей границе страницы; \fI(offset+nbytes\-1)\fP округляется к большей границе страницы. .P В битовую маску аргумент \fIflags\fP можно включать следующие значения: .TP \fBSYNC_FILE_RANGE_WAIT_BEFORE\fP Перед выполнением записи ждать, пока будут перезаписаны все страницы в указанном диапазоне, которые уже были отправлены в драйвер устройства. .TP \fBSYNC_FILE_RANGE_WRITE\fP Начать перезапись всех изменённых страниц в указанном диапазоне, которые к настоящему моменту не были перезаписаны. Заметим, что это может привести к блокировке, если вы пытаетесь записать больше размера очереди запросов. .TP \fBSYNC_FILE_RANGE_WAIT_AFTER\fP После выполнения записи ждать, пока не перезапишутся все страницы в диапазоне. .P Указание 0 в \fIflags\fP допустимо; никаких действий выполнено не будет. .SS Предупреждение Данный системный вызов очень опасен и не должен использоваться в переносимых программах. Ни одна из этих операций перезаписи не касается метаданных файла. Поэтому, если приложение строго не выполняет перезаписи уже выделенных дисковых блоков, то нет никаких гарантий, что данные будут будьте доступны после катастрофического отказа. Не существует пользовательского интерфейса, который позволял бы узнать, действительно ли выполнилась перезапись. В файловых системах, использующих семантику копирования при записи (например, \fIbtrfs\fP) перезапись существующих выделенных блоков невозможна. Когда запись выполняется в уже выделенное пространство, многие файловые системы также вызывают выделитель блоков, которые данный системный вызов не синхронизирует с диском. Данный системный вызов не выполняет сброс дисковых кэшей для записи и поэтому не предоставляет какой\-либо целостности данных в системах с изменчивыми дисковыми кэшами на запись. .SS "Некоторые подробности" При \fBSYNC_FILE_RANGE_WAIT_BEFORE\fP и \fBSYNC_FILE_RANGE_WAIT_AFTER\fP будут обнаруживаться все ошибки ввода\-вывода или условия \fBENOSPC\fP, и они будут возвращены вызвавшему. .P Полезные комбинации битов в \fIflags\fP: .TP \fBSYNC_FILE_RANGE_WAIT_BEFORE | SYNC_FILE_RANGE_WRITE\fP Гарантировать, что все изменённые страницы в указанном диапазоне при вызове \fBsync_file_range\fP() помещаются для записи. Это начало операции по целостной записи данных. .TP \fBSYNC_FILE_RANGE_WRITE\fP Начать запись всех изменённых страниц указанного диапазона, которые ещё не были размещены для записи. Это анонимная операция сброса данных на диск. Она не подходит для операций целостности данных. .TP \fBSYNC_FILE_RANGE_WAIT_BEFORE\fP (или \fBSYNC_FILE_RANGE_WAIT_AFTER\fP) Ждать завершения записи всех страниц указанного диапазона. Можно использовать после операции \fBSYNC_FILE_RANGE_WAIT_BEFORE | SYNC_FILE_RANGE_WRITE\fP, дождаться завершения этой операции и получить её результат. .TP \fBSYNC_FILE_RANGE_WAIT_BEFORE | SYNC_FILE_RANGE_WRITE | SYNC_FILE_RANGE_WAIT_AFTER\fP Это операция по целостной записи данных, которая позволит быть уверенным, что все изменённые на момент вызова \fBsync_file_range\fP() страницы указанного диапазона записаны на диск. .SH "ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ" При успешном выполнении \fBsync_file_range\fP() возвращает 0. При ошибке возвращается \-1, и \fIerrno\fP устанавливается в соответствующее значение. .SH ОШИБКИ .TP \fBEBADF\fP Значение \fIfd\fP не является правильным файловым дескриптором. .TP \fBEINVAL\fP В \fIflags\fP указан некорректный бит; или некорректное значение в \fIoffset\fP или \fInbytes\fP. .TP \fBEIO\fP Ошибка ввода\-вывода. .TP \fBENOMEM\fP Не хватает памяти. .TP \fBENOSPC\fP Недостаточно места на диске. .TP \fBESPIPE\fP Значение \fIfd\fP ссылается не на обычный файл, блочное устройство, или каталог. .SH ВЕРСИИ .SS sync_file_range2() .\" See kernel commit edd5cd4a9424f22b0fa08bef5e299d41befd5622 Для некоторых архитектур (например, PowerPC, ARM) требуется, чтобы 64\-битные аргументы были выровнены в нужных парах регистров. На таких архитектурах для объявления вызова \fBsync_file_range\fP(), показанного в СИНТАКСИСЕ, для заполнения между аргументами \fIfd\fP и \fIoffset\fP расходовался бы ещё один регистр впустую (подробности смотрите в \fBsyscall\fP(2)). Поэтому в этих архитектурах определён другой системный вызов с подходящим порядком аргументов: .P .in +4n .EX \fBint sync_file_range2(int \fP\fIfd\fP\fB, unsigned int \fP\fIflags\fP\fB,\fP \fB off_t \fP\fIoffset\fP\fB, off_t \fP\fInbytes\fP\fB);\fP .EE .in .P Поведение данного системного вызова такое же как \fBsync_file_range\fP(). .SH СТАНДАРТЫ Linux. .SH ИСТОРИЯ Linux 2.6.17. .SS sync_file_range2() Системный вызов с таких объявлением впервые появился для архитектуры ARM в Linux 2.6.20 под именем \fBarm_sync_file_range\fP(). В Linux 2.6.22 он был переименован, так как аналогичный системный вызов был добавлен для PowerPC. Для архитектур, поддерживаемых glibc, glibc прозрачно обёртывает \fBsync_file_range2\fP() именем \fBsync_file_range\fP(). .SH ПРИМЕЧАНИЯ \fB_FILE_OFFSET_BITS\fP should be defined to be 64 in code that takes the address of \fBsync_file_range\fP, if the code is intended to be portable to traditional 32\-bit x86 and ARM platforms where \fBoff_t\fP's width defaults to 32 bits. .SH "СМОТРИТЕ ТАКЖЕ" \fBfdatasync\fP(2), \fBfsync\fP(2), \fBmsync\fP(2), \fBsync\fP(2) .PP .SH ПЕРЕВОД Русский перевод этой страницы руководства разработал Alexander Golubev , Azamat Hackimov , Hotellook, Nikita , Spiros Georgaras , Vladislav , Yuri Kozlov и Иван Павлов . .PP Этот перевод является свободной программной документацией; он распространяется на условиях общедоступной лицензии GNU (GNU General Public License - GPL, .UR https://www.gnu.org/licenses/gpl-3.0.html .UE версии 3 или более поздней) в отношении авторского права, но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ. .PP Если вы обнаружите какие-либо ошибки в переводе этой страницы руководства, пожалуйста, сообщите об этом разработчику по его адресу электронной почты или по адресу .MT списка рассылки русских переводчиков .ME .