sb2-show(1)
NAME
sb2-show - sb2 diagnostics tool
SYNOPSIS
sb2-show [-b binary_name ] [-m mode ] [-f function ] [-D ] [-v ] com- mand_tag [parameters]
DESCRIPTION
sb2-show command must be run from inside scratchbox2. The sb2-show provides developer valuable information about pathmappings that the sb2
pathmapping engine is executing during runtime. This diagnostics tool
helps you understand what files are used and from what location when
using the sb2 development environment.
OPTIONS
-v verbose. Give lots of output.
- -b binary_name
- This option outputs the mapping modifications that are related to the binary name ie program name that you specify with this option.
- -m mode
- Show using named mapping sb2 mode (default=current sb2 mode)
- -f function
- This option can be used when you are debugging mapping rules in sb2. The function name is the full name of library or system call that you want to monitor.
- -D Ignore directories while verifying path lists
- -t report elapsed time (real time elapsed while executing the com
- mand)
- -x file
- Load and execute Lua code from file before executing the command. Useful for debugging and tuning lua scripts of sb2.
- -X file
- Load and execute Lua code from file after executing the command. Useful for debugging and tuning lua scripts of sb2.
COMMAND TAGS
- path [path1] [path2] [pathN]
- Show mappings of pathnames
- realcwd
- Show real current working directory
- exec file [argv0] [argv1] [argvN]
- Show execve() modifications done by sb2
- log-error 'message'
- Add an error message to logfile
- log-warning 'message'
- Add a warning message to the logfile
- verify-pathlist-mappings required-fix [ignorelist]
- Read list of paths from stdina and check that all paths will be mapped to required 'prefix/n'
- execluafile filename
- Load and execute Lua code from file.
EXAMPLES
$ sb2 sb2-show path /etc
/etc => /opt/maemo/dists/etch/etc (readonly)
This shows where the /etc directory gets mapped under your active sb2
target. In this example the /etc gets mapped to
/opt/maemo/dists/etch/etc directory in your host. The /etc directory
has been defined to be readonly.
$ sb2 sb2-show path /home/yourname
/home/yourname => /home/yourname
This example shows where your own home directory gets mapped. By
default under sb2 environment your home directory is the one you use
as your real home directory. Your home directory is read-write.
$ sb2 sb2-show exec /bin/ls
File /bin/ls
Mapped /opt/maemo/dists/etch/bin/ls (readonly)
argv[0] /bin/ls
This command shows what execve() modifications are done by sb2 engine
to the binary that is being executed. It also shows you the argument
vector. In the above example you can see that in maemo mode (ie build
mode) the /bin/ls program is actually executed from location
/opt/maemo/dists/etch/bin/ls in your linux pc.
SEE ALSO
sb2(1), sb2-config(1), sb2-init(1)
AUTHOR
- Lauri Aarnio