sb2-session(1) sb2-session man page sb2-session(1)NAME
sb2-session - manage scratchbox2 sessions
SYNOPSIS
sb2-session [COMMAND [PARAMS]]
DESCRIPTION
sb2-session is used to create attachable scratchbox2 sessions. You can save session even when you haven't done '-S session' during sb2
startup.
Note that you can give parameters to attach command which are passed verbatim to sb2. If there is only one session to attach, it is
selected automatically.
If no command is given, help text is printed.
COMMANDS
help shows help text
save saves current session
list lists detached sb2 sessions
delete SESSION
deletes given session
attach [SESSION [PARAMS]]
attaches to a given session
setenv VARIABLE VALUE
store a value for an environment variable
showenv
show stored environment variables
EXAMPLES
Basic usage is:
[SB2 .. ] $ sb2-session save # save session
[SB2 .. ] $ ^D # exit
Later we can then attach to this session:
% sb2-session attach
If there are more than one saved session, then:
% sb2-session list
session.XXXX TARGET_ARM My Comment
session.YYYY TARGET_ARM My Comment 2
session.ZZZZ TARGET_MIPS
% sb2-session attach session.YYYY
Here we pass '-eR' to sb2 and we only have one saved session:
% sb2-session attach -- -eR
'--' marks end of parameter list for sb2-session.
setenv VARIABLE VALUE can be used to add environment variables, that will become active when a saved session is later taken into use
(either by sb2-session attach or by sb2 -J).
setenv VARIABLE VALUE does not change environment of sessions that are already active.
showenv lists environment variable settings which have been stored with this tool. It does not show environment variables from other
sources.
SEE ALSO sb2(1)AUTHOR
Mika Westerberg
2.2 21 December 2010 sb2-session(1)
Check Out this Related Man Page
sb2-show(1) sb2-show man page sb2-show(1)NAME
sb2-show - sb2 diagnostics tool
SYNOPSIS
sb2-show [-b binary_name ] [-m mode ] [-f function ] [-D ] [-v ] command [parameters]
DESCRIPTION
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)
COMMANDS
Common commands:
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.
realcwd
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)
log-error 'message'
Add an error message to the logfile
log-warning 'message'
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).
execluafile filename
Load and execute Lua code from file.
binarytype realpath
detect & show type of program at realpath (which is an already mapped path)
var variablename
show value of an internal string variable
libraryinterface
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
OPTIONS -v verbose.
-b binary_name
show using binary_name as name of the calling program
-f function
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)
-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.
-g port
use port as qemu gdbserver listening port (default port is 1234). See command qemu-debug-exec
EXAMPLES
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
File /bin/ls
Mapped /opt/maemo/tools/bin/ls (readonly)
argv[0] /bin/ls
...
But in the emulation mode, only target's executables are used. Try also:
$ sb2 -e sb2-show exec /bin/ls
SEE ALSO sb2(1), sb2-config(1), sb2-logz(1), sb2-init(1)AUTHOR
Lauri Aarnio
2.2 17 December 2010 sb2-show(1)