Mac Developer Library Developer
Search

 

This manual page is part of Xcode Tools version 5.0

To obtain these tools:

If you are running a version of Xcode Tools other than 5.0, view the documentation locally:

  • In Xcode

  • In Terminal, using the man(1) command

Reading manual pages

Manual pages are intended as a quick reference for people who already understand a technology.

  • To learn how the manual is organized or to learn about command syntax, read the manual page for manpages(5).

  • For more information about this technology, look for other documentation in the Apple Developer Library.

  • For general information about writing shell scripts, read Shell Scripting Primer.




MSYNC(2)                    BSD System Calls Manual                   MSYNC(2)

NAME
     msync -- synchronize a mapped region

LIBRARY
     Standard C Library (libc, -lc)

SYNOPSIS
     #include <sys/mman.h>

     int
     msync(void *addr, size_t len, int flags);

DESCRIPTION
     The msync() system call writes modified whole pages back to the filesystem and updates the file modifi-cation modification
     cation time.  Only those pages containing addr and len-1 succeeding locations will be examined.

     The flags argument may be specified as follows:

     MS_ASYNC        Return immediately
     MS_SYNC         Perform synchronous writes
     MS_INVALIDATE   Invalidate all cached data

     The MS_ASYNC flag is not permitted to be combined with other flags.

RETURN VALUES
     If any errors occur, -1 is returned and errno is set to indicate the error.  Otherwise, a 0 value is
     returned.

ERRORS
     msync() will fail if:

     [EBUSY]            Some of the specified addresses are locked and MS_INVALIDATE is specified.

     [EINVAL]           addr is not a multiple of the hardware page size.

     [EINVAL]           len is too large, or less than 1.

     [EINVAL]           flags is invalid (e.g., it combines MS_ASYNC with another flag, which is not permit-ted). permitted).
                        ted).

     [EIO]              An I/O error occurs while writing to the file system.

     [ENOMEM]           The specified address range is outside of the address range of the process or
                        includes an unmapped page.

LEGACY SYNOPSIS
     #include <sys/types.h>
     #include <sys/mman.h>

     The include file <sys/types.h> is necessary.

SEE ALSO
     madvise(2), mincore(2), mprotect(2), munmap(2), compat(5)

HISTORY
     The msync() function first appeared in 4.4BSD.

BSD                              June 21, 1994                             BSD

Reporting Problems

The way to report a problem with this manual page depends on the type of problem:

Content errors
Report errors in the content of this documentation with the feedback links below.
Bug reports
Report bugs in the functionality of the described tool or API through Bug Reporter.
Formatting problems
Report formatting mistakes in the online version of these pages with the feedback links below.

Feedback