All of lore.kernel.org
 help / color / mirror / Atom feed
* [PATCH 0/1] linux-yocto-custom: Clarify usage and clear COMPATIBLE_MACHINE
@ 2012-08-03 23:29 Darren Hart
  2012-08-03 23:29 ` [PATCH 1/1] " Darren Hart
  0 siblings, 1 reply; 4+ messages in thread
From: Darren Hart @ 2012-08-03 23:29 UTC (permalink / raw)
  To: openembedded-core; +Cc: Darren Hart

The following changes since commit a9d0cbe1d84bb26fc1a1f48764fe514cf9f9c548:

  gcc: Bump PR since there have been several gcc changes and various problems reported and this should flush anything stale out (2012-08-03 10:32:24 +0100)

are available in the git repository at:

  git://git.yoctoproject.org/user-contrib/dvhart/oe-core skeleton
  http://git.yoctoproject.org/cgit.cgi/user-contrib/dvhart/oe-core/log/?h=skeleton

Darren Hart (1):
  linux-yocto-custom: Clarify usage and clear COMPATIBLE_MACHINE

 .../recipes-kernel/linux/linux-yocto-custom.bb     | 52 +++++++++++++++-------
 1 file changed, 35 insertions(+), 17 deletions(-)

-- 
1.7.11.2




^ permalink raw reply	[flat|nested] 4+ messages in thread

* [PATCH 1/1] linux-yocto-custom: Clarify usage and clear COMPATIBLE_MACHINE
  2012-08-03 23:29 [PATCH 0/1] linux-yocto-custom: Clarify usage and clear COMPATIBLE_MACHINE Darren Hart
@ 2012-08-03 23:29 ` Darren Hart
  2012-08-04  0:27   ` Bruce Ashfield
  0 siblings, 1 reply; 4+ messages in thread
From: Darren Hart @ 2012-08-03 23:29 UTC (permalink / raw)
  To: openembedded-core; +Cc: Darren Hart

There has been some confusion over proper use of the linux-yocto-custom
recipe. It is not intended to build as is from meta-skeleton. It should
be modified via a bbappend file to provide a Linux kernel config at the
very least.

Update the commentary to make this requirement more explicit. Add some
additional detail about how to create a bbappend file and how and when
to modify the various variables.

Clear COMPATIBLE_MACHINE so bitbake will not attempt to build the recipe
unless the user explicitly adds there machine to the variable, which
should encourage them to read the recipe comments before attempting to
build it.

Signed-off-by: Darren Hart <dvhart@linux.intel.com>
CC: Bruce Ashfield <bruce.ashfield@windriver.com>
CC: Tom Zanussi <tom.zanussi@intel.com>
---
 .../recipes-kernel/linux/linux-yocto-custom.bb     | 52 +++++++++++++++-------
 1 file changed, 35 insertions(+), 17 deletions(-)

diff --git a/meta-skeleton/recipes-kernel/linux/linux-yocto-custom.bb b/meta-skeleton/recipes-kernel/linux/linux-yocto-custom.bb
index 55f0c38..dd98228 100644
--- a/meta-skeleton/recipes-kernel/linux/linux-yocto-custom.bb
+++ b/meta-skeleton/recipes-kernel/linux/linux-yocto-custom.bb
@@ -1,17 +1,35 @@
 # linux-yocto-custom.bb:
 #
-#   Provides an example/minimal kernel recipe that uses the linux-yocto
-#   and oe-core kernel classes to apply a subset of yocto kernel 
-#   management to git managed kernel repositories.
+#   An example kernel recipe that uses the linux-yocto and oe-core
+#   kernel classes to apply a subset of yocto kernel management to git
+#   managed kernel repositories.
+#
+#   To use linux-yocto-custom in your layer, create a
+#   linux-yocto-custom.bb file containing at least the following lines:
+#
+#     FILESEXTRAPATHS_prepend := "${THISDIR}/${PN}:"
+#     COMPATIBLE_MACHINE_yourmachine = "yourmachine"
+#
+#   You must also provide a Linux kernel configuration. The most direct
+#   method is to copy your .config to files/defconfig in your layer,
+#   parallel to the linux-yocto-custom.bbappend file.
+#
+#   To use the yocto kernel tooling to generate a BSP configuration
+#   using modular configuration fragments, see the yocto-bsp and
+#   yocto-kernel tools documentation.
+#
+# Warning:
+#
+#   Building this example without providing a defconfig or BSP
+#   configuration will result in build or boot errors. This is not a
+#   bug.
+#
 #
 # Notes:
 #
-#   kconfig(s): the kernel must be configured with a defconfig, or via
-#               configuration fragment(s). Either of these can be added
-#               via bbappend.
-#   patches: patches can be merged into to the source git tree itself, added
-#            using standard bbappend syntax or controlled via .scc feature 
-#            descriptions (also via bbappends)
+#   patches: patches can be merged into to the source git tree itself,
+#            added via the SRC_URI, or controlled via a BSP
+#            configuration.
 #   
 #   example configuration addition:
 #            SRC_URI += "file://smp.cfg"
@@ -20,25 +38,25 @@
 #   example feature addition (for kernel v3.4 only):
 #            SRC_URI += "file://feature.scc"
 #
-# Warning:
-#
-#   Building the sample kernel tree (kernel.org) without providing any
-#   configuration will result in build or boot errors. This is not a bug
-#   it is a required element for creating a valid kernel.
-#    
 
 inherit kernel
 require recipes-kernel/linux/linux-yocto.inc
 
+# Override SRC_URI in a bbappend file to point at a different source
+# tree if you do not want to build from Linus' tree.
 SRC_URI = "git://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git;protocol=git;nocheckout=1"
 
 LINUX_VERSION ?= "3.4"
 LINUX_VERSION_EXTENSION ?= "-custom"
 
+# Override SRCREV to point to a different commit in a bbappend file to
+# build a different release of the Linux kernel.
 # tag: v3.4 76e10d158efb6d4516018846f60c2ab5501900bc
 SRCREV="76e10d158efb6d4516018846f60c2ab5501900bc"
 
-PR = "r0"
+PR = "r1"
 PV = "${LINUX_VERSION}+git${SRCPV}"
 
-COMPATIBLE_MACHINE = "(qemuarm|qemux86|qemuppc|qemumips|qemux86-64)"
+# Override COMPATIBLE_MACHINE to include your machine in a bbappend
+# file. Leaving it empty here ensures an early explicit build failure.
+COMPATIBLE_MACHINE = "(^$)"
-- 
1.7.11.2




^ permalink raw reply related	[flat|nested] 4+ messages in thread

* Re: [PATCH 1/1] linux-yocto-custom: Clarify usage and clear COMPATIBLE_MACHINE
  2012-08-03 23:29 ` [PATCH 1/1] " Darren Hart
@ 2012-08-04  0:27   ` Bruce Ashfield
  2012-08-06 15:52     ` Darren Hart
  0 siblings, 1 reply; 4+ messages in thread
From: Bruce Ashfield @ 2012-08-04  0:27 UTC (permalink / raw)
  To: Patches and discussions about the oe-core layer; +Cc: Darren Hart

On Fri, Aug 3, 2012 at 7:29 PM, Darren Hart <dvhart@linux.intel.com> wrote:
> There has been some confusion over proper use of the linux-yocto-custom
> recipe. It is not intended to build as is from meta-skeleton. It should
> be modified via a bbappend file to provide a Linux kernel config at the
> very least.
>
> Update the commentary to make this requirement more explicit. Add some
> additional detail about how to create a bbappend file and how and when
> to modify the various variables.
>
> Clear COMPATIBLE_MACHINE so bitbake will not attempt to build the recipe
> unless the user explicitly adds there machine to the variable, which
> should encourage them to read the recipe comments before attempting to
> build it.
>
> Signed-off-by: Darren Hart <dvhart@linux.intel.com>
> CC: Bruce Ashfield <bruce.ashfield@windriver.com>
> CC: Tom Zanussi <tom.zanussi@intel.com>
> ---
>  .../recipes-kernel/linux/linux-yocto-custom.bb     | 52 +++++++++++++++-------
>  1 file changed, 35 insertions(+), 17 deletions(-)
>
> diff --git a/meta-skeleton/recipes-kernel/linux/linux-yocto-custom.bb b/meta-skeleton/recipes-kernel/linux/linux-yocto-custom.bb
> index 55f0c38..dd98228 100644
> --- a/meta-skeleton/recipes-kernel/linux/linux-yocto-custom.bb
> +++ b/meta-skeleton/recipes-kernel/linux/linux-yocto-custom.bb
> @@ -1,17 +1,35 @@
>  # linux-yocto-custom.bb:
>  #
> -#   Provides an example/minimal kernel recipe that uses the linux-yocto
> -#   and oe-core kernel classes to apply a subset of yocto kernel
> -#   management to git managed kernel repositories.
> +#   An example kernel recipe that uses the linux-yocto and oe-core
> +#   kernel classes to apply a subset of yocto kernel management to git
> +#   managed kernel repositories.
> +#
> +#   To use linux-yocto-custom in your layer, create a
> +#   linux-yocto-custom.bb file containing at least the following lines:

s/linux-yocto-custom.bb/linux-yocto-custom.bbappend/

> +#
> +#     FILESEXTRAPATHS_prepend := "${THISDIR}/${PN}:"
> +#     COMPATIBLE_MACHINE_yourmachine = "yourmachine"
> +#
> +#   You must also provide a Linux kernel configuration. The most direct
> +#   method is to copy your .config to files/defconfig in your layer,
> +#   parallel to the linux-yocto-custom.bbappend file.

hmm. parallel ready odd to me, but I don't have a better suggestion.

> +#
> +#   To use the yocto kernel tooling to generate a BSP configuration
> +#   using modular configuration fragments, see the yocto-bsp and
> +#   yocto-kernel tools documentation.
> +#
> +# Warning:
> +#
> +#   Building this example without providing a defconfig or BSP
> +#   configuration will result in build or boot errors. This is not a
> +#   bug.
> +#
>  #
>  # Notes:
>  #
> -#   kconfig(s): the kernel must be configured with a defconfig, or via
> -#               configuration fragment(s). Either of these can be added
> -#               via bbappend.

Leaving the part about configuration fragments might be useful.

.. but this looks good, lets see if it saves a few questions :)

Cheers,

Bruce

> -#   patches: patches can be merged into to the source git tree itself, added
> -#            using standard bbappend syntax or controlled via .scc feature
> -#            descriptions (also via bbappends)
> +#   patches: patches can be merged into to the source git tree itself,
> +#            added via the SRC_URI, or controlled via a BSP
> +#            configuration.
>  #
>  #   example configuration addition:
>  #            SRC_URI += "file://smp.cfg"
> @@ -20,25 +38,25 @@
>  #   example feature addition (for kernel v3.4 only):
>  #            SRC_URI += "file://feature.scc"
>  #
> -# Warning:
> -#
> -#   Building the sample kernel tree (kernel.org) without providing any
> -#   configuration will result in build or boot errors. This is not a bug
> -#   it is a required element for creating a valid kernel.
> -#
>
>  inherit kernel
>  require recipes-kernel/linux/linux-yocto.inc
>
> +# Override SRC_URI in a bbappend file to point at a different source
> +# tree if you do not want to build from Linus' tree.
>  SRC_URI = "git://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git;protocol=git;nocheckout=1"
>
>  LINUX_VERSION ?= "3.4"
>  LINUX_VERSION_EXTENSION ?= "-custom"
>
> +# Override SRCREV to point to a different commit in a bbappend file to
> +# build a different release of the Linux kernel.
>  # tag: v3.4 76e10d158efb6d4516018846f60c2ab5501900bc
>  SRCREV="76e10d158efb6d4516018846f60c2ab5501900bc"
>
> -PR = "r0"
> +PR = "r1"
>  PV = "${LINUX_VERSION}+git${SRCPV}"
>
> -COMPATIBLE_MACHINE = "(qemuarm|qemux86|qemuppc|qemumips|qemux86-64)"
> +# Override COMPATIBLE_MACHINE to include your machine in a bbappend
> +# file. Leaving it empty here ensures an early explicit build failure.
> +COMPATIBLE_MACHINE = "(^$)"
> --
> 1.7.11.2
>
>
> _______________________________________________
> Openembedded-core mailing list
> Openembedded-core@lists.openembedded.org
> http://lists.linuxtogo.org/cgi-bin/mailman/listinfo/openembedded-core



-- 
"Thou shalt not follow the NULL pointer, for chaos and madness await
thee at its end"



^ permalink raw reply	[flat|nested] 4+ messages in thread

* Re: [PATCH 1/1] linux-yocto-custom: Clarify usage and clear COMPATIBLE_MACHINE
  2012-08-04  0:27   ` Bruce Ashfield
@ 2012-08-06 15:52     ` Darren Hart
  0 siblings, 0 replies; 4+ messages in thread
From: Darren Hart @ 2012-08-06 15:52 UTC (permalink / raw)
  To: Bruce Ashfield; +Cc: Patches and discussions about the oe-core layer

On 08/03/2012 05:27 PM, Bruce Ashfield wrote:
> On Fri, Aug 3, 2012 at 7:29 PM, Darren Hart <dvhart@linux.intel.com> wrote:
>> There has been some confusion over proper use of the linux-yocto-custom
>> recipe. It is not intended to build as is from meta-skeleton. It should
>> be modified via a bbappend file to provide a Linux kernel config at the
>> very least.
>>
>> Update the commentary to make this requirement more explicit. Add some
>> additional detail about how to create a bbappend file and how and when
>> to modify the various variables.
>>
>> Clear COMPATIBLE_MACHINE so bitbake will not attempt to build the recipe
>> unless the user explicitly adds there machine to the variable, which
>> should encourage them to read the recipe comments before attempting to
>> build it.
>>
>> Signed-off-by: Darren Hart <dvhart@linux.intel.com>
>> CC: Bruce Ashfield <bruce.ashfield@windriver.com>
>> CC: Tom Zanussi <tom.zanussi@intel.com>
>> ---
>>  .../recipes-kernel/linux/linux-yocto-custom.bb     | 52 +++++++++++++++-------
>>  1 file changed, 35 insertions(+), 17 deletions(-)
>>
>> diff --git a/meta-skeleton/recipes-kernel/linux/linux-yocto-custom.bb b/meta-skeleton/recipes-kernel/linux/linux-yocto-custom.bb
>> index 55f0c38..dd98228 100644
>> --- a/meta-skeleton/recipes-kernel/linux/linux-yocto-custom.bb
>> +++ b/meta-skeleton/recipes-kernel/linux/linux-yocto-custom.bb
>> @@ -1,17 +1,35 @@
>>  # linux-yocto-custom.bb:
>>  #
>> -#   Provides an example/minimal kernel recipe that uses the linux-yocto
>> -#   and oe-core kernel classes to apply a subset of yocto kernel
>> -#   management to git managed kernel repositories.
>> +#   An example kernel recipe that uses the linux-yocto and oe-core
>> +#   kernel classes to apply a subset of yocto kernel management to git
>> +#   managed kernel repositories.
>> +#
>> +#   To use linux-yocto-custom in your layer, create a
>> +#   linux-yocto-custom.bb file containing at least the following lines:
> 
> s/linux-yocto-custom.bb/linux-yocto-custom.bbappend/

Thanks!

> 
>> +#
>> +#     FILESEXTRAPATHS_prepend := "${THISDIR}/${PN}:"
>> +#     COMPATIBLE_MACHINE_yourmachine = "yourmachine"
>> +#
>> +#   You must also provide a Linux kernel configuration. The most direct
>> +#   method is to copy your .config to files/defconfig in your layer,
>> +#   parallel to the linux-yocto-custom.bbappend file.
> 
> hmm. parallel ready odd to me, but I don't have a better suggestion.

"in the same directory as the bbappend."

> 
>> +#
>> +#   To use the yocto kernel tooling to generate a BSP configuration
>> +#   using modular configuration fragments, see the yocto-bsp and
>> +#   yocto-kernel tools documentation.
>> +#
>> +# Warning:
>> +#
>> +#   Building this example without providing a defconfig or BSP
>> +#   configuration will result in build or boot errors. This is not a
>> +#   bug.
>> +#
>>  #
>>  # Notes:
>>  #
>> -#   kconfig(s): the kernel must be configured with a defconfig, or via
>> -#               configuration fragment(s). Either of these can be added
>> -#               via bbappend.
> 
> Leaving the part about configuration fragments might be useful.

I removed it because I felt I adequately covered it above:

#   You must also provide a Linux kernel configuration. The most direct
#   method is to copy your .config to files/defconfig in your layer,
#   in the same directory as the bbappend.
#
#   To use the yocto kernel tooling to generate a BSP configuration
#   using modular configuration fragments, see the yocto-bsp and
#   yocto-kernel tools documentation.



> .. but this looks good, lets see if it saves a few questions :)

Will send V2 with your comments addressed.

--
Darren

> 
> Cheers,
> 
> Bruce
> 
>> -#   patches: patches can be merged into to the source git tree itself, added
>> -#            using standard bbappend syntax or controlled via .scc feature
>> -#            descriptions (also via bbappends)
>> +#   patches: patches can be merged into to the source git tree itself,
>> +#            added via the SRC_URI, or controlled via a BSP
>> +#            configuration.
>>  #
>>  #   example configuration addition:
>>  #            SRC_URI += "file://smp.cfg"
>> @@ -20,25 +38,25 @@
>>  #   example feature addition (for kernel v3.4 only):
>>  #            SRC_URI += "file://feature.scc"
>>  #
>> -# Warning:
>> -#
>> -#   Building the sample kernel tree (kernel.org) without providing any
>> -#   configuration will result in build or boot errors. This is not a bug
>> -#   it is a required element for creating a valid kernel.
>> -#
>>
>>  inherit kernel
>>  require recipes-kernel/linux/linux-yocto.inc
>>
>> +# Override SRC_URI in a bbappend file to point at a different source
>> +# tree if you do not want to build from Linus' tree.
>>  SRC_URI = "git://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git;protocol=git;nocheckout=1"
>>
>>  LINUX_VERSION ?= "3.4"
>>  LINUX_VERSION_EXTENSION ?= "-custom"
>>
>> +# Override SRCREV to point to a different commit in a bbappend file to
>> +# build a different release of the Linux kernel.
>>  # tag: v3.4 76e10d158efb6d4516018846f60c2ab5501900bc
>>  SRCREV="76e10d158efb6d4516018846f60c2ab5501900bc"
>>
>> -PR = "r0"
>> +PR = "r1"
>>  PV = "${LINUX_VERSION}+git${SRCPV}"
>>
>> -COMPATIBLE_MACHINE = "(qemuarm|qemux86|qemuppc|qemumips|qemux86-64)"
>> +# Override COMPATIBLE_MACHINE to include your machine in a bbappend
>> +# file. Leaving it empty here ensures an early explicit build failure.
>> +COMPATIBLE_MACHINE = "(^$)"
>> --
>> 1.7.11.2
>>
>>
>> _______________________________________________
>> Openembedded-core mailing list
>> Openembedded-core@lists.openembedded.org
>> http://lists.linuxtogo.org/cgi-bin/mailman/listinfo/openembedded-core
> 
> 
> 

-- 
Darren Hart
Intel Open Source Technology Center
Yocto Project - Technical Lead - Linux Kernel



^ permalink raw reply	[flat|nested] 4+ messages in thread

end of thread, other threads:[~2012-08-06 16:06 UTC | newest]

Thread overview: 4+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2012-08-03 23:29 [PATCH 0/1] linux-yocto-custom: Clarify usage and clear COMPATIBLE_MACHINE Darren Hart
2012-08-03 23:29 ` [PATCH 1/1] " Darren Hart
2012-08-04  0:27   ` Bruce Ashfield
2012-08-06 15:52     ` Darren Hart

This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.