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.