[v6,13/13] Documentation for ARC port
Commit Message
Signed-off-by: Vineet Gupta <vgupta@synopsys.com>
---
NEWS | 9 +++++++++
README | 1 +
manual/install.texi | 4 ++++
3 files changed, 14 insertions(+)
Comments
On 22/04/2020 22:41, Vineet Gupta via Libc-alpha wrote:
> Signed-off-by: Vineet Gupta <vgupta@synopsys.com>
LGTM with a NEWS wording change.
> ---
> NEWS | 9 +++++++++
> README | 1 +
> manual/install.texi | 4 ++++
> 3 files changed, 14 insertions(+)
>
> diff --git a/NEWS b/NEWS
> index 0e627b34057d..d59c1ffb96e1 100644
> --- a/NEWS
> +++ b/NEWS
> @@ -15,6 +15,15 @@ Major new features:
>
> * New locale added: ckb_IQ (Kurdish/Sorani spoken in Iraq)
>
> +* Support for Synopsys ARC HS cores (ARCv2 ISA) running Linux.
> +
> + Port requires at least
> + - binutils-2.32 (binutils-2_31-branch: commit 6ce881c15fc4, 2018-10-04)
> + - gcc 8.3 (gcc-8-stable: commit 0d5ba57508c5, 2019-01-29)
> + - Linux kernel 5.1+ (64-bit time and offsets)
> +
> + Both Little and Big-Endian supported
> +
I would use the same wording for recent architectures additions (riscv64 and
csky):
* Support for Synopsys ARC HS cores (ARCv2 ISA) running Linux has been added.
This port requires at least binutils-2.32, gcc-8.3, and linux-5.1. Three
ABIs are supported:
- arc-linux-gnu
- arc-linux-gnuhf
- arbeb-linux-gnu
The arc* ABI is little-endian while areb is bigendian. All ABIs uses 64-bit
time (y2038 safe) and 64-bit file offsets (LFS default).
> * The GNU C Library now loads audit modules listed in the DT_AUDIT and
> DT_DEPAUDIT dynamic section entries of the main executable.
>
> diff --git a/README b/README
> index 31c5da0405bd..903f07e4840a 100644
> --- a/README
> +++ b/README
> @@ -24,6 +24,7 @@ The GNU C Library supports these configurations for using Linux kernels:
>
> aarch64*-*-linux-gnu
> alpha*-*-linux-gnu
> + arc*-*-linux-gnu
> arm-*-linux-gnueabi
> csky-*-linux-gnuabiv2
> hppa-*-linux-gnu
Ok.
> diff --git a/manual/install.texi b/manual/install.texi
> index 71bf47cac659..e1f15656cdc0 100644
> --- a/manual/install.texi
> +++ b/manual/install.texi
> @@ -507,6 +507,8 @@ the newest version of the compiler that is known to work for building
> release time, GCC 9.2.1 is the newest compiler verified to work to build
> @theglibc{}.
>
> +For ARC architecture builds, GCC 8.3 or higher is needed.
> +
> For multi-arch support it is recommended to use a GCC which has been built with
> support for GNU indirect functions. This ensures that correct debugging
> information is generated for functions selected by IFUNC resolvers. This
> @@ -528,6 +530,8 @@ No other assembler or linker has the necessary functionality at the
> moment. As of release time, GNU @code{binutils} 2.32 is the newest
> verified to work to build @theglibc{}.
>
> +ARC architecture needs @code{binutils} 2.32 or higher for TLS related fixes.
> +
> @item
> GNU @code{texinfo} 4.7 or later
>
>
Ok.
On 6/4/20 5:16 AM, Adhemerval Zanella via Libc-alpha wrote:
>
>
> On 22/04/2020 22:41, Vineet Gupta via Libc-alpha wrote:
>> Signed-off-by: Vineet Gupta <vgupta@synopsys.com>
>
> LGTM with a NEWS wording change.
>
>> ---
>> NEWS | 9 +++++++++
>> README | 1 +
>> manual/install.texi | 4 ++++
>> 3 files changed, 14 insertions(+)
>>
>> diff --git a/NEWS b/NEWS
>> index 0e627b34057d..d59c1ffb96e1 100644
>> --- a/NEWS
>> +++ b/NEWS
>> @@ -15,6 +15,15 @@ Major new features:
>>
>> * New locale added: ckb_IQ (Kurdish/Sorani spoken in Iraq)
>>
>> +* Support for Synopsys ARC HS cores (ARCv2 ISA) running Linux.
>> +
>> + Port requires at least
>> + - binutils-2.32 (binutils-2_31-branch: commit 6ce881c15fc4, 2018-10-04)
>> + - gcc 8.3 (gcc-8-stable: commit 0d5ba57508c5, 2019-01-29)
>> + - Linux kernel 5.1+ (64-bit time and offsets)
>> +
>> + Both Little and Big-Endian supported
>> +
>
> I would use the same wording for recent architectures additions (riscv64 and
> csky):
>
> * Support for Synopsys ARC HS cores (ARCv2 ISA) running Linux has been added.
> This port requires at least binutils-2.32, gcc-8.3, and linux-5.1. Three
> ABIs are supported:
>
> - arc-linux-gnu
> - arc-linux-gnuhf
> - arbeb-linux-gnu
>
> The arc* ABI is little-endian while areb is bigendian. All ABIs uses 64-bit
> time (y2038 safe) and 64-bit file offsets (LFS default).
Thx this is much better.
@@ -15,6 +15,15 @@ Major new features:
* New locale added: ckb_IQ (Kurdish/Sorani spoken in Iraq)
+* Support for Synopsys ARC HS cores (ARCv2 ISA) running Linux.
+
+ Port requires at least
+ - binutils-2.32 (binutils-2_31-branch: commit 6ce881c15fc4, 2018-10-04)
+ - gcc 8.3 (gcc-8-stable: commit 0d5ba57508c5, 2019-01-29)
+ - Linux kernel 5.1+ (64-bit time and offsets)
+
+ Both Little and Big-Endian supported
+
* The GNU C Library now loads audit modules listed in the DT_AUDIT and
DT_DEPAUDIT dynamic section entries of the main executable.
@@ -24,6 +24,7 @@ The GNU C Library supports these configurations for using Linux kernels:
aarch64*-*-linux-gnu
alpha*-*-linux-gnu
+ arc*-*-linux-gnu
arm-*-linux-gnueabi
csky-*-linux-gnuabiv2
hppa-*-linux-gnu
@@ -507,6 +507,8 @@ the newest version of the compiler that is known to work for building
release time, GCC 9.2.1 is the newest compiler verified to work to build
@theglibc{}.
+For ARC architecture builds, GCC 8.3 or higher is needed.
+
For multi-arch support it is recommended to use a GCC which has been built with
support for GNU indirect functions. This ensures that correct debugging
information is generated for functions selected by IFUNC resolvers. This
@@ -528,6 +530,8 @@ No other assembler or linker has the necessary functionality at the
moment. As of release time, GNU @code{binutils} 2.32 is the newest
verified to work to build @theglibc{}.
+ARC architecture needs @code{binutils} 2.32 or higher for TLS related fixes.
+
@item
GNU @code{texinfo} 4.7 or later