BSP guide refers to meta-fri2 as example for binary/ data, it has none

BSP guide refers to meta-fri2 as example for binary/ data, it has none

[Robert P. J. Day]

  in sec 1.3.1 of BSP guide, there is an explanation of the
README.sources file. first, the text suggests that file is mandatory:

"You must include a README.sources in the meta-bsp_name directory."

however, as i read it, it's really only necessary when a layer
provides some binary content in the binary/ subdirectory. the guide
then goes on to claim that the meta-fri2 layer does just that, but i
see no binary content in that layer -- in fact, none of the meta-intel
sublayers appear to come with binary content. so perhaps that part of
the guide can be updated to refer to an appropriate layer.

rday

-- 

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

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

Re: BSP guide refers to meta-fri2 as example for binary/ data, it has none

[Rifenbark, Scott M]

>-----Original Message-----
>From: yocto-bounces@yoctoproject.org [mailto:yocto-
>bounces@yoctoproject.org] On Behalf Of Robert P. J. Day
>Sent: Tuesday, December 30, 2014 10:20 AM
>To: Yocto discussion list
>Subject: [yocto] BSP guide refers to meta-fri2 as example for binary/ data, it
>has none
>
>
>  in sec 1.3.1 of BSP guide, there is an explanation of the README.sources file.
>first, the text suggests that file is mandatory:
>
>"You must include a README.sources in the meta-bsp_name directory."

I understood that for a released BSP to be considered Yocto-compliant, the 
README.sources files is a requirement.
>
>however, as i read it, it's really only necessary when a layer provides some
>binary content in the binary/ subdirectory. the guide then goes on to claim
>that the meta-fri2 layer does just that, but i see no binary content in that layer
>-- in fact, none of the meta-intel sublayers appear to come with binary
>content. so perhaps that part of the guide can be updated to refer to an
>appropriate layer.

The wording here does imply that the sources are the ones used to generate the images that would be in the "binary/" directory.  Can someone tell me if it would be more accurate to state that the README.sources file simply indicates where the sources to build the BSP are period... regardless of whether or not any binaries are included in that directory?  Knowing that would help me make sure this section is not mis-leading.  Also, knowing that would help me choose an appropriate example to point to for the README.sources file.

>
>rday
>
>--
>
>===========================================================
>=============
>Robert P. J. Day                                 Ottawa, Ontario, CANADA
>                        http://crashcourse.ca
>
>Twitter:                                       http://twitter.com/rpjday
>LinkedIn:                               http://ca.linkedin.com/in/rpjday
>===========================================================
>=============
>--
>_______________________________________________
>yocto mailing list
>yocto@yoctoproject.org
>https://lists.yoctoproject.org/listinfo/yocto

Re: BSP guide refers to meta-fri2 as example for binary/ data, it has none

[Tom Zanussi]

On Mon, 2015-01-05 at 21:44 +0000, Rifenbark, Scott M wrote:
> 
> >-----Original Message-----
> >From: yocto-bounces@yoctoproject.org [mailto:yocto-
> >bounces@yoctoproject.org] On Behalf Of Robert P. J. Day
> >Sent: Tuesday, December 30, 2014 10:20 AM
> >To: Yocto discussion list
> >Subject: [yocto] BSP guide refers to meta-fri2 as example for binary/ data, it
> >has none
> >
> >
> >  in sec 1.3.1 of BSP guide, there is an explanation of the README.sources file.
> >first, the text suggests that file is mandatory:
> >
> >"You must include a README.sources in the meta-bsp_name directory."
> 
> I understood that for a released BSP to be considered Yocto-compliant, the 
> README.sources files is a requirement.
> >

Right, README.sources refers to the sources used to generate the
binaries in a released BSP e.g. the release tarballs on the Yocto BSP
Downloads page(s).

> >however, as i read it, it's really only necessary when a layer provides some
> >binary content in the binary/ subdirectory. the guide then goes on to claim
> >that the meta-fri2 layer does just that, but i see no binary content in that layer
> >-- in fact, none of the meta-intel sublayers appear to come with binary
> >content. so perhaps that part of the guide can be updated to refer to an
> >appropriate layer.
> 
> The wording here does imply that the sources are the ones used to
> generate the images that would be in the "binary/" directory.  Can
> someone tell me if it would be more accurate to state that the
> README.sources file simply indicates where the sources to build the
> BSP are period... regardless of whether or not any binaries are
> included in that directory?  Knowing that would help me make sure this
> section is not mis-leading.  Also, knowing that would help me choose
> an appropriate example to point to for the README.sources file.
> 

No. the README.sources indicate what was actually used to build the
images, which can and do contain much more than what is specified by the
recipes in the BSP layer.

So README.sources is meaningless if there are no binaries in /binary,
and the layer itself may have no /binary directory or README.sources
until a tarball is generated for release, which generation might be done
by the release process instead.

Again, this all refers to released BSPs, and if e.g. meta-fri2 doesn't
have these in the meta-intel git repo, any meta-fri2 released BSP
certainly does.

hth,

Tom

 

> >
> >rday
> >
> >--
> >
> >===========================================================
> >=============
> >Robert P. J. Day                                 Ottawa, Ontario, CANADA
> >                        http://crashcourse.ca
> >
> >Twitter:                                       http://twitter.com/rpjday
> >LinkedIn:                               http://ca.linkedin.com/in/rpjday
> >===========================================================
> >=============
> >--
> >_______________________________________________
> >yocto mailing list
> >yocto@yoctoproject.org
> >https://lists.yoctoproject.org/listinfo/yocto

Re: BSP guide refers to meta-fri2 as example for binary/ data, it has none

[Rifenbark, Scott M]

I fixed this up a bit.

Scott

>-----Original Message-----
>From: Zanussi, Tom
>Sent: Monday, January 05, 2015 2:14 PM
>To: Rifenbark, Scott M
>Cc: Robert P. J. Day; Yocto discussion list
>Subject: Re: [yocto] BSP guide refers to meta-fri2 as example for binary/ data,
>it has none
>
>On Mon, 2015-01-05 at 21:44 +0000, Rifenbark, Scott M wrote:
>>
>> >-----Original Message-----
>> >From: yocto-bounces@yoctoproject.org [mailto:yocto-
>> >bounces@yoctoproject.org] On Behalf Of Robert P. J. Day
>> >Sent: Tuesday, December 30, 2014 10:20 AM
>> >To: Yocto discussion list
>> >Subject: [yocto] BSP guide refers to meta-fri2 as example for binary/
>> >data, it has none
>> >
>> >
>> >  in sec 1.3.1 of BSP guide, there is an explanation of the README.sources
>file.
>> >first, the text suggests that file is mandatory:
>> >
>> >"You must include a README.sources in the meta-bsp_name directory."
>>
>> I understood that for a released BSP to be considered Yocto-compliant,
>> the README.sources files is a requirement.
>> >
>
>Right, README.sources refers to the sources used to generate the binaries in
>a released BSP e.g. the release tarballs on the Yocto BSP Downloads page(s).
>
>> >however, as i read it, it's really only necessary when a layer
>> >provides some binary content in the binary/ subdirectory. the guide
>> >then goes on to claim that the meta-fri2 layer does just that, but i
>> >see no binary content in that layer
>> >-- in fact, none of the meta-intel sublayers appear to come with
>> >binary content. so perhaps that part of the guide can be updated to
>> >refer to an appropriate layer.
>>
>> The wording here does imply that the sources are the ones used to
>> generate the images that would be in the "binary/" directory.  Can
>> someone tell me if it would be more accurate to state that the
>> README.sources file simply indicates where the sources to build the
>> BSP are period... regardless of whether or not any binaries are
>> included in that directory?  Knowing that would help me make sure this
>> section is not mis-leading.  Also, knowing that would help me choose
>> an appropriate example to point to for the README.sources file.
>>
>
>No. the README.sources indicate what was actually used to build the images,
>which can and do contain much more than what is specified by the recipes in
>the BSP layer.
>
>So README.sources is meaningless if there are no binaries in /binary, and the
>layer itself may have no /binary directory or README.sources until a tarball is
>generated for release, which generation might be done by the release
>process instead.
>
>Again, this all refers to released BSPs, and if e.g. meta-fri2 doesn't have these
>in the meta-intel git repo, any meta-fri2 released BSP certainly does.
>
>hth,
>
>Tom
>
>
>
>> >
>> >rday
>> >
>> >--
>> >
>>
>>==========================================================
>=
>> >=============
>> >Robert P. J. Day                                 Ottawa, Ontario, CANADA
>> >                        http://crashcourse.ca
>> >
>> >Twitter:                                       http://twitter.com/rpjday
>> >LinkedIn:                               http://ca.linkedin.com/in/rpjday
>>
>>==========================================================
>=
>> >=============
>> >--
>> >_______________________________________________
>> >yocto mailing list
>> >yocto@yoctoproject.org
>> >https://lists.yoctoproject.org/listinfo/yocto
>