ИМЯ

sync, syncfs - записывает кэши файловых систем на диск

ОБЗОР

#include <unistd.h>

void sync(void);

int syncfs(int fd);

Требования макроса тестирования свойств для glibc (см. feature_test_macros(7)):

sync():
_XOPEN_SOURCE >= 500
|| /* начиная с glibc 2.19: */ _DEFAULT_SOURCE
|| /* версии glibc <= 2.19: */ _BSD_SOURCE

syncfs():
_GNU_SOURCE

ОПИСАНИЕ

Вызов sync() приводит к записи в файловую систему всех отложенных изменений метаданных
файловой системы и кэшированных файловых данных.

Вызов syncfs() подобен sync(), но синхронизирует только файловую систему, содержащую файл,
на который указывает открытый файловый дескриптор fd.

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ

При нормальном завершении работы syncfs() возвращает 0. В случае ошибки возвращается -1, а
errno устанавливается в соответствующее значение.

ОШИБКИ

Вызов sync() всегда выполняется без ошибок.

Вызов syncfs() может завершиться с ошибкой, по крайней мере, по следующей причине:

EBADF Значение fd не является правильным файловым дескриптором.

ВЕРСИИ

Системный вызов syncfs() впервые появился в Linux 2.6.39; поддержка в glibc добавлена в
версии 2.14.

СООТВЕТСТВИЕ СТАНДАРТАМ

sync(): POSIX.1-2001, POSIX.1-2008, SVr4, 4.3BSD.

syncfs() есть только в Linux.

ЗАМЕЧАНИЯ

Начиная с glibc 2.2.2 Linux-прототип sync() стал соответствовать различным стандартам. В
glibc 2.21 и старее он объявлялся как «int sync(void)» и вызов sync() всегда возвращал 0.

В соответствии со стандартной спецификацией (например POSIX.1-2001), sync() только планирует
запись, и может закончить работу до того как запись будет на самом деле произведена. Однако
в Linux выполняется ожидание завершения операций ввода-вывода и поэтому sync() или syncfs()
предоставляют такие же гарантии как fsync при вызове для каждого файла в системе или
файловой системы, соответственно.