Re: [PATCH] This patch provides usage of RTEMS cross-compiler over GCC cross-compiler
Sorry, I did not look into it deeply enough. I will make the necessary changes. On Thu, Mar 26, 2020 at 1:44 AM Gedare Bloom wrote: > short commit message is a bit wordy. It doesn't need to be a sentence. > We know it is a patch/commit. > > See https://devel.rtems.org/wiki/Developer/Git#GitCommits (which > should probably be in the docs, it is linked from > https://docs.rtems.org/branches/master/eng/vc-users.html#creating-a-patch) > > On Wed, Mar 25, 2020 at 12:58 PM utkarsh.ra...@gmail.com > wrote: > > > > --- > > user/start/tools.rst | 31 +++ > > 1 file changed, 31 insertions(+) > > > > diff --git a/user/start/tools.rst b/user/start/tools.rst > > index c3f039b..c3147e8 100644 > > --- a/user/start/tools.rst > > +++ b/user/start/tools.rst > > @@ -76,3 +76,34 @@ source code used. > > > > > > Add ``--verbose`` to the GCC command for the the verbose version > details. > > + > > +Need for RTEMS-Specific Cross-Compiler > > + > > + > > +New users are often confused as to why they can't use their > distribution's > > +cross-compiler for their target on rtems, e.g.,the riscv64-linux-gnu or > the > space after comma > > > > +arm-none-eabi-gcc. Below mentioned are some of the reasons for using > the RTEMS > > +cross-compiler. > > + > > + ``Correct configuration of newlib -`` > > + Newlib is a C standard library implementation intended for use on > embedded > > + systems. Most of the POSIX and libc support for RTEMS is derived from > newlib. > > + The RTEMS cross-compiler configures newlib correctly for RTEMS. > > + > > + ``Threading in GCC support libraries -`` > > + GCC support threading libraries such as ``pthread.h`` provide > threading > > + support to an application; these libraries are tailored according to > RTEMS using > > + the RTEMS cross-compiler. > This paragraph looks wrong to me. I don't think pthread.h comes > through gcc. We get it from newlib. But there are other threading > packages in gcc that we need to make "RTEMS-friendly" for languages > with threads such as Go threads (libgo) , openmp (libgomp), and maybe > others. if you want to provide one example do a bit of research to get > it right. It would also be possible to try to identify the exhaustive > set but that doesn't seem necessary. > > > + > > + ``Provide preprocessor define __rtems__ -`` > > + The ``__rtems__`` preprocessor define is used to provide conditional > code > > + compilation in source files that are shared with other projects e.g. > in newlib > > + or imported code from freebsd. > > + > > + ``Multilib variants to match the BSP -`` > > + RTEMS configures GCC to create separate runtime libraries for each > supported > > + instruction set, floating point unit, vector unit, word size (e.g. > 32-bit and > > + 64-bit), endianness, ABI, processor errata workarounds,and so on in > the > space after comma > > I don't think we actually multilib any 32/64 bit targets, but that's > probably fine to leave be. > > > + architecture. These libraries are termed multilib variants. Multilibs > variants > > + to match the BSP are set by selecting a specific set of machine > options using > > + the RTEMS cross-compiler. > > -- > > 2.17.1 > > > > ___ > > devel mailing list > > devel@rtems.org > > http://lists.rtems.org/mailman/listinfo/devel > ___ devel mailing list devel@rtems.org http://lists.rtems.org/mailman/listinfo/devel
Re: [PATCH] This patch provides usage of RTEMS cross-compiler over GCC cross-compiler
short commit message is a bit wordy. It doesn't need to be a sentence. We know it is a patch/commit. See https://devel.rtems.org/wiki/Developer/Git#GitCommits (which should probably be in the docs, it is linked from https://docs.rtems.org/branches/master/eng/vc-users.html#creating-a-patch) On Wed, Mar 25, 2020 at 12:58 PM utkarsh.ra...@gmail.com wrote: > > --- > user/start/tools.rst | 31 +++ > 1 file changed, 31 insertions(+) > > diff --git a/user/start/tools.rst b/user/start/tools.rst > index c3f039b..c3147e8 100644 > --- a/user/start/tools.rst > +++ b/user/start/tools.rst > @@ -76,3 +76,34 @@ source code used. > > > Add ``--verbose`` to the GCC command for the the verbose version details. > + > +Need for RTEMS-Specific Cross-Compiler > + > + > +New users are often confused as to why they can't use their distribution's > +cross-compiler for their target on rtems, e.g.,the riscv64-linux-gnu or the space after comma > +arm-none-eabi-gcc. Below mentioned are some of the reasons for using the > RTEMS > +cross-compiler. > + > + ``Correct configuration of newlib -`` > + Newlib is a C standard library implementation intended for use on embedded > + systems. Most of the POSIX and libc support for RTEMS is derived from > newlib. > + The RTEMS cross-compiler configures newlib correctly for RTEMS. > + > + ``Threading in GCC support libraries -`` > + GCC support threading libraries such as ``pthread.h`` provide threading > + support to an application; these libraries are tailored according to RTEMS > using > + the RTEMS cross-compiler. This paragraph looks wrong to me. I don't think pthread.h comes through gcc. We get it from newlib. But there are other threading packages in gcc that we need to make "RTEMS-friendly" for languages with threads such as Go threads (libgo) , openmp (libgomp), and maybe others. if you want to provide one example do a bit of research to get it right. It would also be possible to try to identify the exhaustive set but that doesn't seem necessary. > + > + ``Provide preprocessor define __rtems__ -`` > + The ``__rtems__`` preprocessor define is used to provide conditional code > + compilation in source files that are shared with other projects e.g. in > newlib > + or imported code from freebsd. > + > + ``Multilib variants to match the BSP -`` > + RTEMS configures GCC to create separate runtime libraries for each > supported > + instruction set, floating point unit, vector unit, word size (e.g. 32-bit > and > + 64-bit), endianness, ABI, processor errata workarounds,and so on in the space after comma I don't think we actually multilib any 32/64 bit targets, but that's probably fine to leave be. > + architecture. These libraries are termed multilib variants. Multilibs > variants > + to match the BSP are set by selecting a specific set of machine options > using > + the RTEMS cross-compiler. > -- > 2.17.1 > > ___ > devel mailing list > devel@rtems.org > http://lists.rtems.org/mailman/listinfo/devel ___ devel mailing list devel@rtems.org http://lists.rtems.org/mailman/listinfo/devel
[PATCH] This patch provides usage of RTEMS cross-compiler over GCC cross-compiler
--- user/start/tools.rst | 31 +++ 1 file changed, 31 insertions(+) diff --git a/user/start/tools.rst b/user/start/tools.rst index c3f039b..c3147e8 100644 --- a/user/start/tools.rst +++ b/user/start/tools.rst @@ -76,3 +76,34 @@ source code used. Add ``--verbose`` to the GCC command for the the verbose version details. + +Need for RTEMS-Specific Cross-Compiler + + +New users are often confused as to why they can't use their distribution's +cross-compiler for their target on rtems, e.g.,the riscv64-linux-gnu or the +arm-none-eabi-gcc. Below mentioned are some of the reasons for using the RTEMS +cross-compiler. + + ``Correct configuration of newlib -`` + Newlib is a C standard library implementation intended for use on embedded + systems. Most of the POSIX and libc support for RTEMS is derived from newlib. + The RTEMS cross-compiler configures newlib correctly for RTEMS. + + ``Threading in GCC support libraries -`` + GCC support threading libraries such as ``pthread.h`` provide threading + support to an application; these libraries are tailored according to RTEMS using + the RTEMS cross-compiler. + + ``Provide preprocessor define __rtems__ -`` + The ``__rtems__`` preprocessor define is used to provide conditional code + compilation in source files that are shared with other projects e.g. in newlib + or imported code from freebsd. + + ``Multilib variants to match the BSP -`` + RTEMS configures GCC to create separate runtime libraries for each supported + instruction set, floating point unit, vector unit, word size (e.g. 32-bit and + 64-bit), endianness, ABI, processor errata workarounds,and so on in the + architecture. These libraries are termed multilib variants. Multilibs variants + to match the BSP are set by selecting a specific set of machine options using + the RTEMS cross-compiler. -- 2.17.1 ___ devel mailing list devel@rtems.org http://lists.rtems.org/mailman/listinfo/devel
Re: [PATCH] This patch provides usage of RTEMS cross-compiler over GCC cross-compiler
On Sun, Mar 22, 2020 at 11:33 AM utkarsh.ra...@gmail.com wrote: > > Really sorry for a new patch, I somehow rm -rf'ed my machine's root Oh no! > --- > user/start/tools.rst | 16 > 1 file changed, 16 insertions(+) > > diff --git a/user/start/tools.rst b/user/start/tools.rst > index c3f039b..3bb939e 100644 > --- a/user/start/tools.rst > +++ b/user/start/tools.rst > @@ -76,3 +76,19 @@ source code used. > > > Add ``--verbose`` to the GCC command for the the verbose version details. > + > +Need for RTEMS-Specific Cross-Compiler > + > + New users are often confused as to why they can't use their distribution's > cross-compiler for their target on rtems, e.g.,the riscv64-linux-gnu or the > arm-none-eabi-gcc. Below mentioned are some of the reasons for using the > RTEMS cross-compiler. > + > + ``Correct configuration of newlib`` - > +Newlib is a C standard library implementation intended for use on > embedded systems. Most of the POSIX and libc support for RTEMS is derived > from newlib. The RTEMS cross-compiler configures newlib correctly for RTEMS. Fix line length (text width) should be <= 80 characters. > + > + ``Threading in GCC support libraries`` - > +GCC support threading libraries such as ``pthread.h`` provide threading > support to an application; these libraries are tailored according to RTEMS > using the RTEMS cross-compiler. > + > + ``Provide preprocessor define __rtems__`` - > +The ``__rtems__`` preprocessor define is used to provide conditional > code compilation in source files that are shared with other projects e.g. in > newlib or imported code from freebsd. > + > + ``Multilib variants to match the BSP``- > +RTEMS configures GCC to create separate runtime libraries for each > supported instruction set, floating point unit, vector unit, word size (e.g. > 32-bit and 64-bit), endianness, ABI, processor errata workarounds,and so on > in the architecture. These libraries are termed multilib variants. Multilibs > variants to match the BSP are set by selecting a specific set of machine > options using the RTEMS cross-compiler. > -- > 2.17.1 > > ___ > devel mailing list > devel@rtems.org > http://lists.rtems.org/mailman/listinfo/devel ___ devel mailing list devel@rtems.org http://lists.rtems.org/mailman/listinfo/devel
[PATCH] This patch provides usage of RTEMS cross-compiler over GCC cross-compiler
Really sorry for a new patch, I somehow rm -rf'ed my machine's root --- user/start/tools.rst | 16 1 file changed, 16 insertions(+) diff --git a/user/start/tools.rst b/user/start/tools.rst index c3f039b..3bb939e 100644 --- a/user/start/tools.rst +++ b/user/start/tools.rst @@ -76,3 +76,19 @@ source code used. Add ``--verbose`` to the GCC command for the the verbose version details. + +Need for RTEMS-Specific Cross-Compiler + + New users are often confused as to why they can't use their distribution's cross-compiler for their target on rtems, e.g.,the riscv64-linux-gnu or the arm-none-eabi-gcc. Below mentioned are some of the reasons for using the RTEMS cross-compiler. + + ``Correct configuration of newlib`` - +Newlib is a C standard library implementation intended for use on embedded systems. Most of the POSIX and libc support for RTEMS is derived from newlib. The RTEMS cross-compiler configures newlib correctly for RTEMS. + + ``Threading in GCC support libraries`` - +GCC support threading libraries such as ``pthread.h`` provide threading support to an application; these libraries are tailored according to RTEMS using the RTEMS cross-compiler. + + ``Provide preprocessor define __rtems__`` - +The ``__rtems__`` preprocessor define is used to provide conditional code compilation in source files that are shared with other projects e.g. in newlib or imported code from freebsd. + + ``Multilib variants to match the BSP``- +RTEMS configures GCC to create separate runtime libraries for each supported instruction set, floating point unit, vector unit, word size (e.g. 32-bit and 64-bit), endianness, ABI, processor errata workarounds,and so on in the architecture. These libraries are termed multilib variants. Multilibs variants to match the BSP are set by selecting a specific set of machine options using the RTEMS cross-compiler. -- 2.17.1 ___ devel mailing list devel@rtems.org http://lists.rtems.org/mailman/listinfo/devel
Re: [PATCH] This patch provides usage of RTEMS cross-compiler over GCC cross-compiler
Thanks Utkarsh, I have comments below. On Sun, Mar 22, 2020 at 4:53 AM utkarsh.ra...@gmail.com wrote: > > --- > user/start/tools.rst | 25 + > 1 file changed, 25 insertions(+) > > diff --git a/user/start/tools.rst b/user/start/tools.rst > index c3f039b..8a1f393 100644 > --- a/user/start/tools.rst > +++ b/user/start/tools.rst > @@ -76,3 +76,28 @@ source code used. > > > Add ``--verbose`` to the GCC command for the the verbose version details. > + > +RTEMS cross-compiler over GCC cross-compiler It is still a gcc cross compiler. I don't know that I like the heading here. Maybe "Need for RTEMS-Specific Cross-Compiler" is better? > + > +The new users are often confused as to why they can't use their > distributions cross-compiler for their target on rtems, e.g., Line length. Please limit to 80 characters. This is a general comment that I won't repeat below. Remove "The", start with "New users" distributions -> distribution's > +the riscv64-linux-gnu or the arm-none-eabi-gcc.Below mentioned are some > the reasons for using the RTEMS cross-compiler. add space in "gcc.Below" "some the" -> "some of the" > + > + ``Correct configuration of newlib`` - > +Newlib is a C standard library implementation intended Rebalance line lengths. You can probably set up your editor to do this automatically. That is the best choice when working with narrative text. (With code, you should deal with line breaks manually.) > +for use on embedded systems. Most of the POSIX and libc support for > RTEMS is derived from newlib. > +The RTEMS cross-compiler configures newlib correctly for RTEMS. > + > + ``Threading in GCC supported libraries`` - supported -> support > +GCC supported threading libraries such as ``pthread.h`` ditto > +provide threading support to an application,these libraries are tailored > according to RTEMS using add space after comma Replace comma with period or semicolon > +the RTEMS cross-compiler. > + > + ``Provide preprocessor define _rtems_`` - Two underscores __rtems__ here. > +The ``_rtems_`` preprocessor define is genarally used to include rtems typo: generally > +specific libraries.This preprocessor define is provided by the RTEMS > cross-compiler at the compile time. It is used to provide conditional code compilation in source files that are shared with other projects, e.g., in newlib or imported code from freebsd. > + > + ``Multilib variants to match the BSP``- > +RTEMS configures GCC to create separate runtime libraries for > +each supported instruction set, floating point unit, vector unit, word > size (e.g. 32-bit and 64-bit), endianess, too many spaces after "each" typo: endianness has two 'n' > +code model, ABI, processor errata workarounds, and so on in the > architecture. This is termed multilib. what is "code model"? "This is term multilib." -> "These libraries are termed multilib variants." > +Multilibs variants to match the BSP are set by selecting a specific set > of machine options using the RTEMS cross-compiler. > -- > 2.17.1 > > ___ > devel mailing list > devel@rtems.org > http://lists.rtems.org/mailman/listinfo/devel ___ devel mailing list devel@rtems.org http://lists.rtems.org/mailman/listinfo/devel
[PATCH] This patch provides usage of RTEMS cross-compiler over GCC cross-compiler
--- user/start/tools.rst | 25 + 1 file changed, 25 insertions(+) diff --git a/user/start/tools.rst b/user/start/tools.rst index c3f039b..8a1f393 100644 --- a/user/start/tools.rst +++ b/user/start/tools.rst @@ -76,3 +76,28 @@ source code used. Add ``--verbose`` to the GCC command for the the verbose version details. + +RTEMS cross-compiler over GCC cross-compiler + +The new users are often confused as to why they can't use their distributions cross-compiler for their target on rtems, e.g., +the riscv64-linux-gnu or the arm-none-eabi-gcc.Below mentioned are some the reasons for using the RTEMS cross-compiler. + + ``Correct configuration of newlib`` - +Newlib is a C standard library implementation intended +for use on embedded systems. Most of the POSIX and libc support for RTEMS is derived from newlib. +The RTEMS cross-compiler configures newlib correctly for RTEMS. + + ``Threading in GCC supported libraries`` - +GCC supported threading libraries such as ``pthread.h`` +provide threading support to an application,these libraries are tailored according to RTEMS using +the RTEMS cross-compiler. + + ``Provide preprocessor define _rtems_`` - +The ``_rtems_`` preprocessor define is genarally used to include rtems +specific libraries.This preprocessor define is provided by the RTEMS cross-compiler at the compile time. + + ``Multilib variants to match the BSP``- +RTEMS configures GCC to create separate runtime libraries for +each supported instruction set, floating point unit, vector unit, word size (e.g. 32-bit and 64-bit), endianess, +code model, ABI, processor errata workarounds, and so on in the architecture. This is termed multilib. +Multilibs variants to match the BSP are set by selecting a specific set of machine options using the RTEMS cross-compiler. -- 2.17.1 ___ devel mailing list devel@rtems.org http://lists.rtems.org/mailman/listinfo/devel
