.MO - Format Memory Object Records (VMOB)

Display memory object records (VMOBs). Optionally format related alias records (VMALs), arena records (VMARs) and context records (VMCOs).

If feature 82818 is installed, then under the Kernel Debugger only, lock information records will be formatted whenever a memory object with locked pages is displayed. See the .MK command for more information.

Syntax:

────.MO ─┬───────┬─┬───────┬─┬───────────┬───────────────────────
           └── V ──┘ ├── M ──┘ └── maddr ──┘
                     │
                     ├───────┬─┬───────┬─┬───────────────────────┬─
                     └── B ──┘ ├── C ──┤ ├──  hob  ──┬─┬─────────┤
                               ├── F ──┤ └── laddr ──┘ └── L n ──┘
                               ├── N ──┤
                               ├── P ──┤
                               └── S ──┘

Parameters:

B

Display in-use (busy) object records in sequential order.
C
Display chained memory structures.

Chaining causes related memory structures to be displayed in groups, the head of which is indicated by an * suffix. The related structures are:

the associated arena record (VMAR). See .MA command
aliases to the associated arena record (VMALs).
arena records of all associated alias records
shared instance data objects for all related arena records
context records for shared objects of all associated arena records (VMCOs). See .MC command.
object records of all associated arena records (VMOBs).
Note: Pseudo-objects have no related memory objects.

F

Display free object records.
M
Searches for a pseudo-object whose address matches the address specified for maddr. If no match is found then nothing is displayed.

Notes:

The pseudo-object address specified must be an exact match for hit.

The pseudo-object address is that of the object itself and not the VMOB that represents it.

A selector:offset form of address may not be specified. However a physical address may be specified in order to bypass virtual address validation done by Kernel Debugger and Dump Formatter.

N
Specifies that only normal object records be displayed. These are objects whose linear address allocation is represented by an arena record. Contrast this with Pseudo-Object and System Object. See also .MA command for details of arena record display.
P
Specifies that pseudo-object records be displayed.
S
Specifies that objects to be displayed are those whose memory management semaphore is busy or wanted. The memory management semaphore is used internally for serialising access to memory management structures. It should not be confused with the memory locking as provided by the DevHlp_Lock, DevHlp_Unlock, DevHlp_VMLocl and DevHlp_VMUnlock calls.
V
Specifies verbose mode of display. The address of the VMOB structure is displayed but object description and owner interpretation is suppressed.
maddr
Specifies the matching address to be used with the M option.

An address expression may be specified.

laddr
Specifies the linear address of a specific object record to be formatted.

An address expression may be specified.

Ln
Specifies the number of object records to display.
hob
Specifies the handle of a specific object record to be formatted according to the criteria specified by the other options.

Results & Notes:

Object records are located in contiguous storage, which is anchored from the address given by global variable:

_pobvmOne

Output from the .MO. command appears in one of four formats:

Normal Object
Pseudo-Object
Free Object Record
System Object

From fix pack 29 for Warp V3 and base Warp V4 the output of this command has been enhanced by adding hmte interpretation for system objects. The apears on the right hand end of the command output following the textual interpretation of the own field.

From fix pack 35 for Warp V3 and base Warp V4 Device Driver and File System Driver allocated objects will record the driver's true hmte as its hmte owner Id instead of the one of the system objects dd1-dd16 and fsd1-fsd8.

Prior to fix pack 29 for Warp V3 the .MO command could trap D while formatting MTE objects. This is fixed from fix pack 29 for Warp V3 and base Warp V4.

For a description of the fields formatted by .MO select .MO Output Field Descriptions

For more examples using of the .M family of commands see: Exploring Memory Management.

---

[Back: .ML Output Field Descriptions]
[Next: Normal Object Records]