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

Sysbox: tprop

Usage: tprop PROPERTY [-s VALUE] [OPTION]... TASKNAME...
or: tprop PROPERTY [-s VALUE] -P [OPTION]... TASKHANDLE...

Get or set property of a process/task by handle or name. Can be invoked only from elevated shells (or tasks).

PROPERTY must be one of the following:

• prior
  Task priority.

Options:

• -d
  Print property values in decimal. Enabled by default.
• -P
  Use task handles instead of task names. Use the 0x prefix to indicate hexadecimal handles.
• -s VALUE
  Set task property instead of show them.
  VALUE can be a single value as the new value of the selected property. It can be a relative value as well: + (plus symbol) can increase the value of the property by the given amount; - (minus symbol) can decrease it.
• -x
  Print property values in hexadecimal.

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

# tprop prior vfs tcpip
Task priority:
vfs (0x2000a1e) -> 22
tcpip (0x20005f4) -> 25
#
# tprop -x prior vfs tcpip
Task priority:
vfs (0x2000a1e) -> 0x16
tcpip (0x20005f4) -> 0x19
#
# tprop prior vfs -s +1
#
# tprop prior vfs
Task priority:
vfs (0x2000a1e) -> 23
#
# tprop prior vfs -s -2
#
# tprop prior vfs
Task priority:
vfs (0x2000a1e) -> 21
#
# tprop prior vfs -s 22
#
# tprop prior vfs
Task priority:
vfs (0x2000a1e) -> 22
#