VxWorks Reference Manual : Libraries
vmShow - virtual memory show routines (VxVMI Option)
vmShowInit( ) - include virtual memory show facility (VxVMI Option)
vmContextShow( ) - display the translation table for a context (VxVMI Option)
This library contains virtual memory information display routines.
The routine vmShowInit( ) links this facility into the VxWorks system. It is called automatically when this facility is configured into VxWorks using either of the following methods:
- If you use the configuration header files, define both INCLUDE_MMU_FULL and INCLUDE_SHOW_ROUTINES in config.h.
- If you use the Tornado project facility, select INCLUDE_MMU_FULL_SHOW.
This module and vmLib are distributed as the unbundled virtual memory support option, VxVMI.
vmLib.h
vmShow, vmLib, VxWorks Programmer's Guide: Virtual Memory
vmShowInit( ) - include virtual memory show facility (VxVMI Option)
void vmShowInit (void)
This routine acts as a hook to include vmContextShow( ). It is called automatically when the virtual memory show facility is configured into VxWorks using either of the following methods:
- If you use the configuration header files, define both INCLUDE_MMU_FULL and INCLUDE_SHOW_ROUTINES in config.h.
- If you use the Tornado project facility, select INCLUDE_MMU_FULL_SHOW.
* This routine is distributed as a component of the unbundled virtual memory support option, VxVMI.
N/A
vmContextShow( ) - display the translation table for a context (VxVMI Option)
STATUS vmContextShow ( VM_CONTEXT_ID context /* context - NULL == currentContext */ )
This routine displays the translation table for a specified context. If context is specified as NULL, the current context is displayed. Output is formatted to show blocks of virtual memory with consecutive physical addresses and the same state. State information shows the writable and cacheable states. If the block is in global virtual memory, the word "global" is appended to the line. Only virtual memory that has its valid state bit set is displayed.
This routine should be used for debugging purposes only.
Note that this routine cannot report non-standard architecture-dependent states.
This routine is distributed as a component of the unbundled virtual memory support option, VxVMI.
OK, or ERROR if the virtual memory context is invalid.