--- layout: default title: usr/share/doc/sysbox/html/tool/tmemo.html ---

Sysbox: tmemo

Usage: tmemo [OPTION]... TASKNAME...
or: tmemo -P [OPTION]... TASKHANDLE...

Display all memos of a task (aka. process) handle or name. Can be invoked only from elevated shells (or tasks).

Conjunction with tview can be very useful.

Options:

• -P
  Use task handles instead of task names. Use the 0x prefix to indicate hexadecimal handles.
• -S STYLE
  Specify the output table style. STYLE must be one of the following: raw, simple, fancy, fancyw. Default is simple.

Columns:

• Handle
  Master handle of the memory object as a hexadecimal integer.
• Type
  Type of the memory object.
  • Norm: Normal, page allocated memory.
  • Fix: Continuous memory allocated on a fix address.
  • HW: Continuous hardware memory. It also has a fix address, but hardware memories are not freely allocatable.
• Address
  Address of the memory object. Undefined for normal (Norm) memories, and a dash (-) will be displayed.
• Size
  Size of the memory object in pages.
• Alloc
  Number of actually allocated pages. This can be lower than the size of the memory object.
• Views
  Number of views allocated on this memory object.
• Copies
  Number of copies made of this memory object.
• Del
  The memory object is marked as deleted or not. Memory objects can be lazily deleted, and actual deletion will be perform when the last view or copy of the memory is released.

Examples (Important! Only super tasks can perform these):

# tmemo tmemo
Task 0x2E001ACC (tmemo) memos:
              Handle Type          Address   Size  Alloc  Views Copies  Del
  0x0000000027001ACF Norm                -      1      1      1      0   no
  0x000000003A001AD0 Norm                -      1      1      1      0   no
  0x000000003A001ADC Norm                -      1      1      1      0   no
  0x0000000019001B70 Norm                -     69     43      2      0   no
  0x0000000019001B73 Norm                -      1      1      1      0   no
  0x0000000019001B75 Norm                -      1      1      1      0   no
  0x0000000019001B77 Norm                -      8      1      1      0   no
  0x000000004D001AD7 Norm                -      1      1      1      0   no
  0x0000000019001B7B Norm                -      1      1      1      0   no
  0x000000002C001B7D Norm                -      4      4      1      0   no
#
# tmemo libsvc
Task 0x5000128 (libsvc) memos:
              Handle Type          Address   Size  Alloc  Views Copies  Del
  0x000000000300012C Norm                -     51     51      1      0   no
  0x000000000200016A Norm                -      1      1      1      0   no
  0x000000000200016C Norm                -      1      1      1      0   no
  0x000000000200016E Norm                -      1      1      1      0   no
  0x0000000001000173 Norm                -      1      1      1      0   no
  0x0000000002000175 Norm                -      4      4      1      0   no
  0x0000000001000193 Norm                -      1      1      1      0   no
  0x0000000002000198 Norm                -      2      2     12      0   no
  0x000000000200019A Norm                -      4      1      1      0   no
  0x0000000002000244 Norm                -      8      8      1      0   no
  0x0000000002000257 Norm                -      2      2     11      0   no
  0x0000000002000259 Norm                -      1      1      1      0   no
...
  0x000000000E0016E1 Norm                -      1      1      2      0   no
#