VxWorks Reference Manual : Libraries

mmanPxLib

NAME

mmanPxLib - memory management library (POSIX)

ROUTINES

mlockall( ) - lock all pages used by a process into memory (POSIX)
munlockall( ) - unlock all pages used by a process (POSIX)
mlock( ) - lock specified pages into memory (POSIX)
munlock( ) - unlock specified pages (POSIX)

DESCRIPTION

This library contains POSIX interfaces designed to lock and unlock memory pages, i.e., to control whether those pages may be swapped to secondary storage. Since VxWorks does not use swapping (all pages are always kept in memory), these routines have no real effect and simply return 0 (OK).

INCLUDE FILES

sys/mman.h

SEE ALSO

mmanPxLib, POSIX 1003.1b document

---

Libraries : Routines

mlockall( )

NAME

mlockall( ) - lock all pages used by a process into memory (POSIX)

SYNOPSIS

int mlockall
    (
    int flags
    )

DESCRIPTION

This routine guarantees that all pages used by a process are memory resident. In VxWorks, the flags argument is ignored, since all pages are memory resident.

RETURNS

0 (OK) always.

ERRNO

N/A

SEE ALSO

mmanPxLib

---

Libraries : Routines

munlockall( )

NAME

munlockall( ) - unlock all pages used by a process (POSIX)

SYNOPSIS

int munlockall (void)

DESCRIPTION

This routine unlocks all pages used by a process from being memory resident.

RETURNS

0 (OK) always.

ERRNO

N/A

SEE ALSO

mmanPxLib

---

Libraries : Routines

mlock( )

NAME

mlock( ) - lock specified pages into memory (POSIX)

SYNOPSIS

int mlock
    (
    const void * addr,
    size_t       len
    )

DESCRIPTION

This routine guarantees that the specified pages are memory resident. In VxWorks, the addr and len arguments are ignored, since all pages are memory resident.

RETURNS

0 (OK) always.

ERRNO

N/A

SEE ALSO

mmanPxLib

---

Libraries : Routines

munlock( )

NAME

munlock( ) - unlock specified pages (POSIX)

SYNOPSIS

int munlock
    (
    const void * addr,
    size_t       len
    )

DESCRIPTION

This routine unlocks specified pages from being memory resident.

RETURNS

0 (OK) always.

ERRNO

N/A

SEE ALSO

mmanPxLib