Manpages

NAME

sb2 − crosscompiling environment

SYNOPSIS

sb2 [options] [command] [arguments] [...]

DESCRIPTION

sb2 Runs command in scratchbox2. If no command is given, a bash shell in scratchbox2 environment is started.

OPTIONS

−v

Display version number.

−L LEVEL

Enable logging. Following values for logging LEVEL are available: error, warning, notice, info, debug, noise, noise2.

−d

Use debug mode: log all redirections (logging LEVEL=debug) to log file under directory $HOME/sb2_logs .

−h

Print help.

−t TARGET

Define TARGET to use. Use sb2-config -d TARGET to set a default.

−e

Use emulation mode, avoid executing any host binaries except qemu.

−m MODE

Use mapping mode MODE given in argument. Following MODE values are supported: devel, emulate, install, simple, tools.

−M FILE

Read mapping rules from FILE.

−s DIRECTORY

Use redirection rules from the DIRECTORY given in argument.

−Q BUGLIST

Emulate bugs of the scratchbox 1 (BUGLIST consists of letters: ’x’ enables exec permission checking bug emulation).

−r

Disable creating reverse mapping rules: functions like getcwd() and realpath() will always return the real path.

−O OPTIONS

Set options for the selected mapping mode. OPTIONS is a mode-specific string.

−R

Execute commands in fakeroot environment.

−S FILE

Create a persistent session: Write session information to FILE

−J FILE

Join a persistent session assossiated with FILE.

−D FILE

Delete a persistent session assosiated with FILE. Warning: this does not check if the session is still in use!

−W DIR

Use DIR as the session directory when creating the session (The default is to create the session in /tmp). DIR must be an absolute path and must not exist. Note that long pathnames may cause trouble with socket operations, so try to keep DIR as short as possible.

−c

When creating a session, also create a private copy of target_root (rootstrap). Note that this can be really slow, depending on the size of the orig.target_root.

−C DIR

When creating a session, create copy of DIR and use it as the target_root (rootstrap). Note that this can be really slow. See alse option -c.

−T DIRECTORY

Use DIRECTORY as tools_root (override the value which was specified to sb2-init when the target specification was created).

EXAMPLES

sb2 ./configure
sb2 make
sb2 -eR make install
sb2 -R -m emulate make install

CONFIGURATION

To configure sb2, do something like this:

mkdir $HOME/buildroot
cd $HOME/buildroot
[fetch a rootfs from somewhere and extract it here]
sb2-init -c qemu-arm TARGET /path/to/cross-compiler/bin/arm-linux-gcc

To change default scratchbox2 target:

sb2-config -d another_target

FILES

~/.scratchbox2/config

SEE ALSO

fakeroot(1), qemu(1) No known bugs at this time.

AUTHOR

Riku Voipio