What's the purpose of "BDIR" in oe-buildenv-internal?

What's the purpose of "BDIR" in oe-buildenv-internal?

[Robert P. J. Day]

   prepping to give a yocto talk to my local (ottawa) LUG next week, and
was reviewing the logic of the setup starting with oe-init-build-env,
and noticed in scripts/oe-buildenv-internal a test of the variable
BDIR for the name of the build directory.  but there's no mention of
that variable in the calling oe-init-build-env, and i see no mention
of it in the intro-level docs.

   clearly, one could use that shell env variable if one wanted to name
the build directory to be used, but given that there's absolutely no
explanation of it anywhere for a new user, what exactly is its purpose?

rday

Re: What's the purpose of "BDIR" in oe-buildenv-internal?

[Scott Garman]

On 10/27/2011 01:27 PM, Robert P. J. Day wrote:
> prepping to give a yocto talk to my local (ottawa) LUG next week, and
> was reviewing the logic of the setup starting with oe-init-build-env,
> and noticed in scripts/oe-buildenv-internal a test of the variable
> BDIR for the name of the build directory. but there's no mention of
> that variable in the calling oe-init-build-env, and i see no mention
> of it in the intro-level docs.
>
> clearly, one could use that shell env variable if one wanted to name
> the build directory to be used, but given that there's absolutely no
> explanation of it anywhere for a new user, what exactly is its purpose?
>
> rday

This allows you to specify a build directory that lives elsewhere on 
your filesystem, rather than in poky/build. This is handy in case you 
want to keep the build system source tree pristine.

Simply source the build init script with the desired build directory as 
an argument. I'm quite sure we have this documented, although BDIR isn't 
explicitly mentioned.

Scott

-- 
Scott Garman
Embedded Linux Engineer - Yocto Project
Intel Open Source Technology Center

Re: What's the purpose of "BDIR" in oe-buildenv-internal?

[Robert P. J. Day]

On Thu, 27 Oct 2011, Scott Garman wrote:

> On 10/27/2011 01:27 PM, Robert P. J. Day wrote:
> > prepping to give a yocto talk to my local (ottawa) LUG next week,
> > and was reviewing the logic of the setup starting with
> > oe-init-build-env, and noticed in scripts/oe-buildenv-internal a
> > test of the variable BDIR for the name of the build directory. but
> > there's no mention of that variable in the calling
> > oe-init-build-env, and i see no mention of it in the intro-level
> > docs.
> >
> > clearly, one could use that shell env variable if one wanted to
> > name the build directory to be used, but given that there's
> > absolutely no explanation of it anywhere for a new user, what
> > exactly is its purpose?
>
> This allows you to specify a build directory that lives elsewhere on
> your filesystem, rather than in poky/build. This is handy in case
> you want to keep the build system source tree pristine.
>
> Simply source the build init script with the desired build directory
> as an argument. I'm quite sure we have this documented, although
> BDIR isn't explicitly mentioned.

  that's the point i was raising -- that variable's value is obvious,
it's just not described anywhere i noticed.

rday

-- 

========================================================================
Robert P. J. Day                                 Ottawa, Ontario, CANADA
                        http://crashcourse.ca

Twitter:                                       http://twitter.com/rpjday
LinkedIn:                               http://ca.linkedin.com/in/rpjday
========================================================================