maemo SDK+ - maemo-rootstrap

jukka-pekka.iivonen@nokia.com

       maemo-rootstrap - maemo rootstrap manager

       maemo-rootstrap [--force] [--file ] [--host-tools] [--version]
                       [--index-url ] [--reload] [command] [nickname | all]

       maemo-rootstrap  tool manages maemo SDK rootstraps on the developer workstation. You can
       easily install or uninstall new rootstraps from the maemo rootstrap repository. You can
       also just check the list of rootstraps  available, or, check what rootstraps have already
       been installed.

       Maemo  SDK+ let's you to specify the exact set of build tools to be used.  If you want to
       use host tools for building, i.g. whatever tools you have installed into your workstation,
       please, use '--host-tools'  option.   With  this  option maemo  SDK+  will  use autogen,
       automake, docbook, bison, flex, etc. from your host distribution during cross-compilations.
       By default you should, however, use the prefered build tool distribution  which  is
       installed  using  'maemo-tools' tool.  For example, to install 'etch' build tool
       distribution you may want to type 'sudo maemo-tools -r etch -m http://ftp.debian.org/debian'.

       maemo-rootstrap  tool  also  configures  Scratchbox2  to use a given GCC cross-compiler
       with the rootstrap being installed or upgraded. maemo SDK comes with a default ARMEL
       cross-compiler. If you want to use some  other  compiler edit the ~/.maemo-sdk/config
       file to define the path to your specific compiler. This can be done by having a line
       CC=--your_gcc_cross-compiler_path-- in the config file.


       You can get the current list of rootstraps available by using the 'available' command.
       Here we  list  some  nick names that have been released already.

       diablo4.1.1_armel ARMEL rootstrap for the latest IT OS 2008

            corresponds to maemo 4.1.1 targeted for N810/N800 devices

       diablo4.1.1_i386  ARMEL rootstrap for the latest IT OS 2008

            corresponds to maemo 4.1.1 targeted for i386 SDK

       bora31_armel      ARMEL rootstrap for IT OS 2007

            corresponds to maemo 3.1 targeted for N800 devices (old OS)

       bora30_armel      ARMEL rootstrap for IT OS 2007

            corresponds to maemo 3.0 targeted for N800 devices

       scirocco22_armel  ARMEL rootstrap for IT OS 2006

            corresponds to maemo 2.2 targeted for 770 devices


       install [nickname | all]

       This command installs a given rootstrap based on it's nick name, or, all rootstraps that
       are available.

         If --reload option is used the rootstrap index file is updated from the network. Please,
         use it when new version of maemo rootstrap has been published.

         If --file option is used the rootstrap is installed from a file, not downloaded from the
         network.

         If --host-tools option is used the host tools are used for cross-compilations.

         If  [--index-url ] option is used the rootstrap index file is downloaded from a
         given location, not from the default network location.


       upgrade [nickname]

       This  command upgrades a given rootstrap based on it's nick name. Note that the old
       content will be overwritten.

         If --reload option is used the rootstrap index file is updated from the network. Please,
         use it when new version of maemo rootstrap has been published.

         If --file option is used the rootstrap is installed from a file, not downloaded from the
         network.

         If  [--index-url ] option is used the rootstrap index file is downloaded from a
         given location, not from the default network location.


       bin-install [nickname]

       This  command  installs  binary-only packages for a given rootstrap. Please, install
       the rootstrap first, and then install the binary-only packages.


       remove [nickname | all]

       This command uninstalls a given rootstrap based on it's nick name.


       toolchain [nickname] [path-to-cross-compiler]

       This command resets a given cross-compiler for a given target rootstrap.


       list

       This command lists all rootstraps that have been installed.


       available

       This command lists all rootstraps that are available on the rootstrap repository.

         If --reload option is used the rootstrap index file is updated from the network. Please,
         use it when new version of maemo rootstrap has been published.

         If  [--index-url ] option is used the rootstrap index file is downloaded from a
         given location, not from the default network location.


       path [nickname]

       This command returns the absolute path of the rootstrap root directory.
       If nickname is omitted the default Scratchbox2 rootstrap is used.


       arch [nickname]

       This command returns the architecture indentifier of the given rootstrap.
       If nickname is omitted the default Scratchbox2 rootstrap is used.


       help

       Shows help.

       maemo-sdk(1), maemo-tools(1), maemo-runtime(1), gcc(1), sb2(1), qemu(1).

       (C) Copyright 2007-2008 by Nokia Corporation

       Contact: Jukka-Pekka Iivonen jukka-pekka.iivonen@nokia.com

teTeX                       November 2008               maemo-rootstrap(1)

Release Information

Other links

maemo-rootstrap