[PATCH 6/6] rtems-docs: Edit commands to build first app
Gedare Bloom
gedare at rtems.org
Tue Mar 16 15:17:05 UTC 2021
$ cd rtems-docs
$ grep -r "Creating a Patch" --exclude-dir=build
eng/vc-users.rts:Creating a Patch
On Tue, Mar 16, 2021 at 2:28 AM Ida Delphine <idadelm at gmail.com> wrote:
>
> 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
More information about the devel
mailing list