inspect

Use the Inspect tool to examine the internal structures such as memory pools, timers, etc. of a Legato process.

Usage

inspect <pools|threads|timers|mutexes|semaphores> [OPTIONS] PID inspect ipc <servers|clients [sessions]> [OPTIONS] PID

inspect pools 

Prints the memory pools usage for the specified process.

inspect threads 

Prints the info of threads for the specified process.

inspect timers 

Prints the info of timers in all threads for the specified process.

inspect mutexes 

Prints the info of mutexes in all threads for the specified process.

inspect semaphores 

Prints the info of semaphores in all threads for the specified process.

inspect ipc 

Prints the info of ipc in all threads for the specified process.

Options

-f 

Update process memory usage information every 3 seconds.

--interval=SECONDS 

Update process memory usage information every SECONDS.

--help 

Display help and exit.

Output Sample

Legato Memory Pools Inspector
Inspecting process 759
TOTAL BLKS  USED BLKS   MAX USED  OVERFLOWS     ALLOCS  MEMORY POOL
         8          0          0          0          0  SubPools
        10          5          5          0          5  TraceKeys
        10          2          2          0          2  LogSession
         0          0          0          0          0  SigMonitor
         0          0          0          0          0  SigHandler
        10          7          7          0          7  SafeRef-Map
         0          0          0          0          0  PathIteratorPool
         8          0          0          0          0  safeRefPathIteratorMap
         4          0          0          0          0  mutex
         4          0          0          0          0  semaphore
         4          1          1          0          1  Thread Pool
         4          1          1          0          1  safeRefThreadRef
         0          0          0          0          0  DestructorObjs
        10          0          1          0       1568  QueuedFunction
        10          0          0          0          0  EventHandler
         5          0          0          0          0  Events
         4          0          0          0          0  safeRefEvents
         8          0          0          0          0  safeRefEventHandlers
        10          2          2          0          2  FdMonitor
         8          2          2          0          2  safeRefFdMonitors
        64          5          5          0          5  safeRefFdEventHandlers
         1          1          1          0          1  Default Timer Pool
         5          1          1          0          1  Protocol
        32          1          1          0          1  MessagingServices
        32          1          1          0          1  MessagingServices
        10          1          1          0          1  Session
        32          0          1          0          2  safeRefMsgTxnIDs
        10          0          2          0          4  LogControlProtocol-Msgs
      1567       1567       1567       1567       1567  EmployeePool
Warning
If the process has sub-pools, these statistics will count all the sub-pool blocks in the USED BLKS and MAX USED but not in the ALLOCS column for the super-pool. See Sub-Pools and Reduced-size pools for more details.