Update guides for building Linux

Author: kolerov

docs/linux/building/toolchain.md

@@ -62,14 +62,16 @@ Here is a table of kernel versions for different toolchain releases:
 | 2015.12 — 2015.06 | 3.18 |
 | earlier | 3.13 |
 
-## Options for 2023.09 release
+## Options for Different Toolchain Releases
 
 !!! note
 
  RPC support must be explicitly disabled since Buildroot configurator
  may enable it by default.
 
-Additional options for glibc-based toolchain:
+### Release 2023.09 for HS6x Family (glibc-based)
+
+Additional options for the toolchain:
 
 ```text
 Toolchain -> External toolchain gcc version -> 13.x
@@ -93,7 +95,9 @@ BR2_TOOLCHAIN_EXTERNAL_CXX=y
 BR2_TOOLCHAIN_EXTERNAL_FORTRAN=y
 ```
 
-Additional options for uClibc-based toolchain:
+### Release 2023.09 for HS5x Family (uClibc-based)
+
+Additional options for the toolchain:
 
 ```text
 Toolchain -> External toolchain gcc version -> 13.x
@@ -103,7 +107,6 @@ Toolchain -> External toolchain gcc version -> 13.x
  [*] Toolchain has SSP support?
  [ ] Toolchain has RPC support?
  [*] Toolchain has C++ support?
- [*] Toolchain has Fortran support?
 ```
 
 Configuration file lines:
@@ -116,58 +119,84 @@ BR2_TOOLCHAIN_EXTERNAL_WCHAR=y
 BR2_TOOLCHAIN_EXTERNAL_HAS_SSP=y
 BR2_TOOLCHAIN_EXTERNAL_INET_RPC=n
 BR2_TOOLCHAIN_EXTERNAL_CXX=y
-BR2_TOOLCHAIN_EXTERNAL_FORTRAN=y
 ```
 
-## Options for 2023.03 release
-
-!!! note
-
- RPC support must be explicitly disabled since Buildroot configurator
- may enable it by default.
+### Release 2023.09 for HS3x/4x Families (glibc-based)
 
-Additional options for glibc-based toolchain:
+Additional options for the toolchain:
 
 ```text
-Toolchain -> External toolchain gcc version -> 12.x
+Toolchain -> External toolchain gcc version -> 13.x
  External toolchain kernel headers series -> 5.16.x
  External toolchain C library -> glibc
  [*] Toolchain has SSP support?
  [ ] Toolchain has RPC support?
  [*] Toolchain has C++ support?
+ [*] Toolchain has Fortran support?
 ```
 
 Configuration file lines:
 
 ```text
-BR2_TOOLCHAIN_EXTERNAL_GCC_12=y
+BR2_TOOLCHAIN_EXTERNAL_GCC_13=y
 BR2_TOOLCHAIN_EXTERNAL_HEADERS_5_16=y
 BR2_TOOLCHAIN_EXTERNAL_CUSTOM_GLIBC=y
 BR2_TOOLCHAIN_EXTERNAL_HAS_SSP=y
 BR2_TOOLCHAIN_EXTERNAL_INET_RPC=n
 BR2_TOOLCHAIN_EXTERNAL_CXX=y
+BR2_TOOLCHAIN_EXTERNAL_FORTRAN=y
 ```
 
+### Release 2023.09 for HS3x/4x Families (uClibc-based)
+
 Additional options for uClibc-based toolchain:
 
 ```text
-Toolchain -> External toolchain gcc version -> 12.x
+Toolchain -> External toolchain gcc version -> 13.x
  External toolchain kernel headers series -> 5.16.x
  External toolchain C library -> uClibc/uClibc-ng
- [*] Toolchain has locale support?
+ [*] Toolchain has WCHAR support?
  [*] Toolchain has SSP support?
  [ ] Toolchain has RPC support?
  [*] Toolchain has C++ support?
+ [*] Toolchain has Fortran support?
 ```
 
 Configuration file lines:
 
 ```text
-BR2_TOOLCHAIN_EXTERNAL_GCC_12=y
+BR2_TOOLCHAIN_EXTERNAL_GCC_13=y
 BR2_TOOLCHAIN_EXTERNAL_HEADERS_5_16=y
 BR2_TOOLCHAIN_EXTERNAL_CUSTOM_UCLIBC=y
-BR2_TOOLCHAIN_EXTERNAL_LOCALE=y
+BR2_TOOLCHAIN_EXTERNAL_WCHAR=y
 BR2_TOOLCHAIN_EXTERNAL_HAS_SSP=y
 BR2_TOOLCHAIN_EXTERNAL_INET_RPC=n
 BR2_TOOLCHAIN_EXTERNAL_CXX=y
+BR2_TOOLCHAIN_EXTERNAL_FORTRAN=y
 ```
+
+### Release 2023.09 for ARC700 Family (uClibc-based)
+
+Additional options for uClibc-based toolchain:
+
+```text
+Toolchain -> External toolchain gcc version -> 13.x
+ External toolchain kernel headers series -> 5.16.x
+ External toolchain C library -> uClibc/uClibc-ng
+ [*] Toolchain has WCHAR support?
+ [*] Toolchain has SSP support?
+ [ ] Toolchain has RPC support?
+ [*] Toolchain has C++ support?
+```
+
+Configuration file lines:
+
+```text
+BR2_TOOLCHAIN_EXTERNAL_GCC_13=y
+BR2_TOOLCHAIN_EXTERNAL_HEADERS_5_16=y
+BR2_TOOLCHAIN_EXTERNAL_CUSTOM_UCLIBC=y
+BR2_TOOLCHAIN_EXTERNAL_WCHAR=y
+BR2_TOOLCHAIN_EXTERNAL_HAS_SSP=y
+BR2_TOOLCHAIN_EXTERNAL_INET_RPC=n
+BR2_TOOLCHAIN_EXTERNAL_CXX=y
+```

docs/linux/simulators/nsim.md

@@ -66,6 +66,7 @@ BR2_TOOLCHAIN_EXTERNAL_CUSTOM_GLIBC=y
 BR2_TOOLCHAIN_EXTERNAL_INET_RPC=n
 BR2_TOOLCHAIN_EXTERNAL_CXX=y
 BR2_TOOLCHAIN_EXTERNAL_FORTRAN=y
+BR2_TOOLCHAIN_EXTERNAL_HAS_SSP=y
 BR2_LINUX_KERNEL=y
 BR2_LINUX_KERNEL_CUSTOM_GIT=y
 BR2_LINUX_KERNEL_CUSTOM_REPO_URL="https://github.com/foss-for-synopsys-dwc-arc-processors/linux"
@@ -194,10 +195,12 @@ BR2_TOOLCHAIN_EXTERNAL_CUSTOM=y
 BR2_TOOLCHAIN_EXTERNAL_PATH="/tools/toolchains/arc-linux-uclibc"
 BR2_TOOLCHAIN_EXTERNAL_GCC_13=y
 BR2_TOOLCHAIN_EXTERNAL_WCHAR=y
-BR2_TOOLCHAIN_EXTERNAL_HAS_SSP=y
+BR2_TOOLCHAIN_EXTERNAL_HEADERS_5_16=y
+BR2_TOOLCHAIN_EXTERNAL_CUSTOM_UCLIBC=y
+BR2_TOOLCHAIN_EXTERNAL_INET_RPC=n
 BR2_TOOLCHAIN_EXTERNAL_CXX=y
 BR2_TOOLCHAIN_EXTERNAL_FORTRAN=y
-BR2_TOOLCHAIN_EXTERNAL_HEADERS_5_16=y
+BR2_TOOLCHAIN_EXTERNAL_HAS_SSP=y
 BR2_LINUX_KERNEL=y
 BR2_LINUX_KERNEL_CUSTOM_GIT=y
 BR2_LINUX_KERNEL_CUSTOM_REPO_URL="https://github.com/foss-for-synopsys-dwc-arc-processors/linux"
@@ -221,11 +224,11 @@ BR2_arc770d=y
 BR2_TOOLCHAIN_EXTERNAL=y
 BR2_TOOLCHAIN_EXTERNAL_CUSTOM=y
 BR2_TOOLCHAIN_EXTERNAL_PATH="/tools/toolchains/arc700-linux-uclibc"
+BR2_TOOLCHAIN_EXTERNAL_CUSTOM_UCLIBC=y
 BR2_TOOLCHAIN_EXTERNAL_GCC_13=y
 BR2_TOOLCHAIN_EXTERNAL_WCHAR=y
 BR2_TOOLCHAIN_EXTERNAL_HAS_SSP=y
 BR2_TOOLCHAIN_EXTERNAL_CXX=y
-BR2_TOOLCHAIN_EXTERNAL_FORTRAN=y
 BR2_TOOLCHAIN_EXTERNAL_HEADERS_5_16=y
 BR2_LINUX_KERNEL=y
 BR2_LINUX_KERNEL_CUSTOM_GIT=y
@@ -309,8 +312,17 @@ a single core (UP) configuration. Here is a corresponding configuration file for
 ```shell
 BR2_arcle=y
 BR2_arc32=y
+BR2_TOOLCHAIN_EXTERNAL=y
+BR2_TOOLCHAIN_EXTERNAL_CUSTOM=y
+BR2_TOOLCHAIN_EXTERNAL_CUSTOM_UCLIBC=y
+BR2_TOOLCHAIN_EXTERNAL_PATH="/tools/toolchains/arc32-linux-uclibc"
+BR2_TOOLCHAIN_EXTERNAL_GCC_13=y
+BR2_TOOLCHAIN_EXTERNAL_INET_RPC=n
+BR2_TOOLCHAIN_EXTERNAL_HEADERS_5_16=y
+BR2_TOOLCHAIN_EXTERNAL_WCHAR=y
+BR2_TOOLCHAIN_EXTERNAL_HAS_SSP=y
+BR2_TOOLCHAIN_EXTERNAL_CXX=y
 # BR2_STRIP_strip is not set
-BR2_PACKAGE_HOST_LINUX_HEADERS_CUSTOM_5_16=y
 BR2_ROOTFS_POST_IMAGE_SCRIPT="board/synopsys/arc64/post-image.sh"
 BR2_ROOTFS_POST_SCRIPT_ARGS="$(LINUX_DIR)"
 BR2_LINUX_KERNEL=y
@@ -320,16 +332,6 @@ BR2_LINUX_KERNEL_CUSTOM_REPO_VERSION="arc64"
 BR2_LINUX_KERNEL_DEFCONFIG="haps_hs5x"
 BR2_LINUX_KERNEL_IMAGE_TARGET_CUSTOM=y
 BR2_LINUX_KERNEL_IMAGE_TARGET_NAME="loader"
-BR2_TOOLCHAIN_EXTERNAL=y
-BR2_TOOLCHAIN_EXTERNAL_CUSTOM=y
-BR2_TOOLCHAIN_EXTERNAL_PATH="/tools/toolchains/arc32-linux-uclibc"
-BR2_TOOLCHAIN_EXTERNAL_HEADERS_5_16=y
-BR2_TOOLCHAIN_EXTERNAL_GCC_13=y
-BR2_TOOLCHAIN_EXTERNAL_WCHAR=y
-BR2_TOOLCHAIN_EXTERNAL_HAS_SSP=y
-BR2_TOOLCHAIN_EXTERNAL_CXX=y
-BR2_TOOLCHAIN_EXTERNAL_INET_RPC=n
-BR2_TOOLCHAIN_EXTERNAL_FORTRAN=y
 BR2_TARGET_ROOTFS_INITRAMFS=y
 ```
 
@@ -410,8 +412,18 @@ a single core (UP) configuration. Here is a corresponding configuration file for
 ```shell
 BR2_arcle=y
 BR2_arc64=y
+BR2_TOOLCHAIN_EXTERNAL=y
+BR2_TOOLCHAIN_EXTERNAL_CUSTOM=y
+BR2_TOOLCHAIN_EXTERNAL_CUSTOM_GLIBC=y
+BR2_TOOLCHAIN_EXTERNAL_PATH="/tools/toolchains/arc64-linux-gnu"
+BR2_TOOLCHAIN_EXTERNAL_GCC_13=y
+BR2_TOOLCHAIN_EXTERNAL_INET_RPC=n
+BR2_TOOLCHAIN_EXTERNAL_HEADERS_5_16=y
+BR2_TOOLCHAIN_EXTERNAL_WCHAR=y
+BR2_TOOLCHAIN_EXTERNAL_HAS_SSP=y
+BR2_TOOLCHAIN_EXTERNAL_CXX=y
+BR2_TOOLCHAIN_EXTERNAL_FORTRAN=y
 # BR2_STRIP_strip is not set
-BR2_PACKAGE_HOST_LINUX_HEADERS_CUSTOM_5_16=y
 BR2_ROOTFS_POST_IMAGE_SCRIPT="board/synopsys/arc64/post-image.sh"
 BR2_ROOTFS_POST_SCRIPT_ARGS="$(LINUX_DIR)"
 BR2_LINUX_KERNEL=y
@@ -421,17 +433,6 @@ BR2_LINUX_KERNEL_CUSTOM_REPO_VERSION="arc64"
 BR2_LINUX_KERNEL_DEFCONFIG="haps_arc64"
 BR2_LINUX_KERNEL_IMAGE_TARGET_CUSTOM=y
 BR2_LINUX_KERNEL_IMAGE_TARGET_NAME="loader"
-BR2_TOOLCHAIN_EXTERNAL=y
-BR2_TOOLCHAIN_EXTERNAL_CUSTOM=y
-BR2_TOOLCHAIN_EXTERNAL_GCC_13=y
-BR2_TOOLCHAIN_EXTERNAL_CUSTOM_GLIBC=y
-BR2_TOOLCHAIN_EXTERNAL_PATH="/tools/toolchains/arc64-linux-gnu"
-BR2_TOOLCHAIN_EXTERNAL_HEADERS_5_16=y
-BR2_TOOLCHAIN_EXTERNAL_LOCALE=y
-BR2_TOOLCHAIN_EXTERNAL_HAS_SSP=y
-BR2_TOOLCHAIN_EXTERNAL_CXX=y
-BR2_TOOLCHAIN_EXTERNAL_INET_RPC=n
-BR2_TOOLCHAIN_EXTERNAL_FORTRAN=y
 BR2_TARGET_ROOTFS_INITRAMFS=y
 ```