SYNC(2)

ИМЯ
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 при вызове для каждого файла в системе или файловой системы, соответственно.

ДЕФЕКТЫ
До версии 1.3.20 Linux не ждёт завершения операций ввода-вывода перед возвращением.

СМОТРИТЕ ТАКЖЕ
sync(1), fdatasync(2), fsync(2)