Annotation of pkgsrc/bootstrap/README.Linux, revision 1.16

1.16    ! bsiegert    1: $NetBSD: README.Linux,v 1.15 2024/10/22 11:54:53 nia Exp $
1.1       grant       2: 
1.10      gdt         3: # General
1.1       grant       4: 
1.10      gdt         5: Generally, bootstrapping on GNU/Linux is expected to Just Work with
                      6: gcc.
                      7: 
                      8: # Compilers
                      9: 
                     10: ## gcc
                     11: 
                     12: gcc is the standard approach.
                     13: 
                     14: As of 2022 it has been reported that systems with gcc 4.8 (e.g. RHEL7)
                     15: do not bootstrap, but that gcc7 (AWS-flavored RHEL7) and gcc8 (RHEL8) succeed.
                     16: 
                     17: ## clang
                     18: 
                     19: There are no reports of success or failure with clang.
                     20: 
                     21: ## icc
                     22: 
1.12      gdt        23: It was reported in 2008 that icc (Intel C++ Compiler) 8.0 and 8.1
1.10      gdt        24: have been tested on i386.  See the old section at the end.
                     25: 
1.14      schmonz    26: # Alpine and derivatives
                     27: 
                     28: After bootstrap, if you want to be using pkgsrc build/install locking,
                     29: install a more featureful ps(1) than BusyBox's:
                     30: 
                     31:        apk add procps
                     32: 
                     33: You may also find that pkgsrc needs a more featureful date(1),
                     34: such as GNU's:
                     35: 
                     36:        apk add coreutils
                     37: 
1.10      gdt        38: # Debian and derivatives
1.4       dmcmahil   39: 
1.6       sevan      40: For Debian and derivatives such as Ubuntu the following packages should be
1.10      gdt        41: installed prior to attempting bootstrap:
1.6       sevan      42: 
1.15      nia        43: apt install cvs libncurses libncurses-dev gcc g++ zlib1g-dev \
                     44:                zlib1g libssl-dev libudev-dev gawk
1.6       sevan      45: 
1.16    ! bsiegert   46: # Slackware
        !            47: 
        !            48: On a fresh installation of Slackware, you need to install the diffutils
        !            49: package if it is not already installed.
        !            50: 
1.13      gdt        51: # RedHat and derivatives
                     52: 
                     53: In 2022, pkgsrc bootstrapped ok on RHEL 8.5, and packages generally worked.
                     54: 
1.11      nia        55: # NixOS
                     56: 
                     57: stdenv.cc should be installed prior to attempting bootstrap.
                     58: 
                     59: Please note that if you run the Nix garbage collector and it collects
                     60: libc, every pkgsrc binary (including binaries generated during bootstrap)
                     61: will need to be rebuilt.
                     62: 
1.12      gdt        63: # musl
                     64: 
                     65: Linux with musl was reported to work in 2022.
                     66: 
                     67: # Termux (Android)
                     68: 
                     69: In 2022, unprivileged bootstrap failed.
                     70: 
                     71: # Very old information
1.4       dmcmahil   72: 
1.12      gdt        73: ## Details of using icc (last update 2005
1.2       grant      74: 
                     75: To bootstrap using icc, assuming the default icc installation
                     76: directory:
                     77: 
                     78:        env CC=/opt/intel_cc_80/bin/icc LDFLAGS=-static-libcxa \
                     79:                ac_cv___attribute__=yes ./bootstrap
                     80: 
1.3       grant      81: note: icc 8.1 needs the `-i-static' argument instead of
                     82: -static-libcxa.
                     83: 
1.2       grant      84: icc supports __attribute__, but the GNU configure test uses a nested
                     85: function, which icc does not support. #undef'ing __attribute__ has the
                     86: unfortunate side-effect of breaking many of the Linux header files, which
                     87: cannot be compiled properly without __attribute__. The test must be
                     88: overridden so that __attribute__ is assumed supported by the compiler.
                     89: 
                     90: After bootstrapping, you should set PKGSRC_COMPILER in mk.conf:
                     91: 
                     92:        PKGSRC_COMPILER=icc
                     93: 
                     94: The default installation directory for icc is /opt/intel_cc_80, which
                     95: is also the pkgsrc default. If you have installed it into a different
                     96: directory, set ICCBASE in mk.conf:
                     97: 
                     98:        ICCBASE=/opt/icc
                     99: 
                    100: pkgsrc uses the static linking method of the runtime libraries
                    101: provided by icc, so binaries can be run on other systems which do not
                    102: have the shared libraries installed.
                    103: 
                    104: Libtool, however, extracts a list of libraries from the ld(1) command
                    105: run when linking a C++ shared library and records it, throwing away
                    106: the -Bstatic and -Bdynamic options interspersed between the libraries.
                    107: This means that libtool-linked C++ shared libraries will have a
                    108: runtime dependency on the icc libraries until this is fixed in
                    109: libtool.

CVSweb <webmaster@jp.NetBSD.org>