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

Sysbox: tview

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

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

Conjunction with tmemo can be very useful.

Options:

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

Columns (all number are hexadecimal):

• Handle
  Master handle of the view.
• Begin
  Virtual address of the first octet of the view.
• End
  Virtual address of the last octet of the view.
• Size
  Size of the view in octets.
• Offs
  Page offset of the view in the memory object.
• Flags
  Flags set on the view:
  • Sh: virtual space is shared across tasks (other tasks with sufficient permissions can map the view onto the same virtual address)
  • F: force the access to the pages (never raise page fault exception, just map the page and continue)
• Memo
  Master handle of the memory object the view allocated from.
• Owner
  Master handle of the owner task of the memo. A short symbolic name may take place to identify the owner.
  This could be a simple Self to indicate that the owner is the same task that the view has.
  If -n option is used, the task name will be resolved from the registry and it will be displayed.

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

# tview sysvc
Task 0x300001C (sysvc) views:
            Handle            Begin              End             Size             Offs Flags             Memo            Owner
  00000000030009F5 0000010000075000 0000010000075FFF             1000                0 Sh    00000000040009F4 000000000300001C Self
  0000000003000A04 0000010000076000 0000010000076FFF             1000                0 Sh    0000000005000A03 000000000300001C Self
  0000000003000A77 0000010000098000 0000010000098FFF             1000                0 Sh    0000000003000A76 000000000300001C Self
  0000000002000A86 0000010000099000 0000010000099FFF             1000                0 Sh    0000000003000A85 000000000300001C Self
  0000000008000E82 0000010000668000 0000010000668FFF             1000                0 Sh    0000000008000E81 000000000300001C Self
  0000000003000EAB 00000100008E0000 00000100008E0FFF             1000                0 Sh    0000000004000EAA 000000000300001C Self
  000000001200128B 000001000185C000 000001000185CFFF             1000                0 Sh    000000001700128A 000000000300001C Self
  000000001600129A 000001000185D000 000001000185DFFF             1000                0 Sh    0000000016001299 000000000300001C Self
  00000000140012AE 0000010001861000 0000010001861FFF             1000                0 Sh    00000000140012AD 000000000300001C Self
  000000000C0012BD 0000010001862000 0000010001862FFF             1000                0 Sh    000000000C0012BC 000000000300001C Self
  0000000002000042 00000100018E0000 0000010001901FFF            22000                0       000000000200001F 000000000300001C Self
  0000000001000048 0000010001902000 0000010001902FFF             1000                0       0000000001000047 000000000300001C Self
  000000000100004A 0000010001903000 0000010001903FFF             1000                0       0000000001000049 000000000300001C Self
  000000000100004C 0000010001904000 0000010001904FFF             1000                0       000000000100004B 000000000300001C Self
  0000000001000050 0000010001905000 0000010001905FFF             1000                0       000000000100004F 000000000300001C Self
  0000000001000056 0000010001906000 0000010001906FFF             1000                0 Sh    0000000001000054 0000000001000019
  0000000001000065 0000010001907000 0000010001907FFF             1000                0 Sh    0000000001000063 0000000001000019
  0000000002000052 0000010001908000 000001000190BFFF             4000                0       0000000002000051 000000000300001C Self
  0000000001000070 000001000190C000 0000010001914FFF             9000                0       000000000100006F 000000000300001C Self
  0000000002000077 0000010001915000 000001000191CFFF             8000                0       0000000002000076 000000000300001C Self
  0000000002000079 000001000191D000 0000010001920FFF             4000                0       0000000002000078 000000000300001C Self
  0000000006001B10 0000010001C99000 0000010001C99FFF             1000                0 Sh    0000000006001B0F 000000000300001C Self
  0000000004001B1F 0000010001C9A000 0000010001C9AFFF             1000                0 Sh    0000000004001B1E 000000000300001C Self
  00000000030005BA 00000100031A3000 00000100031A3FFF             1000                0 Sh    00000000030005B9 000000000300001C Self
  00000000020005C9 00000100031A4000 00000100031A4FFF             1000                0 Sh    00000000020005C8 000000000300001C Self
  00000000060018B2 0000010003918000 0000010003918FFF             1000                0 Sh    00000000060018B1 000000000300001C Self
  00000000040018C1 0000010003919000 0000010003919FFF             1000                0 Sh    00000000040018C0 000000000300001C Self
  00000000110016D5 00000100060FA000 00000100060FAFFF             1000                0 Sh    00000000130016D4 000000000300001C Self
  000000000F0016FE 00000100060FB000 00000100060FBFFF             1000                0 Sh    000000000F0016FD 000000000300001C Self
  00000000150019A9 000001000610D000 000001000610DFFF             1000                0 Sh    00000000150019A8 000000000300001C Self
  000000000F0019BA 000001000610E000 000001000610EFFF             1000                0 Sh    000000000F0019B9 000000000300001C Self
  000000001B001C6C 000001000648F000 000001000648FFFF             1000                0 Sh    000000001B001C6B 000000000300001C Self
  0000000018001C7B 0000010006490000 0000010006490FFF             1000                0 Sh    0000000018001C7A 000000000300001C Self
#
# tview -n sysvc
Task 0x300001C (sysvc) views:
            Handle            Begin              End             Size             Offs Flags             Memo            Owner
  00000000030009F5 0000010000075000 0000010000075FFF             1000                0 Sh    00000000040009F4 000000000300001C sysvc
  0000000003000A04 0000010000076000 0000010000076FFF             1000                0 Sh    0000000005000A03 000000000300001C sysvc
  0000000003000A77 0000010000098000 0000010000098FFF             1000                0 Sh    0000000003000A76 000000000300001C sysvc
  0000000002000A86 0000010000099000 0000010000099FFF             1000                0 Sh    0000000003000A85 000000000300001C sysvc
  0000000008000E82 0000010000668000 0000010000668FFF             1000                0 Sh    0000000008000E81 000000000300001C sysvc
  0000000003000EAB 00000100008E0000 00000100008E0FFF             1000                0 Sh    0000000004000EAA 000000000300001C sysvc
  000000001200128B 000001000185C000 000001000185CFFF             1000                0 Sh    000000001700128A 000000000300001C sysvc
  000000001600129A 000001000185D000 000001000185DFFF             1000                0 Sh    0000000016001299 000000000300001C sysvc
  00000000140012AE 0000010001861000 0000010001861FFF             1000                0 Sh    00000000140012AD 000000000300001C sysvc
  000000000C0012BD 0000010001862000 0000010001862FFF             1000                0 Sh    000000000C0012BC 000000000300001C sysvc
  0000000002000042 00000100018E0000 0000010001901FFF            22000                0       000000000200001F 000000000300001C sysvc
  0000000001000048 0000010001902000 0000010001902FFF             1000                0       0000000001000047 000000000300001C sysvc
  000000000100004A 0000010001903000 0000010001903FFF             1000                0       0000000001000049 000000000300001C sysvc
  000000000100004C 0000010001904000 0000010001904FFF             1000                0       000000000100004B 000000000300001C sysvc
  0000000001000050 0000010001905000 0000010001905FFF             1000                0       000000000100004F 000000000300001C sysvc
  0000000001000056 0000010001906000 0000010001906FFF             1000                0 Sh    0000000001000054 0000000001000019 registry
  0000000001000065 0000010001907000 0000010001907FFF             1000                0 Sh    0000000001000063 0000000001000019 registry
  0000000002000052 0000010001908000 000001000190BFFF             4000                0       0000000002000051 000000000300001C sysvc
  0000000001000070 000001000190C000 0000010001914FFF             9000                0       000000000100006F 000000000300001C sysvc
  0000000002000077 0000010001915000 000001000191CFFF             8000                0       0000000002000076 000000000300001C sysvc
  0000000002000079 000001000191D000 0000010001920FFF             4000                0       0000000002000078 000000000300001C sysvc
  0000000006001B10 0000010001C99000 0000010001C99FFF             1000                0 Sh    0000000006001B0F 000000000300001C sysvc
  0000000004001B1F 0000010001C9A000 0000010001C9AFFF             1000                0 Sh    0000000004001B1E 000000000300001C sysvc
  00000000030005BA 00000100031A3000 00000100031A3FFF             1000                0 Sh    00000000030005B9 000000000300001C sysvc
  00000000020005C9 00000100031A4000 00000100031A4FFF             1000                0 Sh    00000000020005C8 000000000300001C sysvc
  00000000060018B2 0000010003918000 0000010003918FFF             1000                0 Sh    00000000060018B1 000000000300001C sysvc
  00000000040018C1 0000010003919000 0000010003919FFF             1000                0 Sh    00000000040018C0 000000000300001C sysvc
  00000000110016D5 00000100060FA000 00000100060FAFFF             1000                0 Sh    00000000130016D4 000000000300001C sysvc
  000000000F0016FE 00000100060FB000 00000100060FBFFF             1000                0 Sh    000000000F0016FD 000000000300001C sysvc
  00000000150019A9 000001000610D000 000001000610DFFF             1000                0 Sh    00000000150019A8 000000000300001C sysvc
  000000000F0019BA 000001000610E000 000001000610EFFF             1000                0 Sh    000000000F0019B9 000000000300001C sysvc
  000000001B001C6C 000001000648F000 000001000648FFFF             1000                0 Sh    000000001B001C6B 000000000300001C sysvc
  0000000018001C7B 0000010006490000 0000010006490FFF             1000                0 Sh    0000000018001C7A 000000000300001C sysvc
#
( $ tcc - )
#
# tview -n tcc 
Task 0x5D001C18 (tcc) views:
            Handle            Begin              End             Size             Offs Flags             Memo            Owner
  0000000093001C40 00000100000A4000 00000100000A5FFF             2000                0 Sh    0000000003000A94 000000000500007B bufgroup
...
  0000000022001C93 0000010001814000 0000010001815FFF             2000                0 Sh    0000000001000FED 000000000500007B bufgroup
  0000000085001C22 0000010001921000 000001000193DFFF            1D000                0 Sh    0000000002000046 0000000004000020 loadersvc
  0000000027001C25 000001000193E000 000001000193FFFF             2000                0 Sh    0000000002000087 0000000004000020 loadersvc
  0000000077001C26 000001000194A000 000001000194BFFF             2000                0 Sh    00000000010000B4 0000000004000020 loadersvc
  000000001E001CF1 00000100019F3000 00000100019F4FFF             2000                0 Sh    0000000002000198 0000000005000128 libsvc
  000000001C001CB6 0000010001C96000 0000010001C97FFF             2000                0 Sh    000000002B001B61 000000000500007B bufgroup
  000000001E001CF5 0000010001CD2000 0000010001CD3FFF             2000                0 Sh    0000000002000257 0000000005000128 libsvc
...
  000000001C001CF9 0000010001D4B000 0000010001D66FFF            1C000                0 Sh    000000000100027C 0000000005000128 libsvc
  0000000029001C24 0000010003274000 0000010003274FFF             1000                0 Sh    000000000100008B 0000000004000020 loadersvc
  000000001C001CD9 0000010003801000 0000010003893FFF            93000                0       000000001C001CD8 000000005D001C18 tcc
  000000001C001CDD 0000010003894000 0000010003894FFF             1000                0       000000001C001CDC 000000005D001C18 tcc
  000000001E001CE8 0000010003895000 0000010003895FFF             1000                0 Sh    000000001E001CE6 0000000005000128 libsvc
...
  000000001E001D2C 00000100038A4000 00000100038A4FFF             1000                0 Sh    0000000024001D2A 0000000002000A1E vfs
...
  0000000007001E3B 0000010003DB7000 0000010003DB8FFF             2000                0 Sh    0000000004001E26 000000000500007B bufgroup
  000000000F001DA0 0000010003DC1000 0000010003E88FFF            C8000                0       0000000011001D9F 000000005D001C18 tcc
  000000000F001DA2 0000010003E89000 0000010003ED0FFF            48000                0       000000000F001DA1 000000005D001C18 tcc
  000000001C001D03 0000010004C0F000 0000010004C31FFF            23000                2       000000000100028A 0000000005000128 libsvc
  000000001C001D04 0000010004C32000 0000010004C34FFF             3000                0       000000001C001D01 000000005D001C18 tcc
  000000001C001D07 0000010004C35000 0000010004C35FFF             1000                0       000000000100029C 0000000005000128 libsvc
  000000001C001D08 0000010004C36000 0000010004C36FFF             1000                0       000000001E001D05 000000005D001C18 tcc
  000000001C001D0E 0000010004C37000 0000010004C37FFF             1000                0       000000001C001D0D 000000005D001C18 tcc
  000000001C001D14 0000010004C38000 0000010004C38FFF             1000                0 Sh    000000001C001D12 0000000001000019 registry
  000000001C001C9D 00000100060A3000 00000100060A4FFF             2000                0 Sh    00000000170011B9 000000000500007B bufgroup
...
  0000000085001C21 000001000648E000 000001000648EFFF             1000                0       0000000087001C1D 000000005D001C18 tcc
  000000001C001CFD 0000010006491000 00000100064A4FFF            14000                5       0000000001000282 0000000005000128 libsvc
  000000001C001CFE 00000100064A5000 00000100064A7FFF             3000                0       000000001C001CFB 000000005D001C18 tcc
#