sb2-init (1)

sb2-init [OPTION]... [TARGETNAME] [COMPILER[:SPECS]] [SECONDARY_COMPILER...]

sb2-init initializes a target for scratchbox2. If no options or other parameters are given, already initialized targets are listed.

A scratchbox2 target is simply a light-weight, symbolic name for a configuration set. A target does not contain anything that is active, like running processes; hence a user never "works inside a target”. Instead, sessions are used for all active operations. Sessions are created by the sb2 command.

sb2-init is expected to be run in the directory you want to use as the target root filesystem.

TARGETNAME is the name of the target to initialize. If it refers to an existing target, then the target is re-initialized. Otherwise a new one is created.

COMPILER is full path to a cross-compiler (gcc), of the form $HOME/arm-2006q3/bin/arm-linux-gcc. An optional SPECS parameter is path to the compiler specs file.

If more than one compiler is specified, additional compilers are available by version number (e.g. if the primary is known as "gcc" and "gcc-4.1", the secondary may be "gcc-3.4", etc)

Note that the compiler is usually used during the target creation process to determine CPU architecture of the target system.

-c "command"

specify cpu transparency command, for example: "qemu-arm", "sbrsh" or "qemu-arm -R 256M". CPU transparency method is the program which is used to execute foreign binaries, that the host computer can not execute directly.

-p "command"

specify cpu transparency command for staticly linked native binaries.

-r [hostname]

generate sbrsh config using remote device address

-l [hostname]

NFS server/localhost address seen by remote device

-d

set target as default scratchbox2 target (default target can also be set later with the sb2-config command)

-m [mapping_mode]

use mapping_mode as default. Default for this is "simple"

-h

Print help.

-n

don't build libtool for the target

-N

don't generate localization files for the target

-s

skip checks for target root's /usr/include etc.

-t [tools_dir]

set directory containing the build tools distribution

-C "options"

add extra options for the compiler, for example: -C "-fgnu89-inline"

-A arch

manually override target architecture

-M arch

manually override machine name (see uname(2)). This defaults to the target architecture (see option -A)

-v

display version

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

$HOME/.scratchbox2/*

sb2(1), sb2-config(1), qemu(1)

No known bugs at this time.

Lauri T. Aarnio