syncfs

NOM

sync, syncfs - Vider les caches du système de fichiers sur le disque

BIBLIOTHÈQUE

Bibliothèque C standard ( libc, -lc)

SYNOPSIS

#include <unistd.h>

void sync(void);

int syncfs(int fd);

sync() :

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

syncfs() :

    _GNU_SOURCE

DESCRIPTION

sync() force l'écriture sur les systèmes de fichiers sous-jacents de toutes les métadonnées de fichier et données modifiées en cache. syncfs() agit comme sync(), mais ne synchronise que le système de fichiers contenant le fichier référencé par le descripteur de fichier ouvert fd.

VALEUR RENVOYÉE

Si elle réussit, syncfs() renvoie 0. Si elle échoue, elle renvoie  -1 et définit errno pour indiquer l'erreur.

ERREURS

sync() réussit toujours. syncfs() peut échouer au moins dans les cas suivants :

EBADF

fd n'est pas un descripteur de fichier valable.

EIO

Une erreur s'est produite pendant la synchronisation. Cette erreur peut être liée à des données écrites dans n'importe quel fichier du système de fichiers ou à des métadonnées liées au système de fichiers lui-même.

ENOSPC

L'espace disque a été épuisé pendant la synchronisation.

ENOSPC, EDQUOT

Les données ont été écrites dans un fichier sur un système de fichiers NFS ou autre qui n'allouait pas d'espace au moment de l'appel système à write(2) et certaines écritures antérieures ont échoué du fait d'un espace de stockage insuffisant.

VERSIONS

syncfs() est apparue dans Linux 2.6.39 ; la prise en charge de la bibliothèque a été ajoutée dans la glibc 2.14.

STANDARDS

sync() : POSIX.1-2001, POSIX.1-2008, SVr4, 4.3BSD. syncfs() est spécifique à Linux.

NOTES

Depuis la glibc 2.2.2, le prototype sous Linux de sync() est celui indiqué plus haut, ce qui correspond à diverses normes. Dans glibc jusqu'à 2.2.1 c'était « int sync(void) », et sync() renvoyait toujours  0. D'après les normes (par exemple POSIX.1-2001) sync() ne fait que planifier les écritures, il peut donc renvoyer avant que la véritable écriture ne soit effectuée. Cependant, Linux attend la fin de l'écriture et sync() et syncfs() fournissent donc les même garanties que fsync() sur chaque fichier du système ou du système de fichiers respectivement. Dans les versions principales du noyau avant Linux 5.8, syncfs() n'échouera que si un mauvais descripteur de fichier est fourni ( EBADF). Depuis Linux 5.8, syncfs() renverra aussi une erreur si un inœud ou plus a échoué à être réécrit depuis le dernier appel à syncfs().

BOGUES

Avant Linux 1.3.20, Linux n'attendait pas la fin de l'écriture.

VOIR AUSSI

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

TRADUCTION

La traduction française de cette page de manuel a été créée par Christophe Blaess <https://www.blaess.fr/christophe/>, Stéphan Rafin <[email protected]>, Thierry Vignaud <[email protected]>, François Micaux, Alain Portal <[email protected]>, Jean-Philippe Guérard <[email protected]>, Jean-Luc Coulon (f5ibh) <[email protected]>, Julien Cristau <[email protected]>, Thomas Huriaux <[email protected]>, Nicolas François <[email protected]>, Florentin Duneau <[email protected]>, Simon Paillard <[email protected]>, Denis Barbier <[email protected]>, David Prévot <[email protected]>, Thomas Vincent <[email protected]> et Jean-Pierre Giraud <[email protected]> Cette traduction est une documentation libre ; veuillez vous reporter à la GNU General Public License version 3 concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE. Si vous découvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message à [email protected]