sb2-show(1) sb2-show man page sb2-show(1)
sb2-show - sb2 diagnostics tool
sb2-show [-b binary_name ] [-m mode ] [-f function ] [-D ] [-v ] command [parameters]
sb2-show is a tool for querying and testing what scratchbox2 does "behind the scenes".
The two most common uses are testing path mapping (commands path and which ) and finding out how programs are executed (the exec command).
Additionally, there are some commands that are intended to be used internally by scratchbox2 itself, and not so useful for a normal user.
sb2-show must be executed inside a scratchbox2 session (see sb2(1) for details about creating sessions)
path [path1] [path2] [pathN]
Show mapping results for listed pathnames
which [path1] [path2]..
Show mappings of pathnames, a less verbose variant of the path command (useful when using sb2-show from scripts)
exec program_path [arg1] [arg2]..
Show how a program would be executed, together with environment modifications.
Show real current working directory (Inside a session /bin/pwd will usually report virtual paths, and this is the only way to deter-
mine the real wroking directory).
Commands for non-interactive use and debugging of scratchbox2:
exec-cmdline file [argv1] [argv2]..
show execve() modifications on a single line (does not show full details, useful when using sb2-show from scripts)
Add an error message to the logfile
Add a warning message to the logfile
verify-pathlist-mappings required-fix [ignorelist]
Reads list of paths from stdin and checks that all paths will be mapped to a required prefix. This is used by sb2-check-pkg-map-
pings, (an internal utility).
Load and execute Lua code from file.
detect & show type of program at realpath (which is an already mapped path)
show value of an internal string variable
show preload library interface version (the Lua <-> C code interface)
qemu-debug-exec file argv0 [argv1] [argv2]..
show command line that can be used to start target binary under qemu gdbserver
show using binary_name as name of the calling program
show using function as callers name (full name of library or system call)
-D Ignore directories while verifying path lists (effective only for the verify-pathlist-mappings command)
-t report elapsed time (real time elapsed while executing the command)
Load and execute Lua code from file before executing the command. Useful for debugging and tuning lua scripts of sb2.
Load and execute Lua code from file after executing the command. Useful for debugging and tuning lua scripts of sb2.
use port as qemu gdbserver listening port (default port is 1234). See command qemu-debug-exec
Show where the /etc directory gets mapped:
$ sb2 sb2-show path /etc
/etc => /opt/maemo/tools/etc (readonly)
(exact results depend on how sb2-init was executed; what mapping mode is the default, etc.)
Typically, home directories are not mapped:
$ sb2 sb2-show path /home/yourname
/home/yourname => /home/yourname
In development modes, host-compatible versions of tools are executed:
$ sb2 sb2-show exec /bin/ls
Mapped /opt/maemo/tools/bin/ls (readonly)
But in the emulation mode, only target's executables are used. Try also:
$ sb2 -e sb2-show exec /bin/ls
sb2(1), sb2-config(1), sb2-logz(1), sb2-init(1)
2.2 17 December 2010 sb2-show(1)