[PATCH] user: Update rsb-packages to reflect RTEMS 6 changes

Gedare Bloom gedare at rtems.org
Mon Aug 9 15:53:19 UTC 2021


On Mon, Aug 9, 2021 at 9:18 AM Joel Sherrill <joel at rtems.org> wrote:
>
> On Mon, Aug 9, 2021 at 10:07 AM Gedare Bloom <gedare at rtems.org> wrote:
> >
> > I have to think about this. The approach taken here just replaces 5.1
> > -> 6, it isn't updating the screengrabs. This means the tutorial isn't
> > "real" but that might be fine.
>
> He can replace the screenshots but that is not worth the trouble at
> this point IMO.
>
> > The other issue is that when we release, then this has to become 6 ->
> > 6.1 in the release, and 6 -> 7 in the master. How we manage this
> > becomes part of the release overhead.
>
> As Andrei pointed out, these sections trick you into thinking that
> you can ftp "releases" from the master. But they aren't right for the
> master if they say 5 or 6. I'm prone to have these type of sections
> have prominent warnings that they only apply to releases and not
> to fetching from git. At least that keeps the sections and flags them.
>
I'm ok with that.

> But it doesn't do anything about the burden of the release cycle.
>
Either we end up with instructions from an older release in a new one,
or we need a way to (automate) update for a release.

> --joel
>
> > On Fri, Aug 6, 2021 at 3:27 PM Ray Garza <raymond.garza at oarcorp.com> wrote:
> > >
> > > This updates all references and examples in the rtems docs: user/start/rsb-packages.rst to RTEMS 6
> > >
> > > ---
> > >  user/start/rsb-packages.rst | 68 ++++++++++++++++++-------------------
> > >  1 file changed, 34 insertions(+), 34 deletions(-)
> > >
> > > diff --git a/user/start/rsb-packages.rst b/user/start/rsb-packages.rst
> > > index 3119318..891ea6a 100644
> > > --- a/user/start/rsb-packages.rst
> > > +++ b/user/start/rsb-packages.rst
> > > @@ -19,8 +19,8 @@ Return to here once you have completed these steps.
> > >
> > >  You have chosen an installation prefix, the BSP to build, the tool's
> > >  architecure and prepared the source for the RSB in the previous sections.  We
> > > -have chosen :file:`$HOME/quick-start/rtems/5` as the installation prefix, the
> > > -``erc32`` BSP and the SPARC architecture name of ``sparc-rtems5``, and unpacked
> > > +have chosen :file:`$HOME/quick-start/rtems/6` as the installation prefix, the
> > > +``erc32`` BSP and the SPARC architecture name of ``sparc-rtems6``, and unpacked
> > >  the RSB source in :file:`$HOME/quick-start/src`.
> > >
> > >  You are now able to build :ref:`BSP Packages` or 3rd party libraries of code if you
> > > @@ -72,36 +72,36 @@ BSP.
> > >  .. code-block:: none
> > >
> > >      cd $HOME/quick-start/src/rsb/rtems
> > > -    ../source-builder/sb-set-builder --prefix=$HOME/quick-start/rtems/5 \
> > > +    ../source-builder/sb-set-builder --prefix=$HOME/quick-start/rtems/6 \
> > >          --with-rtems-tests=yes bsps/erc32
> > >
> > >  This command should output something like this:
> > >
> > >  .. code-block:: none
> > >
> > > -    RTEMS Source Builder - Set Builder, 5.1.0
> > > +    RTEMS Source Builder - Set Builder, 6 (4e6dc6431435)
> > >      Build Set: bsps/erc32
> > > -    Build Set: 5/rtems-sparc.bset
> > > -    Build Set: 5/rtems-autotools.bset
> > > -    Build Set: 5/rtems-autotools-internal.bset
> > > +    Build Set: 6/rtems-sparc.bset
> > > +    Build Set: 6/rtems-autotools.bset
> > > +    Build Set: 6/rtems-autotools-internal.bset
> > >      config: tools/rtems-autoconf-2.69-1.cfg
> > >      package: autoconf-2.69-x86_64-freebsd12.1-1
> > >      building: autoconf-2.69-x86_64-freebsd12.1-1
> > >      sizes: autoconf-2.69-x86_64-freebsd12.1-1: 7.505MB (installed: 0.000B)
> > >      ...
> > > -    building: protobuf-2.6.1-sparc-rtems5-1
> > > -    sizes: protobuf-2.6.1-sparc-rtems5-1: 228.079MB (installed: 84.408MB)
> > > -    cleaning: protobuf-2.6.1-sparc-rtems5-1
> > > -    reporting: net/protobuf-2.6.1-1.cfg -> protobuf-2.6.1-sparc-rtems5-1.txt
> > > -    reporting: net/protobuf-2.6.1-1.cfg -> protobuf-2.6.1-sparc-rtems5-1.xml
> > > -    staging: protobuf-2.6.1-sparc-rtems5-1 -> $HOME/quick-start/src/rsb/rtems/build/tmp/sb-500-staging
> > > -    cleaning: protobuf-2.6.1-sparc-rtems5-1
> > > -    Build Set: Time 0:00:23.564992
> > > -    Build Set: Time 0:02:27.380299
> > > +    building: protobuf-2.6.1-sparc-rtems6
> > > +    sizes: protobuf-2.6.1-sparc-rtems6: 228.079MB (installed: 84.408MB)
> > > +    cleaning: protobuf-2.6.1-sparc-rtems6
> > > +    reporting: net/protobuf-2.6.1-1.cfg -> protobuf-2.6.1-sparc-rtems6.txt
> > > +    reporting: net/protobuf-2.6.1-1.cfg -> protobuf-2.6.1-sparc-rtems6.xml
> > > +    staging: protobuf-2.6.1-sparc-rtems6 -> $HOME/quick-start/src/rsb/rtems/build/tmp/sb-500-staging
> > > +    cleaning: protobuf-2.6.1-sparc-rtems6
> > > +    Build Set: Time 0:00:27.784056
> > > +    Build Set: Time 0:02:32.697406
> > >      installing: bsps/erc32 -> $HOME/quick-start/rtems/
> > >      clean staging: bsps/erc32
> > > -    Staging Size: 1.372GB
> > > -    Build Set: Time 0:24:17.83979
> > > +    Staging Size: 1.401GB
> > > +    Build Set: Time 0:25:08.37754
> > >
> > >  The RSB BSP build can be customised with following RSB command line options:
> > >
> > > @@ -147,10 +147,10 @@ be a list of build sets. To view the avaliable build sets run this command:
> > >  RTEMS package naming is based on the naming FreeBSD uses in its ports
> > >  collection.
> > >
> > > -This Quick Start Guide will build the BSD Library or :file:`5/rtems-libbsd`.
> > > +This Quick Start Guide will build the BSD Library or :file:`6/rtems-libbsd`.
> > >
> > >  An RTEMS package is hosted on RTEMS so the tool suite name needs to be supplied
> > > -using the ``--host`` option, e.g. ``--host=sparc-rtem5``. The BSP needs to be
> > > +using the ``--host`` option, e.g. ``--host=sparc-rtem6``. The BSP needs to be
> > >  provided using the ``--with-rtems-bsp`` option,
> > >  e.g. ``--with-rtems-bsp=erc32``. The commands to build ``libbsd`` for the
> > >  ``erc32`` BSP are:
> > > @@ -158,25 +158,25 @@ e.g. ``--with-rtems-bsp=erc32``. The commands to build ``libbsd`` for the
> > >  .. code-block:: none
> > >
> > >      cd $HOME/quick-start/src/rsb/rtems
> > > -    ../source-builder/sb-set-builder --prefix=$HOME/quick-start/rtems/5 \
> > > -      --host=sparc-rtems5 --with-rtems-bsp=erc32 5/rtems-libbsd
> > > +    ../source-builder/sb-set-builder --prefix=$HOME/quick-start/rtems/6 \
> > > +      --host=sparc-rtems6 --with-rtems-bsp=erc32 6/rtems-libbsd
> > >
> > >  This command should output something like this:
> > >
> > >  .. code-block:: none
> > >
> > > -    RTEMS Source Builder - Set Builder, 5.1.0
> > > -    Build Set: 5/rtems-libbsd
> > > -    config: tools/rtems-libbsd-5.cfg
> > > -    package: rtems-libbsd-v3cc039cdac77272a8e16b33ae5a53ccd89edf989-sparc-rtems5-1
> > > -    building: rtems-libbsd-v3cc039cdac77272a8e16b33ae5a53ccd89edf989-sparc-rtems5-1
> > > -    sizes: rtems-libbsd-v3cc039cdac77272a8e16b33ae5a53ccd89edf989-sparc-rtems5-1: 1.199GB (installed: 116.541MB)
> > > -    cleaning: rtems-libbsd-v3cc039cdac77272a8e16b33ae5a53ccd89edf989-sparc-rtems5-1
> > > -    reporting: tools/rtems-libbsd-5.cfg -> rtems-libbsd-v3cc039cdac77272a8e16b33ae5a53ccd89edf989-sparc-rtems5-1.txt
> > > -    reporting: tools/rtems-libbsd-5.cfg -> rtems-libbsd-v3cc039cdac77272a8e16b33ae5a53ccd89edf989-sparc-rtems5-1.xml
> > > -    installing: rtems-libbsd-v3cc039cdac77272a8e16b33ae5a53ccd89edf989-sparc-rtems5-1 -> $HOME/quick-start/rtems/5
> > > -    cleaning: rtems-libbsd-v3cc039cdac77272a8e16b33ae5a53ccd89edf989-sparc-rtems5-1
> > > -    Build Set: Time 0:00:51.898231
> > > +    RTEMS Source Builder - Set Builder, 6 (4e6dc6431435)
> > > +    Build Set: 6/rtems-libbsd
> > > +    config: tools/rtems-libbsd-6.cfg
> > > +    package: rtems-libbsd-v3cc039cdac77272a8e16b33ae5a53ccd89edf989-sparc-rtems6
> > > +    building: rtems-libbsd-v3cc039cdac77272a8e16b33ae5a53ccd89edf989-sparc-rtems6
> > > +    sizes: rtems-libbsd-v3cc039cdac77272a8e16b33ae5a53ccd89edf989-sparc-rtems6: 1.199GB (installed: 116.541MB)
> > > +    cleaning: rtems-libbsd-v3cc039cdac77272a8e16b33ae5a53ccd89edf989-sparc-rtems6
> > > +    reporting: tools/rtems-libbsd-6.cfg -> rtems-libbsd-v3cc039cdac77272a8e16b33ae5a53ccd89edf989-sparc-rtems6.txt
> > > +    reporting: tools/rtems-libbsd-6.cfg -> rtems-libbsd-v3cc039cdac77272a8e16b33ae5a53ccd89edf989-sparc-rtems6.xml
> > > +    installing: rtems-libbsd-v3cc039cdac77272a8e16b33ae5a53ccd89edf989-sparc-rtems6 -> $HOME/quick-start/rtems/6
> > > +    cleaning: rtems-libbsd-v3cc039cdac77272a8e16b33ae5a53ccd89edf989-sparc-rtems6
> > > +    Build Set: Time 0:00:55.045735
> > >
> > >  .. note::
> > >
> > > --
> > > 2.27.0
> > >
> > > _______________________________________________
> > > devel mailing list
> > > devel at rtems.org
> > > http://lists.rtems.org/mailman/listinfo/devel
> > _______________________________________________
> > devel mailing list
> > devel at rtems.org
> > http://lists.rtems.org/mailman/listinfo/devel


More information about the devel mailing list