sb2(1)
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 modespecific 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 tar
- get_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