NOMBRE
msync − sincroniza un fichero con un mapa de memoria
SINOPSIS
#include
<unistd.h>
#include <sys/mman.h>
#ifdef
_POSIX_MAPPED_FILES
#ifdef _POSIX_SYNCHRONIZED_IO
int msync(void *comienzo, size_t longitud, int flags);
#endif
#endif
DESCRIPCIÓN
msync vuelca a disco los cambios hechos en la copia en memoria de un fichero que ha sido mapeado en memoria empleando mmap (2). Sin la utilización de esta llamada no está garantizado que los cambios se escriban de vuelta antes de que se llame a munmap (2). Para ser más precisos, se actualiza la parte del fichero que corresponde al área de memoria que empieza en comienzo y tiene de tamaño longitud. El argumento flags puede tener a 1 los bits MS_ASYNC, MS_SYNC y MS_INVALIDATE, pero no a la vez MS_ASYNC y MS_SYNC. MS_ASYNC planifica una actualización para más adelante, pero la llamada regresa inmediatamente. MS_SYNC pide una actualización y espera que se complete. MS_INVALIDATE pide invalidar cualesquiera otros mapeos del mismo fichero (de forma que puedan actualizarse con los valores frescos recién escritos).
VALOR DEVUELTO
En caso de éxito se devuelve 0. En caso de error se devuelve −1 y se pone un valor apropiado en errno.
ERRORES
|
EINVAL |
comienzo no es múltiplo de PAGESIZE, o cualquier bit distinto de MS_ASYNC | MS_INVALIDATE | MS_SYNC está a 1 en flags. | ||
|
EFAULT |
La memoria indicada (o parte de ella) no ha sido mapeada. |
CONFORME A
POSIX.1b (anteriormente POSIX.4)
VÉASE TAMBIÉN
mmap(2), B.O. Gallmeister, POSIX.4, O’Reilly, pp. 128-129 y 389-391.