diff mbox series

[v6,13/13] Documentation for ARC port

Message ID 20200423014126.10417-14-vgupta@synopsys.com
State Superseded
Headers show
Series glibc port to ARC processors | expand

Commit Message

Vineet Gupta April 23, 2020, 1:41 a.m. UTC
Signed-off-by: Vineet Gupta <vgupta@synopsys.com>
---
 NEWS                | 9 +++++++++
 README              | 1 +
 manual/install.texi | 4 ++++
 3 files changed, 14 insertions(+)

Comments

Adhemerval Zanella June 4, 2020, 12:16 p.m. UTC | #1
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.
Vineet Gupta June 4, 2020, 3:36 p.m. UTC | #2
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.
diff mbox series

Patch

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
+
 * 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
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