[v6,13/13] Documentation for ARC port

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

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.