[RFC 1/1] doc/build/gcc.rst: required packages for Suse

[Matthias Brugger]

Hi Heinrich,

On 20/09/2020 12:09, Heinrich Schuchardt wrote:
> Describe the packages required to build U-Boot on Suse.
> 
> Signed-off-by: Heinrich Schuchardt <xypron.glpk at gmx.de>
> ---
> Hello Matthias,
> 
> I would like to add a sub-chapter to our documentation describing what is
> needed to build U-Boot on Suse. Cf.
> https://u-boot.readthedocs.io/en/latest/build/gcc.html
> 
> Unfortunately I could not find all the packages that need to be installed
> in the Suse Tumbleweed Docker image.
> 
> For 'make qemu_arm64_defconfig && make' I get an error
> 
>     aarch64-suse-linux-ld.bfd: cannot find -lgcc

If I remember correctly, that's a known problem in our cross toolchain (ouch!). 
I forwarded the info to our toolchain team, but didn't got any response up to now.

> 
> For 'make tests' a lot more seems to be missing.
> 
> Do you have a list of required packages?
> 

No I don't. I suppose I installed all packages once on my laptop, but I didn't 
kept track which one these are.

Regards,
Matthias

> Best regards
> 
> Heinrich
> ---
>   doc/build/gcc.rst | 20 ++++++++++++++++++++
>   1 file changed, 20 insertions(+)
> 
> diff --git a/doc/build/gcc.rst b/doc/build/gcc.rst
> index fcb0b1ffb3..6250dc1880 100644
> --- a/doc/build/gcc.rst
> +++ b/doc/build/gcc.rst
> @@ -29,6 +29,26 @@ Depending on the build targets further packages maybe needed
>         lzma-alone openssl python3 python3-coverage python3-pyelftools \
>         python3-pytest python3-sphinxcontrib.apidoc python3-sphinx-rtd-theme swig
> 
> +Suse based
> +~~~~~~~~~~
> +
> +On Suse based systems the cross compiler packages are named
> +cross-<architecture>-gcc<version>.
> +
> +You could install GCC and the GCC 10 cross compiler for the ARMv8 architecture
> +with
> +
> +.. code-block:: bash
> +
> +    sudo zypper install gcc cross-aarch64-gcc10
> +
> +Depending on the build targets further packages maybe needed.
> +
> +.. code-block:: bash
> +
> +    zypper install bc bison flex gcc libopenssl-devel libSDL2-devel make \
> +      ncurses-devel python3-devel python3-pytest swig
> +
>   Prerequisites
>   -------------
> 
> --
> 2.28.0
>