|This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.|
Unmap previously mapped addresses
#include <sys/mman.h> int munmap_device_memory( void * addr, size_t len );
- The beginning of the range of addresses that you want to unmap.
- The length of the range of addresses, in bytes.
Use the -l c option to qcc to link against this library. This library is usually included automatically.
The munmap_device_memory() function is essentially the same as munmap(). It removes any mappings for pages in the address range starting at addr and continuing for len bytes, rounded up to the next multiple of the page size. Subsequent references to these pages cause a SIGSEGV signal to be set on the process.
If there are no mappings in the specified address range, then munmap() has no effect.
This function is the complement of mmap_device_memory().
- An error occurred (errno is set).
- Any other value
- The addresses in the specified range are outside the range allowed for the address space of a process.
- The munmap() function isn't supported by this implementation.