From patchwork Mon Feb 10 15:50:40 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Tobias Burnus X-Patchwork-Id: 106259 Return-Path: X-Original-To: patchwork@sourceware.org Delivered-To: patchwork@sourceware.org Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id 3B6A33858288 for ; Mon, 10 Feb 2025 15:51:38 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 3B6A33858288 Authentication-Results: sourceware.org; dkim=pass (2048-bit key, unprotected) header.d=baylibre-com.20230601.gappssmtp.com header.i=@baylibre-com.20230601.gappssmtp.com header.a=rsa-sha256 header.s=20230601 header.b=oK5mPBMK X-Original-To: gcc-patches@gcc.gnu.org Delivered-To: gcc-patches@gcc.gnu.org Received: from mail-wm1-x32a.google.com (mail-wm1-x32a.google.com [IPv6:2a00:1450:4864:20::32a]) by sourceware.org (Postfix) with ESMTPS id 5551D3858D21 for ; Mon, 10 Feb 2025 15:50:44 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org 5551D3858D21 Authentication-Results: sourceware.org; dmarc=none (p=none dis=none) header.from=baylibre.com Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=baylibre.com ARC-Filter: OpenARC Filter v1.0.0 sourceware.org 5551D3858D21 Authentication-Results: server2.sourceware.org; arc=none smtp.remote-ip=2a00:1450:4864:20::32a ARC-Seal: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1739202644; cv=none; b=VLDKDRvesXAWnsQSrAsNh2hTKubKY/KDCkIMaIoWN5ZGpwGbXN9tQwQRtVrSoT1ZIGthXcoom7nbgtcUczps1CR1GKBWZqwXPz7afaRn/PjuBRQVfm2ujLY4YBO04KuCkCC9VOtW5uQ5ohoBBM0kN7RbdECOaJDPbMi4eohBa2Y= ARC-Message-Signature: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1739202644; c=relaxed/simple; bh=uxhj69YkOLuwdXWU5PyRtLdxv4gM3ft4uxQHVPERY1k=; h=DKIM-Signature:Message-ID:Date:MIME-Version:To:From:Subject; b=tSSXYzOCYnNrNSnT4WJWFWwzd+j15YryGdOEcMSpzjbZVXsAE5gCrRc6akUOwcyMYx52gnix6gvgkuHh5o3wxc+8CE/cjZ1+1/9Yshzf2mxcprAmLT1wWBG07UzL0a0Dn7wWaM9aLXgyG3lGoohEpnUuE1c70jcU5MtzKQybWjc= ARC-Authentication-Results: i=1; server2.sourceware.org DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 5551D3858D21 Received: by mail-wm1-x32a.google.com with SMTP id 5b1f17b1804b1-43937cf2131so12043195e9.2 for ; Mon, 10 Feb 2025 07:50:44 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=baylibre-com.20230601.gappssmtp.com; s=20230601; t=1739202643; x=1739807443; darn=gcc.gnu.org; h=subject:from:cc:to:content-language:user-agent:mime-version:date :message-id:from:to:cc:subject:date:message-id:reply-to; bh=cEBwNlOE11gdABgabDerUvEJD2Tr59/hAx3e/DhP5tU=; b=oK5mPBMKH8cdWgGH3M64hRuFbk1NmircU1IhHICfqPzBO6z5vBQ8XiGBME3DepBmz5 cN0JAArftWZ9gTXXXkRcrBr6ZxqgkyVPuUAOHuI0DzcKDvLpYfT8Wl/ZDaZL/l0UbAq2 tDwijZ6n2fbHlwC7A0cVZ1AJvp2DLWr78M/RurhliTbn7xfyFCHrnSv6HRCum7qG0oeX yUz3kiOjlhS5iTkeAOelNdYqnj0YgTS35fH0uwr8yoeGXkdIQCGchbxfSr77ZuXBVsHT E+Y56Kn640uoEn/1t/9eI6VsaNZ7r2AgvUP6lYNFJG5espsdMUcjnytZKzegsulWcS+Y +qLA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1739202643; x=1739807443; h=subject:from:cc:to:content-language:user-agent:mime-version:date :message-id:x-gm-message-state:from:to:cc:subject:date:message-id :reply-to; bh=cEBwNlOE11gdABgabDerUvEJD2Tr59/hAx3e/DhP5tU=; b=dcPRp53LFAj9RSjurxSxEcy88FcRvi6MP9wlXsR8ApRC9lXbj9kh4U/EIUFsPpe390 JhDyaub0zhiQpH6w7QzSk6legOtB+bqKFsoBUm3/K/3SQtJ5bbkP3w30mxJI8sVSnI9Z CAL/94gk2oLhgkabLgVD4ln38m5q9XEmMGEYAF/OmuxfYmiqzltFXPtaJYwkl/6ggYEU dkZ1p4NsiAbbq1qPm6Ow6dZq6xa46O3rR4KtZy6H9F7OcOhQbzbAmN6HzNzM+cPYlTn4 lOg13eebvukT5T9L4mAVtJuxXARVPxBKKTkReZycdpvmVDqdWyWopF3Q08egPOC3FTT+ sJ7g== X-Gm-Message-State: AOJu0YysU9GK70s2TYIZEfZdk/QvPBTaslFcDNBj8ClQ2sWggsWnTuK0 wrIRx5xSAzvfqNQFCW5l4V6k2vi2VyEroAcl6k8s/2MF+onmFave0dFlJvFhqTF+fk3GbqXLfmH D X-Gm-Gg: ASbGnct+Run6/2hzEfWLpw3M+BZ4CSaztVeI3gre0n0gxEfhXHK+HJrjeLlMaV3og2k 5re9SBFwCI/tp1papl2zZNK1yhotwHpkjb0olrj9pZYBnk8PNLUYehZKXiKPcHIf17MeAWyhXQH gS+C0lTfJHi2Ncs9QXCfTJ6zVE2xtBan+bHN3ENCpy1+YMckRSGCZrIWBC4po+2Zcc+IxbPmnHJ 79x/4Zz/bkkG8PqkcE5YjuFBMVe14E6rFG0MDXJ2YVAJUZko8N0LpnsgPbxp97z/Xeyqq8I2S4n TkdRsTXA5AtYesutHh1MKIn0dWmYUDm0tZ4qW081pB9fRavO+ZrhKXweXa/TCXOhLysyjtHVsqc = X-Google-Smtp-Source: AGHT+IEyaVqbzfT/BGikOdFdL2KjTpYzWz1rXbkWuN7krj8Wbmh3xmsoeVfSyn2ubaoJ1KZQ+cHTpw== X-Received: by 2002:a05:600c:4fd1:b0:434:f1e9:afae with SMTP id 5b1f17b1804b1-4394c8078e1mr2744105e9.1.1739202642545; Mon, 10 Feb 2025 07:50:42 -0800 (PST) Received: from [192.168.178.228] (business-24-134-250-121.pool2.vodafone-ip.de. [24.134.250.121]) by smtp.gmail.com with ESMTPSA id ffacd0b85a97d-38dd44c5e3dsm7205866f8f.62.2025.02.10.07.50.41 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Mon, 10 Feb 2025 07:50:42 -0800 (PST) Message-ID: Date: Mon, 10 Feb 2025 16:50:40 +0100 MIME-Version: 1.0 User-Agent: Mozilla Thunderbird Content-Language: en-US To: gcc-patches , Andrew Stubbs Cc: Sandra Loosemore From: Tobias Burnus Subject: [Patch] [gcn] install.texi: Update for new ISA targets and their requirements X-Spam-Status: No, score=-12.2 required=5.0 tests=BAYES_00, DKIM_SIGNED, DKIM_VALID, GIT_PATCH_0, RCVD_IN_DNSWL_NONE, SPF_HELO_NONE, SPF_PASS, TXREP autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on server2.sourceware.org X-BeenThere: gcc-patches@gcc.gnu.org X-Mailman-Version: 2.1.30 Precedence: list List-Id: Gcc-patches mailing list List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: gcc-patches-bounces~patchwork=sourceware.org@gcc.gnu.org Update the GCN install documentation for added ISAs, especially as no longer all supported ISA are enabled by default. And for the (ROCm wise: upcoming) generic support. OK for mainline? Tobias [gcn] install.texi: Update for new ISA targets and their requirements GCN now supports several additional ISA targets such that no longer all targets have a multilib by default; add a note about this, the generic targets and the required LLVM (and ROCm) versions. gcc/ChangeLog: * doc/install.texi (GCN): Update section about multilibs and required LLVM version. gcc/doc/install.texi | 29 +++++++++++++++++++++++++---- 1 file changed, 25 insertions(+), 4 deletions(-) diff --git a/gcc/doc/install.texi b/gcc/doc/install.texi index 3b9f56b0529..f0c207a3ee7 100644 --- a/gcc/doc/install.texi +++ b/gcc/doc/install.texi @@ -3991,14 +3991,35 @@ This is a synonym for @samp{x86_64-*-solaris2*}. @heading amdgcn-*-amdhsa AMD GCN GPU target. -Instead of GNU Binutils, you will need to install LLVM 15, or later, and copy +Instead of GNU Binutils, you will need to install LLVM and copy @file{bin/llvm-mc} to @file{amdgcn-amdhsa/bin/as}, @file{bin/lld} to @file{amdgcn-amdhsa/bin/ld}, @file{bin/llvm-nm} to @file{amdgcn-amdhsa/bin/nm}, and @file{bin/llvm-ar} to both @file{bin/amdgcn-amdhsa-ar} and -@file{bin/amdgcn-amdhsa-ranlib}. Note that LLVM 13.0.1 or LLVM 14 can be used -by specifying a @code{--with-multilib-list=} that does not list @code{gfx1100} -and @code{gfx1103}. +@file{bin/amdgcn-amdhsa-ranlib}. + +The required version of LLVM depends on the devices that should be supported. +As the list of ISA is long, GCC by default only builds a subset of the supported +ISA as multilib; use @code{--with-multilib-list=} to tailor the built multilibs. +Note that mixing ISAs in the same binary is not supported and will give a linker +error. + +By default, multilib support is build for @code{gfx900}, @code{gfx906}, +@code{gfx908}, @code{gfx90a}, @code{gfx90c}, @code{gfx1030}, @code{gfx1036}, +@code{gfx1100} and @code{gfx1103}. The default multilib configuration +requires LLVM 15 or newer. LLVM 13.0.1 or LLVM 14 can be used by specifying +a @code{--with-multilib-list=} that does not list any GFX 11 device nor +@code{gfx1036}. At least LLVM 16 is required for @code{gfx1150} and +@code{gfx1151}, LLVM 19 for the generic @code{gfx9-generic}, +@code{gfx10-3-generic}, and @code{gfx11-generic} targets and for +@code{gfx1152}, while LLVM 20 is required for @code{gfx1153}. + +The supported ISA architectures are listed in the GCC manual. The generic +ISA targets @code{gfx9-generic}, @code{gfx10-3-generic}, and +@code{gfx11-generic} will reduce the number of required multilibs but note +that @code{gfx9-generic} does not include @code{gfx908} or @code{gfx90a}, +that linking specific ISA code is currently not supported, and that only a +future ROCm release (newer than 6.3.2) will be able to execute generic code. Use Newlib (4.3.0 or newer; 4.4.0 contains some improvements and 4.5.0 fixes the device console output for GFX10 and GFX11 devices).