sync(2) System Calls Manual sync(2)

sync, syncfs - zrzuca bufory systemu pliku na dysk

Standardowa biblioteka C (libc, -lc)

#include <unistd.h>
void sync(void);
int syncfs(int fd);
Wymagane ustawienia makr biblioteki glibc (patrz feature_test_macros(7)):

sync():

    _XOPEN_SOURCE >= 500
        || /* Od glibc 2.19: */ _DEFAULT_SOURCE
        || /* glibc <= 2.19: */ _BSD_SOURCE

syncfs():

    _GNU_SOURCE

sync() wymusza fizyczne zapisanie w systemach plików wszystkich oczekujących modyfikacji metadanych systemów plików i zbuforowanych danych plików.

syncfs() jest podobny do sync(), ale synchronizuje tylko system plików zawierający plik, do którego odnosi się otwarty deskryptor pliku fd.

Po pomyślnym zakończeniu syncfs() zwraca zero, po błędzie zwraca -1 i ustawia errno, wskazując błąd.

sync() zawsze kończy się pomyślnie.

syncfs() może się nie powieść co najmniej z poniższych powodów:

fd nie jest prawidłowym deskryptorem pliku.
Wystąpił błąd podczas synchronizacji. Błąd może odnosić się do danych zapisywanych do jakiegoś pliku w systemie plików albo do metadanych powiązanych z samym systemem plików.
Wyczerpano miejsce na dysku podczas synchronizacji.
Dane zapisano do pliku na NFS lub na innym systemie plików, który nie przydziela miejsca w momencie wywołania systemowego write(2) i któryś z poprzednich zapisów nie powiódł się ze względu na brak miejsca na dysku.

Zgodnie ze standardowymi wskazaniami (np. POSIX.1-2001), sync() szereguje zapisy, lecz może powrócić przed dokonaniem fizycznego zapisu. Mimo to Linux czeka na zakończenie operacji wejścia/wyjścia i dlatego sync() lub syncfs() dają te same gwarancje, co wywołanie fsync(2) na każdym pliku w systemie lub odpowiednio w systemie plików.

POSIX.1-2008.
Linux.

POSIX.1-2001, SVr4, 4.3BSD.
Linux 2.6.39, glibc 2.14.

Począwszy od glibc 2.2.2 prototyp wywołania sync() w Linuksie wygląda jak powyżej, zgodnie z różnymi standardami. W wersji 2.2.1 i wcześniejszych biblioteki glibc było to "int sync(void)", a sync() zawsze zwracało 0.

W głównej gałęzi jądra, w wersjach wcześniejszych niż Linux 5.8, syncfs() zawodziło tylko, gdy podano nieprawidłowy deskryptor pliku (EBADF). Od Linuksa 5.8, syncfs() zgłosi błąd również wówczas, gdy nie uda się zapisać jednego lub więcej i-węzłów, od ostatniego wywołania syncfs().

Przed Linuksem 1.3.20, Linux nie czekał na zakończenie operacji wejścia/wyjścia przed powróceniem z tego wywołania systemowego.

sync(1), fdatasync(2), fsync(2)

Autorami polskiego tłumaczenia niniejszej strony podręcznika są: Przemek Borys <pborys@dione.ids.pl>, Andrzej Krzysztofowicz <ankry@green.mf.pg.gda.pl>, Robert Luberda <robert@debian.org> i Michał Kułach <michal.kulach@gmail.com>

Niniejsze tłumaczenie jest wolną dokumentacją. Bliższe informacje o warunkach licencji można uzyskać zapoznając się z GNU General Public License w wersji 3 lub nowszej. Nie przyjmuje się ŻADNEJ ODPOWIEDZIALNOŚCI.

Błędy w tłumaczeniu strony podręcznika prosimy zgłaszać na adres listy dyskusyjnej manpages-pl-list@lists.sourceforge.net.

2 maja 2024 r. Linux man-pages 6.8