[PATCH 6/6] rtems-docs: Edit commands to build first app

Ida Delphine idadelm at gmail.com
Tue Mar 16 08:28:00 UTC 2021


Regarding the patch to add instructions on how to set up a  patch message
in which file should I create this patch or make changes?

On Mon, Mar 15, 2021 at 8:57 PM Gedare Bloom <gedare at rtems.org> wrote:

> Hi Ida,
>
> On Mon, Mar 15, 2021 at 1:50 PM Gedare Bloom <gedare at rtems.org> wrote:
> >
> > Hi Ida,
> >
> > did you send the same set of patches twice, or are there changes
> > between the two sets?
> >
>
> Since I'm not quite sure what to look at here, please do me a favor
> and send a new patchset with a -v2 indicator [1], and also set the
> patch message to specify rtems-docs. git format patch supports to set
> the prefix with:
>      git format-patch HEAD^ --subject-prefix="PATCH rtems-docs"
> You can also create an alias to make this simpler [2]. In fact, if you
> can send a patch to add instructions how to set up patch message with
> the repo name to the text at [1] that would be another nice
> contribution :)
>
> [1]
> https://docs.rtems.org/branches/master/eng/vc-users.html#creating-a-patch
> [2] https://lists.rtems.org/pipermail/devel/2020-April/059308.html
>
> Thank you,
> Gedare
>
> > On Sun, Mar 14, 2021 at 8:26 PM Ida Delphine <idadelm at gmail.com> wrote:
> > >
> > > ---
> > >  user/start/app.rst | 104 ++++++++++++++++++++++-----------------------
> > >  1 file changed, 52 insertions(+), 52 deletions(-)
> > >
> > > diff --git a/user/start/app.rst b/user/start/app.rst
> > > index 8900f78..c343551 100644
> > > --- a/user/start/app.rst
> > > +++ b/user/start/app.rst
> > > @@ -8,7 +8,7 @@ Build Your Application
> > >  ======================
> > >
> > >  You tested a BSP in the previous section.  We built the ``erc32`` BSP
> > > -and it is installed under :file:`$HOME/quick-start/rtems/5`.
> > > +and it is installed under :file:`$HOME/quick-start/rtems/6`.
> > >
> > >  We will now create a simple Hello World application with a Git
> > >  repository and using the `Waf <https://waf.io>`_ build system.
> > > @@ -107,7 +107,7 @@ and copy the Waf script:
> > >      #
> > >      from __future__ import print_function
> > >
> > > -    rtems_version = "5"
> > > +    rtems_version = "6"
> > >
> > >      try:
> > >          import rtems_waf.rtems as rtems
> > > @@ -142,52 +142,52 @@ Configure the application using Waf's
> ``configure`` command:
> > >
> > >  .. code-block:: none
> > >
> > > -    ./waf configure --rtems=$HOME/quick-start/rtems/5
> --rtems-bsp=sparc/erc32
> > > +    ./waf configure --rtems=$HOME/quick-start/rtems/6
> --rtems-bsp=sparc/erc32 --rtems-version=6
> > >
> > >  The output will be something close to:
> > >
> > >  .. code-block:: none
> > >
> > > -     Setting top to                           : $BASE/app/hello
> > > -     Setting out to                           : $BASE/app/hello/build
> > > -     RTEMS Version                            : 5
> > > -     Architectures                            : sparc-rtems5
> > > -     Board Support Package (BSP)              : sparc-rtems5-erc32
> > > -     Show commands                            : no
> > > -     Long commands                            : no
> > > -     Checking for program 'sparc-rtems5-gcc'  :
> $BASE/rtems/5/bin/sparc-rtems5-gcc
> > > -     Checking for program 'sparc-rtems5-g++'  :
> $BASE/rtems/5/bin/sparc-rtems5-g++
> > > -     Checking for program 'sparc-rtems5-gcc'  :
> $BASE/rtems/5/bin/sparc-rtems5-gcc
> > > -     Checking for program 'sparc-rtems5-ld'   :
> $BASE/rtems/5/bin/sparc-rtems5-ld
> > > -     Checking for program 'sparc-rtems5-ar'   :
> $BASE/rtems/5/bin/sparc-rtems5-ar
> > > -     Checking for program 'sparc-rtems5-nm'   :
> $BASE/rtems/5/bin/sparc-rtems5-nm
> > > -     Checking for program 'sparc-rtems5-objdump' :
> $BASE/rtems/5/bin/sparc-rtems5-objdump
> > > -     Checking for program 'sparc-rtems5-objcopy' :
> $BASE/rtems/5/bin/sparc-rtems5-objcopy
> > > -     Checking for program 'sparc-rtems5-readelf' :
> $BASE/rtems/5/bin/sparc-rtems5-readelf
> > > -     Checking for program 'sparc-rtems5-strip'   :
> $BASE/rtems/5/bin/sparc-rtems5-strip
> > > -     Checking for program 'sparc-rtems5-ranlib'  :
> $BASE/rtems/5/bin/sparc-rtems5-ranlib
> > > -     Checking for program 'rtems-ld'             :
> $BASE/rtems/5/bin/rtems-ld
> > > -     Checking for program 'rtems-tld'            :
> $BASE/rtems/5/bin/rtems-tld
> > > -     Checking for program 'rtems-syms'           :
> $BASE/rtems/5/bin/rtems-syms
> > > -     Checking for program 'rtems-bin2c'          :
> $BASE/rtems/5/bin/rtems-bin2c
> > > -     Checking for program 'tar'                  : /usr/bin/tar
> > > -     Checking for program 'gcc, cc'              :
> $BASE/rtems/5/bin/sparc-rtems5-gcc
> > > -     Checking for program 'ar'                   :
> $BASE/rtems/5/bin/sparc-rtems5-ar
> > > -     Checking for program 'g++, c++'             :
> $BASE/rtems/5/bin/sparc-rtems5-g++
> > > -     Checking for program 'ar'                   :
> $BASE/rtems/5/bin/sparc-rtems5-ar
> > > -     Checking for program 'gas, gcc'             :
> $BASE/rtems/5/bin/sparc-rtems5-gcc
> > > -     Checking for program 'ar'                   :
> $BASE/rtems/5/bin/sparc-rtems5-ar
> > > -     Checking for c flags '-MMD'                 : yes
> > > -     Checking for cxx flags '-MMD'               : yes
> > > -     Compiler version (sparc-rtems5-gcc)         : 7.5.0 20191114
> (RTEMS 5, RSB 5.1.0, Newlib fbaa096)
> > > -     Checking for a valid RTEMS BSP installation : yes
> > > -     Checking for RTEMS_DEBUG                    : no
> > > -     Checking for RTEMS_MULTIPROCESSING          : no
> > > -     Checking for RTEMS_NEWLIB                   : yes
> > > -     Checking for RTEMS_POSIX_API                : yes
> > > -     Checking for RTEMS_SMP                      : no
> > > -     Checking for RTEMS_NETWORKING               : no
> > > -     'configure' finished successfully (0.686s)
> > > +    Setting top to                           : $BASE/app/hello
> > > +    Setting out to                           : $BASE/app/hello/build
> > > +    RTEMS Version                            : 6
> > > +    Architectures                            : sparc-rtems6
> > > +    Board Support Package (BSP)              : sparc-rtems6-erc32
> > > +    Show commands                            : no
> > > +    Long commands                            : no
> > > +    Checking for program 'sparc-rtems6-gcc'  :
> $BASE/rtems/6/bin/sparc-rtems6-gcc
> > > +    Checking for program 'sparc-rtems6-g++'  :
> $BASE/rtems/6/bin/sparc-rtems6-g++
> > > +    Checking for program 'sparc-rtems6-gcc'  :
> $BASE/rtems/6/bin/sparc-rtems6-gcc
> > > +    Checking for program 'sparc-rtems6-ld'   :
> $BASE/rtems/6/bin/sparc-rtems6-ld
> > > +    Checking for program 'sparc-rtems6-ar'   :
> $BASE/rtems/6/bin/sparc-rtems6-ar
> > > +    Checking for program 'sparc-rtems6-nm'   :
> $BASE/rtems/6/bin/sparc-rtems6-nm
> > > +    Checking for program 'sparc-rtems6-objdump' :
> $BASE/rtems/6/bin/sparc-rtems6-objdump
> > > +    Checking for program 'sparc-rtems6-objcopy' :
> $BASE/rtems/6/bin/sparc-rtems6-objcopy
> > > +    Checking for program 'sparc-rtems6-readelf' :
> $BASE/rtems/6/bin/sparc-rtems6-readelf
> > > +    Checking for program 'sparc-rtems6-strip'   :
> $BASE/rtems/6/bin/sparc-rtems6-strip
> > > +    Checking for program 'sparc-rtems6-ranlib'  :
> $BASE/rtems/6/bin/sparc-rtems6-ranlib
> > > +    Checking for program 'rtems-ld'             :
> $BASE/rtems/6/bin/rtems-ld
> > > +    Checking for program 'rtems-tld'            :
> $BASE/rtems/6/bin/rtems-tld
> > > +    Checking for program 'rtems-syms'           :
> $BASE/rtems/6/bin/rtems-syms
> > > +    Checking for program 'rtems-bin2c'          :
> $BASE/rtems/6/bin/rtems-bin2c
> > > +    Checking for program 'tar'                  : /usr/bin/tar
> > > +    Checking for program 'gcc, cc'              :
> $BASE/rtems/6/bin/sparc-rtems6-gcc
> > > +    Checking for program 'ar'                   :
> $BASE/rtems/6/bin/sparc-rtems6-ar
> > > +    Checking for program 'g++, c++'             :
> $BASE/rtems/6/bin/sparc-rtems6-g++
> > > +    Checking for program 'ar'                   :
> $BASE/rtems/6/bin/sparc-rtems6-ar
> > > +    Checking for program 'gas, gcc'             :
> $BASE/rtems/6/bin/sparc-rtems6-gcc
> > > +    Checking for program 'ar'                   :
> $BASE/rtems/6/bin/sparc-rtems6-ar
> > > +    Checking for c flags '-MMD'                 : yes
> > > +    Checking for cxx flags '-MMD'               : yes
> > > +    Compiler version (sparc-rtems6-gcc)         : 10.2.1 20210309
> (RTEMS 6, RSB 5e449fb5c2cb6812a238f9f9764fd339cbbf05c2, Newlib d10d0d9)
> > > +    Checking for a valid RTEMS BSP installation : yes
> > > +    Checking for RTEMS_DEBUG                    : no
> > > +    Checking for RTEMS_MULTIPROCESSING          : no
> > > +    Checking for RTEMS_NEWLIB                   : yes
> > > +    Checking for RTEMS_POSIX_API                : no
> > > +    Checking for RTEMS_SMP                      : no
> > > +    Checking for RTEMS_NETWORKING               : no
> > > +    'configure' finished successfully (1.142s)
> > >
> > >  Build the application:
> > >
> > > @@ -199,24 +199,24 @@ The output will be something close to:
> > >
> > >  .. code-block:: none
> > >
> > > -    Waf: Entering directory `$BASE/app/hello/build/sparc-rtems5-erc32'
> > > +    Waf: Entering directory `$BASE/app/hello/build/sparc-rtems6-erc32'
> > >      [1/3] Compiling init.c
> > >      [2/3] Compiling hello.c
> > > -    [3/3] Linking build/sparc-rtems5-erc32/hello.exe
> > > -    Waf: Leaving directory `$BASE/app/hello/build/sparc-rtems5-erc32'
> > > -    'build-sparc-rtems5-erc32' finished successfully (0.183s)
> > > +    [3/3] Linking build/sparc-rtems6-erc32/hello.exe
> > > +    Waf: Leaving directory `$BASE/app/hello/build/sparc-rtems6-erc32'
> > > +    'build-sparc-rtems6-erc32' finished successfully (0.183s)
> > >
> > >  Run the executable:
> > >
> > >  .. code-block:: none
> > >
> > > -    $HOME/quick-start/rtems/5/bin/rtems-run --rtems-bsps=erc32-sis
> build/sparc-rtems5-erc32/hello.exe
> > > +    $HOME/quick-start/rtems/6/bin/rtems-run --rtems-bsps=erc32-sis
> build/sparc-rtems6-erc32/hello.exe
> > >
> > >  The output will be something close to:
> > >
> > >  .. code-block:: none
> > >
> > > -    RTEMS Testing - Run, 5.1.0
> > > +    RTEMS Testing - Run, 6
> > >       Command Line: $BASE/rtems/5/bin/rtems-run --rtems-bsps=erc32-sis
> build/sparc-rtems5-erc32/hello.exe
> > >       Host: FreeBSD hihi 12.1-RELEASE-p2 FreeBSD 12.1-RELEASE-p2
> GENERIC amd64
> > >       Python: 3.7.6 (default, Jan 30 2020, 01:18:54) [Clang 6.0.1
> (tags/RELEASE_601/final 335540)]
> > > @@ -232,10 +232,10 @@ The output will be something close to:
> > >      Hello World
> > >
> > >      *** FATAL ***
> > > -    fatal source: 5 (RTEMS_FATAL_SOURCE_EXIT)
> > > +    fatal source: 6 (RTEMS_FATAL_SOURCE_EXIT)
> > >      fatal code: 0 (0x00000000)
> > > -    RTEMS version: 5.1.0
> > > -    RTEMS tools: 7.5.0 20191114 (RTEMS 5, RSB 5.1.0, Newlib fbaa096)
> > > +    RTEMS version: 6
> > > +    RTEMS tools: 7.5.0 20191114 (RTEMS 6, RSB 6, Newlib fbaa096)
> > >      executing thread ID: 0x08a010001
> > >      executing thread name: UI1
> > >      cpu 0 in error mode (tt = 0x101)
> > > --
> > > 2.25.1
> > >
> > > _______________________________________________
> > > devel mailing list
> > > devel at rtems.org
> > > http://lists.rtems.org/mailman/listinfo/devel
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.rtems.org/pipermail/devel/attachments/20210316/f9d51860/attachment-0001.html>


More information about the devel mailing list