Received: from mail-pg1-f194.google.com (mail-pg1-f194.google.com [209.85.215.194]) by mx.groups.io with SMTP id smtpd.web10.224.1586990368587206413 for ; Wed, 15 Apr 2020 15:39:28 -0700 Authentication-Results: mx.groups.io; dkim=pass header.i=@gmail.com header.s=20161025 header.b=fZa/SQ+L; spf=pass (domain: gmail.com, ip: 209.85.215.194, mailfrom: akuster808@gmail.com) Received: by mail-pg1-f194.google.com with SMTP id n16so646015pgb.7 for ; Wed, 15 Apr 2020 15:39:28 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=subject:to:references:from:autocrypt:cc:message-id:date:user-agent :mime-version:in-reply-to:content-language; bh=VkZY6ivpKX83X0G3u+jmfvPQOW36EKG9dRiUi92r6YE=; b=fZa/SQ+LGrAq6TOIq/wWPveUN/Sr+gKC9sHYpUtOxLedzkONiZ6zawfv1DrMFoLkys 3cTqs+0z6gdDDemk2/oXX/Qd2BAgP6aUH05kPlx4XMIq8E8UsFgtn6TPmEzSCSzbWV45 rjWDzY42a3clI1h0Do2GAoSscWkdaHzp7KmKMGNmhjM86RNNCJQmb7aApqtN8/b+oMBd I3L8biTziKFXxdkWjbzLLCLO5Wtavp7hpLXQ+2FbEFEOwUZa0TfV316YnABJHeHkdTdB Y3XLHF5AS/+BiDgWsHceCpWbXgq+Jum9f5n0pJjD0nmJxMJ2/KV/b+Zk4SvoNOE3u8CH Qocg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:subject:to:references:from:autocrypt:cc :message-id:date:user-agent:mime-version:in-reply-to :content-language; bh=VkZY6ivpKX83X0G3u+jmfvPQOW36EKG9dRiUi92r6YE=; b=eMNViZ3U3MzPebITWqiHOYRuepHnerxDs5fvbPy3Ssc1+0Yh/wBZN7NxdjJGy0+KuC 9fyDom+qXIl8udtLht1FJD8ZY+iXaVGiuztn3yJ9ypooVfOfoCaAcrNL2Eo4WUnPb0aB O3Mg1em6BuVWB3ja0Wvyt+NR4zKoh16KSZJxWVzgvc4sx5KghmxZGMoMghc/4Ly5c7p1 oMhB+M0mibWQ6fSXQZvdZVoUObVoJlbshWApNcvhfCRXvTGbgRd7/wkV8ZITRSpgJHQU G+6Sv3ny8cCrJg3ah//iM6dfNYZ1F+OqJFWScj07NOfVwsrOExOVtOjPDPbO9WgsdqHH 0nrg== X-Gm-Message-State: AGi0PuZJ+X0cDOt5+ZT7s3BhKox74hbPuV3PsBje+gA+OF3h4YO+ouU8 NsTBXy7YBissyGL7ezqA+yttdL6xLkMxsQ== X-Google-Smtp-Source: APiQypIFBDx9azWiPp3yANirGMVUXJj85gM7UlKFtNolUBzAy4W9MnUxUyLSzbOlQI8Z6OtaewqOIw== X-Received: by 2002:aa7:8696:: with SMTP id d22mr29686506pfo.54.1586990367513; Wed, 15 Apr 2020 15:39:27 -0700 (PDT) Return-Path: Received: from ?IPv6:2601:202:4180:a5c0:c885:40f8:b7ee:f5bd? ([2601:202:4180:a5c0:c885:40f8:b7ee:f5bd]) by smtp.gmail.com with ESMTPSA id a12sm8358453pfr.28.2020.04.15.15.39.26 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Wed, 15 Apr 2020 15:39:26 -0700 (PDT) Subject: Re: [docs] [PATCH 2/2] ref-manual: add migration section for 3.1 To: "bluelightning@bluelightning.org" References: <387de38945c4514c58edf915474a2ec474539746.1586987359.git.bluelightning@bluelightning.org> From: "akuster" Autocrypt: addr=akuster808@gmail.com; prefer-encrypt=mutual; keydata= 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 8CS2NxU= Cc: docs@lists.yoctoproject.org Message-ID: Date: Wed, 15 Apr 2020 15:39:26 -0700 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:68.0) Gecko/20100101 Thunderbird/68.4.1 MIME-Version: 1.0 In-Reply-To: <387de38945c4514c58edf915474a2ec474539746.1586987359.git.bluelightning@bluelightning.org> Content-Type: multipart/alternative; boundary="------------B926DF67F3382D27575A5BD5" Content-Language: en-US --------------B926DF67F3382D27575A5BD5 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Paul, On 4/15/20 2:49 PM, Paul Eggleton wrote: > From: Paul Eggleton > > Migration information for the 3.1 release. Thanks for pulling this together. I have in-lined a few questions below. > > Signed-off-by: Paul Eggleton > --- > documentation/ref-manual/migration.xml | 201 +++++++++++++++++++++++++ > 1 file changed, 201 insertions(+) > > diff --git a/documentation/ref-manual/migration.xml b/documentation/ref-= manual/migration.xml > index 03efc7be2..9422b5a27 100644 > --- a/documentation/ref-manual/migration.xml > +++ b/documentation/ref-manual/migration.xml > @@ -7095,6 +7095,207 @@ id=3Df4d4f99cfbc2396e49c1613a7d237b9e57f06f81'>c= ommit message. > > > > + > +
> + Moving to the Yocto Project 3.1 Release > + > + > + This section provides migration information for moving to the > + Yocto Project 3.1 Release from the prior release. > + > + > +
> + Minimum system requirements > + > + > + The following versions / requirements of build host compone= nts have been updated: > + > + gcc 5.0 > + python 3.5 > + tar 1.28 > + rpcgen is now requ= ired on the host (part of the libc-dev-bin package on = Ubuntu, Debian and related distributions, and the glibc package on RPM-based distributions). > + > + > + Additionally, the makeinfo and pod2man > + tools are no longer required on the ho= st. > + > +
> + > +
> + mpc8315e-rdb machine removed > + > + > + The MPC8315E-RDB machine is old/obsolete and unobtainable, = thus given the maintenance burden > + the mpc8315e-rdb machine configuration= that supported it has been removed > + in this release. The removal does leave a gap in official P= owerPC reference hardware > + support; this may change in future if a suitable machine wi= th accompanying support resources > + is found. > + > +
> + > +
> + Python 2 removed > + > + > + Due to the expiration of upstream support in January 2020, = support for Python 2 has now been removed; it is recommended that you use P= ython 3 instead. If absolutely needed there is a meta-python2 community lay= er containing Python 2, related classes and various Python 2-based modules,= however it should not be considered as supported. > + > +
> + > +
> + Reproducible builds now enabled by default > + > + > + In order to avoid unnecessary differences in output files (= aiding binary reproducibility), the Poky distribution configuration (DISTRO =3D "poky") now i= nherits the reproducible_build class by default. > + > +
AK] I think the l hash equivalence server is also enabled by default: commit 1fb4aa42f9c3b9738d78d198ad695fe4fcb6dc2f Author: Richard Purdie Date:=C2=A0=C2=A0 Wed Aug 7 21:56:01 2019 +0100 =C2=A0=C2=A0=C2=A0 poky: Default to enabling a local hash equivalence serv= er =C2=A0=C2=A0=C2=A0 > + > +
> + Impact of ptest feature is now more significant > + > + > + The Poky distribution configuration (DISTRO =3D "poky") enables ptests by def= ault to enable runtime testing of various components. In this release, a de= pendency needed to be added that has resulted in a significant increase in = the number of components that will be built just when building a simple ima= ge such as core-image-minimal. If you do not need runtime tests enabled for= core components, then it is recommended that you remove "ptest" from DISTRO_FEATURES to save a significant amount of build time e.g. by adding the following i= n your configuration: > + > + > + DISTRO_FEATURES_remove =3D "ptest" > + > + > +
> + > +
> + Removed recipes > + > + > + The following recipes have been removed: > + > + > + chkconfig: obsolet= e > + console-tools: obs= olete > + enchant: replaced = by enchant2 > + foomatic-filters: = obsolete > + libidn: no longer = needed, moved to meta-oe > + libmodulemd: repla= ced by libmodulemd-v1 > + linux-yocto: drop = 4.19, 5.2 version recipes (5.4 now provided) > + nspr: no longer ne= eded, moved to meta-oe > + nss: no longer nee= ded, moved to meta-oe > + python: Python 2 r= emoved (Python 3 preferred) > + python-setuptools:= Python 2 version removed (python3-setuptools preferred) > + sysprof: no longer= needed, moved to meta-oe > + texi2html: obsolet= e > + u-boot-fw-utils: f= unctionally replaced by libubootenv > + > + > +
> + > +
> + features_check class replaces distro_features_check</tit= le> > + > + <para> > + The <filename>distro_features_check</filename> class has ha= d its functionality expanded, now supporting <filename>ANY_OF_MACHINE_FEATU= RES</filename>, <filename>REQUIRED_MACHINE_FEATURES</filename>, <filename>C= ONFLICT_MACHINE_FEATURES</filename>, <filename>ANY_OF_COMBINED_FEATURES</fi= lename>, <filename>REQUIRED_COMBINED_FEATURES</filename>, <filename>CONFLIC= T_COMBINED_FEATURES</filename>. As a result the class has now been renamed = to <filename>features_check</filename>; the <filename>distro_features_check= </filename> class still exists but generates a warning and redirects to the= new class. In preparation for a future removal of the old class it is reco= mmended that you update recipes currently inheriting <filename>distro_featu= res_check</filename> to inherit <filename>features_check</filename> instead= . > + </para> > + </section> > + > + <section id=3D'migration-3.1-removed-classes'> > + <title>Removed classes > + > + > + The following classes have been removed: > + > + > + distutils-base: mo= ved to meta-python2 > + distutils: moved t= o meta-python2 > + libc-common: merge= d into the glibc recipe as nothing else used it. > + python-dir: moved = to meta-python2 > + pythonnative: move= d to meta-python2 > + setuptools: moved = to meta-python2 > + tinderclient: drop= ped as it was obsolete. > + > + > +
> + > +
> + SRC_URI checksum behaviour > + > + > + Previously, recipes by tradition included both SHA256 and M= D5 checksums for remotely fetched files in SRC_URI, even though only one is actually mandate= d. However, the MD5 checksum does not add much given its inherent weakness;= thus when a checksum fails only the SHA256 sum will now be printed. The md= 5sum will still be verified if it is specified. AK] If I am not mistaken, we can support all these in a recipe:=C2=A0 "md5= ", "sha256", "sha1", "sha384", "sha512" ref: bitbake/lib/bb/fetch2/__init__.py ; CHECKSUM_LIST Not sure if we want to mention that too??? not saying it has to include this. > + > +
> + > + > +
> + npm fetcher changes > + > + > + The npm fetcher has been completely reworked in this releas= e. The npm fetcher now only fetches the package source itself and no longer= the dependencies; there is now also an npmsw fetcher which explicitly fetc= hes the shrinkwrap file and the dependencies. This removes the slightly awk= ward NPM_LOCKDOWN and NPM_SHRINKWRAP variables which pointed to local files; the lockdown file is no longer = needed at all. Additionally, the package name in npm:// entries in SRC_URI is now specified using a package parameter instead= of the earlier name which overlapped with the generic= name parameter. All recipes using the npm fetcher wil= l need to be changed as a result.=20 > + > + > + An example of the new scheme: > + > +SRC_URI =3D "npm://registry.npmjs.org;package=3Darray-flatten;version= =3D1.1.1 \ > + npmsw://${THISDIR}/npm-shrinkwrap.json" > + > + Another example where the sources are fetched from git rath= er than an npm repository: > + > +SRC_URI =3D "git://github.com/foo/bar.git;protocol=3Dhttps \ > + npmsw://${THISDIR}/npm-shrinkwrap.json" > + > + > + > + devtool and recipetool have also been updated to match with= the npm fetcher changes. Other than producing working and more complete re= cipes for npm sources, there is also a minor change to the command line for= devtool: the --fetch-dev option has been renamed to <= filename>--npm-dev as it is npm-specific. > + > +
> + > + > +
> + Packaging changes > + > + > + > + intltool has been = removed from packagegroup-core-sdk as it is rarely nee= ded to build modern software - gettext can do most of the things it used to= be needed for. intltool has also been removed from packagegroup-core-self-hosted as it is not needed to for= standard builds. > + git: git-am, git-difftool, git-submodule, and git-request-pull are no longer perl-based, so are now insta= lled with the main git package instead of within git-perltools. > + The ldconfig binar= y built as part of glibc has now been moved to its own ldconfig package (note no glibc- prefix). This packag= e is in the RRECOMMENDS of the main glibc package if ldco= nfig is present in DISTRO_FEATURES. > + libevent now split= s each shared library into its own package (as Debian does). Since these ar= e shared libraries and will be pulled in through the normal shared library = dependency handling, there should be no impact to existing configurations o= ther than less unnecessary libraries being installed in some cases.<= /listitem> > + linux-firmware now has a new package fo= r bcm4366c and includes available NVRAM config files i= nto the bcm43340, bcm43362, bcm43430 and bcm4356-pcie packages. > + harfbuzz now split= s the new libharfbuzz-subset.so library into its own p= ackage to reduce the main package size in cases where libharfbuzz= -subset.so is not needed. > + > + > +
> + > +
> + Additional warnings > + > + > + Warnings will now be shown at do_package_qa time in the following circumstances: > + > + > + A recipe installs .desktop files containing MimeType keys but does not i= nherit the new mime-xdg class > + A recipe installs .xml files into ${datadir}/mime/packages but does not = inherit the mime class > + > + > +
> + > +
> + <filename>wic</filename> image type now used instead of = <filename>live</filename> by default for x86 > + > + > + conf/machine/include/x86-base.inc (inh= erited by most x86 machine configurations) now specifies wic instead of live by default in IMAGE_FSTYPES. The live image type will likely be removed in a future release so i= t is recommended that you use wic instead. > + > +
> + > +
> + Miscellaneous changes > + > + > + > + The undocumented SRC_DISTRIBU= TE_LICENSES variable has now been removed in favour of a new AVAILABLE_LICENSES variable which is dynamically set base= d upon license files found in ${COMMON_LICENSE_DIR} an= d ${LICENSE_PATH}. > + The tune definition for big-endian micr= oblaze machines is now microblaze instead of microblazeeb. > + newlib no longer h= as built-in syscalls. libgloss should then provide the= syscalls, crt0.o and other functions that are no long= er part of newlib itself. If you are using T= CLIBC =3D "newlib" this now means that you must link application= s with both newlib and libgloss, = whereas before newlib would run in many configurations= by itself. > + > + > +
> + > +
> + > + > >