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

Sysbox: readreg

Usage: readreg [OPTION]... KEY...

Display registry key in desired form. This is intended to be used in scripts, but it is still useful for general purpose as well. However, for registry investigation it is recommended to use the treereg tool instead.

Options:

• -a
  Show binary keys in ASCII form. This is the default for binary keys.
• -b
  Show binary keys as hexdump.
• -d
  Show integer keys in decimal. This is the default for integer keys.
• -k
  Print key names as well. The printed key will be the same as the argument was.
• -l
  Print the length of binary keys.
• -q
  Quiet mode. Just check key existence, and exit with the number of not existing keys. Therefore, the exit code of zero means a success.
• -Q
  Quote the text representation of the binary key if ASCII form is used.
• -x
  Show integer keys in hexadecimal using lowercase letters.
• -X
  Show integer keys in hexadecimal using uppercase letters.

Examples:

$ readreg -d run/dev/tcpip    
50333128
$
$ readreg -k run/dev/tcpip
run/dev/tcpip: 50333128
$
$ readreg -q run/dev/tcpip ; echo $?
0
$
$ readreg -x run/dev/tcpip
0x30005c8
$
$ readreg -X run/dev/tcpip
0x30005C8
$
$ readreg -l run/proc/000000000300055D
len=5, tcpip
$
$ readreg -lq run/proc/000000000300055D ; echo $?
0
$
$ readreg -lQ run/proc/000000000300055D
len=5, "tcpip"
$ 
$ readreg -lb run/proc/000000000300055D
len=5, 74 63 70 69 70
$
$ readreg -kQ run/proc/000000000300055D
run/proc/000000000300055D: "tcpip"
$
$ readreg -klQ run/proc/000000000300055D
run/proc/000000000300055D: len=5, "tcpip"
$
$ readreg -q asdf ; echo $?
1
$