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

Sysbox: devquery

Usage: devquery [OPTION]... [-T timeout] QUERY DEVNAME [PARAM]

Query a device. The name of the device will be DEVNAME. The optional PARAM argument must be an integer number, but defaults to zero.

The QUERY argument must be one of the following:

• GET_CLASS
  Get the nth class (where n is PARAM; zero based index).
• PING
  Simple ping query. Basically the same as devping.
• CHANGE_POWER_LEVEL
  Change the power level of the device. Device-side support is required.
• QUERY_POWER_LEVEL
  Query the current power level.
• DEBUG_COMMAND
  Device specific debug command. This is highly device dependent, hard to tell anything about it.

Options:

• -c
  Compact mode, display only the result.
• -C
  Undo the effect of all previous -c options.
• -d
  Display the result as a decimal integer. Enabled by default.
• -h
  Display the result as a hexadecimal integer.
• -T MSEC
  Set query timeout to MSEC milliseconds.
• -v
  Verbose mode. Print messages during the process.

Examples:

$ devquery -c PING tcpip
0
$
$ devquery -h GET_CLASS tcpip 0
Result: 0xdce70005
$
$ devquery -h GET_CLASS tcpip 1
Result: 0xdce7000c
$
$ devquery -h GET_CLASS tcpip 2
Result: 0xdce7005c
$
$ devquery -v QUERY_POWER_LEVEL tcpip
devquery: tcpip: get device MsgPort from registry ("run/dev/tcpip")
devquery: tcpip: query with 5000 msec timeout
devquery: tcpip: message sent
devquery: tcpip: ping successful
Result: 3
$