sb2-show

Langue: en

Version: 251012 (debian - 07/07/09)

Section: 1 (Commandes utilisateur)

NAME

sb2-show - sb2 diagnostics tool

SYNOPSIS

sb2-show [-b binary_name ] [-m mode ] [-f function ] [-D ] [-v ] command_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 command)
-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