NAME

       sb2-init - initialize a target for scratchbox2

SYNOPSIS

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

DESCRIPTION

       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.

OPTIONS

       -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

EXAMPLES

       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

FILES

       $HOME/.scratchbox2/*

SEE ALSO

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

BUGS

       No known bugs at this time.

AUTHORS

       Lauri T. Aarnio