linux-yocto: improve checkout error handling and reporting
authorBruce Ashfield <bruce.ashfield@windriver.com>
Fri, 24 Feb 2012 01:58:47 +0000 (20:58 -0500)
committerRichard Purdie <richard.purdie@linuxfoundation.org>
Fri, 24 Feb 2012 17:12:05 +0000 (17:12 +0000)
commit9e5bf10e212ee74074abf7ce19c115883d2e6e6c
tree421926ee5e4b201be2e3f5256b393d9d0978cb81
parentf232e2c763178558a793e4e6e9aeb02bd12db951
linux-yocto: improve checkout error handling and reporting

The typical workflow for linux-yocto simply uses a remote
upstream repository (Whether it is mirrored or not), and in this
case there are no issues with consistency in the format of the
resository that is unpacked into the WORKDIR.

When working with a local linux-yocto repository for kernel
development the remote vs local branches is not always consistent
between repositories.

The suggested/documented workflow has always been to use a
bare clone of linux-yocto, and use a second working tree repository
for development. Changes flow from the working tree to the bare
clone and then into the working directory for build. A common
mistake that happens with this workflow is that the non-bare,
working repository is used instead of the bare clone version.

If a non-bare repository is reference by the SRC_URI, then the
branches that are fetched into WORKDIR are not consitent. If the
MACHINE and META branches are not present, cryptic build errors
will result.

To solve this problem, the checkout code has been changed in
several ways:

  - works with a newly proposed 'bareclone' option to bitbake
  - detects if a bareclone is present in WORKDIR or not and
    adjustst the checkout accordingly.
  - if a non-bare clone is detected, machine and meta branches
    are checked. If they are not present, or can't be created
    a clear error message is produced
  - instead of manipulating the refs directly in the git tree,
    local tracking branches are (quietly) created for remote
    branches. Enabling a better workflow in the WORKDIR kernel
    repository.

This has been tested with linux-yocto remote upstreams, local
bare and non-bare respositories. All builds succeed or fail
with clear error messages.

(From OE-Core rev: e3b6537cc7931636ab11ae6ed2c8fbaad9da91bc)

Signed-off-by: Bruce Ashfield <bruce.ashfield@windriver.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
meta/classes/kernel-yocto.bbclass