[v4,15/15] Documentation for ARC port

Message ID 20200313030419.15843-16-vgupta@synopsys.com
State Superseded
Headers
Series glibc port to ARC processors |

Commit Message

Vineet Gupta March 13, 2020, 3:04 a.m. UTC
  Signed-off-by: Vineet Gupta <vgupta@synopsys.com>
---
 NEWS                | 11 +++++++++++
 README              |  1 +
 manual/install.texi |  5 +++++
 3 files changed, 17 insertions(+)
  

Comments

Joseph Myers March 27, 2020, 10:49 p.m. UTC | #1
On Thu, 12 Mar 2020, Vineet Gupta via Libc-alpha wrote:

> +* Support for ARC HS cores running Linux has been contributed by Synopsys.
> +
> +  Port requires atleast
> +    - 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+
> +
> +  ISA: ARCv2
> +  ABI: 32-bit, soft-float, LE: /lib/ld-linux-arc.so.2 (compatible with
> +       hard-float builds)

I don't think the default of the dynamic linker name etc. (which should go 
on https://sourceware.org/glibc/wiki/ABIList) belong in the NEWS entry.
  
Vineet Gupta March 27, 2020, 11:56 p.m. UTC | #2
On 3/27/20 3:49 PM, Joseph Myers wrote:
> On Thu, 12 Mar 2020, Vineet Gupta via Libc-alpha wrote:
> 
>> +* Support for ARC HS cores running Linux has been contributed by Synopsys.
>> +
>> +  Port requires atleast
>> +    - 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+
>> +
>> +  ISA: ARCv2
>> +  ABI: 32-bit, soft-float, LE: /lib/ld-linux-arc.so.2 (compatible with
>> +       hard-float builds)
> I don't think the default of the dynamic linker name etc. (which should go 
> on https://sourceware.org/glibc/wiki/ABIList) belong in the NEWS entry.

OK, at the time port is ready and about to be committed or now ?
  
Joseph Myers March 28, 2020, 12:01 a.m. UTC | #3
On Fri, 27 Mar 2020, Vineet Gupta via Libc-alpha wrote:

> On 3/27/20 3:49 PM, Joseph Myers wrote:
> > On Thu, 12 Mar 2020, Vineet Gupta via Libc-alpha wrote:
> > 
> >> +* Support for ARC HS cores running Linux has been contributed by Synopsys.
> >> +
> >> +  Port requires atleast
> >> +    - 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+
> >> +
> >> +  ISA: ARCv2
> >> +  ABI: 32-bit, soft-float, LE: /lib/ld-linux-arc.so.2 (compatible with
> >> +       hard-float builds)
> > I don't think the default of the dynamic linker name etc. (which should go 
> > on https://sourceware.org/glibc/wiki/ABIList) belong in the NEWS entry.
> 
> OK, at the time port is ready and about to be committed or now ?

I think the wiki should be updated at the time the port is committed.  
https://sourceware.org/glibc/wiki/NewPorts lists all the wiki pages that 
should be updated (MAINTAINERS, ABIList, PortStatus, Release/X.Y and the 
copy for the next release).
  

Patch

diff --git a/NEWS b/NEWS
index b03681eb1462..fd1ef4f56429 100644
--- a/NEWS
+++ b/NEWS
@@ -17,6 +17,17 @@  Major new features:
     - rv32imafdc ilp32
     - rv32imafdc ilp32d
 
+* Support for ARC HS cores running Linux has been contributed by Synopsys.
+
+  Port requires atleast
+    - 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+
+
+  ISA: ARCv2
+  ABI: 32-bit, soft-float, LE: /lib/ld-linux-arc.so.2 (compatible with
+       hard-float builds)
+
 Deprecated and removed features, and other changes affecting compatibility:
 
   [Add deprecations, removals and changes affecting compatibility here]
diff --git a/README b/README
index cee86ab178cf..73b4f9f3c907 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..c4b11e4e7973 100644
--- a/manual/install.texi
+++ b/manual/install.texi
@@ -507,6 +507,9 @@  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 is needed which has the necessary
+fixes to support @theglibc{}.
+
 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 +531,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 for TLS related fixes.
+
 @item
 GNU @code{texinfo} 4.7 or later